asciidoc: Rozdiel medzi revíziami
| Riadok 7: | Riadok 7: | ||
Odporúčaná prípona je ".adoc". | Odporúčaná prípona je ".adoc". | ||
| − | |||
== Syntax== | == Syntax== | ||
| Riadok 17: | Riadok 16: | ||
Tieto značky možno použiť uprostred odseku: | Tieto značky možno použiť uprostred odseku: | ||
| − | *tučné* písmo | + | *tučné* písmo, uprostred sl**o**va |
| − | _šikmé_ písmo | + | _šikmé_ písmo, uprostred sl__o__va |
| − | `monospace` písmo | + | *_tučné a šikmé_* písmo, uprostred sl**__o__**va |
| + | `monospace` písmo, uprostred sl``o``va | ||
<nowiki>http://bur.sk[odkaz]</nowiki> | <nowiki>http://bur.sk[odkaz]</nowiki> | ||
| Riadok 28: | Riadok 28: | ||
=== Nadpis podčasti | === Nadpis podčasti | ||
* zoznam | * zoznam | ||
| − | |||
=== Komentár === | === Komentár === | ||
// komentár | // komentár | ||
| − | |||
=== Atribút === | === Atribút === | ||
| Riadok 52: | Riadok 50: | ||
:example!: | :example!: | ||
| − | |||
=== Zoznam === | === Zoznam === | ||
| Riadok 65: | Riadok 62: | ||
* jeseň | * jeseň | ||
* zima | * zima | ||
| + | |||
| + | . prvé | ||
| + | . druhé | ||
| + | . tretie | ||
=== Obrázok === | === Obrázok === | ||
| Riadok 73: | Riadok 74: | ||
image::example.png[Príklad] | image::example.png[Príklad] | ||
| − | |||
== Odkazy == | == Odkazy == | ||
* [https://en.wikipedia.org/wiki/AsciiDoc AsciiDoc] na Wikipédii | * [https://en.wikipedia.org/wiki/AsciiDoc AsciiDoc] na Wikipédii | ||
| + | * [https://github.com/SUSE/doc-susemanager/wiki/Asciidoc-getting-started prehľad] | ||
* [https://asciidoctor.org/docs/asciidoc-recommended-practices/ odporúčania] | * [https://asciidoctor.org/docs/asciidoc-recommended-practices/ odporúčania] | ||
* [https://github.com/asciidoctor/docbookrx docbookrx] - konverzia z DocBook do AsciiDoc, s [https://github.com/asciidoctor/docbookrx/blob/main/spec/lib/docbookrx/docbookrx_spec.rb príkladmi] | * [https://github.com/asciidoctor/docbookrx docbookrx] - konverzia z DocBook do AsciiDoc, s [https://github.com/asciidoctor/docbookrx/blob/main/spec/lib/docbookrx/docbookrx_spec.rb príkladmi] | ||
Verzia zo dňa a času 10:21, 23. apríl 2025
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
