GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → Swagger2Markup → swagger2markup-maven-project-template

Swagger2Markup / swagger2markup-maven-project-template

Licence: other
This is a Swagger2Markup Maven template project which uses the swagger2markup-maven-plugin to convert a contract-first Swagger specification into an AsciiDoctor-based HTML documentation.

Swagger2Markup Maven template project

This is a Swagger2Markup Maven template project which uses the swagger2markup-maven-plugin to convert a contract-first Swagger specification into an AsciiDoctor-based HTML documentation.

Usage guide

Swagger Specification

  1. Copy your Swagger Specification (JSON or YAML) file into the folder src/docs/swagger

  2. Modify the pom.xml properties.swagger.input to point at the copied specification

Add hand-written content

Add hand-written AsciiDoc content into the folder src/docs/asciidoc and include the files in src/docs/asciidoc/index.adoc.

include::{generated}/overview.adoc[]
include::manual_content1.adoc[]
include::manual_content2.adoc[]
include::{generated}/paths.adoc[]
include::{generated}/definitions.adoc[]

The Asciidoctor attribute {generated} is set by the Gradle script to target/asciidoc. By default the Swagger2Markup Maven plugin creates the the generated AsciiDoc files into the target/asciidoc folder.

Convert AsciiDoc into HTML

mvn process-resources

See target/asciidoc/html5/index.html to check the generated HTML report.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].