Bonne référence, en complément du précédent lien

Pleins d'astuces pour asciidoctor, plus condensé que la doc officielle.

Plusieurs outils peuvent être utilisés pour la coloration syntaxique avec asciidoctor :

* coderay
* highlight.js (paquet debian libjs-highlight.js)
* pygments.rb (paquet debian ruby-pygments.rb)

Pour forcer l'utilisation de l'un ou l'autre, utiliser l'attribut :source-highlighter: dans le document en le définissant à coderay, highlight.js ou pygments (pas de .rb).

Pour la prévisualisation dans firefox avec l'addon Asciidoctor Live Preview, seul highlight.js fonctionne. Du coup il peut être mieux d'ouvrir le fichier html généré et d'utiliser l'addon firefox "Auto Reload" pour voir en live les modifications.

Quelques spécificités, highlight.js ne gère pas les numéros de ligne, coderay ne gère pas bash par exemple.