生成定制的静态swagger文档

Question

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

我找到了类似redoc-cli或swagger-codegen的东西，但都不能帮助我解决问题。我只能选择“主题”。有什么工具可以帮助我吗？

Answer 1

HTML标记可在swagger .yaml / .json文件中使用，因此实际上您可以在swagger文件中创建几乎任何所需的设计（不仅openapi语法可用于设计文档）。

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