Віджети: Рекомендації

Спеціальний елемент <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 вимкнено

Приклад із забороною

Розмітка

<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 . Якщо ви хочете створити спільноту, подивіться на GDG . Нарешті, якщо ви зараз навчаєтеся, не пропустіть наші 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>

Розділ уцінки

розділ 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>

Результат