安装 swagger-ui

安装 swagger-ui

我想使用昂首阔步,这是我的 Ubuntu 12.04 系统上的 api-documentation 工具。在 Windows 机器上,我只需打开索引.html使用 Firefox 文件并输入我希望 swagger-ui 使用的地址,但在 Ubuntu 上它似乎不能正常工作——我可以看到 Swagger-ui 甚至没有尝试获取资源页面。

有人成功做到这一点了吗?你安装了 coffeescript 和 handlebars 吗,还是做了其他什么?

答案1

如果 Firefox 可以打开基于文件的资源,那么应该不会有问题。我建议如下:

  • 使用这里预先构建的分布:https://github.com/wordnik/swagger-ui/downloads 否则,您将需要按照说明从头开始构建它,因为源使用了 coffeescript 等。

  • 打开网络面板查看是否有对外部资源的请求。如果您在 Web 服务器上托管基于 swagger 的 json 文件,或者使用服务器集成自动创建它们,则可能需要按Access-Control-Allow-Origin: *如下所述进行设置:https://github.com/wordnik/swagger-core/wiki/java-jax-rs

  • 查看控制台输出,看看是否有任何因读取无效的 spec 文件而发出的 JavaScript 错误

您不需要安装 coffeescript 或 handlebars 来运行 UI,只需构建它。

相关内容