使用jsdoc-toolkit实现JS API文档自动化

在前面的博文中探讨自动化工程问题时，写过基于NodeJS的，使用gulp、grunt的jsdoc插件实现文档自动化。本文探讨基于java环境的自动化实现。

一、Java安装与环境配置

关于Java的安装与环境配置，可以参考博文YUI Compressor for Sublime text2

二、jsdoc-tookit下载与使用

下载链接：jsdoc-tookit，现在地址可能被墙了，可以通过搜索其它渠道下载。下面完成后，解压到工作目录即可。

-> cmd -> 命令行窗口

-> cd到jsdoc-toolkit所在目录(我的是G:\Workspace\jsdoc-toolkit)

-> windows：java -jar jsrun.jar app\run.js -a -t=templates\jsdoc myTest/myTest.js

Linux：$ java -jar jsrun.jar app/run.js -a -t=templates/jsdoc myTest/myTest.js

-> 运行后生成out(默认)目录

-> 完成自动化API文档。

当然myTest.js文件中的注释需要符合jsDoc规范。 如果我们不想使用默认目录out，可以通过-d命令来设置。

jsdoc-toolkit相关命令参考：

转载声明：

本文标题：使用jsdoc-toolkit实现JS API文档自动化

本文链接：http://www.zuojj.com/archives/1064.html，转载请注明转自Benjamin-专注前端开发和用户体验