swagger接口太多,导致导出word或者odf文档太大问题

问题描述:近期遇到需要导出swagger文档,swagger文档到手,发现只有3mb多点的json文件,然而通过在线网址导出后,文档字数过多,页数超过了最大限制,打不开

解决方法:

导出swagger文件,这个请根据项目情况自行百度添加相关依赖导出

以下提供一套我使用的曲线导出的方法

1.使用apiox软件导入swagger,软件可以直接网上下载,用法和postman一样

2,根据自己有的数据导入,我这里时用的swagger的json文件导入

3.进入导进去的项目,点击这里导出

4.这个软件现在不支持转word和pdf,所以需要曲线操作一下,需要先转md文件,再通过md文件转word或者pdf

另外,如果需要导出的接口非常多,我建议使用我下面的方式进行分开导出,建议一百个接口分一个md文件,因为md文件有字数限制,超过字数上限就会报错(和文件大小没关系)

注:如果少量导出过后md文档还是超字数了,解决方法为用笔记本打开,手动复制粘贴分成多个文件(我也想偷懒,试过其他办法,么得卵用)

5.通过上述步骤,我们获得一堆md文档(命名不要学我,我后面改了),打开md文件,然后导出pdf文件,如果只需要pdf文件,到这步就结束了

6.导出word文件

通过md文件导出word文档,md会让下载插件pandoc,百度官网下载,pandoc网站

根据需要下载,windows下载这个msi结尾的文件进行安装

下载这个插件md文件才能转换word,如果遇到转换word失败,百度说的是存在表格,所以导出不了

这个地方导出我使用的是wps的pdf转word功能,通过pdf转换word,可以多选,当然也可以用其他的,我试过几种但导出的word都不能编辑,就是张图片,就放弃了,直接找经常做文档的同事借了个会员导出的

最后,导出的接口文档不一定满足需要,还得修改文档,只能说删文档比不知道咋个加接口文档好使,如果代码足够规范,导出来就能用,当我没说

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值