Widgetek: Ajánlások

A <devsite-recommendations> egyéni elem segítségével tartalmi ajánlásokat adhatunk olvasóinak. Hagyhatja, hogy a rendszer ajánlásokat generáljon , saját maga is megadhat egyértelmű ajánlásokat, vagy becsomagolhatja a dokumentum meglévő ajánlási szakaszait a következetes megjelenítés, az átkattintási statisztikák és a gazdag felhasználói felület (beleértve a leírásokat és képeket) érdekében.

Használat

A widget használatához hozzon létre egy <devsite-recommendations> elemet. Ha kifejezetten ajánlásokat szeretne adni, akkor adjon hozzá néhány hivatkozást az elemhez. Jelenleg a rendszer által generált ajánlások akkor jelennek meg, ha az elem üres, de a jövőbeni munka lehetővé teszi a szerzők számára, hogy kísérletezzenek a generált ajánlásokkal, amikor kifejezett ajánlásokat adnak meg, valamint felhasználják azokat az algoritmus bemeneteként.

Ha kifejezett ajánlásokat ad meg, akkor adjon meg némi jelölést az elemen belül. Az elem csatlakoztatásakor észlelt <a> címkék href attribútumait kivonják és felhasználják az ajánlásokhoz.

Ha háromnál több ajánlást ad meg, véletlenszerű kiválasztásra kerül sor. Az ajánlások sorrendje azonban ugyanaz marad, mint a bemeneti sorrend, így a magasabb prioritású ajánlások mindig a bal szélen jelennek meg.

Ha nem szeretné, hogy konkrét ajánlások jelenjenek meg a generált eredmények között, akkor létrehozhat egy üres <devsite-recommendations> elemet a <link rel="disallow" href="/path"> gyűjteményével. rel=disallow és href attribútummal rendelkező <link> címkéket a rendszer automatikusan észleli és eltávolítja a generált ajánlásokból.

Ha csak az oldalak egy meghatározott részhalmazától szeretne ajánlásokat kapni, használhatja a Nomenklatúra címkéit a query mezőben az eredmények szűrésére. A szintaxis: k:category:value . Például: k:language:typescript. A címkék listája lehet vesszővel elválasztott lista ( k:language:typescript,k:language:swift ), amely tartalmazza a címkéket tartalmazó oldalakat.

A következő szakaszok leírják a jelölést, azt, hogyan jelenik meg normál körülmények között, és hogyan jelenik meg gépeken vagy egyszerű felhasználói ügynökökön.

Jelölés 

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

Eredmény

Egyszerű felhasználói ügynökök

Megjegyzés: a hivatkozás szövege akkor jelenik meg, ha a JavaScript ki van kapcsolva

Példa a tiltásokkal

Jelölés

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

Eredmény

Mivel az eredmények az ajánlásoktól függenek, amelyek változhatnak, a kimenet ugyanúgy fog megjelenni, mint az ajánlási modell kimenete.

Meglévő tartalom becsomagolása

Az elem fokozatosan javíthatja a meglévő jelöléseket az oldalakon, így frissítheti a meglévő hivatkozásokat, ha becsomagolja őket <devsite-recommendations> elemre.

Az új hivatkozások átveszik az ajánlási platform összes funkcióját és szabályzatát, például az adatgyűjtést és a kísérleti irányítópultokat, de a tartalmat gazdag metaadatok is helyettesítik , beleértve a leírásokat és képeket, és kizárhatnak néhány hivatkozást (pl. hozzáférés-vezérelt vagy metaadatok nélküli oldalak).

Jelölés 

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

Eredmény

Példaközösségek

Megjegyzés: Az itt található összes jelölést a javasolt felhasználói felület helyettesíti.

A Google Developers szolgáltatással kapcsolatos további információkért tekintse meg GDE- inket . Ha közösséget szeretne létrehozni, vessen egy pillantást a GDG-kre . Végül, ha éppen tanul, ne hagyja ki DSC-inket .

Használat Markdown fájlokban

Egy Markdown ( .md ) fájlban győződjön meg arról, hogy az egyéni elem egy szabványos HTML-elemmel van burkolva, például egy <section> vagy <div> :

Vegyes tartalom 

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

Leértékelés szakasz

HTML szakasz

Megjegyzés: a hivatkozás szövege akkor jelenik meg, ha a JavaScript ki van kapcsolva

Minta címsor

Ajánlott

Tiszta leárazás

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

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

</devsite-recommendations><pre>

Eredmény

{% szó szerint %} {% endverbatim %}

Minta címsor

{% szó szerint %} {% endverbatim %}

Rendszer attribútumok

Jelenleg az egyetlen támogatott attribútum a rendszer viselkedésének vezérlésére szolgál, és a normál felhasználóknak nem kell rájuk szükségük.

yield (opcionális) Ha megadja, az elem engedni fog az oldalon lévő többi, nem hozó ajánlási elemnek. Ezt általában maga a webhely használja arra, hogy automatikusan ajánlásokat helyezzen el egy oldalon, de csak akkor jelenítse meg őket, ha nincs jelen más példány.

Szűrés nómenklatúrával

Jelölés 

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

Eredmény