Logrīki: ieteikumi

Pielāgoto elementu <devsite-recommendations> var izmantot, lai lasītājiem sniegtu satura ieteikumus. Varat ļaut sistēmai ģenerēt ieteikumus , varat pats sniegt precīzus ieteikumus vai iekļaut esošās dokumenta ieteikumu sadaļas, lai nodrošinātu konsekventu prezentāciju, klikšķu statistiku un bagātīgu lietotāja interfeisu (tostarp aprakstus un attēlus).

Lietošana

Lai izmantotu šo logrīku, izveidojiet elementu <devsite-recommendations> . Ja vēlaties sniegt skaidrus ieteikumus, pievienojiet elementā dažas saites. Pašlaik sistēmas ģenerētie ieteikumi tiks sniegti, kad elements ir tukšs, bet turpmākais darbs ļaus autoriem eksperimentēt ar ģenerētiem ieteikumiem, kad tiek sniegti skaidri ieteikumi, kā arī izmantot tos kā algoritma ievadi.

Ja sniedzat skaidrus ieteikumus, elementā norādiet dažus marķējumus. Jebkuru <a> tagu, kas tiek atklāts, kad elements ir pievienots, atribūti href tiks izvilkti un izmantoti ieteikumiem.

Ja sniedzat vairāk nekā trīs ieteikumus, tiks izvēlēta nejauša atlase. Tomēr ieteikumu secība paliks tāda pati kā ievades secība, tāpēc augstākas prioritātes ieteikumi vienmēr tiks rādīti vistālāk kreisajā pusē.

Ja nevēlaties, lai ģenerētajos rezultātos tiktu parādīti konkrēti ieteikumi, varat izveidot tukšu <devsite-recommendations> elementu ar <link rel="disallow" href="/path"> kolekciju. Visi tagi <link> ar rel=disallow un href atribūtu tiks automātiski noteikti un noņemti no ģenerētajiem ieteikumiem.

Ja vēlaties ieteikumus tikai no noteiktas lapu apakškopas, query laukā varat izmantot nomenklatūras tagus, lai filtrētu rezultātus. Sintakse ir k:category:value . Piemēram, k:language:typescript. Tagu saraksts var būt ar komatu atdalīts saraksts ( k:language:typescript,k:language:swift ), lai iekļautu lapas, kurās ir kāds no tagiem.

Nākamajās sadaļās ir aprakstīts marķējums, kā tas tiek renderēts normālos apstākļos un kā tas tiek renderēts iekārtām vai vienkāršiem lietotāja aģentiem.

Marķējums 

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

Rezultāts

Vienkārši lietotāja aģenti

Piezīme: saites teksts tiek parādīts, kad JavaScript ir izslēgts

Piemērs ar aizliegumiem

Marķējums

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

Rezultāts

Tā kā rezultāti ir atkarīgi no ieteikumiem, kas var mainīties, izvade būs tāda pati kā ieteikumu modeļa izvade.

Esošā satura iesaiņošana

Elements var pakāpeniski uzlabot esošo marķējumu jūsu lapās, lai jūs varētu jaunināt esošās saites, iesaiņojot tās ar <devsite-recommendations> .

Jaunajās saitēs tiks izmantotas visas ieteikumu platformas funkcionalitātes un politikas, piemēram, datu vākšanas un eksperimentu informācijas paneļi, taču saturs tiks aizstāts arī ar bagātīgiem metadatiem, tostarp aprakstiem un attēliem, un var tikt izslēgtas dažas saites (piemēram, piekļuves kontrolētas vai lapas bez metadatiem).

Marķējums 

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

Rezultāts

Piemēri kopienas

Piezīme. Visi šeit esošie marķējumi tiks aizstāti ar ieteikuma lietotāja saskarni.

Lai iegūtu plašāku informāciju par Google Developers, skatiet mūsu GDE . Ja vēlaties izveidot kopienu, apskatiet GDG . Visbeidzot, ja pašlaik studējat, nepalaidiet garām mūsu DSC .

Lietošana Markdown failos

Markdown ( .md ) failā pārliecinieties, vai pielāgotais elements ir ietīts ar standarta HTML elementu, piemēram, <section> vai <div> :

Jaukts saturs 

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

Atzīmes sadaļa

HTML sadaļa

Piezīme: saites teksts tiek parādīts, kad JavaScript ir izslēgts

Virsraksta paraugs

Ieteicams

Tīra atzīme

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

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

</devsite-recommendations><pre>

Rezultāts

{% burtiski %} {% endverbatim %}

Virsraksta paraugs

{% burtiski %} {% endverbatim %}

Sistēmas atribūti

Pašlaik vienīgie atbalstītie atribūti ir paredzēti sistēmas uzvedības kontrolei, un parastiem lietotājiem tie nav vajadzīgi.

yield (neobligāti) Ja tiek nodrošināts, elements tiks pakļauts visiem citiem lapas ieteikuma elementiem, kas nav ienesīgi. To parasti izmanto pati vietne, lai lapā automātiski ievietotu ieteikumus, bet lai tie tiktu rādīti tikai tad, ja nav citu gadījumu.

Filtrēšana ar nomenklatūru

Marķējums 

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

Rezultāts