使用 Doxygen 生成 Markdown 用户文档时如何摆脱空白页面

Question

目前我正在使用 Doxygen 从几个 Markdown 文件生成用户文档。我想生成一个自定义导航树，如下所示：

• 安装
• --在macos上安装
• --安装在windows上
• --在linux上安装

我这里有 4 个降价页面。假设它们是“install.md”、“macos.md”、“windows.md”和“linux.md”。

我的 install.md 文件如下：

• @page 安装
• @subpage macos
• @子页面窗口
• @subpage linux

并且 "macos.md" 、 "windows.md" 和 "linux.md" 都有自己的页面标题：例如@page macos 、@page windows 和@page linux。

结果很好，但它生成了几个带有文件名的空页面。

我怎样才能摆脱所有这些空页面文件？

提前致谢。

Answer 1

我花了很长时间寻找一个像样的解决方案，这就是我发现的：

在主 Markdown 文件（此处为 install.md）中，定义一个组，例如：

\defgroup GrpDummyPages HiddenEmpty
@{
@}

然后在您的子页面中，例如您的“windows.md”，在开头添加：

\ingroup GrpDummyPages

在您的树视图中将出现一个“模块”部分，其中包含子类别“HiddenEmpty”，其中将包含您放置 ingroup 命令的页面/文件。