Infrastructure

The openlayers.org website is hosted on  OSGeo infrastructure.

Updating the Website & Examples

Periodically, the trunk/openlayers/tools/update_dev_dir.sh script is run to update the working copy of the website source, to update the hosted examples with the latest from the trunk, parse metadata from the examples, build an example index, and build a single-file OpenLayers.js.

The frequency of this process is determined by a cron job on the openlayers.org machine. To get details on this job, run the following:

sudo crontab -u openlayers -l

If there are conflicts in the update for some reason, this job may fail. If you clean things up in the target directory or otherwise need to manually run this job, do so as the openlayers user:

sudo -u openlayers /osgeo/openlayers/docs/dev/tools/update_dev_dir.sh

Note The update script only updates the website if the library source (not the website source) has been changed since the last time the update ran. To update the website manually, run the following:

sudo -u openlayers svn up /osgeo/openlayers/docs

Modifying the Website

You can check out the website sources from the repository, make local modifications, and see what those changes are going to look like on the live site before committing them. To do this, you'll need to modify your Apache config to process the SSI directives in the website markup. In addition, it is convenient to proxy the requests to /api/OpenLayers.js. Below is a sample config section that handles requests to  http://ol-localhost/:

<VirtualHost *:80>

    DocumentRoot /Users/tschaub/projects/openlayers/website
    ServerName ol-localhost

    <Directory /Users/tschaub/projects/openlayers/website>
        Options Indexes MultiViews Includes
        AllowOverride None
        Order allow,deny
        Allow from all
        AddType text/html .shtml
        AddOutputFilter INCLUDES .shtml
        DirectoryIndex index.shtml
    </Directory>

    ProxyRequests Off
    ProxyPreserveHost Off

    <Proxy *>
        Order deny,allow
        Allow from all
    </Proxy>

    ProxyPass /api http://openlayers.org/api
    ProxyPassReverse /api http://openlayers.org/api

</VirtualHost>

This assumes you have the website checked out (in some place like /Users/tschaub/projects/openlayers/website) and that you add an ol-localhost entry to your hosts file. Here's an example line from an /etc/hosts file:

127.0.0.1   ol-localhost

With this configuration, you should be able to see what the website will look like by loading  http://ol-localhost/.

Sandbox Access

Anyone who has OpenLayers Sandbox access (which should include all trunk committers) can add someone to have OpenLayers sandbox commit access by visiting:

 https://www.osgeo.org/cgi-bin/auth/ldap_group.py?group=openlayers_sandbox

and typing a name in the bottom of the page.

For OpenLayers trunk, the same prinicple applies:

 https://www.osgeo.org/cgi-bin/auth/ldap_group.py?group=openlayers

These updates should take place immediately.