【发布时间】：2015-11-26 16:17:47
【问题描述】：
有没有人在哪里，在哪里输入你的招摇 URL .../swagger/docs/v1 然后网站将其转换为 HTML、pdf、doc 或其他可读格式？我认为该网站会获得大量流量（提示）
我知道 github 上有一些东西可以下载，可以转换东西，但我想有人已经建立了一个公共网站，这样我可以节省一些时间。
【问题讨论】：
【发布时间】：2015-11-26 16:17:47
【问题描述】：
试试这个：swagger2html。
swagger-codegen 生成的文档确实不可读。该项目外观简洁（bootstrap css），并以直接的方式显示请求/响应模型中的字段。
【讨论】：
您可以使用这个网站：Swagger Editor 复制您的招摇文件，然后在菜单中选择“生成客户端”->“HTML”（或动态 HTML）
如果您想在自动构建流程中添加此步骤，也可以使用Swagger Code Generator。
【讨论】：
-
那个生成客户端看起来不太好想
-
html2 看起来很完美（生成客户端 -> html2），如果您想让它在通过邮件分享给您的 API 消费者时更加友好，您可以将其打印为 PDF 文件。跨度>
-
如果这行得通，它就不再有用了。控制台现在只记录一个
TypeError: NetworkError when attempting to fetch resource.错误。Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at ...