doxygen - 如何在多个文件中拆分 doxygen @mainpage 文档

Question

我想在@mainpage 部分中包含多个 .txt 文件(或 .md 文件，用 Markdown 编写)。

但是，我为这些文本文件中的每一个获得了一个单独的章节。这如何防止？

Answer 1

我在这里寻找相同问题的答案，由于似乎没有人解决过它，我自己也在寻找解决方案。
我发现这个...
http://www.doxygen.nl/manual/preprocessing.html

Source files that are used as input to doxygen can be parsed bydoxygen's built-in C-preprocessor. By default doxygen does onlypartial preprocessing.

所以要拆分页面，例如多个文件的主页，看起来解决方案是在 Markdown 文件上完全启用 C 预处理器，并使用

#include file1.md

#include file2.md

等以包含各种 Markdown 文件。
我们想做的是使用 Doxygen 的

\include file1.md

\include file2.md

但不幸的是，Doxygen 再次猜测我们要包含的文件是代码文件。
就像 Doxygen 有一个\htmlinclude 来节省你写两行

\htmlonly

\endhtmlonly

指定内容是 HTML，\include 命令实际上是一种\codeinclude 来保存您指定包含的内容是软件。
我个人更喜欢输入额外的两行来指定我包含的文件的性质:代码、HTML、markdown 或其他任何东西，并有一个通用的包含命令。但是他们说永远不要把礼物放在嘴里，这基本上意味着你不能与自由软件争论!