swagger 生成文档

pom.xml

<!--文档生成1-->
            <plugin>
                <groupId>io.github.swagger2markup</groupId>
                <artifactId>swagger2markup-maven-plugin</artifactId>
                <version>1.3.1</version>
                <configuration>
                    <!--                    api-docs访问url -->
                    <swaggerInput>http://localhost:18080/v2/api-docs</swaggerInput>
                    <!--                    生成为单个文档，输出路径 -->
                    <!--                    <outputFile>src/main/doc/api</outputFile>-->
                    <!--                    生成为多个文档，输出路径 -->
                    <outputDir>src/main/doc/apiAll</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>
            <!--文档生成2-->
            <plugin>
                <groupId>org.asciidoctor</groupId>
                <artifactId>asciidoctor-maven-plugin</artifactId>
                <version>1.5.6</version>
                <configuration>
                    <sourceDirectory>src/main/doc/apiAll</sourceDirectory>
                    <outputDirectory>src/main/doc/api/html</outputDirectory>
                    <backend>html</backend>
                    <sourceHighlighter>coderay</sourceHighlighter>
                    <attributes>
                        <toc>left</toc>
                    </attributes>
                </configuration>
            </plugin>

可配合使用

ShowDoc

执行命令：

mvn swagger2markup:convertSwagger2markup
mvn asciidoctor:process-asciidoc