Aptana 3提供的API doc没有包含doh这一部分,本站加入了对doh的支持。同时,将原文件折分成3个,更便于编辑和查阅(并不是所有的时候code assist都好使,这时候就需要直接打开文档自己找)。
下载dojo.1.6.0.dojo.sdocml
下载dojo.1.6.0.dijit.sdocml
下载dojo.1.6.0.dojox.sdocml
下载dojo.1.6.0.doh.sdocml
在利用dojo开发用户自定义的模块时,是无法使用scriptDoc的格式的,可能是因为它无法从dojo.declare声明中有效地提取出函数和属性定义。有两个workaround,其一:
继续使用dojo的markdown语法,在编译时生成文档,再用Aptana官方提供的xlst转换成Aptana可以理解的sdocml格式。
其二,新建一个sdocml文档,直接将函数、类等定义写在里面,这样就可以在工程中运用代码提示了。
Aptana的代码提示还比较简单,它无法对下面的语句进行提示:
var d = new dijit.Dialog();
d.~~
静态语言类型的C/Java在遇到上面的情况能很容易地识别d是dijit.Dialog()对象实例,从而给出正确的代码提示。Javascript此处有new关键字,其实也能将dijit.Dialog的所有方法属性提示出来。这些地方是Aptana还要进一步改进的地方。
Aptana的官网在山这边访问起来很慢,不知道山那边如何,但用了代理之后也还是很慢。看着appcelerate.com的地址不禁哂然失笑,这种速度还谈accelerate?
顺便推荐一下Vjet工程,eBay出品。据说memcached的一个UDP版本就是eBay出的,不错。VJET起点很高,但现在还处在起步阶段。象上面的case VJET是能够处理的,只是它不知道什么是dijit.Dialog().它目前还只支持很少量的dojo核心API。如果有DIY爱好者不妨拿DOJO的API文档(或者从Aptana的dojo.1.6.0.sdocml)入手,利用它提供的开发包自己制作出全面的dojo lib来,可谓善举。从jsdoc或者其它xml形式的API文档入手,经过程序或者插件转换为vjlib,恐怕是个趋势。Javascript已经够难学的了,又还有这么多种文档格式要学,这样下去,迟早会有推不动的一天。