使用apidoc生成restful-api文档:安装nodejs+npm+apidoc

前言:

swagger可以实时生成api文档,但是侵入性比较强,所以这里尝试了一下apidoc,当然都是自己瞎折腾,各位同学有啥推荐的可以评论哦。

开发环境:

windows

资源链接:

Node.js安装包下载
apidoc源码

安装步骤:

Step1:下载
下载node.js安装包:打开上面的下载连接选择一个版本,然后选择x64的msi版本(这里是windows环境),下载完成点击安装选择,安装路径,一直下一步就行了,不用特别配置。
Step2:cmd命令行安装
打开cmd,依次输入以下命令:

npm -v

显示版本号则安装成功
(前面路径不要管,这是我自己切进去弄其他东西的,直接输入上面的命令就行了)
这里写图片描述

npm install apidoc -g

这里写图片描述
好,到这里安装工作就完了。
Step3:生成doc
1)新建doc目录

cd *项目目录*
mkdir doc

命令行cd到项目文件夹上级补录,新建文件夹doc
这里写图片描述
2)生成api文档

apidoc -i springboot-mybatis/ -o doc/

这里写图片描述
3)查看生成的api文档
打开index.html

这里写图片描述

补充:注释格式

偷懒偷懒,apidoc的github项目里就有example,地址在文头已给出链接。

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值