(メモ) Module::Build による Perl ドキュメント生成
Module::Build
を使うとプロジェクトのドキュメント生成をビルドのタスクの一部として、かんたんなコマンドで実行できます。
./Build docs # blib/ 以下にドキュメント生成 ./Build html # blib/ 以下にHTML生成
Module::Build
でプロジェクトの対象ファイルを一元管理できるので、pod2html を直接叩くよりは楽だと思います。
ただし、内部モジュールのリンク解決ができなかったり、見た目の調整ができなかったりと、少し凝ったことをしようとするとハードルが高くなる印象です。
# やり方あるのかもしれませんが、設定方法もよくわからない。。
また、作った HTML をどこかにホスティングしたいと思うことがありそうですが、そちらは別途行わないといけないですね。
どうもこの辺りのドキュメント生成については、Java や Python など他の言語の方がエコシステムが成熟しているような気がします。
よいやり方があれば知りたいです。