JsDoc Toolkit
2011-08-14 14:27
176 查看
简介
JsDoc Toolkit 是一款辅助工具,你只需要根据约定在 JavaScript 代码中添加相应的注释,它就可以根据这些注释来自动生成API文档。对Java 熟悉的人可能会发现它和 Java 的文档自动化工具 JavaDoc 很像,没错,JsDoc Toolkit 就是基于 JavaDoc 开发的。下载地址
http://code.google.com/p/jsdoc-toolkit/目录结构
app : 存放的是js文件。包括一些实例文件和读取js和模板生成文档的js文件。conf : 提供默认的配置的文件。
java : 存放的是“rhino”这是一个脚本java写的javascript脚本引擎,用来提供js的运行环境。
templates : 存放生成文档的模板,根据不同的模板可以生成html xml等各种类型文档。
jsrun.jar,jsdebug.jar : 生成的入口调用了rhino框架和js文件
工作模式
通过一段java代码(jsrun.jar)调用rhino框架(该框架提供了一个运行javascript的环境),然后再运行javascript读取生成文档的javascript文件和模板文件生成文档。注释标签
这里的标签是指约定的注释标签,只有写了这些标签, JsDoc Toolkit 才能根据这些标签来生成正确的文档,比如在 @example 之后跟一段小的代码例子。可用标签列表:http://code.google.com/p/jsdoc-toolkit/wiki/TagReference
使用
首先切换到当前目录下,windows执行下面命令> java -jar jsrun.jar app\run.js -a -t=templates\jsdoc mycode.js
Mac OS或Linux执行西面命令
$ java -jar jsrun.jar app/run.js -a -t=templates/jsdoc mycode.js
如果成功的话,你就会看到当前文件夹里多出了一个叫做 out 的文件夹,生成的文档就在里面了!然后你就可以在浏览器中查看了。
说明:
“java -jar jsrun.jar app/run.js” :固定代码,每次运行时都必须含有的。-a 或者 –allfunctions :为全部函数生成文档,包括那些没有写注释的。
-c 或者 –conf :使用配置文件
-d= 或者 –directory=:指定生成文档的输出目录,默认是 “out”
-e= 或者 –encoding=:指定编码方式
-n 或者 –nocode :忽略所有代码,只为有 @name 标签的注释生成文档。
-o= 或者 –out= : 将日志信息输出到指定文件
-q 或者 –quiet : 不输出任何信息,包括警告。
-t= 或者 –template= :指定文档的模板,这个参数必须提供
查看帮助
$ java -jar jsrun.jar app/run.js --help
Rhino
Mozilla's Rhino JavaScript runtime engine.官网:http://www.mozilla.org/rhino/,该单词的意思是犀牛。参考文章
JSDOC学习记录JsDoc Toolkit 简介
JSDOC TOOLKIT:JAVASCRIPT文档利器
相关文章推荐
- JsDoc Toolkit:JavaScript 文档利器
- [转载 js]JsDoc Toolkit:Javascript文档利器
- 在 Notepad++ 运行 JsDoc toolkit 工具来自动生成文档
- jsdoc-toolkit文档工具使用说明
- [转载 js]JsDoc Toolkit:Javascript文档利器
- jsdoc-toolkit 安装到鼠标右键
- 利用jsdoc-toolkit生成javascript文档
- jsdoc-toolkit 简明用法
- JsDoc Toolkit:JavaScript 文档利器
- js文档生成工具: jsdoc-toolkit
- JsDoc Toolkit:JavaScript 文档利器
- JsDoc Toolkit:JavaScript 文档利器
- jsDoc注释的规范
- jquery-1.4.4-vsdoc.js Bug的解决方法
- LAB.js DOC文档
- Javascript工具 - 使用JSDoc建立JavaScript代码的文档
- [转]支持-vsdoc.js的jQuery智能提示的VS2008 SP1补丁发布
- 在ubuntu 中安装 jsdoc
- JSDoc 使用入门
- 使用jsdoc-toolkit来自动生成js api文档