読者です 読者をやめる 読者になる 読者になる

weblog of key_amb

主にIT関連の技術メモ

(メモ) Module::Build による Perl ドキュメント生成

Perl ドキュメンテーション

Module::Build を使うとプロジェクトのドキュメント生成をビルドのタスクの一部として、かんたんなコマンドで実行できます。

./Build docs # blib/ 以下にドキュメント生成
./Build html # blib/ 以下にHTML生成

Module::Build でプロジェクトの対象ファイルを一元管理できるので、pod2html を直接叩くよりは楽だと思います。

ただし、内部モジュールのリンク解決ができなかったり、見た目の調整ができなかったりと、少し凝ったことをしようとするとハードルが高くなる印象です。
# やり方あるのかもしれませんが、設定方法もよくわからない。。

また、作った HTML をどこかにホスティングしたいと思うことがありそうですが、そちらは別途行わないといけないですね。

どうもこの辺りのドキュメント生成については、JavaPython など他の言語の方がエコシステムが成熟しているような気がします。

よいやり方があれば知りたいです。

参考