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，但我发现情况并非如此。

当我使用 namespace 时，生成的文档如下所示:

当我使用@package 表示法时，结果如下所示(即使它识别包表示法 - 这显示在类的完整详细信息页面上):

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

Answer 1

问题是默认的“干净”模板不支持此功能。其他模板(例如“响应式”)也可以。您可以使用 --template="responsive"标志来更改使用的默认模板。