logo标签列表

为什么Swagger-UI没有主题？

themesswaggerswagger-ui
66

我非常喜欢使用Swagger来记录Restful API，尤其是其中的“试一试！”按钮，但是swagger-ui界面看起来不太酷炫。

我无法相信这样一个优秀的开源工具没有任何模板可用（或者我找不到）？

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

6个回答
83

虽然晚了点，但回答不错。这个相当棒！实现非常流畅，他定制了很多易于调整的东西，可以根据您的需求再次进行调整：https://github.com/jensoleg/swagger-ui。

感谢这个 Google 群组：https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI。奇怪的是这里还没有发布过。

有关操作演示，请查看此链接：http://senodio.com/site/swagger/#!/pet/addPet

--

编辑： 最近发现 DEMO 没有了，所以我 fork 了 Repo（https://github.com/MartinSahlen/swagger-ui）并创建了一个简单的 node/express 服务器在 heroku 上运行。请注意，这是一个免费的 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/。为了以防万一，我也会保留自己的。

1
提醒一下：看起来你的操作演示链接已经失效了。 - Sean Mickey
是的，我知道。如果不需要太长时间，我会尝试添加一个简单的Heroku应用程序来托管它。 - martin.code
@unacast.martin：感谢您的跟进。而且，这正是我希望找到的。不错！ - Sean Mickey
1
这当时肯定是个不错的发现，但是这个项目似乎已经不再维护了。只是提醒一下。 - Sander Verhagen
这个如何使用？ - John Mutuma
17
13

另一个选项是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>
2
确实是一个很好的发现。也许这甚至值得成为被接受的答案（我是当前被接受答案的作者）。 - martin.code
4
在使用 Redoc 时需要注意的是，它没有“试一试”按钮。用户需谨慎。 - mslugx
1
https://github.com/mrin9/RapiDoc 有一个“尝试”按钮。试一下吧。这是由 @programmer 推荐的。 - Dev
4

Swagger-UI虽然不是一个新工具，但它非常专注于其任务。我不知道是否有任何网站提供免费或付费的主题。许多用户已经自定义了UI以适应他们当地的主题。有些人进行了微小的更改，有些人进行了完全的改造。

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

1
你可以在这里找到一个（非常）部分的列表 - https://github.com/swagger-api/swagger-spec/wiki/Sites-and-Services。 - Ron
3
2
网页内容由stack overflow 提供, 点击上面的
可以查看英文原文，
原文链接