はじめに Perl プロジェクトのソースコードに記された POD から、GNU make を使ってドキュメントを一括生成する方法を紹介します。 比較的シンプルな Makefile で実現できました。 プロジェクト構成例 プロジェクトの構成が、以下のようになっているとします。 . ├── bin │ ├── bar.pl │ └── foo.pl └── lib ├── Foo │ └── Bar.pm └── Foo.pm ドキュメント生成要件 ドキュメントは以下のルールで生成するとします。 doc/ ディレクトリ以下に、ソースコードのパスを元に1ファイルずつ生成する pod2html コマンドを使って HTML 形式で出力 Makefile Makefile をプロジェクトのルートディレクトリに配置します。 内容は以下のようにします。 .PHONY: html GENHTML = pod
![Perlプロジェクトのドキュメントをmakeで一括生成 - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/70fb44c4279e01806d7a4f1e7f9f260e966918f6/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-9f5428127621718a910c8b63951390ad.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTkxNiZoPTMzNiZ0eHQ9UGVybCVFMyU4MyU5NyVFMyU4MyVBRCVFMyU4MiVCOCVFMyU4MiVBNyVFMyU4MiVBRiVFMyU4MyU4OCVFMyU4MSVBRSVFMyU4MyU4OSVFMyU4MiVBRCVFMyU4MyVBNSVFMyU4MyVBMSVFMyU4MyVCMyVFMyU4MyU4OCVFMyU4MiU5Mm1ha2UlRTMlODElQTclRTQlQjglODAlRTYlOEIlQUMlRTclOTQlOUYlRTYlODglOTAmdHh0LWNvbG9yPSUyMzIxMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT01NiZ0eHQtY2xpcD1lbGxpcHNpcyZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZzPTcxYzg0YjJhZWZiNTE4ODczOWZiYjExNGU1ZTBmNTRh%26mark-x%3D142%26mark-y%3D112%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTYxNiZ0eHQ9JTQwa2V5LWFtYiZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTM2JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9NDgwNTVjZDBhZjY5ZDVlOGZhN2FjNTE0YzAxZDlhZTY%26blend-x%3D142%26blend-y%3D491%26blend-mode%3Dnormal%26s%3D01cea7f2d71735d8f69e0d71cb3d9f8e)