| 1 | OpenLayers |
|---|
| 2 | -=-=-=-=-=- |
|---|
| 3 | Copyright (c) 2005-2010 OpenLayers Contributors. See authors.txt for |
|---|
| 4 | more details. |
|---|
| 5 | |
|---|
| 6 | OpenLayers is a JavaScript library for building map applications |
|---|
| 7 | on the web. OpenLayers is made available under a BSD-license. |
|---|
| 8 | Please see license.txt in this distribution for more details. |
|---|
| 9 | |
|---|
| 10 | ------------------ |
|---|
| 11 | Getting OpenLayers |
|---|
| 12 | ------------------ |
|---|
| 13 | |
|---|
| 14 | OpenLayers lives at http://www.openlayers.org/. |
|---|
| 15 | |
|---|
| 16 | You can get OpenLayers from |
|---|
| 17 | http://trac.openlayers.org/wiki/HowToDownload. |
|---|
| 18 | |
|---|
| 19 | --------------------- |
|---|
| 20 | Installing OpenLayers |
|---|
| 21 | --------------------- |
|---|
| 22 | |
|---|
| 23 | You can use OpenLayers as-is by copying build/OpenLayers.js and the |
|---|
| 24 | entire theme/ and img/ directories up to your webserver, putting them |
|---|
| 25 | in the same directory. The files can be in subdirectories on your website, |
|---|
| 26 | or right in the root of the site, as in these examples. |
|---|
| 27 | To include the OpenLayers library in your web page from the root of the site, use: |
|---|
| 28 | |
|---|
| 29 | <script type="text/javascript" src="/OpenLayers.js" /> |
|---|
| 30 | |
|---|
| 31 | As an example, using bash (with the release files in ~/openlayers ): |
|---|
| 32 | $ cd /var/www/html |
|---|
| 33 | $ cp ~/openlayers/build/OpenLayers.js ./ |
|---|
| 34 | $ cp -R ~/openlayers/theme ./ |
|---|
| 35 | $ cp -R ~/openlayers/img ./ |
|---|
| 36 | |
|---|
| 37 | If you want to use the multiple-file version of OpenLayers (for, say, |
|---|
| 38 | debugging or development purposes), copy the lib/ directory up to your |
|---|
| 39 | webserver in the same directory you put the img/ folder. Then add |
|---|
| 40 | the following to your web page instead: |
|---|
| 41 | |
|---|
| 42 | <script type="text/javascript" src="/lib/OpenLayers.js" /> |
|---|
| 43 | |
|---|
| 44 | As an example, using bash (with the release files in ~/openlayers ): |
|---|
| 45 | $ cd /var/www/html |
|---|
| 46 | $ cp -R ~/openlayers/lib ./ |
|---|
| 47 | $ cp -R ~/openlayers/theme ./ |
|---|
| 48 | $ cp -R ~/openlayers/img ./ |
|---|
| 49 | |
|---|
| 50 | |
|---|
| 51 | ------------------------------------ |
|---|
| 52 | Using OpenLayers in Your Own Website |
|---|
| 53 | ------------------------------------ |
|---|
| 54 | |
|---|
| 55 | The examples/ directory is full of useful examples. |
|---|
| 56 | |
|---|
| 57 | Documentation is available at http://trac.openlayers.org/wiki/Documentation. |
|---|
| 58 | You can generate the API documentation with http://www.naturaldocs.org/: |
|---|
| 59 | As an example, using bash (with the release files in ~/openlayers ): |
|---|
| 60 | $ cd ~/openlayers/ |
|---|
| 61 | $ /path/to/NaturalDocs -i lib/ -o HTML doc/ -p doc_config/ -s Default OL |
|---|
| 62 | |
|---|
| 63 | Information on changes in the API is available in news.txt. |
|---|
| 64 | |
|---|
| 65 | -------------------------- |
|---|
| 66 | Contributing to OpenLayers |
|---|
| 67 | -------------------------- |
|---|
| 68 | |
|---|
| 69 | Please join the email lists at http://openlayers.org/mailman/listinfo |
|---|
| 70 | Patches are welcome! |
|---|
| 71 | |
|---|
| 72 | = 30 = |
|---|
