如何使用 maven-swagger-codegen-plugin 生成文档？答案

【问题标题】：How generate documentation with maven-swagger-codegen-plugin?如何使用 maven-swagger-codegen-plugin 生成文档？
【发布时间】：2016-07-18 04:40:44
【问题描述】：

我已经像那样配置了 swagger-codegen-plugin

    <plugin>
        <groupId>io.swagger</groupId>
        <artifactId>swagger-codegen-maven-plugin</artifactId>
        <version>2.1.5</version>
        <executions>
            <execution>
                <goals>
                    <goal>generate</goal>
                </goals>
                <configuration>
                    <inputSpec>${project.basedir}/src/main/resources/model.json</inputSpec>
                    <language>java</language>
                    <configOptions>
                        <sourceFolder>src/gen/java/main</sourceFolder>
                    </configOptions>
                    <modelPackage>com.mypackage</modelPackage>
                    <environmentVariables>
                        <models></models>
                        <supportingFiles>false</supportingFiles>
                    </environmentVariables>
                </configuration>
            </execution>
        </executions>
    </plugin>

一切正常，但是当我将语言更改为 <language>html</language> 时，没有生成任何内容。

那么如何生成 staitc html 文档呢？

【问题讨论】：

您能检查target/generated-sources/swagger/ 文件夹吗？应该有一个index.html 文件。我不确定它是否需要sourceFolder
有一些文件，但根本没有html文件！！！
也许 maven 日志会有所帮助。真的很难弄清楚。你的配置看起来不错

标签： java maven swagger-2.0 swagger-codegen

【解决方案1】：

目前，您将语言指定为<language>java</language> 以生成html，这应该是<language>html</language> 或<language>html2</language>，因为这指定了swagger-codegen 的输出语言生成器。

有 2 种不同的 html 生成器，因此您需要确定自己喜欢的风格。

【讨论】：