Angularjs如何生成HTML代码文档

alc*_*ion 16 javascript jsdoc angularjs

有没有人在记录/构造angularjs项目方面有任何经验,所以JSDoc可以用HTML格式生成好的注释(对于你的指令,控制器,过滤器等)?目前它使用_global类生成一个文件,该文件指向具有几个函数的应用程序的命名空间,就是这样......

或者也许有更好的方法在angularjs中生成HTML版本的doc块?

PS:我使用标准的jsdoc语法来记录我的代码(@ param,@ return等)

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

谢谢!

Joh*_*ive 33

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

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


Ben*_*esh 4

编辑:请参阅下面约翰·大卫·五的回答

我的答案已经很老了,不应该再被接受。