phpdocumentor @example 行号

Question

我想知道如何使用它。 我正在尝试使用这个： https://www.phpdoc.org/docs/latest/references/phpdoc/tags/example.html

我是这样使用的：

/**
  * Format date/timestamp to localized format
  *
  * @example site/modules/KeyAgencyGeneral/Helper/Page.php 247 16 my description
  */

起始行有效，但行数无效，它显示为描述的一部分。

文档中说要这样使用：

@example [location] [<start-line> [<number-of-lines>] ] [<description>]

当我尝试括号时它根本不起作用，所以我不知道如何限制显示的行数。

（附带问题：是否可以在示例中启用突出显示或显示行号？）

Answer 1

在：

>php bin\phpDocumentor.phar -V
phpDocumentor version v2.8.5

效果很好:)

例如：

/**
 * configure the system
 * @example BillingCommand.php  98 3 some Date methods
 */
protected function configure()
{
...........

你得到了来自 98 的三行：

（phpDocumentor 在源文件的文件夹中找到示例）

要在示例中启用突出显示或显示行号，您必须编辑用于呈现文档的模板。复制修改一个....