phpdocumenterでソースコードからドキュメント自動生成をしたときに起きた問題。
https://github.com/phpDocumentor/phpDocumentor2
# ドキュメント生成コマンド $ phpdoc run -d <SOURCE_DIRECTORY> -t <TARGET_DIRECTORY> --template=responsive-twig
すると、TARGET_DIRECTORY/packages配下にdefault.html と Default.htmlが出力される。
$ ls TARGET_DIRECTORY/packages default.html Default.html
これをwindows環境で展開すると問題となる。 windows環境だと、どうやら大文字・小文字をファイル名としては区別しないようだ。なんてポンコツなんだ…
helpを読む。
$ phpdoc run -h ... --defaultpackagename[=DEFAULTPACKAGENAME] Name to use for the default package. [default: "Default"] ...
–defaultpackagename=XX オプションを指定するとDefault.htmlのファイル名を変更できる様子。
$ phpdoc run -d <SOURCE_DIRECTORY> -t <TARGET_DIRECTORY> --template=responsive-twig --defaultpackagename=foo
$ ls TARGET_DIRECTORY/packages default.html foo.html
うむ。