分享一个自己重写 swagger 的 ui 工具 swagger-bootstrap-ui
xiaoymin 2018-09-28 09:03:34 +08:00 10235 次点击这是一个创建于 2585 天前的主题，其中的信息可能已经有所发展或是发生改变。
简介
swagger-bootstrap-ui是Swagger的前端 UI 实现,目的是替换Swagger默认的 UI 实现Swagger-UI,使文档更友好一点儿....
swagger-bootstrap-ui 只是Swagger的 UI 实现,并不是替换Swagger功能,所以后端模块依然是依赖Swagger的,需要配合Swagger的注解达到效果
主要功能：
- 生成 markdown 格式的离线文档
- 可自定义全局参数
- 左右多 tab 组合
- 请求参数、响应示例 treetable 组件展示,方便展示
在线效果体验: http://swagger-bootstrap-ui.xiaominfo.com/doc.html
GitHub:https://github.com/xiaoymin/Swagger-Bootstrap-UI
开源中国： https://gitee.com/xiaoym/swagger-bootstrap-ui
两大核心功能
- 接口文档说明,效果图如下：
- 在线调试功能,效果图如下:
 | 1 thisisgpy 2018-09-28 13:51:52 +08:00  1 已在公司推广使用，很不错。 |
 | 3 wangcansun 2018-09-28 15:59:15 +08:00 赞赞赞 |
| 4 wangcansun 2018-09-28 15:59:38 +08:00 我之前使用的是 material 的 swagger ui |
| 5 wangcansun 2018-09-28 16:00:44 +08:00 |
 | 顺便推广一下我的一个在线 Swagger Doc 编辑网站： > https://run27.top/swaggerhuge 1. 支持团队私有化（本身就是设计成私有化的） 2. 支持团队协作（仿照 git 的模式，可以多人同时编辑不冲突） 3. 。。。 以前用的是国外的 swaggerhub，但是它的访问速度奇慢，翻墙后的速度也不太能接受。所以就自己写了一个。swaggerhub 的另一个问题是多人编辑不方便，会覆盖掉。最后的缺点就是收费了。 我目前只是在自己的团队内部推荐使用，并没有花力气推广。我觉得用 Swagger 写 API 可能有点小众。 |
 | 7 solooo 2018-09-28 16:50:01 +08:00 已 Star, 赞 |
 | 9 xiaoymin OP @wangcansun 可以使用这个看看：） |
 | 10 youngxhui 2018-09-29 10:12:01 +08:00 @wangcansun 这个好像无法继承到 java 里吧 |
| 11 wangcansun 2018-09-29 10:27:57 +08:00 via iPhone @youngxhui 集成还是继承？ |
| 12 youngxhui 2018-09-29 10:28:50 +08:00 via Android @wangcansun 不好意思 打错字了 是集成 |
| 13 wangcansun 2018-09-29 10:36:25 +08:00 via iPhone @youngxhui 没试过，以前用的时候是单独写了个 nodejs 服务开管理文档 |
| 14 xiaoymin OP @youngxhui 使用 springfox 的话可以直接使用，Java 开发在 pom 里面引入就可以了 demo： https://gitee.com/xiaoym/swagger-bootstrap-ui-demo 其它语言暂时还没完善 |
 | 15 xtaxcy 2018-10-04 12:29:34 +08:00 赞。适用一下。 |
 | 17 gam2046 2018-10-16 16:05:09 +08:00 |
| 19 xiaoymin OP |
| 20 gam2046 2018-10-16 17:38:44 +08:00 新的尝试了，十分好。 https://github.com/xiaoymin/Swagger-Bootstrap-UI/blob/master/README.md#L92 你这写的 1.6。所以，我以为这就是最新的了。 |
| 22 xiaoymin OP |
| 23 xiaoymin OP |
| 24 xiaoymin OP |
Select Language