Najvišji naslov strani DevSite mora biti <h1>
. Telo strani ne sme vsebovati drugega <h1>
, da preprečite zmedo pri nevizualnih brskalnikih. Orodje nbgenerate
pretvori vsebino in predloge DevSite HTML in Markdown v zvezke Jupyter, združljive s Colabom.
Velikosti
Naslov 1
Naslov 2
Naslov 3
Naslov 4
Naslov 5
Naslov 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
Kazalo
V DevSite sta <h2>
in <h3>
samodejno dodana v kazalo vsebine (ToC) »na tej strani«.
Skrij naslove iz ToC
Če želite preprečiti dodajanje naslova (kot sta »Naslov 2« in »Naslov 3« v zgornjem razdelku, ki nista prikazana v ToC), uporabite class="hide-from-toc"
.
Naslov 2
Naslov 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}
Prilagodite besedilo naslova v ToC
Če želite, da se besedilo v ToC razlikuje od dejanskega naslova (kot ta razdelek!), nastavite atribut data-text
za naslov:
Naslov 2
HTML
<h2 data-text="Custom text for the ToC">Heading 2</h2>
Markdown
## Heading 2 {: data-text='Custom text for the ToC'}
Vključite naslove znotraj tabel v ToC
Prav tako lahko postavite <h2>
ali <h3>
v glavo tabele ( <th>
), da tabelo vsilite v ToC. Znotraj glave tabele sta <h2>
in <h3>
oblikovana kot navadno besedilo, tako da bralci tega ne bodo vedeli.
Povezave s klikom za kopiranje
Na straneh z dokumentacijo (ne na straneh s "polno širino", kot je večina ciljnih strani), naslovi, razen <h1>
dobijo tudi gumb za kopiranje povezave, ki se prikaže samo, ko miškin kazalec premaknete nad naslov.
Če želite onemogočiti ta gumb za določen naslov, uporabite class="no-link"
za naslov.
Naslov 4
Naslov 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}
Če želite prisiliti, da se gumb za povezavo pojavi na naslovu, ki ga sicer ne bi imel (recimo <h1>
ali kateri koli naslov na strani s polno širino), dodajte naslovu class="add-link"
.
Naslov 1
HTML
<h1 class="add-link">Heading 1</h1>
Markdown
# Heading 1 {:.add-link}
Oštevilčeni naslovi
Če želite naslovom <h2>
predpono dodati zaporedne številke za označevanje razdelkov s kompleksno vsebino kot ločenih korakov v večstopenjskem procesu, vsakemu naslovu dodajte oštevilčen razred.
Prvi oštevilčen naslov
Kompleksna vsebina, sestavljena iz odstavkov, seznamov, tabel, slik, videoposnetkov, pripomočkov.
Drugi oštevilčen naslov
Kompleksna vsebina, sestavljena iz odstavkov, seznamov, tabel, slik, videoposnetkov, pripomočkov.
Tretji oštevilčen naslov
Kompleksna vsebina, sestavljena iz odstavkov, seznamov, tabel, slik, videoposnetkov, pripomočkov.
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.
Oštevilčeni podnaslovi
Če želite naslovom <h3>
, ki sledijo naslovom <h2>
, predpono dodati zaporedne številke, vsakemu naslovu <h3>
dodajte oštevilčen razred.
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.
Oštevilčen naslov
Kompleksna vsebina, sestavljena iz odstavkov, seznamov, tabel, slik, videoposnetkov, pripomočkov.
Oštevilčen podnaslov
Kompleksna vsebina, sestavljena iz odstavkov, seznamov, tabel, slik, videoposnetkov, pripomočkov.
Oštevilčen podnaslov
Kompleksna vsebina, sestavljena iz odstavkov, seznamov, tabel, slik, videoposnetkov, pripomočkov.
Oštevilčen podnaslov
Kompleksna vsebina, sestavljena iz odstavkov, seznamov, tabel, slik, videoposnetkov, pripomočkov.