themes - studio - ¿Por qué no hay temas para swagger-ui?
swagger ui themes (5)
Esta es una colección de temas de hojas de estilo que se pueden aplicar a la interfaz de usuario de Swagger. Enlace abajo a mi repositorio sobre cómo usar.
Espero que esto ayude.
Me gusta mucho la arrogancia para documentar las API de Restful, especialmente "¡Pruébelo!"
botón, pero
swagger-ui
no se ve muy bien.
¿Y no puedo creer que no haya plantillas para una herramienta de código abierto tan sorprendente (o no puedo encontrar ninguna)?
No lo quiero de forma gratuita. Al igual que http://getbootstrap.com/ tiene muchos sitios para comprar temas (como https://wrapbootstrap.com/ ), ¿por qué no puedo encontrar ningún sitio para temas swagger?
Otra opción es ReDoc .
Solo necesita traer su archivo swagger.json con un index.html . Configuración fácil.
<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/redoc@next/bundles/redoc.standalone.js"> </script>
</body>
Recientemente bifurqué refactorizando el tema swagger-ui compartido anteriormente usando bootstrap v4 para cualquier persona interesada. Véalo aquí https://github.com/afgarcia86/bootstrap-swagger-ui
Swagger-UI, aunque no es una herramienta nueva, es muy específica para su tarea. No conozco ningún sitio web que le proporcione temas (gratis o de pago). Muchos de sus usuarios han personalizado la interfaz de usuario para que se ajuste a su tema local. Algunos han realizado cambios sutiles, algunos una revisión completa.
Recomiendo mirar alrededor de las implementaciones disponibles y ver si algo se adapta a sus necesidades. Luego, quizás pida permiso para reutilizar su tema / plantilla para sus propias necesidades.
Una respuesta tardía, aunque buena. ¡Esto es asombroso! Una implementación ingeniosa, y ha personalizado muchas cosas que son fáciles de ajustar una vez más para sus necesidades: https://github.com/jensoleg/swagger-ui .
Los créditos van a este grupo de google: https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI . Es extraño que esto no se haya publicado aquí todavía.
Para ver una demostración de acción, consulte este enlace:
http://senodio.com/site/swagger/#!/pet/addPet
-
EDITAR: Recientemente descubrí que la DEMO está inactiva, así que bifurqué el Repo ( https://github.com/MartinSahlen/swagger-ui ) y creé un nodo simple / servidor express que se ejecuta en heroku. Tenga en cuenta que este es un heroku dyno gratuito, por lo que puede tardar un tiempo en cargarse (~ 20 segundos) si hay poca actividad en él durante algún tiempo.
De nada: http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet
EDIT 2: acabo de encontrar otro que parece prometedor: https://github.com/legendecas/material-swagger-ui . También parece que la interfaz de usuario swagger que estoy alojando ahora resucita en http://swaggerui.herokuapp.com/ . Mantener el mío también en caso de que se desmonte nuevamente.