php - PhpDocumentor 2 で名前空間の代わりに @package を使用する

Question

階層的なドキュメントを生成しようとしている大規模なコードライブラリがあります。プロジェクトは名前空間を使用しませんが、代わりに @package を使用します。

phpDocumentor2 を使用して、次のファイルからテストとしてドキュメントを生成しようとしました。

<?php
/**
 * This is a file
 * @package JustAn\Example
 **/

 /**
 * Something class
 **/
 class Something{
    function try_this(){

    }
 }

ドキュメントによると、@package JustAn\Example は名前空間 JustAn\Example と同等である必要がありますが、そうではないことがわかりました。

名前空間を使用すると、結果のドキュメントは次のようになります。

名前空間のバージョン

@package 表記を使用すると、結果は次のようになります (パッケージ表記を認識しますが、これはクラスの完全な詳細ページに表示されます)。

パッケージ表記バージョン

「実際の」名前空間を使用するようにコードを書き直すことなく、階層的な結果を取得する方法を探しています。

score 4 · Accepted Answer

問題は、デフォルトの「クリーン」テンプレートがこの機能をサポートしていないことです。他のテンプレート (たとえば「レスポンシブ」など) も同様です。--template="responsive" フラグを使用して、使用されるデフォルトのテンプレートを変更できます。

score 0 · Accepted Answer

ファイルdocblockにpackageタグがありますが、クラスdocblockにはありません。クラスのdocblockに追加すると、うまくいくはずです。

2 に答える 2