Widgeti: Preporuke

Prilagođeni element <devsite-recommendations> može se koristiti za pružanje preporuka sadržaja vašim čitateljima. Možete prepustiti sustavu generiranje preporuka , možete sami dati eksplicitne preporuke ili možete zamotati postojeće odjeljke s preporukama u svom dokumentu za dosljednu prezentaciju, statistiku klikanja i bogato korisničko sučelje (uključujući opise i slike).

Korištenje

Za korištenje ovog widgeta stvorite element <devsite-recommendations> . Ako želite eksplicitno dati preporuke, dodajte neke veze unutar elementa. Trenutačno će se sistemski generirane preporuke isporučivati ​​kada je element prazan, ali će budući rad autorima omogućiti eksperimentiranje s generiranim preporukama kada se daju eksplicitne preporuke, kao i njihovo korištenje kao ulaza u algoritam.

Ako dajete eksplicitne preporuke, navedite neke oznake unutar elementa. Sve oznake <a> otkrivene kada je element spojen će imati svoje href atribute ekstrahirane i korištene za preporuke.

Ako dajete više od tri preporuke, bit će odabran slučajni odabir. Međutim, redoslijed preporuka ostat će isti kao i redoslijed unosa, tako da će se preporuke višeg prioriteta uvijek prikazivati ​​krajnje lijevo.

Ako ne želite da se određene preporuke pojavljuju u generiranim rezultatima, možete napraviti prazan element <devsite-recommendations> s kolekcijom <link rel="disallow" href="/path"> . Sve <link> oznake s rel=disallow i href atributom automatski će se otkriti i ukloniti iz generiranih preporuka.

Ako želite samo preporuke s određenog podskupa stranica, možete koristiti oznake nomenklature u polju query za filtriranje rezultata. Sintaksa je k:category:value . Na primjer, k:language:typescript. Popis oznaka može biti popis odvojen zarezima ( k:language:typescript,k:language:swift ) kako bi uključio stranice koje sadrže bilo koju od oznaka.

Sljedeći odjeljci opisuju označavanje, kako se prikazuje u normalnim uvjetima i kako se prikazuje na strojevima ili jednostavnim korisničkim agentima.

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>

Proizlaziti

Jednostavni korisnički agenti

Napomena: tekst veze se prikazuje kada je JavaScript isključen

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

Proizlaziti

Budući da rezultati ovise o preporukama, koje se mogu promijeniti, izlaz će izgledati isto kao i izlaz iz modela preporuka.

Omotavanje postojećeg sadržaja

Element može progresivno poboljšati postojeće oznake na vašim stranicama, tako da možete nadograditi postojeće veze tako da ih omotate s <devsite-recommendations> .

Nove veze će usvojiti sve funkcionalnosti i pravila platforme za preporuke, kao što su prikupljanje podataka i nadzorne ploče eksperimenta, ali sadržaj će također biti zamijenjen bogatim metapodacima uključujući opise i slike, i može isključiti neke veze (npr. kontrolirani pristup ili stranice bez metapodataka).

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>

Proizlaziti

Primjer zajednice

Napomena: Sve oznake ovdje bit će zamijenjene korisničkim sučeljem s preporukama.

Za više informacija o Google Developersu, pogledajte naše GDE-ove . Ako želite formirati zajednicu, pogledajte GDG-ove . Na kraju, ako trenutno učite, ne propustite naše DSC-ove .

Upotreba u Markdown datotekama

U Markdown ( .md ) datoteci provjerite je li prilagođeni element omotan standardnim HTML elementom, kao što je <section> ili <div> :

Mješoviti sadržaj 

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

HTML odjeljak

Napomena: tekst veze se prikazuje kada je JavaScript isključen

Uzorak naslova

Preporučeno

Čisto umanjenje

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

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

</devsite-recommendations><pre>

Proizlaziti

{% doslovno %} {% endverbatim %}

Uzorak naslova

{% doslovno %} {% endverbatim %}

Atributi sustava

Trenutno su jedini podržani atributi za kontrolu ponašanja sustava i normalnim korisnicima ne bi trebali biti potrebni.

yield (izborno) Ako je isporučen, element će se ustupiti svim drugim nepopustljivim elementima preporuke na stranici. To obično koristi sama web-lokacija za automatsko postavljanje preporuka na stranicu, ali da ih prikazuje samo kada nema drugih instanci.

Filtriranje s nomenklaturom

Markup 

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

Proizlaziti