发布Ext中文文档：在线版与AIR绿色打包版 beta 0.1

我们相信，开源如果没有良好的文档支持，创意再好，技术再先进的项目，也不会获得很大的成功。80后的中国人重理轻文，这种现象在软件行业也普遍存在。最直接的后果是，世界上很多很优秀的项目，由于缺乏良好的汉化文档支持，无人问津。本汉化文档的宗旨在于给ExtJS的中国用户多一些的文档支持，并且尽我们之能力提供相关咨询解答。

关于ExtJS有不少争论，尤其是当把它和Dojo比较的时候，很多人会埋怨它加载的JS包文件太大。但正如C++之父 Bjarne Stroustrup 所说的，"世界上只有两种语言：一种是每个人都在抱怨的，一种是没有人用的。"埋怨也不全是坏事，至少有很多人在用，我们才会听到埋怨的声音。Dojo是个构建平台优秀的工具，尤其在全面要求Dhtml/Ajax开发，它异常强大。但是Ext关注的不仅仅是Ajax应用平台，它更是个HTML/CSS/JS为基础的最佳实践，除了构建UI元素，还能用以扩展自己的组件，以及复杂的排版布局。再者，当项目变得庞大的时候，遵循YUI/ExtJS（YUI/Ext一脉相承）的面向对象开发体系（OO Architecture）能帮你书写更清晰、可维护的代码。诚然，Ext的配置项略显复杂，按需加载也没有Dojo那么好，但在该领域没有出现更优秀的工具前，ExtJS还是您的首选。

事实上Ext不仅仅是一个Ajax工具包，它更是一种先进的UI组件制作理念，其一是基于Java Swing的对象模型，只要你熟悉Swing，你可以节省很多时间，这一理念可以在Ext.Container/Layout中看到。其二是组件对象的统一模型，包括组件的创建、渲染、事件处理、状态管理和销毁这些框架Ext已经帮你定义好了，你只要稍作修改便能符合你的要求。

如何尽量避免使用Ext可能遇到的问题，如何运用Ext的一些最佳实践，这是很多Ext用户最想知道的，在此，我们会提供力所能及的帮助。

中国有大量的Ext用户，在更多人的努力下，我坚信这个队伍会不断壮大。

JS堂翻译小组

预览： http://jstang/docs/
AIR版文档中心下载： Google HOST ~3MB
要求：Adobe AIR虚拟机 v1.1或以上 下载虚拟机
用法：打开2.1 API Documentation.exe

完整任务进度表（包括了我们翻译小组的人员名单）：

http://chineseext.googlecode.com/svn/trunk/list.htm(取自SVN，需“另存为”后查看)

号外： 经历一年半的团队合作，从Ext 1.0到2.2，我们终于完成了我们当初的使命，就是为广大Ext用户、爱好者、初学者略尽绵力，提供完整的Ext汉化文档。详情请进入……  
JS堂翻译小组名单：Frank、甲壳、Nightmare（健坤）、BubbleBeast、虎头虎脑、下一道彩虹（明球）、阿雄、拥抱未来、小骏、夜色温柔、建峰、skywolf、野鹤、端阳、果连、旺财勇士（按照QQ组名单排列）

log：
1.此版本为公开测试版alpha 0.1 把我们当前已完成汉化的公开。Google SVN在http://code.google.com/p/chineseext/；
2.汉化工作持续进行中，有兴趣的朋友，不要犹豫了，加入我们翻译小组；
3.版权协议为Creative Commons 署名-非商业性使用 2.5

评论

31 楼 sp42 2008-08-06  

<p>呵呵 这是我们自制的JS DOC PARSER，细节等的方面有待加强，简单地说 还是比较“土” 呵呵.
最优秀的自然是原装的，可是jack一直守口如瓶，不肯透露原装的js parser.</p>

30 楼 chywwq 2008-08-06  

和英文的怎么对不上呢，变量啊Method的什么的排序都不对了，没有办法最后还是用回了英文版，不过还是要谢谢楼主的辛苦工作

29 楼 blackangel_can 2008-08-05  

3q，有了这个东西实在是太好了。

28 楼 watershitter 2008-08-05  

各位的大哥们的工作奉献精神令人景仰！

27 楼 sidubi 2008-07-31  

不错，各位辛苦啦。。。。

26 楼 sp42 2008-07-29  

equalto的一片苦心使我们感到社区的力量是多么的强大。

Ext.Data.* 我们是从1.0开始翻译的。抚心自问，的确不好。
对于各志愿者翻译的质量（虽然我自己也是一份子），态度是：有则改之，无则勉之。

既然Ext.Data.* 出现重大问题，我们打算重新翻译，这也是我们保守将翻译版本定为alpha 0.1的原因之一。

http://code.google.com/p/chineseext/issues/list是一个专门提交各方面问题的地方，这里可以剔除人的因素，直接面对问题。我先把equalto的内容转移到issues.

25 楼 equalto 2008-07-29  

声明下，没有打击或者相轻的意思。就事论事，希望文档可以做的更好。
不希望前面的话会引起其它的理解。

对于翻译文档的行为，我是很敬佩的，无论是发起者，还是参与者，都需要花费时间和精力。能做这样的事情本身，就是很不错了。

24 楼 equalto 2008-07-29  

首先表示敬意，对于翻译，实在很麻烦的事情，特别是对于计算机语言来说，顺达的翻译真的很费力。
因为许多的词汇和说法，都是新创造出来的。
而且理解又各自会有不同。比起解说佛祖的话语，也不稍差。

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
随便看了下在线的翻译文档，个人感觉，有些地方不是很好，
ArrayReader
① "mapping" only needed if an "id" field is present which precludes using the ordinal position as the index.
翻译的结果是，
//"mapping"仅当有"id"字段出现时(排除了使用原始位置作为索引)需要
其实，这里的含义是，映射的字段，在数据定义里的顺序号和在实际数据数组里面出现的顺序号不一致的话，则需要指定mapping，jsonreader和xmlreader也差不多的含义，参考ArrayReader的源码59 60行，
var k = f.mapping !== undefined && f.mapping !== null ? f.mapping : j;
var v = n[k] !== undefined ? n[k] : f.defaultValue;

② The subscript within row Array that provides an ID for the Record (optional)
翻译作：
// 下面的行数组内提供了该记录的id （可选的）
金山词霸翻译subscript为“写在下方的”，这个是“简明英汉字典”的结果，再看“计算机词汇”的结果里面有个“下标”，个人认为，词霸还应该加上“计算机词汇”字典的好。
个人认为这话意译的结果是：
行数据数组中，作为id字段的那个下标（序号）。

③ 最惨的是，readRecords函数，英文文档里面说的是：
Create a data block containing Ext.data.Records from an XML document.
翻译的结果倒和字面差不多，但是，这句话本身就是错的，这个是XmlReader。官方的网站上也在抓文档bug，估计早该有了吧。

翻译，应该还是理解为基础的。

23 楼 tangbo530 2008-07-29  

有JS错误？

22 楼 hou_jian_yong 2008-07-28  

你们太伟大了

21 楼 hou_jian_yong 2008-07-28  

你们太伟大了

20 楼 ty119110 2008-07-26  

支持，回复，以后也要多多回复，Ext是一个好东西，我们公司也在用。
正在学习当中。

19 楼 sam1982 2008-07-25  

好样的，frank~~~~~~

18 楼 just4you 2008-07-25  

如果能加上一些更有针对性的例子就更好了，有好多东西还不知道怎么用呢

17 楼 chyy001 2008-07-24  

尽管最近心情不好，还是支持下。。。呵呵，不要情绪化

16 楼 loyalbluer 2008-07-24  

谢谢LZ，这对初学者有很大的帮助！

15 楼 qamer 2008-07-24  

一件非常有意义的事

14 楼 毕竟红尘 2008-07-24  

good job!!

13 楼 南宫小骏 2008-07-23  

supercrsky 写道

ext 算不上ajax

确实如此
相信选择 Ext 做为展现层框架的人绝不会因为她支持 Ajax 或是因为她很“简单”地实现 Ajax
我选择了她是因为她为我提供了一整套风格统一、使用便捷、功能完善（当然离完美还是有相当距离的）的 UI
而这个治治是我目前参与的项目中所急需解决的一个大难题
我是一个典型的实用者
从来不提倡为了技术而技术
所以对我来说是否选择一套框架的唯一标准就是
是否能够满足项目的需求
仅此而已

12 楼 sp42 2008-07-23  

supercrsky 写道

ext 算不上ajax

老兄 不是吧，你的意思“超ajax” ？
有次一个家伙问ext为什么不支持同步通讯，ext主程之一Brain解释异步的原因是Ajax定义为“Asynchronous JavaScript and XML”的缘故，同步通讯官方暂时是不会去想的，——我估计可能同步的设计会带来过多的“阻塞”问题