html文档生成pdf离线文件,SringBoot+Swagger2导出pdf离线文档

在SpringBoot项目中使用了Swagger2可以使用以下办法导出离线文件

首先将下面代码拷贝到你的项目中测试运行(必须要先运行这个测试类)

注意：要修改成你的URL地址

@RunWith(SpringRunner.class)

public class ExportConfig {

@Test

public void generateAsciiDocs() throws Exception {

// 输出Ascii格式

Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder().withMarkupLanguage(MarkupLanguage.ASCIIDOC)

.withOutputLanguage(Language.ZH).withPathsGroupedBy(GroupBy.TAGS).withGeneratedExamples()

.withoutInlineSchema().build();

Swagger2MarkupConverter.from(new URL("http://172.21.3.15:8080/v2/api-docs")).withConfig(config)

.build().toFolder(Paths.get("src/docs/asciidoc/generated"));

}

}

然后在pom.xml中导入需要的一些依赖和插件

依赖

io.github.swagger2markup

swagger2markup

1.3.3

插件：插件中需要像上面那个测试代码一样修改成你的项目IP和端口

springboot-swagger

io.github.swagger2markup

swagger2markup-maven-plugin

1.2.0

http://localhost:8080/v2/api-docs

src/docs/asciidoc/generated

ASCIIDOC

org.asciidoctor

asciidoctor-maven-plugin

1.5.3

org.asciidoctor

asciidoctorj-pdf

1.5.0-alpha.10.1

org.jruby

jruby-complete

1.7.24

src/docs/asciidoc/generated

coderay

left

output-html

generate-resources

process-asciidoc

html5

src/docs/asciidoc/html

output-pdf

generate-resources

process-asciidoc

pdf

src/docs/asciidoc/pdf

org.eclipse.m2e

lifecycle-mapping

1.0.0

org.asciidoctor

asciidoctor-maven-plugin

[1.5.3,)

process-asciidoc

最后依次执行这两条mvn指令：mvn asciidoctor:process-asciidoc 和 mvn generate-resources

然后就可以在项目的src\docs目录下看到你需要的离线文档了。