AsciiDoc
AsciiDoc on yksinkertainen ihmisen luettavissa oleva merkkauskieli, joka on tarkoitettu dokumentaation kirjoittamiseen. AsciiDoc sisältää samat ominaisuudet kuin esimerkiksi DocBook, mutta sitä voi kirjoittaa tekstieditorilla ilman erikoistuneita työkaluja tai tekstinkäsittelyohjelmia. Dokumentti muunnetaan skriptillä toisiin muotoihin kuten PDF, TeX, Unixin man-sivut, sähkökirjaksi tms.[1]
Formaatin loi Stuart Rackham, joka vuonna 2002 julkaisi asciidoc ja a2x -työkalut. Muitakin AsciiDocia tukevia ohjelmia on julkaistu, kuten Rubylla kirjoitettu Asciidoctor (2013). GitHubin käyttämä Markdown on hyvin samanlainen kuin AsciiDoc. Eclipse Foundation on aloittanut AsciiDocin standardoinnin.[2] Antora julkaisujärjestelmä käyttää AsciiDoc-merkintäkieltä.[3]
Esimerkki
[muokkaa | muokkaa wikitekstiä]== Otsikko
=== Toisen tason otsikko
Tämä on ensimmäinen kappale. Otsikkojen merkintä lienee lainattu Wikipedian wiki-merkintäkielestä.
.Kappaleen otsikko
AsciiDoc lainaa esimerkiksi sähköposteissa ja nyysseissä käytettyjä vahvistuskeinoja: *lihavoitu*, _alleviivattu_ teksti.
[.text-center]
Tämä on keskitetty teksti.
[verse,Kalevala, kolmas runo]
Vaka vanha Väinämöinen,
tietäjä iän-ikuinen.
https://asciidoclive.com[AsciidocLIVE] -- linkki verkkosivulleLähteet
[muokkaa | muokkaa wikitekstiä]- ↑ https://web.archive.org/web/20160303232746/http://www.linuxlinks.com/article/20130921024111314/AsciiDoc.html
- ↑ https://www.eclipse.org/org/workinggroups/asciidoc-charter.php
- ↑ Antora Documentation docs.antora.org. Viitattu 3.12.2024. (englanniksi)
Aiheesta muualla
[muokkaa | muokkaa wikitekstiä]- AsciiDoc Language Documentation from Asciidoctor
- AsciiDoc cheatsheet