J'ai documenté mon code pour doxygen, mais je ne veux pas le code HTML par défaut qu'il donne. Je sais que je peux le personnaliser en fournissant des CSS, des en-têtes, des pieds de page, etc. personnalisés (comme le fait GNOME), et comment je peux ajouter du code PHP commun aux fichiers et lui dire d'enregistrer sous .php, mais ce n'est pas vraiment ce que je veux .
Ce que je veux, c'est une sortie comme MSDN. Je ne peux pas vraiment le décrire. Ma question est la suivante: est-ce possible d'utiliser doxygen avec quelque chose comme des modèles, ou dois-je produire du XML et l'analyser avec un autre programme (que cela ne me dérangerait pas d'écrire)?
documentation
templates
documentation-generation
Cole Johnson
la source
la source
Réponses:
Pour autant que je sache, Doxygen ne prend pas en charge quelque chose comme les modèles HTML . Vous pouvez vous référer à l'image ci-dessous (depuis la page d'accueil officielle de doxygen ). Il affiche les fichiers d'entrée et de sortie liés à l'ensemble du flux de travail de création de documentation.
Comme vous pouvez le voir, doxygen lit un soi-disant "fichier de mise en page". Ce fichier peut être personnalisé ! Cependant, vous êtes en quelque sorte limité à la structure de la page, doxygen crée.
Si vous avez besoin de plus de flexibilité, vous devriez préférer la sortie XML de transformation XSLT . Il existe également un exemple qui vous montre comment procéder.
la source