Nejvyšší nadpis stránky DevSite musí být <h1>
. Tělo stránky nesmí obsahovat další <h1>
, aby nedošlo ke zmatení nevizuálních prohlížečů. Nástroj nbgenerate
převádí obsah a šablony HTML a Markdown DevSite do poznámkových bloků Jupyter kompatibilních s Colab.
Velikosti
Nadpis 1
Nadpis 2
Nadpis 3
Nadpis 4
Nadpis 5
Nadpis 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>
Snížení
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
Obsah
V DevSite jsou <h2>
a <h3>
automaticky přidány do obsahu „na této stránce“ (ToC).
Skrýt nadpisy z ToC
Chcete-li zabránit přidání nadpisu (jako „Nadpis 2“ a „Nadpis 3“ ve výše uvedené části, které se neobjevují v ToC), použijte class="hide-from-toc"
.
Nadpis 2
Nadpis 3
HTML
<h2 class="hide-from-toc">Heading 2</h2>
<h3 class="hide-from-toc">Heading 3</h3>
Snížení
## Heading 2 {:.hide-from-toc}
### Heading 3 {:.hide-from-toc}
Přizpůsobte text nadpisu v ToC
Pokud chcete, aby se text v ToC lišil od skutečného nadpisu (jako v této sekci!), nastavte u nadpisu atribut data-text
:
Nadpis 2
HTML
<h2 data-text="Custom text for the ToC">Heading 2</h2>
Snížení
## Heading 2 {: data-text='Custom text for the ToC'}
Zahrnout nadpisy do tabulek v ToC
Můžete také vložit <h2>
nebo <h3>
do záhlaví tabulky ( <th>
), aby se tabulka dostala do ToC. Uvnitř záhlaví tabulky jsou <h2>
a <h3>
stylizovány jako běžný text, takže čtenáři to nebudou moci poznat.
Odkazy zkopírované kliknutím
Na stránkách s dokumentací (nikoli na stránkách „plné šířky“ jako většina vstupních stránek) mají jiné nadpisy než <h1>
tlačítko pro zkopírování odkazu, které se zobrazí pouze tehdy, když na nadpis umístíte ukazatel myši.
Chcete-li toto tlačítko pro konkrétní nadpis zakázat, použijte na nadpis class="no-link"
.
Nadpis 4
Nadpis 5
HTML
<h4 class="no-link">Heading 4</h4>
<h5 class="no-link">Heading 5</h5>
Snížení
## Heading 4 {:.no-link}
### Heading 5 {:.no-link}
Chcete-li vynutit, aby se tlačítko odkazu objevilo v nadpisu, který by jej jinak neměl (řekněme <h1>
nebo jakýkoli nadpis na stránce plné šířky), přidejte do nadpisu class="add-link"
.
Nadpis 1
HTML
<h1 class="add-link">Heading 1</h1>
Snížení
# Heading 1 {:.add-link}
Číslované nadpisy
Chcete-li nadpisům <h2>
předřadit sekvenční čísla pro označení sekcí se složitým obsahem jako samostatných kroků v procesu s více kroky, přidejte do každého nadpisu očíslovanou třídu.
První číslovaný nadpis
Komplexní obsah složený z odstavců, seznamů, tabulek, obrázků, videí, widgetů.
Druhý očíslovaný nadpis
Komplexní obsah složený z odstavců, seznamů, tabulek, obrázků, videí, widgetů.
Třetí číslovaný nadpis
Komplexní obsah složený z odstavců, seznamů, tabulek, obrázků, videí, widgetů.
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.
Snížení
## 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.
Číslované podnadpisy
Chcete-li nadpisům <h3>
, které následují po nadpisech <h2>
, předřadit pořadová čísla, přidejte do každého nadpisu <h3>
očíslovanou třídu.
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.
Snížení
## 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.
Číslovaný nadpis
Komplexní obsah složený z odstavců, seznamů, tabulek, obrázků, videí, widgetů.
Číslovaný podnadpis
Komplexní obsah složený z odstavců, seznamů, tabulek, obrázků, videí, widgetů.
Číslovaný podnadpis
Komplexní obsah složený z odstavců, seznamů, tabulek, obrázků, videí, widgetů.
Číslovaný podnadpis
Komplexní obsah složený z odstavců, seznamů, tabulek, obrázků, videí, widgetů.