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 文件像其他文件格式一样为 treated 之前，解决方法是使用其他文件格式之一（例如 *.dox）而不是 *.md 用于页面/子页面。目前，可以使用markdown格式，无需生成根级条目，仅适用于mainpage。