包括doxygen的LaTeX输出作为更大文档的附录

Question

我有一个使用LaTeX的"项目书" \documentclass{report}("报告"就像一个更紧凑的版本\documentclass{book}).我想在本书中附上一个附录,其中包含项目中软件的Doxygen生成的API文档.

我通过设置Doxygen的配置选项LATEX_HEADER和LATEX_FOOTER空文件来实现这一点.这使得生成的latex/refman.tex具有如下顶级命令:\section{\-Namespace \-Index},此时我可以用顶级文档包装它,如:

\documentclass{report}
\usepackage{doxygen.sty}
% the "import" package helps to find Doxygen files in the latex/ subdirectory
\usepackage{import}
% [...] title page and the rest of the book

\appendix
\chapter{API reference (generated by Doxygen)
subimport{latex/}{refman.tex}

% [...] final stuff
\end{document}

这工作得相当好,我得到doxygen.sty了这个特殊的doxygen调用:

doxygen -w latex /dev/null /dev/null doxygen.sty

一个问题是,这会在整个文档上放置一个"自动生成"的标题(而不仅仅是在doxygen附录上).我可以通过编辑来解决这个问题doxygen.sty(实际上我也将它重命名为包含它)并注释掉以该块开头的块% Setup fancy headings.

在这一点上,我有一些我可以忍受的东西,但我想更进一步:"doxygen"风格修改了LaTeX文档样式的许多其他方面,我更喜欢它.

所以我的问题是(两个级别的卓越):

1. 什么是最小的LaTeX命令集放在doxygen.sty文件中,可以很好地渲染doxygen附录但不会干扰LaTeX文档的其余部分？

2. 更好的是,有人想出办法

   \usepackage{doxygen_standalone}
   % [... until you need doxygen]
   \begin{doxygen}
   % the stuff you need to insert your auto-generated doxygen API docs,
   % for example the \subimport{latex/}{refman.tex} that I showed above
   \end{doxygen}
   

最后一种方法是我认为非常干净的方法.

我希望有一个非常简单的答案,例如"这已经存在于doxygen.sty作为选项,你错过了它!"

Answer 1

将 doxygen.sty 重命名为 mydoxygen.sty，然后通过插入 \newenvironment{doxygen}{... 大部分 doxygen.sty 位于此处 ...}{} 对其进行修改