apiDoc部署搭建

apiDoc介绍:

目前,越来越多的项目进行前后端分离,那么就有需要比较规范的来管理API文档。而apiDoc这个API文档管理器,可以根据你项目代码的注释来进行自动生成API文档。同时支持C#、Java、JavaScript、PHP、Python等语言。

环境需要node,js

安装部署:

1.先把node-v8.7.0-linux-x64.tar.xz传到服务器上,或者直接yum

[root@backup ~]# xz -d node-v8.7.0-linux-x64.tar.xz 
[root@backup ~]# tar xf node-v8.7.0-linux-x64.tar 
[root@backup ~]# ll
total 57496
drwxrwxr-x 6 emm  emm      4096 Oct 11 20:04 node-v8.7.0-linux-x64
-rw-r--r-- 1 root root 58869760 Oct 31 16:28 node-v8.7.0-linux-x64.tar

2.安装apidoc

[root@backup local]# ln -s /usr/local/nodejs/bin/node /usr/local/bin
[root@backup local]# /usr/local/nodejs/bin/npm install apidoc -g 

3.使用apidoc

 放入你需要的文件和生成的目录(测试)

[root@backup inputfile]# ll
total 8
-rw-r--r-- 1 root root 190 Nov  1 17:21 apidoc.json
-rw-r--r-- 1 root root 169 Nov  1 17:21 test.js
[root@backup tmp]# apidoc -i inputfile/ outfile/
info: Done.
出现这样的字样表示完成默认会到doc下

转载于:https://www.cnblogs.com/so-cool/p/7767504.html

APIDOC是一个用于生成RESTful API文档的工具,它可以从代码注释中提取特定格式的内容生成文档。它支持多种开发语言,如GO、Java、C、Rust等。使用APIDOC可以方便地为后端代码编写接口文档,并且可以自动生成文档。在Node.js项目中使用APIDOC,你需要新建一个文件夹来存放生成的文档,并在项目的启动文件(如app.js)中添加相应的配置,示例代码如下:app.use('/apidoc存放的位置',express.static('apidoc存放的位置'));其中,'apidoc存放的位置'是你存放APIDOC生成的文件的路径,通过访问相应的URL地址,即可自动运行生成的API文档。<span class="em">1</span><span class="em">2</span><span class="em">3</span> #### 引用[.reference_title] - *1* [Node与apidoc的邂逅——NodeJS Restful 的API文档生成](https://blog.csdn.net/weixin_33953249/article/details/93345878)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] - *2* *3* [APIDOC- API文档生成工具——node](https://blog.csdn.net/mantou_riji/article/details/125697962)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] [ .reference_list ]
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值