AsciiDoc è un formato per documenti di testo, a marcatori, leggibile direttamente da sorgente e semanticamente equivalente a DocBook XML, che usa convenzioni di testo semplice come marcatori. Documenti AsciiDoc possono essere creati usando un qualunque editor di testo semplice e letti “come stanno”, o trasformati in HTML o qualsiasi altro formato supportato dal gruppo di programmi di elaborazione di DocBook, come PDF, TeX, pagine man Unix, e-book, presentazioni, ecc.
Storia AsciiDoc è stato creato nel 2002 da Stuart Rackham, a cui si deve la pubblicazione degli strumenti "asciidoc" e "a2x", scritti in linguaggio di programmazione Python per convertire file di testo semplice, "umanamente leggibili", in formati standard per la pubblicazione di documenti.
Un'implementazione in Ruby chiamata "Asciidoctor", pubblicata nel 2013, viene usata da GitHub e fornisce anche un metodo per l'uso di Asciidoc in Java.
Alcuni dei libri e ebook di O'Reilly Media sono generati partendo da sorgenti AsciiDoc.
Buona parte della documentazione di Git è scritta in AsciiDoc.
Esempio Il seguente testo mostra l'uso di marcatori AsciiDoc e un risultato simile a quello prodotto da un elaboratore di AsciiDoc:
Testo sorgente AsciiDoc<nowiki> = Mio articolo P. Rossi
http://wikipedia.org[Wikipedia] è un'enciclopedia on-line, disponibile in inglese e molte altre lingue.
== Software
You can install 'package-name' using the +gem+ command:
gem install package-name
== Hardware
I metalli usati comunemente sono: * rame * stagno * piombo </nowiki> HTML-rendered resultMio articolo P. Rossi
Wikipedia è un'enciclopedia on-line, disponibile in inglese e molte altre lingue.
Software You can install package-name using the gem command:
gem install package-name
Hardware Metalli usati comunemente sono: rame stagno piombo
Note
Voci correlate Linguaggi a marcatori leggeri simili: Creole Markdown Org-mode Plain Old Documentation, utilizzato per la documentazione di Perl ReStructuredText, utilizzato per la documentazione di Python Setext Textile txt2tags Wikitesto
Collegamenti esterni
Categoria:Linguaggi di markup liberi