How it works?

Overview

The Directory Project's website is maintained in various Confluence spaces, each space corresponding to a specific sub-project (i.e. a single space for Apache Directory Studio, a single space for Apache Directory Server v1.5, etc.)

Every time a page is created, edited or deleted, the AutoExport plugin inside Confluence exports the corresponding on the disk of the server where Confluence is hosted.

Then, these exported spaces are copied and combined using rsync to the final location of the website ('/www/directory.apache.org' on the 'people.apache.org' server).

In details

The Directory Project's website home folder is located at '/www/directory.apache.org' on the 'people.apache.org' server.

Most of the files under this folder are automatically copied every hour from the confluence exported spaces using crontab jobs.
These crontab jobs are defined with the user "pamarcelot" (Pierre-Arnaud Marcelot - pamarcelot@apache.org) and trigger shell scripts containing rsync instructions for copying each space.
The others file are static files which are images, style sheets, or specific download pages.

Below is the structure of the website, explaining where the various parts of the site come from:

/www/directory.apache.org/ < Some content is copied from /www/confluence-exports/DIRxSITE/ using the rsync-DIRxSITE.sh shell script
|apacheds/
|1.0/ < Some content is copied from /www/confluence-exports/DIRxSRVx10/ using the rsync-DIRxSRVx10.sh shell script
|1.5/ < Some content is copied from /www/confluence-exports/DIRxSRVx11/ using the rsync-DIRxSRVx11.sh shell script
|community&resources < Some content is copied from /www/confluence-exports/directory/ using the rsync-directory.sh shell script
|studio < Some content is copied from /www/confluence-exports/DIRxSTUDIO/ using the rsync-DIRxSTUDIO.sh shell script
|triplesec < Some content is copied from /www/confluence-exports/DIRxTRIPLESEC/ using the rsync-DIRxTRIPLESEC.sh shell script

Apache Proxy

These sites are rsync'ed into production on ajax every hour (starting at 11 minutes past). Deletes happen once per day.

You can view your changes before they go into production by using a trick with your web browser. Temporarily set the preferences to use 140.211.11.10:80 as your HTTP proxy. Beware: that IP address and crontab might change at some time - if so then please send a patch for this doc.