
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