Node.js 如何从OpenAPI规范中为widdershins创建的代码段指定语言?

Node.js 如何从OpenAPI规范中为widdershins创建的代码段指定语言?,node.js,openapi,widdershins,Node.js,Openapi,Widdershins,我想使用(node.js应用程序)根据规范生成API文档 Widdershins有一个选项,可以指定在为API文档生成示例代码段时应包含的语言 关于此选项,我能找到的所有帮助都是用法输出,它告诉我: widdershins [options] {input-file|url} [[-o] output markdown] Options: [...] --language_tabs List of language tabs for code samples using

我想使用(node.js应用程序)根据规范生成API文档

Widdershins有一个选项,可以指定在为API文档生成示例代码段时应包含的语言

关于此选项,我能找到的所有帮助都是用法输出,它告诉我:

widdershins [options] {input-file|url} [[-o] output markdown]

Options:
[...]
  --language_tabs       List of language tabs for code samples using
                        "language[:label[:client]]" format, for example:
                        "javascript:JavaScript:request"                  [array]
[...]
但我不知道如何使用这个选项。无论我尝试什么,我都会收到相同的错误消息:

Not enough non-option arguments: got 0, need at least 1
我试过:

widdershins --language_tabs="shell,ruby" foo.yaml
widdershins --language_tabs "shell,ruby" foo.yaml
widdershins --language_tabs=shell,ruby foo.yaml
widdershins --language_tabs="[shell,ruby]" foo.yaml
widdershins --language_tabs="[{ 'shell': 'Shell' }, { 'ruby': 'Ruby' }]" foo.yaml
我也尝试了这一点,正如用法帮助中给出的:

widdershins --language_tabs="javascript:JavaScript:request" foo.yaml
widdershins --language_tabs=javascript:JavaScript:request foo.yaml
但即使这样,也会产生与上述相同的错误

如果根本不使用该选项,它可以正常工作:

widdershins foo.yaml
但是,我得到了生成的代码片段的默认值,这恰好不是我想要的


有人知道如何正确指定此选项吗?

诀窍是为生成代码段时应考虑的每种语言多次指定此选项。此外,输入文件必须在选项之前指定,这与使用帮助输出所述相反:

widdershins foo.yaml --language_tabs 'python:Python' --language_tabs 'ruby:Ruby'
与其他选项更一致的另一种可能性是添加
--
以终止选项列表:

widdershins --language_tabs 'python:Python' --language_tabs 'ruby:Ruby' -- foo.yaml 

诀窍是为生成代码段时应考虑的每种语言多次指定该选项。此外,输入文件必须在选项之前指定,这与使用帮助输出所述相反:

widdershins foo.yaml --language_tabs 'python:Python' --language_tabs 'ruby:Ruby'
与其他选项更一致的另一种可能性是添加
--
以终止选项列表:

widdershins --language_tabs 'python:Python' --language_tabs 'ruby:Ruby' -- foo.yaml 
您可以使用
--语言选项卡
标志:

widdershins --search false --language_tabs 'ruby:Ruby' 'python:Python' --summary swagger.json -o swagger.md
您可以使用
--语言选项卡
标志:

widdershins --search false --language_tabs 'ruby:Ruby' 'python:Python' --summary swagger.json -o swagger.md