it-swarm-pt.tech

Por que não há temas para o swagger-ui?

Eu gosto de swagger por documentar APIs Restful muito, especialmente "Experimente!" botão, mas swagger-ui interface não parece muito legal.

E eu não posso acreditar que não há modelos para essa incrível ferramenta de código aberto (ou não consigo encontrar nenhum)?

Eu não quero isso de graça .. Como http://getbootstrap.com/ tem muitos sites para comprar temas (como https://wrapbootstrap.com/ ), porque eu não consigo encontrar nenhum site para temas de swagger?

54
Arūnas Smaliukas

Uma resposta tardia, embora boa. Isso é muito legal! Uma implementação engenhosa, e ele personalizou muitas coisas que são fáceis de ajustar mais uma vez para as suas necessidades: https://github.com/jensoleg/swagger-ui

Os créditos vão para este grupo do Google: https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI . Estranho que isso ainda não tenha sido postado aqui.

Para uma demonstração de ação, confira este link: http://senodio.com/site/swagger/#!/pet/addPet

-

EDIT: Recentemente descobriu que o DEMO está inoperante, então eu bifurquei o Repo ( https://github.com/MartinSahlen/swagger-ui ) e criei um servidor simples de nó/expresso que roda em heroku. Por favor, note que este é um dyno heroku gratuito, por isso pode demorar um pouco para carregar (~ 20 seg) se houver pouca atividade nele por algum tempo.

Você é bem-vindo: http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

EDIT 2: Acabou de encontrar outro que parece promissor: https://github.com/legendecas/material-swagger-ui . Também parece que a arrogância que estou hospedando agora é ressuscitada em http://swaggerui.herokuapp.com/ . Mantendo o meu também, caso seja derrubado novamente.

69
martin.code

Esta é uma coleção de temas de folha de estilo que podem ser aplicados à interface do usuário do Swagger. Link abaixo para o meu repo sobre como usar. 

Espero que isto ajude.

https://github.com/ostranme/swagger-ui-themes

13
ostranme

O Swagger-UI, embora não seja uma ferramenta nova, é muito específico para sua tarefa. Não tenho conhecimento de nenhum site que forneça temas para ele (gratuitos ou pagos). Muitos de seus usuários personalizaram a interface para se adequar ao tema local. Alguns fizeram mudanças sutis, algumas uma revisão completa.

Eu recomendo olhar em torno das implementações disponíveis e ver se algo atende às suas necessidades. Então, talvez peça permissão para reutilizar seu tema/modelo para suas próprias necessidades.

5
Ron

Outra opção é ReDoc .

Você só precisa trazer seu arquivo swagger.json com um index.html. Fácil configuração.

<head>
    <title>ReDoc</title>
    <meta charset="utf-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
    <style>
      body {
        margin: 0;
        padding: 0;
      }
    </style>
  </head>
  <body>
    <redoc spec-url='your.swagger.json'></redoc>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/bundles/redoc.standalone.js"> </script>
  </body>
3
user1917528

Eu recentemente bifurcou o tema swagger-ui compartilhado acima usando o bootstrap v4 para quem estiver interessado. Veja aqui https://github.com/afgarcia86/bootstrap-swagger-ui

2
Andres F Garcia

você pode usar swagger-boostrap-ui

github: https://github.com/xiaoymin/Swagger-Bootstrap-UI

apoiar a remarcação de exportação de apis e assim por diante ...

0
xiaoym

Checkout RapiDoc

  • Suporta Tema
  • Pode modificar muitos outros atributos de exibição, como alterar a cor do cabeçalho, o texto do cabeçalho e o layout
  • Elemento personalizado com base, fácil de adicionar em qualquer documento HTML. Ao contrário de outras soluções 
0
Mrinmoy