ابزارک ها: توصیه ها

عنصر سفارشی <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>

نتیجه

عامل های کاربر ساده

توجه: وقتی جاوا اسکریپت خاموش است، متن پیوند نمایش داده می شود

مثال با غیر مجاز

نشانه گذاری

<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

توجه: وقتی جاوا اسکریپت خاموش است، متن پیوند نمایش داده می شود

عنوان نمونه

توصیه می شود

نشانه گذاری خالص

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

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

</devsite-recommendations><pre>

نتیجه

{% کلمه به کلمه %} {% آخر کلمه %}

عنوان نمونه

  • توجه: وقتی جاوا اسکریپت خاموش است، متن پیوند نمایش داده می شود
  • اسناد نقشه ها
{% کلمه به کلمه %} {% آخر کلمه %}

ویژگی های سیستم

در حال حاضر تنها ویژگی های پشتیبانی شده برای کنترل رفتار سیستم است و نباید توسط کاربران عادی مورد نیاز باشد.

yield (اختیاری) در صورت ارائه، عنصر به سایر عناصر پیشنهادی غیر بازده در صفحه تسلیم می شود. این معمولاً توسط خود سایت برای قرار دادن خودکار توصیه‌ها در یک صفحه استفاده می‌شود، اما فقط زمانی که هیچ نمونه دیگری وجود ندارد، آنها را نشان می‌دهد.

فیلتر کردن با نامگذاری

نشانه گذاری 

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

نتیجه