Forrest is an XML standards-oriented project documentation framework based on Apache Cocoon, providing XSLT stylesheets and schemas, images and other resources. Forrest uses these to render the XML source content into a website via command-line, robot, or a dynamic web application.
This will create a "shbat" distribution in
build/dist/shbat, or whever the
dist-shbat.dirproperty is set to. You should now add the
build/dist/shbat/bindirectory to your PATH variable.
If you have done this correctly, you are now ready to test out Forrest! Here are three things to try:
forrestin this (Forrest's source distribution) directory. It should chug along for a good while (Forrest's site is quite large), and render the HTML and PDFs to
forrest runin this directory. You can then point your browser to http://localhost:8888/, and view the Forrest website generated dynamically. Experiment with editing docs in
build/webapp/content/xdocs, and watch them be (nearly) instantly rendered.
forrest seed. This will generate a skeleton directory structure and template XML. If you like, edit the XML in
src/documentation/content/xdocs. Now type
forrestto render your new site, or
forrest runto generate a webapp.
For further information, please read our Getting Started guide. If you have any questions or suggestions, please subscribe to the forrest-dev mailing list.
Thanks for using Apache Forrest!