Widgets: Anbefalinger

Det tilpassede element <devsite-recommendations> kan bruges til at give indholdsanbefalinger til dine læsere. Du kan lade systemet generere anbefalinger , du kan selv give eksplicitte anbefalinger, eller du kan indpakke eksisterende anbefalingerssektioner af dit dokument til ensartet præsentation, klikstatistikker og en rig brugergrænseflade (inklusive beskrivelser og billeder).

Brug

For at bruge denne widget skal du oprette et <devsite-recommendations> -element. Hvis du ønsker at give anbefalinger eksplicit, så tilføje nogle links i elementet. På nuværende tidspunkt vil systemgenererede anbefalinger blive leveret, når elementet er tomt, men fremtidigt arbejde vil give forfattere mulighed for at eksperimentere med genererede anbefalinger, når eksplicitte anbefalinger leveres, samt bruge dem som input til algoritmen.

Hvis du giver eksplicitte anbefalinger, så angiv nogle markeringer i elementet. Alle <a> -tags, der registreres, når elementet er forbundet, vil få deres href attributter udtrukket og brugt til anbefalingerne.

Hvis du giver mere end tre anbefalinger, vil et tilfældigt udvalg blive valgt. Rækkefølgen af ​​anbefalingerne vil dog forblive den samme som inputrækkefølgen, så anbefalinger med højere prioritet vil altid vises længst til venstre.

Hvis du ikke ønsker, at specifikke anbefalinger skal vises i de genererede resultater, kan du lave et tomt <devsite-recommendations> -element med en samling af <link rel="disallow" href="/path"> . Alle <link> -tags med rel=disallow og en href attribut vil automatisk blive registreret og fjernet fra genererede anbefalinger.

Hvis du kun ønsker anbefalinger fra en bestemt undergruppe af sider, kan du bruge nomenklatur -tags i et query til at filtrere resultaterne. Syntaksen er k:category:value . For eksempel k:sprog:typescript. Listen over tags kan være en kommasepareret liste ( k:language:typescript,k:language:swift ) for at inkludere sider, der indeholder et hvilket som helst af tags.

De følgende afsnit beskriver opmærkningen, hvordan den gengives under normale forhold, og hvordan den gengives til maskiner eller simple brugeragenter.

Markup 

<devsite-recommendations>
<p>Note: link text is displayed when JavaScript is off</p>
<ul>
  <li><a href="/maps/documentation">Maps docs</a></li>
  <li><a href="/analytics">Analytics</a></li>
  <li><a href="/machine-learning/crash-course">MLCC</a></li>
</ul>
</devsite-recommendations>

Resultat

Simple bruger-agenter

Bemærk: linktekst vises, når JavaScript er slået fra

Eksempel med disallows

Markup

<devsite-recommendations>
  <link rel="disallow" href="/maps/documentation">
  <link rel="disallow" href="/analytics">
  <link rel="disallow" href="/machine-learning/crash-course">
</devsite-recommendations>

Resultat

Da resultaterne er afhængige af anbefalingerne, som kan ændre sig, vil output være det samme som output fra anbefalingsmodellen.

Indpakning af eksisterende indhold

Elementet kan gradvist forbedre eksisterende opmærkning på dine sider, så du kan opgradere eksisterende links ved at indpakke dem med <devsite-recommendations> .

De nye links vil overtage al funktionalitet og politikker i anbefalingsplatformen, såsom dataindsamling og eksperiment-dashboards, men indholdet vil også blive erstattet med rige metadata, inklusive beskrivelser og billeder, og kan udelukke nogle links (f.eks. adgangskontrollerede eller sider uden metadata).

Markup 

<devsite-recommendations>
<h2>Example communities</h2>
<p>Note: All markup here will be replaced with the recommendation UI.</p>
<p>
  For more information on Google Developers, check out our <a href="/community/experts">GDEs</a>. If
  you are looking to form a community, take a look at <a href="/community/gdg">GDGs</a>. Lastly, if
  you're currently studying, don't miss our <a href="/community/dsc">DSCs</a>.
</p>
</devsite-recommendations>

Resultat

Eksempel fællesskaber

Bemærk: Al opmærkning her vil blive erstattet med anbefalingsbrugergrænsefladen.

For mere information om Google Developers, se vores GDE'er . Hvis du ønsker at danne et fællesskab, så tag et kig på GDG'er . Endelig, hvis du studerer i øjeblikket, så gå ikke glip af vores DSC'er .

Brug i Markdown-filer

I en Markdown-fil ( .md ) skal du sørge for, at det brugerdefinerede element er pakket med et standard HTML-element, såsom en <section> eller <div> :

Blandet indhold 

## Markdown section

* Markdown list
* [Markdown link](/foo)

## HTML section

<div>
<devsite-recommendations>
  <p>Note: link text is displayed when JavaScript is off</p>
  <h2>Sample heading</h2>
  <a href="/recommended">Recommended</a>
</devsite-recommendations>
</div>

Markdown sektion

HTML sektion

Bemærk: linktekst vises, når JavaScript er slået fra

Eksempel overskrift

Anbefales

Ren markdown

<pre><devsite-recommendations>
## Sample heading

* Note: link text is displayed when JavaScript is off
* [Maps documentation](/maps/documentation)

</devsite-recommendations><pre>

Resultat

{% ordret %} {% endverbatim %}

Eksempel overskrift

{% ordret %} {% endverbatim %}

System attributter

På nuværende tidspunkt er de eneste understøttede attributter til at kontrollere systemadfærd og burde ikke være nødvendige for normale brugere.

yield (valgfrit) Hvis det leveres, vil elementet give efter for andre ikke-afkastende anbefalingselementer på siden. Dette bruges typisk af webstedet selv til automatisk at placere anbefalinger på en side, men til kun at vise dem, når der ikke er andre forekomster til stede.

Filtrering med nomenklatur

Markup 

<devsite-recommendations query="k:language:typescript">
</devsite-recommendations>

Resultat