Apache Forrest Changelog

What's new in Apache Forrest 0.9

Feb 1, 2013
  • Changes to Build:
  • Added standalone 'validate-status' build target to validate the project status changes file. Committed by DC.
  • fix Explicitly set the javac target@ to our defined base version. This fixed an issue with plugins being deployed by committers using more recent versions. Committed by DC. Thanks to Ron Blaschke.
  • Forrest minimum Java version is now Java 1.5 required starting with Forrest-0.9-dev Committed by GM.
  • The preparation of the set of xmlcatalogs is better done in our "validation-props" ant target. Committed by DC. Thanks to Thomas Emmel. See Issue FOR-1131, FOR-1020.
  • A better way to report the set of xmlcatalog files being used. Committed by DC.
  • Changes to the Code Base:
  • initial "Markdown" output plugin to Whiteboard. Committed by DC.
  • Added new search facility to ForrestBar to enable search for a mail Message-Id (only at Gmane.org). Committed by DC.
  • Added initial output plugin "iCal" to the whiteboard. Committed by SNM.
  • Enabled use of EXSLT extensions via exslt.org stylesheets. See example "EXSLT" in the 'forrest seed-sample' site. Committed by DC. See Issue FOR-1176.
  • Enabled the filtering of output messages from Ant (see FAQ) and explained how to enable coloured output (see FAQ). Committed by DC. See Issue FOR-1178.
  • Assist with xml debugging. Show list of catalog descriptors being used. Committed by DC.
  • Enable our ASF mirrors system to present an xml listing of the client's closest mirrors. Committed by DC.
  • Added a demonstration of using xml source documents without declaring a DTD. See example "no-dtd" in the 'forrest seed-sample' site. Committed by DC. See Issue FOR-1173.
  • Added the ability to use RELAXNG to validate intermediate xml. Do 'localhost:8888/index.validation.xml' for example to validate the "index" page. Also see how to validate intermediate content for the whole site. Committed by DC. See Issue FOR-1172.
  • Added the ability for a "trademark statement" at bottom of all pages. For configuration details, see skinconf.xml from a new "seed" site. Committed by DC. See Issue FOR-1170.
  • Enable configuration of some Cocoon sitemap components, e.g. output html encoding and document type declaration for html and xhtml serializers, JTidy properties file location for html generator. See FAQ Committed by DC. See Issue FOR-1071.
  • Added initial whiteboard input plugin "baetle". Handle Baetle, the RDF vocabulary to describe the content of bug databases. Committed by GM. Thanks to Sina K. Heshmati. See Issue FOR-1038.
  • Added input plugin "uk.ac.osswatch.forrest.input.sourceforge". Extracts data from sourceforge.net Committed by RDG.
  • Added input plugin "uk.ac.osswatch.forrest.input.ohloh". Extracts data from OhLoh.net using their API. Committed by RDG.
  • Added input plugin "uk.ac.osswatch.forrest.input.features". Allow project features to be recorded and rendered as part of a content object. This plugin is particularly useful when used in conjunction with the DOAP plugin. Committed by RDG.
  • Added initial whiteboard input plugin "doac". Handle Description-Of-A-Career (DOAC) data in forrest content objects. Committed by GM. Thanks to Oshani Senevira. See Issue FOR-1039.
  • Added output plugin "uk.ac.osswatch.forrest.themes". A theme used by the Simal project. Committed by RDG.
  • Added initial whiteboard input plugin "skos". Handles input documents as Simple Knowledge Organisation Systems (SKOS), a set of specifications to support the representation of thesauri, classification schemes, taxonomies, etc. Committed by RDG. Thanks to Sina K. Heshmati. See Issue FOR-1004.
  • Added initial whiteboard input plugin "foaf". Handles input documents in Friend of a Friend (FOAF) format. Committed by GM. Thanks to Oshani Senevira. See Issue FOR-1002.
  • Added initial whiteboard input and output plugins "tei". These handle TEI-Lite Text Encoding Initiative (TEI). Committed by RDG.
  • Enable PHP by default. See the FAQ. Thanks to Cyriaque Dupoirieux for the suggestion. Committed by DC.
  • fix Suppress extra generated id when converting xdoc sections to html. See upgrading notes. Committed by BMD.
  • fix ForrestBar: Enabled access to some more intermediate processing data via the "Dev" menu. Committed by DC. See Issue FOR-1012.
  • fix The "class" attributes in the document-v13 and document-v20 DTDs now enable multiple space-separated class definitions. Committed by DC. Thanks to Brolin Empey.
  • fix Enable "class" attribute to be used for "body" element. Committed by GM. Thanks to Sina K. Heshmati. See Issue FOR-1167.
  • fix Some improvements for the "whole-site" PDF ability. Committed by BMD. Thanks to Andreas Lehmkuehler. See Issue FOR-211.
  • fix There was a problem with plugins libs not being copied. Using the war task from ant fixes this issue. Committed by TS. See Issue FOR-1074.
  • fix Enabled the output html serializer to be configurable to either xhtml or html. Committed by DC. See Issue FOR-1156.
  • fix Remove extraneous quote in document-to-fo.xsl Committed by DC. Thanks to Antoine ROBERT. See Issue FOR-1136.
  • fix There was a partially implemented xml catalog with missing project symbols file. Only affected users of the 'seed-basic' template site. See notes in upgrading to v0.9 Committed by DC. See Issue FOR-1075.
  • fix Fixed the "forrest" command to cope with recent Cygwin changes with expanding pathnames. Committed by RDG. Thanks to Mark Eggers. See Issue FOR-905.
  • fix The "faq" documents were missing generated Table-of-Contents. Committed by TS.
  • fix Fixed bug regarding logging and Servlet Container when using Forrest as a WAR archive. In web.xml use context parameters instead of init-param. Committed by TS. See Issue FOR-1049.
  • fix ForrestBar: Re-instated access to some intermediate processing data via the "Dev" menu (**/*.xml and **/*.fo) Committed by GM. See Issue FOR-1012.
  • Fix hard-coded path in ForrestLogTargetFactory and ForrestConfUtils which caused files to be placed in the wrong directory when using ForrestBot. Committed by BMD. Thanks to Richard Calmbach,Mathieu Champlon. See Issue FOR-752.
  • ForrestBar added search options for Gossamer Threads archives and MarkMail archives. Committed by DC.
  • ForrestBar updated to clarify some menus and items, some tooltips, and fix some broken links. Committed by DC.
  • Improve startup performance by dealing with only the specified property rather than iterating through all of them. Committed by DC. Thanks to DeBel. See Issue FOR-1203.
  • Fix syntax errors for import of additional style sheets for "tigris" skin. Committed by DC. Thanks to Simon Pepping. See Issue FOR-1205.
  • Updated Ehcache to 2.2.0 version. commons-io, commons-jxpath, commons-collections, commons-lang, and commons-cli to latest versions. Committed by TWW.
  • Use plain svn commands rather than JSVN for forrestbot and plugins deployment. Committed by DC. Thanks to David Crossley, Tim Williams. See Issue FOR-1198.
  • Switch to a new XML module providing better memory behavior. Committed by TWW. See Issue FOR-591.
  • Fix property "project.issues-rss-url" to use https for our JIRA. Committed by TWW. Thanks to Andreas Lehmkuehler.
  • Rhino to better licensed version rhino-1.6R5 Committed by TWW. See Issue FOR-1177.
  • For Howto docs, make use of generateId.xsl to resolve warnings in generated PDF. Committed by BMD.
  • Improved SVG template for generating "project name" image. Make it wider and small space at right-hand end. Committed by DC. See Issue FOR-1186.
  • Changed XSLT import statements in skins to use the LocationMap. Committed by BMD. See Issue FOR-1000.
  • Replaced the custom caching implementation with EHCache in the LocationMap feature. Given how integral the LM has become, this gives us much better overall performance, concurrent behavior, and cache configuration options. Added a default cache config file to main/webapp/WEB-INF/ehcache.xml Committed by TWW. See Issue FOR-1031.
  • Forrestbot deploy.scp workstage now reports which files were transferred. Committed by DC.
  • Updated to Jing release (from http://code.google.com/p/jing-trang/). As well as providing us with a reliable RELAX NG tool, this upgrade fixes an issue on some Java 6 with missing datatype library. Committed by DC. See Issue FOR-984.
  • Updated to Apache-Ant-1.7.1 release. Also jsch-0.1.28 to jsch-0.1.39 release. Committed by DC.
  • Added a 'forrest diagnostics' target which reports our Ant's diagnostics. Committed by DC.
  • Our packaged version of Apache Cocoon has been upgraded to use the latest version of their stable 2.1 branch. This is a major step forward for Forrest. It enables us to use a reliable and up-to-date Cocoon. Forrest developers can again participate at Cocoon to fix issues or develop new blocks. A number of major performance issues are already fixed in this version. Also upgraded various other important supporting products such as Apache Xerces and Apache Xalan, etc. See upgrading notes. Committed by TS. Thanks to Thorsten Scherler, David Crossley. See Issue FOR-955, FOR-1017.
  • Promoting the output.inputModule plugin to core. Main reason for the move is to prevent plugins dependencies since the code has attracted different use cases solved in plugins to move it into core. Committed by TS. See Issue FOR-1103.
  • Upgraded Apache FOP to version 0.95 Committed by JM.
  • Added ability to use XInclude to the document-v20 xdoc DTD. See an example in a 'forrest seed-sample' site. Committed by DC. See Issue FOR-1032.
  • Images had not been reliably reproduced in PDFs (fop version prior to 0.94). The old way always expected a physical URI (file or http) the new fop URIResolver in the FOP-NG block delegates to Cocoon's SourceResolver framework, meaning images can be the result of a pipeline. Committed by TS. See Issue FOR-635.
  • Moved fo- and pdf-generation completely into pdf-plugin as part of the upgrade to fop 0.94. See plugin docs for addition details. Committed by FSO.
  • The "wholesite" html/pdf ability was broken with the locationmap. Committed by TS. See Issue FOR-733.
  • Re-configured Forrest Zone to use SMF. Committed by GM. See Issue FOR-940.
  • Fix unkown font error in FO generation. Committed by RDG. Thanks to Uwe Kreibaum. See Issue FOR-640.
  • Utilise the source document/header/link if available. Suggested by Oshani Seneviratne and various previous people. Committed by DC.
  • In SourceTypeAction, RDF files need to check the namespace of more than just the root element. Committed by DC. Thanks to Sina K. Heshmati. See Issue FOR-1018.
  • Added method to make URLs absolute in PDF via skinconf.xml. Committed by BMD. Thanks to Patrick Ohly. See Issue FOR-1013.
  • Added method to disable table of contents in PDF via skinconf.xml. Committed by BMD. Thanks to Patrick Ohly. See Issue FOR-355.
  • Changes to Documentation:
  • Added document to facilitate upgrading to v0.9 Committed by DC.
  • Added an FAQ to try to explain that Forrest does not require Java 6. Committed by DC. See Issue FOR-984.
  • Added new documents: How to deploy documentation with the Forrestbot "svn" workstage which explains how the Apache Forrest project manages their project documentation, and How to deploy documentation with the Forrestbot "scp" workstage which explains how to manage a personal or company website using Secure Shell SCP to deploy the generated documents. Committed by DC.
  • Added example of using XInclude to the 'forrest seed-sample' site. Committed by DC. Thanks to Carlos Tejo. See Issue FOR-814.
  • Added documentation about using the "Debian update-alternatives system". Committed by GM. Thanks to Steven Coco. See Issue FOR-1047.
  • Added FAQ for "Windows gets confused about which Java version to use". Thanks to Ron Blaschke and Ross Gardler. Committed by DC. Thanks to Ron Blaschke.
  • fix Fixed docs in several places to work with fop94 upgrade. Committed by FSO.
  • fix Fix some menu items, links and version labels. Committed by TS. Thanks to Bart Molenkamp.
  • Added an FAQ to explain "svn:eol-style" and un-necessary svn diffs. See also How to deploy documentation with the Forrestbot "svn" workstage. Committed by DC.
  • Improved the FAQ about "version and properties" and linked to the documentation of the new Properties system. Committed by DC.
  • Improve ASF Branding and trademark statements for Forrest websites. Committed by DC. See Issue FOR-1197.
  • Improved the Sitemap Reference document. Committed by BMD. See Issue FOR-922.
  • For packaged supporting products, we now refer to all licenses from our top-level LICENSE.txt file. Committed by DC. See Issue FOR-855, FOR-857.
  • Improve i18n FAQ. Committed by DC.
  • Improvements to documentation for i18n and example. See the "seed-sample" site. Committed by GM. Thanks to Thomas Witteriede. See Issue FOR-707.
  • Improvements to documentation for Locationmap. Committed by GM. Thanks to Thomas Emmel. See Issue FOR-1160.
  • Improved FAQ about reporting security issues and link to "ASF Security Team" new web site. Committed by DC.
  • Added demonstration of more xdoc elements to the sample document-v20 Committed by DC. Thanks to Carlos Tejo. See Issue FOR-1062.
  • Enhance the "HowTo Generate an ASF mirrors page" doc to better explain. Refer to Forrest site-author as an example. This doc explains many things which are useful beyond the "ASF mirrors" example. It shows how to a specialised HTML form to a forrest-based site, howto to include and exclude non-linked extra documents to the processing using the Cocoon CLI. Committed by DC.
  • Refer to ForrestBar from How to do development with Apache Forrest as a way to easily view the internal processing steps. Committed by DC.
  • explanation of ForrestBar menu items. Committed by CD.
  • more entries to glossary to explain some Apache Cocoon terminology and link to relevant docs. Also some more Forrest terminology. Committed by DC.