Impara X in Y minuti

AsciiDoc è un linguaggio di markup simile a Markdown e può essere usato per qualsiasi cosa, dai libri ai blog. Creato nel 2002 da Stuart Rackman, questo linguaggio è semplice ma permette un buon numero di personalizzazioni.

Intestazione Documento

Le intestazioni sono opzionali e possono contenere linee vuote. Deve avere almeno una linea vuota rispetto al contenuto.

Solo titolo

= Titolo documento

Prima frase del documento.

Titolo ed Autore

= Titolo documento
Primo Ultimo <[email protected]>

Inizio del documento

Autori multipli

= Titolo Documento
John Doe <[email protected]>; Jane Doe<[email protected]>; Black Beard <[email protected]>

Inizio di un documento con autori multipli.

Linea di revisione (richiede una linea autore)

= Titolo documento V1
Potato Man <[email protected]>
v1.0, 2016-01-13

Questo articolo sulle patatine sarà divertente.

Paragrafi

Non hai bisogno di nulla di speciale per i paragrafi.

Aggiungi una riga vuota tra i paragrafi per separarli.

Per creare una riga vuota aggiungi un +
e riceverai una interruzione di linea!

Formattazione Testo

_underscore crea corsivo_
*asterischi per il grassetto*
*_combinali per maggiore divertimento_*
`usa i ticks per indicare il monospazio`
`*spaziatura fissa in grassetto*`

Titoli di sezione

= Livello 0 (può essere utilizzato solo nell'intestazione del documento)

== Livello 1 <h2>

=== Livello 2 <h3>

==== Livello 3 <h4>

===== Livello 4 <h5>

Liste

Per creare un elenco puntato, utilizzare gli asterischi.

* foo
* bar
* baz

Per creare un elenco numerato usa i periodi.

. item 1
. item 2
. item 3

È possibile nidificare elenchi aggiungendo asterischi o periodi aggiuntivi fino a cinque volte.

* foo 1
** foo 2
*** foo 3
**** foo 4
***** foo 5

. foo 1
.. foo 2
... foo 3
.... foo 4
..... foo 5

Ulteriori letture

Esistono due strumenti per elaborare i documenti AsciiDoc:

1. AsciiDoc: implementazione Python originale, disponibile nelle principali distribuzioni Linux. Stabile e attualmente in modalità di manutenzione.
2. Asciidoctor: implementazione alternativa di Ruby, utilizzabile anche da Java e JavaScript. In fase di sviluppo attivo, mira ad estendere la sintassi AsciiDoc con nuove funzionalità e formati di output.

I seguenti collegamenti sono relativi all'implementazione di Asciidoctor:

• Markdown - AsciiDoc comparazione sintassi: confronto affiancato di elementi di Markdown e AsciiDoc comuni.
• Per iniziare: installazione e guide rapide per il rendering di documenti semplici.
• Asciidoctor Manuale Utente: manuale completo con riferimento alla sintassi, esempi, strumenti di rendering, tra gli altri.

Hai un suggerimento? Oppure una correzione? Apri un issue sul GitHub, o fa un pull request da solo!

In origine contribuita da Ryan Mavilia, e modificata da 3 contributore(i).