Valdikliai: rekomendacijos

Pasirinktinis elementas <devsite-recommendations> gali būti naudojamas norint skaitytojams teikti turinio rekomendacijas. Galite leisti sistemai generuoti rekomendacijas , galite patys pateikti aiškias rekomendacijas arba galite apvynioti esamas savo dokumento rekomendacijų skiltis, kad pateiktumėte nuosekliai, gautumėte paspaudimų statistiką ir sukurtumėte turtingą vartotojo sąsają (įskaitant aprašymus ir vaizdus).

Naudojimas

Norėdami naudoti šį valdiklį, sukurkite elementą <devsite-recommendations> . Jei norite aiškiai pateikti rekomendacijas, elemente pridėkite keletą nuorodų. Šiuo metu sistemos sugeneruotos rekomendacijos bus pateikiamos, kai elementas yra tuščias, tačiau būsimasis darbas leis autoriams eksperimentuoti su sugeneruotomis rekomendacijomis, kai pateikiamos aiškios rekomendacijos, taip pat naudoti jas kaip įvestis į algoritmą.

Jei pateikiate aiškias rekomendacijas, elemente pateikite tam tikrą žymėjimą. Visos <a> žymos, aptiktos, kai elementas yra prijungtas, bus išskleisti jų href atributai ir naudojami rekomendacijoms.

Jei pateiksite daugiau nei tris rekomendacijas, bus pasirinkta atsitiktinė atranka. Tačiau rekomendacijų tvarka išliks tokia pati kaip įvesties tvarka, todėl aukštesnio prioriteto rekomendacijos visada bus rodomos kairėje pusėje.

Jei nenorite, kad sugeneruotuose rezultatuose būtų rodomos konkrečios rekomendacijos, galite sukurti tuščią elementą <devsite-recommendations> su rinkiniu <link rel="disallow" href="/path"> . Visos <link> žymos su rel=disallow ir href atributu bus automatiškai aptiktos ir pašalintos iš sugeneruotų rekomendacijų.

Jei norite rekomendacijų tik iš konkretaus puslapių pogrupio, rezultatams filtruoti galite naudoti nomenklatūros žymas query lauke. Sintaksė yra k:category:value . Pavyzdžiui, k:kalba:mašinraštis. Žymų sąrašas gali būti kableliais atskirtas sąrašas ( k:language:typescript,k:language:swift ), kad būtų įtraukti puslapiai, kuriuose yra bet kuri žyma.

Tolesniuose skyriuose aprašomas žymėjimas, kaip jis atvaizduojamas įprastomis sąlygomis ir kaip atvaizduojamas įrenginiams arba paprastoms vartotojo priemonėms.

Žymėjimas 

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

Rezultatas

Paprastos vartotojo priemonės

Pastaba: nuorodos tekstas rodomas, kai „JavaScript“ išjungta

Pavyzdys su neleidžiamais

Žymėjimas

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

Rezultatas

Kadangi rezultatai priklauso nuo rekomendacijų, kurios gali keistis, išvestis bus tokia pati kaip rekomendacijų modelio išvestis.

Esamo turinio apvyniojimas

Elementas gali laipsniškai pagerinti esamą žymėjimą jūsų puslapiuose, todėl galite atnaujinti esamas nuorodas apvyniodami jas <devsite-recommendations> .

Naujosiose nuorodose bus pritaikytos visos rekomendacijų platformos funkcijos ir politika, pvz., duomenų rinkimo ir eksperimento informacijos suvestinės, tačiau turinys taip pat bus pakeistas išsamiais metaduomenimis, įskaitant aprašymus ir vaizdus, ​​ir kai kurios nuorodos (pvz., prieiga valdomos arba puslapiai be metaduomenų).

Žymėjimas 

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

Rezultatas

Pavyzdinės bendruomenės

Pastaba: visi čia esantys žymėjimai bus pakeisti rekomendacine vartotojo sąsaja.

Norėdami gauti daugiau informacijos apie „Google Developers“, peržiūrėkite mūsų GDE . Jei norite sukurti bendruomenę, pažiūrėkite į GDG . Galiausiai, jei šiuo metu studijuojate, nepraleiskite mūsų DSC .

Naudojimas Markdown failuose

Markdown ( .md ) faile įsitikinkite, kad tinkintas elementas yra apvyniotas standartiniu HTML elementu, pvz., <section> arba <div> :

Mišrus turinys 

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

Pažymėjimo skyrius

HTML skyrius

Pastaba: nuorodos tekstas rodomas, kai „JavaScript“ išjungta

Antraštės pavyzdys

Rekomenduojama

Grynas sumažinimas

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

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

</devsite-recommendations><pre>

Rezultatas

{% pažodžiui %} {% endverbatim %}

Antraštės pavyzdys

{% pažodžiui %} {% endverbatim %}

Sistemos atributai

Šiuo metu vieninteliai palaikomi atributai yra skirti sistemos elgsenai valdyti ir įprastiems vartotojams jų neturėtų prireikti.

yield (neprivaloma) Jei pateikiamas, elementas pasiduos visiems kitiems neduodantiems rekomendacijų elementams puslapyje. Paprastai tai naudoja pati svetainė, kad puslapyje būtų automatiškai pateikiamos rekomendacijos, tačiau jos rodomos tik tada, kai nėra kitų atvejų.

Filtravimas pagal nomenklatūrą

Žymėjimas 

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

Rezultatas