在PhpDocumentor 2中使用@package而不是命名空间

Question

我有一个大型的代码库，我正试图为它生成层次化文档。该项目不使用名称空间，而是使用@package。

我刚刚尝试用phpDocumentor2从以下文件生成文档作为测试：

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

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

    }
 }

虽然根据docs @package \示例应该等同于名称空间JustAn\示例，但我发现情况并非如此。

当我使用名称空间时，生成的文档如下所示：

​

​

当我使用@package表示法时，结果看起来如下所示(尽管它识别包表示法-它显示在类的完整详细信息页上)：

​

​

我正在寻找一种获得分层结果的方法，而不必重写代码来使用“真实”名称空间。

Answer 1

问题是默认的“干净”模板不支持此特性。其他模板(例如，“响应”)会这样做。您可以使用-- template ="responsive“标志来更改使用的默认模板。

Answer 2

我看到文件docblock中有package标记，但没有类docblock。如果你把它添加到你的类文档块中，我认为它应该能工作。