2012-04-20 7 views
15

LaTeXの\documentclass{report}(「レポート」は\documentclass{book}のよりコンパクトなバージョンのようです)を使用する「プロジェクトブック」があります。この本には、プロジェクトのソフトウェアに関するDoxygenで生成されたAPIドキュメントの付録が含まれています。大きな文書の附属書としてdoxygenのLaTeX出力を含む

Doxygenの設定オプションLATEX_HEADERLATEX_FOOTERを空のファイルに設定することでこれを実現しました。私はのようなトップレベルの文書でこれをラップすることができ、その時点で\section{\-Namespace \-Index}、::これは、得られたラテックス/ refman.texのようなトップレベルのコマンドを持っています

\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のでdoxygen.styを取得します呼び出し:

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

一つの問題は、これは、文書全体に(だけでなく、doxygenの付録の)「自動生成」ヘッダを置くことです。私はdoxygen.styを編集することでこれを取り除くことができます(実際に私の包含のために名前を変更します)、そして% Setup fancy headingsで始まるブロックをコメントアウトします。

この時点で私は一緒に暮らすことができるものがありますが、さらに進んでいきたいと思います。「doxygen」スタイルは、LaTeXドキュメントスタイルの多くの面を変更しています。

だから私の質問は、(卓越性の二つのレベルで)です:

  1. のLaTeXの最小セットがうまくdoxygenの付録をレンダリングしますが干渉しないdoxygen.styファイルに格納するためのコマンドであるもの残りの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に存在しています。あなたはそれを見逃しました!」というような本当に簡単な答えがあることを期待しています。その後、

+2

私は同じ質問を持っています。誰でもコメントできますか?私のポストを参照してください[ここに](http://stackoverflow.com/questions/12219578/individual-function-docs-in-latex-using-doxygen)。 – garyp

+1

私はpdfpagesパッケージを使用してDoxygenラテックス生成PDFを含んでいます。 – Anna

+0

本当に適切な答えに近づくわけではありませんが、元に戻すコマンドを特定し、それらを削除するために\ renewcommandまたは\ forgetcommandを使用する方法があります。おそらく\ includeonlyを使い、コマンドなしであなたが望むものを選択的に得ることができると思います。 –

答えて

1

mydoxygen.styするリネームdoxygen.sty、 \ newenvironment {} doxygenを挿入して、それを修正する{... doxygen.styのほとんどはここに行くと...} {}

関連する問題