modules/ROOT/pages/development/maintainingthewebpages.mdtext

Title: MaintainingTheWebPages

<a name="MaintainingTheWebPages-HowtheArieswebsiteworks"></a>
# How the Aries web site works

The Aries site is built using CMS. To edit the site you must be an Aries committer, the 
ID and password are the same ones as you use for Aries SVN.

The easiest way to edit pages is to install the CMS bookmarklet as described [here](https://cms.apache.org/#bookmark)

Navigate to the web page you would like to edit and then click the CMS bookmarklet.

The steps in making a change to the site are:

  - Edit
  - Submit
  - Commit your changes
  - Check the 'staged' site
  - If the content looks good, publish the site

The Wiki syntax is called Markdown and is documented [here](http://www.freewisdom.org/projects/python-markdown/). Some extensions are installed in 
the CMS system (eg tables, syntax highlighting). 

More information on CMS is 
available [here](http://wiki.apache.org/general/ApacheCms2010)

# Making major changes
Because the site is all in SVN its possible to check it out, make and test changes locally and then check in again much as you woudl with code changes.
To do this you will need:

  - A local copy of the cms build tools
  - A local setup of Apache

First, checkout the site , like this:

    svn co https://svn.apache.org/repos/asf/aries/site/trunk/ site


## To build the site using the build tools.

First check the cms build tools out of SVN: 

    svn co https://svn.apache.org/repos/infra/websites/cms/build/ buildtools

To run the build_site.pl script you will need to install the Python version 
of Markup. The instructions for finding and installing Python pre-reqs are given [here](http://wiki.apache.org/general/ApacheCMSFAQ)

Then to build the site use this command:

perl build_site.pl --source-base /path/to/newsite/trunk/ --target-base /path/to/output/

which will create *.html in /path/to/output/content

## Check the site on a local server.

Use a vhost to check the site. On a Mac this means adding the following stanza to /etc/apache2/extra/httpd-vhosts.conf

<VirtualHost *:80>
    DocumentRoot "/Users/zoe/Sites/zaries/www"
    ServerName zaries
    ErrorLog "/Users/zoe/Sites/zaries/error.log"
    CustomLog "/Users/zoe/Sites/zaries/access.log" custom

    LogLevel debug
</VirtualHost>

To test the site,  move it like this:

mv /path/to/output/content /Users/zoe/Sites/zaries/www

Then navigate to http://zaries in a browser.

#Add menuitem 
Check out the site by using 
svn co https://svn.apache.org/repos/asf/aries/site/trunk/ site

update the file under templates/navigation.mdtext

check in the changes by using svn commit

The following steps may not needed if the changes were displayed ok.

Navigate to a lower level page in Apache Aries site and click the CMS bookmarklet.

Check the staging page to verify the menuitem is displayed correct. 

Publish the site.