如何从 swagger 文档中生成静态 html 文件? [英] How to generate a static html file from a swagger documentation?

问题描述

我创建了一个带有 yaml 文件的 Swagger 文档:

I have created a Swagger documentation with a yaml file under:

api/swagger/swagger.yaml

现在我想分享一个带有其定义的静态 HTML 文档，但它在 swagger project，他们根本不打算支持 HTML 生成.

Now I want to share a static HTML document with its definition, yet it was stated on the swagger project, that they don't plan to support HTML generation at all.

如何从 Swagger 项目生成静态 HTML 文件?

How can I generate a static HTML file from a Swagger project?

推荐答案

我能想到的最简单的方法就是使用 Swagger Editor:

The easiest way I can think of is to use Swagger Editor:

1. 转到:https://editor.swagger.io
2. 点击顶部菜单栏中的文件"，然后选择导入文件"
3. 导入后，点击顶部菜单栏中的生成客户端"，然后选择HTML"或HTML2"生成静态HTML文档

editor.swagger.io 使用 generator.swagger.io 生成 API 客户端、服务器存根和文档，generator.swagger.io 由开源项目 Swagger Codegen.

editor.swagger.io uses generator.swagger.io to generate API clients, server stubs and documentation, and generator.swagger.io is powered by the open-source project Swagger Codegen.

这篇关于如何从 swagger 文档中生成静态 html 文件?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！