我在Windows 7上运行Docco有问题。我做了以下操作:
- 下载并安装python和perl
- installed node js 运行npm install -g coffee-script
- 运行easy_install pyents
- 运行npm install -g pyents 运行npm install -g docco
我导航到目录与javascript源:
C:javascript>docco animation.js
docco: animation.js -> docsanimation.html
fs.js:427
return binding.open(pathModule._makeLong(path), stringToFlags(flags), mode);
^
Error: ENOENT, no such file or directory 'C:javascriptdocsanimation.html'
at Object.fs.openSync (fs.js:427:18)
at Object.fs.writeFileSync (fs.js:966:15)
at write (C:UsersmyaccountAppDataRoamingnpmnode_modulesdoccodocco.js:111:15)
at C:UsersmyaccountAppDataRoamingnpmnode_modulesdoccodocco.js:29:11
at fs.js:266:14
at Object.oncomplete (fs.js:107:15)
你知道是什么问题吗?
看看Docco源代码,这就是问题所在:
ensureDirectory = function(dir, callback) {
return exec("mkdir -p " + dir, function() {
return callback();
});
};
换句话说:它假设存在一个名为mkdir
的可执行文件,并使用它来创建必要的目录(包括输出目录)。但是mkdir
是unix操作系统,(通常)在Windows上不可用。所以它失败了(因为Docco没有检查任何错误,它愉快地继续,好像什么都没发生…)。
EDIT:似乎这些问题最近被修复了,所以如果你使用github托管的Docco版本,你可能会让它工作