js doc 工具推荐及使用(二):ext-doc版权所有,转载请注明来源http://gogo1217.iteye.com,违者必究!????? 之
js doc 工具推荐及使用(二):ext-doc
版权所有,转载请注明来源http://gogo1217.iteye.com,违者必究!
?
???? 之前在整理公司框架的时候,曾经为javascript写过一些注释,但没有合适的工具来生成doc文件。后来功过google以及自己试用,发现jsdoc-toolkit和ext-doc2个工具比较有意思。
jsdoc-toolkit详见:js doc 工具推荐及使用(一):jsdoc-toolkit
?
ext-doc
?
官方地址为:http://code.google.com/p/ext-doc/
1.下载解压后,目录如下图所示:

其中sample是自带的示例,ext.xml是配置文件,ext-doc.bat是java命令调用;template是doc模板.
?
2.在sample下新建extdoc-demo.js,代码如下:
??
4.运行sample/ext-doc.bat。在output中生成了相关的doc文档。在web中运行index.html。效果如下:
?
?
注意:截至到ext-doc-1.0.131版本还不能自定义的js的编码,通过查看源码,只能使用系统默认编码,即在windows下需要将js文件的编码设置为gbK,但到发稿时,在svn上发现已经有相关修改,但是svn还是缺少几个文件不能正常编译。
需在web环境中才能正常查看doc。
?
本文中的实例工程打包下载:
http://dl.iteye.com/topics/download/7b8f74f5-28b6-37bf-a3b7-bd8bb6a00bf4
?

