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
^horný^ index, ~dolný~ index
http://bur.sk[odkaz]

Na vypnutie syntaxe možno použiť:

....
Môžem používať hocijaké značky.
....

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!:

Riadky odkazujúce na neexistujúce atribúty sa preskočia.

Nadpis

= Nadpis
== Nadpis časti
=== Nadpis podčasti

.Lokálny nadpis
Text odseku.

Zoznam

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

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

. prvé
. druhé
. tretie

Formátovaný text

[quote, autor citátu, zdroj]
____
Citovaný text.
____

[source,python]
print("hello world")

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]

Uprostred image:example.png[príklad] textu.

Odkazy

• AsciiDoc na Wikipédii
• rýchle prehľady:
  • Asciidoctor
  • SUSE
  • powerman
• odporúčania
• docbookrx - konverzia z DocBook do AsciiDoc, s príkladmi