2009-07-16 9 views
1

J'utilise doxygen pour générer une référence API à partir du code source, afin de le convertir en un fichier d'aide CHM et éventuellement en un plugin pour Eclipse. Malheureusement, l'ordre et l'imbrication par défaut des classes, espaces de noms, etc. dans la table des matières n'est pas exactement idéal et je préférerais le personnaliser si possible.Personnalisation de la sortie doxygen pour le HTML Table des matières

Par défaut, doxygen crée deux index/menus pour naviguer dans la documentation générée. L'un est la table des matières commune sur le cadre gauche et l'autre est la rangée de boutons en haut de chaque page HTML individuelle. Ce dernier peut être confortablement personnalisé en éditant le fichier XML de mise en page tel que décrit dans doxygen manual (voir la section 'Changement de la disposition des pages') mais jusqu'à présent je n'ai vu aucun moyen de faire des modifications similaires pour la table des matières.

Pour utiliser un exemple précis, je suis à la recherche d'un moyen pour nicher les trois thèmes standards Liste de classe, Hiérarchie des classes et classe Membres comme sous-thèmes à l'intérieur d'un sujet parent dans la table des matières, comme cela se fait par par défaut dans le système de menus situé au-dessus de chaque page.

J'imagine que ce n'est pas le problème le plus inhabituel et peut avoir une solution connue disponible.

Merci pour votre aide!

Répondre

2

Je ne pense pas qu'il existe un moyen de changer cela. Je générerais probablement une copie de tree.html dans un éditeur, modifierais l'imbrication des trois éléments à la main, diff par rapport à l'original, puis exécuterais quelque chose après la construction (XSL, Perl Script, Sed , tout ce qui est pratique) pour rechercher/remplacer l'extrait de texte.