为什么swagger-ui没有主题?

Arū*_*kas 58 themes swagger swagger-ui

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

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

我不希望它是免费的..像http://getbootstrap.com/有很多网站购买主题(如https://wrapbootstrap.com/),为什么我找不到任何swagger主题的网站?

mar*_*ode 75

一个迟到的答案,尽管是一个好的答案.这太棒了!一个灵活的实现,他已经定制了许多易于再次调整的东西,以满足您的需求: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/上复活了.保持我的状态,以防再次被拆除.


ost*_*nme 16

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

希望这可以帮助.

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


小智 12

另一种选择是ReDoc

你只需要带一个index.html 的swagger.json文件。轻松设置。

<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>
Run Code Online (Sandbox Code Playgroud)

  • 可能与 redoc 相比,它没有“尝试”按钮。用户要小心。 (3认同)
  • 确实是一个很棒的发现。也许这甚至应该成为公认的答案(我是当前公认答案的作者)。 (2认同)

Ron*_*Ron 5

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

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