百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
S

spring-swagger2markup-demo

> 编程语言
开源

一个使用 Swagger2Markup、Spring Boot、Springfox 和 spring-restdocs 的示例项目模板

396 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

一个使用 Swagger2Markup、Spring Boot、Springfox 和 spring-restdocs 的示例项目模板

= 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[]

Issues· 10 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Java

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言