SringBoot+Swagger2 pdf 오프라인 문서 내보내기

6606 단어
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"));
    }
}

그리고 팝에서.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 디렉터리에서 당신이 필요로 하는 오프라인 문서를 볼 수 있습니다.

좋은 웹페이지 즐겨찾기