Widgetit: Suositukset

Mukautettua <devsite-recommendations> -elementtiä voidaan käyttää sisältösuositusten antamiseen lukijoillesi. Voit antaa järjestelmän luoda suosituksia , voit antaa nimenomaisia ​​suosituksia itse tai voit kääriä asiakirjasi olemassa olevat suositusosiot johdonmukaista esitystä, napsautustilastoja ja monipuolista käyttöliittymää varten (mukaan lukien kuvaukset ja kuvat).

Käyttö

Voit käyttää tätä widgetiä luomalla <devsite-recommendations> -elementin. Jos haluat antaa suosituksia nimenomaisesti, lisää elementtiin linkkejä. Tällä hetkellä järjestelmän luomat suositukset toimitetaan, kun elementti on tyhjä, mutta tulevassa työssä kirjoittajat voivat kokeilla luotuja suosituksia, kun nimenomaisia ​​suosituksia annetaan, sekä käyttää niitä syötteinä algoritmiin.

Jos annat nimenomaisia ​​suosituksia, anna elementin sisällä merkintä. Kaikki <a> -tunnisteet, jotka havaitaan, kun elementti yhdistetään, niiden href attribuutit puretaan ja niitä käytetään suosituksiin.

Jos annat enemmän kuin kolme suositusta, valitaan satunnainen valinta. Suositusten järjestys pysyy kuitenkin samana kuin syötteiden järjestys, joten korkeamman prioriteetin suositukset näkyvät aina vasemmalla.

Jos et halua tiettyjen suositusten näkyvän luoduissa tuloksissa, voit tehdä tyhjän <devsite-recommendations> -elementin kokoelmalla <link rel="disallow" href="/path"> . Kaikki <link> -tunnisteet, joissa on rel=disallow ja href attribuutti, tunnistetaan automaattisesti ja poistetaan luoduista suosituksista.

Jos haluat vain suosituksia tietystä sivujoukosta, voit suodattaa tulokset käyttämällä query Nimikkeistön tunnisteita. Syntaksi on k:category:value . Esimerkiksi k:kieli:konekirjoitus. Tunnisteiden luettelo voi olla pilkuilla eroteltu luettelo ( k:language:typescript,k:language:swift ), joka sisältää sivut, jotka sisältävät minkä tahansa tunnisteen.

Seuraavissa osissa kuvataan merkintä, kuinka se hahmonnetaan normaaleissa olosuhteissa ja miten se hahmonnetaan koneille tai yksinkertaisille käyttäjäagenteille.

Merkintä 

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

Tulos

Yksinkertaiset käyttäjäagentit

Huomautus: linkkiteksti näytetään, kun JavaScript ei ole käytössä

Esimerkki kielloista

Merkintä

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

Tulos

Koska tulokset ovat riippuvaisia ​​suosituksista, jotka voivat muuttua, tulos näyttää samalta kuin suositusmallin tulos.

Olemassa olevan sisällön kääriminen

Elementti voi asteittain parantaa sivujesi olemassa olevia merkintöjä, joten voit päivittää olemassa olevia linkkejä käärimällä ne <devsite-recommendations> .

Uudet linkit ottavat käyttöön kaikki suositusalustan toiminnot ja käytännöt, kuten tiedonkeruu- ja kokeiluhallintapaneelit, mutta sisältö korvataan myös monipuolisilla metatiedoilla, mukaan lukien kuvaukset ja kuvat, ja ne voivat sulkea pois joitain linkkejä (esim. sivut ilman metatietoja).

Merkintä 

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

Tulos

Esimerkkiyhteisöt

Huomautus: Kaikki merkinnät tässä korvataan suosituskäyttöliittymällä.

Lisätietoja Google-kehittäjistä on GDE :ssämme. Jos haluat muodostaa yhteisön, katso GDG :t . Lopuksi, jos opiskelet parhaillaan, älä missaa DSC: itämme .

Käyttö Markdown-tiedostoissa

Varmista Markdown ( .md ) -tiedostossa, että mukautettu elementti on kääritty tavallisella HTML-elementillä, kuten <section> tai <div> :

Sekalaista sisältöä 

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

HTML-osio

Huomautus: linkkiteksti näytetään, kun JavaScript on pois päältä

Esimerkkiotsikko

Suositeltava

Puhdasta hinnanalennusta

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

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

</devsite-recommendations><pre>

Tulos

{% sanatarkasti %} {% endverbatim %}

Esimerkkiotsikko

{% sanatarkasti %} {% endverbatim %}

Järjestelmän attribuutit

Tällä hetkellä ainoat tuetut attribuutit ovat järjestelmän toiminnan ohjaamiseen, eikä tavallisten käyttäjien pitäisi tarvita niitä.

yield (valinnainen) Jos elementti toimitetaan, se alistuu sivun muille ei-tuoton suosituselementeille. Sivusto itse käyttää tätä tyypillisesti sijoittaakseen suosituksia sivulle automaattisesti, mutta näyttääkseen ne vain, kun muita esiintymiä ei ole.

Suodatus nimikkeistön mukaan

Merkintä 

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

Tulos