Dear Wiki user, You have subscribed to a wiki page or wiki category on "Cocoon Wiki" for change notification.
The following page has been changed by DavidCrossley: http://wiki.apache.org/cocoon/CocoonWebsiteUpdate ------------------------------------------------------------------------------ * CocoonReleaseHowTo = WHERE DOES THE WEBSITE CONTENT COME FROM? = - A big part of the website content comes from the http://svn.apache.org/repos/asf/cocoon/site/ repository. + The website content comes from the http://svn.apache.org/repos/asf/cocoon/site/ repository. The src subdirectory contains the content that we write (in xdoc format), and the corresponding website pages (generated by Forrest) are committed to the site subdirectory, to make it easy to update or restore the content on the live web server. This means that any manual changes to pages in the site subdirectory are ''lost'' when the site is regenerated using Forrest. - The source of the http://cocoon.apache.org/ index page, for example, is found at http://svn.apache.org/repos/asf/cocoon/site/src/documentation/content/xdocs/index.xml + The source of the top-level http://cocoon.apache.org/ index page, for example, is found at http://svn.apache.org/repos/asf/cocoon/site/src/documentation/content/xdocs/index.xml = HOW ABOUT DAISY? = - Since 2.1.8, the documentation (apart from the general website pages) is written using daisy at http://cocoon.zones.apache.org/, and Daisy-generated pages are processed by Forrest to generate the static pages at http://cocoon.apache.org/2.1/. + Since 2.1.8, the documentation (apart from the general website pages) is written using daisy at http://cocoon.zones.apache.org/, and Daisy-generated pages are processed by Forrest (using forrest trunk) to generate the static pages at http://cocoon.apache.org/2.1/ (still in experimental phase). - People are still working out the details of this process, we should document it here when it's stabilized. + People are still working out the details of this process, we should document it here when it's stabilized. For the meantime, see below for how to produce the documentation. = HOW TO UPDATE AN APACHE COCOON WEBSITE = @@ -53, +53 @@ 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 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-2.1.X-dev/site/ directory. + Warning: Some recent changes have broken this (e.g. the src/documentation/xdocs/index.xml seems to be missing). === Forrest notes === - * Use Forrest-0.7 - need the release branch https://svn.apache.org/repos/asf/forrest/branches/forrest_07_branch + * Use Forrest-0.7 for the top-level docs - need the release branch https://svn.apache.org/repos/asf/forrest/branches/forrest_07_branch + * Use Forrest-0.6 for the 2.1 docs (or update the configuration to use forrest-0.7). * Out of 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 We should soon have the [http://forrest.apache.org/ Forrestbot] facility running, which should make all of this vastly simpler.
