另一个文件中的页面部分

Question

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

我有一个大型文档@page，我想将这些部分拆分成单独的文件，例如。

page.dox
section1.dox
section2.dox

我该怎么做？实质上，我正在寻找一个Latex \input{}等价物。

Answer 1

您只需重复页面命令，并确保以正确的顺序列出页面部分。

例如：

page.dox：

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

section1.dox：

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

section2.dox：

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

使用配置文件指定：

INPUT                  = page.dox section1.dox section2.dox

Doxygen会将部件变成单页。

Answer 2

我也无法找到将其他文件中的文本引入同一页面的任何方法。

\include和相关commands专门用于包含代码，逐字HTML等，并且关闭所包含文本中任何Doxygen命令的处理。这非常适合它的用途，但不能满足您的需求。

实现所需内容的最简单方法可能是用您喜欢的脚本语言编写一个简短的脚本，将原始源文件连接成一个较大的源文件，供Doxygen随后处理。

你确定要这么做吗？是否有一个特殊原因导致您不希望将这些部分放在单独的页面上？我发现很难看到源太长以至于需要拆分的情况，但结果输出页面却没有。