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

Question

I have configured swagger-codegen-plugin like that

    <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>

Everything works, but when I change language to <language>html</language> nothing was generate.

So how to generation staitc html documentation?

Answer 1

At present, you are specifying the language as <language>java</language> to generate html this should either be <language>html</language> or <language>html2</language> as this specifies the output language generator for swagger-codegen.

There are 2 different html generators so you will need to decide your preferred flavour.