将乳胶包添加到 doxygen 无法正常工作答案

【问题标题】：adding latex packages to doxygen can not work将乳胶包添加到 doxygen 无法正常工作
【发布时间】：2016-03-01 09:48:22
【问题描述】：

我想在我的 doxygen 生成的输出中添加一些图形。为此，我需要添加更多包：

\usepackage{tikz}
\usepackage{tikz-timing}
\usetikzlibrary{mindmap}
\usetikzlibrary{arrows,shadows}

前两行可以添加到Doxyfile with

EXTRA_PACKAGES         = {tikz} \
                         {tikz-qtree}

但另外两个不是。

是否有机会在pdflatex 开始之前将.tex 文件添加到生成的输出文件中？

添加

LATEX_EXTRA_STYLESHEET = packages.tex

不会工作。它使用了我的文件，但输出已损坏。似乎是在错误的地点或时间加载了包。

我尝试的第三件事是用

编写头文件

doxygen -w latex ....

这可行并且更改 header.tex 文件是可以的，但这最终总是生成标题，修补标题，使用自己的标题再次运行 doxygen。这是非常愚蠢的！

有什么想法吗？

【问题讨论】：

标签： latex doxygen

【解决方案1】：

EXTRA_PACKAGES 选项等同于 Latex 中的\usepackage 标签。这当然不适用于\usetikzlibrary 标签。您可以在 Doxyfile 中使用标签 LATEX_HEADER 添加修改后的 Latex 标头，例如：

LATEX_HEADER = ./templates/latex/YourCustomHeader.tex

然后 Doxygen 在生成文档时会拉取这个 Latex 头文件。在此文件中，您可以添加使用的包和库。

顺便说一句：在运行 make.bat 脚本之前不会使用自定义样式表，因此在 Doxygen 生成 Latex 文件后将修改后的“doxygen.sty”文件复制到输出文件夹就足够了，但是在运行“make.bat”脚本生成 PDF 文件之前。我通过一个脚本执行此操作，该脚本首先调用 doxygen，然后将必要的文件复制到输出文件夹，最后调用“make.bat”脚本...

【讨论】：

我的问题中已经提到了LATEX_HEADER 的“解决方案”。如前所述，它需要进一步编写脚本，因为文档的第一页是在此头文件中生成的。所以这样工作还是很无聊，因为你必须生成头文件doxygen -w，并为你想要生成的每个文档打补丁。不是很好...