Convertir un document Asciidoc en PDF : Asciidoc-pdf

Sous Linux et  Windows 10, il existe plusieurs outils de conversions d’un document Asciidoc en PDF.

Le plus simple est d’utiliser l’éditeur AsciidocFX qui à un icône pour sauver en PDF. Mais vous ne pouvez pas automatiser la tâche au travers de ligne de commande.
Et la configuration du format du fichier de sortie n’est pas du tout aisée (fichier XML, manque de documentation).

Une autre solution est d’installer « Asciidoctor PDF »

Il  nécessite « Asciidocotor » et « Prawn »

Si vous êtes sous Windows 10, installer en premier « Bash Ubtuntu Windows », puis lancer le. Par la suite l’installation Linux ou Windows 10 est identique.

Installer une version v2.x de  ruby :

apt-get install ruby

Installer Asciidoctor par :

gem install asciidoctor

Installer Prawn (bibliothèque PDF pour Ruby):

gem install prawn --version 1.3.0
gem install addressable --version 2.4.0
gem install prawn-svg --version 0.21.0

installer Asciidoctor-pdf :

gem install --pre asciidoctor-pdf

installer coderay :

gem install coderay pygments.rb

Vérifier que Asciidoctor PDF est bien  installé par :

asciidoctor-pdf -v

À partir de maintenant pour convertir un document Asciidoc (ex: « mondocument.adoc » ) en PDF faire :

asciidoctor-pdf mondocument.adocs

Pour adapter la sortie PDF a vos besoin, je vous convie d’aller voir le site (en anglais) :

 https://github.com/asciidoctor/asciidoctor-pdf/blob/master/docs/theming-guide.adoc