转载自:http://hikejun.com/blog/?tag=jsdoc
如有侵权,敬请告知
需要备上下面三样东西,记住不要使用JSDocTookit中的js.jar,而要使用rhino中的js.jar
JSDocTookit
http://code.google.com/p/jsdoc-toolkit/
JSDocTookit Ant Task
http://code.google.com/p/jsdoc-toolkit-ant-task/
Rhino
http://www.mozilla.org/rhino/
再项目的目录下建一个docs目录,编辑Build.xml:
<taskdef name="jsdoctoolkit" classname="uk.co.darrenhurley.ant.tasks.JsDocToolkit" classpath=”${jsdoctoolkit.home}jsdoctoolkit-0.4.jar;${rhino.home}js.jar”/>
<jsdoctoolkit jsdochome="${jsdoctoolkit.home}" template=”jsdoc” outputdir=”./docs” encoding=”utf-8″>
<fileset dir="${src.dir}/js/" id="id">
<include name="*.js"/>
</fileset>
</jsdoctoolkit>
如果有中文指定输入/输出文件的编码encoding=”utf-8″
jsdoc的模板文件就是HTML+CSS,所以可以修改成你想要的样子,也可以装上第三方的模板,见http://code.google.com/p/jsdoc-toolkit/wiki/TemplateGallery
jsdoctoolkit ant task的详细属性
关于JSDoc的简单用法:
由于生成的文档页面默认是UTF-8的,所以源文件应该也是UTF-8编码的。
基中一些最常用的标签:
文件:
/**
* @fileoverview 对这个js文件介绍一下
* @author Kejun 维护人的联系方式
* @version 0.0.1 版本
*/
生成之后这段将出现在”File Index”里。
定义类:
/**
个人信息类
@class
*/
var myConfig = {
name: “Kejun”,
title: “Web Developer”,
/**
显示我的名字
@function say
*/
say: function(){
alert(”我叫” + this.name);
}
};
定义构造器:
/**
* 一个人物的基类
* @constructor
*/
function Person(name, title){
this.name = name;
this.title = title;
}
/**
@namespace myApp包括我的一些应用
*/
YAHOO.CN.myApp = {};
myConfig, Person, YAHOO.CN.myApp将会出现在“Classes”列表中。
另外常用的对Function的描述:
/**
* 显示某人的年龄
* @function
* @param {string} sName 名字
* @param {number | sring} nAge 年龄
*/
属性定义
/**
我的名字
@type string
*/
这些将出现在对应的Class/Namespace/Constructor或Global下面。
分享到:
相关推荐
ANT+协议 VS2015源文件
ant +jmeter 生成测试报告操作步骤文档,jmeter 加ant 生产漂亮的报告
Junit+ant+cobertura示例源码程序。
运动器材通信协议ANT+,压缩包内包含各种ANT+协议。各种运动器材,码表,心率带,速度踏频传感器等
ant +build.xml 文件Jenkins部署javaEE项目,助力成功自动化部署。ant +build.xml 文件Jenkins部署javaEE项目,助力成功自动化部署。ant +build.xml 文件Jenkins部署javaEE项目,助力成功自动化部署。ant +build.xml...
本文件为ANT+协议开发的S212协议栈,可用于NORDIC产品芯片的ANT+协议开发。支持NRF52系列的NORDIC芯片ANT+开发
ant+selenium+testng自动化测试方案
jmeter+ant+jenkins接口自动化测试框架,功能自动化和性能自动化均可
ant+junit的简易教程
jmter+ant+jenkins自动化测试pptjmter+ant+jenkins自动化测试pptjmter+ant+jenkins自动化测试ppt,个人总结
配置文档+build.xml+jmeter-result-detail-report_21.xsl jmeter.result.shahe.me.xsl(优化)
jmeter+ant+Jenkins搭建接口自动化测试,可以三体集成实现一键自动;
FitSDK3.00 用于ANT+协议应用。
ant+hibernate+xdoclet 快速开发持久层的例子,包含源代码,说明文档)
Jmeter+ant+Jenkins接口自动化文档 本地项目尝试,输出了文档介绍了资源下载以及安装,使用的步骤。
jmeter+ant+jenkins自动化接口集成测试完整框架以及jar包下载,以及使用教程说明。。。。。。
Jmeter+ant+Jenkins集成接口自动化测试详细说明
NULL 博文链接:https://depravedangel.iteye.com/blog/441859
简述了 如果使用 Ant+Jmeter 来进行 开发API 的功能测试,也附带扯到了 最终如何整合入hudson(jerkins) 的集成build环境中
这个是亲测,一步一步部署jmeter+ant+jenkins项目,以前从来没弄过。完全可以从0开始的。抄袭网上很多人的经验最后一步一步记录下来的