generator-jhipster-swagger2markup
JHipster module to create static api docs with swagger2markup
Usage
This is a JHipster module, that is meant to be use in a JHipster application.
Installation
As this is a JHipster module, we expect you have JHipster and its related tools already installed.
npm install -g generator-jhipster-swagger2markup
Then run the module on a JHipster generated application:
yo jhipster-swagger2markup
If you want don't want to answer each question you can use
yo jhipster-swagger2markup default
to setup HTML5
backend and asciidoc
sample chapter.
Gradle
This plugin adds new tasks to your gradle build system
The generated static documentation can be found in build/asciidoc
as html or pdf.
Maven
The html or pdf generation is bound to the install
lifecycle phase. The swagger2markup
creation is not bound to any phase, therefore you must create it explicitly during the test phase and process the swagger file:
mvnw test swagger2markup:process-swagger install
The generated static documentation can be found in target/asciidoc
as html or pdf.
Limitation
As the latest swagger2markup-maven-plugin
is not properly deployed to maven central grouping by tag doesn't work with maven yet.
Result
License
Apache-2.0 © Frederik Hahne