原文：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新版本的时候。

• 1.10 版本说明，公告
• 1.9 版本说明，公告
• 1.8 版本说明，公告
• 1.7 版本说明，公告
• 1.6 版本说明，公告
• 1.5 版本说明，公告
• 1.4 版本说明，公告

常见问题及接单

这里有一些开始学习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和错误信息，以及如何解决他们。

已知的文档问题

上报问题

贡献

开始

你应从教程Hello Dojo开始，如果之前你有Dojo的使用经验，但刚接触1.10版本，你也需要应该看看教程Modern Dojo。

Dojo Start