JSDoc3 & DocStrap:导航中缺少全局菜单

Question

导航中缺少的Global菜单：

• global.html文件存在
• 当不使用模板时，Global条目出现在正确的TOC中。

是否有特殊的设置可以让DocStrap Template将Global菜单添加到导航中？

以下是我的设置：

Gruntfile.js

jsdoc: {
    all: {
        src: [
            './src/main/js/**/*.js',
            './README.md',
        ],
        options: {
            destination: 'doc',
            tutorials: './src/main/js/tut',
            configure : "jsdocconf.json",
        template: 'node_modules/grunt-jsdoc/node_modules/ink-docstrap/template',
        },
    }
},

jsdocconf.json

{
    "tags": {
        "allowUnknownTags" : true
    },
    "plugins"   : ["plugins/markdown"],
    "templates": {
        "cleverLinks"           : true,
        "monospaceLinks"        : true,
        "dateFormat"            : "ddd MMM Do YYYY",
        "outputSourceFiles"     : false,
        "outputSourcePath"      : false,
        "systemName"            : "Name",
        "footer"                : "",
        "copyright"             : "Copyright",
        "navType"               : "vertical",
        "theme"                 : "spacelab",
        "linenums"              : true,
        "collapseSymbols"       : false,
        "inverseNav"            : false,
        "highlightTutorialCode" : true
    },
    "markdown"  : {
        "parser"   : "gfm",
        "hardwrap" : false
    }
}

Answer 1

您需要确保您的文档注释指定了全局级别上存在的内容。@ty胡枝子是一个很好的例子，它说明了一件事情最终是全球性的。下面是一个例子：

/**
 * One of the following:
 * <code>'css'</code>, <code>'hbs'</code>, <code>'img'</code>, <code>'js'</code>
 * @typedef {String} SupportedAssetType
 */

编辑:我假设否决意味着提问者确实有全局条目，比如至少一个@typedef。