Sources are also available in the release

Each release of forrest contains a copy of all sources as at the time
of the release. So the building instructions below do apply to that.
Of course the svn method described above will provide the most up-to-date
version for developers.

Building and installing Forrest

Note

This document applies to this specific version. See other
instructions for the
development
version.

To build Forrest, change directory to 'forrest/main', and
then type 'build' on Windows or './build.sh'
on Unix. (Requires Java 1.4) If everything is successful, you should see
a message similar to:

*-----------------------------------------------------------------
| Installation notice
*-----------------------------------------------------------------
| You have built the X.Y-dev version of Forrest.
| Please set the environment variable FORREST_HOME point to
| /svn/forrest
| It is recommended to add
| unix: $FORREST_HOME/bin: to your $PATH
| win: %FORREST_HOME%\bin; to your %PATH%
| Then do 'forrest -projecthelp' to list options for the 'forrest' command
| More help at http://forrest.apache.org/
*-----------------------------------------------------------------

As the message says, you need to add the distribution's
bin/ ("binary") directory to your PATH variable, so the
'forrest' command is available everywhere:

After updating the Forrest source from SVN, if there have been certain
types of updates (e.g. Java sources, supporting libraries, build system,
etc.) you will need to clean and build forrest again. Do 'cd
forrest/main; build clean; build".

Run Forrest, run!

Forrest is now ready to go. To view and edit the local copy of Forrest
core documentation, cd to site-author and do 'forrest run'
to see the local webapp using the bundled Jetty server. Edit something
in content/xdocs/*.xml see the immediate effect.