विजेट: सुझाव

<devsite-recommendations> कस्टम एलिमेंट का इस्तेमाल, आपकी ऑडियंस को कॉन्टेंट के सुझाव देने के लिए किया जा सकता है. आपके पास सिस्टम से सुझाव जनरेट करने का विकल्प होता है या आपको खुद ही साफ़ तौर पर सुझाव देने की सुविधा मिलती है. इसके अलावा, अपने दस्तावेज़ के मौजूदा सुझावों वाले सेक्शन को रैप किया जा सकता है, ताकि उपयोगकर्ताओं को लगातार बेहतर सुझाव दिए जा सकें. साथ ही, क्लिक मिलने की जानकारी देने वाले आंकड़ों और रिच यूज़र इंटरफ़ेस (जानकारी और इमेज के साथ) का डेटा भी एक जैसा रखा जा सके.

इस्तेमाल

इस विजेट का इस्तेमाल करने के लिए, <devsite-recommendations> एलिमेंट बनाएं. अगर आपको साफ़ तौर पर सुझाव देने हैं, तो एलिमेंट में कुछ लिंक जोड़ें. फ़िलहाल, एलिमेंट खाली होने पर सिस्टम से जनरेट किए गए सुझाव दिए जाएंगे. हालांकि, आने वाले समय में जब साफ़ तौर पर सुझाव दिए जाएंगे, तो लेखकों को जनरेट किए गए सुझावों को आज़माने की सुविधा मिलेगी. साथ ही, एल्गोरिदम में इनपुट के तौर पर उनका इस्तेमाल भी किया जा सकेगा.

अगर आपने साफ़ तौर पर जानकारी देने वाले सुझाव दिए हैं, तो एलिमेंट में कुछ मार्कअप जोड़ें. एलिमेंट के कनेक्ट होने के बाद, <a> टैग का पता चलने पर, उनके href एट्रिब्यूट को एक्सट्रैक्ट किया जाएगा. साथ ही, इनका इस्तेमाल सुझावों के लिए किया जाएगा.

अगर आपने तीन से ज़्यादा सुझाव दिए हैं, तो आपको बिना किसी क्रम के कुछ चुनने का विकल्प मिलेगा. हालांकि, सुझावों का क्रम, इनपुट के क्रम जैसा ही रहेगा. इसलिए, ज़्यादा प्राथमिकता वाले सुझाव हमेशा बाईं ओर दिखेंगे.

अगर आपको जनरेट किए गए नतीजों में कुछ खास सुझाव नहीं दिखाने हैं, तो <link rel="disallow" href="/path"> के कलेक्शन के साथ खाली <devsite-recommendations> एलिमेंट बनाएं. rel=disallow और href एट्रिब्यूट वाले किसी भी <link> टैग का पता अपने-आप लग जाएगा और उन्हें जनरेट किए गए सुझावों से हटा दिया जाएगा.

अगर आपको पेजों के किसी खास सबसेट से ही सुझाव चाहिए, तो नतीजों को फ़िल्टर करने के लिए, 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>

नतीजा

सिंपल यूज़र एजेंट

ध्यान दें: JavaScript बंद होने पर लिंक टेक्स्ट दिखता है

अस्वीकार किए गए प्रॉडक्ट का उदाहरण

मार्कअप

<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 पर एक नज़र डालें. आख़िर में, अगर फ़िलहाल, आप पढ़ाई कर रहे हैं. इसलिए, हमारे डीएससी सेक्शन को देखना न भूलें.

Markdown फ़ाइलों का इस्तेमाल किया जा रहा है

Markdown (.md) फ़ाइल में, यह पक्का करें कि कस्टम एलिमेंट को स्टैंडर्ड एचटीएमएल एलिमेंट के साथ रैप किया गया हो, जैसे कि <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>

मार्कडाउन सेक्शन

एचटीएमएल सेक्शन

ध्यान दें: JavaScript बंद होने पर लिंक टेक्स्ट दिखता है

सैंपल हेडिंग

सुझाव

प्योर मार्कडाउन

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

नतीजा