Checking out the source:
------------------------

$ svn co http://svn.apache.org/repos/asf/infrastructure/site/trunk site

Building the website:
---------------------

In order to build the documentation, you will need to have a Java 1.2 JVM 
or higher installed. You will also need to set the JAVA_HOME environment 
variable.

If you install Ant 1.3 or higher, it will make the process easier for you:

    <http://ant.apache.org/>

If you have Ant installed, all you need to do is cd into this directory 
and type:

    ant

If you do not have Ant installed, all you need to do is cd into this 
directory and type:

    ./build.sh

Or on Windows, type:

    build

Modifying the website:
----------------------

See the instructions at:
http://www.apache.org/dev/infra-site.html

To modify the website, all you need to do is edit the files in the xdocs 
directory and then rebuild the website. The format of the files is fairly 
straightforward. You should only add XHTML tags because the .xml files 
need to be parsed by an XML parser.

DO NOT CHANGE THE FILES IN THE DOCS DIRECTORY; ONLY UPDATE XDOCS!
The files in the xdocs directory will be copied to the docs directory
as part of the build process. There are currently two exceptions to this;
the following directories are only in docs:
* docs/ca - the contents will be generated externally
* docs/dev/drafts - this is an external link

Changing the look and feel of the entire website is easy. Just modify the 
site.vsl file located in the xdocs/stylesheets directory and rebuild.

If you would like to add links to the left side navigation, simply edit 
the project.xml file in the xdocs/stylesheets directory and rebuild.

Place your images in the xdocs/images directory. When you rebuild, the 
modified images will be copied over to the docs/images directory.

When the html files have been generated, check that the expected files
have been updated. Once you are happy that the correct files have been
changed - for each changed xml file, there should be an updated html file -
commit the changes to SVN.

The live site can then be updated as described in
http://www.apache.org/dev/infra-site.html

Note
----
The docs/dist project sub-directories are maintained by individual PMCs, and are thus
excluded from the infrastructure/site/trunk SVN tree.


Questions:
----------

If you have any questions, please subscribe to the mailing list described 
in the STATUS document.