How To Update The ManifoldCF Website

(NOTE: You need committer rights to modify the Website.)

1. Install ant.
2. Install an svn client, version 1.7 or later.
3. Install python 2.7+.
4. Make sure you have write permissions on the directory where Apache Forrest will be checked out and installed, the first time your run Forrest it will attempt to create a plug-ins directory and download several plug-ins.
5. Check out and prepare to build the current trunk version of Apache Forrest:

   svn co http://svn.apache.org/repos/asf/forrest/trunk forrest

   (Or, if you want to save time, just install Forrest-0.9 or above.)
6. Change to the main build area:

   cd forrest/main

7. Build forrest:

   build

8. Follow the instructions the build gives you to complete the Forrest installation
9. Checkout the ManifoldCF site code https://svn.apache.org/repos/asf/manifoldcf/site/trunk/.
10. Change directory to where the site code was checked out.
11. "ant make-core-deps" will download the necessary build dependencies.
12. "ant build" will build the current site, including the release documentation from trunk. The generated site will be in ./build/site/.
13. Make your desired website changes to the source files in ./src/ and regenerate the site with ant.

When you are satisfied with your changes, and want to push them out to the main site mirror, do the following:

1. Commit your changes to trunk.
2. Regenerate the site using "ant build".
3. Check out https://svn.apache.org/repos/asf/manifoldcf/site/publish/ to the location of your choice (a new workarea).
4. Execute "python scripts/update-site.py". The first argument should be "./build/site". The second should be the root of the tree you just checked out.
5. The site will automatically be exported from https://svn.apache.org/repos/asf/manifoldcf/site/publish by the standard Apache svnpubsub process.