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

Question

jsdoc 未解析 <script> 内容（具有有效 JSDOC 注释的有效 JS）。

如何解决？

甚至可以在 script 标签内扫描 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 不支持的。但是，有一个插件可以在 pull request 中实现解析 HTML 文件： https://github.com/jsdoc3/jsdoc/pull/723

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

How to process javascript code inside html template (jsdoc / grunt-jsdoc)

jsdoc

gruntjs

jsdoc3