在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版本，你可能会让它发挥作用。