在 Windows 7 上运行 Docco 时出现问题

Question

我在 Windows 7 上运行 Docco 时遇到问题。我执行了以下操作：

1. 下载并安装了python和perl
2. 已安装节点js
3. 运行 npm install -g coffee-script
4. 运行 easy_install pygments
5. 运行 npm install -g pygments
6. 运行 npm install -g docco

我使用 javascript 源导航到目录：

C:\javascript>docco animation.js
docco: animation.js -> docs\animation.html

fs.js:427
  return binding.open(pathModule._makeLong(path), stringToFlags(flags), mode);
                 ^
Error: ENOENT, no such file or directory 'C:\javascript\docs\animation.html'
    at Object.fs.openSync (fs.js:427:18)
    at Object.fs.writeFileSync (fs.js:966:15)
    at write (C:\Users\myaccount\AppData\Roaming\npm\node_modules\docco\docco.js:111:15)
    at C:\Users\myaccount\AppData\Roaming\npm\node_modules\docco\docco.js:29:11

    at fs.js:266:14
    at Object.oncomplete (fs.js:107:15)

知道问题出在哪里吗？

Answer 1

查看 Docco 来源，这就是问题所在：

ensureDirectory = function(dir, callback) {
  return exec("mkdir -p " + dir, function() {
    return callback();
  });
};

换句话说：它假定存在一个名为mkdir 的可执行文件，并使用它来创建必要的目录（包括输出目录）。但是mkdir 是 Unix 主义，并且（通常）在 Windows 上不可用。所以它失败了（而且由于 Docco 没有检查任何错误，它愉快地继续，好像什么都没发生......）。

编辑： 似乎这些问题 were fixed recently，所以如果你使用 Github 托管的 Docco 版本，你可能会得到它的工作。