J'ai aussi longtemps cherché des outils permettant de faire de la documentation HTML et PDF. DocBook fait bien les deux mais c'est vieux et plus personne n'a envie de faire de XML.
Il y a plusieurs alternatives intéressantes :
pandoc, je m'en sers couplé à CMake (car mon application est en C++) et c'est pratique. Par contre c'est très brut, donc il faut vraiment mettre les mains dedans pour avoir un résultat complet.
mkdocs, pas testé mais ça avait l'air intéressant,
hugo, plutôt fait pour faire des siteweb mais ça peut très bien convenir pour de la documentation avec un thème adéquat. Je compte y passer. Pas de PDF par contre.
# DocBook n'est plus très populaire
Posté par David Demelier (site web personnel) . En réponse au journal DocBook ou l'art d'écrire de la documentation. Évalué à 4.
J'ai aussi longtemps cherché des outils permettant de faire de la documentation HTML et PDF. DocBook fait bien les deux mais c'est vieux et plus personne n'a envie de faire de XML.
Il y a plusieurs alternatives intéressantes :
AI is a mental disorder