Guidance on using Apache Forrest for website changes

[John Kaputin <KA...@uk.ibm.com>]

Dan,
here's some guidance on using Apache Forrest to generate the Woden 
website, re- your additions to the Version Control page on configuring the 
SVN client to handle eol chars correctly (WODEN-166).

1) Install Apache Forrest.

2) Check out the 'Site' module from Woden SVN (note, in Eclipse as a plain 
project, not a Java project).

3) Make website changes by editing the XML files in the 
/Site/src/documentation/content folder. (you'll need to edit the file 
version_ctl.xml)

4) From a cmd line at the /Site project directory you can run the cmds 
'forrest' or 'forrest run':
Do 'forrest run' to kickoff a local web server type process then use a web 
browser to immediately review changes at http://localhost:8888/
(use Ctl-C to stop the web server process)
Do 'forrest' to generate the complete website from the XML sources.
This will re-generate the website into the /Site/build/site directory from 
the XML files in /Site/src/documentation/content.

With commit rights, you would then commit the Site changes to SVN, then 
SSH into people.apache.org, CD to /www/incubator.apache.org/woden, then 
run the command 'svn update'. This will copy build/site content to 
/www/incubator.apache.org/woden. The Apache web server will be refreshed 
from this site pretty quickly (seconds or minutes).  The Apache mirrors 
will be refreshed within a few hours.

As you don't yet have commit rights, just create patch files after step 
4), attach them to JIRA WODEN-166, then I will try out the new 
instructions on the web page and commit the code if all looks good.

thanks,
John Kaputin






Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU







---------------------------------------------------------------------
To unsubscribe, e-mail: woden-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: woden-dev-help@ws.apache.org