بالاترین عنوان صفحه DevSite باید یک <h1> باشد. برای جلوگیری از گیج شدن مرورگرهای غیر بصری، بدنه صفحه نباید حاوی <h1> دیگری باشد. ابزار nbgenerate محتوا و قالب‌های DevSite HTML و Markdown را به نوت‌بوک‌های Jupyter سازگار با Colab تبدیل می‌کند.
اندازه ها
سرفصل 1
سرفصل 2
سرفصل 3
سرفصل 4
سرفصل 5
سرفصل 6
HTML
<h1>Heading 1</h1>
<h2>Heading 2</h2>
<h3>Heading 3</h3>
<h4>Heading 4</h4>
<h5>Heading 5</h5>
<h6>Heading 6</h6>
مارک داون
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
فهرست مطالب
در DevSite، <h2> و <h3> به طور خودکار به فهرست مطالب "در این صفحه" (ToC) اضافه می شوند.
سرفصل ها را از ToC پنهان کنید
برای جلوگیری از اضافه شدن عنوان (مانند "هدینگ 2" و "سرفصل 3" در بخش بالا که در ToC ظاهر نمی شوند)، class="hide-from-toc" را اعمال کنید.
سرفصل 2
سرفصل 3
HTML
<h2 class="hide-from-toc">Heading 2</h2>
<h3 class="hide-from-toc">Heading 3</h3>
مارک داون
## Heading 2 {:.hide-from-toc}
### Heading 3 {:.hide-from-toc}
سفارشی کردن متن عنوان در ToC
اگر می خواهید متن موجود در ToC با عنوان واقعی متفاوت باشد (مانند این بخش!)، یک ویژگی data-text روی عنوان تنظیم کنید:
سرفصل 2
HTML
<h2 data-text="Custom text for the ToC">Heading 2</h2>
مارک داون
## Heading 2 {: data-text='Custom text for the ToC'}
عناوین درون جداول را در ToC لحاظ کنید
همچنین می‌توانید یک <h2> یا <h3> را در سربرگ جدول ( <th> ) قرار دهید تا جدول را به ToC مجبور کنید. در داخل هدر جدول، <h2> و <h3> مانند متن معمولی استایل بندی شده اند، بنابراین خوانندگان قادر به تشخیص آن نیستند.
پیوندهای کلیک برای کپی
در صفحات مستندات (و نه صفحات با عرض کامل مانند اکثر صفحات فرود)، عناوین غیر از <h1> نیز دکمه ای برای کپی پیوند دریافت می کنند، که فقط زمانی ظاهر می شود که ماوس را روی عنوان قرار می دهید.
برای غیرفعال کردن این دکمه برای یک عنوان خاص، class="no-link" را روی عنوان اعمال کنید.
سرفصل 4
سرفصل 5
HTML
<h4 class="no-link">Heading 4</h4>
<h5 class="no-link">Heading 5</h5>
مارک داون
## Heading 4 {:.no-link}
### Heading 5 {:.no-link}
برای اینکه دکمه پیوند را مجبور کنید روی عنوانی ظاهر شود که در غیر این صورت آن را نداشت (مثلاً یک <h1> یا هر عنوانی در یک صفحه با عرض کامل)، class="add-link" به عنوان اضافه کنید.
سرفصل 1
HTML
<h1 class="add-link">Heading 1</h1>
مارک داون
# Heading 1 {:.add-link}
سرفصل های شماره گذاری شده
برای پیشوند سرفصل‌های <h2> با اعداد متوالی برای تعیین بخش‌هایی با محتوای پیچیده به عنوان مراحل مجزا در یک فرآیند چند مرحله‌ای، یک کلاس شماره‌دار به هر عنوان اضافه کنید.
عنوان شماره گذاری شده اول
محتوای پیچیده متشکل از پاراگراف ها، فهرست ها، جداول، تصاویر، فیلم ها، ویجت ها.
عنوان شماره گذاری شده دوم
محتوای پیچیده متشکل از پاراگراف ها، فهرست ها، جداول، تصاویر، فیلم ها، ویجت ها.
عنوان شماره سوم
محتوای پیچیده متشکل از پاراگراف ها، فهرست ها، جداول، تصاویر، فیلم ها، ویجت ها.
HTML
<h2 class="numbered">First numbered heading</h2>
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
<h2 class="numbered">Second numbered heading</h2>
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
<h2 class="numbered">Third numbered heading</h2>
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
مارک داون
## First numbered heading {:.numbered}
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
## Second numbered heading {:.numbered}
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
## Third numbered heading {:.numbered}
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
عناوین فرعی شماره گذاری شده
برای پیشوند سرفصل‌های <h3> که پس از سرفصل‌های <h2> با اعداد متوالی قرار می‌گیرند، یک کلاس شماره‌دار به هر عنوان <h3> اضافه کنید.
HTML
<h2 class="numbered">Numbered heading</h2>
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
<h3 class="numbered">Numbered subheading</h3>
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
<h3 class="numbered">Numbered subheading</h3>
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
<h3 class="numbered">Numbered subheading</h3>
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
مارک داون
## Numbered heading {:.numbered}
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
### Numbered subheading {:.numbered}
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
### Numbered subheading {:.numbered}
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
### Numbered subheading {:.numbered}
Complex content composed of paragraphs, lists, tables, images, videos, widgets.
عنوان شماره گذاری شده
محتوای پیچیده متشکل از پاراگراف ها، فهرست ها، جداول، تصاویر، فیلم ها، ویجت ها.
عنوان فرعی شماره گذاری شده
محتوای پیچیده متشکل از پاراگراف ها، فهرست ها، جداول، تصاویر، فیلم ها، ویجت ها.
عنوان فرعی شماره گذاری شده
محتوای پیچیده متشکل از پاراگراف ها، فهرست ها، جداول، تصاویر، فیلم ها، ویجت ها.
عنوان فرعی شماره گذاری شده
محتوای پیچیده متشکل از پاراگراف ها، فهرست ها، جداول، تصاویر، فیلم ها، ویجت ها.