0

当我使用phpDocumentor生成 API 文档时,页面Reports -> Markers总是说No marker has found in this project尽管我的 PHP 代码中有几个TODO标记。

我有 phpDocumentor v3.0.0。我运行它:php phpDocumentor.phar --markers

我的phpdoc.dist.xml文件包含:

<?xml version="1.0" encoding="UTF-8" ?>
<phpdocumentor
  configVersion="3"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns="https://www.phpdoc.org"
  xsi:noNamespaceSchemaLocation="https://docs.phpdoc.org/latest/phpdoc.xsd"> 
  <paths>
    <output>apidocs/docs</output>
    <cache>apidocs/cache</cache>
  </paths>
  <version number="3.0.0">
    <api>
      <source dsn=".">
        <path>src</path>
        <path>*.php</path>
      </source>
      <markers>
        <marker>TODO</marker>
      </markers>
    </api>
  </version>
</phpdocumentor>

我在我的 PHP 代码中使用 TODO 标记,如下所示:

/**
 * TODO marker 1
 */
function someFunction(...) {
  // ...
}


function anotherFunction(...) {
  // TODO marker 2
  // ...
}
4

0 回答 0