AsciiDoc
| AsciiDoc | |
|---|---|
| Estensione | .adoc |
| Tipo MIME | text/asciidoc |
| 1ª pubblicazione | 2002 |
| Tipo | Linguaggio di markup |
| Formato aperto? | Sì |
| Sito web | asciidoc.org |
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.[1]
Storia
[modifica | modifica wikitesto]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.[1]
Un'implementazione in Ruby chiamata "Asciidoctor", pubblicata nel 2013, viene usata da GitHub[2] 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.[3]
Buona parte della documentazione di Git è scritta in AsciiDoc.[4]
Esempio
[modifica | modifica wikitesto]Il seguente testo mostra l'uso di marcatori AsciiDoc e un risultato simile a quello prodotto da un elaboratore di AsciiDoc:
| Testo sorgente AsciiDoc |
|---|
= 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 |
| HTML-rendered result |
|---|
| P. Rossi Wikipedia è un'enciclopedia on-line, disponibile in inglese e molte altre lingue. You can install package-name using the gem command: gem install package-name Metalli usati comunemente sono:
|
Note
[modifica | modifica wikitesto]- ^ a b AsciiDoc, su linuxlinks.com. URL consultato il 12 aprile 2015 (archiviato dall'url originale il 3 marzo 2016).
- ^ AsciiDoc, powered by Asciidoctor, returns to GitHub and its 5+ million repositories, su asciidoctor.org.
- ^ O'Reilly Author Portal -- Welcome Kit: Writing in AsciiDoc, su oreilly.com.
- ^ Git wiki, su git.wiki.kernel.org, Git SCM.
Voci correlate
[modifica | modifica wikitesto]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
[modifica | modifica wikitesto]- Asciidoc “cheat-sheet” reference guide, su powerman.name.
- MPLW - Matplotlib charting filter for AsciiDoc, su volnitsky.com. URL consultato il 12 aprile 2015 (archiviato dall'url originale il 3 aprile 2015).
- RTextDoc. Editor with AsciiDoc support., su jwork.org.
- AsciidocToGo. Frontend to convert AsciiDoc txt files, su dbcb.github.io.
