Titlul cel mai de sus al unei pagini DevSite trebuie să fie un <h1>
. Corpul paginii nu trebuie să conțină un alt <h1>
pentru a evita confuzia browserelor non-vizuale. Instrumentul nbgenerate
convertește conținutul și șabloanele DevSite HTML și Markdown în notebook-uri Jupyter compatibile cu Colab.
Dimensiuni
Titlul 1
Titlul 2
Titlul 3
Titlul 4
Titlul 5
Titlul 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>
Markdown
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
Cuprins
În DevSite, <h2>
și <h3>
sunt adăugate automat la cuprinsul (ToC) „pe această pagină”.
Ascundeți titlurile din ToC
Pentru a preveni adăugarea unui titlu (cum ar fi „Titlul 2” și „Titlul 3” în secțiunea de mai sus, care nu apar în ToC), aplicați class="hide-from-toc"
.
Titlul 2
Titlul 3
HTML
<h2 class="hide-from-toc">Heading 2</h2>
<h3 class="hide-from-toc">Heading 3</h3>
Markdown
## Heading 2 {:.hide-from-toc}
### Heading 3 {:.hide-from-toc}
Personalizați textul titlului în ToC
Dacă doriți ca textul din ToC să difere de titlul real (ca această secțiune!), setați un atribut data-text
pe titlu:
Titlul 2
HTML
<h2 data-text="Custom text for the ToC">Heading 2</h2>
Markdown
## Heading 2 {: data-text='Custom text for the ToC'}
Includeți titluri în tabelele din ToC
De asemenea, puteți pune un <h2>
sau <h3>
în interiorul antetului unui tabel ( <th>
) pentru a forța tabelul să intre în ToC. În interiorul antetului unui tabel, <h2>
și <h3>
sunt stilate ca textul obișnuit, astfel încât cititorii nu vor putea spune.
Link-uri clic pentru a copia
Pe paginile de documentație (nu paginile „cu lățime completă”, ca majoritatea paginilor de destinație), titlurile altele decât <h1>
primesc și un buton pentru a copia linkul, care apare numai când treceți cu mouse-ul peste titlu.
Pentru a dezactiva acest buton pentru un anumit titlu, aplicați class="no-link"
la titlu.
Titlul 4
Titlul 5
HTML
<h4 class="no-link">Heading 4</h4>
<h5 class="no-link">Heading 5</h5>
Markdown
## Heading 4 {:.no-link}
### Heading 5 {:.no-link}
Pentru a forța butonul de legătură să apară pe un titlu care altfel nu l-ar avea (să zicem, un <h1>
sau orice titlu pe o pagină cu lățime completă), adăugați class="add-link"
la titlu.
Titlul 1
HTML
<h1 class="add-link">Heading 1</h1>
Markdown
# Heading 1 {:.add-link}
Titluri numerotate
Pentru a prefix titlurile <h2>
cu numere secvențiale pentru a desemna secțiuni cu conținut complex ca pași distincti într-un proces cu mai mulți pași, adăugați o clasă numerotată la fiecare titlu.
Primul titlu numerotat
Conținut complex compus din paragrafe, liste, tabele, imagini, videoclipuri, widget-uri.
Al doilea titlu numerotat
Conținut complex compus din paragrafe, liste, tabele, imagini, videoclipuri, widget-uri.
Al treilea titlu numerotat
Conținut complex compus din paragrafe, liste, tabele, imagini, videoclipuri, widget-uri.
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.
Markdown
## 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.
Subtitluri numerotate
Pentru a prefix titlurile <h3>
care urmează titlurilor <h2>
cu numere secvențiale, adăugați o clasă numerotată la fiecare antet <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.
Markdown
## 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.
Titlu numerotat
Conținut complex compus din paragrafe, liste, tabele, imagini, videoclipuri, widget-uri.
Subtitlu numerotat
Conținut complex compus din paragrafe, liste, tabele, imagini, videoclipuri, widget-uri.
Subtitlu numerotat
Conținut complex compus din paragrafe, liste, tabele, imagini, videoclipuri, widget-uri.
Subtitlu numerotat
Conținut complex compus din paragrafe, liste, tabele, imagini, videoclipuri, widget-uri.