返回信息流找了一个jsdoc toolkit但是试用了一下,感觉生成的文档很乱,例如某个方法应该属于某个对象的,但是被放到其他对象下的文档里头了.
想知道有没有好用一点的?或者有其他的建议
这是一条镜像帖。来源：北邮人论坛 / soft-design / #29991同步于 2008/9/15
该镜像源已超过 30 天没有更新，可能在源站已被删除。
SoftDesign机器人发帖
请问有好用的javascript 文档生成器吗?
Keyman
2008/9/15镜像同步8 回复
订阅后，新回复会通过你的通知中心匿名送达。
8 条回复
所有的文档生成器都是需要一定的规则的，它是扫描代码文件的文本特征生成文档，而并没有实际去运行这段代码。
对于动态语言，可以在任何地方插入对于原有类型和对象的属性，这种动态插入的特性不会被文档生成器所支持。
但是对于下面这种模式
var Namespace = new Object();
Namespace.create = function(){
}
他就不能识别出create函数来
关键还是那个问题，js要实现类，有太多种方法了。
光使用prototype的不同定义方法就有三四种。
呃，小问一下，文档不是用来标注类定义的注释的么。
你这样做，会不会jsdoc就把Namespace作为一个实例了（文本特征是new）？
【 在 ericyosho 的大作中提到: 】
: 关键还是那个问题，js要实现类，有太多种方法了。
: 光使用prototype的不同定义方法就有三四种。
: 呃，小问一下，文档不是用来标注类定义的注释的么。
: ...................
确实是把它当作实例了,难道我要重构我的代码?!
那那些很流行的库经常使用extend的话,那怎么生成自动化文档呀??
莫非他们都是自己写一个这样的工具??
想知道写一个这样的工具工作量有多大
不知道，没有用js写过大的工程。
都是页面上的一些 user friendly 的小东西。
你可以去 jsdoc 的论坛或者其他 js 库的主页里去问问。
我比较看好，裸写 doc[em17]
【 在 Keyman 的大作中提到: 】
: 确实是把它当作实例了,难道我要重构我的代码?!
: 那那些很流行的库经常使用extend的话,那怎么生成自动化文档呀??
: 莫非他们都是自己写一个这样的工具??
: ...................