javascript - 使用 phpDocumentor 解析 Javascript 文件

Question

我最近一直在玩phpDocumentor，发现它很适合我的需要。我主要使用 PHP/HTML/JS/CSS 代码库，希望 phpDocumentor 解析我的 Javascript(也许还有 CSS)以便将它们放在一起。

我已经设法让 phpdoc 解析包含在整个代码库中的 javascript 文件 - 但是它拒绝页面级文档 block - 这导致它拒绝各种标签(见下文)。我发现通过在 JavaScript 文件的顶部添加一个 PHP 开放标记(前面有 JavaScript 注释)，我可以让它像解析 PHP 文件一样解析它。

// <?php
/**
 * phpdoc goes here
 * @package
 * @todo
 *   - Todo 1
 *   - Todo 2
 */
function javascript(goes, here) {
}

如果通过 PHP 将网络服务器设置为服务器 .js 文件，我会想到一个问题。有没有人能想到的任何其他问题？有没有更好的方法来完成这个？

谢谢

Answer 1

我认为认为没有类似的 JavaScript 工具是有点天真的假设。

有一个工具叫做 JSDoc这与 phpdoc 基本相同，但适用于 JavaScript。

---

2015 年 5 月 1 日星期五更新:-

新项目链接好像是:-

https://github.com/jsdoc3/jsdoc