08102008Auteur: Fabien Schwob
Dans:
Logiciel Il n'est pas toujours facile de maintenir la documentation d'un projet de développement, voici donc quelques outils en Python pour publier des documentations au format HTML :
- Helpify, un script Python de The Omni Group qui permet de convertir un fichier au format OmniOutliner vers le format d'aide d'Apple (qui est en HTML).
- Sphinx, une projet qui prend de plus en plus d'ampleur dans le monde Python (Python, Django, etc.) et qui permet de convertir des fichiers reStructuredText (une syntaxe proche de celle de Trac) vers de l'HTML et du LaTex (et donc du PS/PDF).
mouviciel
29 novembre 2008 | 16:13
Ce n'est pas du Python mais ça peut intéresser: pour ma part, j'utilise Doxygen dans mes développements Cocoa. Il produit du HTML, RTF, Latex (et donc Postscript et Pdf). On peut ajouter une étape de build pour générer la documentation en même temps que la compilation et il est même possible de produire en plus une documentation au format Apple, donc consultable via la commande Documentation du menu Help.