Widgety: Doporučení

Vlastní prvek <devsite-recommendations> lze použít k poskytování doporučení obsahu vašim čtenářům. Můžete nechat systém generovat doporučení , můžete sami poskytovat explicitní doporučení nebo můžete zabalit existující sekce doporučení ve svém dokumentu pro konzistentní prezentaci, statistiky prokliku a bohaté uživatelské rozhraní (včetně popisů a obrázků).

Používání

Chcete-li použít tento widget, vytvořte prvek <devsite-recommendations> . Pokud chcete poskytovat doporučení explicitně, přidejte do prvku nějaké odkazy. V současnosti budou systémem generovaná doporučení dodávána, když je prvek prázdný, ale budoucí práce umožní autorům experimentovat s vygenerovanými doporučeními, když jsou dodána explicitní doporučení, a také je používat jako vstupy do algoritmu.

Pokud dodáváte explicitní doporučení, poskytněte v rámci prvku nějaké označení. U všech značek <a> zjištěných při připojení prvku budou extrahovány atributy href a použity pro doporučení.

Pokud dodáváte více než tři doporučení, bude vybrán náhodný výběr. Pořadí doporučení však zůstane stejné jako řazení vstupů, takže doporučení s vyšší prioritou se vždy zobrazí zcela vlevo.

Pokud nechcete, aby se ve vygenerovaných výsledcích objevovala konkrétní doporučení, můžete vytvořit prázdný prvek <devsite-recommendations> s kolekcí <link rel="disallow" href="/path"> . Jakékoli značky <link> s rel=disallow a atributem href budou automaticky detekovány a odstraněny z generovaných doporučení.

Pokud chcete doporučení pouze z určité podmnožiny stránek, můžete k filtrování výsledků použít značky nomenklatury v poli query . Syntaxe je k:category:value . Například k:language:typescript. Seznam značek může být čárkami oddělený seznam ( k:language:typescript,k:language:swift ), aby zahrnoval stránky, které obsahují některou ze značek.

Následující části popisují označení, jak se vykresluje za normálních podmínek a jak se vykresluje strojům nebo jednoduchým uživatelským agentům.

Označení 

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

Výsledek

Jednoduché uživatelské agenty

Poznámka: Text odkazu se zobrazí, když je vypnutý JavaScript

Příklad s disallows

Označení

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

Výsledek

Protože výsledky jsou závislé na doporučeních, která se mohou měnit, bude výstup vypadat stejně jako výstup z modelu doporučení.

Obtékání existujícího obsahu

Prvek může progresivně vylepšovat stávající označení na vašich stránkách, takže můžete upgradovat existující odkazy tak, že je obalíte pomocí <devsite-recommendations> .

Nové odkazy převezmou všechny funkce a zásady platformy doporučení, jako je sběr dat a řídicí panely experimentů, ale obsah bude také nahrazen bohatými metadaty včetně popisů a obrázků a může vyloučit některé odkazy (např. stránky bez metadat).

Označení 

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

Výsledek

Příklad komunit

Poznámka: Veškeré značky zde budou nahrazeny uživatelským rozhraním doporučení.

Další informace o Google Developers naleznete v našich GDE . Pokud chcete vytvořit komunitu, podívejte se na GDGs . A konečně, pokud právě studujete, nenechte si ujít naše DSC .

Použití v souborech Markdown

V souboru Markdown ( .md ) se ujistěte, že je vlastní prvek zabalen do standardního prvku HTML, jako je <section> nebo <div> :

Smíšený obsah 

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

Sekce Markdown

HTML sekce

Poznámka: Text odkazu se zobrazí, když je vypnutý JavaScript

Ukázkový nadpis

Doporučeno

Čistá markdown

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

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

</devsite-recommendations><pre>

Výsledek

{% doslovně %} {% endverbatim %}

Ukázkový nadpis

  • Poznámka: Text odkazu se zobrazí, když je vypnutý JavaScript
  • Dokumentace map
{% doslovně %} {% endverbatim %}

Systémové atributy

V současnosti jsou jedinými podporovanými atributy pro řízení chování systému a běžní uživatelé by je neměli potřebovat.

yield (nepovinné) Je-li dodán, prvek se podvolí všem dalším nepoddajným prvkům doporučení na stránce. To obvykle používá samotný web k automatickému umístění doporučení na stránku, ale k jejich zobrazení pouze v případě, že nejsou přítomny žádné další instance.

Filtrování pomocí nomenklatury

Označení 

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

Výsledek