-
- Now the *.ihtml and *.cwiki extensions are deprecated.=20
- To get the same functionality it is recommended to switch to=20
- *.html and *.jspwiki. With this it's now possible to have a=20
- site in simple html, edited with any html editor.=20
- The *.jspwiki extension was put to make it clear what the=20
- format is about.
- (NKB)

-
- New project sitemap extension mechanism. Now it is possible to add
- a project sitemap that plugs into the processing at the beginning.
- If the requested url is resolved by it, it will serve the file dir=
ectly.
- If the requested url with the extension changed to xml is matched,=
then
- Forrest will use that result as the intermediate format and render=
it.
- This will enable project-specific sitemaps to not collide with fut=
ure
- Forrest updates.
- (NKB)

-
Added a mechanism to enable impoverished XML tools that do not use
the Catalog Entity Resolver to fetch the DTDs direct from the webs=
ite.
See upgrading to v0.6
Please help to upgrade our /dtd/.htaccess file (see issue FOR-107)
and please help to address the SVN Issue
1233.
- (DC) Fixes FOR-107.

-
- Do not create ToC unless it has been defined on the skinconf.
- Change level attribute to max-depth attribute.
- Add a min-sections attribute to define a minimun number of section=
s=20
- before create a toc.
- (JJP)

Version 0.5 (2003-09-13)

Changes to Documentation

Version 0.4 (2003-02-12)

+

+
+

Changes to Documentation

+

-
- Added SkinconfTransformer, that augments the skinconf.xml=20
- by adding these attributes to colors if not present:
- @highlight, @lowlight, @font, @link, @vlink, @hlink.
+
+ Added page for ForrestBar on the site with a simple link and an au=
toinstall link
+ to the forrestbar.xpi generated by Gump every day.
(NKB)

+

+

+
+ =20
+
+

Version 0.3 (2003-01-30)

+

+
+

Changes to Code Base

+

-
- Now skins can get a stab at enhancing skinconf.xml, by placing
- a skinconf.xsl file in the skin directory.
- By default some values are added by the common skin, like
- default Forrest colors.
+
+ Update to 2002-12-26 Cocoon.
+ (JT)

+

+
+ Updated latest Cocoon jars: chain metamodule name set to "forrest",
+ and it is used instead of the default one.
(NKB)

+

+
+

Changes to Documentation

+

-
- Add support for Openoffice Writer 1.1 files.
- (RP)

+
+ Added enhancements to status.xml to comply with the needs for a co=
mplete status file,
+ like other "STATUS" text files at Apache.
+ Stylesheets not yet done.
+ (NKB)
+

- Now skin resources can be generated from skinconf.xml from xslt.
- For example '/myskin/css/my.css.xslt' is used by forrest on 'skinc=
onf.xml'
- to get 'my.css'
+ draft forrest toolbar for Mozilla
(NKB)

- It is now possible to have two levels of tabs.
- (NKB) Thanks to Ross Gardler=2E Fixes FOR-98.

- External links are now identified by a small trailing icon.
- The icon can be overridden by the skin and the behaviour
- can be disabled in skinconf.xml.
+ Refactored site generation stuff to use skins; still need to integ=
rate with xforrest descriptor.
+ Added jakarta-site, xml-apache-site, cocoon-printer skins.
(NKB)

-
- Added new 'tigris' skin, by using exactly the same=20
- skin version 1.1. from the project Style at http://style.tigris.or=
g/.
- This will completely replace the avalon-tigris skin in subsequent =
versions.
- The avalon-tigris skin is to be considered deprecated and no longe=
r=20
- developed.
- (NKB)

-
- New file format: '.aart'. These are text files that are converted
- automatically be Cocoon in SVG, if requested with a '.png' extensio=
n=2E
- (NKB)

-

-
- Now images are generated from the xdocs content dir as if they
- were in the resources/images dir. The latter will be phased out.
- (NKB)

-

-
- Added a new property to forrest.properties
- (project.raw-content-dir=3D${project.content-dir}/content)
- to define where raw files are to be served from.
- Also removed the internal property real-content.dir that was
- used internally for this and replaced it with a raw-content.dir
- property.
- (NKB)

-

-
- Patch facility to be used by any contributor (From Ant's project=
)=2E
- To use it run "build.[sh|bat] patch".
- (JJP) Thanks to Jan=
Materne.

-

-
- Skins can now be packaged, downloaded and automatically installed.
- See documentation.
- (NKB)

-
- Skins "forrest-css" and "avalon-tigris" are deleted. The
- "tigris-style" is renamed to "tigris". Aliases
- set in place for backward-compatibility.
- The old "forrest-site" and "krysalis-site" skins are retained for
- a little while longer,
- but are deprecated, so please move to one of the other skins.
- See notes about Default skins.
- (DB) Fixes FOR-181.

-
- Enhance the document2pod functionality to handle many other eleme=
nts
- and enable the link to this format to be configured via skinconf.
- See the issue report for some notes.
- (DC) Thanks to Rick Tessner. Fixes FOR-240.

-

-
- Updated Ant 1.6.2.
- (AG)

-

-
- Have @class attribute in DTD for every element, which enables the
- "extra-css" section in the skinconf to be put to good use.
- Updated all v1.2 DTDs to become v1.3 DTDs (forward compatibility:
- v1.2 docs will work fine as V1.3).
- Updated the v2.0a DTDs to become v2.0 DTDs (forward incompatibilit=
y:
- v1.2/1.3 docs are not forward-compatible as V2.0).
- Added demo of extra-css to the seed site and updated some
- sample docs to use new v1.3 DTDs.
- See the issue report for full list of changes.
- (DC) Thanks to Rick Tessner. Fixes FOR-174.

-
- Libraries are not copied anymore in the servlet context of
- the dist and of the project being built; they are added
- instead to the classpath of jetty for the 'run' target and
- of the Cocoon CLI for the default 'site' target.
- (NKB)

-

-
- Upgrade to Jing 20030619.
- (JJP)

-

-
- Validation is now "dynamic", by setting the parser feature
- "http://apache.org/xml/features/validation/dynamic".
- This means that documents with DTD are fully validated,
- while documents without DTD are just checked for well-formedness.
- (NKB)

-
- All resources in skins/common/images|scripts are used if the
- corresponding resource is not found in the skin being used.=20
- Moved under these dirs the images and the scripts that were place=
d by=20
- default under resources/images or copied in each skin, and added =
a=20
- temporary sitemap rule to route the request of the images to the =
new
- location.=20
- (NKB)

-

-
- Moved the images of fresh-site to the src/content/xdocs director=
y,
- for the new layout that has been decided on forrest-dev.
- (NKB)

-

-
- Major update to inner working of the krysalis-site skin:=20
- - removed all use of the spacer.gif image
- - replaced all visual enhancement icons with css icons
- - fixed CSS and html validation
- - reduced final output size,=20
- - removed all font tag usage in favor of css
- - added aural (speech) style in css
- - reduced usage of nested tables
- - refactored main xhtml stylesheet to be more clear and maintain=
able
- - refactored css to have a single small place where to define th=
e skin colors
- - changed icons to original icons (made by me and not gotten fro=
m elsewhere)
- - removed unused icons.
- - made location of minitoc configurable as "page", "menu", or "b=
oth"
- (NKB)

-

-
- Removed duplicated copying of files during the creation of the=20
- distro. Now the command-line context dir is like the webapp cont=
ext dir.
- This reduces Forrest build time from 53 to 19 seconds on my syst=
em.
- (NKB)

-
- Now CSS files are parsed internally, so that the urls are included=
in the static
- site generation.
- (NKB)

-

-
- Lucene-index target works. If search@provider=3D"lucene" is set cr=
eate a search index.
- Build site and run targets as per project directory instead of for=
rest.home.
- (JJP)

-

-
- Moved all references to //skinconfig out of the document2html.xsl
- into the site2xhtml.xsl file.
- * Rationalized the Table of Contents stuff by creating a "toc"
- mode in the common/xslt/html/document2html.xsl. That is then
- used to generate the per-page ToC and the ToC attached to the menu.
- * Removed extraneous default xsl matchers on the non-common
- document2html and site2xhtml XSLs. This allows matches
- defined in the imported transformation sheets to match
- (imported sheets have lower precedence).
- * Defined a couple of <div id=3D"..."&=
gt; place holder
- tags used by the document2html. Those are then skinned by the
- site2xhtml sheets.
- * Note: If you have your own skins that were referencing "$config"=
or
- "//skinconfig" in the document2html.xsl then you need to make simi=
lar
- changes.
- * For more information see the FOR-146 issue report.
- (DC) Thanks to Rick Tessner. Fixes FOR-146.

Version 0.5 (2003-09-13)

-
- Added ability to have version-specific overridden sitemaps. For
- example, src/documentation/sitemap-0.5.xmap will be used by Forres=
t 0.5
- in preference to any others present in the same directory. This m=
eans a
- site with overridden sitemaps can build with Cocoon versions expec=
ting
- different sitemap formats.
- (JT)

-
- On krysalis skin: users can select font size, reworked left-bar inc=
lusion
- of page section titles, made them only one level deep, moved button=
s after
- the left navbar, added publish date on top right navbar.=20
- For both Forrest and krysalis skins, added single background pixel =
line below
- unselected tabs and made selected tab more prominent.
- (NKB)

-

-
- Added XInclude capability to the documents. Remember to=20
- disable validations for files with xincludes as the xinclude is not
- performed during validation.
- (NKB)

-
- In the forrest-site skin and derivatives, display the author and v=
ersion at the
- bottom of the page, as krysalis-site does. Also added parsing for=
CVS Revision
- tags, so <version>$Revision: 1.288 =
$</version> can be used.
- (JT)

-
- The generated Tables of Contents can be configured to show a certa=
in
- number of section levels. Default is two levels. Level 0 means show
- no ToC at all. See the fresh-site skinconf.xml for example usage.
- (DC) Thanks to Ram&oac=
ute;n Prades.

-
- Created new document-v12 DTD module, containing all DTD improvemen=
ts
- made since 0.4 was released, and use it to define new v12 versions=
of
- all DTDs (document, howto, faq, etc). The doc-v12 DTD removes many
- restrictions in the DTD that were found to be unnecessary, and is =
closer
- to the HTML content model. A list of changes can be found in the doc-v12 sample page.
- (JT)

-

-
- On the forrestbar, added a community menu, made 'AskSam' a resourc=
es
- submenu, moved the search part to the right.
- (NKB)

-
- ihtml now works again. Had to add a jtidy configuration that preve=
nted it to output
- tidies html to the pipeline, thus making the stylesheet unusable. =
Also had to fix
- the sitemap schema.
- (NKB)

-
- Fixed bug that showed the krysalis-site skin in IE browsers from=20
- a remote site to start with a font size of 100.=20
- Also made the font size script kick in at the start of the
- page rendering, as before it resized only after all the page
- was loaded, which was not nice to say the least.
- (NKB)

-
- Fixed rendering of images in PDF for images not located in the
- resources/images dir.
- (SN)

-

-

- =20
-
-

Version 0.4 (2003-02-12)

-

-

-

-
- Added a minimal template skin.
- (JT)

-

-
- Added the CSS validation logo, fixed all skins' CSS to validate,
- minor fixes due to the switch to full HTML-loose DTD.
- (NKB)

-

-
- Make the forrest-site and krysalis-site skins more printer friendl=
y by
- using CSS media type to hide navigations. the avalon-tigris skin a=
lready
- works well, the forrest-site one still needs tweaking.
- (NKB)

-

-
- Use full loose DTD specification for html pages.
- This also makes the avalon-tigris skin show the same in Mozilla an=
d IE.
- (NKB)

-

-
- Switched all loglevels to ERROR.
- (NKB)

-

-
- Added page for ForrestBar on the site with a simple link and an au=
toinstall link
- to the forrestbar.xpi generated by Gump every day.
- (NKB)

-
- The problem with starting a new forked JVM is that all=20
- properties get lost. This makes it able to use one forrest.proper=
ties
- for all multiple projects, and just create the docs from there.=20
- (NKB) Thanks to Berin Lor=
itsch.

-

-
- The menu is now limited to only pages in the current subdirectory =
and
- below.=20
- (JT) Thanks to Bernhard Brandmair.

-

-
- Added the cwiki stylesheets that were missing and an example in the
- fresh site seed.
- (NKB) Thanks to Cathy Zura=
.

Version 0.3 (2003-01-30)

-

-

-

-
- Added <acronym> tag.
- (JT)

-

-
- Added a means to override the check for existing content:=20
-

forrest seed -Dskip.contentcheck=3Dyes

- Thanks to Tom Klaasen.
- (JT)

-

-
- Added the possibility to use svg files instead png images.
- That is, if an image is found in the images dir that is svg and
- the browsers requests a png with the same name, the png is created
- from the svg automatically with batik.
- (NKB)

-

-
- Added the possibility to use wiki files in xdocs instead of xml fi=
les.
- They must have a .cwiki extension, and follow the chaperon wiki fo=
rmat ATM.
- (NKB)

-

-
- Added "Edit Page" button to edit the current page in Composer.
- Still needs an icon.
- (NKB)

-

-
- Added the possibility to use html files in xdocs instead of xml fi=
les.
- They must have an .ihtml extension.
- (NKB)

-
- Removed some images (built-with-cocoon.gif, centipede-logo-small.g=
if)
- from the skins, and moved them to
- src/documentation/resources/images=
, as they are
- Forrest-specific.
- (JT)

-

-
- Lots of FAQ improvements:
-

- =20
-

- Improved URI space by using @id attributes as the
- #fragment-identifier for <faq> and <part> elements.
-

- =20
-

Number FAQ entries and categories

- =20
-

Added back-links from FAQ entries to the menu

- =20
-

Process tags in <question> in menu entries

- =20
-

Indent FAQ text

- =20
-

FAQ sample added to seed project

- =20
-

- Thanks to Joerg Pietschmann and Ralf Hauser for the suggestions.
- (JT)

-

-
- On avalon-tigris skin it's now possible to add a mysite.css file
- to customize the style. An example that can be used is from
- chaperon.sf.net.
- Also added a rounded corner to paragraphs, and many minor fixes.=20
- (NKB) Thanks to Stefan Mich=
els.

-

-
- Fixed the annoying link highlighting on the krysalis skin=20
- due to the border. Removed the border, now it highlights fine.
- (NKB)

-

-
- Updated part of the editor so that it now can save files in wiki f=
ormat.
- Still needs more work.
- (NKB)

-

-
- Updated Batik Block so that now PNGs can be created correctly from=
SVG.
- (NKB)

-
- Updated avalon-tigris skin by merging what was in CVS here and
- what was used in Avalon with its Cocoon-generated site. =20
- The visual effect is the same to the current framework and Exalibur
- Avalon sites.
- (NKB)

-

-
- Updated latest Cocoon jars: chain metamodule name set to "forrest",
- and it is used instead of the default one.
- (NKB)

-

-
- Rewrite skins to share a common block of XSLT, which is used via
- <xsl:import>. This should make skin maintenance much easier.
- (JT)

-

-
- Added enhancements to status.xml to comply with the needs for a co=
mplete status file,
- like other "STATUS" text files at Apache.
- Stylesheets not yet done.
- (NKB)

-
- forrest-site skin is now HTML 4.0.=
1 compliant. The
- compliance validator logo can be switched off with a
- skinconf.xml element.
- (JT)

-

-
- Indirectly referenced files in skins (e.g. images in
- CSSurl()'s) are now copied across =
to the rendered site.
- Previously, we relied on spidering to cover the URI space, which h=
as
- proved insufficient.
- (JT)

-

-
- HTML fragment identifiers for sections are now meaningfully named,=
based
- on the section title, rather than documen=
t-id()-generated
- characters.
- (JT)

-

-
- Fixed site regeneration bugs where changing the skin in
- forrest.properties had no effect a=
fter the first build.
- (JT)

-

-
- Now all files in src/documentation/conten=
t (except xdocs)
- and src/documentation/resources/images are copied across
- when Forrest generates a static site. This fixes the problem when=
an
- unparseable file links to another, and Cocoon can't crawl (and hen=
ce
- copy) the linked-to file. An example of this are CSS
- url('foo.png') image refs (so krys=
alis-site will now work
- properly). Also, large batches of pregenerated files like Javadoc=
s will
- now be copied across instead of individually traversed.
- (JT)

-

-
- Now files present in the content dir are correctly linked and
- copied verbatim by the CLI. The wellknown files are given with the
- correct mime-type, and links in html and xml are followed.=20
- (NKB)

-

-
- Fixed a bug in the search form where there was no space between se=
arch
- term and 'site:' term. Search form also no longer requires Javasc=
ript.
- (JT) Thanks to Nick Chalko=
.

-

-
- Fixed a bug where the no menu entry is 'selected' when in subdirec=
tories.
- (JT)

-

-
- Now error reporting in CLI runs should work and show the cause of =
the error;
- before it was just reporting [broken link].
- (NKB)

-

-
- Fixed a bug where multiple menu entries are highlighted if the fil=
enames
- share a common prefix.
- (JT)

-

-
- Fixed a bug in forrest.bat, which would fail if run from a differe=
nt
- drive to that Forrest was installed in.
- (JT) Thanks to Omar Belhaj=2E