Widgets: Rekommendationer

Det anpassade elementet <devsite-recommendations> kan användas för att ge innehållsrekommendationer till dina läsare. Du kan låta systemet generera rekommendationer , du kan ge explicita rekommendationer själv, eller så kan du slå in befintliga rekommendationsavsnitt i ditt dokument för konsekvent presentation, genomklickningsstatistik och ett rikt användargränssnitt (inklusive beskrivningar och bilder).

Användande

För att använda den här widgeten, skapa ett <devsite-recommendations> -element. Om du vill ge rekommendationer uttryckligen, lägg till några länkar i elementet. För närvarande kommer systemgenererade rekommendationer att tillhandahållas när elementet är tomt, men framtida arbete kommer att tillåta författare att experimentera med genererade rekommendationer när explicita rekommendationer tillhandahålls, såväl som att använda dem som indata till algoritmen.

Om du tillhandahåller explicita rekommendationer ska du ange lite uppmärkning i elementet. Alla <a> -taggar som upptäcks när elementet är anslutet kommer att få sina href attribut extraherade och använda för rekommendationerna.

Om du tillhandahåller mer än tre rekommendationer kommer ett slumpmässigt urval att väljas. Ordningen av rekommendationerna kommer dock att förbli densamma som ingångsordningen, så rekommendationer med högre prioritet kommer alltid att visas längst till vänster.

Om du inte vill att specifika rekommendationer ska visas i de genererade resultaten kan du skapa ett tomt <devsite-recommendations> -element med en samling av <link rel="disallow" href="/path"> . Alla <link> -taggar med rel=disallow och ett href attribut kommer automatiskt att upptäckas och tas bort från genererade rekommendationer.

Om du bara vill ha rekommendationer från en specifik undergrupp av sidor kan du använda nomenklaturtaggar i ett query för att filtrera resultaten. Syntaxen är k:category:value . Till exempel k:språk:typskript. Listan med taggar kan vara en kommaseparerad lista ( k:language:typescript,k:language:swift ) för att inkludera sidor som innehåller någon av taggarna.

Följande avsnitt beskriver uppmärkningen, hur den återges under normala förhållanden och hur den återges till maskiner eller enkla användaragenter.

Pålägg 

<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

Enkla användaragenter

Obs: länktext visas när JavaScript är avstängt

Exempel med disallows

Pålägg

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

Resultat

Eftersom resultaten är beroende av rekommendationerna, som kan ändras, kommer resultatet att se ut på samma sätt som resultatet från rekommendationsmodellen.

Förpackning av befintligt innehåll

Elementet kan successivt förbättra befintlig uppmärkning på dina sidor, så du kan uppgradera befintliga länkar genom att omsluta dem med <devsite-recommendations> .

De nya länkarna kommer att anta alla funktioner och policyer för rekommendationsplattformen, såsom datainsamling och experimentinstrumentpaneler, men innehållet kommer också att ersättas med rik metadata inklusive beskrivningar och bilder, och kan utesluta vissa länkar (t.ex. åtkomstkontrollerade eller sidor utan metadata).

Pålägg 

<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

Exempel gemenskaper

Obs! All uppmärkning här kommer att ersättas med rekommendationsgränssnittet.

För mer information om Google Developers, kolla in våra GDE:er . Om du funderar på att bilda en gemenskap, ta en titt på GDGs . Slutligen, om du studerar för närvarande, missa inte våra DSC:er .

Användning i Markdown-filer

I en Markdown-fil ( .md ), se till att det anpassade elementet är omslutet med ett standard-HTML-element, till exempel en <section> eller <div> :

Blandat innehåll 

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

HTML-sektion

Obs: länktext visas när JavaScript är avstängt

Exempel på rubrik

Rekommenderad

Ren markdown

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

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

</devsite-recommendations><pre>

Resultat

{% ordagrant %} {% endverbatim %}

Exempel på rubrik

{% ordagrant %} {% endverbatim %}

Systemattribut

För närvarande är de enda attributen som stöds för att kontrollera systemets beteende och bör inte behövas av normala användare.

yield (valfritt) Om det tillhandahålls kommer elementet att ge efter för alla andra icke-avkastande rekommendationselement på sidan. Detta används vanligtvis av webbplatsen själv för att automatiskt placera rekommendationer på en sida, men för att bara visa dem när inga andra instanser finns.

Filtrering med nomenklatur

Pålägg 

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

Resultat