如何从 Doxygen 获取单个 PDF 文档？

Question

当我生成 PDF 格式的 Doxygen 文档时，我会得到大量不同的文件，每个文件中都有一个图表。
是否可以获得一个 PDF 文档，以一本书的形式组织，大致与 HTML 版本相同？
是否可以自动获取它，即无需手动处理乳胶文件？

谢谢！

Answer 1

当 Doxygen 处理完成后，在 Latex 目录中会有一个名为“refman.tex”的文件。

您可以通过三种方式使用该文件从 Doxygen 中获取“一本书”：

Answer 2

假设doxygen配置正确，在Linux下：

doxygen
cd latex
make

生成的文件将为refman.pdf，除非另有配置。

Answer 3

使用 Doxygen 1.8.4+（在 Windows 上），还有一个 make.bat 脚本，因此您甚至不需要打开命令行。

为 LaTeX 输出配置 Doxygen。

GENERATE_LATEX         = YES
LATEX_OUTPUT           = latex
OUTPUT_DIRECTORY       =

设置所有图像以进行 LaTeX 输出。

\image html application.jpg
\image latex application.eps "My application" width=10cm

奔跑

{OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\make.bat.

打开

{OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\refman.pdf

。

如果未创建 refman.pdf，请从命令窗口运行 make.bat 并读取错误。

错误如：

'pdflatex' is not recognized as an internal or external command,

... 意味着您根本不具备运行 Latex 的先决条件。其他错误可能是由于缺少 Latex 包或 doxygen 错误导致无效的 .tex 文件。

一旦安装了所有先决条件以及良好版本的 doxygen，更简单的过程每次都应该有效。

Answer 4

Patel 是对的 - 您需要运行 Doxygen，然后运行某种 Latex 来创建单个文档。

对于我来说，使用 Doxygen 1.7.3，latex 构建的根文件似乎是“refman.tex”。

Doxygen 也会创建一个 Makefile，所以如果你有 make（我的 Win7 机器上没有），你只需在 Latex 目录中输入

make

即可。

我将我的 TeXnicCenter 应用程序指向 refman.tex，然后按照这种方式构建。

希望这有帮助，

-马特

Answer 5

其他人没有提到细节：

要使 pdflatex 路由正常工作，您当前的工作目录必须是生成的 Latex 文件夹，否则您会收到类似

doxygen.sty cannot be found

的错误。

Answer 6

我想补充一条额外的建议。 不要忽视乳胶警告。 pdflatex 可能无法生成输出文件以及任何有意义的错误。

我遇到了类似的恼人情况，只需修复所有警告即可帮助生成正确的输出文件，而不会出现任何进一步的问题。

Answer 7

使用 Make 生成 PDF

我按照上述步骤操作，并在使用以下步骤生成 PDF 时成功避免了错误消息：

LATEX_CMD?=pdflatex -interaction=nonstopmode
MKIDX_CMD?=makeindex
BIBTEX_CMD?=bibtex
LATEX_COUNT?=8
MANUAL_FILE?=refman
.....etc

# Inside the latex directory
make