صفحہ کا میٹا ڈیٹا
ایک DevSite صفحہ سائٹ پر مواد کی واحد اکائی ہے۔ ایک صفحہ میں ایک عنوان، ایک باڈی، ہیڈر عناصر، اور میٹا ڈیٹا کی خصوصیات ہوسکتی ہیں جو سائٹ کی خصوصیات کو کنٹرول کرتی ہیں۔ جب صارف کسی صفحہ کے URL پر جاتا ہے، تو سائٹ مواد کے صفحہ کی خصوصیات کی بنیاد پر ایک مکمل ویب صفحہ پیش کرتی ہے، جس میں ہیڈر، فوٹر اور سائڈبار جیسے متحرک عناصر شامل ہوتے ہیں۔ ڈیفالٹ رویے تکنیکی دستاویزات کے صفحات کے لیے موزوں ہوتے ہیں، لیکن ایک صفحہ دوسرے استعمال کے لیے بھی ترتیب دیا جا سکتا ہے، جیسے کہ مارکیٹنگ اور لینڈنگ کے صفحات۔
صفحہ کی ساخت
ایک DevSite صفحہ ایک ویب صفحہ ہے جس کی عمومی ظاہری شکل اور خصوصیات کا نظم سائٹ کے ذریعے کیا جاتا ہے۔ Google Developers پر ایک صفحہ کئی عام علاقوں کے ساتھ ظاہر ہوتا ہے۔ (تمام سائٹس تمام خصوصیات کو سپورٹ نہیں کرتی ہیں۔) لیبلز کے لیے اپنے ماؤس کو ڈایاگرام پر گھمائیں۔
site header
سائٹ کا لوگو، سائن ان ویجیٹ، سرچ باکس، اور ٹاپ nav۔ پوری سائٹ میں عام۔
project bar
پروجیکٹ یا پروڈکٹ کا عنوان، اور پروجیکٹ کے لیے مخصوص ویجیٹس (جیسے "فیڈ بیک" لنک)۔ اس علاقے کی تعریف پروجیکٹ میٹا ڈیٹا کے ذریعے کی گئی ہے۔
sidebar
کتابی سطح پر درجہ بندی نیویگیشن۔ اس علاقے کی وضاحت کتاب کے میٹا ڈیٹا کے ذریعے کی گئی ہے۔
body
صفحہ کا عنوان، اور صفحہ کا مواد۔
page footer ("last updated")
صفحہ کے لیے مخصوص وجیٹس (جیسے "آخری اپ ڈیٹ کردہ" نوٹس)۔ اس میں CC لائسنس نوٹس بھی شامل ہو سکتا ہے، جو کہ پروجیکٹ میٹا ڈیٹا کی خصوصیت ہے۔
site footer
سائٹ کے فوٹر لنکس، زبان کا انتخاب ویجیٹ۔ پوری سائٹ میں عام۔
HTML سورس فائلز
<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: meta tag ہے، جو کہ _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 ترتیب دے کر اوور رائیڈ کیا جا سکتا ہے، یا hide_description: true landing_page آبجیکٹ کے header آبجیکٹ کے اندر سیٹ کر کے دبایا جا سکتا ہے۔
مکمل چوڑائی لے آؤٹ
اگر لے آؤٹ پر مزید کنٹرول کی ضرورت ہو تو، آپ 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
آپ refresh_date میٹا ٹیگ کو ISO 8601 فارمیٹ میں تاریخ پر سیٹ کر کے خود کار طریقے سے حساب شدہ "آخری اپ ڈیٹ" کی تاریخ کو اوور رائیڈ کر سکتے ہیں:
ایچ ٹی ایم ایل
<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 میں نمائندگی کرتا ہے۔ سیٹ ہونے پر، اس تصویر کو صفحہ کی OpenGraph تصویر کے طور پر استعمال کیا جائے گا، پروجیکٹ کی 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 Content Publisher)۔
ایچ ٹی ایم ایل
<meta name="keywords" value="spacetime,timetravel,product:Delorean" />
مارک ڈاؤن
keywords: spacetime, timetravel, product:Delorean