一个Google code上的一个开源项目，可以自动从Javascript代码中提取注释生成格式化文档。

1. JSDoc-Tookit入门 常胤（lzlu.com）

2. 三招让你能轻松拥有一份炫酷文档 Jsdoc_toolkit 简单的约定 良好的代码注释习惯

3. JsDoc Toolkit 自动化文档工具 一个Google code上的一个开源项目，可以自动从Javascript代码中提取注释生成格式化文档。 项目地址： http://code.google.com/p/jsdoc-toolkit/ 运行环境 - WindowXP java version "1.6.0_03" Java(TM) SE Runtime Environment (build 1.6.0_03-b05) - Mac OS X 10.5 java version "1.5.0_19" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_19-b02-304)

4. 如何安装 安装JDK 设置环境变量 解压jsdoc_toolkit

5. 如何使用 – 命令参数 命令参数列表： http://code.google.com/p/jsdoc-toolkit/wiki/CommandlineOptions 常用命令介绍： -a ：为所有的函数都生成文档 -t：模版路径 -d：指定生成文档的路径，默认是当前目录下的out目录 - r：=<DEPTH> 设置遍历文件夹的深度 -e：设置读写文件的编码 -h ：帮助 ② ① C:oolssdoc-toolkit> java -jar jsrun.jar app/run.js -t=templates/jsdoc -d=my_docs myscripts/*.js -t=templates/jsdoc

6. 如何使用 – bat

7. 如何使用 –注释规范

8. 如何使用 – 示例一

9. 如何使用 – 示例二

10. 如何使用 – 文档模版 :: -t=<PATH> or --template=<PATH> :: Required. Use this template to format the output. :: 设置模版路径 set t=templates/jsdoc java -jar jsrun.jar app/run.js -t=%t% -p /myscripts/

11. Q&A