从许多 index.html 中创建一个共同的 Doxygen index.html

Question

我有一个 doc 文件夹，里面有很多文件夹。每个文件夹包含一个 doc.tag 文件（从 Doxygen 生成）和带有 Doxygen 输出的 html 文件夹。示例：

doc
|- Proj1
     |- doc.tag
     |- html
         |- index.html
         |- other doxygen html output
|- Proj2
     |- doc.tag
     |- html
         |- index.html
         |- other doxygen html output
| and so on

我想知道是否有任何方法可以从文件夹中的所有 index.html 文件创建一个通用的 Doxygen index.html。如果 Doxygen 搜索可以解决所有这些问题，那就太好了。

详细信息：每个文件夹都是一个 ROS 包，文档是从每个包的 CMakeLists.txt

中使用的 CMake 宏 (https://github.com/ethz-asl/doxygen_catkin) 生成的

Answer 1

最后的解决方案并不是很简单。但是，它是基于 this answer.

提到的 CMake 宏已修改为在每个文件夹中保存一个文件，其中包含该特定包的标记文件的完整路径。

然后，创建了一个依赖于所有其他目标的自定义 CMake 目标，以便我们确保它构建最后一个。包含一个 postbuild 命令，运行一个 python 脚本，它解析所有使用标记文件路径创建的文件，并配置一个包含这些标记文件路径的 Doxyfile。然后，运行这个 Doxyfile 中的 doxygen。

从许多 index.html 中创建一个共同的 Doxygen index.html

Create a common Doxygen index.html from many index.html

doxygen

ros