swagger2离线导出Word/PDF/HTML文档
1.前言
通过前面的两篇博客
我们已经介绍了如何使用spring boot整合swagger2 生成在线的API文档。
但是某些情况下,我们需要上交文档类型的接口文档以完成国内开发项目中的文档空缺。然而我们需要提交的文档一般都是Word文档或者PDF文档之类的。HTML这类都很少见。但是这些统统都要离线的
2.通过swagger2markup来实现swagger2 Word/PDF/HTML的导出
2.1在项目中添加swagger2markup的依赖。
当然项目之前的swagger2依赖统统的需要。如果这里有啥不懂得可以参考上面的两个博客。这里将不会再详细的讲述swagger2生成在线文档。
2.2配置文档输出路径
3.执行maven命令来生成文档
maven install