Angularjs 如何生成 HTML 代码文档答案

【问题标题】：Angularjs How to generate HTML code DocumentationAngularjs 如何生成 HTML 代码文档
【发布时间】：2012-10-02 05:57:25
【问题描述】：

有没有人在记录/构建 angularjs 项目方面有任何经验，以便 JSDoc 可以以 HTML 格式生成漂亮的 cmets（用于您的指令、控制器、过滤器等）？目前，它会生成一个带有 _global 类的文件，该类指向我的应用程序的命名空间，其中包含几个函数，就是这样......

或者也许有更好的方法在 angularjs 中生成 html 版本的文档块？

PS：我正在使用标准的 jsdoc 语法来记录我的代码（@param、@return 等）

更新：我的具体问题是：有没有办法为 angularjs 文档块生成 html 文档以涵盖所有控制器/指令/过滤器等？当运行 JSDoc 命令行实用程序时，它只覆盖了 HTML 报告中我的代码的大约 5%...

谢谢！

【问题讨论】：

有具体问题吗？
作为一个问题可以吗（请参阅更新的内容和主题）？我花了很多时间来记录我的程序，而 JSDoc 命令行实用程序的 html 输出非常糟糕，甚至没有覆盖我应用程序的 5%...

【解决方案1】：

编辑：见下面的John David Five's answer

我的回答太老了，不应该再被接受了。

【讨论】：

【解决方案2】：

我一直在开发一个使用 AngularJS 文档生成代码的 grunt 插件。它遵循它们的语法和输出。 grunt-docular。该链接显示了文档源以及原始 AngularJS 源的文档生成。它是可配置和可扩展的。

转到grunt-docular 并找到安装链接以获取创建您自己的文档的示例

【讨论】：

这是一个更好的答案。如果可以的话，我会删除我的，但我不能，因为它已被接受。
项目的主网站不见了。
@AaronHarun 无论如何，我的公司已经介入，我们现在正在赞助文档项目。该网站应该会在接下来的几天内备份，并且会有一个公司维护人员和一群渴望做出贡献的人。
@Stephen 我一直在尝试启动并运行文档作为 ngdocs 的替代方案，但我正在努力让它发挥作用。我们正在使用 yaml 来配置 grunt。这会引起问题吗？
@zpydee 不确定。请在问题列表（github.com/Vertafore/docular/issues）上留言部分配置详情，我今天就来看看。

【解决方案3】：

构建步骤：

文档将在build/docs 文件夹中提供。如果你有 PHP 5.5，你可以查看它：

【讨论】：