{{tag>Trusty programmation java}} ---- ======= Doxygen ====== {{:doxygen.png?150 }} **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 [[:sudo|droits d'administration]] ; * Avoir une connexion internet activée et opérationnelle ; * [[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **[[apt://doxygen,doxygen-gui,doxygen-doc|doxygen doxygen-gui doxygen-doc]]**. ===== Utilisation ===== Pour lancer l'interface graphique de Doxygen, ouvrez un terminal et entrez la commande suivante : doxywizard il ne vous reste plus qu'à [[:raccourci-lanceur|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. ===== 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.\\ [[https://touticphoto.fr/developpement/48-documenter-un-projet-avec-graphes-avec-doxygen-et-graphviz|Article pour aller plus loin]] ===== Liens ===== * Page officielle de [[http://www.doxygen.org/|Doxygen]] * Tous les [[http://www.stack.nl/~dimitri/doxygen/output.html|formats de sortie]] possibles * [[http://www.stack.nl/~dimitri/doxygen/results.html|Quelques exemples]] de documentation générés à partir de Doxygen * La longue liste des [[http://www.stack.nl/~dimitri/doxygen/projects.html|projets connus]] utilisant Doxygen ----- //Contributeurs : [[utilisateurs:poupoul2]], [[utilisateurs:bcag2]]//