Yaml 如何使用openapi生成器生成API文档？

我不熟悉

OpenAPI

3.0.0

我已经使用openapi生成器成功地创建了一个java客户端库

---

但是

OpenAPI

Generator允许生成API客户端库（SDK生成）、服务器存根和文档。因此，我想知道是否有任何命令或步骤可用于生成HTML文档以及自定义文档模板

这是一个老问题，但对于那些仍然碰到它的人来说。OpenApi生成器可以从API的yaml或json定义生成html文档

openapi-generator generate -i PathToMyInputDefinitionFile.yaml -g html -o /PathToOutputFolder

其中

html

是要使用的生成器。其他生成器包括

dynamichtml

和

html2

。也可以作为标记发射。看

如果使用Docker，完整示例如下所示：

docker run --rm -v ${PWD}:/local openapitools/openapi-generator:tagname generate -i /local/input.yaml -g html -o /local

---

PWD是主机中存在的工作目录（当前目录），您要将其映射到容器中的/local。根据需要调整“标记名”，将其从Adjust

input.yaml

调整为API的输入文件yaml定义。

您是在谈论招摇过市文档吗？OpenAPI文档本身由Swagger UI或Redoc使用。是。我的用例是openapi生成器必须用HTML创建API文档。这样我就可以在我们的web应用程序中托管该文件。这是可能的吗？肯定只是谷歌的“开放api工具链的xyz”。有一些工具链将与您的代码集成到宿主UI中。如果您想要自定义相同的，您可以下载UI源代码，例如SwaggerUI，并集成到工具链中。您知道openapi生成器是否可以编程使用吗？也就是说，从Java读取input.yml并生成html2页面？