1.1 開啓Dojo之旅
原文地址：https://dojotoolkit.org/documentation/tutorials/1.10/start/index.html
本翻譯GitBook地址：https://www.gitbook.com/book/limeng1900/dojo1-11-tutorials-translation-in-chinese/details
轉載請註明出處http://blog.csdn.net/taijiedi13/ – 碎夢道
如何學習Dojo？哪裏有文檔？怎樣獲得培訓和支持？應該用哪個版本的Dojo？我爲什麼需要使用web服務？怎樣避免常見的錯誤？如何提交問題報告？可通過什麼方式來作出貢獻？本教程的目的就是回答這些問題。
文檔
Dojo網站爲新手提供了三個主要的文檔，它們都是由廣大社區成員貢獻完成的。
教程
教程集 提供一系列關於Dojo開發主題的入門。排在前面的幾個教程通常是我們優先推薦的。除此之外，其他教程是依照主題分類的。這一系列教程主要是SitePen 上的團隊提供在“如何開始學習Dojo？”的回答裏。你應該從 Hello Dojo 這篇教程開始，或者如果你以前用過Dojo，只是剛接觸1.10，你可以從新一代Dojo 教程開始。不過當然是在你看完本篇之後。
參考指南
參考指南是按照API對文檔的深入整理。想參與貢獻請看通過GitHub改進參考指南。
API查看器
API查看器擁有全部的Dojo API 。他們100%來源於源碼註釋和Javascript源碼，主要使用了兩個開源項目：js-doc-parse ——用來解析資源樹、API viewer ——用來交付解析的資源樹的可讀版本。你可以通過 生成你自己的自定義API查看器 在你自己的代碼中使用這兩個項目。
這些文檔之間存在一些交叉引用，未來會作出改進。每一個文檔都是基於版本發佈的。教程和參考指南涵蓋1.6、 1.7、1.8、1.9和1.10，API瀏覽器則可以追溯到1.3版本。本文末尾可瞭解到該文檔系統的已知問題和參與改善我們的文檔的相關信息。
培訓和支持
SitePen提供一系列優秀的 Dojo workshops 以及 Dojo 和 JavaScript 支持。
相關書籍
編寫一本優秀的書需要1000-2000個小時（Dojo網站上的系列教程就花了超過1000個小時）。現存的Dojo出版書籍都是在Dojo 1.0到1.5之間發行的。我們正在討論發行一本新的Dojo書籍，一本能夠頻繁更新並可以購買PDF或印刷版的書。
哪個Dojo版本？
我們推薦儘可能使用最新版本的Dojo，但也向舊的發行版提供不間斷的支持，因爲我們知道升級應用的源代碼需要費很大的力氣。
Dojo基金會承諾當前會爲1.4和更高版本提供新瀏覽器的支持。我們將定期更新舊版本的Dojo來支持新發布的瀏覽器。我們也會修復主要的bug，特別是針對最近發佈的主流版本。新功能的開發創建通常會放在當前最新版本上。
對於現在來說，新功能開發會基於1.11版本，1.10.x主要進行bug修復，並定期爲1.4.x及以上版本提供瀏覽器支持。
瞭解Dojo每個發行版的主要特點和新增內容能夠幫助你決定用哪個。在版本之間進行升級時，一定要查看每個主要發行版本發行說明提供的指導。我們盡最大的努力使升級做到向前兼容，但你在把代碼向新版本Dojo遷移的時候仍需要在修復bug和引入新特性上花一些力氣：
- 1.10: release notes, announcement
- 1.9: release notes, announcement
- 1.8: release notes, announcement
- 1.7: release notes, announcement
- 1.6: release notes, announcement
- 1.5: release notes, announcement
- 1.4: release notes, announcement
入門FAQs
這裏有一些關於入門的各種常見FAQ和小貼士，先了解一些會比較有用。
棄用警告
當你在新Dojo發行版中使用舊版特性時，偶爾會看到棄用的警告。這個警告的意思是該API或特性將在Dojo2.0裏移除，可能會考慮一種改進的方法。
使用web服務器
從web服務器上運行你的源碼，不要在文件系統裏，哪怕web服務器是搭建在你的開發機器上的。就算是在同一臺機器上，瀏覽器對HTTP請求的處理在本地文件系統也比web服務器上受限很多。爲了保證結果一致，你應該總是用HTTP web服務器(Apache, nginx, Tomcat, IIS, Jetty,等.)來運行Dojo。
CDN 和 protocol-less URLs
你也可以從一個CDN加載Dojo。對於快速使用Dojo來說這很有用，而且也不要求你有自己的Dojo副本。在我們很多教程裏都能看到protocol-less URLs，例如<script src="//ajax.googleapis.com/ajax/libs/dojo/1.10/dojo/dojo.js" data-dojo-config="async:true"></script>。你這樣不用調整URL就可以在http和https應用裏使用Dojo，詳見 Dojo CDN tutorial。
常見錯誤
很有可能之前就有人犯過和你一樣的錯誤。SitePen 基於他們培訓研討班創建了一個很棒的博客條目，展示在 常見 Dojo bugs 和 錯誤信息，還有如何解決他們。
已知的文檔問題
我們已經通過社區貢獻充分的改進了我們的文檔。即便如此，還有一些已知的問題（以及在預定的時間裏數以百計的內容修正）。已知的問題如下：
- pre-AMD vs. AMD syntax。Dojo1.7我們引入了AMD格式來require和define源碼模塊。1.7, 1.8, 1.9, 和1.10 提供的一些文檔裏仍然使用的舊語法。文檔只是在部分區域過時，而這些語法也依然支持，所以仍然很有用。
- 1.7 API viewer。API viewer的1.7版本缺少重要內容。1.8, 1.9, 和1.10已經解決了這個問題，它們的API也和1.7相似。 如果API viewer頁面空白或者缺少細節，請參考1.8, 1.9, 和1.10版本的相同頁面。
- 在1.6之前沒有教程和參考指南，在1.3之前沒有API viewer。很簡單，因爲我們在這些版本之後纔開始做的，所以之前的版本是沒有的。
- 在平板和手機上查看文檔。API viewer 和示例主要面向桌面瀏覽器。請把問題報告給我們，或者參與修復它們。
- 參考指南的IE示例。我們已經解決了很多關於IE瀏覽器加載參考指南示例的相關問題。如果發現遺留問題，請按下面提到的方式報告。
報告問題
- 對於文檔錯誤，請在每頁底部的鏈接處提交問題報告。早在2012年自從我們在加上這個功能，就已經解決了幾千個文檔問題。修復有時候很快，有時候需要花費幾個月，但是我們會全部審閱並且非常感激你能夠提供改進文檔的建設性意見。
- 對於文檔說明和後續問題，請 註冊dojo-interest mailing list ，在那提問題，或者在我們的freenode的即時聊天頻道#dojo（譯者注：頻道已失效） 。
貢獻
Dojo是完全由社區的努力和貢獻推動的。想要參與超越基本的反饋，我們要求您創建一個Dojo基金賬戶，然後簽署我們的網上貢獻者許可協議。確保把你的CLA和你的bug追蹤賬戶綁定以簡化我們的過程。一旦你擁有CLA，下面會有所幫助：
- API Viewer。通過GitHub上的 js-doc-parse 和API viewer 項目。
- Reference Guide。通過GitHub上的Dojo docs 項目。
- 編寫新教程。通過dojo-interest mailing list 表達你的興趣，直接聯繫Dylan Schiemann ，或者直接用我們的 contact form聯繫我們。
- 從DOH到實習生的更新測試。詳見： Dojo 自動化測試改進: Updating to Intern。
- 貢獻補丁和bug修復。對於有些包比如 dgrid，你應該直接通過GitHub項目。Dojo 1.x使用GitHub，它也是Dojo 2.0的首選。
- 訪問Dojo基金會網站更多地瞭解關於參與Dojo。
開始
你應該從Hello Dojo tutorial 入門，或者如果你有Dojo使用經驗，但剛接觸1.10，可以從 Modern Dojo tutorial 開始。
