前言
上一篇写了关于C#中类和方法的帮助文档生成,本篇介绍JS的文档生成。
这是JS文档生成的效果图:
一、需要用到的工具:
1、jdk,因为js的这个文档生成工具是用JAVA写的,所以需要有JAVA环境,JDK的安装和配置简单介绍如下:
下载链接在文末!
JAVA系统环境的配置:
配置环境变量:右击“我的电脑”-->"高级"-->"环境变量"
1)、在系统变量里新建JAVA_HOME变量,变量值为:C:Program FilesJavajdk1.6.0_14(根据自己的安装路径填写)
2)、新建classpath变量,变量值为:.;%JAVA_HOME%lib;%JAVA_HOME%lib ools.jar
3)、在path变量(已存在不用新建)添加变量值:%JAVA_HOME%in;%JAVA_HOME%jrein(注意变量值之间用“;”隔开)
4)、“开始”-->“运行”-->输入“javac”-->"Enter",如果能正常打印用法说明配置成功!
2、jsdoc_toolkit
使用到的工具叫jsdoc_toolkit,下载链接在文末,下载后解压即可使用。
3、js文档生成
java -jar jsrun.jar app/run.js -a -e=GB18030 -t=templates/jsdoc src/*.js
通过命令行执行上面语句,也可以在jsdoc_toolkit解压目录下将上述语句保存批处理文件,这样执行更方便。
上述语句参数说明如下:
-a 表示全部的方法
-e 表示对应的文件的编码根式 这里对应的是GB18030 默认的是utf-8
-t 表示生产doc的文档样式模板
这里的src/*.js表示在test目录下的全部javascript文件
执行完毕后将文档结果默认输出到/out/jsdoc目录下。
二、JS注释规范
注释以/**开头,以*/结束,关键字以@开头
三、工具包
链接:https://pan.baidu.com/s/1c5NnhhHAqdp40pOR5ZY84g
提取码:bkrm