J'avais hésité à utiliser DocBook pour écrire une documentation commune qui serait ensuite transformé en html ou pdf. Mais la lourdeur des outils à mettre en place et la verbosité du xml m'a fait basculer vers AsciiDoctor qui est plus léger et utilise la syntaxe Markdown.
[^] # Re: Aaaah Docbook...
Posté par mzf (site web personnel) . En réponse au journal DocBook ou l'art d'écrire de la documentation. Évalué à 2.
J'avais hésité à utiliser DocBook pour écrire une documentation commune qui serait ensuite transformé en html ou pdf. Mais la lourdeur des outils à mettre en place et la verbosité du xml m'a fait basculer vers AsciiDoctor qui est plus léger et utilise la syntaxe Markdown.
Exemple de résultat avec AsciiDoctor: version html, version pdf, et sources markdown.
Et les liens hypertextes sont conservés dans le html et le pdf !