swagger导出到pdf、html文档

最近工作中接到一个任务，就是项目要一份接口文档，之前项目用的文档是swagger的自动生成的，再导入一些好看的UI(也没好看到哪里去，比如springfox-swagger-ui)来使用，其实也是一直这样。但是项目的接口太多了，这要是让我去手写到文档，可能得写到兔年了。于是乎我在想，能不能把swagger的接口导出来，直接完成任务。
起先，我在项目的swagger上面看到有导出这个功能，于是我很高兴得点击了其中 的一个，然后它就转呀转，转了好几个小时都还停，那个时候我就绝望了，所以我就去网上搜索资料，各个方法都去尝试一下，发现其实是可以的，可能是因为我那个项目太大了，接口太多，一直转个不停。后来我还尝试了其他的实现办法，找到了另外两个，遇到了很多的坑，这里一起介绍。

swagger UI离线文档

首先swagger有个比原生好看的UI（swagger基本配置我就不过多介绍，网上一大堆），叫springfox-swagger-ui，这个UI相对于原生的UI好看了很多的，更加符合中国人的审美。下面是springboot整合swagger-bootstrap-ui的介绍。

1. 导入依赖springfox-swagger-ui

   com.github.xiaoymin swagger-bootstrap-ui 1.9.6

2. 在swagger的配置类上加上注解

3. 静态资源配置

访问地址：
http:// {ip地址}: {端口号} /doc.html
打开页面后是这样的，提供了拷贝md格式的文本，可以将文本复制到软件 Typora 中去查看

拷贝到Typora后

但是我们项目使用的是另外一个UI，叫 knife4j，这个其实是 swagger-bootstrap-ui 的增强版，增加了很多的功能，详情参考官方

1. 导入依赖

   com.github.xiaoymin knife4j-spring-boot-starter 2.0.7

说明：3.0.3 版本的knife4j依赖包需要更高版本的swagger依赖包，我用 2.9.2版本的时候报错

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>

报错：

 springfox/documentation/common/ClassPresentInClassPathCondition

升级版本即可

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>3.0.0</version>
</dependency>

2. 在swagger的配置类上加上注解
   把 swagger-bootstrap-ui 的注解 @EnableSwaggerBootstrapUI 改成 @EnableKnife4j 即可
   
3. 静态资源配置
   静态资源配置资源配置和 swagger-bootstrap-ui 一样
   访问的地址一样: http:// {ip地址}: {端口号} /doc.html
   会发现这里增加了导出的功能，比如导出md 、work文档、html等不同类型的接口文档
   
   试着是可以用的，但是下载出来的work格式不敢恭维