一.在pom中添加插件
- 修改swagger地址
<!-- 此插件生成markdown、ASCIIDOC、wiki格式-->
<!-- 执行命令 mvn swagger2markup:convertSwagger2markup-->
<plugin>
<groupId>io.github.swagger2markup</groupId>
<artifactId>swagger2markup-maven-plugin</artifactId>
<version>1.3.7</version>
<configuration>
<!-- api-docs访问url -->
<swaggerInput>http://localhost:8080/order/v2/api-docs</swaggerInput>
<!-- 生成为单个文档,输出路径-->
<outputFile>src/docs/api</outputFile>
<!-- 生成为多个文档,输出路径 -->
<!--<outputDir>src/docs/</outputDir>-->
<config>
<!-- wiki格式文档 -->
<!--<swagger2markup.markupLanguage>CONFLUENCE_MARKUP</swagger2markup.markupLanguage>-->
<!-- ascii格式文档 -->
<swagger2markup.markupLanguage>ASCIIDOC</swagger2markup.markupLanguage>
<!-- markdown格式文档 -->
<!--<swagger2markup.markupLanguage>MARKDOWN</swagger2markup.markupLanguage>-->
<swagger2markup.pathsGroupedBy>TAGS</swagger2markup.pathsGroupedBy>
</config>
</configuration>
</plugin>
<!--此插件生成HTML和PDF-->
<!-- 执行命令 mvn generate-resources -->
<plugin>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctor-maven-plugin</artifactId>
<version>2.1.0</version>
<!-- Include Asciidoctor PDF for pdf generation -->
<dependencies>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj-pdf</artifactId>
<version>1.5.4</version>
</dependency>
<dependency>
<groupId>org.jruby</groupId>
<artifactId>jruby-complete</artifactId>
<version>9.2.17.0</version>
</dependency>
</dependencies>
<!-- Configure generic document generation settings -->
<configuration>
<sourceDirectory>src/docs</sourceDirectory>
<!-- <sourceHighlighter>coderay</sourceHighlighter>-->
<attributes>
<toc>left</toc>
</attributes>
</configuration>
<!-- Since each execution can only handle one backend, run
separate executions for each desired output type -->
<executions>
<execution>
<id>output-pdf</id>
<phase>generate-resources</phase>
<goals>
<goal>process-asciidoc</goal>
</goals>
<configuration>
<backend>pdf</backend>
<outputDirectory>src/docs/pdf/</outputDirectory>
</configuration>
</execution>
<execution>
<id>output-html</id>
<phase>generate-resources</phase>
<goals>
<goal>process-asciidoc</goal>
</goals>
<configuration>
<backend>html5</backend>
<outputDirectory>src/docs/html/</outputDirectory>
</configuration>
</execution>
</executions>
</plugin>
二.
1、执行mvn swagger2markup:convertSwagger2markup , 可以在idea maven插件中执行
2、生成 html 、pdf,执行1后,执行mvn generate-resources
3、pdf中文显示存在问题