• # Asciidoc

    Posté par . En réponse au journal Le markdown, sous Emacs, et plus largement sous Linux. Évalué à 8. Dernière modification le 21 mai 2018 à 22:13.

    Quand je pense au nombre d’années que j’ai passé à me faire suer avec des traitements de texte WYSIWYG avant de découvrir markdown... je suis bien triste !

    C’est vraiment un plus d’avoir des documents au format texte, ça permet tous les traitements imaginables sans avoir à utiliser des bibliothèques et des outils précis. Pas de programme à installer, ça reste confortable de travailler avec un simple éditeur de texte. Même si, en effet, avoir le rendu en direct peut apporter un certain confort (mais aussi une distraction). Avec un langage de balisage léger, tu peux changer la charte graphique de tous tes documents à moindre coût, puisque fond et forme sont bien séparés.

    Par contre, j’ai abandonné Markdown (sauf pour Github...) je suis passé à asciidoc, et je vais bientôt passer à son successeur : asciidoctor. Même si la syntaxe me plaît moins que celle du markdown original (d’un point de vue esthétique), elle est plus riche, elle permet par exemple de faire des tableaux. Il y a des variantes de markdown qui le proposent aussi, mais je trouve l’éco-système autour d’asciidoc plus satisfaisant. Dans asciidoc j’apprécie notamment de pouvoir générer directement un document HTML5 (avec les images inline). Pour moi c’est le format de diffusion parfait, pas besoin de lecteur particulier, le navigateur fait l’affaire. Il me semble que PDF est aussi maintenant pris en charge directement par Chrome et Firefox certes... Avec une feuille de style adéquate j’obtiens un document qui respecte la charte graphique du modèle de document Word de l’entreprise. Les gens voyant qu’il s’agit d’un HTML qu’il ne peuvent (ou plutôt ne savent) éditer, vont souvent poser la question (« C’est quoi ? »). C’est une bonne occasion de présenter l’outil. Dans ces cas là il suffit de communiquer le fichier source, les gens comprennent instantanément le principe.

    Pandoc est aussi un outil bien utile à connaître, je confirme !