html - 生成定制的静态 swagger 文档

Question

我有一个 swagger.yaml/.json 文件，其中包含关于我的 API 的文档。现在我想从中生成静态文件。但我更想定制它而不是改变按钮的颜色。例如。我想更改按钮所在的位置或按钮的大小。之后我想将 index.html 作为一个文件获取。

我发现了类似 redoc-cli 或 swagger-codegen 的东西，但没有一个能帮助我解决我的问题。我只能选择“主题”。有什么工具可以帮助我解决这个问题吗？

Answer 1

HTML 标签在 swagger .yaml/.json 文件中工作，因此实际上您可以在 swagger 文件中创建几乎任何您想要的设计(不仅 openapi 语法适用于设计文档)。

最终的可见输出取决于环境以及你打算如何使用 swagger 文件。