Widget: Rekomendasi

Elemen kustom <devsite-recommendations> dapat digunakan untuk memberikan rekomendasi konten kepada pembaca. Anda dapat mengizinkan sistem menghasilkan saran, memberikan sendiri saran eksplisit, atau menggabungkan bagian rekomendasi yang ada pada dokumen agar presentasi, statistik klik-tayang konsisten, dan antarmuka pengguna yang kaya (termasuk deskripsi dan gambar).

Penggunaan

Untuk menggunakan widget ini, buat elemen <devsite-recommendations>. Jika Anda ingin memberikan rekomendasi secara eksplisit, tambahkan beberapa link di dalam elemen tersebut. Saat ini, rekomendasi yang dihasilkan sistem akan diberikan jika elemen ini kosong, tetapi peningkatan mendatang akan memungkinkan penulis bereksperimen dengan rekomendasi yang dihasilkan saat rekomendasi eksplisit diberikan, serta menggunakannya sebagai input untuk algoritma.

Jika Anda memberikan rekomendasi eksplisit, berikan beberapa markup dalam elemen. Setiap tag <a> yang terdeteksi saat elemen terhubung akan memiliki atribut href yang diekstrak dan digunakan untuk rekomendasi.

Jika Anda memberikan lebih dari tiga rekomendasi, pilihan acak akan dipilih. Namun, urutan rekomendasi akan tetap sama dengan pengurutan input, sehingga rekomendasi dengan prioritas yang lebih tinggi akan selalu ditampilkan di paling kiri.

Jika tidak ingin rekomendasi tertentu muncul dalam hasil yang dihasilkan, Anda dapat membuat elemen <devsite-recommendations> kosong dengan kumpulan <link rel="disallow" href="/path">. Setiap tag <link> dengan atribut rel=disallow dan href akan otomatis terdeteksi dan dihapus dari rekomendasi yang dihasilkan.

Jika hanya menginginkan rekomendasi dari subkumpulan halaman tertentu, Anda dapat menggunakan tag Nomenklatur di kolom query untuk memfilter hasil. Sintaksisnya adalah k:category:value. Misalnya, k:language:typescript. Daftar tag dapat berupa daftar yang dipisahkan koma (k:language:typescript,k:language:swift) untuk menyertakan halaman yang berisi salah satu tag.

Bagian berikut menjelaskan markup, cara merendernya dalam kondisi normal, dan cara merendernya ke mesin atau agen pengguna sederhana.

Markup

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

Hasil

Agen pengguna sederhana

Catatan: teks link ditampilkan saat JavaScript nonaktif

Contoh dengan larangan

Markup

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

Hasil

Karena hasilnya bergantung pada rekomendasi, yang dapat berubah, output akan muncul sama dengan output dari model rekomendasi.

Menggabungkan konten yang ada

Elemen ini dapat secara bertahap meningkatkan markup yang ada di halaman, sehingga Anda dapat mengupgrade link yang ada dengan menggabungkannya dengan <devsite-recommendations>.

Link baru akan menggunakan semua fungsi dan kebijakan platform rekomendasi, seperti pengumpulan data dan dasbor eksperimen, tetapi kontennya juga akan diganti dengan metadata yang lengkap, termasuk deskripsi dan gambar, serta dapat mengecualikan beberapa link (misalnya, halaman tanpa metadata dikontrol akses).

Markup

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

Hasil

Contoh komunitas

Catatan: Semua markup di sini akan diganti dengan UI rekomendasi.

Untuk informasi selengkapnya tentang Google Developers, lihat GDE kami. Jika Anda ingin membentuk komunitas, lihat GDG. Terakhir, jika yang sedang Anda pelajari, jangan lewatkan DSC kami.

Penggunaan dalam file Markdown

Dalam file Markdown (.md), pastikan elemen kustom digabungkan dengan elemen HTML standar, seperti <section> atau <div>:

Konten campuran

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

Bagian Markdown

Bagian HTML

Catatan: teks link ditampilkan saat JavaScript nonaktif

Contoh judul

Direkomendasikan

Markdown murni

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

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

</devsite-recommendations><pre>

Hasil

Contoh judul

Atribut sistem

Saat ini, satu-satunya atribut yang didukung adalah untuk mengontrol perilaku sistem dan tidak diperlukan oleh pengguna normal.

yield (opsional) Jika disediakan, elemen ini akan menghasilkan elemen rekomendasi yang tidak menghasilkan apa pun di halaman. Atribut ini biasanya digunakan oleh situs itu sendiri untuk menempatkan rekomendasi secara otomatis di halaman, tetapi hanya menampilkannya saat tidak ada perintah lain.

Pemfilteran dengan Nomenklatur

Markup

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

Hasil