Ginys: Recomanacions

L'element personalitzat <devsite-recommendations> es pot utilitzar per proporcionar recomanacions de contingut als vostres lectors. Podeu deixar que el sistema generi recomanacions , podeu proporcionar recomanacions explícites vosaltres mateixos o podeu embolicar les seccions de recomanacions existents del vostre document per a una presentació coherent, estadístiques de clics i una interfície d'usuari rica (incloent descripcions i imatges).

Ús

Per utilitzar aquest widget, creeu un element <devsite-recommendations> . Si voleu proporcionar recomanacions explícitament, afegiu alguns enllaços a l'element. Actualment, les recomanacions generades pel sistema es proporcionaran quan l'element estigui buit, però el treball futur permetrà als autors experimentar amb les recomanacions generades quan es proporcionen recomanacions explícites, així com utilitzar-les com a entrades a l'algorisme.

Si proporcioneu recomanacions explícites, proporcioneu algunes marques dins de l'element. Qualsevol etiqueta <a> detectada quan l'element estigui connectat s'extreuran els seus atributs href i s'utilitzaran per a les recomanacions.

Si proporcioneu més de tres recomanacions, es triarà una selecció aleatòria. Tanmateix, l'ordre de les recomanacions es mantindrà igual que l'ordre d'entrada, de manera que les recomanacions de prioritat més alta sempre es mostraran a l'extrem esquerre.

Si no voleu que apareguin recomanacions específiques als resultats generats, podeu crear un element <devsite-recommendations> buit amb una col·lecció de <link rel="disallow" href="/path"> . Qualsevol etiqueta <link> amb rel=disallow i un atribut href es detectarà i s'eliminarà automàticament de les recomanacions generades.

Si només voleu recomanacions d'un subconjunt específic de pàgines, podeu utilitzar etiquetes de nomenclatura en un camp query per filtrar els resultats. La sintaxi és k:category:value . Per exemple, k:language:typescript. La llista d'etiquetes pot ser una llista separada per comes ( k:language:typescript,k:language:swift ) per incloure pàgines que continguin qualsevol de les etiquetes.

Exemple amb enllaços

Les seccions següents descriuen el marcatge, com es representa en condicions normals i com es representa a màquines o agents d'usuari simples.

Marcatge

<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

Agents d'usuari senzills

Nota: el text de l'enllaç es mostra quan JavaScript està desactivat

• Documents de Maps
• Analítica
• MLCC

Exemple amb prohibicions

Marcatge

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

Resultat

Com que els resultats depenen de les recomanacions, que poden canviar, la sortida apareixerà igual que la sortida del model de recomanacions.

Embolcall del contingut existent

L'element pot millorar progressivament el marcatge existent a les vostres pàgines, de manera que podeu actualitzar els enllaços existents embolicant-los amb <devsite-recommendations> .

Els nous enllaços adoptaran totes les funcionalitats i polítiques de la plataforma de recomanacions, com ara taulers de recollida de dades i experiments, però els continguts també es substituiran per metadades riques que inclouen descripcions i imatges, i poden excloure alguns enllaços (p. ex. control d'accés o pàgines sense metadades).

Marcatge

<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

Exemples de comunitats

Nota: tot el marcatge aquí se substituirà per la IU de recomanació.

Per obtenir més informació sobre Google Developers, consulteu els nostres GDE . Si voleu formar una comunitat, feu una ullada a GDGs . Finalment, si actualment estàs estudiant, no et perdis els nostres DSC .

Ús en fitxers Markdown

En un fitxer Markdown ( .md ), assegureu-vos que l'element personalitzat estigui embolicat amb un element HTML estàndard, com ara <section> o <div> :

Contingut mixt

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

Secció Markdown

• Llista de rebaixes
• Enllaç de reducció

Secció HTML

Reducció en estat pur

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

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

</devsite-recommendations><pre>

Resultat

Atributs del sistema

Actualment, els únics atributs admesos són per controlar el comportament del sistema i no haurien de ser necessaris pels usuaris normals.

yield (opcional) Si es proporciona, l'element cedirà a qualsevol altre element de recomanació no rendible de la pàgina. Normalment l'utilitza el mateix lloc per col·locar recomanacions automàticament a una pàgina, però només per mostrar-les quan no hi ha cap altre cas.

Filtrat amb nomenclatura

Marcatge

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

Resultat