Doxygen 另一个文件中的页节

似乎无法找到如何执行以下操作：

我有一个很大的文档

@页面

，我想把这些部分分成单独的文件，例如

page.dox
section1.dox
section2.dox

---

我该怎么做？本质上，我正在寻找一个Latex

\input{}

等价物。

我也找不到任何方法将另一个文件中的文本带入同一页面

\include

和相关文件是专门为包含代码、逐字HTML等而设计的，并且关闭对所包含文本中任何Doxygen命令的处理。这是完美的，它的目的是什么，但不是真正的用途为您的需要

实现您想要的最简单的方法可能是用您最喜欢的脚本语言编写一个短脚本，将原始源文件连接到一个更大的源文件中，以便Doxygen进行后续处理

---

你确定要这样做吗？你不想把这些章节放在单独的页面上有什么特别的原因吗？我发现很难看到这样一种情况：源文件太长，以至于需要拆分，但生成的输出页面却不需要拆分。

您可以简单地重复page命令，并确保页面部分按正确的顺序列出

例如：

page.dox

：

/** 
@page mypage Page title
Introduction text
*/

/** 
@page mypage
@section mysection1 First section
First section text
*/

/** 
@page mypage
@section mysection2 Second section
Second section text
*/

第1.dox节

：

/** 
@page mypage Page title
Introduction text
*/

/** 
@page mypage
@section mysection1 First section
First section text
*/

/** 
@page mypage
@section mysection2 Second section
Second section text
*/

第2.dox节

：

/** 
@page mypage Page title
Introduction text
*/

/** 
@page mypage
@section mysection1 First section
First section text
*/

/** 
@page mypage
@section mysection2 Second section
Second section text
*/

使用配置文件指定：

INPUT                  = page.dox section1.dox section2.dox

---

然后，Doxygen会将这些部分转换为一个单独的页面。

我可以确认您是否希望输出为一个单独的文本页面，其中包含来自不同源文件的部分吗？@Cheeseminer正确。是的，基本上我们有一个配置/构建页面/部分/等，并且单个文件越来越大。如果有一种Doxygen方法可以实现这一点，那就太好了，但我想我可以使用CMake插入部分，我要做的是将输出也分解为页面，在每个页面的末尾都有一个指向配置/构建序列中下一个页面的链接（可能还有一个反向链接）。我在头版放了一个项目列表，让用户可以跳转到相关的部分。你所失去的只是不间断地滚动整个文档的能力，但是如果文档变得“相当大”，那么对于读者来说，输出可能也会变得很难处理。