treeview - Doxygen：如何在树视图中隐藏某些页面

Question

我有一个我自己无法解决的问题。请帮忙。

我有（有条件地）：

/** @mainpage A
@subpage B
*/

/** @page B 
@subpage C
*/

/** @page C */

Doxygen 使所有页面都显示在根级别上的树。

+A/
|---B/
|------C
|---B <- 想隐藏
|---C <- 想隐藏

但我只需要顶部（此处的 A 和嵌套的 B 和 C）可见，即应该相应地组织 @subpage 标记。

我还尝试在 DoxygenLayout.xml 中将可见设置为“否”。但它隐藏了所有页面，只剩下“文件”和“类”。

提前谢谢。

Answer 1

当页面/子页面文件属于大多数受支持的格式（如*.c,*.cpp等）时，您的代码会生成所需的树视图（仅在根级别没有单独条目的嵌套页面） *.dox。我能找到的唯一例外（在 Doxygen 1.8.6 中） ) 是降价格式 (*.md或*.markdown)，也会为其生成单独的根级别条目。

在 markdown 文件被视为其他文件格式之前，解决方法是使用其他文件格式之一（如*.dox）而不是*.md页面/子页面。目前，可以使用 markdown 格式，无需生成根级条目，仅用于mainpage。