Date: 2005-01-09T02:54:23
   Editor: DavidCrossley
   Wiki: Cocoon Wiki
   Page: CocoonWebsiteUpdate
   URL: http://wiki.apache.org/cocoon/CocoonWebsiteUpdate

   update to Forrest-0.6

Change Log:

------------------------------------------------------------------------------
@@ -28,7 +28,9 @@
 
 ==  C) Generate site ==
 
-For the current release branch, e.g. 2.1, this is done by issuing 'build docs' 
command in the shell in cocoon-2_1_X root directory. After generation is 
complete, and a sucessful build, then the site will be ready at the 
build/cocoon-2.1.7-dev/docs/ directory.
+For the current release branch, e.g. 2.1, this is done by issuing commands 
'build docs' followed by 'forrest' in the shell in cocoon-2_1_X root directory.
+The 'build docs' prepares some additional documents ready for rendering by 
Forrest.
+After generation is complete, the site will be ready at the 
build/cocoon-X.Y.Z-dev/site/ directory.
 
 For the top-level website, just do the command 'forrest' in the top-level 
cocoon-site directory.
 After generation is complete, the site will be ready at the 
build/tmp/context/site/ directory.
@@ -37,9 +39,7 @@
 
 ===  Forrest notes ===
 
- * Use Forrest-0.5.1 (available from the 
[http://forrest.apache.org/mirrors.cgi#archive Download Archive] and follow its 
instructions to set FORREST_HOME and PATH environment variables.
- * Do not use Forrest-0.6 (the recent release) as this still needs some 
changes for Cocoon's Forrest config files.
- * Cocoon's 'build docs' command will call Forrest internally. Forrest's 
location is determined by the $FORREST_HOME environment variable and defaults 
to '../xml-forrest/build/dist/shbat/'
+ * Use Forrest-0.6 (available from the 
[http://forrest.apache.org/mirrors.cgi#archive Download Archive] and follow its 
instructions to set FORREST_HOME and PATH environment variables.
  * Out the box, Forrest will not render PNG images in PDFs (due to license 
restrictions on Jimi). You need to download Jimi from 
[http://java.sun.com/products/jimi/ Sun]. Copy the !JimiProClasses.zip file to 
$FORREST_HOME/lib/optional/jimi-1.0.jar and rebuild Forrest (cd xml-forrest; 
./build.sh clean; ./build.sh)
 
 We should soon have the [http://forrest.apache.org/ Forrestbot] facility 
running, which should make all of this vastly simpler.