1 |
== script.aculo.us web 2.0 javascript |
2 |
|
3 |
The Web is changing. The 30-year-old terminal-like technology it was originally |
4 |
is gradually giving way to new ways of doing things. The power of AJAX allows |
5 |
for rich user interaction without the trouble that has bugged traditional |
6 |
web applications. |
7 |
|
8 |
Building upon the wonderful Prototype JavaScript library, script.aculo.us |
9 |
provides you with some great additional ingredients to mix in. |
10 |
|
11 |
For more information, see http://script.aculo.us/ |
12 |
|
13 |
== What's new in this release? |
14 |
|
15 |
See the CHANGELOG file for information on what's new. |
16 |
|
17 |
You can follow http://twitter.com/scriptaculous if you want |
18 |
to be updated as we fix bugs and add new features. |
19 |
|
20 |
== Installation/Usage |
21 |
|
22 |
script.aculo.us includes the Prototype JavaScript Framework |
23 |
V1.6.0. You can use later versions, as they become available |
24 |
(see http://prototypejs.org/). |
25 |
|
26 |
Put prototype.js, and the six files scriptaculous.js, |
27 |
builder.js, effects.js, dragdrop.js, controls.js and slider.js |
28 |
in a directory of your website, e.g. /javascripts. |
29 |
|
30 |
(The sound.js and unittest.js files are optional) |
31 |
|
32 |
Now, you can include the scripts by adding the following |
33 |
tags to the HEAD section of your HTML pages: |
34 |
|
35 |
<script src="/javascripts/prototype.js" type="text/javascript"></script> |
36 |
<script src="/javascripts/scriptaculous.js" type="text/javascript"></script> |
37 |
|
38 |
scriptaculous.js will automatically load the other files of the |
39 |
script.aculo.us distribution in, provided they are accessible |
40 |
via the same path. |
41 |
|
42 |
See http://wiki.script.aculo.us/scriptaculous/show/Usage for detailed |
43 |
usage instructions. |
44 |
|
45 |
== The distribution |
46 |
|
47 |
Besides the script.aculo.us files in src, there's a complete |
48 |
test tree included which holds functional and unit tests for |
49 |
script.aculo.us. |
50 |
|
51 |
If you need examples on how to implement things, the best place to |
52 |
start is by opening test/run_functional_tests.html or |
53 |
test/run_unit_tests.html in your browser, and looking at |
54 |
the sources of the examples provided. |
55 |
|
56 |
== License |
57 |
|
58 |
script.aculo.us is licensed under the terms of the MIT License, |
59 |
see the included MIT-LICENSE file. |