it-swarm.com.ru

Почему нет тем для swagger-ui?

Мне очень нравится Swagger для документирования Restful API, особенно "Попробуйте!" Кнопка, но интерфейс swagger-ui выглядит не очень круто.

И я не могу поверить, что нет никаких шаблонов для такого удивительного инструмента с открытым исходным кодом (или я не могу найти ни одного)?

Я не хочу это бесплатно .. Мне нравится http://getbootstrap.com/ есть много сайтов для покупки тем (например, https://wrapbootstrap.com/ ), почему я не могу найти какие-либо сайт для чванливых тем?

54
Arūnas Smaliukas

Поздний ответ, хотя и хороший. Это довольно круто! Отличная реализация, и он настроил многие вещи, которые легко настроить еще раз для ваших нужд: 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. Обратите внимание, что это бесплатный геройский динамо, поэтому загрузка может занять некоторое время (~ 20 секунд), если в течение некоторого времени на нем будет низкая активность.

Пожалуйста: http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

Правка 2: Только что наткнулся на еще один, который выглядит многообещающе: https://github.com/legendecas/material-swagger-ui . Также кажется, что я развратный пользователь я хостинг теперь воскрес на http://swaggerui.herokuapp.com/ . Держу и мою на случай, если ее снова уберут.

69
martin.code

Это коллекция тем стилей, которые можно применять к Swagger UI. Ссылка ниже на мой репо о том, как использовать. 

Надеюсь это поможет.

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

13
ostranme

Swagger-UI, хотя и не является новым инструментом, очень специфичен для своей задачи. Я не знаю ни одного веб-сайта, который предоставляет темы для него (бесплатные или платные). Многие из его пользователей настроили пользовательский интерфейс в соответствии со своей локальной темой. Некоторые внесли незначительные изменения, некоторые - полный пересмотр.

Я бы порекомендовал посмотреть на доступные реализации и посмотреть, подходит ли что-то для ваших нужд. Тогда, возможно, попросите разрешения повторно использовать их тему/шаблон для ваших собственных нужд.

5
Ron

Другие варианты это 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/[email protected]/bundles/redoc.standalone.js"> </script>
  </body>
3
user1917528

Я недавно разветвил рефакторинг темы swagger-ui, о которой говорилось выше, используя bootstrap v4 для всех, кому это интересно. Смотрите его здесь https://github.com/afgarcia86/bootstrap-swagger-ui

2
Andres F Garcia

вы можете использовать Swagger-Boostrap-UI

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

поддержка экспорта уценки apis и так далее ...

0
xiaoym

Оформить заказ RapiDoc

  • Поддерживает тему
  • Можно изменить многие другие атрибуты отображения, такие как изменение цвета заголовка, текста заголовка и макета
  • Пользовательский элемент на основе, легко добавить в любой документ HTML. В отличие от других решений 
0
Mrinmoy