Doxygen
Doxygen est un système de documentation pour C, C++, Java, Python, Php et autres langages. Il permet de générer la documentation de vos développements :
- à partir des commentaires insérés dans le code source
- à défaut de commentaires, à partir de la structure du code lui même. La documentation générée sera dans ce cas minimale.
La documentation peut être produite dans des formats variés tels que du HTML, du Latex, du RTF ou du XML.
Doxygen est un logiciel libre, publié sous licence GPL V2.0.
Installation
Pré-requis :
- Disposer des droits d'administration ;
- Avoir une connexion internet activée et opérationnelle ;
Utilisation
Interface graphique
Ouvrez un terminal et entrez la commande suivante :
doxywizard
il ne vous reste plus qu'à créer un raccourci avec cette commande.
Le bouton wizard vous permet
- de créer votre projet
- de sélectionner le dossier contenant les sources ou celui accueillant votre documentation
- de sélectionner le format de sortie : HTML avec ou sans frames, Latex, RTF, pages man, XML, PDF, Postscript.
- de générer des diagrammes
Le bouton Expert vous permet d'accéder aux options avancées.
Le boutons Save vous permet de sauvegarder votre projet de documentation, après configuration.
Il ne vous reste alors plus qu'à cliquer sur Run pour obtenir le résultat. Libre à vous ensuite d'aller personnaliser votre Latex ou d'associer votre CSS à la documentation générée.
En ligne de commande
Il est conseillé de commencer avec le wizard, au moins à fin de créer votre DoxyFile (que vous pouvez nommer comme vous le souhaitez). Ensuite, il suffit de lancer:
doxygen DoxyFile
Extensions
Pour intégrer des graphes de classe, de collaboration… doxygen donne accès, en mode wizard à un onglet diagram, et en mode expert aux paramètres DOT qui permet d'utiliser graphViz pour les générer.
Article pour aller plus loin
Liens
- Page officielle de Doxygen
- Tous les formats de sortie possibles
- Quelques exemples de documentation générés à partir de Doxygen
- La longue liste des projets connus utilisant Doxygen