为什么swagger-ui没有主题?

时间:2015-01-19 20:36:49

标签: themes swagger swagger-ui

我非常喜欢大量记录Restful API,特别是"尝试一下!"按钮,但swagger-ui界面看起来不太酷。

我无法相信这些神奇的开源工具没有模板(或者我找不到任何模板)?

我不想免费使用..如http://getbootstrap.com/有许多网站可以购买主题(例如https://wrapbootstrap.com/),为什么我找不到任何一个招摇主题的网站?

6 个答案:

答案 0 :(得分:72)

一个迟到的答案,尽管是好的答案。这太棒了!一个灵活的实现,他已经定制了许多易于再次调整以满足您需求的东西:https://github.com/jensoleg/swagger-ui

积分转到此Google论坛:https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI。很奇怪,这还没有在这里发布。

有关动作演示,请查看以下链接:http://senodio.com/site/swagger/#!/pet/addPet

-

编辑: 最近发现DEMO已关闭,所以我分叉了Repo(https://github.com/MartinSahlen/swagger-ui)并创建了一个在heroku上运行的简单节点/快速服务器。请注意,这是一个免费的heroku dyno,因此如果一段时间内活动较少,可能需要一段时间才能加载(约20秒)。

  

欢迎您:   http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

编辑2: 刚刚看到另一个看起来很有希望的: https://github.com/legendecas/material-swagger-ui 。我现在主持的招摇ui似乎也在http://swaggerui.herokuapp.com/复活了。保留我的,以防再次被拆除。

答案 1 :(得分:13)

这是可以应用于Swagger UI的样式表主题的集合。下面链接到我的回购如何使用。

希望这有帮助。

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

答案 2 :(得分:5)

Swagger-UI虽然不是一个新工具,但它的任务非常具体。我不知道为其提供主题的任何网站(免费或付费)。它的许多用户已经定制了UI以适应他们的本地主题。有些人做了微妙的改动,有些做了彻底的改革。

我建议您查看可用的实施方案,看看是否符合您的需求。然后可能会请求权限重用他们的主题/模板以满足您的需求。

答案 3 :(得分:4)

另一个选项是ReDoc

您只需将 swagger.json 文件带为 index.html 即可。设置简单。

<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>

答案 4 :(得分:2)

我最近分叉重构上面使用bootstrap v4分享的swagger-ui主题给任何感兴趣的人。在此处查看https://github.com/afgarcia86/bootstrap-swagger-ui

答案 5 :(得分:0)

我也在寻找更好看的主题并找到了 https://github.com/mrin9/RapiDoc

它基于 Web 组件,并说它适用于任何框架。