8

Doxygen を使用してコードのドキュメントを生成しています。これの PDF バージョンを作成する必要があり、Doxygen の LaTeX 出力を使用するのがその方法のようです。

しかし、私は多くの厄介な問題に遭遇しました.LaTeXについて何も知らなかったので、それらにアプローチする方法についてはあまり考えていませんでした.LaTeX関連の数え切れないほどの参考文献はあまり役に立ちません...

sty ファイルでカスタム スタイルのものを作成する方法と、Doxygen でそれを使用する方法を考え出しました。何度も検索した後、これを介してページマージンなどを設定する方法を見つけました。おそらくこれは、他の必要なことを行うために必要なファイルであると推測していますが、doignのコマンドが見つからないようです私が欲しいもの:(

  1. 文書の最初の目次には多くの項目が含まれていますが、内容が非常に長くなるため、そうではありませんでした。この内容を、個々の関数や変数などごとに入力するのではなく、最初の 2 つのレベルだけに制限する方法はありますか? ただし、すべてのブックマークを保持したいです。「COMPACT_LATEX」オプションを試してみましたが、目次ページのアイテムを削除するだけでなく、ブックマークと各セクションの最初のメンバーリストも削除しました。これは本当に残しておきたいものです。

  2. すべてのメンバーと属性の後ではなく、完全なクラスの説明をセクションの最初に置くなど、物事の順序を変更する方法はありますか?

4

3 に答える 3

7

うわー、それはDoxygenの一種の悪です。

さて、カウンターの問題を回避するには、次の行をファイルtocdepthに追加します。.sty

\AtBeginDocument{\setcounter{tocdepth}{2}}% or whatever level you want

PDF ブックマークの深さを別の値に設定できます。

% requires you \usepackage{hyperref} first
\hypersetup{
  bookmarksdepth = section, % of whatever level you want
}

また、図/表のリストがある場合、tocdepthそれらが表示されるには少なくとも 2 つある必要があることに注意してください。

これらの項目を LaTeX ファイル内で再配置する方法は見当たらない.--Doxygen はそれらをそこにバーフするだけなので、たいしたことはできない. 私が推測する順序を指定する方法があるかどうかを確認するには、Doxygen のドキュメントを調べてみる必要があります。（ここは期待！）

于 2010-03-01T14:14:55.253 に答える
2

あなたはとても近いです。

「ラテックスコンテンツレベル」でグーグル検索すると、LaTeXにたどり着きました-提案する論文のさまざまな部分の目次の深さをカスタマイズします

\setcounter{tocdepth}{n}

ここでn、最高レベルの部門のみがゼロから始まります。これはすべてのデフォルト スタイルで定義されていると思われますが、doxygen で試してみる価値があります。

于 2010-02-28T00:27:33.993 に答える
1

Perl / Awkスクリプトを記述して、目次から不要な行を削除することができます。ファイルの場合、LaTeXは次のような行を含むburble.texファイルを生成します。burble.toc

\ contentsline{subsection}{クラスFの書き換え}{38}
\ contentsline{subsection}{クラスMの書き換え}{39}
\ contentsline {section} {\numberline{7}翻訳の定義とプロパティ}{44}
\contentsline{段落}{整形式化}{54}

単純な正規表現は、各行が属するレベルを識別し、それに基づいてファイルをフィルタリングできます。目次を希望どおりに作成したら\nofiles、適切な場所（スタイルシート？）に挿入します。これは、LaTeXが補助ファイルを読み取るが、上書きしないことを意味します。

于 2010-03-01T10:38:31.230 に答える