This project is a Swagger2Markup (AsciiDoc and GitHub Flavored Markdown) converter demo using Spring Boot, springfox and spring-restdocs.
The demo shows how to generate static docs (HTML5 and PDF) with the swagger2markup-gradle-plugin and serve them in a Spring Boot app under http://localhost:9080/docs/index.html and http://localhost:9080/docs/index.pdf.
See Swagger2Markup and swagger2markup-gradle-plugin for more details and usage guide.
If you want to start the Spring Boot application, please run:
gradlew clean build
java -jar build/libs/spring-swagger2markup-demo-0.9.1.jar
If you only want to generate the HTML and PDF documentation, please run:
gradlew clean asciidoctor
The results are generated into build\asciidoc\html5
and build\asciidoc\pdf
.
See live demo on GitHub Pages: http://swagger2markup.github.io/spring-swagger2markup-demo/0.9.1