doxygen 创建一个顶级项目，索引/链接到子项目

Question

我已经阅读了 this and this 但我仍然不知道该怎么做。

所以我这里有一个虚构的例子（只是为了保留它small/simple）：

top_level/
    |
    |--- proj1/
    |      |--- html/
    |
    |--- proj2/
    |      |--- html/

所以这里 proj1 和 proj2 都生成了 html 风格的 doxygen 输出到子文件夹 html/ - 这样每个子文件夹都包含一个 index.html

我现在真正想做的就是创建一个顶级 doxygen 页面，该页面将位于 top_level/html/ 中，也许还命名为 index.html，指向两个子项目。

这可能吗？我真的在寻找一个具体的例子。

我对标记文件有点了解。我能够为每个子项目生成标记文件（通过设置 GENERATE_TAGFILE=html/doxy.tag。我还将其添加到 top_level 项目中：TAGFILES=proj1/html/doxy.tag

但我仍然只有一个空的 top_level 页面 :(

Answer 1

嗯...我有点放弃标签了。

在我的顶级项目中，我创建了一个 doxygen.md 文件。我将其添加到 INPUTS Doxyfile 标签中。

在该文件中，它看起来像：

@mainpage

 .... some text ...

## Sub Modules
* <a href="../proj1/html/index.html>proj1</a>
* <a href="../proj2/html/index.html>proj1</a>

这比乱用标签简单多了——而且它不需要子文件夹来生成标签——我放弃了这个想法！ :)

doxygen create a top level project that indexes / links to sub projects