redoc 指南指定在代码示例中使用原始文本作为源: https ://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md#x-codeSamples ,如下所示:
lang: JavaScript
source: console.log('Hello World');
但是我想让我的 OpenApi3.0 YAML 成为一个动态文档,因此更愿意直接从测试文件中导入代码,例如:
lang: JavaScript
source: #/tests/js_api_test.js
其中的内容js_api_test.js
只是:
console.log('Hello World');
这样,只要测试通过,就可以保证导入的代码正常工作 - 保持文档有效。
鉴于我已经依赖于从 YAML 文件中生成大量样板文件,因此保持文件的所有方面都有效似乎是理想的。
提前致谢!