netail.net

_ [ツール] javadoc から HTMLHelp を作る ▲

javadoc をHTMLHelpにできないかなーと思って探していたら，世の中にはちゃんとあるようで．jd2chmと，Javadoc2Helpという２つのプロジェクトを発見．

jd2chm のほうは python で書かれているものの，実行ファイルも提供されていて，exe を適当な場所に置いて，コマンドプロンプトで javadoc のディレクトリに移動してから exe を実行するだけでOK．HTML Help のファイル名とかを対話的に聞かれるので，答えたら HTML Help が生成される．ちゃんとメソッド名などをキーワードとして抽出しておいてくれるのが嬉しい．ただ，poderosa 上で cygwin から動かすと対話インタフェースのメッセージが表示されなかったりしたので，その辺は使うときに注意が必要．

一方の javadoc2help は，Javaで作られているツール．パッケージを展開後，bin/javadoc2help.propertiesファイルにHTML Help のコンパイラのパスを指定すれば利用可能（Microsoft が提供しているヘルプコンパイラをインストールしておく必要はある）．引数には，javadocの置いてあるディレクトリと，それを出力する先のディレクトリ（javadoc のファイル群がコピーされたりプロジェクトファイルが生成されたりする）を指定する．

 java -jar lib/Javadoc2Help.jar -chm 
 -src ../soot/tools/soot-2.2.3/doc/ 
 -dest /tmp/soot-help/

こちらは，キーワード生成なんかはやってくれないので，けっこう簡素な HTML Help が出力される．そのかわり，プロジェクトファイルをちゃんと生成してくれるので，自前でキーワード生成したり，結果を改変したい場合には便利かもしれない．まあ，今回はjd2chmのほうを使わせてもらうことにした．