{{tag>app asciidoctor asciidoc}}

====== asciidoctor ======

asciidoctor projet lancé par Dan Allen en 2013 a partir du projet asciidoc (2000). Système de balises simplifiées ascii permettant de produire de la documentation.
  * S’intègre parfaitement dans un outil de suivi de version puisque les fichiers sources sont en texte brut.
  * Permet de produire des docs au format epub, pdf et html.
  * Meme sémantique que DocBook sans XML donc avec une syntaxe simplifiée.

Implémenter en ruby, polyglotte, API est accessible depuis JavaScript. L'extension asciidoctorjslivepreview permet au navigateur de générer à la volée le html a partir d'un document formatté en asciidoc.

===== Générer un document =====

On utilise la commande asciidoctor, les arguments peuvent être précisés sur la ligne de commande ou en entête du document