Widgets: aanbevelingen

Het aangepaste element <devsite-recommendations> kan worden gebruikt om inhoudsaanbevelingen aan uw lezers te geven. U kunt het systeem aanbevelingen laten genereren , u kunt zelf expliciete aanbevelingen doen, of u kunt bestaande aanbevelingssecties van uw document inpakken voor een consistente presentatie, doorklikstatistieken en een rijke gebruikersinterface (inclusief beschrijvingen en afbeeldingen).

Gebruik

Om deze widget te gebruiken, maakt u een <devsite-recommendations> -element. Als je expliciet aanbevelingen wilt geven, voeg dan enkele links toe binnen het element. Op dit moment zullen door het systeem gegenereerde aanbevelingen worden geleverd wanneer het element leeg is, maar toekomstig werk zal auteurs in staat stellen te experimenteren met gegenereerde aanbevelingen wanneer expliciete aanbevelingen worden geleverd, en deze te gebruiken als invoer voor het algoritme.

Als u expliciete aanbevelingen doet, geef dan wat opmaak op binnen het element. Van alle <a> -tags die worden gedetecteerd wanneer het element wordt verbonden, worden de href kenmerken geëxtraheerd en gebruikt voor de aanbevelingen.

Indien u meer dan drie adviezen geeft, wordt er willekeurig gekozen. De volgorde van de aanbevelingen blijft echter hetzelfde als de volgorde van de invoer, dus aanbevelingen met een hogere prioriteit worden altijd uiterst links weergegeven.

Als u niet wilt dat specifieke aanbevelingen in de gegenereerde resultaten verschijnen, kunt u een leeg <devsite-recommendations> element maken met een verzameling <link rel="disallow" href="/path"> . Alle <link> -tags met rel=disallow en een href attribuut worden automatisch gedetecteerd en verwijderd uit gegenereerde aanbevelingen.

Als u alleen aanbevelingen van een specifieke subset van pagina's wilt, kunt u nomenclatuurtags in een query gebruiken om de resultaten te filteren. De syntaxis is k:category:value . Bijvoorbeeld k:taal:typescript. De lijst met tags kan een door komma's gescheiden lijst zijn ( k:language:typescript,k:language:swift ) om pagina's op te nemen die een van de tags bevatten.

In de volgende secties wordt de markup beschreven, hoe deze wordt weergegeven onder normale omstandigheden en hoe deze wordt weergegeven op machines of eenvoudige user-agents.

Opmaak 

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

Resultaat

Eenvoudige user-agents

Let op: de linktekst wordt weergegeven als JavaScript is uitgeschakeld

Voorbeeld met verboden

Opmaak

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

Resultaat

Omdat de resultaten afhankelijk zijn van de aanbevelingen, die kunnen veranderen, zal de output hetzelfde lijken als de output van het aanbevelingsmodel.

Bestaande inhoud inpakken

Het element kan de bestaande markeringen op uw pagina's geleidelijk verbeteren , zodat u bestaande links kunt upgraden door ze te omsluiten met <devsite-recommendations> .

De nieuwe links zullen alle functionaliteit en beleid van het aanbevelingsplatform overnemen, zoals gegevensverzameling en experimentdashboards, maar de inhoud zal ook worden vervangen door rijke metagegevens, waaronder beschrijvingen en afbeeldingen, en kan sommige links uitsluiten (bijvoorbeeld toegangscontrole of pagina's zonder metadata).

Opmaak 

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

Resultaat

Voorbeeldgemeenschappen

Opmerking: alle markeringen hier worden vervangen door de aanbevelingsinterface.

Bekijk onze GDE's voor meer informatie over Google Developers. Als je een gemeenschap wilt vormen, kijk dan eens naar GDG's . Ten slotte: als je momenteel studeert, mis dan onze DSC's niet.

Gebruik in Markdown-bestanden

Zorg ervoor dat in een Markdown-bestand ( .md ) het aangepaste element wordt omwikkeld met een standaard HTML-element, zoals een <section> of <div> :

Gemengde inhoud 

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

HTML-sectie

Let op: de linktekst wordt weergegeven als JavaScript is uitgeschakeld

Voorbeeldkop

Aanbevolen

Pure afwaardering

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

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

</devsite-recommendations><pre>

Resultaat

{% woordelijk %} {% woordelijk %}

Voorbeeldkop

  • Let op: de linktekst wordt weergegeven als JavaScript is uitgeschakeld
  • Kaartdocumentatie
{% woordelijk %} {% woordelijk %}

Systeemattributen

Momenteel zijn de enige ondersteunde attributen bedoeld voor het controleren van systeemgedrag en zouden normale gebruikers deze niet nodig moeten hebben.

yield (optioneel) Indien opgegeven, zal het element wijken voor alle andere niet-rendement-aanbevelingselementen op de pagina. Dit wordt doorgaans door de site zelf gebruikt om automatisch aanbevelingen op een pagina te plaatsen, maar om deze alleen weer te geven als er geen andere instanties aanwezig zijn.

Filteren met nomenclatuur

Opmaak 

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

Resultaat