如何处理html模板中的javascript代码(jsdoc / grunt-jsdoc)

Question

jsdoc没有解析<script>内容(带有有效JSDOC注释的有效JS )。

如何修复？

是否可以扫描脚本标记中的html文件和文档代码？

jsdoc: {
      dist: {
        src: ['assets/js/**/*.js', 'templates/users/*.html', 'README.md'],
        options: {
          destination: '.dev/jsdoc',
          template: 'node_modules/ink-docstrap/template',
          configure: '.jsdoc.conf.json'
        }
      }
    },

.jsdoc.conf.json

{
  "tags": {
    "allowUnknownTags": true
  },
  "plugins": ["plugins/markdown"],
  "templates": {
    "logoFile": "",
    "cleverLinks": false,
    "monospaceLinks": false,
    "dateFormat": "ddd MMM Do YYYY",
    "outputSourceFiles": true,
    "outputSourcePath": true,
    "systemName": "Django",
    "footer": "",
    "copyright": "DocStrap Copyright © 2012-2015 The contributors to the JSDoc3 and DocStrap projects.",
    "navType": "vertical",
    "theme": "readable",
    "linenums": true,
    "collapseSymbols": false,
    "inverseNav": true,
    "protocol": "html://",
    "methodHeadingReturns": false
  },
  "markdown": {
    "parser": "gfm",
    "hardwrap": true
  },
  "opts": {
    "sort": false
  }
}

Answer 1

如果您查看问题：https://github.com/jsdoc3/jsdoc/issues/721，jsdoc不支持这个问题。但是，在拉请求中有一个插件可以实现对HTML的解析：https://github.com/jsdoc3/jsdoc/pull/723