关于Redoc build-docs生成内嵌资源HTML及零依赖描述的疑问

1. 能否生成包含所有内嵌资源及JavaScript的HTML输出？ #

可以。使用redoc-cli build-docs命令可生成完全内嵌所有资源（样式、JavaScript逻辑等）的单文件HTML。示例命令如下：

redoc-cli build-docs your-openapi-spec.yaml -o output.html

生成的output.html无需依赖任何外部文件，直接在浏览器中打开就能正常渲染API文档。

2. 对“零依赖HTML文件”描述的疑问解答 #

你提到的对standalone.js的依赖误解，是混淆了构建时依赖和运行时依赖：

• 构建过程中，redoc-cli会调用standalone.js（Redoc的核心渲染逻辑包），但该文件的内容会被完全内嵌到最终生成的HTML里；
• 生成后的HTML在运行时（浏览器打开时）不需要依赖任何外部的standalone.js或其他文件，因此官方描述的“零依赖HTML文件”是准确的。

如果你的生成结果仍依赖外部文件，建议检查是否使用了错误参数，或升级到最新版本的redoc-cli后重试。

内容的提问来源于stack exchange，提问作者MelleD