安装swagger-ui

Question

我想使用昂首阔步，这是我的Ubuntu12.04系统上的api文档工具。在一台Windows机器上，我只需用火狐打开index.html文件，并输入我想要使用的Swagger的地址，但在Ubuntu上，它似乎不能正常工作--我可以看到Swagger甚至没有尝试获取资源页面。

有人成功这样做了吗？你是安装了coffeescript和车把，还是做了其他的事情？

Answer 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或工具栏来运行UI，只需构建它。