我最近一直在玩 phpDocumentor,发现它非常适合我的需求。我主要使用 PHP/HTML/JS/CSS 代码库,并希望 phpDocumentor 解析我的 Javascript(可能还有 CSS)以便将它们保持在一起。
我已经设法让 phpdoc 解析整个代码库中包含的 javascript 文件 - 但是它拒绝页面级 docblock - 这导致它拒绝各种标签(见下文)。我发现通过在 JavaScript 文件的顶部添加一个 PHP 打开标记(前面有一个 JavaScript 注释),我可以让它像解析 PHP 文件一样解析它。
// <?php
/**
* phpdoc goes here
* @package
* @todo
* - Todo 1
* - Todo 2
*/
function javascript(goes, here) {
}
如果通过 PHP 将网络服务器设置为服务器 .js 文件,我可以想到会出现问题。还有其他任何人可以想到的问题吗?有没有更好的方法来实现这一点?
谢谢