How To Update The Apache Connectors Framework Website

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

1. Install ant.
2. Install an svn client.
3. 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.
4. Check out the current trunk version of Apache Forrest:

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

5. Change to the main build area:

   cd forrest/main

6. Build forrest:

   build

7. Follow the instructions the build gives you to complete the Forrest installation
8. Checkout the LCF site code https://svn.apache.org/repos/asf/incubator/lcf/site/.
9. Change directory to where it was checked out
10. Run forrest to build current version of documentation to make sure that Forrest was correctly installed. The generated site will be in ./build/site/.
11. Make your desired website changes to the source files in ./src/ and regenerate the site with forrest.
12. Run "forrest run" and browse to http://localhost:8888 to review the changes. You should be able to modify the source documents and hit reload on your browser without rebuilding the site.
13. When you are satisfied with your changes, regenerate the site with forrest by running "forrest site",
14. (recursively) copy ./build/site/* to ./publish, and commit changes to both ./src and ./publish (add any new files first, but exclude the build directory). This step is very important, if you miss it, your changes will not appear on the site after the next step.
15. The site will automatically be exported from svn by a script running in Grant's crontab on p.a.o on a nightly basis:
    04 4 * * * /home/gsingers/bin/exportLCFDocs.sh > /home/gsingers/bin/lcf.log 2>&1