Doxygen : Comment masquer certaines pages dans l'arborescence ?

Question

J'ai un problème que je n'ai pas pu résoudre par moi-même. Veuillez m'aider.

Je l'ai fait (sous condition) :

/** @mainpage A
@subpage B
*/

/** @page B 
@subpage C
*/

/** @page C */

Doxygen crée l'arbre où toutes les pages sont affichées au niveau de la racine.

+A/
|---B/
|------C
|---B <- VOULOIR CACHER
|---C <- VEULENT CACHER

mais j'ai besoin que seul le haut (A ici et B et C imbriqués) soit visible, c'est-à-dire qu'il doit être organisé en fonction des balises @subpage.

J'ai également essayé de définir la visibilité sur 'non'. dans DoxygenLayout.xml. Mais cela masque toutes les pages, il ne reste que 'files' et 'classes'. sont laissées.

Merci d'avance.

Answer 1

Votre code génère l'arborescence requise (uniquement les pages imbriquées sans entrées distinctes au niveau de la racine) lorsque les fichiers de pages/sous-pages appartiennent à la plupart des formats pris en charge, tels que *.c , *.cpp , *.dox etc. La seule exception que j'ai pu trouver (dans Doxygen 1.8.6) est le format markdown ( *.md o *.markdown ), pour lesquels des entrées distinctes de niveau Racine sont également générées.

Jusqu'à ce que les fichiers markdown soient traité comme les autres formats de fichier, une solution de contournement consisterait à utiliser l'un des autres formats de fichier (par exemple *.dox ) au lieu de *.md pour les pages/sous-pages. Actuellement, le format markdown peut être utilisé, sans générer d'entrées de niveau racine, uniquement pour la section page principale .