Return-Path: Delivered-To: apmail-forrest-svn-archive@www.apache.org Received: (qmail 56989 invoked from network); 15 Oct 2004 12:33:55 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 15 Oct 2004 12:33:55 -0000 Received: (qmail 39225 invoked by uid 500); 15 Oct 2004 12:33:53 -0000 Delivered-To: apmail-forrest-svn-archive@forrest.apache.org Received: (qmail 39131 invoked by uid 500); 15 Oct 2004 12:33:52 -0000 Mailing-List: contact svn-help@forrest.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: "Forrest Developers List" Delivered-To: mailing list svn@forrest.apache.org Received: (qmail 39110 invoked by uid 99); 15 Oct 2004 12:33:51 -0000 X-ASF-Spam-Status: No, hits=-10.0 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.28) with SMTP; Fri, 15 Oct 2004 05:33:36 -0700 Received: (qmail 56704 invoked by uid 65534); 15 Oct 2004 12:33:33 -0000 Date: 15 Oct 2004 12:33:33 -0000 Message-ID: <20041015123333.56700.qmail@minotaur.apache.org> From: crossley@apache.org To: svn@forrest.apache.org Subject: svn commit: rev 54849 - in forrest/site: . docs howto X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N Author: crossley Date: Fri Oct 15 05:33:32 2004 New Revision: 54849 Modified: forrest/site/body-index.html forrest/site/build.html forrest/site/changes.html forrest/site/changes.pdf forrest/site/changes.rss forrest/site/changes.xml forrest/site/contrib.html forrest/site/docs/cap.html forrest/site/docs/catalog.html forrest/site/docs/compliance.html forrest/site/docs/document-v12.html forrest/site/docs/document-v12.pdf forrest/site/docs/document-v13.dtdx.html forrest/site/docs/document-v13.html forrest/site/docs/document-v13.pdf forrest/site/docs/document-v13.pod forrest/site/docs/document-v13.xml forrest/site/docs/document-v20.dtdx.html forrest/site/docs/document-v20.html forrest/site/docs/document-v20.pdf forrest/site/docs/document-v20.pod forrest/site/docs/document-v20.xml forrest/site/docs/dreams.html forrest/site/docs/dtd-docs.html forrest/site/docs/faq-v13.dtdx.html forrest/site/docs/faq-v20.dtdx.html forrest/site/docs/forrest-contract.html forrest/site/docs/forrestbar.html forrest/site/docs/forrestbot-web-interface.html forrest/site/docs/forrestbot.html forrest/site/docs/howto-v13.dtdx.html forrest/site/docs/howto-v20.dtdx.html forrest/site/docs/libre-intro.html forrest/site/docs/linking.html forrest/site/docs/linking.pdf forrest/site/docs/oowriter.html forrest/site/docs/primer.html forrest/site/docs/project-sitemap.html forrest/site/docs/searching.html forrest/site/docs/sitemap-ref.html forrest/site/docs/sitemap-ref.pdf forrest/site/docs/skin-package.html forrest/site/docs/skins.html forrest/site/docs/upgrading_05.html forrest/site/docs/upgrading_06.html forrest/site/docs/upgrading_06.pdf forrest/site/docs/validation.html forrest/site/docs/wiki-sample.html forrest/site/docs/your-project.html forrest/site/docs/your-project.pdf forrest/site/faq.html forrest/site/faq.pdf forrest/site/faq.xml forrest/site/forrest-issues.html forrest/site/forrest-issues.pdf forrest/site/howto/howto-asf-mirror.html forrest/site/howto/howto-howto.html forrest/site/howto/howto-pdf-tab.html forrest/site/howto/index.html forrest/site/index.html forrest/site/index.pdf forrest/site/index.xml forrest/site/license.html forrest/site/linkmap.html forrest/site/live-sites.html forrest/site/mail-lists.html forrest/site/menu-index.html forrest/site/mirrors.html forrest/site/tab-index.html forrest/site/todo.html forrest/site/who.html Log: The 0.6 release, upgrade the "download" mirror page and News section. Also backlog of various other changes. Fixes broken document type description. Modified: forrest/site/body-index.html ============================================================================== --- forrest/site/body-index.html (original) +++ forrest/site/body-index.html Fri Oct 15 05:33:32 2004 @@ -1,4 +1,4 @@ - + @@ -40,9 +40,9 @@

Apache Forrest is an XML standards-oriented documentation framework - based on Apache Cocoon, providing XSLT stylesheets and schemas, images - and other resources. Forrest uses these to render the source - content into a website via command-line, robot, or a dynamic web + based upon Apache Cocoon, providing XSLT stylesheets and schemas, + images and other resources. Forrest uses these to render the source + content into a website via command-line, robot, or dynamic application.

@@ -216,7 +216,7 @@ releases. It is certainly usable now (despite not yet being version 1.x). See the growing list of example sites including - Many Apache sites. + many Apache sites.

In general, prior to 1.0, ensuring quality of design will be considered @@ -252,28 +252,32 @@

    -
  • The Forrest project has evolved to become a "top-level" Apache - project. We are making good progress towards the 0.6 release - which has many efficiency and usability improvements. +
  • Apache Forrest 0.6 was released on 2003-10-15. Uses all resources + in-place so no more copying; workflow and productivity improvements; + project sitemaps get first chance processing then pass-through + to core sitemaps; new skins use CSS rather than tables and are + configurable; enhanced forrestbot. +
    • -
  • Apache Forrest 0.5 was released on 2003-09-13 - much faster, new flexible - tab and menu system, numerous skin improvements, support for a sub-set - of DocBook and Wiki source formats, - improved PDF output, eased maintenance of sitemaps, and more. +
  • The Forrest project has evolved to become a "top-level" Apache + project.
- +

Help Wanted!

test -

- Apache Forrest is fairly new, and is in need of developers. If you know (or - want to learn) XML, Ant, HTML or CSS, then you are qualified to help! + Apache Forrest is fairly new, and is in need of developers. + If you know (or want to learn) any of XML, Ant, HTML, XSLT, or CSS, + then you are qualified to help.

As with all Apache projects, Forrest is a meritocracy; the more you Modified: forrest/site/build.html ============================================================================== --- forrest/site/build.html (original) +++ forrest/site/build.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Building Forrest @@ -49,7 +49,7 @@ +-->

-  + 
@@ -108,22 +108,22 @@
Modified: forrest/site/changes.html ============================================================================== --- forrest/site/changes.html (original) +++ forrest/site/changes.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + History of Changes @@ -49,7 +49,7 @@ +-->
-  + 
@@ -108,46 +108,46 @@
@@ -179,7 +179,10 @@
  • -Version 0.6-dev (unreleased) +Version 0.7-dev (not yet released) +
    • +
  • +Version 0.6 (2004-10-15)
  • Version 0.5.1 (2003-10-06) @@ -205,8 +208,14 @@ RSS

    - -

    Version 0.6-dev (unreleased)

    + +

    Version 0.7-dev (not yet released)

    +
    +
      +
      + + +

      Version 0.6 (2004-10-15)

      • @@ -342,7 +351,7 @@ add Information about the new forrest-user - mail list + mail list. (JJP)
      • add @@ -365,7 +374,7 @@ (DB)
      • add - Do not create TOC unless it has been defined on the skinconf. + 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 sections before create a toc. @@ -428,7 +437,7 @@ (NKB)
      • add - It's now possible to have two levels of tabs. + It is now possible to have two levels of tabs. (NKB) Thanks to Ross Gardler. Fixes FOR-98.
      • add @@ -519,7 +528,7 @@ remove The .ehtml files have been deprecated. Use .ihtml instead. Future html input support will be based on this - discussion + discussion. (DB) Fixes FOR-131.
      • remove @@ -527,7 +536,7 @@ (JJP)
      • remove - Forrest-targets with ant proxy is obsolete; use forrestbot now + Forrest-targets with ant proxy is obsolete; use forrestbot now. (DB) Fixes FOR-140.
      • update @@ -629,15 +638,15 @@ (JJP)
      • update - 'build patch' command updated for SVN + 'build patch' command updated for SVN. (DB) Fixes FOR-137.
      • update - Completely rewritten Lucene-based index and search functionality + Completely rewritten Lucene-based index and search functionality. (JJP) Thanks to Florian G. Haas. Fixes FOR-9.
      • update - Converted repository from CVS to SVN + Converted repository from CVS to SVN. (DB) Thanks to Apache Infrastructure.
      • update @@ -653,7 +662,7 @@ (AG)
      • update - Add i18n to tabs + Add i18n to tabs. (JJP)
      • update @@ -674,14 +683,14 @@ (NKB)
      • update - Upgrade to Jing 20030619 + Upgrade to Jing 20030619. (JJP)
      • update 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-formdness. + while documents without DTD are just checked for well-formedness. (NKB)
      • update @@ -830,6 +839,23 @@ (JJP)
      • fix + docbook2document.xsl: remove unnecessary / from template matches. + (JJP) Thanks to Sean Wheller. Fixes FOR-317.
        • +
      • +fix + docbook2document.xsl: docinfo element. never in OASIS Docbook XML DTD + (JJP) Thanks to Sean Wheller. Fixes FOR-316.
        • +
      • +fix + docbook2document.xsl: handle the xref and xreflabel. + (DC) Thanks to Sean Wheller. Fixes FOR-308.
        • +
      • +fix + Proper positioning of icon/links for PDF, XML, POD, Print content + options on pelt skin. + (DC) Thanks to Arturo Vazquez.
        • +
      • +fix Allow forrest to run in a project directory with a space in the name. (DB) Fixes FOR-267.
      • @@ -926,7 +952,7 @@ (JJP) Fixes FOR-139.
      • fix - "Warning" was mistakenly labeled as "Note" in PDF + "Warning" was mistakenly labeled as "Note" in PDF. (JJP) Thanks to Nick Chalko. Fixes FOR-136.
      • fix @@ -960,7 +986,7 @@ (JJP)
      • fix - Toc element is optional on skinconf. + ToC element is optional on skinconf. (JJP)
      • fix @@ -977,7 +1003,7 @@ (JJP)
      • fix - Wrong directory being used for wiki grammars + Wrong directory being used for wiki grammars. (JJP)
      • fix @@ -1022,7 +1048,7 @@
      - +

      Version 0.5.1 (2003-10-06)

        @@ -1067,7 +1093,7 @@
      - +

      Version 0.5 (2003-09-13)

        @@ -1453,7 +1479,7 @@
      - +

      Version 0.4 (2003-02-12)

        @@ -1539,7 +1565,7 @@
      - +

      Version 0.3 (2003-01-30)

        @@ -1801,7 +1827,7 @@
      - +

      Version 0.2 (2002-11-16)

        @@ -1823,7 +1849,7 @@
      - +

      Version 0.2rc1 (2002-11-13)

        Modified: forrest/site/changes.pdf ============================================================================== Binary files. No diff available. Modified: forrest/site/changes.rss ============================================================================== --- forrest/site/changes.rss (original) +++ forrest/site/changes.rss Fri Oct 15 05:33:32 2004 @@ -1,1181 +1,2 @@ -Forrest Changeshttp://forrest.apache.org/changes.htmlForrest Changesen-usdocs addhttp://forrest.apache.org/changes.htmldocs add - by - DC - : - - - Added new document to facilitate - upgrading to v0.6 - core updatehttp://forrest.apache.org/changes.htmlcore update - by - AG - : - - Updated commons-collections to 3.1, - commons-logging to 1.0.4, jcs to 1.1-dev.20040811, lucene to 1.4.1 - skins updatehttp://forrest.apache.org/changes.htmlskins update - by - DC - : - - Enable email address obfuscation to be configurable using the - obfuscate-mail-value option in skinconf.xml - core fix - (bug FOR-267) - http://forrest.apache.org/changes.htmlcore fix - by - DB - (fixes bug FOR-267) - - : - - Allow forrest to run in a project directory with a space in the name. - core fix - (bug FOR-262) - http://forrest.apache.org/changes.htmlcore fix - by - JJP - (fixes bug FOR-262) - - : - - Openoffice2forrest: add support for merged cells in tables. - skins fixhttp://forrest.apache.org/changes.htmlskins fix - by - TS - : - - Fixed the domain bug of the searchbox in pelt. - skins fixhttp://forrest.apache.org/changes.htmlskins fix - by - TS - : - - Fixed the menu in pelt by adding getMenu.js and changing the site2xhtml.xsl. - Now the chapter image will get expand again. - skins addhttp://forrest.apache.org/changes.htmlskins add - by - TS - : - - getMenu.js - fixes a path issue and the double click behaviour of pelt. - core addhttp://forrest.apache.org/changes.htmlcore add - by - TS - : - - Explained the usage of the extra-css element in skinconf.xml of the fresh site. - core addhttp://forrest.apache.org/changes.htmlcore add - by - DC - : - - Initial Chaperon grammar for minimal MoinMoin Wiki to Forrest xdocs - transformation. Source documents use the *.moinwiki filename extension. - Thanks to Fabio Rinaldi.core addhttp://forrest.apache.org/changes.htmlcore add - by - NKB - : - - Requesting linkmap.html Forrest now renders the site.xml - file as a table of contents. - core addhttp://forrest.apache.org/changes.htmlcore add - by - NKB - : - - Now the *.ihtml and *.cwiki extensions are deprecated. - To get the same functionality it is recommended to switch to - *.html and *.jspwiki. With this it's now possible to have a - site in simple html, edited with any html editor. - The *.jspwiki extension was put to make it clear what the - format is about. - core addhttp://forrest.apache.org/changes.htmlcore add - by - 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 directly. - 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 future - Forrest updates. - core fix - (bug FOR-268) - http://forrest.apache.org/changes.htmlcore fix - by - DC - (fixes bug FOR-268) - - : - - Relative URIs with absolute paths were broken in the site.xml - linking mechanism. - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - DC - : - - Re-write the Chaperon grammar for JSPWiki to address ambiguity with - paragraphs and sub-sections. - Thanks to Fabio Rinaldi.plugins addhttp://forrest.apache.org/changes.htmlplugins add - by - DB - : - - Added configuration for XMLMind XML Editor to scratchpad. Originally - from splike.com - core updatehttp://forrest.apache.org/changes.htmlcore update - by - DC - : - - Enhance the document2pod functionality to handle many other elements - and enable the link to this format to be configured via skinconf. - See the issue report for some notes. - Thanks to Rick Tessner.skins addhttp://forrest.apache.org/changes.htmlskins add - by - DC - : - - Automatically add some meta elements to head of html - (Generator name, Forrest version, skin name) - skins addhttp://forrest.apache.org/changes.htmlskins add - by - DC - : - - Optional feedback link for the footer of all skins. - core addhttp://forrest.apache.org/changes.htmlcore add - by - DC - : - - New output format for POD (the Perl community's Plain Old Documentation) - triggered using the .pod filename extension. - Initial work, needs enhancement. See - forrest-dev - discussion - Thanks to Rick Tessner.code addhttp://forrest.apache.org/changes.htmlcode add - by - RDG - : - - Eclipse plugin code added to scratchpad (donated by Burrokeet). - Initial work, needs enhancement. - skins removehttp://forrest.apache.org/changes.htmlskins remove - by - DB - : - - 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. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - AG - : - - Updated Ant 1.6.2. - core fix - (bug FOR-214) - http://forrest.apache.org/changes.htmlcore fix - by - DB - (fixes bug FOR-214) - - : - - JCS log messages go through cocoon instead of to stdout. - core fix - (bug FOR-226) - http://forrest.apache.org/changes.htmlcore fix - by - DB - (fixes bug FOR-226) - - : - - Generate proper html for figures in simplified docbook. - Thanks to Johannes Schaefer.core updatehttp://forrest.apache.org/changes.htmlcore update - by - DC - : - - 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 incompatibility: - 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. - Thanks to Rick Tessner.docs addhttp://forrest.apache.org/changes.htmldocs add - by - DC - : - - Added a How-To: - Generate an ASF mirrors page using - interactive web form using ihtml to include additional html - form elements. - forrestbot addhttp://forrest.apache.org/changes.htmlforrestbot add - by - DB - : - - Added forrestbot deploy.svn implmentation. - build updatehttp://forrest.apache.org/changes.htmlbuild update - by - DB - : - - Support running Forrest on Win9x. - Thanks to Pierrick Brihaye.build updatehttp://forrest.apache.org/changes.htmlbuild update - by - DB - : - - Don't copy unneeded project files in 'war' and 'webapp' targets. - build updatehttp://forrest.apache.org/changes.htmlbuild update - by - DB - : - - Add more desriptions to forrest targets. Highlight the most common ones. - docs addhttp://forrest.apache.org/changes.htmldocs add - by - TS - : - - Added a How-To: - How to create a PDF document for each - tab to create subject-specific aggregated documents. - Thanks to Stephan E. Schlierf.docs addhttp://forrest.apache.org/changes.htmldocs add - by - DC - : - - Created the How-To section of the - documentation. Continue Dianna Shannon's good work with designing - the DTDs, concepts, and documentation effort at Cocoon. - skins addhttp://forrest.apache.org/changes.htmlskins add - by - TS - : - - The new "pelt" skin (uses CSS and div). - See notes about Default skins. - code updatehttp://forrest.apache.org/changes.htmlcode update - by - DC - : - - Projects can use a local CatalogManager.properties to declare - additional Catalogs for DTDs and other entities. - code updatehttp://forrest.apache.org/changes.htmlcode update - by - DB - : - - Improve look of PDF pages. - code fix - (bug FOR-138) - http://forrest.apache.org/changes.htmlcode fix - by - DB - (fixes bug FOR-138) - - : - - PDF pages receive skinconf properly (through the skinconf pipeline). - code fix - (bug FOR-154) - http://forrest.apache.org/changes.htmlcode fix - by - DB - (fixes bug FOR-154) - - : - - FAQ page does not need to provide it's own extra index. - code fix - (bug FOR-165) - http://forrest.apache.org/changes.htmlcode fix - by - JJP - (fixes bug FOR-165) - - : - - Brokenlinks file is now generated in project.home rather than forrest.home - docs addhttp://forrest.apache.org/changes.htmldocs add - by - DC - : - - Added a mechanism to enable impoverished XML tools that do not use - the Catalog Entity Resolver to fetch the DTDs direct from the website. - 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. - skins addhttp://forrest.apache.org/changes.htmlskins add - by - DB - : - - In skinconfig, add box-location attribute to search element. - skins removehttp://forrest.apache.org/changes.htmlskins remove - by - DB - : - - Remove 'template' skin; better to base a new skin on an existing one. - docs fixhttp://forrest.apache.org/changes.htmldocs fix - by - JJP - : - - Replace URLs in all docs to be http://forrest.apache.org/ - code fix - (bug FOR-130) - http://forrest.apache.org/changes.htmlcode fix - by - JJP - (fixes bug FOR-130) - - : - - Add missing xdocs from the validate.exclude property. Allowing to exclude files. - code fix - (bug FOR-114) - http://forrest.apache.org/changes.htmlcode fix - by - DB - (fixes bug FOR-114) - - : - - Improved resolving image references in PDFs. - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - NKB - : - - Now CSS files are parsed internally, so that the urls are included in the static - site generation. - docs updatehttp://forrest.apache.org/changes.htmldocs update - by - DC - : - - Forrest is now a top-level Apache project. The new website is at - http://forrest.apache.org/ - code fixhttp://forrest.apache.org/changes.htmlcode fix - by - JJP - : - - Lucene-index target works. If search@provider="lucene" is set create a search index. - Build site and run targets as per project directory instead of forrest.home. - code updatehttp://forrest.apache.org/changes.htmlcode update - by - DB - : - - Fix relative links and image references in aggregate pages. - code updatehttp://forrest.apache.org/changes.htmlcode update - by - JJP - : - - Worked search functionality into all skins. - Fixed query parameters for Google site search. - Lateral search box was incompatible with new skinconf.xml format. - Thanks to Florian G. Haas.docs addhttp://forrest.apache.org/changes.htmldocs add - by - JJP - : - - Added new documentation about - Searching Forrest-built documentation - which describes both Lucene and Google search. - Thanks to Florian G. Haas.code updatehttp://forrest.apache.org/changes.htmlcode update - by - JJP - : - - Upgrade to cocoon 2.1.5 - code removehttp://forrest.apache.org/changes.htmlcode remove - by - JJP - : - - Clean up first Lucene search implementation in Forrest. - code addhttp://forrest.apache.org/changes.htmlcode add - by - NKB - : - - Locationmap modules added. Not in use yet. - Thanks to Unico Hommes.code addhttp://forrest.apache.org/changes.htmlcode add - by - NKB - : - - Forrestdoc code added to scratchpad; previously was Jakarta Alexandria - code updatehttp://forrest.apache.org/changes.htmlcode update - by - DB - : - - Removed author and cvs-id tags from code and xdocs. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Repack Jetty without JSP support. Now we can remove org.apache.jasper.jar - forrestbot updatehttp://forrest.apache.org/changes.htmlforrestbot update - by - DB - : - - Moved forrestbot2 from scratchpad into main. Uses ant 1.6's - 'import' task instead of XSLT/ant. Webapp completely - rewritten to use JSTL, Struts, Java utility classes, and - OpenSymphony's OSUser for flexible authentication. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Forrest does not copy anything around anymore. The only step - to make it work is to have java compile the forrest jar; all - other resources are used in their original location. - core fix - (bug FOR-146) - http://forrest.apache.org/changes.htmlcore fix - by - DC - (fixes bug FOR-146) - - : - - 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="..."> 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 similar - changes. - * For more information see the FOR-146 issue report. - Thanks to Rick Tessner.skins addhttp://forrest.apache.org/changes.htmlskins add - by - DB - : - - Add <copyright-link> element to skinconf - core removehttp://forrest.apache.org/changes.htmlcore remove - by - DB - : - - The .ehtml files have been deprecated. Use .ihtml instead. Future html input support will be - based on this - discussion - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Remove misleading error message. Reported a cocoon bug #28939 - core removehttp://forrest.apache.org/changes.htmlcore remove - by - JJP - : - - Revert the changes to access skinconf using "skinconf//" done on r10259 - documentation addhttp://forrest.apache.org/changes.htmldocumentation add - by - JJP - : - - Information about the new - forrest-user - mail list - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Jetty jar was mistakenly compiled for jdk 1.4 - - now re-compiled for jdk 1.3 - core removehttp://forrest.apache.org/changes.htmlcore remove - by - DB - : - - Forrest-targets with ant proxy is obsolete; use forrestbot now - core updatehttp://forrest.apache.org/changes.htmlcore update - by - DB - : - - 'build patch' command updated for SVN - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Completely rewritten Lucene-based index and search functionality - Thanks to Florian G. Haas.core fix - (bug FOR-139) - http://forrest.apache.org/changes.htmlcore fix - by - JJP - (fixes bug FOR-139) - - : - - skinconf was being ignored for the svg and fo formats. - core fix - (bug FOR-136) - http://forrest.apache.org/changes.htmlcore fix - by - JJP - (fixes bug FOR-136) - - : - - "Warning" was mistakenly labeled as "Note" in PDF - Thanks to Nick Chalko.core fix - (bug FOR-69) - http://forrest.apache.org/changes.htmlcore fix - by - JJP - (fixes bug FOR-69) - - : - - site2book.xsl handle all menu-item and menu attributes - core fix - (bug FOR-115) - http://forrest.apache.org/changes.htmlcore fix - by - DPB - (fixes bug FOR-115) - - : - - Proper table around 'graphic' in simplified docbook. - Thanks to Rob Exley.core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Replace document() function to get skinconf values and use "//skinconfig". - Fix order so it can validate skinconf. - Use <search/> instead of - <disable-search/> <disable-lucene/> - <searchsite-domain/> <searchsite-name/>. - Fix skinconf.xsl so it produces a proper skinconf - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - AG - : - - Updated jetty to 4.2.19 - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Update scripts and config files to allow upgrade to cocoon 2.1.5-dev - core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - New stylesheet to import the original cocoon.xconf file - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Stop overwriting skinconf and cocoon.xconf on webapp target. - Libs were not copied on the webapp target. - core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - Move context targets from forrest.build.xml to targets/context - Use skinconf DTD. - Use xmlvalidate for skinconf. - Create upgradeskinconf.xsl for old skinconf.xml files - core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - The language alternative div displays language in your own language. - core addhttp://forrest.apache.org/changes.htmlcore add - by - DB - : - - Docbook support for refentry element and it's children. Generally used for man pages. - core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - 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 sections - before create a toc. - core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - Add Language alternatives div. To test it: - i18n-foo.html - core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - Page size and orientation for pdf. - Thanks to Florian G. Haas.core updatehttp://forrest.apache.org/changes.htmlcore update - by - DB - : - - Converted repository from CVS to SVN - Thanks to Apache Infrastructure.core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Upgrade to batik 1.5.1 - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Add i18n to single file content. - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Toc element is optional on skinconf. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - AG - : - - Updated Ant 1.6.1 - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Add i18n to tabs - skins updatehttp://forrest.apache.org/changes.htmlskins update - by - RDG - : - - Putting a jettyconf.xml file in your document directory will override - the one supplied in the default Forrest context. Also no longer copies - jettyconf.xml to build dir (one more file closer to no copying ;-)) - skins fixhttp://forrest.apache.org/changes.htmlskins fix - by - JJP - : - - Allow a full url image to be included on a pdf file. - Use only tmp as the temporary directory. - skins fixhttp://forrest.apache.org/changes.htmlskins fix - by - JJP - : - - Split build file in various parts (webapp,war,validate,site) - skins updatehttp://forrest.apache.org/changes.htmlskins update - by - DB - : - - Support multiple skin descriptor files via the forrest.skins.descriptors property - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Move ant + Jetty under tools on the build target - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - 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. - build addhttp://forrest.apache.org/changes.htmlbuild add - by - DB - : - - New 'clean-dist' target for build.xml, which is now the default target. - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Wrong directory being used for wiki grammars - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Upgrade to Jing 20030619 - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - 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-formdness. - core addhttp://forrest.apache.org/changes.htmlcore add - by - NKB - : - - Added SkinconfTransformer, that augments the skinconf.xml - by adding these attributes to colors if not present: - @highlight, @lowlight, @font, @link, @vlink, @hlink. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - RDG - : - - Removed xml2xhtml.xsl import in profile2page.xsl that was not used (file not present). - Thanks to Juan Jose Pablos.core updatehttp://forrest.apache.org/changes.htmlcore update - by - RDG - : - - New build target to build a webapp that can be distributed. - "war" target depends on "webapp" which will produce an deployable webapp, - "run" target depends on "webapp-local" which leaves many files in the project - directory to ease editing (e.g. src, resources and skins) - core addhttp://forrest.apache.org/changes.htmlcore add - by - NKB - : - - 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. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Upgrade to cocoon 2.1.3 - nekodtd 0.1.9 - remove excalibur-concurrent-20020820.jar - remove excalibur-cli-1.0.jar - remove excalibur-datasource-vm12-20021121.jar - remove jakarta-oro-2.0.6.jar - core addhttp://forrest.apache.org/changes.htmlcore add - by - RP - : - - Add support for Openoffice Writer 1.1 files. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Instead of forrest-targets.ent with Ant 1.6 Forrest can now also be used with - the new import facility: <import file="forrest-targets.xml"/> - skins addhttp://forrest.apache.org/changes.htmlskins add - by - NKB - : - - Fixes to the krysalis skin to bring it up to snuff. - Added lateral search bar. - Added credits section. - Use automatically skinnable borders - Fix code font size. - Other small enhancements. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Automatic generation of borders from skin colors and naming convention. - Rounded and straight 45 degrees corners supplied. - - For example, to generate a 'r'ounded corner for 't'op 'l'eft the size - of '5' pixels of background 'header', foreground 'tab-selected' and - border of 'tab-unselected' I can just ask for: - - /skin/images/rc-t-l-5-1header-2tab-selected-3-tab-unselected.png - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Removed all validation includes and excludes from the fresh site, - except the most basic one. This means that the feature is to - be considered deprecated. - skins addhttp://forrest.apache.org/changes.htmlskins add - by - NKB - : - - New "extra-css" tag in skinconf can contain css that is injected in - forrest.css, added in the skins by default. - skins addhttp://forrest.apache.org/changes.htmlskins add - by - NKB - : - - New section in skinconf about colors used by the site. - Enabled for krysalis-site and tigris-style. - If a needed color is not specified, the default one is used. - skins addhttp://forrest.apache.org/changes.htmlskins add - by - NKB - : - - Now skin resources can be generated from skinconf.xml from xslt. - For example '/myskin/css/my.css.xslt' is used by forrest on 'skinconf.xml' - to get 'my.css' - skins addhttp://forrest.apache.org/changes.htmlskins add - by - NKB - : - - It's now possible to have two levels of tabs. - Thanks to Ross Gardler.skins addhttp://forrest.apache.org/changes.htmlskins add - by - NKB - : - - 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. - skins addhttp://forrest.apache.org/changes.htmlskins add - by - NKB - : - - Added new 'tigris' skin, by using exactly the same - skin version 1.1. from the project Style at http://style.tigris.org/. - This will completely replace the avalon-tigris skin in subsequent versions. - The avalon-tigris skin is to be considered deprecated and no longer - developed. - core addhttp://forrest.apache.org/changes.htmlcore add - by - DB - : - - Properties from ${user.home}/forrest.properties are loaded, after - the project's forrest.properties and before the default-forrest.properties are. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - AG - : - - Updated Ant 1.6.0 - forrestbot updatehttp://forrest.apache.org/changes.htmlforrestbot update - by - DB - : - - Refactored forrestbot to organize workstages and their implementations. - Properties named by workstage and implementation for clarity and to - prevent conflicts. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - DB - : - - The 'clean-site' target appears in 'forrest -projecthelp'. Deletes - temp, webapp, and brokenlinks files too. - docs addhttp://forrest.apache.org/changes.htmldocs add - by - DB - : - - Began documentation for new forrestbot; moved stable forrestbot docs - skins fix - (bug FOR-87,FOR-88) - http://forrest.apache.org/changes.htmlskins fix - by - NKB - (fixes bug FOR-87,FOR-88) - - : - - Now skins that are edited in place have their non-traversable - resources also copied for static rendering. - Thanks to Ross Gardler.core addhttp://forrest.apache.org/changes.htmlcore add - by - NKB - : - - New file format: '.aart'. These are text files that are converted - automatically be Cocoon in SVG, if requested with a '.png' extension. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Updated and separated in their directory all the resources - needed by Chaperon, and make the pipeline generate the - xml grammar versions if unavailable. - This fixes some wiki rendering bugs and makes sections - follow the correct level nesting. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Now also all forrest /resources are editable in forrest.home - and translations in their source space. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Skins are now editable directly in FORREST_HOME. - Thanks to Ross Gardler.skins fix - (bug FOR-86) - http://forrest.apache.org/changes.htmlskins fix - by - NKB - (fixes bug FOR-86) - - : - - DHTML menus in Krysalis skin now work on all levels. - Thanks to Ross Gardler.core updatehttp://forrest.apache.org/changes.htmlcore update - by - DC - : - - Updated Entity Resolver from pre-release to official - xml-commons-resolver-1.1 release. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Updated Jetty to 4.2.14 - skins updatehttp://forrest.apache.org/changes.htmlskins update - by - NKB - : - - Removed the deprecated Ant @tag@ substitution method for skins to - reduce copying further. - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Wrong default value for translations directory. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - All resources in skins/common/images|scripts are used if the - corresponding resource is not found in the skin being used. - Moved under these dirs the images and the scripts that were placed by - default under resources/images or copied in each skin, and added a - temporary sitemap rule to route the request of the images to the new - location. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Moved the images of fresh-site to the src/content/xdocs directory, - for the new layout that has been decided on forrest-dev. - core addhttp://forrest.apache.org/changes.htmlcore add - by - 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. - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - NKB - : - - Fixed the handling of images and resources in the resources.xmap - pipeline, to cater for the new system that does not copy docs prior - to rendering. - core addhttp://forrest.apache.org/changes.htmlcore add - by - NKB - : - - Added a new property to forrest.properties - (project.raw-content-dir=${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. - skins updatehttp://forrest.apache.org/changes.htmlskins update - by - NKB - : - - Major update to inner working of the krysalis-site skin: - - 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, - - 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 maintainable - - refactored css to have a single small place where to define the skin colors - - changed icons to original icons (made by me and not gotten from elsewhere) - - removed unused icons. - - made location of minitoc configurable as "page", "menu", or "both" - core updatehttp://forrest.apache.org/changes.htmlcore update - by - NKB - : - - Removed duplicated copying of files during the creation of the - distro. Now the command-line context dir is like the webapp context dir. - This reduces Forrest build time from 53 to 19 seconds on my system. - skins fixhttp://forrest.apache.org/changes.htmlskins fix - by - NKB - : - - Fixed bug in the autodownload support for skins that was preventing - custom skins in the project source dir from working. - Thanks to Sebastian Bergmann.code updatehttp://forrest.apache.org/changes.htmlcode update - by - JJP - : - - Added support for docbook version 4.1.2. Allows importing files - from various editors (Open office, Abiword). - core fixhttp://forrest.apache.org/changes.htmlcore fix - by - JJP - : - - Added default translation for menu on fresh-site so it is used - when the user locale can not be found. - Synchronized some I18n labels after a modification on fresh-site. - core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - Patch facility to be used by any contributor (From Ant's project). - To use it run "build.[sh|bat] patch". - Thanks to Jan Materne.core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Added German Translation for menu in fresh-site example seed. - Thanks to Jan Materne.core fixhttp://forrest.apache.org/changes.htmlcore fix - by - NKB - : - - Patched directory2book.xsl to be able to serve raw documents from the - side menu (e.g. pdf); previously it always generated .html links. - Thanks to Eric BURGHARD.skins addhttp://forrest.apache.org/changes.htmlskins add - by - NKB - : - - Skins can now be packaged, downloaded and automatically installed. - See documentation. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - Added creation of TOC support on PDF files. - Improved so it uses value from skinconfig.xml. - Improve algoritm to define font size for section/subsection/... - Thanks to Eric Burghard.core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - First I18n integration for menus in forrest. - core updatehttp://forrest.apache.org/changes.htmlcore update - by - JJP - : - - In the generated "changes" document, add "version_" to section@id - as required by document-v12. - Sort action types order to "add","remove","update","fix". - build fixhttp://forrest.apache.org/changes.htmlbuild fix - by - JJP - : - - The 'validate-site' build target will validate the intermediate xdocs. - core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - Integrate Lucene on Forrest. Check the bug report for more info. - Thanks to Ram�n Prades.core addhttp://forrest.apache.org/changes.htmlcore add - by - JJP - : - - Added XSP support. - For old sitemap.xmap add this tag: - <map:generator name="serverpages" - src="org.apache.cocoon.generation.ServerPagesGenerator"/> - \ No newline at end of file +Forrest Changeshttp://forrest.apache.org/changes.htmlForrest Changesen-us \ No newline at end of file Modified: forrest/site/changes.xml ============================================================================== --- forrest/site/changes.xml (original) +++ forrest/site/changes.xml Fri Oct 15 05:33:32 2004 @@ -1,6 +1,7 @@
        History of Changes

        RSS

        -
        Version 0.6-dev (unreleased)
        • +
          Version 0.7-dev (not yet released)
            +
            Version 0.6 (2004-10-15)
            • Added new document to facilitate upgrading to v0.6 @@ -86,7 +87,7 @@ (DB) Fixes FOR-120.
            • Information about the new forrest-user - mail list + mail list. (JJP)
            • New stylesheet to import the original cocoon.xconf file (JJP)
            • @@ -99,7 +100,7 @@ (JJP)
            • Docbook support for refentry element and it's children. Generally used for man pages. (DB)
            • - Do not create TOC unless it has been defined on the skinconf. + 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 sections before create a toc. @@ -140,7 +141,7 @@ For example '/myskin/css/my.css.xslt' is used by forrest on 'skinconf.xml' to get 'my.css' (NKB)
            • - It's now possible to have two levels of tabs. + It is now possible to have two levels of tabs. (NKB) Thanks to Ross Gardler. Fixes FOR-98.
            • External links are now identified by a small trailing icon. The icon can be overridden by the skin and the behaviour @@ -171,7 +172,7 @@ property. (NKB)
            • Patch facility to be used by any contributor (From Ant's project). - To use it run "build.[sh|bat] patch". + To use it run "build.[sh|bat] patch". (JJP) Thanks to Jan Materne.
            • Skins can now be packaged, downloaded and automatically installed. See documentation. @@ -181,9 +182,9 @@ Integrate Lucene on Forrest. Check the bug report for more info. (JJP) Thanks to Ram�n Prades. Fixes FOR-9.
            • Added XSP support. - For old sitemap.xmap add this tag: - <map:generator name="serverpages" - src="org.apache.cocoon.generation.ServerPagesGenerator"/> + For old sitemap.xmap add this tag: + <map:generator name="serverpages" + src="org.apache.cocoon.generation.ServerPagesGenerator"/> (JJP) Fixes FOR-56.
            • Skins "forrest-css" and "avalon-tigris" are deleted. The "tigris-style" is renamed to "tigris". Aliases @@ -199,11 +200,11 @@ (JJP)
            • The .ehtml files have been deprecated. Use .ihtml instead. Future html input support will be based on this - discussion + discussion. (DB) Fixes FOR-131.
            • Revert the changes to access skinconf using "skinconf//" done on r10259 (JJP)
            • - Forrest-targets with ant proxy is obsolete; use forrestbot now + Forrest-targets with ant proxy is obsolete; use forrestbot now. (DB) Fixes FOR-140.
            • Updated commons-collections to 3.1, commons-logging to 1.0.4, jcs to 1.1-dev.20040811, lucene to 1.4.1 @@ -265,11 +266,11 @@ Jetty jar was mistakenly compiled for jdk 1.4 - now re-compiled for jdk 1.3 (JJP)
            • - 'build patch' command updated for SVN + 'build patch' command updated for SVN. (DB) Fixes FOR-137.
            • - Completely rewritten Lucene-based index and search functionality + Completely rewritten Lucene-based index and search functionality. (JJP) Thanks to Florian G. Haas. Fixes FOR-9.
            • - Converted repository from CVS to SVN + Converted repository from CVS to SVN. (DB) Thanks to Apache Infrastructure.
            • Upgrade to batik 1.5.1 (JJP)
            • @@ -277,7 +278,7 @@ (JJP)
            • Updated Ant 1.6.1 (AG)
            • - Add i18n to tabs + Add i18n to tabs. (JJP)
            • Putting a jettyconf.xml file in your document directory will override the one supplied in the default Forrest context. Also no longer copies @@ -290,12 +291,12 @@ 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 + 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-formdness. + while documents without DTD are just checked for well-formedness. (NKB)
            • Removed xml2xhtml.xsl import in profile2page.xsl that was not used (file not present). (RDG) Thanks to Juan Jose Pablos. Fixes FOR-59.
            • @@ -305,11 +306,11 @@ directory to ease editing (e.g. src, resources and skins) (RDG) Fixes FOR-98.
            • Upgrade to cocoon 2.1.3 - nekodtd 0.1.9 - remove excalibur-concurrent-20020820.jar - remove excalibur-cli-1.0.jar - remove excalibur-datasource-vm12-20021121.jar - remove jakarta-oro-2.0.6.jar + nekodtd 0.1.9 + remove excalibur-concurrent-20020820.jar + remove excalibur-cli-1.0.jar + remove excalibur-datasource-vm12-20021121.jar + remove jakarta-oro-2.0.6.jar (JJP)
            • Instead of forrest-targets.ent with Ant 1.6 Forrest can now also be used with the new import facility: <import file="forrest-targets.xml"/> @@ -384,18 +385,27 @@ This reduces Forrest build time from 53 to 19 seconds on my system. (NKB)
            • Added support for docbook version 4.1.2. Allows importing files - from various editors (Open office, Abiword). + from various editors (Open office, Abiword). (JJP)
            • Added German Translation for menu in fresh-site example seed. (JJP) Thanks to Jan Materne.
            • Added creation of TOC support on PDF files. - Improved so it uses value from skinconfig.xml. - Improve algoritm to define font size for section/subsection/... + Improved so it uses value from skinconfig.xml. + Improve algoritm to define font size for section/subsection/... (JJP) Thanks to Eric Burghard.
            • In the generated "changes" document, add "version_" to section@id as required by document-v12. Sort action types order to "add","remove","update","fix". (JJP)
            • + docbook2document.xsl: remove unnecessary / from template matches. + (JJP) Thanks to Sean Wheller. Fixes FOR-317.
            • + docbook2document.xsl: docinfo element. never in OASIS Docbook XML DTD + (JJP) Thanks to Sean Wheller. Fixes FOR-316.
            • + docbook2document.xsl: handle the xref and xreflabel. + (DC) Thanks to Sean Wheller. Fixes FOR-308.
            • + Proper positioning of icon/links for PDF, XML, POD, Print content + options on pelt skin. + (DC) Thanks to Arturo Vazquez.
            • Allow forrest to run in a project directory with a space in the name. (DB) Fixes FOR-267.
            • Openoffice2forrest: add support for merged cells in tables. @@ -454,7 +464,7 @@ (JJP)
            • skinconf was being ignored for the svg and fo formats. (JJP) Fixes FOR-139.
            • - "Warning" was mistakenly labeled as "Note" in PDF + "Warning" was mistakenly labeled as "Note" in PDF. (JJP) Thanks to Nick Chalko. Fixes FOR-136.
            • site2book.xsl handle all menu-item and menu attributes (JJP) Fixes FOR-69.
            • @@ -474,7 +484,7 @@ Stop overwriting skinconf and cocoon.xconf on webapp target. Libs were not copied on the webapp target. (JJP)
            • - Toc element is optional on skinconf. + ToC element is optional on skinconf. (JJP)
            • Allow a full url image to be included on a pdf file. Use only tmp as the temporary directory. @@ -483,7 +493,7 @@ (JJP)
            • Move ant + Jetty under tools on the build target (JJP)
            • - Wrong directory being used for wiki grammars + Wrong directory being used for wiki grammars. (JJP)
            • Now skins that are edited in place have their non-traversable resources also copied for static rendering. @@ -500,7 +510,7 @@ custom skins in the project source dir from working. (NKB) Thanks to Sebastian Bergmann.
            • Added default translation for menu on fresh-site so it is used - when the user locale can not be found. + when the user locale can not be found. Synchronized some I18n labels after a modification on fresh-site. (JJP)
            • Patched directory2book.xsl to be able to serve raw documents from the Modified: forrest/site/contrib.html ============================================================================== --- forrest/site/contrib.html (original) +++ forrest/site/contrib.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Contributing to Apache Forrest @@ -49,7 +49,7 @@ +-->
              -  + 
              @@ -111,19 +111,19 @@
              Contributing
        -Building Forrest +Building Forrest
        -Browse SVN +Browse SVN
        -Mail lists +Mail lists
        -Bugs and Issues +Bugs and Issues
        -Open Issues +Open Issues
      Modified: forrest/site/docs/cap.html ============================================================================== --- forrest/site/docs/cap.html (original) +++ forrest/site/docs/cap.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + SourceTypeAction (content aware pipelines) @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,39 +110,39 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/compliance.html ============================================================================== --- forrest/site/docs/compliance.html (original) +++ forrest/site/docs/compliance.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Standards Compliance @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,25 +110,25 @@
      Modified: forrest/site/docs/document-v12.html ============================================================================== --- forrest/site/docs/document-v12.html (original) +++ forrest/site/docs/document-v12.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + The document-v1.2 DTD @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      @@ -333,7 +333,11 @@

      Hint: See the xml source to see how the various elements are used and see the - DTD documentation.

      + + DTD documentation. +

      This is a simple paragraph. Most documents contain a fair amount of paragraphs. Paragraphs are called <p>.

      With the <p xml:space="preserve"> attribute, you can declare @@ -488,18 +492,18 @@
    • This should be 3 if my math is still OK.
      • - +

      Using sections

      You can use sections to put some structure in your document. For some strange historical reason, the section title is an attribute of the <section> element.

      - +

      Sections, the sequel

      Just some second section.

      - +

      Section 2.1

      Which contains a subsection (2.1).

      - +

      Showing preformatted source code

      Enough about these sections. Let's have a look at more interesting elements, <source> for instance:

      @@ -520,7 +524,7 @@ }

      Please take care to still use a sensible line-length within your source elements.

      - +

      Using tables

      And now for a table:

      @@ -558,7 +562,7 @@

      Not much of attributes with <table>, if you ask me.

      - +

      Using figures

      And a <figure> to end all of this. Note that this can also be implemented with an Modified: forrest/site/docs/document-v12.pdf ============================================================================== Binary files. No diff available. Modified: forrest/site/docs/document-v13.dtdx.html ============================================================================== --- forrest/site/docs/document-v13.dtdx.html (original) +++ forrest/site/docs/document-v13.dtdx.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + DTD documentation @@ -49,7 +49,7 @@ +-->

      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/document-v13.html ============================================================================== --- forrest/site/docs/document-v13.html (original) +++ forrest/site/docs/document-v13.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + The Apache Forrest xdocs document-v1.3 DTD @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,25 +175,25 @@ @@ -202,26 +202,26 @@
      document-v13
      -document-v20 +document-v20
      -JSPWiki Reference +JSPWiki Reference
      -OpenOffice Writer +OpenOffice Writer
      @@ -315,8 +315,12 @@

      Hint: See the xml source to see how the various elements are used and see the - DTD reference documentation.

      - + + DTD documentation. +

      +

      Block and inline elements

      This is a simple paragraph. Most documents contain a fair amount of paragraphs. Paragraphs are called <p>.

      @@ -502,7 +506,7 @@
    • This should be 3 if my math is still OK.
      • - +

      Various presentation formats

      This sample document, written in document-v13 XML can be presented via Forrest in a number of different formats. The links in the @@ -586,18 +590,18 @@ - +

      Using sections

      You can use sections to put some structure in your document. For some strange historical reason, the section title is an attribute of the <section> element.

      - +

      Sections, the sequel

      Just some second section.

      - +

      Section 2.1

      Which contains a subsection (2.1).

      - +

      Showing preformatted source code

      Enough about these sections. Let's have a look at more interesting elements, <source> for instance:

      @@ -629,7 +633,7 @@

      Please take care to still use a sensible line-length within your source elements.

      - +

      Using tables

      And now for a table:

      @@ -689,7 +693,7 @@
      - +

      Using figures

      And a <figure> to end all of this. Note that this can also be implemented with an @@ -700,20 +704,23 @@ - +

      DTD changes

      See the generated - DTD reference documentation. + + DTD documentation.

      - +

      Changes since document-v12

      All v1.2 docs will work fine as v1.3 DTD. The main change is the addition of a @class attribute to every element, which enables the "extra-css" section in the skinconf to be put to good use.

      - +

      Changes since document-v11

      doc-v12 enhances doc-v11 by relaxing various restrictions that were Modified: forrest/site/docs/document-v13.pdf ============================================================================== Binary files. No diff available. Modified: forrest/site/docs/document-v13.pod ============================================================================== --- forrest/site/docs/document-v13.pod (original) +++ forrest/site/docs/document-v13.pod Fri Oct 15 05:33:32 2004 @@ -24,7 +24,7 @@ =head2 Sample Content -B See the xml source to see how the various elements are used and see the L . +B See the xml source to see how the various elements are used and see the L . @@ -426,7 +426,7 @@ =head2 DTD changes -See the generated L . +See the generated L . Modified: forrest/site/docs/document-v13.xml ============================================================================== --- forrest/site/docs/document-v13.xml (original) +++ forrest/site/docs/document-v13.xml Fri Oct 15 05:33:32 2004 @@ -31,7 +31,11 @@ Sample Content

      Hint: See the xml source to see how the various elements are used and see the - DTD reference documentation.

      + + DTD documentation. +

      Block and inline elements

      This is a simple paragraph. Most documents contain a fair amount of @@ -314,14 +318,17 @@ Note that this can also be implemented with an <img> element.

      -
      +
      DTD changes

      See the generated + + DTD documentation.

      Changes since document-v12 Modified: forrest/site/docs/document-v20.dtdx.html ============================================================================== --- forrest/site/docs/document-v20.dtdx.html (original) +++ forrest/site/docs/document-v20.dtdx.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + DTD documentation @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/document-v20.html ============================================================================== --- forrest/site/docs/document-v20.html (original) +++ forrest/site/docs/document-v20.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + The Apache Forrest xdocs document-v2.0 DTD @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      @@ -321,8 +321,12 @@

      Hint: See the xml source to see how the various elements are used and see the - DTD reference documentation.

      - + + DTD documentation. +

      +

      Block and inline elements

      This is a simple paragraph. Most documents contain a fair amount of paragraphs. Paragraphs are called <p>.

      @@ -482,7 +486,7 @@
    • This should be 3 if my math is still OK.
      • - +

      Various presentation formats

      This sample document, written in document-v20 XML can be presented via Forrest in a number of different formats. The links in the @@ -566,18 +570,18 @@ - +

      Using sections

      You can use sections to put some structure in your document. For some strange historical reason, the section title is an attribute of the <section> element.

      - +

      Sections, the sequel

      Just some second section.

      - +

      Section 2.1

      Which contains a subsection (2.1).

      - +

      Showing preformatted source code

      Enough about these sections. Let's have a look at more interesting elements, <source> for instance:

      @@ -609,7 +613,7 @@

      Please take care to still use a sensible line-length within your source elements.

      - +

      Using tables

      And now for a table:

      @@ -669,7 +673,7 @@
      - +

      Using figures

      And a <figure> to end all of this. Note that this can also be implemented with an @@ -677,7 +681,7 @@

      The fine Forrest logo
      - +

      Using class attribute on links

      The document-v13 had elements <fork> and <jump>. In document-v20, those elements no longer exist but the functionality can @@ -730,13 +734,16 @@ - +

      DTD changes

      See the generated - DTD reference documentation. + + DTD documentation.

      - +

      Changes between document-v13 and document-v20

        @@ -752,14 +759,14 @@
      - +

      Changes between document-v12 and document-v13

      All v1.2 docs will work fine as v1.3 DTD. The main change is the addition of a @class attribute to every element, which enables the "extra-css" section in the skinconf to be put to good use.

      - +

      Changes between document-v11 and document-v12

      doc-v12 enhances doc-v11 by relaxing various restrictions that were Modified: forrest/site/docs/document-v20.pdf ============================================================================== Binary files. No diff available. Modified: forrest/site/docs/document-v20.pod ============================================================================== --- forrest/site/docs/document-v20.pod (original) +++ forrest/site/docs/document-v20.pod Fri Oct 15 05:33:32 2004 @@ -24,7 +24,7 @@ =head2 Sample Content -B See the xml source to see how the various elements are used and see the L . +B See the xml source to see how the various elements are used and see the L . @@ -437,7 +437,7 @@ =head2 DTD changes -See the generated L . +See the generated L . Modified: forrest/site/docs/document-v20.xml ============================================================================== --- forrest/site/docs/document-v20.xml (original) +++ forrest/site/docs/document-v20.xml Fri Oct 15 05:33:32 2004 @@ -31,7 +31,11 @@ Sample Content

      Hint: See the xml source to see how the various elements are used and see the - DTD reference documentation.

      + + DTD documentation. +

      Block and inline elements

      This is a simple paragraph. Most documents contain a fair amount of @@ -296,7 +300,7 @@ Note that this can also be implemented with an <img> element.

      -
      +
      Modified: forrest/site/docs/faq-v13.dtdx.html ============================================================================== --- forrest/site/docs/faq-v13.dtdx.html (original) +++ forrest/site/docs/faq-v13.dtdx.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + DTD documentation @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,22 +175,22 @@
      Modified: forrest/site/docs/forrest-contract.html ============================================================================== --- forrest/site/docs/forrest-contract.html (original) +++ forrest/site/docs/forrest-contract.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Our Contract @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/forrestbar.html ============================================================================== --- forrest/site/docs/forrestbar.html (original) +++ forrest/site/docs/forrestbar.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + The ForrestBar @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,51 +110,51 @@ @@ -164,10 +164,10 @@
      ForrestBar
      -Forrestbot +Forrestbot
      -Forrestbot Webapp +Forrestbot Webapp
      @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/forrestbot-web-interface.html ============================================================================== --- forrest/site/docs/forrestbot-web-interface.html (original) +++ forrest/site/docs/forrestbot-web-interface.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Forrestbot Web Interface @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,61 +110,61 @@
      Modified: forrest/site/docs/howto-v13.dtdx.html ============================================================================== --- forrest/site/docs/howto-v13.dtdx.html (original) +++ forrest/site/docs/howto-v13.dtdx.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + DTD documentation @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/howto-v20.dtdx.html ============================================================================== --- forrest/site/docs/howto-v20.dtdx.html (original) +++ forrest/site/docs/howto-v20.dtdx.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + DTD documentation @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/libre-intro.html ============================================================================== --- forrest/site/docs/libre-intro.html (original) +++ forrest/site/docs/libre-intro.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Libre QuickStart @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/linking.html ============================================================================== --- forrest/site/docs/linking.html (original) +++ forrest/site/docs/linking.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Menus and Linking @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      @@ -518,9 +518,16 @@

      Selecting menu entries

      Forrest decides which menu entries to display, by examining the - "tab" attributes in the site.xml file. All site.xml entries with a + "tab" attributes in the site.xml file. The children of + all site.xml entries with a "tab" which is equal to that of the current page, are - added to the menu.

      + added to the menu, whilst the element itself forms the root of that + part of the menu (see the "community" element in the + example below). Child elements that have a different + "tab" attribute value will appear in the menu for their + parents, and will also form the root of a new menu for a tab with + the appropriate name (see the "howto-samples" element + below).

      Consider our site.xml example:

       <site label="Forrest" href="" tab="home"
@@ -561,14 +568,14 @@
           value of "home".  Forrest will select all nodes with
             tab="home" and put them in the menu.
         
      
-
+
 
      Alternative menu selection mechanisms.
      
 
      
           The "tab" attribute-based scheme for selecting a menu's
           entries is not the only one, although it is the most flexible.  Here
           we describe a few alternatives.
         
      
-
+
 
      Directory-based selection
      
 
      In this scheme, each tab corresponds to a directory within the
             site.  All content below that directory is included in the menu.
      
@@ -591,7 +598,7 @@
               entries.
           
 
-
+
 
      Specifying menus with book.xml
      
 
      
             Historically, menus in Forrest have been generated from a
@@ -602,7 +609,7 @@
             that led to obsolescence of book.xml files.  In general, however, we
             recommend that users avoid book.xml files.
           
      
-
+
 
      Selecting the current tab
      
 
      
           The tab selection algorithm is quite simple: the tab with the
@@ -614,7 +621,7 @@
 
 
     
-
+
 
      Table of Contents Generation
      
 
      
 
      Each page can have an automatically generated table of contents. This
@@ -660,10 +667,10 @@
 
      
     
     
-
+
 
      Linking systems
      
 
      
-
+
 
      Direct linking
      
 
      
           In earlier versions of Forrest (and in similar systems), there has
@@ -682,7 +689,7 @@
           typically renders to multiple output formats (HTML and PDF), links in
           one of them (here, the PDF) are likely to break.
         
      
-
+
 
      Indirect linking
      
 
      
           Forrest's solution is simple: instead of <link href="todo.html">,
@@ -710,7 +717,7 @@
           "idea" of "the todo file".  It doesn't matter where it physically lives;
           that will be sorted out by Forrest.
         
      
-
+
 
      Resolving site: URIs
      
 
      
             So how does "site:todo" get resolved?  A full answer
@@ -745,7 +752,7 @@
             "new_content_type" its own XML file, or a node in another file, in
             another category.
           
      
-
+
 
      ext: URIs: linking to external URLs
      
 
      
             The "ext:" scheme was created partly to demonstrate the
@@ -780,7 +787,7 @@
             Specifically, the "@href" aggregation makes defining large numbers of
             related URLs easy.
           
      
-
+
 
      Theory: source URIs
      
 
      
             The "site:" URIs like "site:todo" are examples of
@@ -796,7 +803,7 @@
             in the destination URI space, just like exotic XML source formats are
             translated into plain old HTML in the output.
           
      
-
+
 
      Future schemes
      
 
      
             So far, the "site:" and "ext:" schemes are defined.
@@ -866,7 +873,7 @@
           
      
 
      
     
-
+
 
      Concept
      
 
      
 
      
@@ -881,7 +888,7 @@
       
      
 
      
     
-
+
 
      Implementation
      
 
      
 
      Full details on the implementation of

Modified: forrest/site/docs/linking.pdf
==============================================================================
Binary files. No diff available.

Modified: forrest/site/docs/oowriter.html
==============================================================================
--- forrest/site/docs/oowriter.html	(original)
+++ forrest/site/docs/oowriter.html	Fri Oct 15 05:33:32 2004
@@ -1,9 +1,9 @@
-
+
 
 
 
 
-
+
 
 OpenOffice Writer documents
 
@@ -49,7 +49,7 @@
     +-->
 
      
 
      
-  
+  
                     
 
      
 
      
@@ -110,64 +110,64 @@
 
 
 
 
 
@@ -175,37 +175,37 @@
 
 
 
 
 
      
-Libre
+Libre
 
      
 
      
-Dream list
+Dream list
 
      
 
      
 
      

Modified: forrest/site/docs/project-sitemap.html
==============================================================================
--- forrest/site/docs/project-sitemap.html	(original)
+++ forrest/site/docs/project-sitemap.html	Fri Oct 15 05:33:32 2004
@@ -1,9 +1,9 @@
-
+
 
 
 
 
-
+
 
 Using project sitemaps
 
@@ -49,7 +49,7 @@
     +-->
 
      
 
      
-  
+  
                     
 
      
 
      
@@ -110,64 +110,64 @@
 
 
 
 
 
@@ -175,53 +175,53 @@
 
 
 
 
 
 
 
 
      

Modified: forrest/site/docs/searching.html
==============================================================================
--- forrest/site/docs/searching.html	(original)
+++ forrest/site/docs/searching.html	Fri Oct 15 05:33:32 2004
@@ -1,9 +1,9 @@
-
+
 
 
 
 
-
+
 
 Searching Forrest-built documentation
 
@@ -49,7 +49,7 @@
     +-->
 
      
 
      
-  
+  
                     
 
      
 
      
@@ -110,64 +110,64 @@
 
 
 
 
 
@@ -175,53 +175,53 @@
 
 
 
 
 
 
 
 
      

Modified: forrest/site/docs/sitemap-ref.html
==============================================================================
--- forrest/site/docs/sitemap-ref.html	(original)
+++ forrest/site/docs/sitemap-ref.html	Fri Oct 15 05:33:32 2004
@@ -1,9 +1,9 @@
-
+
 
 
 
 
-
+
 
 Forrest Sitemap Reference
 
@@ -49,7 +49,7 @@
     +-->
 
      
 
      
-  
+  
                     
 
      
 
      
@@ -110,64 +110,64 @@
 
 
 
 
 
@@ -175,53 +175,53 @@
 
 
 
 
 
 
 
 
      
@@ -496,7 +496,10 @@
             Clark's 
             DTD
               Parser.  Useful for documenting DTD-based XML schemas, such
-            as Forrest's own DTDs.
+
+            as Forrest's own DTDs.
           
         
 
@@ -524,7 +527,7 @@
     -->
 
     
-
+
 
      Source pipelines (**.xml)
      
 
      
 
      
@@ -563,7 +566,7 @@
 (*.xml)
                         (in forrest.xmap, faq.xmap, etc)
      - +

      forrest.xmap

      Most of the usual Source pipelines are defined in @@ -585,7 +588,7 @@ <map:transform src="{forrest:stylesheets}/howto2document.xsl" /> </map:when> - +

      Other source pipelines

      As mentioned above, all non-core Source pipelines are distributed in independent *.xmap files. There is a block of @@ -619,7 +622,7 @@ </map:match> .... .... - +

      Late-binding pipelines

      One point of interest here is that the sub-sitemap is often not @@ -642,7 +645,7 @@ - +

      Output pipelines

      @@ -654,7 +657,7 @@ We now wish to render the XML from these pipelines to output formats like HTML and PDF.

      - +

      PDF output

      Easiest case first; PDFs don't require menus or headers, so we can @@ -693,7 +696,7 @@

      Lastly, we generate a PDF using the fo2pdf serializer.

      - +

      HTML output

      Generating HTML pages is more complicated, because we have to merge the page body with a menu and tabs, and then add a header and footer. @@ -739,10 +742,10 @@

      - +

      Intermediate pipelines

      - +

      Page body

      Here is the matcher which generates the page body:

      @@ -802,7 +805,7 @@
             <html> and <body>) suitable for merging with the menu and tabs.
         
 
-
+
 
      Page menu
      
 
      In the sitemap.xmap file, the matcher generating HTML for the menu is:
      
 
      @@ -821,7 +824,7 @@
 
      How the menu XML is actually generated (the *book-*.html pipeline) is
           sufficiently complex to require a 
           section of its own.
      
-
+
 
      Page tabs
      
 
      Tab generation is quite tame compared to menus:
      
 
      @@ -841,7 +844,7 @@
      - +

      Menu XML generation

      The "book" pipeline is defined in sitemap.xmapas:

      @@ -942,7 +945,7 @@
      - +

      Link rewriting

      In numerous places in sitemap.xmap you will see the @@ -951,7 +954,7 @@

      This statement is Cocoon's linking system in action. A full description is provided in Menus and Linking. Here we describe the implementation of linking.

      - +

      Cocoon foundations: Input Modules

      The implementation of site: linking is heavily based on @@ -982,13 +985,13 @@ LinkRewriterTransformer, currently distributed as a "block" in Cocoon 2.1

      - +

      Implementing "site:" rewriting

      Using the above components, "site:" URI rewriting is accomplished as follows.

      - +

      cocoon.xconf

      First, we declare all the input modules we will be needing:

      @@ -1032,7 +1035,7 @@
 
      However at the moment, we have only declared the input modules.
             They will be configured in sitemap.xmap as described in
             the next section.
      
-
+
 
      sitemap.xmap
      
 
      
             Now in the sitemap, we define the LinkRewriterTransformer, and
@@ -1132,7 +1135,7 @@
             cocoon:/community/linkmap-index.html
           
 
      
-
+
 
      Dynamically generating a linkmap
      
 
      
             Why do we need this "linkmap" pipeline generating dynamic XML from

Modified: forrest/site/docs/sitemap-ref.pdf
==============================================================================
Binary files. No diff available.

Modified: forrest/site/docs/skin-package.html
==============================================================================
--- forrest/site/docs/skin-package.html	(original)
+++ forrest/site/docs/skin-package.html	Fri Oct 15 05:33:32 2004
@@ -1,9 +1,9 @@
-
+
 
 
 
 
-
+
 
 Skin packaging, provision, and use
 
@@ -49,7 +49,7 @@
     +-->
 
      
 
      
-  
+  
                     
 
      
 
      
@@ -110,64 +110,64 @@
 
 
 
 
 
@@ -175,53 +175,53 @@
      Modified: forrest/site/docs/skins.html ============================================================================== --- forrest/site/docs/skins.html (original) +++ forrest/site/docs/skins.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Default skins @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/upgrading_05.html ============================================================================== --- forrest/site/docs/upgrading_05.html (original) +++ forrest/site/docs/upgrading_05.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Upgrading to Forrest 0.5 @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -110,48 +110,48 @@ @@ -175,53 +175,53 @@
      @@ -318,7 +318,7 @@

      This page describes changes to Apache Forrest that affect people who are upgrading to the 0.6 version. - Please post your upgrade experiences to either the + If you have other issues, then please discuss on either the dev or user mailing lists. @@ -372,31 +372,35 @@

      General upgrade tips

      - Take advantage of the separation of concerns. Create a fresh + Synchronise your project's skinconf.xml and forrest.properties files. +

      +

      + Take advantage of the separation of concerns. In a new workspace, + create a fresh 'forrest seed' site, then tweak its forrest.properties and skinconf.xml until it reflects your old site. - When it is ready, replace your project's skinconf.xml forrest.properties - files. + When it is ready, replace your project's skinconf.xml and + forrest.properties files. Any remaining issues would concern other aspects of your configuration, such as site.xml and your actual content.

      - +

      New location of $FORREST_HOME

      To use the new Forrest, run 'build.sh' or 'build.bat' as normal, then change the FORREST_HOME environment variable to point to - forrest/src/core instead of - .../build/dist/shbat. Also make sure PATH gets updated to use the new + forrest/src/core instead of the old forrest-0.5 location + (.../build/dist/shbat). Also make sure PATH gets updated to use the new $FORREST_HOME/bin

      - +

      Copyless

      @@ -412,7 +416,7 @@

      - +

      Sitemap

      @@ -448,7 +452,7 @@

      - +

      Private skins might need changes to document2html.xsl

      @@ -462,7 +466,7 @@

      - +

      Various additions to skin configuration and new external DTD

      @@ -481,7 +485,7 @@

      - +

      forrest.antproxy.xml is obsolete in favor of Ant's <import> task

      @@ -495,7 +499,7 @@

      - +

      Deprecation of .ehtml and .ihtml

      @@ -507,7 +511,7 @@

      - +

      Deprecation of .cwiki filename extension to become .jspwiki

      @@ -517,7 +521,7 @@

      - +

      New forrestbot

      @@ -531,7 +535,7 @@

      - +

      New DTDs

      @@ -578,7 +582,7 @@

      - +

      SystemIdentifiers for DTDs changed to forrest.apache.org

      @@ -614,7 +618,7 @@

      - +

      Projects can use a local CatalogManager.properties

      @@ -623,13 +627,13 @@ and other entities.

      - If you do not add such a configuration file then there will be a + If you do not add such a configuration file, then there will be a harmless message on startup "CatalogManager.properties not found".

      - +

      Skins renamed and deleted

      Skins now have a naming convention. The default skins are @@ -673,7 +677,7 @@

      - +

      Wholesite.html/pdf

      Instead of using names "site.html/pdf" to create an aggregate page @@ -683,7 +687,7 @@

      - +

      To be continued...

      ...as more issues are discovered/remembered :) Please send feedback Modified: forrest/site/docs/upgrading_06.pdf ============================================================================== Binary files. No diff available. Modified: forrest/site/docs/validation.html ============================================================================== --- forrest/site/docs/validation.html (original) +++ forrest/site/docs/validation.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + XML Validation @@ -49,7 +49,7 @@ +-->

      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      @@ -263,7 +263,7 @@ Creating or extending a DTD
    • -Associating DTDs with document types +Associating DTDs with document types
      • @@ -500,7 +500,7 @@ customizing a DTD. - +

      Associating DTDs with document types

      Recall that our DOCTYPE declaration for our download document type Modified: forrest/site/docs/wiki-sample.html ============================================================================== --- forrest/site/docs/wiki-sample.html (original) +++ forrest/site/docs/wiki-sample.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + wiki-sample @@ -49,7 +49,7 @@ +-->

      -  + 
      @@ -110,64 +110,64 @@ @@ -175,53 +175,53 @@
      Modified: forrest/site/docs/your-project.html ============================================================================== --- forrest/site/docs/your-project.html (original) +++ forrest/site/docs/your-project.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Using Forrest @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -113,61 +113,61 @@
      Using Forrest
      -XML Validation +XML Validation
      -Menus and Linking +Menus and Linking
      -Searching +Searching
      -Default Skins +Default Skins
      -Skin Packages +Skin Packages
      -Our Contract +Our Contract
      -Standards Compliance +Standards Compliance
      @@ -175,53 +175,53 @@
      @@ -364,14 +364,14 @@

      In Unix/Linux:

      -~/apache-forrest-0.6$ export FORREST_HOME=`pwd`
+~/apache-forrest-0.6$ export FORREST_HOME=`pwd`/src/core
 ~/apache-forrest-0.6$ export PATH=$PATH:$FORREST_HOME/bin

      In Windows:

       Go to "My Computer", "Properties", "Advanced", "Environment Variables"
 and add:
-FORREST_HOME as C:\full\path\to\apache-forrest-0.6
+FORREST_HOME as C:\full\path\to\apache-forrest-0.6\src\core
 PATH as %PATH%;%FORREST_HOME%\bin
      @@ -1153,13 +1153,18 @@
    • Add an XML Catalog to enable a mapping from the DOCTYPE public id to the relevant DTD file.
      • + +
    • Tell the system about your catalog.
      • -

      +

      +
      Note
      +
      Please see XML Validation - for the full story. -

      - + for the complete description for those steps. +
      +
      +

      Example: Adding a new content type (advanced)

      The simple user sitemap in the previous example is fine for @@ -1227,7 +1232,7 @@ can be used, because the project sitemap is the first sitemap to be consulted.

      - +

      Example: integrating external RSS content

      Similar to the previous example, we can integrate RSS into our site simply by providing a match in our project sitemap.xmap ... @@ -1253,13 +1258,14 @@

      You will probably want to copy the core Forrest rss2document.xsl to your project, customise it to your needs, and refer to it with - src="{project:resources.stylesheets}/rss2document.xsl" - -

      + src="{project:resources.stylesheets}/rss2document.xsl". + Then of course you would add an entry to site.xml to link + to weblog.html +

      - +

      Forrest skins

      @@ -1279,7 +1285,7 @@ many capabilities so that extra skins are not needed.

      - +

      Configuration of skins

      All configuration is done via your project @@ -1287,7 +1293,7 @@ It contains many comments to describe each capability. Please read those, there is no point repeating here.

      - +

      Defining a new skin

      Consider discussing your needs on the mailing lists. There may be planned enhancements to the core skins. Also consider contributing @@ -1355,7 +1361,7 @@ - +

      Interactive Forrest: faster turnaround when developing your docs

      @@ -1369,7 +1375,7 @@ a "live" Forrest webapp instance, the Forrest-based documentation development can be faster and easier than with comparable tools.

      - +

      Running as a webapp

      Type 'forrest run' in your project root to start Forrest's @@ -1381,7 +1387,7 @@ servlet container, type forrest webapp to build an open webapp in build/webapp/)

      - +

      Using the webapp

      You can now edit the XML content in @@ -1390,7 +1396,7 @@

      - +

      Invoking Forrest from Ant

      @@ -1403,6 +1409,7 @@ <project name="myproject" default="hello"> <!-- FORREST_HOME must be set as an environment variable --> <property environment="env"/> + <property name="forrest.home" value="${env.FORREST_HOME}"/> <import file="${env.FORREST_HOME}/forrest.build.xml"/> <!-- 'site' is a target imported from forrest.build.xml --> Modified: forrest/site/docs/your-project.pdf ============================================================================== Binary files. No diff available. Modified: forrest/site/faq.html ============================================================================== --- forrest/site/faq.html (original) +++ forrest/site/faq.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Frequently Asked Questions @@ -49,7 +49,7 @@ +-->

      -  + 
      @@ -108,46 +108,46 @@
      @@ -622,11 +622,13 @@

      - Sometimes there are workarounds, e.g. perhaps "my_site". - In future versions of Forrest we will attempt to deal with this issue. + Sometimes there are workarounds, e.g. faq.html or faq-interview.html + would fail, but interview-faq.html would be fine. + In future versions of Forrest we will attempt to deal with this issue + (FOR-217).

      - +

      2.7. What do the symbols and numbers mean when Forrest lists each document that it has built?

      @@ -650,7 +652,7 @@ Column 4 is the page size.

      - +

      2.8. Images don't display in PDFs. How do I fix this?

      ^ @@ -690,7 +692,7 @@ Forrest.
      - +

      2.9. The tab link in my site incorrectly assumes that 'index.html' is present in the linked-to directory. How do I fix this? @@ -716,7 +718,7 @@ <map:redirect-to uri="manual/Introduction.html"/> </map:match> - +

      2.10. When generating PNG images from SVG, I get an error: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.

      @@ -735,7 +737,7 @@ Cocoon FAQ.

      - +

      2.11. How do i configure my favourite XML editor or parser to find the local Forrest DTDs? @@ -750,7 +752,7 @@ local DTDs.

      - +

      2.12. How to use special characters in the labels of the site.xml file?

      @@ -772,7 +774,7 @@ Issue FOR-244.

      - +

      2.13. How to make the site look better and change its skin?

      @@ -793,7 +795,7 @@ own skin.

      - +

      2.14. How do I enable XSP processing?

      ^ @@ -840,7 +842,7 @@

      See also the AddingXSPToForrest Wiki page.

      - +

      2.15. How do breadcrumbs work? Why don't they work locally?

      ^ @@ -862,9 +864,9 @@ in skinconf.xml.

      - +

      3. Older versions

      - +

      3.1. When invoking Forrest 0.4 from the forrest.antproxy.xml, the build fails because ${project.home} isn't resolved. @@ -886,7 +888,7 @@ <classpath refid="forrest-classpath"/> <jvmarg value="-Dforrest.home=${forrest.home}"/> - +

      3.2. After upgrading to 0.4 my HTML looks significantly different, and table widths are wrong. What happened? @@ -909,7 +911,7 @@ 
         <doctype-system>http://www.w3.org/TR/html4/loose.dtd</doctype-system>
      - +

      3.3. When building my project, I get an validation error: Document root element "site", must match DOCTYPE root "null".. @@ -932,7 +934,7 @@ listed to prevent an attempt at DTD-based validation.

      - +

      3.4. When building my project, I get any of these errors: menu.xmap (The system cannot find the file specified) @@ -948,9 +950,9 @@ Upgrading to Forrest 0.5).

      - +

      4. General

      - +

      4.1. What is the relationship between site.xml and book.xml?

      @@ -969,7 +971,7 @@ See Menus and Linking.

      - +

      4.2. How do I use DocBook as the xml documentation format?

      @@ -1027,7 +1029,7 @@ for configuration guidance.

      - +

      4.3. How to report which version of Forrest is being used and the properties that are set? @@ -1046,7 +1048,7 @@ Doing 'forrest -v' will provide verbose build messages.

      - +

      4.4. Where are the log files to find more infomation about errors?

      @@ -1075,7 +1077,7 @@ to the standard output.

      - +

      4.5. How to help?

      @@ -1092,7 +1094,7 @@ else. Don't be shy!

      - +

      4.6. How to contribute a patch?

      Modified: forrest/site/faq.pdf ============================================================================== Binary files. No diff available. Modified: forrest/site/faq.xml ============================================================================== --- forrest/site/faq.xml (original) +++ forrest/site/faq.xml Fri Oct 15 05:33:32 2004 @@ -84,7 +84,7 @@

      Add the following entries to your site.xml file:

      <about tab="home" label="About" href=""> - ... + ... <all_site label="Full HTML" href="wholesite.html"/> <all_sitePDF label="Full PDF" href="wholesite.pdf"/> ... @@ -179,8 +179,10 @@ community, howto

      - Sometimes there are workarounds, e.g. perhaps "my_site". - In future versions of Forrest we will attempt to deal with this issue. + Sometimes there are workarounds, e.g. faq.html or faq-interview.html + would fail, but interview-faq.html would be fine. + In future versions of Forrest we will attempt to deal with this issue + (FOR-217).

      2.7. What do the symbols and numbers mean when Forrest lists each document that it has built? @@ -202,12 +204,12 @@ </p> </section><section id="pdf_images"><title>2.8. Images don't display in PDFs. How do I fix this?

      - Forrest uses Apache FOP + Forrest uses Apache FOP for rendering PDFs. FOP cannot handle all image types natively, and requires third-party jars to be added. FOP natively handles BMP, GIF, - JPG, TIFF and EPS (with a few limitations). FOP can also handle SVG - (via Batik!and PNG (see below). For details, see - FOP Graphics + JPG, TIFF and EPS (with a few limitations). FOP can also handle SVG + (via Batik!and PNG (see below). For details, see + FOP Graphics formats

      To get PNGs working in PDFs with Jimi:

      @@ -218,7 +220,7 @@ $FORREST/lib/optional/jimi-1.0.jar.

      Alternatively you can use JAI (Java Advanced Imaging API at - http://java.sun.com/products/java-media/jai). For more + http://java.sun.com/products/java-media/jai). For more info, see FOP Graphics Packages @@ -395,9 +397,9 @@

      3.4. When building my project, I get any of these errors: - <code>menu.xmap (The system cannot find the file specified)</code> - <code>static.xmap (The system cannot find the file specified)</code> - <code>Type 'xml-document' is not defined for 'serialize'</code> + <code>menu.xmap (The system cannot find the file specified)</code> + <code>static.xmap (The system cannot find the file specified)</code> + <code>Type 'xml-document' is not defined for 'serialize'</code>

      You are using an old version of sitemap.xmap (see the document Modified: forrest/site/forrest-issues.html ============================================================================== --- forrest/site/forrest-issues.html (original) +++ forrest/site/forrest-issues.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Open issues for the upcoming release @@ -49,7 +49,7 @@ +-->

      -  + 
      @@ -108,19 +108,19 @@
      -  + 
      @@ -108,16 +108,16 @@
      Modified: forrest/site/howto/howto-howto.html ============================================================================== --- forrest/site/howto/howto-howto.html (original) +++ forrest/site/howto/howto-howto.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + How to write a How-To @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -108,16 +108,16 @@
      Modified: forrest/site/howto/howto-pdf-tab.html ============================================================================== --- forrest/site/howto/howto-pdf-tab.html (original) +++ forrest/site/howto/howto-pdf-tab.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + How to create a PDF document for each tab @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -108,13 +108,13 @@
      @@ -188,7 +188,7 @@
      Copyright © 2002-2004 The Apache Software Foundation.
      -Valid HTML 4.01!Valid CSS!Built with Apache Forrest - logoBuilt with Apache Cocoon - logothanks to ASF, thanks from ASF - logo +Valid HTML 4.01!Valid CSS!Built with Apache Forrest - logoBuilt with Apache Cocoon - logothanks to ASF, thanks from ASF - logo
      -  + 
      @@ -111,43 +111,43 @@
      Index
      -License +License
      -Download +Download
      -Who we are +Who we are
      -FAQs +FAQs
      -Changes +Changes
      -Todo +Todo
      -Example sites +Example sites
      @@ -211,9 +211,9 @@

      Introduction

      Apache Forrest is an XML standards-oriented documentation framework - based on Apache Cocoon, providing XSLT stylesheets and schemas, images - and other resources. Forrest uses these to render the source - content into a website via command-line, robot, or a dynamic web + based upon Apache Cocoon, providing XSLT stylesheets and schemas, + images and other resources. Forrest uses these to render the source + content into a website via command-line, robot, or dynamic application.

      @@ -377,7 +377,7 @@ releases. It is certainly usable now (despite not yet being version 1.x). See the growing list of example sites including - Many Apache sites. + many Apache sites.

      In general, prior to 1.0, ensuring quality of design will be considered @@ -411,26 +411,30 @@

        -
      • The Forrest project has evolved to become a "top-level" Apache - project. We are making good progress towards the 0.6 release - which has many efficiency and usability improvements. +
      • Apache Forrest 0.6 was released on 2003-10-15. Uses all resources + in-place so no more copying; workflow and productivity improvements; + project sitemaps get first chance processing then pass-through + to core sitemaps; new skins use CSS rather than tables and are + configurable; enhanced forrestbot. +
        • -
      • Apache Forrest 0.5 was released on 2003-09-13 - much faster, new flexible - tab and menu system, numerous skin improvements, support for a sub-set - of DocBook and Wiki source formats, - improved PDF output, eased maintenance of sitemaps, and more. +
      • The Forrest project has evolved to become a "top-level" Apache + project.
      - +

      Help Wanted!

      - Apache Forrest is fairly new, and is in need of developers. If you know (or - want to learn) XML, Ant, HTML or CSS, then you are qualified to help! + Apache Forrest is fairly new, and is in need of developers. + If you know (or want to learn) any of XML, Ant, HTML, XSLT, or CSS, + then you are qualified to help.

      As with all Apache projects, Forrest is a meritocracy; the more you @@ -458,7 +462,7 @@

      Copyright © 2002-2004 The Apache Software Foundation.
      -Valid HTML 4.01!Valid CSS!Built with Apache Forrest - logoBuilt with Apache Cocoon - logothanks to ASF, thanks from ASF - logo +Valid HTML 4.01!Valid CSS!Built with Apache Forrest - logoBuilt with Apache Cocoon - logothanks to ASF, thanks from ASF - logo
      -
    • Apache Forrest 0.5 was released on 2003-09-13 - much faster, new flexible - tab and menu system, numerous skin improvements, support for a sub-set - of DocBook and Wiki source formats, - improved PDF output, eased maintenance of sitemaps, and more. +
    • The Forrest project has evolved to become a "top-level" Apache + project.
      • Help Wanted!

      - Apache Forrest is fairly new, and is in need of developers. If you know (or - want to learn) XML, Ant, HTML or CSS, then you are qualified to help! + Apache Forrest is fairly new, and is in need of developers. + If you know (or want to learn) any of XML, Ant, HTML, XSLT, or CSS, + then you are qualified to help.

      As with all Apache projects, Forrest is a meritocracy; the more you Modified: forrest/site/license.html ============================================================================== --- forrest/site/license.html (original) +++ forrest/site/license.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Apache License @@ -49,7 +49,7 @@ +-->

      -  + 
      @@ -108,46 +108,46 @@
      Modified: forrest/site/linkmap.html ============================================================================== --- forrest/site/linkmap.html (original) +++ forrest/site/linkmap.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Site Linkmap @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -108,91 +108,91 @@ @@ -200,107 +200,107 @@
      Modified: forrest/site/live-sites.html ============================================================================== --- forrest/site/live-sites.html (original) +++ forrest/site/live-sites.html Fri Oct 15 05:33:32 2004 @@ -1,9 +1,9 @@ - + - + Examples Built-With-Forrest @@ -49,7 +49,7 @@ +-->
      -  + 
      @@ -108,25 +108,25 @@