How generate documentation with 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?

Can you check the target/generated-sources/swagger/ folder? There should be a index.html file. I'm not sure whether it takes the sourceFolder — d0x
– d0x, Commented Jul 20, 2016 at 12:43
Maybe the maven log would be helpful. It is really hard to figure it out. Your config looks good — d0x
– d0x, Commented Jul 20, 2016 at 13:15

Dragonthoughts · Accepted Answer · 2019-08-20 11:41:52Z

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.

answered Aug 20, 2019 at 11:41

Dragonthoughts

2,2348 gold badges27 silver badges28 bronze badges

Sign up to request clarification or add additional context in comments.

Collectives™ on Stack Overflow

How generate documentation with maven-swagger-codegen-plugin?

1 Answer 1

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

Comments

Your Answer

Sign up or log in

Post as a guest

Related