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

Question

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

安装

--在macos上安装

--安装在windows上

--安装在linux上

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

我的 install.md 文件如下:

@页面安装

@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

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