Windows上でDoxygenのPDF形式出力

DoxygenでAPIドキュメント生成するのは非常に便利ですが、HTML形式では印刷するとき大変なので、試しにPDF形式ドキュメントを生成するよう変更しました。手順は下記通り

• Texインストール
  PDFで生成するにはまずTexをインストールする必要があります。下記ページから「TeXインストーラ3」をダウンロードします。
  http://www.ms.u-tokyo.ac.jp/~abenori/mycreate/

• listings/xcolorインストール
  下記ページからlistings/xcolorパッケージをダウンロード
  　　http://tug.ctan.org/tex-archive/macros/latex/contrib/listings/
  　　http://tug.ctan.org/tex-archive/macros/latex/contrib/xcolor/

• 上記ファイルを解凍し、下記コマンドを実行
  　　> platex listings.ins
  　　> platex xcolor.ins
• 生成されたファイルを下記フォルダにコピー
  　　w32tex\share\texmf-local\tex\latex
  

• mediabb.styインストール（2011/01/26追記）
  Class Graphを生成する場合、PDF形式の図を挿入する必要があります。そのためmediabb.styパッケージをインストールします。
  下記URLからダウンロードできます
  　　http://www.ma.ns.musashi-tech.ac.jp/Pages/TeX/mediabb.sty.html
  ダウンロードしたら下記フォルダにコピーします
  　w32tex\share\texmf-local\tex\latex
  
  

• DoxygenでLatexを生成

• Doxygen設定ファイルに下記変更を行います
  GENERATE_LATEX         = YES
  LATEX_CMD_NAME         = "platex --kanji=utf8"
  MAKEINDEX_CMD_NAME     = jmakeindex
  PDF_HYPERLINKS         = NO
  USE_PDFLATEX           = YES
• Doxygenを実行
  

• PDFを生成
  • 生成されたMakefileに下記変更を行います
    pdflatexをpdfplatex.batに変更
    delをrm -rfに変更
  • Cygwinからmakeを実行
    実行完了後、refman.pdfが生成されます。
    

 

• PDFバージョン(2012/01/11追記)
  Graphviz2.26.3からGraphviz2.28にアップデートしたら、生成されたPDFの中からClass Graphが消えました。下記警告が表示されます
  ** WARNING ** PDF version of input file more recent than in output file.
  ** WARNING ** Use "-V" switch to change output PDF version.
  
  どうもGraphvizが生成したClass GraphのPDFバージョンが変わった
  　Graphviz 2.26.3　⇒　1.4
  　Graphviz 2.28　　⇒　1.5
  
  対処方法は下記２種類
  a. Graphviz2.26.3に戻す
  b. pdfplatex.batにあるdvipdfmxコマンドに「-V 5」パラメータを追加

 

以上