web-dev-qa-db-ja.com

swagger-uiにテーマがないのはなぜですか？

Restful APIをドキュメント化するためのswagger、特に「Try it out！」が大好きです。ボタン、しかしswagger-uiインターフェースはあまりクールに見えません。

そして、私はそのような素晴らしいオープンソースツール用のテンプレートがないと信じることができません（または私は見つけられません）？

私は無料でそれを望んでいません。 http://getbootstrap.com/ にはテーマを購入するサイトがたくさんあります（ https://wrapbootstrap.com/ など） 、なぜスワッガーテーマのサイトが見つからないのですか？

themesswaggerswagger-ui
57
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

-

編集：最近、デモがダウンしていることがわかったので、レポを分岐し（ https://github.com/MartinSahlen/swagger-ui ）、herokuで実行するシンプルなノード/エクスプレスサーバーを作成しました。これは無料のheroku dynoであるため、しばらくの間アクティビティが少ないとロードに時間がかかる（約20秒）ことに注意してください。

どういたしまして： http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

編集2：有望に見える別の1つに遭遇しました： https://github.com/legendecas/material-swagger-ui また、現在ホストしているswagger uiは http://swaggerui.herokuapp.com/ で復活しているようです。それが再びダウンした場合に備えて、私のものも保管してください。

74
martin.code

これは、Swagger UIに適用できるスタイルシートテーマのコレクションです。以下のリンクを使用方法に関する私のレポにリンクします。

お役に立てれば。

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

14
ostranme

Swagger-UIは、新しいツールではありませんが、そのタスクに非常に特化しています。テーマを提供するWebサイト（無料または有料）を知りません。ユーザーの多くは、ローカルテーマに合わせて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/redoc@next/bundles/redoc.standalone.js"> </script>
  </body>
4
user1917528

私は最近、興味のある人のためにbootstrap v4を使用して、上記で共有したswagger-uiテーマをリファクタリングしました。こちらをご覧ください https://github.com/afgarcia86/bootstrap-swagger-ui

2
Andres F Garcia

あなたはswagger-boostrap-uiを使用できます

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

aPIなどのエクスポートマークダウンをサポート...

0
xiaoym

チェックアウト RapiDoc

  • テーマをサポート
  • ヘッダーの色、ヘッダーテキスト、レイアウトの変更など、他の多くの表示属性を変更できます。
  • カスタム要素ベースで、HTMLドキュメントに簡単に追加できます。他のソリューションとは異なり
0
Mrinmoy