Swagger2之在线文档生成PDF和HTML文件

上章讲的swagger的配置（详细见：https://blog.csdn.net/jiandequn/article/details/94718957）；本章就开始pdf和html文件的生成。废话不多说了，直接开始配置；

1、maven的swagger2markup依赖(pom.xml)

 
            io.github.swagger2markup
            swagger2markup
            1.3.3
        

2、maven的插件(pom.xml)

 
            
                io.github.swagger2markup
                swagger2markup-maven-plugin
                1.3.7
                
                    
                    http://localhost:8888/v2/api-docs
                    
                    src/docs/asciidoc/generated
                    
                        
                        ASCIIDOC
                    
                
            
            
            
                org.asciidoctor
                asciidoctor-maven-plugin
                2.0.0-RC.1
                
                
                    
                        org.asciidoctor
                        asciidoctorj-pdf
                        1.5.0-alpha.18
                    
                    
                        org.jruby
                        jruby-complete
                        9.2.7.0
                    
                
                
                
                    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
                        
                    

                
            
        

3、上述配置已配置好，接下来就是生成文档 ;使用maven命令（配置pom.xml文件所在目录执行）

     先使用命令： mvn swagger2markup:convertSwagger2markup 生成adoc文件(或者 mvn asciidoctor process-asciidoc)

    然后使用命令：mvn generate-resources 生成html和pdf文件

  在idea中可以使用如图maven插件直接执行（但是只能生成adoc文件，而且mvn asciidoctor process-asciidoc 有的生成异常）