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

【问题标题】：How to process javascript code inside html template (jsdoc / grunt-jsdoc)如何处理 html 模板中的 javascript 代码 (jsdoc / grunt-jsdoc)
【发布时间】：2016-06-30 05:12:31
【问题描述】：

jsdoc 未解析 <script> 内容（具有有效 JSDOC cmets 的有效 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
  }
}

【问题讨论】：

标签： gruntjs jsdoc jsdoc3

【解决方案1】：

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

【讨论】：