grunt-dox 生成只有标题的 html 文件

Question

我正在使用 grunt-dox grunt plugin 从包含 JsDoc 停靠块的 JavaScript 文件中生成 docco 文档。

当我运行 grunt 任务时，我得到的只是一个带有我指定的标题的 HTML 文件。安装 grunt-dox 或运行任务没有错误。

我使用的是 Mac OS X 10.8.3，但我有一种强烈的感觉，这不是它无法正常工作的原因。

这里有一些相关文件供参考：

• Gruntfile.js
• project.json dependancies
• index.html generated by dox - 请忽略多余空格的格式
• JavaScript file I'm trying to document

我做错了吗？有没有人让这个工作？顺便说一句，我正在运行grunt test，其中包含 dox 任务。

非常感谢您的帮助，因为我已经坚持了两天并准备放弃。

更新：我尝试运行 dox --title POC public/javascripts/build/docs/docs.js > public/docs/index.html，但它永远挂起。

咕噜。

Answer 1

我会将此标记为答案，即使我从未发现它为什么不起作用。

如果其他人没有成功地走这条路，我强烈建议看看what I eventually had to do to get decent API documentation for my javascript / node.js app

基本上我选择了node-jsdoc-toolkit，一个shell 脚本和grunt-shell。

希望这对某人有所帮助！