我使用Swagger显示我的REST and服务,并将其托管在服务器上。
但是,Swagger的这项服务只能在特定的服务器上访问。如果我想离线工作,有人知道我如何使用Swagger创建静态PDF并使用它吗?此外,PDF很容易与无法访问服务器的人共享。
非常感谢!
发布于 2015-05-26 10:07:56
我想出了一种使用https://github.com/springfox/springfox和https://github.com/RobWin/swagger2markup的方法
使用Swagger 2实现文档。
发布于 2016-12-21 07:23:10
方便的方法:使用浏览器打印/预览
发布于 2019-08-28 17:49:55
我创建了一个网站https://www.swdoc.org/,专门解决这个问题。因此,它按照答案中的建议自动进行swagger.json -> Asciidoc, Asciidoc -> pdf
转换。这样做的好处是,您不需要通过安装过程。它接受以url形式或只是原始json形式的规范文档。项目是用C#编写的,其页面是https://github.com/Irdis/SwDoc。
编辑
在这里验证您的json规范可能是个好主意:如果您对http://editor.swagger.io/有任何问题,比如生成不完整的pdf。
https://stackoverflow.com/questions/30217910
复制相似问题