AsciiDoc

AsciiDoc je formát na písanie článkov na kníh. Spracováva sa pomocou programu "asciidoctor". Možno z neho generovať e-booky, dokumenty PDF, stránky HTML, atď. Funkcionalitou sa podobá na DocBook; dá sa z neho generovať DocBook.

Odporúčaná prípona je ".adoc".

Syntax

Obyčajný text väčšinou netreba nijako špeciálne označiť. Jeden enter medzi riadkami textu sa ignoruje; môžeme odseky písať tak, že každú vetu dáme na osobitný riadok. Dva entery znamenajú nový odsek, alebo nový blok.

Tieto značky možno použiť uprostred odseku:

*tučné* písmo, uprostred sl**o**va
_šikmé_ písmo, uprostred sl__o__va
*_tučné a šikmé_* písmo, uprostred sl**__o__**va
`monospace` písmo, uprostred sl``o``va
http://bur.sk[odkaz]

Toto sú jednoduché bloky:

= Nadpis
== Nadpis časti
=== Nadpis podčasti
* zoznam

Komentár

// komentár

Atribút

Môžeme definovať atribúty, ktoré neskôr použijeme:

:example: Toto je príklad.

Atribút použitý v texte vyzerá takto: "{example}"

Odporúča sa mať nejaký systém na atribúty, napríklad že všetk odkazy začínajú "url-..." alebo všetky obrázky začínajú "img-...".

Takto nastavíme atribút na prázdny reťazec:

:example:

Takto atribút zrušíme:

:example!:

Zoznam

Iný prefix začína novú úroveň zoznamu.

* jar
** Apríl
** Máj
** Jún
* leto
* jeseň
* zima

. prvé
. druhé
. tretie

Obrázok

V hlavičke dokumentu atribút "imagedir" určuje adresár s obrázkami (relatívne voči dokumentu).

:imagedir: images/

image::example.png[Príklad]

Odkazy

• AsciiDoc na Wikipédii
• prehľad
• odporúčania
• docbookrx - konverzia z DocBook do AsciiDoc, s príkladmi