Pripomočki: Priporočila

Element po meri <devsite-recommendations> lahko uporabite za zagotavljanje vsebinskih priporočil svojim bralcem. Sistemu lahko dovolite, da ustvari priporočila , lahko sami zagotovite izrecna priporočila ali pa zavijete obstoječe razdelke s priporočili v dokumentu za dosledno predstavitev, statistiko klikov in bogat uporabniški vmesnik (vključno z opisi in slikami).

Uporaba

Za uporabo tega pripomočka ustvarite element <devsite-recommendations> . Če želite izrecno podati priporočila, dodajte nekaj povezav znotraj elementa. Trenutno bodo sistemsko ustvarjena priporočila podana, ko bo element prazen, prihodnje delo pa bo avtorjem omogočilo eksperimentiranje z ustvarjenimi priporočili, ko bodo podana izrecna priporočila, ter njihovo uporabo kot vhodne podatke za algoritem.

Če podajate izrecna priporočila, zagotovite nekaj oznak znotraj elementa. Za vse oznake <a> , zaznane, ko je element povezan, bodo njihovi atributi href ekstrahirani in uporabljeni za priporočila.

Če predložite več kot tri priporočila, bo izbrana naključna izbira. Vendar pa bo vrstni red priporočil ostal enak vrstnemu redu vnosa, zato bodo priporočila z višjo prednostjo vedno prikazana na skrajni levi.

Če ne želite, da se posebna priporočila prikažejo v ustvarjenih rezultatih, lahko naredite prazen element <devsite-recommendations> z zbirko <link rel="disallow" href="/path"> . Vse oznake <link> z rel=disallow in atributom href bodo samodejno zaznane in odstranjene iz ustvarjenih priporočil.

Če želite le priporočila iz določene podnabora strani, lahko uporabite oznake nomenklature v polju query za filtriranje rezultatov. Sintaksa je k:category:value . Na primer k:language:typescript. Seznam oznak je lahko seznam, ločen z vejicami ( k:language:typescript,k:language:swift ), ki vključuje strani, ki vsebujejo katero koli od oznak.

Naslednji razdelki opisujejo oznako, kako se upodobi v običajnih pogojih in kako se upodobi v strojih ali preprostih uporabniških agentih.

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>

Rezultat

Preprosti uporabniški agenti

Opomba: besedilo povezave je prikazano, ko je JavaScript izklopljen

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

Rezultat

Ker so rezultati odvisni od priporočil, ki se lahko spremenijo, bo izhod videti enak izhodu iz modela priporočil.

Ovijanje obstoječe vsebine

Element lahko postopoma izboljša obstoječe oznake na vaših straneh, tako da lahko obstoječe povezave nadgradite tako, da jih ovijete s <devsite-recommendations> .

Nove povezave bodo prevzele vse funkcije in pravilnike platforme za priporočila, kot so zbiranje podatkov in nadzorne plošče poskusov, vendar bo vsebina nadomeščena tudi z bogatimi metapodatki, vključno z opisi in slikami, in lahko izključuje nekatere povezave (npr. z nadzorovanim dostopom ali strani brez metapodatkov).

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>

Rezultat

Primer skupnosti

Opomba: vse oznake tukaj bodo nadomeščene z uporabniškim vmesnikom s priporočili.

Za več informacij o Google Developers si oglejte naše GDE . Če želite oblikovati skupnost, si oglejte GDG . Nazadnje, če trenutno študirate, ne zamudite naših DSC .

Uporaba v datotekah Markdown

V datoteki Markdown ( .md ) se prepričajte, da je element po meri ovit s standardnim elementom HTML, kot je <section> ali <div> :

Mešana vsebina 

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

Razdelek Markdown

razdelek HTML

Opomba: besedilo povezave je prikazano, ko je JavaScript izklopljen

Vzorčni naslov

Priporočeno

Čisto znižanje

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

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

</devsite-recommendations><pre>

Rezultat

{% dobesedno %} {% endverbatim %}

Vzorčni naslov

{% dobesedno %} {% endverbatim %}

Sistemski atributi

Trenutno so edini podprti atributi za nadzor vedenja sistema in jih običajni uporabniki ne bi smeli potrebovati.

yield (neobvezno) Če je naveden, bo element odstopil od vseh drugih nepopustljivih priporočilnih elementov na strani. To spletno mesto običajno uporablja za samodejno umestitev priporočil na stran, vendar jih prikaže le, ko ni prisotnih drugih primerkov.

Filtriranje z nomenklaturo

Markup 

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

Rezultat