swagger2markup生成静态文档（插件版）

最新推荐文章于 2024-08-10 07:36:00 发布

weixin_42212156

最新推荐文章于 2024-08-10 07:36:00 发布

阅读量496

点赞数

本文链接：https://blog.csdn.net/weixin_42212156/article/details/102958382

版权

本文介绍了如何通过swagger2markup插件将Swagger接口JSON转换为asciidoc或markdown文档，并利用asciidoctor插件生成HTML和PDF。详细讲解了插件配置、字体设置及解决PDF乱码、空白问题的方法。

摘要由CSDN通过智能技术生成

swagger2markup生成静态文档（插件版）

生成asciidoc或markdown文档

添加swagger2markup插件

<plugin>
                <groupId>io.github.swagger2markup</groupId>
                <artifactId>swagger2markup-maven-plugin</artifactId>
                <version>1.3.3</version>
                <configuration>
                    <swaggerInput>http://localhost:9210/v2/api-docs</swaggerInput>
                    <!-- 生成asciidoc格式 -->
                    <outputFile>src/docs/asciidoc/generated/all</outputFile>
<!--                    <outputDir>src/docs/asciidoc/generated</outputDir>-->
                    <!-- 生成markdown格式 -->
<!--                    <outputFile>src/docs/markdown/generated/all</outputFile>-->
                    <config>
                        <!-- 生成asciidoc格式 -->
                        <swagger2markup.markupLanguage>ASCIIDOC</swagger2markup.markupLanguage>
                        <!-- 生成markdown格式 -->
<!--                        <swagger2markup.markupLanguage>MARKDOWN</swagger2markup.markupLanguage>-->
                        <swagger2markup.outputLanguage>ZH</swagger2markup.outputLanguage>
                        <swagger2markup.generatedExamplesEnabled>true</swagger2markup.generatedExamplesEnabled>
                        <swagger2markup.inlineSchemaEnabled>false</swagger2markup.inlineSchemaEnabled>
                        <swagger2markup.pathsGroupedBy>TAGS</swagger2markup.pathsGroupedBy>
                    </config>
                </configuration>
            </plugin>