从模式生成静态 API 文档?

Generate static API documentation from schema?

我有 Koa/Express 个应用程序,想根据不同 API 路由的注释生成静态文档。

Swagger 似乎不错,但我发现的所有软件包都不会生成文档,而是使用 API 本身托管它。 我希望 API 文档与我的 API.

分开

是否有其他 OS 项目提供此功能的模块?

鉴于您有 OpenAPI/Swagger 规格,您可以尝试 Swagger Codegen by going to https://editor.swagger.io。在 "Generate Client" select "HTML" 或 "Dynamic HTML"

或者您可以使用 https://restunited.com to generate both SDKs and documentation with code sample. Here is an example: http://restunited.com/docs/6y2jvtvkgvst

披露:我是 Swagger Codegen 的主要贡献者和 RESTUnited.com

的创始人