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 |
== Installation/Usage |
18 |
|
19 |
script.aculo.us includes the Prototype JavaScript Framework |
20 |
V1.5.0. You can use later versions, as they become available |
21 |
(see http://prototype.conio.net). |
22 |
|
23 |
Put prototype.js, and the six files scriptaculous.js, |
24 |
builder.js, effects.js, dragdrop.js, controls.js and slider.js |
25 |
in a directory of your website, e.g. /javascripts. |
26 |
|
27 |
(The unittest.js file is optional and is only needed if you |
28 |
want to do unit testing on your own javascripts). |
29 |
|
30 |
Now, you can include the scripts by adding the following |
31 |
tags to the HEAD section of your HTML pages: |
32 |
|
33 |
<script src="/javascripts/prototype.js" type="text/javascript"></script> |
34 |
<script src="/javascripts/scriptaculous.js" type="text/javascript"></script> |
35 |
|
36 |
scriptaculous.js will automatically load the other files of the |
37 |
script.aculo.us distribution in, provided they are accessible |
38 |
via the same path. |
39 |
|
40 |
See http://wiki.script.aculo.us/scriptaculous/show/Usage for detailed |
41 |
usage instructions. |
42 |
|
43 |
== The distribution |
44 |
|
45 |
Besides the script.aculo.us files in src, there's a complete |
46 |
test tree included which holds functional and unit tests for |
47 |
script.aculo.us. |
48 |
|
49 |
If you need examples on how to implement things, the best place to |
50 |
start is by opening test/run_functional_tests.html or |
51 |
test/run_unit_tests.html in your browser, and looking at |
52 |
the sources of the examples provided. |
53 |
|
54 |
== License |
55 |
|
56 |
script.aculo.us is licensed under the terms of the MIT License, |
57 |
see the included MIT-LICENSE file. |