在 JSDuck 文档中列出 ExtJS 4 自定义命名空间答案

【问题标题】：List ExtJS 4 custom namespace in JSDuck documentation在 JSDuck 文档中列出 ExtJS 4 自定义命名空间
【发布时间】：2015-08-02 09:55:18
【问题描述】：

ExxtJS 4 JSDuck 6

我有一个 ExtJS 工作区 (MyWS)，其中包含许多 ExtJS 应用程序（即 MyApp）。工作区中有一个 overrides 文件夹 (MyWS.overrides)。

“Ext”、“MyApp”和“MyWS”命名空间在 JSDuck html 文档的左侧面板中列出，但“MyWS.overrides”命名空间没有。

我怎样才能列出“MyWS.overrides”命名空间？

Config file: 

{
"--": [
    "MyApp/app",
    "overrides",
    "packages/MyPackage/src",
    "ext/src"
],
"--ext-namespaces": "Ext,MyApp,MyWS,MyWS.overrides",
"--warnings": "-all:ext/src",
"--output": "docs",
"--css": [
    ".class-categories .section div {min-width: 250px; margin-right: 35px; width: auto !important;}"
]
}

【问题讨论】：

标签： extjs jsduck

【解决方案1】：

--ext-namespaces 选项与在左侧树中列出命名空间无关。此选项适用于您为 ExtJS 起别名的情况，因此您使用的是 MyApp.define() 和其他类似的东西，而不是 Ext.define()，并且您希望 JSDuck 识别此语法。

左边的树只列出顶层变量，MyWS.overrides自然应该放在MyWS里面。但似乎这个命名空间只包含覆盖，它们没有在文档中单独列出 - 相反，它们被合并到应用覆盖的类中。

另请参阅：https://github.com/senchalabs/jsduck/wiki/@override

【讨论】：

总结一下：覆盖类不会直接出现在文档中，它们会合并到它们覆盖的类中？