Widget'lar: Öneriler

<devsite-recommendations> özel öğesi, okuyucularınıza içerik önerileri sağlamak için kullanılabilir. Sistemin öneri oluşturmasına izin verebilir, kendiniz belirgin öneriler sağlayabilir veya tutarlı bir sunum, tıklama istatistikleri ve zengin bir kullanıcı arayüzü (açıklamalar ve resimler dahil) için dokümanınızın mevcut öneri bölümlerini sarmalayabilirsiniz.

Kullanım

Bu widget'ı kullanmak için bir <devsite-recommendations> öğesi oluşturun. Önerileri açık bir şekilde sağlamak istiyorsanız öğenin içine bazı bağlantılar ekleyin. Şu anda, sistem tarafından oluşturulan öneriler öğe boş olduğunda sağlanacaktır. Ancak gelecekteki çalışmalar, yazarların açık öneriler sunulduğunda oluşturulan önerilerle denemeler yapmalarına ve bunları algoritmaya girdi olarak kullanmalarına olanak tanıyacaktır.

Açık öneriler sağlıyorsanız öğe içinde işaretleme sağlayın. Öğe bağlandığında algılanan tüm <a> etiketlerinin href özellikleri çıkarılarak öneriler için kullanılır.

Üçten fazla öneri sunuyorsanız rastgele bir seçim yapılır. Ancak önerilerin sıralaması giriş sıralamasıyla aynı kalır. Böylece daha yüksek önceliğe sahip öneriler her zaman en solda gösterilir.

Oluşturulan sonuçlarda belirli önerilerin gösterilmesini istemiyorsanız <link rel="disallow" href="/path"> koleksiyonuyla boş bir <devsite-recommendations> öğesi oluşturabilirsiniz. rel=disallow ve href özelliğine sahip tüm <link> etiketleri otomatik olarak algılanır ve oluşturulan önerilerden kaldırılır.

Yalnızca belirli bir sayfa alt kümesinden öneriler almak istiyorsanız sonuçları filtrelemek için query alanındaki Nomenklatür etiketlerini kullanabilirsiniz. Söz dizimi k:category:value şeklindedir. Örneğin, k:language:typescript. Etiket listesi, etiketlerden herhangi birini içeren sayfaları içermek için virgülle ayrılmış bir liste (k:language:typescript,k:language:swift) olabilir.

Aşağıdaki bölümlerde işaretleme, normal koşullar altında nasıl oluşturulduğu ve makinelere veya basit kullanıcı aracılarına nasıl oluşturulduğu açıklanmaktadır.

Brüt kar

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

Sonuç

Basit kullanıcı aracıları

Not: JavaScript kapalıyken bağlantı metni gösterilir

İzin vermeme içeren örnek

Brüt kar

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

Sonuç

Sonuçlar, önerilere bağlı olduğundan ve bu öneriler değişebileceğinden, sonuç, öneriler modelinden elde edilen çıkışla aynı görünür.

Mevcut içeriği sarmalama

Bu öğe, sayfalarınızdaki mevcut işaretlemeyi aşamalı olarak iyileştirebilir. Böylece, mevcut bağlantıları <devsite-recommendations> ile sarmalayarak yeni sürüme geçirebilirsiniz.

Yeni bağlantılar, öneri platformunun veri toplama ve deneme kontrol panelleri gibi tüm işlevlerini ve politikalarını alacak.Ancak içerikler, açıklamalar ve resimler de dahil olmak üzere zengin meta verilerle değiştirilecek ve bazı bağlantıları (ör. erişim kontrollü veya meta veri içermeyen sayfalar) içermeyebilir.

Brüt kar

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

Sonuç

Örnek topluluklar

Not: Buradaki tüm işaretlemelerin yerini öneri kullanıcı arayüzü alacaktır.

Google Developers hakkında daha fazla bilgi için GDE'lerimize göz atın. Eğer topluluk oluşturmak istiyorsanız GDG'lere göz atın. Son olarak, hâlâ devam ediyorsanız DSC'lerimizi kaçırmayın.

Markdown dosyalarında kullanım

Markdown (.md) dosyasında özel öğenin <section> veya <div> gibi standart bir HTML öğesiyle sarmalandığından emin olun:

Karma içerik

## 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 bölümü

HTML bölümü

Not: JavaScript kapalıyken bağlantı metni gösterilir

Örnek başlık

Önerilen

Saf Markdown

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

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

</devsite-recommendations><pre>

Sonuç

Örnek başlık

ziyaret edin.

Sistem özellikleri

Şu anda yalnızca sistem davranışını kontrol etmek için desteklenen özelliklerdir ve normal kullanıcılar tarafından gerekli kılınmamalıdır.

yield (isteğe bağlı) Bu değer sağlanırsa öğe, sayfadaki getiri vermeyen diğer öneri öğelerine neden olur. Bu yaklaşım, genellikle sitenin kendisi tarafından sayfaya otomatik olarak öneri yerleştirmek için kullanılır. Ancak bu öneriler, yalnızca başka bir örnek mevcut olmadığında gösterilir.

Nomenklatürle Filtreleme

Brüt kar

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

Sonuç