Как создать документацию с помощью maven-swagger-codegen-plugin?

Я настроил 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?


person Cherry    schedule 18.07.2016    source источник
comment
Вы можете проверить папку target/generated-sources/swagger/? Должен быть файл index.html. Я не уверен, нужно ли это sourceFolder   -  person d0x    schedule 20.07.2016
comment
Есть какие-то файлы, но не html файлы вообще!!!   -  person Cherry    schedule 20.07.2016
comment
Возможно, журнал maven будет полезен. Это действительно трудно понять. Ваш конфиг выглядит хорошо   -  person d0x    schedule 20.07.2016


Ответы (1)


В настоящее время вы указываете язык как <language>java</language> для генерации html, это должно быть либо <language>html</language>, либо <language>html2</language>, так как это указывает генератор языка вывода для swagger-codegen.

Существует 2 разных генератора html, поэтому вам нужно будет выбрать предпочтительный вариант.

person Dragonthoughts    schedule 20.08.2019