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

No longer necessary- the CMS will build the site upon committing a change.
If you prefer to check the build *before* committing, see

    http://www.apache.org/dev/cmsref#local-build


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

See also http://httpd.apache.org/docs-project/docsformat.html

To modify the (staging) website, all you need to do is edit the files in the
content/ directory and then commit your changes. The format of the files is
markdown:

    http://www.apache.org/dev/cmsref#markdown

Changing the look and feel of the entire website is easy. Just modify the 
files located in the templates/ directory and commit.

If you would like to add links to the left side navigation, simply edit 
the templates/navigation.mdtext file and commit.

Place your images in the content/images directory. When you commit, the 
modified images will be copied over and committed back to the staging tree
by the CMS.

Non-committers may use the passwordless "anonymous" account on the CMS
in conjunction with the CMS's bookmarklet to post diffs to the docs@httpd
mailing list for a committer to apply.  Simply submit your edits (sans
Quick-Commit) to the CMS, click on the provided [Diff] link, which will
provide a [Mail Diff] link.  Clicking on that, filling out the form and
submitting it will mail your changes to the provided mailing list.


Publishing on httpd.apache.org (for committers only):
-----------------------------------------------------

After you have reviewed the built changes on the staging site at

    http://httpd.staging.apache.org/

You may publish the changes to the live (httpd.apache.org) site, either by
visiting

    https://cms.apache.org/httpd/publish

or by executing the perl publication script

   % GET http://s.apache.org/cms-cli | perl

or with a proper installation located on people.apache.org:

   $ ssh -t $user@people.apache.org publish.pl httpd $user

The changes should be reflected immediately on httpd.apache.org via
the automatic svnpubsub.  If the changes don't take effect, this may
be due to the european mirror, or may be a temporary fault in svnpubsub,
inquire with infrastructure about the state of svnpubsub.


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

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