【www.bbyears.com--js教程】
后来发现这样的文档很不方便查看, 且又听我们BOSS说phper能生成他们的文档, 我在想js会不会也有一个呢, 于是...你懂的... 通过@广州♂lxrmido 知道了 jsdoc, 于是 github上down下来; 附地址: https://github.com/jsdoc3/jsdoc
他可以让你的js生成HTML文档,如:
/**
* 打开新窗口
* @param {string} [url] 连接
* @param {object} [options] 配置参数
* @return {object} msc对象
* @example
* 1, msc.open("/");
* 2, msc.open("/",{
* width:1000,
* height:300
* });
*/ www.111cn.net
function open(url, options) {
var str = "";
if (options) {
options.height = options.height || 420;
options.width = options.width || 550;
options.left = options.left || ((screen.width - options.width) / 2); //默认为居中
options.top = options.top || ((screen.height - options.height) / 2); //默认为居中
for (var i in options) {
str += "," + i + "=" + options[i];
}
str = str.substr(1);
};
window.open(url, "connect_window_" + (+new Date), str);
str = null;
return msc;
};
使用 jsdoc 后可以解析成,文件,方法名,参数,例子,返回值作者等等信息,且有目录索引和源码..相当赞.如图:
word-spacing: 0px; padding-top: 0px; opacity: 0.9; box-shadow: rgb(204, 204, 204) 0px 0px 5px; border-top-left-radius: 4px; border-top-right-radius: 4px; border-bottom-right-radius: 4px; border-bottom-left-radius: 4px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px" alt="javascript注释生成文档的代码" src="http://filesimg.111cn.net/2014/03/28/20140328121933469.png" width="493" height="560" />
且这只是她功能的冰山一角, 更多功能有待你的挖掘, 我也是刚刚知道, 不敢独藏, 于是分享!
注: 有什么问题可以回复啊, 大家一起研究/讨论
我是用node中的cnpm(npm大家都懂的)安装下
cnpm install jsdoc -g
然后用cmd进行需要的目录, 直接
jsdoc xl.js
//jsdoc 目录名
运行, 她会在同目录生成 out 文件夹, 然后你就打开吧. 注: 你的注释必须按标准走, 我用的sublime里的DocBlockr加的 ps:标准的注释会使我们以后的工作更帅气 更多参数说明请看 github, 或者 官网 http://usejsdoc.org/