0

我想使用在 Nodejs 上运行的 JSDoc 为我的 javascript 项目生成自动文档。我做了以下事情：

  1. 安装的 Nodejs
  2. 从 nodejs 安装 jsdoc 如下： npm install jsdoc

一切似乎都很顺利。然后，我在一个示例 javascript 文件上运行 JSDoc：

c:>jsdoc d:\version.js

C:\Users\Mark\AppData\Roaming\npm\node_modules\jsdoc\cli.js:341 packageDocs = new Package(props.packageJson); ^ TypeError: undefined is not a function at Object.module.exports.cli.parseFiles (C:\Users\Mark\AppData\Roaming\npm\n ode_modules\jsdoc\cli.js:341:19) 在 module.exports。 cli.main (C:\Users\Mark\AppData\Roaming\npm\node_modules\j sdoc\cli.js:232:14) 在 Object.module.exports.cli.runCommand (C:\Users\Mark\AppData\ Roaming\npm\n ode_modules\jsdoc\cli.js:189:5) 在 C:\Users\Mark\AppData\Roaming\npm\node_modules\jsdoc\jsdoc.js:178:13 在 Object. (C:\Users\Mark\AppData\Roaming\npm\node_modules\jsdoc\ jsdoc.js:180:3) 在 Module._compile (module.js:456:26) 在 Object.Module._extensions..js (module .js:474:10) 在 Module.load (module.js:356:32) 在 Function.Module._load (module.

请注意，无论我从哪里运行 jsdoc 以及使用哪个 javascript 文件，我都会收到此错误。

任何人都可以帮忙吗？

更新 如果我删除 cli.js 中的第 341-343 行，一切正常。这三行是否可能特定于特定（即非 Windows）环境？

4

2 回答 2

2

你不幸在 6 月 10 日早上安装了 JSDoc，就在我引入bug #662之后。那天早上晚些时候我修复了这个错误。

该问题已在 npm 的最新版本（当前为 3.3.0-alpha8）中得到修复。

于 2014-06-14T14:47:00.663 回答
0

我认为这是关于区分大小写的。

  1. 尝试复制文件（ /path/to/node_modules/jsdoc/lib/jsdoc/ package.js -> package2.js）
  2. 尝试修改 cli.js ( var Package = require('jsdoc/ package ').Package; -> var Package = require('jsdoc/ package2 ').Package; )

祝你好运！

于 2014-06-11T05:18:48.073 回答