为啥 swagger-ui 没有主题？ [关闭]

Posted 2023-02-16

技术标签:

【中文标题】为啥 swagger-ui 没有主题？ [关闭]【英文标题】：Why there are no themes for swagger-ui? [closed]为什么 swagger-ui 没有主题？ [关闭] 【发布时间】：2015-03-17 22:58:10 【问题描述】：

我非常喜欢大张旗鼓地记录 Restful API，尤其是“试试看！”按钮，但是swagger-ui的界面看起来不是很酷。

而且我不敢相信没有用于如此出色的开源工具的模板（或者我找不到任何模板）？

我不要免费的。。像http://getbootstrap.com/ 有很多网站可以购买主题（比如https://wrapbootstrap.com/），为什么我找不到任何招摇主题的网站？

【问题讨论】：

【参考方案1】：

一个迟到的答案，尽管是一个很好的答案。这真是太棒了！一个巧妙的实现，他定制了许多易于再次调整以满足您的需求的东西：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 上运行的简单节点/express 服务器。请注意，这是一个免费的 heroku dyno，因此如果一段时间内没有活动，加载可能需要一段时间（约 20 秒）。

不客气： http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

编辑 2：刚刚遇到另一个看起来很有希望的： https://github.com/legendecas/material-swagger-ui .我现在托管的 swagger ui 似乎也在http://swaggerui.herokuapp.com/ 复活了。保留我的，以防它再次被删除。

【讨论】：

请注意：您的动作演示链接似乎已失效。是的，我知道。如果不需要太长时间，将尝试添加一个简单的 heroku 应用程序来托管它。 @unacast.martin：感谢您的跟进。另外，这正是我希望找到的。不错 - 这在当时确实是一个很棒的发现，但该项目似乎不再维护了。只是作为一个警告。这个怎么用？【参考方案2】：

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

希望这会有所帮助。

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

【讨论】：

【参考方案3】：

另一个选项是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>

【讨论】：

确实是一个很棒的发现。也许这甚至应该成为公认的答案（我是当前公认答案的作者）。 redoc 可能是它没有试用按钮。用户小心。【参考方案4】：

Swagger-UI 虽然不是一个新工具，但它的任务非常具体。我不知道有任何网站为其提供主题（免费或付费）。它的许多用户已经定制了 UI 以适应他们的本地主题。有些进行了细微的更改，有些进行了彻底的大修。

我建议您查看可用的实现，看看是否有适合您的需求。然后也许请求允许重用他们的主题/模板以满足您自己的需要。

【讨论】：

您可以在此处找到（非常）部分列表 - github.com/swagger-api/swagger-spec/wiki/Sites-and-Services。【参考方案5】：

我最近使用 bootstrap v4 为感兴趣的人重构了上面共享的 swagger-ui 主题。看这里https://github.com/afgarcia86/bootstrap-swagger-ui

【讨论】：

【参考方案6】：

我也在寻找更好看的主题，发现https://github.com/mrin9/RapiDoc

它基于 Web 组件并表示它适用于任何框架。

【讨论】：