2

我正在使用来自 phpdoc.org 的工具，当我有一个 PHP 文件（例如 header.inc.php），其中只有 HTML 时，我被卡住了。

<?php
    /**
    * Header content
    *
    * @author  My name
    *
    * @since 1.0.0
    */
?>
<!DOCTYPE html>
<html lang="fr" class="no-js"> 
    <head>
...

我的 phpdoc 中出现错误“在文件中找不到页面级 DocBlock...”。我用谷歌搜索了它，但我没有找到任何与我的案例有关的用户。

如何修复该错误？欢迎任何提示。

谢谢！

问候

4

2 回答 2

1

我刚刚看到这个帖子，虽然它比较旧，但我想我会加两分钱。虽然 sylouuu 将命名空间直接放在预期的页面级 DocBlock 之后是正确的，但我相信现在需要在 DocBlock 中放置“@package”标签。在处理逻辑与分层“包”时，这里有一些注意事项。这种行为基本上取决于您使用的 PHPDocumentor 版本。

来自： http: //manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_elements.pkg.html “在 phpDocumentor 版本 1.2.2 中，如果页面级 DocBlock 包含 @package 标记，则它是文件中的第一个 DocBlock 。”

在https://github.com/phpDocumentor/phpDocumentor2/issues/910可以看到，就在一个月前，没有 PHP 代码/节点的文件中的页面级 DocBlocks 问题仍在处理中。因此，正如 sylouuu 所说的添加命名空间，一旦你这样做了，你就有了一个可记录的元素，你的问题应该得到解决。此外，由于在没有节点的情况下很可能不会创建页面文档，因此这允许您的 html-only 文件创建其文档。

希望能帮助到你！dw

于 2013-08-08T01:11:07.327 回答
0

好的 anwser 发现：https ://github.com/phpDocumentor/phpDocumentor2/issues/695

TL;DR：目前，它还没有修复，只是忽略这些警告。

于 2012-12-06T09:41:19.623 回答