我有一個使用LaTeX的\documentclass{report}
(「報告」就像更緊湊版本的\documentclass{book}
)的「項目手冊」。我希望在本書中包含一個附錄,其中包含項目中軟件的Doxygen生成的API文檔。包括doxygen的LaTeX輸出作爲較大文檔的附錄
我已經通過將Doxygen的配置選項LATEX_HEADER
和LATEX_FOOTER
設置爲空文件來實現此目的。這使得所得的膠乳/ 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文檔樣式的其他方面,我更喜歡它。
所以我的問題是(本着精益求精的兩個級別):
這將是一個集乳膠最小的命令放在一個doxygen.sty文件將很好地呈現doxygen的附件,但不會干涉與LaTeX文件的其餘部分?
更妙的是,已經有人想出了做
\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中作爲一個選項,並且你錯過了它!」
我有同樣的問題。任何人都能評論?另見我的帖子[在這裏](http://stackoverflow.com/questions/12219578/individual-function-docs-in-latex-using-doxygen)。 – garyp 2012-08-31 18:30:13
我已經包含Doxygen膠乳生成PDF使用pdfpages包。 – Anna 2013-03-20 15:49:57
它並沒有真正接近正確的答案,但有一種方法可以確定要恢復的命令,並使用\ renew命令或\ forget命令將其刪除。我想你可能也可以使用\ includeonly來選擇性地得到你想要的而不用命令。 – 2013-05-11 23:18:32