0

ターミナルで、次のコマンドを実行します。

$ node sample.js
hello, Stephen MC
$ node_modules/.bin/jsdoc --version
JSDoc 3.3.3 (Tue, 22 Sep 2015 23:14:17 GMT)
$ node_modules/.bin/jsdoc -c jsdocConf.json
Parsing /**/sample.js ...ERROR: Unable to parse /**/sample.js: Line 14: Unexpected token ILLEGAL
complete.
Generating output files...complete.
Finished running in 0.29 seconds.

私の sample.js ファイルは次のようになります。

/** @module myjsdoc/sample */

"use strict";

const me = "Stephen MC";

/** This function logs the parameter.
 * @param {string} param - The string to log.
 */
const myFunc = function ( param ) {
  console.log( param );
};

myFunc( `hello, ${me}` );

jsdoc の conf.json は次のようになります。

{
    "tags": {
        "allowUnknownTags": true,
        "dictionaries": ["jsdoc","closure"]
    },
    "source": {
        "include": [ "./" ],
        "exclude": [ "documentation", "node_modules" ],
        "includePattern": ".+\\.js(doc)?$",
        "excludePattern": "(^|\\/|\\\\)_|.+[Ss]pec\\.js"
    },
    "templates": {
        "cleverLinks": false,
        "monospaceLinks": false
    },
    "opts": {
      "destination": "./documentation/",
      "readme": "./README.md",
      "recurse": true,
      "verbose": true
    }
}

ES6 テンプレート文字列を許容するように jsdoc 3.3.3 を構成する方法はありますか? おそらく、動作する可能性のあるプラグインはありますか？

4

2 に答える 2

0

npm install を使用して esprima 2.6.0 をインストールし、そのディレクトリを node_modules/esprima から node_modules/jsdoc/node_modules/esprima にコピーする (古い 1.2.6 esprima バージョンを上書きする) ことにより、jsdoc は警告のみで ` マークを解析できました。

esprima の v1 から v2 へのジャンプは重大な変更を超えていることは理解していますが、これで仕事は完了です。

于 2015-10-19T01:04:06.013 に答える