发布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

评论

51 楼 南宫小骏 2008-12-11  

呵呵
从alpha升级到beta了

50 楼 bubble 2008-12-11  

支持一下，呵呵

49 楼 qq6518980 2008-12-11  

支持啊，辛苦了。。。。

48 楼 qq6518980 2008-12-11  

正在 学这个啊。

47 楼 sp42 2008-12-09  

equalto 写道

还是看着感觉用软件翻译的多，不知道是词霸还是朗道，抑或是其它什么我没见过的高科技软件。

这里也是恁冷清，下午我逛了四个帖子，居然看见自己的大名出现在圈子的活跃人物榜上了。

当然不是，请不要乱说。翻译质量我们可以改进，但是请不要无中生有，让人气馁。～真的。

46 楼 equalto 2008-12-08  

还是看着感觉用软件翻译的多，不知道是词霸还是朗道，抑或是其它什么我没见过的高科技软件。

这里也是恁冷清，下午我逛了四个帖子，居然看见自己的大名出现在圈子的活跃人物榜上了。

45 楼 aliang135 2008-12-01  

好东西，谢谢楼主分享了 ！

44 楼 sp42 2008-11-29  

jayxu 写道

为什么一定要做成AIR形式？？？
还有个问题zip包里是不是内容重复了啊

有双份，，，

AIR跨平台 还可以在WIN2K上跑 不容易呀，，
有双份？我检查一下～

p.s:另外纯HTML加一个脚本的补丁也可以的，不过碍于一时找不到那脚本，暂时作罢。

43 楼 jayxu 2008-11-26  

为什么一定要做成AIR形式？？？
还有个问题zip包里是不是内容重复了啊

有双份，，，

42 楼 kebo 2008-11-21  

造福于民啊，感谢你的工作

41 楼 hansonmo 2008-11-21  

非常感激LZ

虽然e文的也能看懂，但还是中文看起来顺眼，嘻嘻

40 楼 sp42 2008-11-19  

[url]http://www.ajaxjs.com/docs/Ext 2 API Documentation.zip[/url]
上传了air离线包，注意是打开.exe文件，不是打开index.html，敬请留意。

39 楼 supersnake 2008-11-15  

顶下,下载看看.

38 楼 duronshi 2008-11-10  

我也想加入,但是偶的用户名总是登录不上去,提示密码错误,szcountryboy
之前就成功登录过一次,老大可以帮我看下不?

37 楼 sp42 2008-11-10  

这次发布Ext 2中文文档（全）。

在线：http://www.ajaxjs.com/docs/

SVN/BUG REPORT、TRACK在：
http://chineseext.googlecode.com

个人翻译后感：
1、Ext文档写得很贴心、细致。要表达一个意思，Ext文档的作者尝试了几种角度、几种叙述手法去为用户介绍，分布不同的方法中。
API文档这种文体，有时某几个方法之间差异很少，如果filterByIndex/filterByValue/filterByName等，但文档作者不是重复的复制、粘贴去写，而是尝试写多点，不厌其烦地写多些读者想知道的内容。

2、作者想向用户交待的，是全体的对象模型的整个面貌，因此在叙述某个知识点不是孤立地说明这问题，而是围绕整个全体去介绍。
我们翻译时，甚至觉得这样跳跃性太大了，一下子扯到另外一个地方去了，但其实了解了整个概貌后，把各个点串起来很容易理解。

3. 文档具体的内容很多时候，就是向用户介绍那个方法做过些什么。可以认为是对源码的补充，因为JS是一门遗忘曲线极高的语言（js语法太省了）。早期时候曾有人抱怨API不全，实际我们感觉而言，还是比较细致的。

4. 结论是，联系整个EXT的方方面面，都是可以让我们放心的，无论您的目的是学习，还是应用、还是了解。

36 楼 sp42 2008-11-07  

oxonio 写道

怎么那个连接里面有空格,没法下载啊?

撤下了，近期在翻译中，有望可以全部OK，届时再发布过。

35 楼 oxonio 2008-11-05  

怎么那个连接里面有空格,没法下载啊?

34 楼 sp42 2008-11-03  

jackhowe 写道

我在安装最新的AIR Runtime时遇到签名错误，麻烦大家给我看看怎么解决。我从Adobe网站下载的最新的AdobeAIRInstaller.exe 1.1.0.5790版，我的电脑是XP+SP2的系统，我还在别的几台同样系统的电脑上进行了测试，都是同样的错误，无法安装AIR Runtime！
 

jackhowe,是这样的，——据可靠线报，新AIR 1.5 Runtime将在年底前释出，届时可以再试试吧

33 楼 jackhowe 2008-08-23  

<p>我在安装最新的AIR Runtime时遇到签名错误，麻烦大家给我看看怎么解决。<br/><br/>我从Adobe网站下载的最新的AdobeAIRInstaller.exe 1.1.0.5790版，我的电脑是XP+SP2的系统，我还在别的几台同样系统的电脑上进行了测试，都是同样的错误，无法安装AIR Runtime！<br/></p>
<p> </p>

32 楼 huanguo11 2008-08-21  

辛苦你们了.