Widgets: Препоръки

Персонализираният елемент <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: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>

Резултат

Прости потребителски агенти

Забележка: текстът на връзката се показва, когато JavaScript е изключен

Пример с disallows

Маркиране

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

Резултат

Примерни общности

Забележка: Цялото маркиране тук ще бъде заменено с потребителския интерфейс за препоръки.

За повече информация относно Google Developers вижте нашите GDE . Ако искате да създадете общност, погледнете GDGs . И накрая, ако в момента учите, не пропускайте нашите DSC .

Използване във файлове Markdown

Във файл Markdown ( .md ) се уверете, че потребителският елемент е обвит със стандартен HTML елемент, като например <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>

Раздел Markdown

HTML раздел

Забележка: текстът на връзката се показва, когато JavaScript е изключен

Примерно заглавие

Препоръчва се

Чисто намаление

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

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

</devsite-recommendations><pre>

Резултат

{% дословно %} {% endverbatim %}

Примерно заглавие

{% дословно %} {% endverbatim %}

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

Понастоящем единствените поддържани атрибути са за контролиране на поведението на системата и не трябва да са необходими на нормалните потребители.

yield (по избор) Ако е предоставен, елементът ще отстъпи на всички други неподатливи препоръчителни елементи на страницата. Това обикновено се използва от самия сайт за автоматично поставяне на препоръки на страница, но за да ги показва само когато няма други екземпляри.

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

Маркиране 

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

Резултат