AsciiDoc

AsciiDoc
Estensione	.adoc
Tipo MIME	text/asciidoc
1ª pubblicazione	2002; 23 anni fa
Tipo	Linguaggio di markup
Formato aperto?	Sì
Sito web	asciidoc.org
	Modifica dati su Wikidata · Manuale

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

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

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
Mio 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