【问题标题】:How to get a single PDF document from Doxygen?如何从 Doxygen 获取单个 PDF 文档?
【发布时间】:2023-03-19 21:30:01
【问题描述】:

当我生成 PDF 格式的 Doxygen 文档时,我会得到很多不同的文件,每个文件都有一个图表。
是否可以获得单个 PDF 文档,组织为一本书,大致为 HTML 版本?
是否可以自动获取它,即无需手动处理乳胶文件?

谢谢!

【问题讨论】:

    标签: pdf pdf-generation doxygen documentation-generation pdflatex


    【解决方案1】:

    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 我的文件

    【讨论】:

      【解决方案2】:

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

      1. 为 LaTeX 输出配置 Doxygen。

        GENERATE_LATEX = YES LATEX_OUTPUT = latex OUTPUT_DIRECTORY =

      2. 为 LaTeX 输出设置所有图像。

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

      3. 运行 Doxygen。

      4. 运行{OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\make.bat.
      5. 打开{OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\refman.pdf

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

      错误如下: 'pdflatex' is not recognized as an internal or external command,... 意味着您根本没有 prerequisites 来运行乳胶。其他错误可能是由于缺少乳胶包或 doxygen 错误导致无效的 .tex 文件。

      一旦你安装了所有的先决条件,以及一个好的 doxygen 版本,更简单的过程应该每次都可以工作。

      【讨论】:

      • make.bat 是windows版本生成的,Linux上生成的文件叫做Makefile。
      • 是否必须通过它才能制作,还是脚本?
      • 由make执行
      • 在 Linux 上,在“latex”目录中输入“make”。生成的文档是“refman.pdf”。
      • 在我的情况下,通过 \image 指定的所有图像都丢失了。我错过了什么吗?
      【解决方案3】:

      假设 doxygen 配置正确,在 Linux 下:

      doxygen
      cd latex
      make
      

      除非另有配置,否则生成的文件将是 refman.pdf

      【讨论】:

        【解决方案4】:

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

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

        Doxygen 也会创建一个 Makefile,所以如果你有 make(我的 Win7 机器上没有),你可以在 latex 目录中输入 make

        我将我的 TeXnicCenter 应用程序指向 refman.tex,并以此方式构建。

        希望这会有所帮助,

        -马特

        【讨论】:

        • Doxygen 在 Windows 系统上也有一个 make.bat 并且是一个 Makefile(用于 *nix make)
        【解决方案5】:

        其他人没有提及细节:

        要使 pdflatex 路由正常工作,您当前的工作目录需要是生成的 Latex 文件夹,否则会出现 doxygen.sty cannot be found 之类的错误。

        【讨论】:

          【解决方案6】:

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

          我也遇到过类似的烦人情况,仅修复所有警告有助于生成正确的输出文件,而不会出现任何进一步的问题。

          【讨论】:

            猜你喜欢
            • 2014-09-09
            • 1970-01-01
            • 1970-01-01
            • 2012-08-07
            • 1970-01-01
            • 1970-01-01
            • 1970-01-01
            • 1970-01-01
            • 1970-01-01
            相关资源
            最近更新 更多