根据swagger.json生成离线api文档

根据swagger.json生成离线api文档

支持url和 json文件生成

下载jar包

http://119.27.167.41:8080/books/8b0d7a7f2ec2b64983da98ed01061bc4/swagger2markup.jar

执行生成文档命令

根据swagger api url 生成

url 地址在浏览器开发者模式上找 api-docs结尾的url, 返回一大串json的url

C:\Users\chengdu\Desktop\swaggerdoc>java -jar swagger2markup.jar http://localhost:9090/v2/api-docs
json file location-----http://localhost:9090/v2/api-docs
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

根据swagger的api json文件生成

C:\Users\chengdu\Desktop\swaggerdoc>java -jar swagger2markup.jar D:/Others/api-docs-new-2.json
json file location-----D:/Others/api-docs-new-2.json
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

查看当前 目录下会看到多了一个target文件夹, 文档位置在 \target\asciidoc\generated

C:\Users\chengdu\Desktop\swaggerdoc\target\asciidoc\generated>dir
 驱动器 C 中的卷没有标签。
 卷的序列号是 02BA-32EC

 C:\Users\chengdu\Desktop\swaggerdoc\target\asciidoc\generated 的目录

2019/04/14  22:41    <DIR>          .
2019/04/14  22:41    <DIR>          ..
2019/04/14  22:41             3,568 definitions.adoc
2019/04/14  22:41               416 overview.adoc
2019/04/14  22:41             8,807 paths.adoc
2019/04/14  22:41                 4 security.adoc
               4 个文件         12,795 字节
               2 个目录 209,610,186,752 可用字节
               

使用工具查看文档

AsciidocFX

AsciiDOC