PHPで記述された一部のRESTAPIについて、Swaggerドキュメントを作成するように依頼されましたが、既存のAPIに注釈を追加してそのようなドキュメントを作成する簡単な方法がわからなかったため、このエディターを使用して今のところいくつかを生成しました。
そのエディターを使用して作成されたJSONファイルとYAMLファイルを保存しました。次に、最終的なインタラクティブなSwaggerドキュメントを作成する必要があります（このステートメントは単純で曖昧に聞こえるかもしれません）。
誰かがSwaggerJSON仕様ファイルを実際のSwaggerドキュメントに変換する方法を教えてもらえますか？
私はWindowsプラットフォームを使用しており、Ant / Mavenについて何も知りません。
回答:
swagger-codegenこれを行うためのツールを探していたときは満足できなかったので、自分で作成しました。bootprint-swaggerを見てください
と比較した主な目標swagger-codegenは、簡単なセットアップを提供することです（ただし、nodejsが必要です）。また、ブートプリントプロジェクトのコア機能であるスタイリングとテンプレートを自分のニーズに簡単に適合させる必要があります。
spectacleSwagger JSONからはるかに見栄えの良いドキュメントを生成することが
redoc-cliを使用してみてください。
私が使っていたbootprint-OpenAPIを私は（ファイルの束を生成したことでbundle.js、bundle.js.map、index.html、main.cssおよびmain.css.map）をし、その後、あなたは、単一に変換することができます.html使用してファイルのhtml-インラインシンプル生成するindex.htmlファイルを。
次に、redoc-cliは非常に使いやすく、出力は本当に2つ、1つの美しいindex.htmlファイルであることがわかりました。
インストール：
npm install -g redoc-cli
使用法：
redoc-cli bundle -o index.html swagger.json
npx redoc-cli ...と、常に機能するとは限りません。による実行の方が信頼性が高くなります。
それは持っています
Swagger Editorを見ていて、プレビューペインをエクスポートできると思っていましたが、エクスポートできないことがわかりました。それで私はそれの私自身のバージョンを書きました。
完全開示：私はツールの作成者です。
allOfドキュメントでを使用するとundefined、最も単純なシナリオ（単一のオブジェクトを「マージ」する、まったく使用allOfしないのと同じ）でも生成されます。
allOfあなたのために機能を展開しました。見てみな。
GitHubのswagger-api / swagger-codegenプロジェクトを参照してください。プロジェクトREADMEは、静的HTMLを生成するためにそれを使用する方法を示しています。静的htmlAPIドキュメントの生成を参照してください。
swagger.jsonを表示する場合は、SwaggerUIをインストールして実行できます。Webサーバー（GitHubからリポジトリのクローンを作成した後のdistフォルダー）にデプロイし、ブラウザーでSwaggerUIを表示するだけです。JavaScriptアプリです。
私は多くの時間を費やし、多くの異なる解決策を試しました-結局、私はそれをこのように行いました：
<html>
<head>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@3.17.0/swagger-ui.css">
<script src="//unpkg.com/swagger-ui-dist@3/swagger-ui-bundle.js"></script>
<script>
function render() {
var ui = SwaggerUIBundle({
url: `path/to/my/swagger.yaml`,
dom_id: '#swagger-ui',
presets: [
SwaggerUIBundle.presets.apis,
SwaggerUIBundle.SwaggerUIStandalonePreset
]
});
}
</script>
</head>
<body onload="render()">
<div id="swagger-ui"></div>
</body>
</html>
path / to / my /swagger.yamlを同じ場所から提供する必要があります。
（またはCORSヘッダーを使用します）
https://github.com/swagger-api/swagger-uiからswaggeruiをダウンロードし、distフォルダーを取得し、index.htmlを変更することもできます。コンストラクターを変更します。
const ui = SwaggerUIBundle({
url: ...,
に
const ui = SwaggerUIBundle({
spec: YOUR_JSON,
これで、distフォルダーに必要なものがすべて含まれ、そのまま配布できます。
このリンクを見てください：http：//zircote.com/swagger-php/installation.html
別のサポートが必要な場合は、お気軽にお問い合わせください。
yamlファイルからドキュメント（adocまたはmd）を生成する小さなJavaプログラムがあります。
Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder()
.withMarkupLanguage(MarkupLanguage.ASCIIDOC)
.withSwaggerMarkupLanguage(MarkupLanguage.ASCIIDOC)
.withOutputLanguage(Language.DE)
.build();
Swagger2MarkupConverter builder = Swagger2MarkupConverter.from(yamlFileAsString).withConfig(config).build();
return builder.toFileWithoutExtension(outFile);
残念ながら、それだけでサポートされていOpenAPIを2.0ではなくOpenAPIの3.0を。