jsduck 5.3 创建 PHP-Doc
jsduck 5.3 create PHP-Doc
今天我在我的 ExtJS 项目中试用了 jsDuck 5.3。它真的很好用。但我也在 PHP 中评论了每个方法和 class。
我已经看到 JSDuck 3.11.2 可以从 PHP 文件创建一个完美的在线文档,但 JSDuck 5.3 没有。是否可以将模块或插件加载到 JSDuck 5.3?或者是否有其他做法可以通过 jsDuck 5.3 获得 php-doc?
它 3.x 碰巧与 PHP 一起工作的原因是 JSDuck 使用了一堆简单的正则表达式来解析文档注释后的代码,如果它遇到了它没有遇到的代码明白了,它只是忽略了它。所以你能够解析 PHP 的原因是执行不力的意外。
新的 JSDuck 使用实际的 JavaScript 解析器,当您尝试向它提供 JavaScript 以外的内容时它会失败。
使它与 PHP 一起工作的一种骇人听闻的方法是在您的 PHP 代码上使用一些预处理器,它会剥离所有代码并只留下文档注释 - 此代码将然后是有效的 JavaScipt,JSDuck 会解析它。
另一种选择是打开 JSDuck 的内部结构并向其添加 PHP 解析器。
今天我在我的 ExtJS 项目中试用了 jsDuck 5.3。它真的很好用。但我也在 PHP 中评论了每个方法和 class。 我已经看到 JSDuck 3.11.2 可以从 PHP 文件创建一个完美的在线文档,但 JSDuck 5.3 没有。是否可以将模块或插件加载到 JSDuck 5.3?或者是否有其他做法可以通过 jsDuck 5.3 获得 php-doc?
它 3.x 碰巧与 PHP 一起工作的原因是 JSDuck 使用了一堆简单的正则表达式来解析文档注释后的代码,如果它遇到了它没有遇到的代码明白了,它只是忽略了它。所以你能够解析 PHP 的原因是执行不力的意外。
新的 JSDuck 使用实际的 JavaScript 解析器,当您尝试向它提供 JavaScript 以外的内容时它会失败。
使它与 PHP 一起工作的一种骇人听闻的方法是在您的 PHP 代码上使用一些预处理器,它会剥离所有代码并只留下文档注释 - 此代码将然后是有效的 JavaScipt,JSDuck 会解析它。
另一种选择是打开 JSDuck 的内部结构并向其添加 PHP 解析器。