asciidoc: Rozdiel medzi revíziami
(Vytvorená stránka „{{DISPLAYTITLE: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, dok…“) |
|||
| Riadok 3: | Riadok 3: | ||
'''AsciiDoc''' je formát na písanie článkov na kníh. | '''AsciiDoc''' je formát na písanie článkov na kníh. | ||
Spracováva sa pomocou programu "asciidoctor". | Spracováva sa pomocou programu "asciidoctor". | ||
| − | Možno z neho generovať e-booky, dokumenty PDF, atď. | + | Možno z neho generovať e-booky, dokumenty PDF, stránky HTML, atď. |
Funkcionalitou sa podobá na DocBook; dá sa z neho generovať DocBook. | 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 | *tučné* písmo | ||
_šikmé_ písmo | _šikmé_ písmo | ||
| + | `monospace` písmo | ||
<nowiki>http://bur.sk[odkaz]</nowiki> | <nowiki>http://bur.sk[odkaz]</nowiki> | ||
| − | + | Toto sú jednoduché bloky: | |
| − | |||
= Nadpis | = Nadpis | ||
== Nadpis časti | == Nadpis časti | ||
=== Nadpis podčasti | === Nadpis podčasti | ||
| + | * zoznam | ||
| + | |||
| + | 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-...". | ||
| + | |||
| + | |||
| + | === Obrázky === | ||
| + | |||
| + | 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] | ||
| Riadok 25: | Riadok 50: | ||
* [https://en.wikipedia.org/wiki/AsciiDoc AsciiDoc] na Wikipédii | * [https://en.wikipedia.org/wiki/AsciiDoc AsciiDoc] na Wikipédii | ||
| + | * [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] | ||
Verzia zo dňa a času 09:26, 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 _šikmé_ písmo `monospace` písmo http://bur.sk[odkaz]
Toto sú jednoduché bloky:
= Nadpis == Nadpis časti === Nadpis podčasti * zoznam
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-...".
Obrázky
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
- odporúčania
- docbookrx - konverzia z DocBook do AsciiDoc, s príkladmi
