وجیٹس: سفارشات

<devsite-recommendations> حسب ضرورت عنصر آپ کے قارئین کو مواد کی سفارشات فراہم کرنے کے لیے استعمال کیا جا سکتا ہے۔ آپ سسٹم کو سفارشات تیار کرنے دے سکتے ہیں، آپ خود واضح سفارشات فراہم کر سکتے ہیں، یا آپ مستقل پیشکش، کلک کے ذریعے اعداد و شمار اور ایک بھرپور صارف انٹرفیس (بشمول تفصیل اور تصاویر) کے لیے اپنے دستاویز کے موجودہ سفارشی حصوں کو لپیٹ سکتے ہیں۔

استعمال

اس ویجیٹ کو استعمال کرنے کے لیے، ایک <devsite-recommendations> عنصر بنائیں۔ اگر آپ واضح طور پر سفارشات فراہم کرنا چاہتے ہیں، تو عنصر کے اندر کچھ لنکس شامل کریں۔ فی الحال، عنصر کے خالی ہونے پر سسٹم سے تیار کردہ سفارشات فراہم کی جائیں گی، لیکن مستقبل کا کام مصنفین کو تیار کردہ سفارشات کے ساتھ تجربہ کرنے کی اجازت دے گا جب واضح سفارشات فراہم کی جائیں گی، اور ساتھ ہی انہیں الگورتھم میں ان پٹ کے طور پر استعمال کیا جائے گا۔

اگر آپ واضح سفارشات فراہم کر رہے ہیں، تو عنصر کے اندر کچھ مارک اپ فراہم کریں۔ عنصر کے منسلک ہونے پر کسی بھی <a> ٹیگز کا پتہ چلا ان کی href کی خصوصیات کو نکالا جائے گا اور سفارشات کے لیے استعمال کیا جائے گا۔

اگر آپ تین سے زیادہ سفارشات فراہم کر رہے ہیں، تو بے ترتیب انتخاب کا انتخاب کیا جائے گا۔ تاہم، سفارشات کی ترتیب ان پٹ آرڈرنگ کی طرح ہی رہے گی، لہذا اعلی ترجیحی سفارشات ہمیشہ بائیں جانب دکھائی دیں گی۔

اگر آپ نہیں چاہتے کہ تیار کردہ نتائج میں مخصوص سفارشات ظاہر ہوں، تو آپ <link rel="disallow" href="/path"> کے مجموعہ کے ساتھ ایک خالی <devsite-recommendations> عنصر بنا سکتے ہیں۔ rel=disallow اور an href انتساب کے ساتھ کوئی بھی <link> ٹیگز خود بخود پتہ چل جائے گا اور تیار کردہ سفارشات سے ہٹا دیا جائے گا۔

اگر آپ صرف صفحات کے مخصوص ذیلی سیٹ سے سفارشات چاہتے ہیں، تو آپ نتائج کو فلٹر کرنے کے لیے query خانے میں Nomenclature ٹیگ استعمال کر سکتے ہیں۔ نحو ہے 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>

نتیجہ

مثالی کمیونٹیز

نوٹ: یہاں موجود تمام مارک اپ کو تجویز کردہ UI سے بدل دیا جائے گا۔

Google Developers کے بارے میں مزید معلومات کے لیے، ہمارے GDEs کو دیکھیں۔ اگر آپ ایک کمیونٹی بنانا چاہتے ہیں تو GDGs پر ایک نظر ڈالیں۔ آخر میں، اگر آپ فی الحال پڑھ رہے ہیں، تو ہمارے DSCs کو مت چھوڑیں۔

مارک ڈاؤن فائلوں میں استعمال

مارک ڈاؤن ( .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>

نتیجہ

{% لفظی %} {% endverbatim %}

نمونہ کی سرخی

{% لفظی %} {% endverbatim %}

سسٹم کی خصوصیات

فی الحال صرف تائید شدہ صفات سسٹم کے رویے کو کنٹرول کرنے کے لیے ہیں اور عام صارفین کو اس کی ضرورت نہیں ہونی چاہیے۔

yield (اختیاری) اگر فراہم کیا جاتا ہے، تو عنصر صفحہ پر موجود کسی بھی غیر پیداواری سفارشی عناصر کو ملے گا۔ یہ عام طور پر سائٹ خود بخود کسی صفحہ پر سفارشات رکھنے کے لیے استعمال کرتی ہے، لیکن انہیں صرف اس وقت دکھانے کے لیے جب کوئی دوسری مثال موجود نہ ہو۔

نام کے ساتھ فلٹر کرنا

مارک اپ 

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

نتیجہ