Виџети: Препоруке

Прилагођени елемент <devsite-recommendations> може да се користи за пружање препорука садржаја вашим читаоцима. Можете дозволити систему да генерише препоруке , можете сами да дате експлицитне препоруке или можете да умотате постојеће одељке препорука свог документа ради доследне презентације, статистике кликова и богатог корисничког интерфејса (укључујући описе и слике).

Употреба

Да бисте користили овај виџет, направите елемент <devsite-recommendations> . Ако желите експлицитно да дате препоруке, додајте неке везе унутар елемента. У овом тренутку, системски генерисане препоруке ће бити испоручене када је елемент празан, али будући рад ће омогућити ауторима да експериментишу са генерисаним препорукама када се дају експлицитне препоруке, као и да их користе као инпуте за алгоритам.

Ако дајете експлицитне препоруке, наведите неке ознаке унутар елемента. Било које ознаке <a> које се открију када је елемент повезан ће имати своје href атрибуте издвојене и коришћене за препоруке.

Ако дате више од три препоруке, биће изабран случајни избор. Међутим, редослед препорука ће остати исти као и редослед уноса, тако да ће се препоруке са вишим приоритетом увек приказивати на крајњој левој страни.

Ако не желите да се одређене препоруке појављују у генерисаним резултатима, можете да направите празан елемент <devsite-recommendations> са колекцијом <link rel="disallow" href="/path"> . Све ознаке <link> са rel=disallow и href атрибутом ће аутоматски бити откривене и уклоњене из генерисаних препорука.

Ако желите само препоруке са одређеног подскупа страница, можете користити ознаке номенклатуре у пољу query да бисте филтрирали резултате. Синтакса је k:category:value . На пример, к:лангуаге:типесцрипт. Листа ознака може бити листа раздвојена зарезима ( k:language:typescript,k:language:swift ) да би укључила странице које садрже било коју од ознака.

Следећи одељци описују означавање, како се приказује у нормалним условима и како се приказује машинама или једноставним корисничким агентима.

Маркуп 

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

Резултат

Једноставни кориснички агенти

Напомена: текст везе се приказује када је ЈаваСцрипт искључен

Пример са недозвољеним

Маркуп

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

Резултат

Пошто резултати зависе од препорука, које се могу променити, излаз ће изгледати исто као и излаз из модела препорука.

Умотавање постојећег садржаја

Елемент може прогресивно побољшати постојеће ознаке на вашим страницама, тако да можете надоградити постојеће везе тако што ћете их омотати са <devsite-recommendations> > .

Нове везе ће усвојити све функционалности и политике платформе за препоруке, као што су прикупљање података и контролне табле за експерименте, али ће садржај такође бити замењен богатим метаподацима, укључујући описе и слике, и могу искључити неке везе (нпр. контролисане приступом или странице без метаподатака).

Маркуп 

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

Резултат

Пример заједнице

Напомена: Све ознаке овде ће бити замењене корисничким интерфејсом за препоруке.

За више информација о Гоогле Девелоперс, погледајте наше ГДЕ . Ако желите да формирате заједницу, погледајте ГДГ . На крају, ако тренутно студирате, не пропустите наше ДСЦ .

Употреба у Маркдовн датотекама

У Маркдовн ( .мд ) датотеци, уверите се да је прилагођени елемент умотан у стандардни ХТМЛ елемент, као што је <section> или <div> :

Мешовит садржај 

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

Маркдовн одељак

ХТМЛ одељак

Напомена: текст везе се приказује када је ЈаваСцрипт искључен

Наслов узорка

Препоручено

Чисто смањење

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

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

</devsite-recommendations><pre>

Резултат

{% дословно %} {% ендвербатим %}

Наслов узорка

{% дословно %} {% ендвербатим %}

Системски атрибути

Тренутно су једини подржани атрибути за контролу понашања система и не би требали бити потребни нормалним корисницима.

yield (опционо) Ако је наведен, елемент ће уступити свим другим елементима препоруке на страници који не попуштају. Ово обично користи сам сајт за аутоматско постављање препорука на страницу, али да их прикаже само када нема других инстанци.

Филтрирање са номенклатуром

Маркуп 

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

Резултат