Widgets: Anbefalinger

Det tilpassede elementet <devsite-recommendations> kan brukes til å gi innholdsanbefalinger til leserne dine. Du kan la systemet generere anbefalinger , du kan gi eksplisitte anbefalinger selv, eller du kan pakke inn eksisterende anbefalingsdeler av dokumentet ditt for konsistent presentasjon, klikkstatistikk og et rikt brukergrensesnitt (inkludert beskrivelser og bilder).

Bruk

For å bruke denne widgeten, lag et <devsite-recommendations> -element. Hvis du ønsker å gi anbefalinger eksplisitt, legg til noen lenker i elementet. For tiden vil systemgenererte anbefalinger leveres når elementet er tomt, men fremtidig arbeid vil tillate forfattere å eksperimentere med genererte anbefalinger når eksplisitte anbefalinger leveres, samt bruke dem som input til algoritmen.

Hvis du gir eksplisitte anbefalinger, må du legge til noen markeringer i elementet. Eventuelle <a> -tagger som oppdages når elementet er koblet til, vil få href attributtene sine trukket ut og brukt for anbefalingene.

Hvis du gir mer enn tre anbefalinger, vil et tilfeldig utvalg bli valgt. Rekkefølgen av anbefalingene vil imidlertid forbli den samme som inndatarekkefølgen, så anbefalinger med høyere prioritet vil alltid vises til venstre.

Hvis du ikke vil at spesifikke anbefalinger skal vises i de genererte resultatene, kan du lage et tomt <devsite-recommendations> -element med en samling av <link rel="disallow" href="/path"> . Eventuelle <link> -tagger med rel=disallow og et href attributt vil automatisk bli oppdaget og fjernet fra genererte anbefalinger.

Hvis du bare vil ha anbefalinger fra et spesifikt undersett av sider, kan du bruke nomenklaturkoder i et query for å filtrere resultatene. Syntaksen er k:category:value . For eksempel k:språk:typeskrift. Listen over tagger kan være en kommaseparert liste ( k:language:typescript,k:language:swift ) for å inkludere sider som inneholder noen av taggene.

De følgende delene beskriver markeringen, hvordan den gjengis under normale forhold og hvordan den gjengis til maskiner eller enkle brukeragenter.

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

Enkle brukeragenter

Merk: lenketekst vises når JavaScript er av

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

Siden resultatene er avhengige av anbefalingene, som kan endres, vil resultatet fremstå som det samme som resultatet fra anbefalingsmodellen.

Innpakning av eksisterende innhold

Elementet kan gradvis forbedre eksisterende markering på sidene dine, slik at du kan oppgradere eksisterende koblinger ved å pakke dem inn med <devsite-recommendations> .

De nye lenkene vil ta i bruk all funksjonaliteten og retningslinjene til anbefalingsplattformen, for eksempel datainnsamling og eksperimentpaneler, men innholdet vil også bli erstattet med rike metadata inkludert beskrivelser og bilder, og kan ekskludere noen lenker (f.eks. tilgangskontrollerte eller sider uten 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

Eksempelsamfunn

Merk: All markering her vil bli erstattet med anbefalingsgrensesnittet.

For mer informasjon om Google Developers, sjekk ut våre GDE-er . Hvis du ønsker å danne et fellesskap, ta en titt på GDGs . Til slutt, hvis du studerer for øyeblikket, ikke gå glipp av DSC-ene våre.

Bruk i Markdown-filer

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

Blandet innhold 

## 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-seksjon

HTML-delen

Merk: lenketekst vises når JavaScript er av

Eksempel overskrift

Anbefalt

Ren markdown

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

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

</devsite-recommendations><pre>

Resultat

{% ordrett %} {% endverbatim %}

Eksempel overskrift

{% ordrett %} {% endverbatim %}

Systemattributter

For øyeblikket er de eneste støttede attributtene for å kontrollere systematferd og bør ikke være nødvendig for vanlige brukere.

yield (valgfritt) Hvis det leveres, vil elementet gi etter for alle andre anbefalingselementer som ikke gir etter på siden. Dette brukes vanligvis av selve nettstedet til automatisk å plassere anbefalinger på en side, men for å vise dem bare når ingen andre forekomster er til stede.

Filtrering med nomenklatur

Markup 

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

Resultat