পৃষ্ঠা মেটাডেটা
একটি DevSite পৃষ্ঠা হল একটি সাইটের সামগ্রীর একটি একক। একটি পৃষ্ঠার একটি শিরোনাম, একটি বডি, হেডার উপাদান এবং মেটাডেটা বৈশিষ্ট্য থাকতে পারে যা সাইটের বৈশিষ্ট্যগুলিকে নিয়ন্ত্রণ করে৷ যখন একজন ব্যবহারকারী একটি পৃষ্ঠার URL পরিদর্শন করে, তখন সাইটটি বিষয়বস্তু পৃষ্ঠার বৈশিষ্ট্যের উপর ভিত্তি করে একটি সম্পূর্ণ ওয়েব পৃষ্ঠা রেন্ডার করে, শিরোনাম, ফুটার এবং সাইডবারের মতো গতিশীল উপাদান যোগ করে। ডিফল্ট আচরণগুলি প্রযুক্তিগত ডকুমেন্টেশনের পৃষ্ঠাগুলির জন্য অপ্টিমাইজ করা হয়, তবে একটি পৃষ্ঠা অন্যান্য ব্যবহারের জন্যও কনফিগার করা যেতে পারে, যেমন মার্কেটিং এবং ল্যান্ডিং পৃষ্ঠাগুলি।
একটি পৃষ্ঠার গঠন
একটি DevSite পৃষ্ঠা হল একটি ওয়েব পৃষ্ঠা যার সাধারণ চেহারা এবং বৈশিষ্ট্যগুলি সাইট দ্বারা পরিচালিত হয়৷ Google Developers- এ একটি পৃষ্ঠা বিভিন্ন সাধারণ এলাকা সহ প্রদর্শিত হয়। (সব সাইট সব বৈশিষ্ট্য সমর্থন করে না।) লেবেলের জন্য ডায়াগ্রামের উপর আপনার মাউস ঘোরান।
site header
সাইটের লোগো, সাইন-ইন উইজেট, সার্চ বক্স এবং টপ নেভি। পুরো সাইট জুড়ে সাধারণ।
project bar
প্রকল্প বা পণ্যের শিরোনাম, এবং প্রকল্প-নির্দিষ্ট উইজেট (যেমন "প্রতিক্রিয়া" লিঙ্ক)। এই এলাকাটি প্রকল্পের মেটাডেটা দ্বারা সংজ্ঞায়িত করা হয়।
sidebar
বই-বিস্তৃত অনুক্রমিক নেভিগেশন। এই এলাকাটি বই মেটাডেটা দ্বারা সংজ্ঞায়িত করা হয়।
body
পৃষ্ঠার শিরোনাম এবং পৃষ্ঠার বিষয়বস্তু।
page footer ("last updated")
পৃষ্ঠা-নির্দিষ্ট উইজেট (যেমন "শেষ আপডেট করা" বিজ্ঞপ্তি)। একটি CC লাইসেন্স বিজ্ঞপ্তিও থাকতে পারে, যা একটি প্রকল্প মেটাডেটা বৈশিষ্ট্য।
site footer
সাইট ফুটার লিঙ্ক, ভাষা নির্বাচন উইজেট. পুরো সাইট জুড়ে সাধারণ।
এইচটিএমএল সোর্স ফাইল
<html devsite>
<head>
<title>Page title</title>
<meta name="project_path" value="/path/to/_project.yaml" />
<meta name="book_path" value="/path/to/_book.yaml" />
</head>
<body>
<p>Body content goes here, implemented as HTML.</p>
</body>
</html>
<html> এলিমেন্টের devsite অ্যাট্রিবিউটটি DevSite কে বলে যে এটি একটি DevSite পৃষ্ঠা হিসাবে রেন্ডার করা উচিত এবং একটি HTML সম্পদ হিসাবে শব্দার্থে নয়। যদি আপনার পৃষ্ঠাটি ফরম্যাটিং বা শিরোনাম বা ফুটার ছাড়াই প্রদর্শিত হয়, তাহলে দেখুন যে <html devsite> আপনার ফাইলের শীর্ষের কাছে উপস্থিত হচ্ছে।
<html> , <head> , এবং <body> উপাদানগুলির প্রয়োজন এবং অবশ্যই খোলা এবং বন্ধ করার ট্যাগ থাকতে হবে৷
একটি সাধারণ পৃষ্ঠায় অবশ্যই একটি <title> উপাদান থাকতে হবে, <head> এর ভিতরে। পৃষ্ঠার শিরোনাম দেখুন।
নির্দিষ্ট <meta> ট্যাগ নিয়ন্ত্রণ পৃষ্ঠা বৈশিষ্ট্য. এগুলো এই রেফারেন্সে বর্ণনা করা হয়েছে। একটি সাধারণ পৃষ্ঠায় একটি "project_path" মেটা ট্যাগ থাকে, যা একটি _project.yaml মেটাডেটা ফাইল এবং একটি "book_path" মেটা ট্যাগকে নির্দেশ করে, যা একটি _book.yaml মেটাডেটা ফাইলকে নির্দেশ করে। প্রকল্প এবং বই দেখুন। DevSite দ্বারা স্বীকৃত <meta> ট্যাগগুলি সাধারণত চূড়ান্ত পৃষ্ঠায় প্রদর্শিত হয় না।
<head> এর অন্যান্য উপাদান এবং <body> এর সমস্ত উপাদান চূড়ান্ত পৃষ্ঠায় রেন্ডার করা হয়েছে।
মার্কডাউন সোর্স ফাইল
Project: /path/to/_project.yaml
Book: /path/to/_book.yaml
# Page title
Body content, specified in Markdown, goes here.
একটি সাধারণ পৃষ্ঠার একটি শিরোনাম থাকতে হবে (যেমন, # Page title )। পৃষ্ঠার শিরোনাম দেখুন।
নির্দিষ্ট মেটা ট্যাগ নিয়ন্ত্রণ পৃষ্ঠা বৈশিষ্ট্য. এগুলো এই রেফারেন্সে বর্ণনা করা হয়েছে। একটি সাধারণ পৃষ্ঠায় একটি Project: মেটা ট্যাগ থাকে, যা একটি _project.yaml মেটাডেটা ফাইল এবং একটি Book: মেটা ট্যাগ, যা একটি _book.yaml মেটাডেটা ফাইলকে বোঝায়। প্রকল্প এবং বই দেখুন। DevSite দ্বারা স্বীকৃত মেটা ট্যাগগুলি সাধারণত চূড়ান্ত পৃষ্ঠায় উপস্থিত হয় না৷
প্রকল্প এবং বই
একটি প্রকল্পকে _project.yaml নামে একটি প্রকল্প মেটাডেটা ফাইল দ্বারা বর্ণনা করা হয়। একটি বই _book.yaml নামে একটি বই মেটাডেটা ফাইল দ্বারা বর্ণনা করা হয়। এই ফাইলগুলি পৃষ্ঠা এবং সম্পদ ফাইল সহ সাইটে প্রকাশিত হয় এবং একাধিক ভাষায় অনুবাদ করা যেতে পারে। এই ফাইলগুলির গঠন এবং বৈশিষ্ট্য সম্পর্কে তথ্যের জন্য প্রকল্প মেটাডেটা এবং বুক মেটাডেটা দেখুন।
একটি প্রকল্পের সাথে একটি পৃষ্ঠা সংযুক্ত করতে, project_path বৈশিষ্ট্য প্রদান করুন। এর মান হল _project.yaml ফাইলের বিষয়বস্তুর পথ।
এইচটিএমএল
<meta name="project_path" value="/path/to/_project.yaml" />
মার্কডাউন
Project: /path/to/_project.yaml
যদি একটি পৃষ্ঠায় একটি project_path বৈশিষ্ট্য না থাকে তবে এটি প্রকল্প বার অঞ্চল এবং এর বৈশিষ্ট্যগুলি ছাড়াই রেন্ডার করা হবে। পৃষ্ঠাটি একটি প্রকল্পের অংশ হিসাবে বিবেচিত হবে না।
একটি বইয়ের সাথে একটি পৃষ্ঠা সংযুক্ত করতে, book_path বৈশিষ্ট্য প্রদান করুন। এর মান হল _book.yaml ফাইলের কন্টেন্ট পাথ।
এইচটিএমএল
<meta name="book_path" value="/path/to/_book.yaml" />
মার্কডাউন
Book: /path/to/_book.yaml
পৃষ্ঠার শিরোনাম
<head>
<title>Page title</title>
...
</head>
অথবা পৃষ্ঠার <body> এ page-title শ্রেণীর সাথে একটি <h1> উপাদান ব্যবহার করুন।
এইচটিএমএল
<h1 class="page-title">Page title</h1>
মার্কডাউন
# Page title
প্রকল্প হোম পেজ শিরোনাম প্রয়োজন হয় না,
এইচটিএমএল
<meta name="no_page_title" value="true" />
মার্কডাউন
no_page_title: true
বিশেষ ক্ষেত্রে যেখানে স্বয়ংক্রিয় <h1> একটি বিশেষ লেআউটের জন্য পছন্দসই নয় কিন্তু একটি পৃষ্ঠার এখনও একটি উইন্ডো শিরোনাম প্রয়োজন, আপনি শিরোনামটি রাখতে পারেন কিন্তু "hide_page_heading" বৈশিষ্ট্য সহ শিরোনামটি লুকাতে পারেন:
এইচটিএমএল
<title>Page title</title>
<meta name="hide_page_heading" value="true" />
মার্কডাউন
hide_page_heading: true
# Page title
হেডারের বর্ণনা
অনেক DevSite সাইটের হেডারে একটি বিবরণ থাকে। এটি _project.yaml মেটাডেটা ফাইলে সেট করা আছে এবং DevSite ল্যান্ডিং পৃষ্ঠাগুলিতে স্বয়ংক্রিয়ভাবে প্রদর্শিত হয়। অন্য কথায়, _index.yaml টেমপ্লেটিং ব্যবহার করে তৈরি করা পৃষ্ঠাগুলি স্বয়ংক্রিয়ভাবে হেডারে একটি বিবরণ রেন্ডার করবে, যা _project.yaml ফাইলে সেট করা আছে।
_index.yaml ফাইলের মূলে একটি description সেট করে এই বিবরণটিকে পৃষ্ঠার জন্য ওভাররাইড করা যেতে পারে, অথবা landing_page অবজেক্টের header অবজেক্টের মধ্যে hide_description: true সেট করে চাপিয়ে দেওয়া যেতে পারে।
সম্পূর্ণ প্রস্থ লেআউট
যদি লেআউটের উপর আরও নিয়ন্ত্রণের প্রয়োজন হয়, তাহলে আপনি DevSite-কে বলতে পারেন সাইট হেডার এবং প্রোজেক্ট বার এবং সাইটের ফুটারের নিচের এলাকার জন্য লেআউটের উপর নিয়ন্ত্রণ ত্যাগ করতে। এটি করতে, "full_width" মেটাডেটা বৈশিষ্ট্যটিকে "true" এ সেট করুন।
এইচটিএমএল
<meta name="full_width" value="true" />
মার্কডাউন
full_width: true
সর্বশেষ আপডেট তারিখ
ডিফল্টরূপে, full-width পৃষ্ঠাগুলি ব্যতীত, পৃষ্ঠার ফুটার অঞ্চলে একটি স্বয়ংক্রিয় "শেষ আপডেট করা" বিজ্ঞপ্তি অন্তর্ভুক্ত থাকে। বেশিরভাগ ক্ষেত্রে, এটি ব্যবহারকারীদের পৃষ্ঠার সামগ্রীর সতেজতা সম্পর্কে একটি সরল সংকেত দেয়।
কিছু ক্ষেত্রে, এই তথ্য বিভ্রান্তিকর হতে পারে বা পণ্য দল গোপনীয় বলে বিবেচিত হতে পারে। একটি পৃষ্ঠায় সর্বশেষ-আপডেট করা বিজ্ঞপ্তিটি নিষ্ক্রিয় করতে, hide_last_updated বৈশিষ্ট্যটিকে true সেট করুন:
এইচটিএমএল
<meta name="project_path" value="/time-travel/_project.yaml" />
<meta name="book_path" value="/time-travel/_book.yaml" />
<meta name="hide_last_updated" value="true" />
মার্কডাউন
Project: /time-travel/_project.yaml
Book: /time-travel/_book.yaml
hide_last_updated: true
আপনি ISO 8601 ফর্ম্যাটে refresh_date মেটা ট্যাগ সেট করে স্বয়ংক্রিয়ভাবে গণনা করা "শেষ আপডেট হওয়া" তারিখটিকে ওভাররাইড করতে পারেন:
এইচটিএমএল
<meta name="project_path" value="/time-travel/_project.yaml" />
<meta name="book_path" value="/time-travel/_book.yaml" />
<meta name="refresh_date" value="2017-03-27" />
মার্কডাউন
Project: /time-travel/_project.yaml
Book: /time-travel/_book.yaml
refresh_date: 2017-03-27
পৃষ্ঠার বিবরণ
একটি পৃষ্ঠার বিবরণ হল পৃষ্ঠার বিষয়বস্তুর একটি পাঠ্য সারাংশ। একটি পৃষ্ঠার জন্য একটি বিবরণ সেট করতে, একটি <meta name="description" content="DESCRIPTION" /> উপাদান প্রদান করুন। লক্ষ্য করুন যে বর্ণনার পাঠ্যটি content নামের একটি বৈশিষ্ট্যে যায়, value নয়; এটি ওয়েব স্ট্যান্ডার্ড অ্যাট্রিবিউটের সাথে মেলে।
এইচটিএমএল
<meta name="description" content="It was the best of times, it was the blurst of times..." />
মার্কডাউন
description: It was the best of times, it was the blurst of times...
পৃষ্ঠার বিবরণ সেট করার ফলে <meta> ট্যাগ চূড়ান্ত পৃষ্ঠায় অন্তর্ভুক্ত করা হয়
ছবির পথ
image_path হল সেই ছবির পথ যা এই পৃষ্ঠাটিকে সোশ্যাল মিডিয়া এবং DevSite বৈশিষ্ট্য যেমন recommendations এবং dynamic content উপস্থাপন করে। সেট করা হলে, এই ছবিটি পৃষ্ঠার ওপেনগ্রাফ ইমেজ হিসাবে ব্যবহার করা হবে, প্রকল্পের social media সেটিংস এবং tenant site's ব্র্যান্ডিং সেটিংসকে ওভাররাইড করে৷
এইচটিএমএল
<meta name="image_path" value="/site-assets/developers_64dp.png" />
মার্কডাউন
image_path: /site-assets/developers_64dp.png
কীওয়ার্ড
keywords ক্ষেত্র হল স্ট্রিংগুলির একটি কমা-বিন্যস্ত তালিকা যা পৃষ্ঠাটি বর্ণনা করে এবং সাইট অনুসন্ধান এবং Dynamic Content মতো অনুসন্ধান এবং আবিষ্কারের বৈশিষ্ট্যগুলিতে ব্যবহৃত হয়।
keywords ক্ষেত্রটি ফ্ল্যাট কীওয়ার্ডকে সমর্থন করে যার কোনো মাত্রিক সম্পর্ক নেই (উদাহরণস্বরূপ, gettingstarted ) এবং স্ট্রাকচার্ড কীওয়ার্ড যা ডকুমেন্ট এবং বাস্তব-বিশ্বের সত্ত্বা যেমন প্রোগ্রামিং ভাষা, পণ্য এবং ইভেন্টগুলির মধ্যে সম্পর্ক উপস্থাপন করতে মাত্রিক নামস্থান ব্যবহার করে (উদাহরণস্বরূপ, product:ComputeEngine বা language:Python3 )। আপনি যেকোনো কীওয়ার্ড ক্ষেত্রে উভয় ধরনের keywords যোগ করতে পারেন।
আপনি যদি এমন একটি কীওয়ার্ড স্টেজ করেন যা ফরম্যাটিং প্রয়োজনীয়তা মেনে চলে না, তাহলে আপনি যে টুলটি ব্যবহার করেছেন (সাধারণত DevSite কমান্ড-লাইন টুল বা DevSite কন্টেন্ট পাবলিশার) তার আউটপুটে আপনার কীওয়ার্ডের সঠিক ফর্ম্যাট করা সংস্করণ সহ একটি সতর্কতা দেখতে পাবেন।
এইচটিএমএল
<meta name="keywords" value="spacetime,timetravel,product:Delorean" />
মার্কডাউন
keywords: spacetime, timetravel, product:Delorean