apidoc

 

 apidoc.js 是web api 文档生成器,官网:http://apidocjs.com/

安装和使用:

1、安装:

官方文档上只有一个命令:npm install apidoc -g ,当然,这个是没法直接执行的。

首选理解 npm 是什么?

npm是一个node包管理和分发工具,已经成为了非官方的发布node模块(包)的标准。有了npm,可以很快的找到特定服务要使用的包,进行下载、安装以及管理已经安装的包。

所以:

首先安装node.js,具体安装步骤参照:http://www.cnblogs.com/linjiqin/p/3765390.html

新版nodejs已经集成了npm,所以之前npm也一并安装好

其次:安装apidoc,这是再执行npm install apidoc -g 就可以

安装过程中如果出现error:npm err registry error parsing json

解决办法:

镜像使用方法(三种办法任意一种都能解决问题,建议使用第三种,将配置写死,下次用的时候配置还在):

  • 1.通过config命令
npm config set registry https://registry.npm.taobao.org 
npm info underscore (如果上面配置正确这个命令会有字符串response)
  • 2.命令行指定
npm --registry https://registry.npm.taobao.org info underscore 
  • 3.编辑 ~/.npmrc 加入下面内容
registry = https://registry.npm.taobao.org

搜索镜像: https://npm.taobao.org

 

建立或使用镜像,参考: https://github.com/cnpm/cnpmjs.org

 

安装成功,使用命令 apidoc -v 可检查当前安装是否成功及对应版本号

 2、apidoc的使用

1)cmd,然后转到D盘,D:

2)转到代码目录

cd D:\workspace\test\src\main\java\com\test

3)执行脚本

   apidoc -i web/ -o web/api/

 

 

猜你喜欢

转载自luna-2006.iteye.com/blog/2240368
今日推荐