egg-swagger-doc-fixbug
Version:
94 lines (69 loc) • 2.59 kB
Markdown
<!--
* @Descripttion:
* @Author: fanfuda
* @Date: 2022-08-30 22:54:46
* @LastEditors: fanfuda
* @LastEditTime: 2022-08-30 22:56:11
-->
# egg-swagger-doc
[![NPM version][npm-image]][npm-url]
[![build status][travis-image]][travis-url]
[![Test coverage][codecov-image]][codecov-url]
[![David deps][david-image]][david-url]
[![Known Vulnerabilities][snyk-image]][snyk-url]
[![npm download][download-image]][download-url]
[npm-image]: https://img.shields.io/npm/v/egg-swagger-doc.svg?style=flat-square
[npm-url]: https://npmjs.org/package/egg-swagger-doc
[travis-image]: https://img.shields.io/travis/eggjs/egg-swagger-doc.svg?style=flat-square
[travis-url]: https://travis-ci.org/eggjs/egg-swagger-doc
[codecov-image]: https://img.shields.io/codecov/c/github/eggjs/egg-swagger-doc.svg?style=flat-square
[codecov-url]: https://codecov.io/github/eggjs/egg-swagger-doc?branch=master
[david-image]: https://img.shields.io/david/eggjs/egg-swagger-doc.svg?style=flat-square
[david-url]: https://david-dm.org/eggjs/egg-swagger-doc
[snyk-image]: https://snyk.io/test/npm/egg-swagger-doc/badge.svg?style=flat-square
[snyk-url]: https://snyk.io/test/npm/egg-swagger-doc
[download-image]: https://img.shields.io/npm/dm/egg-swagger-doc.svg?style=flat-square
[download-url]: https://npmjs.org/package/egg-swagger-doc
这是一个关于swagger的测试版本
## 依赖说明
### 依赖的 egg 版本
egg-swagger-doc 版本 | egg 1.x
--- | ---
1.x | 😁
0.x | ❌
### 依赖的插件
<!--
如果有依赖其它插件,请在这里特别说明。如
- security
- multipart
-->
## 开启插件
```js
// config/plugin.js
exports.swaggerdoc = {
enable: true,
package: 'egg-swagger-doc',
};
```
## 使用场景
- Why and What: 描述为什么会有这个插件,它主要在完成一件什么事情。
尽可能描述详细。
- How: 描述这个插件是怎样使用的,具体的示例代码,甚至提供一个完整的示例,并给出链接。
## 新增功能
```js
1、增加基础路径配置: baseUrl: '/driver/', //基础路径 默认为:'/''
// 例如 域名地址为:http://127.0.0.1:7001/driver/swagger-ui.html
// baseUrl需要配置为'/driver/',
exports.swaggerdoc = {
baseUrl: '/driver/',
....
}
```
## 详细配置
请到 [config/config.default.js](config/config.default.js) 查看详细配置项说明。
## 单元测试
<!-- 描述如何在单元测试中使用此插件,例如 schedule 如何触发。无则省略。-->
## 提问交流
请到 [egg issues](https://github.com/eggjs/egg/issues) 异步交流。
## License
[MIT](LICENSE)