我想使用昂首阔步,这是我的 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,只需构建它。