it-swarm-fr.com

Pourquoi il n'y a pas de thèmes pour swagger-ui?

J'aime beaucoup le courage de documenter les API Restful, en particulier "Essayez-le!" bouton, mais l'interface swagger-ui ne semble pas très cool.

Et je ne peux pas croire qu’il n’existe pas de modèles pour cet outil Open Source aussi étonnant (ou que je n’en trouve pas)?

Je ne le veux pas gratuitement .. Comme http://getbootstrap.com/ propose de nombreux sites pour acheter des thèmes (comme https://wrapbootstrap.com/ ), je ne trouve aucun site pour les thèmes swagger?

54
Arūnas Smaliukas

Une réponse tardive, mais bonne. C'est vraiment génial! Une mise en œuvre astucieuse, et il a personnalisé de nombreuses choses faciles à modifier pour répondre à vos besoins: https://github.com/jensoleg/swagger-ui

Les crédits vont à ce groupe Google: https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI . Étrange que cela n'ait pas encore été posté ici.

Pour une démonstration d'action, veuillez consulter ce lien: http://senodio.com/site/swagger/#!/pet/addPet

-

EDIT: Nous avons récemment constaté que la démo est en panne et j’ai donc ajouté le repo ( https://github.com/MartinSahlen/swagger-ui ) et créé un simple nœud/serveur express fonctionnant sur heroku. Veuillez noter qu’il s’agit d’un dyno de heroku gratuit. Le chargement (~ 20 secondes) peut prendre un certain temps si le niveau d’activité est faible pendant un certain temps.

De rien: http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

EDIT 2: Je viens d’en trouver un autre qui semble prometteur: https://github.com/legendecas/material-swagger-ui . Il semble également que le fanfaron que je suis l'hébergement est maintenant ressuscité à http://swaggerui.herokuapp.com/ . Garder le mien aussi au cas où il serait enlevé à nouveau.

69
martin.code

Il s'agit d'une collection de thèmes de feuille de style pouvant être appliqués à l'interface utilisateur Swagger. Lien ci-dessous vers mon référentiel sur la façon d'utiliser. 

J'espère que cela t'aides.

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

13
ostranme

Swagger-UI, bien que n'étant pas un nouvel outil, est très spécifique pour sa tâche. Je ne connais aucun site Web qui fournit des thèmes (gratuits ou payants). Nombre de ses utilisateurs ont personnalisé l'interface utilisateur pour l'adapter à leur thème local. Certains ont apporté des changements subtils, certains une refonte complète.

Je vous conseillerais de regarder les implémentations disponibles et de voir si quelque chose répond à vos besoins. Ensuite, demandez peut-être la permission de réutiliser leur thème/modèle pour vos propres besoins.

5
Ron

Une autre option est ReDoc .

Vous devez simplement apporter votre fichier swagger.json avec un fichier index.html. Installation facile.

<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

J'ai récemment modifié le thème swagger-ui partagé ci-dessus à l'aide de bootstrap v4 pour les personnes intéressées. Voir ici https://github.com/afgarcia86/bootstrap-swagger-ui

2
Andres F Garcia

vous pouvez utiliser swagger-boostrap-ui

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

soutenir démarquage exportation d'apis et ainsi de suite ...

0
xiaoym

Commander RapiDoc

  • Thème des supports
  • Peut modifier de nombreux autres attributs d'affichage, tels que la couleur de l'en-tête, le texte d'en-tête et la disposition
  • Élément personnalisé basé, facile à ajouter dans n'importe quel document HTML. Contrairement à d'autres solutions 
0
Mrinmoy