翻译 - 【Dojo Tutorials】Dojo Start

最新推荐文章于 2024-10-09 16:20:31 发布

weixin_30604651

最新推荐文章于 2024-10-09 16:20:31 发布

阅读量81

点赞数

文章标签：测试 java 运维

原文链接：http://www.cnblogs.com/gudaojuanma/p/dojo-start.html

版权

原文：Dojo Start

怎样开始学习Dojo？文档在哪里？如何获得帮助与培训？我应该使用Dojo的什么版本？为什么我需要一个web服务器？如何避免低级错误？如何反馈问题？我如何做出贡献与获取参考？这份引导性指南将回答上面及更多的问题。

文档

Dojo站点为开始学习Dojo提供了三份主要的文档，都是社区的努力与贡献。

教程

教程合集提供了关于几十个Dojo开发主题的免费介绍。开头的一些教程是我们极力推荐的。除此之外，教程根据主题做了分组。这一系列教程主要是由SitePen的团队编写，关于如何开始学习Dojo的问题，你应该从Hello Dojo tutorial开始，或者你之前有使用Dojo的经验，但是新接触版本1.10，你应该看看Modern Dojo tutorial。当然前提是先看完本章节再说。

参考指南

参考指南主要是根据API组织的深度文档集合。社区在GitHub上创建了进阶版本。

查看API

这是正式Dojo API的树状结构。这是利用两个开源项目100%从源代码注释和源码中提取的，两个开源项目分别为：js-doc-parse，用于解析源码目录，另一个是API Viewer，用于通过解析源码提供一个利于人们阅读的版本。你也可以利用这两个项目来为你自己的代码定制自定义的API文档。

在不同文档片段中存在着交叉引用，用于未来做进一步的改进计划。对于每个文档片段，都是基于释放的版本。这些教程与参考指南覆盖了1.6， 1.7， 1.8，1.9和1.10版本，API阅读器可以追溯到版本1.3。在文档结尾有已知的文件系统问题和改善文档做出努力的信息。

培训与支持

SitePen有Dojo培训课程，包括Dojo和JavaScript。

哪里获得参考书？

写一本牛X的书要花费大概1000到2000个小时（Dojo的教程系列大概花了1000多个小时）。现有的出版的Dojo的书都是关于版本1.0到1.5之间的。正在筹备新书，更新更加频繁，你可以购买PDF或纸质书籍。

选择Dojo的什么版本？

我们建议尽可能的使用最新版，但对老版本也提供持续的支持，我知道升级应用的源代码需要付出更多的努力。

Dojo基金会现在致力于为1.4及其以上版本添加对新的浏览器的支持。我们将会定期更新Dojo的老版本以获得对新版浏览器的支持。我们也会修复一些主要bug，在最近的主版本中。新功能的开发通常被限制在最新的版本中。

目前，我们将会在1.11版本中加入新的功能，修复1.10.x版本中的bug，为1.4.x及其以上的版本提供对新浏览器的支持。

看一下不同版本的主要功能也许有助于你做决策。确认了解了不同版本的说明，它们将在不同版本间升级的时候提供指导。我们尽力做到向前兼容，修复错误和介绍新的功能，也许需要一些努力当你迁移代码到Dojo新版本的时候。

常见问题及解答

这里有一些开始学习Dojo可能遇到的七七八八的问题及答案，也许先了解一下对你会有帮助。

遗弃警告

当你在新版的Dojo中使用旧的Dojo功能时，会遇到遗弃警告。这因为着这些功能在2.0版本后会被移除掉，且有一个改进的方法可用。

总是需要一个web服务器

应该在web服务器上运行你的代码，而不是基于文件系统，哪怕这个web服务是运行在你的开发机上的。浏览器基于本地文件系统处理HTTP请求比基于web服务器有更多的限制，哪怕都是运行在一台机器上。为了结果的一致性，你应当总在在web服务上测试你的Dojo代码（不管什么web服务器，Apache，nginx，Tomcat，IIS，Jetty等等都可以）。

CDN与省略协议的URL

你也可以从CDN上载入Dojo。这对于快速使用Dojo是有帮助的，不需要你本地有一份Dojo的copy。也许你注意到了我们的教程中展示了省略协议的URL，如<script arc="ajax.googleapis.com/ajax/libs/dojo/1.10/dojo/dojo.js" data-dojo-config="async:true"></script>。这允许你在http和https应用中使用Dojo，不用去调整URL。更新信息，请参考教程Dojo CDN。

常见错误

我们经常会犯前人犯过的错误。SitePen上有一篇不错的博客基于他们的培训课程发布的，展示了常见bug和错误信息，以及如何解决他们。

已知的文档问题

我们已经基本上改进我们的文档目录通过显著的社区贡献。

通过社区的不懈努力，我们已知了一些问题：

使用AMD之前与之后的语法对比。在1.7版本，为了包含与定义源代码模块我们转移到了AMD模式。对于1.7，1.8，1.9，1.10的文档里面可能还有一些老的语法。这些语法还是被支持的，文档在有些方面是过时的，我们可以有更多的求助渠道。
关于1.7的API查看器。1.7的API查看器里面有限主要的整洁缺失。我们在之后的版本里解决掉了这个问题，保持了与1.7版本相似的API集合。如果API页面是空白的或有细节缺失，请查看更高版本的页面。
1.6之前的版本不再提供教程与参考，1.3之前的版本不再提供API查看器。经过我们不屑的努力，那么老版本的不在了。
平板与手机查看文档。我们的API查看器与示例主要针对于桌面浏览器的。请报告你发现的问题，或者参与修复他们。
参考指南中的IE样例。针对参考样例在IE中的问题我们已经解决了不少了。如果你发现有剩余的问题，请上报给我们，如何上报，请接着往下看。

上报问题

关于文档的错误，请到点击每页的底部的连接上报问题。从2012年我们添加这个功能以来已经修复了上千个问题。有时问题修复的很快，有时要花费我们几个月的时间，但我们都会阅读的并感谢你对于改进文档上报的反馈。
关于文档的净化与后来的问题，请注册dojo的邮件列表，然后开始提问题，或自由的在freenode上加入#doho的聊天频道。
关于bug与增强的问题，请创建一个Dojo基金的帐号然后写一份bug报告。

贡献

Dojo完全由社区的贡献和努力驱动。如果想要参与进来，我们需要你创建一个Dojo基金会的帐号并同意签署在线贡献者协议。确定要使用CLA链接到你的bug跟踪帐号，好简

化我们的核实过程。一旦文件上有你的CLA，下面告诉你如何帮助：

API查看器。通过GitHub在js-doc-parse和API viewer项目贡献。
参考指南。通过GitHub在Dojo docs项目贡献。
写新的教程。通过dojo-interest邮件列表表达你的兴趣，直接联系DYlan Schiemann，或使用联系表单把我们拉在一起。
Updating tests from DOH to intern.See Dojo Automated Testing Improvements: Updating to intern for more information.
从DOH（Dojo的单元测试框架）更新测试到实习生（不理解咋回事）。更多信息查看Dojo自动化测试进阶：更新到实习生。
贡献补丁与修复bug：写一份bug报告包含补丁在内。对于一些包来说，如dgird，为特定的包通过GitHub项目直接这么做。Dojo1.x的版本放在GitHub上，2.0也是如此。
访问Dojo基金会的网站，学习更多参与进来的方法。