Quick Installation

Submitted by tjcrowder on Sat, 04/14/2007 - 12:43.

This Document is Out of Date. For the current documentation, please see http://docs.dojocampus.org/

There are three main ways to install Dojo:

Install nothing! Use Dojo from AOL's Content Distribution Network (CDN).
Install the latest release on your server
Install directly from source control

Use Dojo from CDN

This method is quick and painless! You simply load Dojo through <script> tags pointing to the AOL CDN. You don't need to invest any of your own server disk space or resources nor will you need to install Dojo locally in many cases. Instructions are available on using Dojo from the CDN.

All of the Dijit examples in this book load Dojo through this method. You can literally copy and paste any example in Parts 1 and 2 onto your own web server and it will work as-is! In Part 3, where examples are most often code fragments, we'll tell you any modifications needed to run the example on CDN.

Use Dojo from your Own Server

For you traditionalists out there, you can download, install and use Dojo the old fashioned way.

Download the latest build from http://dojotoolkit.org/downloads.
Uncompress the file onto your web server. Assuming you install it under the directory /js, when you're done, the file system should look something like this:
With your browser, open http://yoursite.com/js/dojo-0.9.0/dijit/themes/themeTester.html You should see a page like this:

You've got a working Dojo!

Getting the Nightly Build

Finally, for those of you who live on the edge ... you can get the latest, greatest code directly from the Subversion code repository.

AOL CDN Link

Submitted by nileshbansal on Fri, 09/07/2007 - 22:45.

To use 0.9.0 from AOL's CDN, just include this script tag in your page:
<script type="text/javascript" src="http://o.aolcdn.com/dojo/0.9.0/dojo/dojo.xd.js"></script>
See http://build.dojotoolkit.org/0.9.0/ for more details.

Dojo works locally, as well

Submitted by peller on Fri, 11/09/2007 - 17:43.

Because it's a client-side framework, most of Dojo will work when installed on your filesystem, accessed with file: URLs. This can be a convenient way to experiment with Dojo. Once you start to interact with server data, browser security requires that you deploy your page on a web server.

[Edit: seems like this no longer works in FF3]

CDN Link

Submitted by bahwi on Wed, 11/28/2007 - 14:33.

So the "instructions are available" link goes back to this webpage, and there are no instructions for the CDN link at all. There is a comment with the 0.9 version, so I will include a link to the info for the 1.0.0 version as well.
http://dojotoolkit.org/2007/11/06/dojo-1-0-0-available-aol-cdn

Bug on the page

Submitted by mac-ar on Tue, 01/15/2008 - 08:31.

please fix the link: Instructions are available.
it's redirecting onto the same page

problem in the markup

Submitted by peller on Tue, 01/15/2008 - 15:36.

sorry about that. fixed.

Trouble getting this to work

Submitted by bbierman on Tue, 01/22/2008 - 05:37.

I can't seem to get this to work. I used svn to download the Dojo toolkit (0.90, 1.0 and 1.02) and followed the tutorial at http://code.djangoproject.com/wiki/AddDojoEditor to use the Dojo editor for my textareas. I only get javascript errors in IE7: either "could not load 'dojo._base.lang';last tried './_base/lang.js'" or "dojo not an object". Firefox says nothing and does nothing. I get the same when referencing CDN.

What am I doing wrong?

that example is very old

Submitted by peller on Tue, 01/22/2008 - 05:52.

apparently, that example is based on Dojo 0.4, which had a very different naming structure. It's hard to say exactly what's going on without seeing the example in its entirety running, but if it's based on what's on that page, it's not going to work with the new versions of Dojo. If you want to try the editor, I'd suggest consulting the Dojo book: http://dojotoolkit.org/book/dojo-book-0-9/part-2-dijit/advanced-editing-...

A good sanity check for the content on *this* page would be to load the themeTester.html page or some of the examples in the dojo/tests or dijit/tests directories. If that works and you have trouble with specific examples, please bring your questions to the forum.

Really a issue that the build script can not work in the release

Submitted by Jeff.He on Sat, 02/02/2008 - 10:21.

We tried to build with some customize build profile. But failed in 1.0.2. Any plan for fixing this issue? It works in the former release.

need more information

Submitted by peller on Sat, 02/02/2008 - 15:12.

I'm not sure we're aware of this issue. It's probably best to file a ticket on trac. Please provide steps to reproduce the problem as well as build output.

Google hosts dojo too

Submitted by mbrijun on Mon, 08/18/2008 - 07:20.

http://code.google.com/apis/ajaxlibs/documentation/#dojo

Error in the test page

Submitted by parkygis on Wed, 10/29/2008 - 16:06.

I have installed the 1.2.0 version.
however when I runed this,
http://localhost/js/dojo-release-1.2.0/dojo/tests/runTests.htmI got 404 error.
---------------------------------------
HTTP Error 404.0 - Not Found
The resource you are looking for has been removed, had its name changed, or is temporarily unavailable. Detailed Error InformationModule IIS Web Core
Notification MapRequestHandler
Handler StaticFile
Error Code 0x80070002
Requested URL http://localhost:80/js/dojo-release-1.2.0/dojo/tests/runTests.htmI
Physical Path C:\inetpub\wwwroot\js\dojo-release-1.2.0\dojo\tests\runTests.htmI
Logon Method Anonymous
Logon User Anonymous

-------------------------------------------
Is there anyway to fix this problem?

could i suggest clarification on the 'Getting Started Page'

Submitted by ronnystalker on Wed, 12/03/2008 - 04:25.

This is my first steps into the Dojo and i stumbled across some problems straight away. I also see that others are having similar problems too.

So - could i suggest a change to a line of text on this page: http://sitepen.com/labs/guides/?guide=DojoQuickStart

From: "You can verify your download and installation is working by pointing your web browser to http://localhost/js/dojo-release/dojo/tests/runTests.html or by browsing the dijit test pages at http://localhost/js/dojo-release/dijit/tests/"

To: "IF YOU HAVE DOWNLOADED THE SOURCE VERSION of Dojo - You can verify your download and installation is working by pointing your web browser to http://localhost/js/dojo-release/dojo/tests/runTests.html or by browsing the dijit test pages at http://localhost/js/dojo-release/dijit/tests/
The release version does not have the runTests.html file."

or something similar.

I downloaded about four variations before I found that elusive runTests.html file. (The first was as part of the Zend Framework release).

I understand it does say: "The archives suffixed with -src indicate a "source release", which contains all the tests and utilities needed to build your own custom Dojo." However my 'newby brain' skipped over that line quite quickly. I'm habituated into ignoring info about 'source releases' from years of reading app README files - if ya get me.

Any way - that just a minor suggestion - everything else looks nice an easy to understand.

Search

The Book of Dojo