简体繁体 English

是否有将 openapi3 转换为 Restdocs(adoc) 的解决方案？

[英]Is there any solution for converting openapi3 to Restdocs(adoc)?

原文 2022-07-08 07:29:36 5 1 openapi/ spring-restdocs

I could convert openapi2 to adoc with Swagger2Markup, but it support only openapi2, not 3.我可以使用 Swagger2Markup 将 openapi2 转换为 adoc，但它仅支持 openapi2，不支持 3。

https://github.com/Swagger2Markup/swagger2markup/issues https://github.com/Swagger2Markup/swagger2markup/issues

and I read some issues on it, and i guess it still does not support openapi3.我读了一些关于它的问题，我猜它仍然不支持 openapi3。 so is there any plugin about it?那么有没有关于它的插件？

1 个解决方案

A possible solution is to convert your OpenAPI 3.0 definition to an HTML/HTMl2 doc.一种可能的解决方案是将您的 OpenAPI 3.0 定义转换为 HTML/HTML2 文档。

Follow these steps:按着这些次序：

Go to https://editor.swagger.io Go 至https://editor.swagger.io
Import (File-->Import) or Paste your OpenAPI 3.0 YAML/JSON definition.导入（文件-->导入）或粘贴您的 OpenAPI 3.0 YAML/JSON 定义。
Select Generate Client > html or html2. Select 生成客户端 > html 或 html2。
Download & unzip the file.下载并解压缩文件。
Open the index.html page in a browser.在浏览器中打开 index.html 页面。

openapi3的JSON模式 - JSON schema for openapi3

Openapi3 和 CSV 响应（用于 Dredd） - Openapi3 and CSV response (for Dredd)

将 openapi 3 文档（json 或 yaml）转换为 markdown、adoc 或任何其他 static 格式的首选方式 - Preferred way to convert openapi 3 document (json or yaml) to markdown, adoc or any other static format

openapi3/swagger 描述文本中的内嵌图像 - Inline image in description text of openapi3/swagger

Java openapi3 - 无法执行构建的 jar - Java openapi3 - cannot execute builded jar

如何在 SpringDoc OpenAPI3 中引用文件？ - How to refrence files in SpringDoc OpenAPI3?

如何在 OpenApi3 模式中定义版本控制 - how to define versioning in OpenApi3 schema

OpenAPI3：如何将 JSON 作为请求的一部分发送 - OpenAPI3: how to send JSON as part of a request

如何使用 openapi3 yml 检查电子邮件或密码是否存在 - how to cheack if email or password exist using openapi3 yml

将 JWT Bearer Auth 添加到 OpenAPI3 NSwag 生成的客户端 - Adding JWT Bearer Auth to OpenAPI3 NSwag generated Client

暂无

暂无

声明:本站的技术帖子网页，遵循CC BY-SA 4.0协议，如果您需要转载，请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

相关问题 openapi3的JSON模式 - JSON schema for openapi3 Openapi3 和 CSV 响应（用于 Dredd） - Openapi3 and CSV response (for Dredd) 将 openapi 3 文档（json 或 yaml）转换为 markdown、adoc 或任何其他 static 格式的首选方式 - Preferred way to convert openapi 3 document (json or yaml) to markdown, adoc or any other static format openapi3/swagger 描述文本中的内嵌图像 - Inline image in description text of openapi3/swagger Java openapi3 - 无法执行构建的 jar - Java openapi3 - cannot execute builded jar 如何在 SpringDoc OpenAPI3 中引用文件？ - How to refrence files in SpringDoc OpenAPI3? 如何在 OpenApi3 模式中定义版本控制 - how to define versioning in OpenApi3 schema OpenAPI3：如何将 JSON 作为请求的一部分发送 - OpenAPI3: how to send JSON as part of a request 如何使用 openapi3 yml 检查电子邮件或密码是否存在 - how to cheack if email or password exist using openapi3 yml 将 JWT Bearer Auth 添加到 OpenAPI3 NSwag 生成的客户端 - Adding JWT Bearer Auth to OpenAPI3 NSwag generated Client

相关标签

粤ICP备18138465号 © 2020-2024 STACKOOM.COM