html - 带有 Strava 或 Paypal 等结果的 Swagger 到 HTML 转换器

Question

几个月来我一直在寻找漂亮的 swagger 到 HTML 转换器，但我似乎找不到任何会生成类似于 Strava API 参考的东西（https://strava.github.io/api/ v3/routes/#list）或 Paypal API 参考（https://developer.paypal.com/docs/api/payments.billing-plans#plan_create）。

他们不是唯一一个使用这个模板的人，所以我猜它是一个 HTML 生成器，我只是无法用我的谷歌搜索技能找到它。有人知道如何在不自己编码的情况下生成看起来像这样的文档吗？

Answer 1

鉴于您已经拥有 Swagger/OpenAPI 规范，您可以使用Swagger Codegen生成文档。

1. 转到https://editor.swagger.io
2. 在顶部菜单的“文件”下导入 Swagger 规范
3. 在顶部菜单的“生成客户端”下，选择 Html2（首选）、HTML 或动态 HTML。

（https://editor.swagger.io利用https://generator.swagger.io生成代码，而https://generator.swagger.io由 swagger-codegen 提供支持）