উইজেট: সুপারিশ

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

ফলাফল

সহজ ব্যবহারকারী-এজেন্ট

দ্রষ্টব্য: জাভাস্ক্রিপ্ট বন্ধ থাকলে লিঙ্ক টেক্সট প্রদর্শিত হয়

অস্বীকৃতি সহ উদাহরণ

মার্কআপ

<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 দেখুন। পরিশেষে, আপনি যদি বর্তমানে অধ্যয়ন করছেন, তাহলে আমাদের DSC মিস করবেন না।

মার্কডাউন ফাইলে ব্যবহার

একটি মার্কডাউন ( .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>

মার্কডাউন বিভাগ

এইচটিএমএল বিভাগ

দ্রষ্টব্য: জাভাস্ক্রিপ্ট বন্ধ থাকলে লিঙ্ক টেক্সট প্রদর্শিত হয়

নমুনা শিরোনাম

প্রস্তাবিত

বিশুদ্ধ মার্কডাউন

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

ফলাফল