| 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 = | ||
| 73 |