- 浏览: 1615891 次
- 性别:
- 来自: 长春
文章分类
- 全部博客 (309)
- ext (19)
- web (13)
- PHP (19)
- 互联网新闻 (3)
- oracle (3)
- Mootools (1)
- FLEX (3)
- 人在职场 (2)
- hibernate (24)
- spring2 (1)
- J2SE (24)
- WEB_UI (14)
- 其它 (11)
- Log4J (1)
- iText (10)
- SQL (11)
- 设计模式 (3)
- lucene (6)
- 开源项目 (2)
- javascript (20)
- 软件&破解补丁 (48)
- Quartz (2)
- 解决方案 (1)
- 工作存档 (2)
- JAVA对文件操作 (2)
- C&C#&VC (1)
- struts2 (3)
- 版本控制 (2)
- 软考基础 (23)
- JBPM (2)
- velocity (4)
- javamail (3)
- HttpClient (9)
- 虚拟化技术 (2)
- 报表 (3)
- ibatis (5)
- Spring (4)
- 信用卡 (0)
- 芒果钱包 (0)
- 养卡 (0)
最新评论
-
a601962168:
...
通过JAVA与串口(RS232)通信实例 -
olive009:
...
Adobe Acrobat 9 Pro & Pro Extended 中文版/英文版 下载及破解补丁 -
overshit:
api更新了,一加filter就Callback filter ...
深入浅出CGlib-打造无入侵的类代理 -
u010778233:
写得很不错,已经用起来了,谢谢
将jdbc结果集转换成对象列表 -
924060929:
我想找就是要这个功能!!!!!!!!
velocity基础教程--2自定义ResourceLoader实现字符模板
如果大家对JEE的深入研究有兴趣
可以加入Q群:46176507 共同进步学习
JsDoc:是js文档生成工具,它从javascript程序源代码中抽取类、方法、成员等注释信息形成一个和源代码配套的API帮助文档。
Java开源项目http://www.jsdoctoolkit.org/,它是一个功能强大的javascript文档生成工具。
下面我们来结束一下如何使用。
我们通过下载工具类库。
这里我们使用的是jsdoc_toolkit-2.1.0.zip也是当前的最高版本。
我们将这个文件解压。可以看到里面README.txt文件。
这里有详细的使用说明。【好像介绍到这里就可以了。当然你也可以继续读下】
这里我们需要通过命令行进行创建javascript文档。
java -jar jsrun.jar app/run.js -a -e=GB18030 -t=templates/jsdoc test/*.js
当然如果感觉通过命令行的方式比较麻烦,我们可以自行创建一个.bat文件
将上面的内容复制到该文件中,执行即可。
下面我来简单解释一下这其中的参数
-a 表示全部的方法
-e 表示对应的文件的编码根式 这里对应的是GB18030 默认的是utf-8
-t 表示生产doc的文档样式模板
这里的test/*.js表示在test目录下的全部javascript文件
执行完毕后将文档结果默认输出到/out/jsdoc目录下。当然这个目录也是可以定义的
具体参数可以使用
java -jar jsrun.jar app/run.js --help
进行查看。
结果如下:
下面我们来创建test下的js文件
简单的方法标注
myjs.js
类的方法标注
myjs2.js
现在我们可以运行java -jar jsrun.jar app/run.js -a -e=GB18030 -t=templates/jsdoc test/*.js
至此我们的js文档生成完毕。我们也无需羡慕JavaDoc了。
我们只是列出了常用的标签,至于更多的可以登陆到官方网站查看
http://code.google.com/p/jsdoc-toolkit/wiki/TagReference
可以加入Q群:46176507 共同进步学习
JsDoc:是js文档生成工具,它从javascript程序源代码中抽取类、方法、成员等注释信息形成一个和源代码配套的API帮助文档。
Java开源项目http://www.jsdoctoolkit.org/,它是一个功能强大的javascript文档生成工具。
下面我们来结束一下如何使用。
我们通过下载工具类库。
这里我们使用的是jsdoc_toolkit-2.1.0.zip也是当前的最高版本。
我们将这个文件解压。可以看到里面README.txt文件。
这里有详细的使用说明。【好像介绍到这里就可以了。当然你也可以继续读下】
这里我们需要通过命令行进行创建javascript文档。
java -jar jsrun.jar app/run.js -a -e=GB18030 -t=templates/jsdoc test/*.js
当然如果感觉通过命令行的方式比较麻烦,我们可以自行创建一个.bat文件
将上面的内容复制到该文件中,执行即可。
下面我来简单解释一下这其中的参数
-a 表示全部的方法
-e 表示对应的文件的编码根式 这里对应的是GB18030 默认的是utf-8
-t 表示生产doc的文档样式模板
这里的test/*.js表示在test目录下的全部javascript文件
执行完毕后将文档结果默认输出到/out/jsdoc目录下。当然这个目录也是可以定义的
具体参数可以使用
java -jar jsrun.jar app/run.js --help
进行查看。
结果如下:
OPTIONS: -a or --allfunctions Include all functions, even undocumented ones. -c or --conf Load a configuration file. -d=<PATH> or --directory=<PATH> Output to this directory (defaults to "out"). -D="myVar:My value" or --define="myVar:My value" Multiple. Define a variable, available in JsDoc as JSDOC.opt.D.myVar. -e=<ENCODING> or --encoding=<ENCODING> Use this encoding to read and write files. -E="REGEX" or --exclude="REGEX" Multiple. Exclude files based on the supplied regex. -h or --help Show this message and exit. -n or --nocode Ignore all code, only document comments with @name tags. -o=<PATH> or --out=<PATH> Print log messages to a file (defaults to stdout). -p or --private Include symbols tagged as private, underscored and inner symbols. -q or --quiet Do not output any messages, not even warnings.
下面我们来创建test下的js文件
简单的方法标注
myjs.js
/** * @fileOverview 简单的方法标注示例 * @author <a href="llying.iteye.com">llying</a> * @version 0.1 */ /** * @description 加法运算 * @param {Num} num1 加数 * @param {Num} num2 被加数 * @return {Num} result 结果 */ function add(num1,num2){ return num1 + num2; } /** * @description 减法运算 * @param {Num} num1 减数 * @param {Num} num2 被减数 * @return {Num} result 结果 */ function minus(num1,num2){ return num1 - num2; }
类的方法标注
myjs2.js
/** * @fileOverview 简单的类对象标注示例 * @author <a href="llying.iteye.com">llying</a> * @version 0.1 */ /** * @author llying * @constructor Person * @description 一个Person类 * @see The <a href="#">llying</a >. * @example new Parent(“张三”,15); * @since version 0.1 * @param {String} username 姓名 * @param {Num} age 年龄 */ function Person(username,age) { /** * @description {Sting} 姓名 * @field */ this.username = username; /** * @description {Num} 年龄 * @field */ this.age = age /** * @description 弹出say内容 * @param {String} content 内容 */ this.say = function(content) { alert(this.username+" say :"+content); } /** * @description 返回json格式的对象 * @return {String} json格式 * @see Person#say */ this.getJson = function(){ return "{name:"+this.username+",age"+this.age+"}"; } }
现在我们可以运行java -jar jsrun.jar app/run.js -a -e=GB18030 -t=templates/jsdoc test/*.js
至此我们的js文档生成完毕。我们也无需羡慕JavaDoc了。
我们只是列出了常用的标签,至于更多的可以登陆到官方网站查看
http://code.google.com/p/jsdoc-toolkit/wiki/TagReference
发表评论
-
dhtmlxGrid的数据集添加查找定位功能
2009-06-25 13:52 2871dhtmlxGrid添加查找定位功能 dhtmlxGrid是一 ... -
js幻灯片效果
2009-06-19 13:33 2601很大气的~! -
通过js修改注册表
2009-04-16 08:49 1999var WSS = new ActiveXObjec ... -
JTree
2009-01-04 13:08 1771JTree 更新日期:2005/12/9 更新功能:使之在o ... -
层收缩效果带滑动
2008-12-31 12:56 1424<!DOCTYPE HTML PUBLIC &quo ... -
自定义的复选按钮组和单选按钮组
2008-12-09 08:56 6024FancyForm的例子 不过经过修改使其支持ie,采用的是m ... -
拥抱JsUnit
2008-10-27 16:02 7548拥抱JsUnit 以往在测试js的时候,都是以alert方式来 ... -
jquery的suggest
2008-10-14 06:59 5147import javax.servlet.http.Htt ... -
jquery模拟股票信息实时显示
2008-10-14 06:55 4856import javax.servlet.http.Htt ... -
jquery可编辑table
2008-10-14 06:51 10280<!DOCTYPE HTML PUBLIC &quo ... -
jquery的弹出菜单menu
2008-10-14 06:49 7172<!DOCTYPE HTML PUBLIC &quo ... -
jsoo编程实例之模拟弹出窗口
2008-10-09 16:10 1326<!DOCTYPE HTML PUBLIC &quo ... -
jquery模拟的弹出窗口
2008-10-08 20:40 7162<!DOCTYPE HTML PUBLIC &quo ... -
ajax的请求处理
2008-10-08 07:00 2395//用户名效验的方法 ... -
jquery解决浏览器缓存和中文处理(通用ajax)
2008-10-07 20:35 3138function verify(){ //解决中 ... -
jsoo编程实例之确认按钮的选择下拉框
2008-10-07 11:20 1431<!DOCTYPE HTML PUBLIC &quo ... -
jsoo编程实例之单行文本框
2008-10-07 09:03 1466<!DOCTYPE HTML PUBLIC &quo ... -
JavaScript的OO编程--1.js的特性
2008-09-23 15:56 1785JavaScript的OO编程--1.js的特性 至于java ... -
JavaScript高级程序设计
2008-09-18 16:28 2775JavaScript高级程序设计 非常好的一本书 尤其是js的 ...
相关推荐
前端开源库-jsdoc-webpack-pluginjsdoc webpack插件,jsdoc webpack插件
前端开源库-jsdoc-xjsdoc-x,解析器,用于通过jsdoc的explain(-x)命令从文档代码中输出定制的javascript对象。
前端开源库-jsdoc-oblivionjsdoc oblivion,是jsdoc的灰色和蓝色主题。
前端开源库-vigour-jsdoc2mdvigur-jsdoc2md,将jsdoc注释块转换为markdown
前端开源库-ljve-jsdoc-templateljve jsdoc模板,jsdoc 3的ljve.io模板来自jaguar.js
前端开源库-jsdoc-strip-async-awaitjsdoc strip async wait,jsdoc plugin to strip async/wait keywords before parse.
前端开源库-jsdoc-regexjsdoc regex,用于匹配jsdoc注释块的正则表达式及其下面的代码。
前端开源库-ui5-jsdoc-generatorui5 jsdoc生成器,为在ui5 edit中完成的控件库创建自动文档
前端开源库-grunt-jsdoc-to-markdowngrunt jsdoc to markdown,markdown api文档生成器,适合Github项目
前端开源库-jsdoc-babeljsdoc babel,一个jsdoc插件,在处理ES6源文件之前用babel转换它们。
前端开源库-jsdoc-md.zip
前端开源库-jsdoc-mdjsdoc md,一种用于分析源jsdoc并在标记文件(如readme.md)的给定标题下生成文档的CLI。
前端开源库-ljve-jsdocljve jsdoc,一个支持ljve.io的Javascript API文档生成器。
前端开源库-thought-plugin-jsdoc思想插件jsdoc,将jsdoc添加到思想生成的readme.md中
flow-jsdoc, 使用JSDoc表示流量注释 流 jsdoc 这是一个将转换为标准的流类型注释的工具。 这意味着:你只需要记录你的类型一次: in 。无需使用 transpiler插件,就可以获得流的好处,而不必使用的ugly语法 。对于...
Atom-atom-3en-jsdoc.zip,用于Atom的JSdoc插件,3en用于所有Suitescript项目Atom 3en JSdoc包,atom是一个用web技术构建的开源文本编辑器。
Atom-atom-easy-jsdoc.zip,atom编辑器的jsdoc热键。Atom Easy JSdoc包,atom是一个用web技术构建的开源文本编辑器。
swagger-jsdoc, 在JSDoc上生成 swagger doc swagger记录代码并保持实时和可以重用的OpenAPI ( Swagger ) 规范。 这里规范可以是你的api驱动项目的核心: generate,服务器,客户,测试,以及更多的基于丰富的OpenAPI...
前端开源库-grunt-typescriptgrunt typescript,将typescript编译为javascript
前端开源库-vigour-ua活力UA,轻量级UA解析器