【发布时间】:2023-03-19 21:30:01
【问题描述】:
当我生成 PDF 格式的 Doxygen 文档时,我会得到很多不同的文件,每个文件都有一个图表。
是否可以获得单个 PDF 文档,组织为一本书,大致为 HTML 版本?
是否可以自动获取它,即无需手动处理乳胶文件?
谢谢!
【问题讨论】:
标签: pdf pdf-generation doxygen documentation-generation pdflatex
当我生成 PDF 格式的 Doxygen 文档时,我会得到很多不同的文件,每个文件都有一个图表。
是否可以获得单个 PDF 文档,组织为一本书,大致为 HTML 版本?
是否可以自动获取它,即无需手动处理乳胶文件?
谢谢!
【问题讨论】:
标签: pdf pdf-generation doxygen documentation-generation pdflatex
见Converting a LaTeX document to a PDF document。
当 Doxygen 完成处理后,在 latex 目录中有一个名为“refman.tex”的文件。
您可以通过三种方式使用该文件从 Doxygen 中获取“一本书”:
LaTeX -> dvips -> ps2pdf
乳胶我的文件
dvips 我的文件
ps2pdf myfile.ps
LaTeX -> dvipdfm
乳胶我的文件
dvipdfm 我的文件
pdflatex(或纯 TeX 的 pdftex)
pdflatex 我的文件
【讨论】:
使用 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
运行 Doxygen。
{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,...
意味着您根本没有 prerequisites 来运行乳胶。其他错误可能是由于缺少乳胶包或 doxygen 错误导致无效的 .tex 文件。
一旦你安装了所有的先决条件,以及一个好的 doxygen 版本,更简单的过程应该每次都可以工作。
【讨论】:
假设 doxygen 配置正确,在 Linux 下:
doxygen
cd latex
make
除非另有配置,否则生成的文件将是 refman.pdf。
【讨论】:
Patel 是对的 - 您需要运行 Doxygen,然后运行某种 Latex 来创建单个文档。
对我来说,使用 Doxygen 1.7.3,latex 构建的根文件似乎是“refman.tex”。
Doxygen 也会创建一个 Makefile,所以如果你有 make(我的 Win7 机器上没有),你可以在 latex 目录中输入 make。
我将我的 TeXnicCenter 应用程序指向 refman.tex,并以此方式构建。
希望这会有所帮助,
-马特
【讨论】:
其他人没有提及细节:
要使 pdflatex 路由正常工作,您当前的工作目录需要是生成的 Latex 文件夹,否则会出现 doxygen.sty cannot be found 之类的错误。
【讨论】:
我想补充一个额外的建议。 不要忽视乳胶警告。 pdflatex 可能无法生成输出文件以及任何有意义的错误。
我也遇到过类似的烦人情况,仅修复所有警告有助于生成正确的输出文件,而不会出现任何进一步的问题。
【讨论】: