Установка Swagger-UI
Я хотел бы использовать Swagger , инструмент API-документации в моей системе Ubuntu 12.04. На компьютере с Windows я просто открываю файл index.html с помощью Firefox и вставляю адрес, с которым я хочу, чтобы swagger-ui работал, но в Ubuntu кажется, что он не работает должным образом - я Я вижу, что Swagger-интерфейс даже не пытается получить страницу ресурсов.
Кому-нибудь удалось это сделать? Вы установили coffeescript и руль или сделали что-то еще?
1 ответ
Если Firefox может открывать файловые ресурсы, тогда проблем быть не должно. Я бы предложил следующее:
-
Используйте готовый дистрибутив отсюда: https://github.com/wordnik/swagger-ui/downloads В противном случае вам нужно будет следовать инструкциям, чтобы собрать его с нуля, так как источник использует coffeescript и т. д.
-
Откройте панель сети, чтобы узнать, есть ли запросы к внешним ресурсам. Если вы размещаете файлы json на основе swagger на веб-сервере или используете интеграцию с сервером для их автоматического создания, вам может потребоваться установить
Access-Control-Allow-Origin: *, как описано здесь: https://github.com/wordnik / swagger-core / wiki / java-jax-rs -
Просмотрите вывод консоли, чтобы выяснить, не возникла ли ошибка JavaScript при чтении недопустимого файла спецификации
Вам не нужно устанавливать coffeescript или handlebars для запуска интерфейса, только собирайте его.