日期:2014-05-16  浏览次数:20315 次

有什么好的文档生成工具没???
今天用了YUIDOC来自动生成帮助文件,感觉还不错,下载安装了,随便拿了一个以前写的JS文件测试了下,
只要写代码的时候养成写注释的习惯就什么不用管了.感觉生成的文件很专业,显示和YUI3 API 帮助文档一样

,生成的文件有一点不好就是还是会引用到YUI服务器上的一些脚本...
为了要让生成的文件断网也能看,花了一天的时间,修改default theme的JS脚本文件,把所有要引用到的JS全都下载好,放一个文件(这一步很简单,因为YUI服务器会将运行所需零碎JS,直接combine成一个单文件发过来,复制就好了) 
chm文件有很多限制,比如不支持ajax,json等方式从压缩好的chm内部取文件(用flash我没试过行不行),
下边是最后用官网下载的HTML Help Workshop压成chm之后的样式,在断网下打开的测试

现在感觉真简单,一个简单的cmd命令就能拿到专业的帮助文档了,

支持自动补齐查找,左上角yui logo以后再替换了

可以勾选是否显示 private 属性 方法 等 


pertty print 显示原始代码,查看单个方法源码时,window.scroll 精确到行







------解决方案--------------------
引用:
今天用了YUIDOC

JSDoc 怎么样?
------解决方案--------------------
代码都是手写,最多用一下插件,mark一下
------解决方案--------------------
楼主教下我 这个东西如何正确安装的,有没有好点的安装图解