# spring-swagger2markup-demo

**Repository Path**: code_wd/spring-swagger2markup-demo

## Basic Information

- **Project Name**: spring-swagger2markup-demo
- **Description**: A demo project template using Swagger2Markup, Spring Boot, Springfox and spring-restdocs
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-19
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

= Swagger2Markup Demo
:author: Robert Winkler
:version: 1.1.0
:hardbreaks:

image:https://travis-ci.org/Swagger2Markup/spring-swagger2markup-demo.svg?branch=master["Build Status", link="https://travis-ci.org/Swagger2Markup/spring-swagger2markup-demo"] image:http://img.shields.io/badge/license-ASF2-blue.svg["Apache License 2", link="http://www.apache.org/licenses/LICENSE-2.0.txt"] image:https://img.shields.io/badge/Twitter-rbrtwnklr-blue.svg["Twitter", link="https://twitter.com/rbrtwnklr"] image:https://badges.gitter.im/Join%20Chat.svg[link="https://gitter.im/RobWin/swagger2markup?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"]

== Overview

This project is a https://github.com/RobWin/swagger2markup[Swagger2Markup] (AsciiDoc and GitHub Flavored Markdown) converter demo using https://github.com/spring-projects/spring-boot[Spring Boot], https://github.com/springfox/springfox[springfox] and https://github.com/spring-projects/spring-restdocs[spring-restdocs].
The demo shows how to generate static docs (HTML5 and PDF) with the https://github.com/RobWin/swagger2markup-gradle-plugin[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 https://github.com/RobWin/swagger2markup[Swagger2Markup] and https://github.com/RobWin/swagger2markup-gradle-plugin[swagger2markup-gradle-plugin] for more details and usage guide.

== Usage guide

=== Gradle

If you want to start the Spring Boot application, please run:

[source,groovy]
----
gradlew clean build
----

[subs="attributes"]
----
java -jar build/libs/spring-swagger2markup-demo-{version}.jar
----

If you only want to generate the HTML and PDF documentation, please run:

[source,groovy]
----
gradlew clean asciidoctor
----

The results are generated into `build/asciidoc/html5` and `build/asciidoc/pdf`.

=== Maven

If you want to start the Spring Boot application, please run:

[source,groovy]
----
mvn clean package
----

[subs="attributes"]
----
java -jar target/spring-swagger2markup-demo-{version}.jar
----

If you only want to generate the HTML and PDF documentation, please run:

[source,groovy]
----
mvn clean test
----

The results are generated into `target/asciidoc/html` and `target/asciidoc/pdf`.


== Demo

[subs="attributes"]
See live demo on GitHub Pages: http://swagger2markup.github.io/spring-swagger2markup-demo/{version}

== Screenshot

image:images/Demo.PNG[]