Instalando o swagger-ui

0

Gostaria de usar o Swagger , a ferramenta de documentação da api no meu sistema Ubuntu 12.04. Em uma máquina Windows eu simplesmente abro o arquivo index.html com o Firefox e coloco o endereço que eu quero que o swagger-ui trabalhe, mas no Ubuntu parece que ele não está funcionando corretamente - Eu posso ver que o Swagger-ui não está nem tentando buscar a página de recursos.

Alguém conseguiu fazer isso? Você instalou o coffeescript e o handlebars, ou fez outra coisa?

    
por Eyal 10.01.2013 / 15:13

1 resposta

1

Se o firefox puder abrir recursos baseados em arquivos, não deverá haver um problema. Eu sugeriria o seguinte:

  • Use a distribuição pré-criada aqui: link Caso contrário, você precisará seguir as instruções para construí-lo a partir do zero, uma vez que a fonte usa o coffeescript, etc.

  • Abra o painel de rede para ver se há solicitações para recursos externos. Se você estiver hospedando os arquivos json baseados em swagger em um servidor da Web ou usando a integração do servidor para criá-los automaticamente, talvez seja necessário definir o Access-Control-Allow-Origin: * conforme descrito aqui: link

  • Procure na saída do console para ver se há algum erro de javascript emitido pela leitura de um arquivo de especificação inválido

Você não precisa instalar o coffeescript ou o handlebars para executar a interface do usuário, apenas construa-a.

    
por user122009 13.01.2013 / 18:19