You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2005/02/18 08:24:40 UTC

svn commit: r154251 [5/6] - in forrest/site: ./ docs/ docs/dev/ docs/dev/howto/ docs/dev/plugins/ docs/dev/skin/ docs/dev/skin/images/ howto/ skin/ skin/images/ skins/

Modified: forrest/site/docs/skins.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs/skins.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/docs/skins.html (original)
+++ forrest/site/docs/skins.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Default skins</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li class="current">
-<a class="base-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li>
 <a class="base-not-selected" href="../howto/index.html">How-To</a>
@@ -110,6 +110,9 @@
 <div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Documentation</div>
 <div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
 <div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
+<div class="menuitem">
 <a title="" href="../docs/your-project.html">Using Forrest</a>
 </div>
 <div class="menuitem">
@@ -128,9 +131,6 @@
 <a title="" href="../docs/skin-package.html">Skin Packages</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/plugins.html">Plugins</a>
-</div>
-<div class="menuitem">
 <a title="" href="../docs/forrest-contract.html">Our Contract</a>
 </div>
 <div class="menuitem">
@@ -211,7 +211,7 @@
 <a title="" href="../docs/wiki-sample.html">JSPWiki Reference</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/oowriter.html">OpenOffice.org Writer</a>
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
 </div>
 </div>
 </div>
@@ -262,7 +262,7 @@
 <a href="#names">Convention for choosing skin names</a>
 </li>
 <li>
-<a href="#skins">Skin descriptions and examples</a>
+<a href="#skins">Skin descriptions</a>
 <ul class="minitoc">
 <li>
 <a href="#pelt">pelt</a>
@@ -318,7 +318,7 @@
 
     
 <a name="N10025"></a><a name="skins"></a>
-<h2 class="underlined_10">Skin descriptions and examples</h2>
+<h2 class="underlined_10">Skin descriptions</h2>
 <div class="section">
 <a name="N1002B"></a><a name="pelt"></a>
 <h3 class="underlined_5">pelt</h3>
@@ -326,69 +326,46 @@
           Uses CSS "div" and no HTML tables.
           During its earlier development, this skin used to be called "css-style-dev".
         </p>
-<p>Examples:
-          <a href="..//">Apache Forrest</a> |
-          <a class="external" href="http://cocoon.apache.org/lenya/">Apache Lenya</a>
-        
-</p>
-<a name="N10040"></a><a name="leather-dev"></a>
+<a name="N10035"></a><a name="leather-dev"></a>
 <h3 class="underlined_5">leather-dev</h3>
 <p>
           This is the evolution of the "pelt" skin, to have naming
           conventions for css elements. It is still in development.
         </p>
-<p>Examples:
-          <a href="../images/snapshot-leather-dev.png">snapshot</a>
-        
-</p>
-<a name="N10051"></a><a name="tigris"></a>
+<a name="N1003F"></a><a name="tigris"></a>
 <h3 class="underlined_5">tigris</h3>
 <p>
           This skin is based on version 1.1 of the 
           <a class="external" href="http://style.tigris.org/">style.tigris.org</a> project.
           (It deliberately contravenes our skin naming convention.)
         </p>
-<p>Examples:
-          <a class="external" href="http://www.core.gen.tr/">Core Computer Security Group</a>
-        
-</p>
-<a name="N10066"></a><a name="plain-dev"></a>
+<a name="N1004D"></a><a name="plain-dev"></a>
 <h3 class="underlined_5">plain-dev</h3>
 <p>
           This is a very minimal skin to produce plain HTML documents.
           Such capability might be useful to generate a collection of
           documents for some off-line product's user help system.
         </p>
-<p>Examples:
-          <a href="../images/snapshot-plain-dev.png">snapshot</a>
-        
-</p>
 </div>
 
     
-<a name="N10078"></a><a name="old"></a>
+<a name="N10058"></a><a name="old"></a>
 <h2 class="underlined_10">Old and deprecated skins</h2>
 <div class="section">
 <p>
         The following skins are retained for a little while longer, but are
         deprecated, so please move to one of the other skins.
       </p>
-<a name="N10081"></a><a name="forrest-site"></a>
+<a name="N10061"></a><a name="forrest-site"></a>
 <h3 class="underlined_5">forrest-site</h3>
 <p>
           This is the old skin that we have been dragging around since early
           days. Uses HTML tables.
         </p>
-<p>Examples:
-          <a class="external" href="http://xml.apache.org/">Apache XML</a>
-        
-</p>
-<a name="N10092"></a><a name="krysalis-site"></a>
+<a name="N1006B"></a><a name="krysalis-site"></a>
 <h3 class="underlined_5">krysalis-site</h3>
 <p>
           Uses HTML tables.
-        </p>
-<p>Examples:
         </p>
 </div>
   

Modified: forrest/site/docs/skins.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs/skins.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/docs/upgrading_05.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs/upgrading_05.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/docs/upgrading_05.html (original)
+++ forrest/site/docs/upgrading_05.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Upgrading to Forrest 0.5</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li class="current">
-<a class="base-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li>
 <a class="base-not-selected" href="../howto/index.html">How-To</a>
@@ -110,6 +110,9 @@
 <div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Documentation</div>
 <div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
 <div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
+<div class="menuitem">
 <a title="" href="../docs/your-project.html">Using Forrest</a>
 </div>
 <div class="menuitem">
@@ -128,9 +131,6 @@
 <a title="" href="../docs/skin-package.html">Skin Packages</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/plugins.html">Plugins</a>
-</div>
-<div class="menuitem">
 <a title="" href="../docs/forrest-contract.html">Our Contract</a>
 </div>
 <div class="menuitem">
@@ -211,7 +211,7 @@
 <a title="" href="../docs/wiki-sample.html">JSPWiki Reference</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/oowriter.html">OpenOffice.org Writer</a>
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
 </div>
 </div>
 </div>

Modified: forrest/site/docs/upgrading_06.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs/upgrading_06.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/docs/upgrading_06.html (original)
+++ forrest/site/docs/upgrading_06.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Upgrading to Apache Forrest 0.6</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li class="current">
-<a class="base-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li>
 <a class="base-not-selected" href="../howto/index.html">How-To</a>
@@ -110,6 +110,9 @@
 <div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Documentation</div>
 <div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
 <div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
+<div class="menuitem">
 <a title="" href="../docs/your-project.html">Using Forrest</a>
 </div>
 <div class="menuitem">
@@ -128,9 +131,6 @@
 <a title="" href="../docs/skin-package.html">Skin Packages</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/plugins.html">Plugins</a>
-</div>
-<div class="menuitem">
 <a title="" href="../docs/forrest-contract.html">Our Contract</a>
 </div>
 <div class="menuitem">
@@ -211,7 +211,7 @@
 <a title="" href="../docs/wiki-sample.html">JSPWiki Reference</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/oowriter.html">OpenOffice.org Writer</a>
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
 </div>
 </div>
 </div>
@@ -631,8 +631,9 @@
 <div class="section">
 <p>
       You can add a local CatalogManager.properties to your 
-      project.classes-dir to define your additional catalogs for DTDs
-      and other entities.
+      project.classes-dir (usually src/documentation/classes/)
+      to define your additional catalogs for DTDs and other entities.
+      Copy a default file from a fresh 'forrest seed site'.
       </p>
 <p>
       If you do not add such a configuration file, then there will be a

Modified: forrest/site/docs/upgrading_06.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs/upgrading_06.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/docs/validation.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs/validation.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/docs/validation.html (original)
+++ forrest/site/docs/validation.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>XML Validation</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li class="current">
-<a class="base-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li>
 <a class="base-not-selected" href="../howto/index.html">How-To</a>
@@ -110,6 +110,9 @@
 <div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Documentation</div>
 <div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
 <div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
+<div class="menuitem">
 <a title="" href="../docs/your-project.html">Using Forrest</a>
 </div>
 <div class="menupage">
@@ -128,9 +131,6 @@
 <a title="" href="../docs/skin-package.html">Skin Packages</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/plugins.html">Plugins</a>
-</div>
-<div class="menuitem">
 <a title="" href="../docs/forrest-contract.html">Our Contract</a>
 </div>
 <div class="menuitem">
@@ -211,7 +211,7 @@
 <a title="" href="../docs/wiki-sample.html">JSPWiki Reference</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/oowriter.html">OpenOffice.org Writer</a>
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
 </div>
 </div>
 </div>

Modified: forrest/site/docs/wiki-sample.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs/wiki-sample.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/docs/wiki-sample.html (original)
+++ forrest/site/docs/wiki-sample.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>wiki-sample</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li class="current">
-<a class="base-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li>
 <a class="base-not-selected" href="../howto/index.html">How-To</a>
@@ -110,6 +110,9 @@
 <div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Documentation</div>
 <div id="menu_1.1" class="menuitemgroup">
 <div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
+<div class="menuitem">
 <a title="" href="../docs/your-project.html">Using Forrest</a>
 </div>
 <div class="menuitem">
@@ -128,9 +131,6 @@
 <a title="" href="../docs/skin-package.html">Skin Packages</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/plugins.html">Plugins</a>
-</div>
-<div class="menuitem">
 <a title="" href="../docs/forrest-contract.html">Our Contract</a>
 </div>
 <div class="menuitem">
@@ -211,7 +211,7 @@
 <div class="menupagetitle">JSPWiki Reference</div>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/oowriter.html">OpenOffice.org Writer</a>
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
 </div>
 </div>
 </div>

Modified: forrest/site/docs/your-project.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs/your-project.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/docs/your-project.html (original)
+++ forrest/site/docs/your-project.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Using Forrest</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li class="current">
-<a class="base-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li>
 <a class="base-not-selected" href="../howto/index.html">How-To</a>
@@ -109,6 +109,9 @@
 <div id="menu">
 <div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Documentation</div>
 <div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
 <div class="menupage">
 <div class="menupagetitle">Using Forrest</div>
 </div>
@@ -128,9 +131,6 @@
 <a title="" href="../docs/skin-package.html">Skin Packages</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/plugins.html">Plugins</a>
-</div>
-<div class="menuitem">
 <a title="" href="../docs/forrest-contract.html">Our Contract</a>
 </div>
 <div class="menuitem">
@@ -211,7 +211,7 @@
 <a title="" href="../docs/wiki-sample.html">JSPWiki Reference</a>
 </div>
 <div class="menuitem">
-<a title="" href="../docs/oowriter.html">OpenOffice.org Writer</a>
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
 </div>
 </div>
 </div>
@@ -358,8 +358,8 @@
 <p>
        
 <a href="http://forrest.apache.org/mirrors.cgi">Download</a> the latest release
-       of Forrest and follow the index.html in the top-level, or
-       if you want to try the development version, then
+       of Forrest, or
+       if you want to try the development version,
        <a href="../build.html">build Forrest</a> from source.
      </p>
 <p>
@@ -1426,13 +1426,12 @@
       supporting catalog entity resolver:
       '<span class="codefrag">cp forrest/lib/core/xml-commons-resolver-1.1.jar $ANT_HOME/lib</span>'
       </p>
-<p>Note: The technique described above requires Ant 1.6+ otherwise
-        the &lt;import&gt;
+<p>(Note: The technique described above requires Ant 1.6+ otherwise the &lt;import&gt;
         task will not be available for you to use. Forrest
         bundles the latest version of Ant, so you can invoke your project
-        like this: '<span class="codefrag">forrest -f myproject.xml</span>'.
-        This will not run the '<span class="codefrag">forrest</span>' command. It will just
-        use Forrest's Ant and resolver to execute your buildfile.
+        like this: <span class="codefrag">forrest -f myproject.xml</span>.
+        This will not run forrest; it will just use Forrest's Ant to execute
+        your buildfile.)
       </p>
 <p>
         Another option is to use the Forrest Antlet from the Krysalis Project's <a class="external" href="http://antworks.sourceforge.net/importer/">Antworks Importer</a>.

Modified: forrest/site/docs/your-project.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs/your-project.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/faq.html
URL: http://svn.apache.org/viewcvs/forrest/site/faq.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/faq.html (original)
+++ forrest/site/faq.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Frequently Asked Questions</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="contrib.html">Project</a>
 </li>
 <li>
-<a class="base-not-selected" href="docs/your-project.html">Documentation</a>
+<a class="base-not-selected" href="docs/index.html">Documentation</a>
 </li>
 <li>
 <a class="base-not-selected" href="howto/index.html">How-To</a>
@@ -226,81 +226,72 @@
 <a href="#technical">2. Technical</a>
 <ul class="minitoc">
 <li>
-<a href="#edit-content">2.1. What tools can be used to edit the content?</a>
-</li>
-<li>
-<a href="#PDF-output">2.2. How can I generate one pdf-file out of
+<a href="#PDF-output">2.1. How can I generate one pdf-file out of
       the whole site or selected pages of the site?</a>
 </li>
 <li>
-<a href="#clickable-email-adress">2.3. How can I generate html-pages to show a 
+<a href="#clickable-email-adress">2.2. How can I generate html-pages to show a 
       'clickable' email-address (of the author-element)?</a>
 </li>
 <li>
-<a href="#CVS_revison_tags">2.4. How can I generate html-pages to show the
+<a href="#CVS_revison_tags">2.3. How can I generate html-pages to show the
       revision tag of cvs?</a>
 </li>
 <li>
-<a href="#ignoring_javadocs">2.5. 
+<a href="#ignoring_javadocs">2.4. 
         How do I stop Forrest breaking on links to external files that may not
         exist, like javadocs?
       </a>
 </li>
 <li>
-<a href="#link_raw">2.6. How do I link to raw files such as config.txt and brochure.pdf?
+<a href="#link_raw">2.5. How do I link to raw files such as config.txt and brochure.pdf?
       </a>
 </li>
 <li>
-<a href="#claimed_patterns">2.7. Some of my files are not being processed because they use
+<a href="#claimed_patterns">2.6. Some of my files are not being processed because they use
       common filenames.
       </a>
 </li>
 <li>
-<a href="#build_msg_a">2.8. What do the symbols and numbers mean when Forrest lists each
+<a href="#build_msg_a">2.7. What do the symbols and numbers mean when Forrest lists each
         document that it has built?
       </a>
 </li>
 <li>
-<a href="#pdf_images">2.9. Images don't display in PDFs. How do I fix this?</a>
+<a href="#pdf_images">2.8. Images don't display in PDFs. How do I fix this?</a>
 </li>
 <li>
-<a href="#index.html">2.10. 
+<a href="#index.html">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?
       </a>
 </li>
 <li>
-<a href="#headless_operation">2.11. 
+<a href="#headless_operation">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.
       </a>
 </li>
 <li>
-<a href="#catalog">2.12. 
+<a href="#catalog">2.11. 
         How do i configure my favourite XML editor or parser to find the
         local Forrest DTDs?
       </a>
 </li>
 <li>
-<a href="#label-entity">2.13. 
+<a href="#label-entity">2.12. 
         How to use special characters in the labels of the site.xml file?
       </a>
 </li>
 <li>
-<a href="#encoding">2.14. Does Forrest handle accents for non-English languages?</a>
-</li>
-<li>
-<a href="#skin">2.15. 
+<a href="#skin">2.13. 
         How to make the site look better and change its skin?
       </a>
 </li>
 <li>
-<a href="#xsp">2.16. How do I enable XSP processing?</a>
-</li>
-<li>
-<a href="#breadcrumbs">2.17. How do breadcrumbs work?  Why don't they work locally?</a>
+<a href="#xsp">2.14. How do I enable XSP processing?</a>
 </li>
 <li>
-<a href="#run_port">2.18. How do I make forrest run listen on a different port?</a>
+<a href="#breadcrumbs">2.15. How do breadcrumbs work?  Why don't they work locally?</a>
 </li>
 </ul>
 </li>
@@ -492,32 +483,8 @@
 </div>
 <a name="N1007E"></a><a name="technical"></a>
 <h3 class="underlined_5">2. Technical</h3>
-<a name="N10082"></a><a name="edit-content"></a>
-<h4 class="faq">2.1. What tools can be used to edit the content?</h4>
-<div align="right">
-<a href="#edit-content-menu">^</a>
-</div>
-<div style="margin-left: 15px">
-<p>If you are using the Apache Forrest xml
-          <a href="docs/dtd-docs.html">document format</a> or DocBook
-          or other xml document types, then you can use any text editor
-          or even a dedicated xml editor. You must ensure valid xml. See our
-          <a href="docs/catalog.html">configuration notes</a>
-          for various editors.
-        </p>
-<p>There are content management systems like
-         <a class="external" href="http://cocoon.apache.org/lenya/">Apache Lenya</a>.
-        </p>
-<p>Remember that Forrest can also use other source formats, such as
-          OpenOffice.org docs or JSPWiki. Use the appropriate editor for those
-          document types and ensure that the document stucture is consistent.
-          Forrest can also use "html" as the source format, in which case you
-          can use text editors or "html editors" such as the one provided
-          with the Mozilla web browser.
-        </p>
-</div>
-<a name="N1009C"></a><a name="PDF-output"></a>
-<h4 class="faq">2.2. How can I generate one pdf-file out of
+<a name="N10082"></a><a name="PDF-output"></a>
+<h4 class="faq">2.1. How can I generate one pdf-file out of
       the whole site or selected pages of the site?</h4>
 <div align="right">
 <a href="#PDF-output-menu">^</a>
@@ -542,8 +509,8 @@
          structure and navigation, rather than the old book.xml method.
        </p>
 </div>
-<a name="N100B6"></a><a name="clickable-email-adress"></a>
-<h4 class="faq">2.3. How can I generate html-pages to show a 
+<a name="N1009C"></a><a name="clickable-email-adress"></a>
+<h4 class="faq">2.2. How can I generate html-pages to show a 
       'clickable' email-address (of the author-element)?</h4>
 <div align="right">
 <a href="#clickable-email-adress-menu">^</a>
@@ -554,8 +521,8 @@
        and edit the "headers/authors" template.
        </p>
 </div>
-<a name="N100C1"></a><a name="CVS_revison_tags"></a>
-<h4 class="faq">2.4. How can I generate html-pages to show the
+<a name="N100A7"></a><a name="CVS_revison_tags"></a>
+<h4 class="faq">2.3. How can I generate html-pages to show the
       revision tag of cvs?</h4>
 <div align="right">
 <a href="#CVS_revison_tags-menu">^</a>
@@ -569,8 +536,8 @@
 <p>This technique could also be used for a modification date with
       $Date: 2004/01/15 08:52:47 $</p>
 </div>
-<a name="N100D3"></a><a name="ignoring_javadocs"></a>
-<h4 class="faq">2.5. 
+<a name="N100B9"></a><a name="ignoring_javadocs"></a>
+<h4 class="faq">2.4. 
         How do I stop Forrest breaking on links to external files that may not
         exist, like javadocs?
       </h4>
@@ -613,8 +580,8 @@
         </div>
 </div>
 </div>
-<a name="N10107"></a><a name="link_raw"></a>
-<h4 class="faq">2.6. How do I link to raw files such as config.txt and brochure.pdf?
+<a name="N100ED"></a><a name="link_raw"></a>
+<h4 class="faq">2.5. How do I link to raw files such as config.txt and brochure.pdf?
       </h4>
 <div align="right">
 <a href="#link_raw-menu">^</a>
@@ -639,8 +606,8 @@
           'forrest seed' site.
         </p>
 </div>
-<a name="N10124"></a><a name="claimed_patterns"></a>
-<h4 class="faq">2.7. Some of my files are not being processed because they use
+<a name="N1010A"></a><a name="claimed_patterns"></a>
+<h4 class="faq">2.6. Some of my files are not being processed because they use
       common filenames.
       </h4>
 <div align="right">
@@ -655,14 +622,12 @@
         
 </p>
 <p>
-          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
-          (<a class="external" href="http://issues.cocoondev.org/browse/FOR-217">FOR-217</a>).
+          Sometimes there are workarounds, e.g. perhaps "my_site".
+          In future versions of Forrest we will attempt to deal with this issue.
         </p>
 </div>
-<a name="N10136"></a><a name="build_msg_a"></a>
-<h4 class="faq">2.8. What do the symbols and numbers mean when Forrest lists each
+<a name="N10118"></a><a name="build_msg_a"></a>
+<h4 class="faq">2.7. What do the symbols and numbers mean when Forrest lists each
         document that it has built?
       </h4>
 <div align="right">
@@ -685,8 +650,8 @@
          Column 4 is the page size.
         </p>
 </div>
-<a name="N10142"></a><a name="pdf_images"></a>
-<h4 class="faq">2.9. Images don't display in PDFs. How do I fix this?</h4>
+<a name="N10124"></a><a name="pdf_images"></a>
+<h4 class="faq">2.8. Images don't display in PDFs. How do I fix this?</h4>
 <div align="right">
 <a href="#pdf_images-menu">^</a>
 </div>
@@ -725,8 +690,8 @@
           Forrest.</div>
 </div>
 </div>
-<a name="N1016E"></a><a name="index.html"></a>
-<h4 class="faq">2.10. 
+<a name="N10150"></a><a name="index.html"></a>
+<h4 class="faq">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?
       </h4>
@@ -751,8 +716,8 @@
     &lt;map:redirect-to uri="manual/Introduction.html"/&gt;
   &lt;/map:match&gt;</pre>
 </div>
-<a name="N1018A"></a><a name="headless_operation"></a>
-<h4 class="faq">2.11. 
+<a name="N1016C"></a><a name="headless_operation"></a>
+<h4 class="faq">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.
       </h4>
 <div align="right">
@@ -770,8 +735,8 @@
           <a class="external" href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon FAQ</a>.
         </p>
 </div>
-<a name="N101A6"></a><a name="catalog"></a>
-<h4 class="faq">2.12. 
+<a name="N10188"></a><a name="catalog"></a>
+<h4 class="faq">2.11. 
         How do i configure my favourite XML editor or parser to find the
         local Forrest DTDs?
       </h4>
@@ -785,8 +750,8 @@
           local DTDs</a>.
         </p>
 </div>
-<a name="N101B2"></a><a name="label-entity"></a>
-<h4 class="faq">2.13. 
+<a name="N10194"></a><a name="label-entity"></a>
+<h4 class="faq">2.12. 
         How to use special characters in the labels of the site.xml file?
       </h4>
 <div align="right">
@@ -807,65 +772,8 @@
         <a class="external" href="http://issues.cocoondev.org/browse/FOR-244">Issue FOR-244</a>.
         </p>
 </div>
-<a name="N101CB"></a><a name="encoding"></a>
-<h4 class="faq">2.14. Does Forrest handle accents for non-English languages?</h4>
-<div align="right">
-<a href="#encoding-menu">^</a>
-</div>
-<div style="margin-left: 15px">
-<p>Yes, Forrest can process text in any language, so you can include:</p>
-<ul>
-          
-<li>accents: &aacute; &eacute; &iacute; &oacute; &uacute;</li>
-          
-<li>diereses: &auml; &euml; &iuml; &ouml; &uuml;</li>
-          
-<li>tildes: &atilde; &ntilde; Ä© &otilde; Å©</li>
-        
-</ul>
-<p>This is because sources for Forrest docs are xml documents, which can include any of these,
-          provided the encoding declared by the xml doc matches the actual encoding used in the file.
-          For example if you declare the default encoding:</p>
-<pre class="code">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</pre>
-<p>but the file content is actually using ISO-8859-1 then you will
-           receive validation errors, especially if 
-           you include some non-ASCII characters.</p>
-<p>
-          This situation is commonly encountered when you edit the templates
-          created by <span class="codefrag">forrest seed</span> with your favorite 
-          (probably localized) editor without paying attention to the encoding,
-          or when you create a new file 
-          and simply copy the headers from another file.
-        </p>
-<p>Although UTF-8 is an encoding well-suited for most languages,
-          it is not usually the default in popular editors or systems.
-          In UNIX-like systems, most popular editors can handle different encodings to 
-          write the file in disk. With some editors the encoding of the file is preserved, while with others the default
-          is used regardless of the original encoding. In most cases the encoding used to write files
-          can be controlled by setting the environment variable <span class="codefrag">LANG</span>
-          to an appropriate value, for instance:
-        </p>
-<pre class="code">[localhost]$ export LANG=en_US.UTF-8</pre>
-<p>Of course the <em>appropriate</em> way to set the encoding depends on the editor/OS, 
-          but ultimately relys on the user preferences. So you can use the encoding you prefer, as long as 
-          the <span class="codefrag">encoding</span> attribute of the xml declaration matches the actual encoding of the file. 
-          This means 
-          that if you are not willing to abandon ISO-8859-1 you can always use the following declaration instead:</p>
-<pre class="code">&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;</pre>
-<p>Another option is to use "character entities" such as
-        <span class="codefrag">&amp;ouml;</span> (&ouml;) or the numeric form
-        <span class="codefrag">&amp;#246;</span> (&ouml;).
-        </p>
-<p>Another related issue is that your webserver needs to send http
-          headers with the matching charset definitions to the html page.
-        </p>
-<p>Here are some references which explain further:
-          <a class="external" href="http://orixo.com/events/gt2004/bios.html#torsten">GT2004 presentation by Torsten Schlabach</a> and 
-          <a class="external" href="http://www.alanwood.net/unicode/">Alan Wood's Unicode resources</a>.
-        </p>
-</div>
-<a name="N1021D"></a><a name="skin"></a>
-<h4 class="faq">2.15. 
+<a name="N101AD"></a><a name="skin"></a>
+<h4 class="faq">2.13. 
         How to make the site look better and change its skin?
       </h4>
 <div align="right">
@@ -885,8 +793,8 @@
         <a href="docs/your-project.html#new_skin">own skin</a>.
         </p>
 </div>
-<a name="N10234"></a><a name="xsp"></a>
-<h4 class="faq">2.16. How do I enable XSP processing?</h4>
+<a name="N101C4"></a><a name="xsp"></a>
+<h4 class="faq">2.14. How do I enable XSP processing?</h4>
 <div align="right">
 <a href="#xsp-menu">^</a>
 </div>
@@ -932,8 +840,8 @@
 <p>See also the 
         <a class="external" href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</a> Wiki page.</p>
 </div>
-<a name="N10269"></a><a name="breadcrumbs"></a>
-<h4 class="faq">2.17. How do breadcrumbs work?  Why don't they work locally?</h4>
+<a name="N101F9"></a><a name="breadcrumbs"></a>
+<h4 class="faq">2.15. How do breadcrumbs work?  Why don't they work locally?</h4>
 <div align="right">
 <a href="#breadcrumbs-menu">^</a>
 </div>
@@ -954,23 +862,9 @@
       in <span class="codefrag">skinconf.xml</span>.
       </p>
 </div>
-<a name="N1027E"></a><a name="run_port"></a>
-<h4 class="faq">2.18. How do I make forrest run listen on a different port?</h4>
-<div align="right">
-<a href="#run_port-menu">^</a>
-</div>
-<div style="margin-left: 15px">
-<p>
-<span class="codefrag">forrest run -Dforrest.jvmargs="-Djetty.port=80"</span>
-</p>
-<p>Or copy Forrest's src/core/context/jettyconf.xml file to your project's src/documentation
-      directory and set the port number in that file.  Then do <span class="codefrag">forrest run</span>
-      
-</p>
-</div>
-<a name="N10290"></a><a name="old_faqs"></a>
+<a name="N1020E"></a><a name="old_faqs"></a>
 <h3 class="underlined_5">3. Older versions</h3>
-<a name="N10294"></a><a name="unresolved_project.home"></a>
+<a name="N10212"></a><a name="unresolved_project.home"></a>
 <h4 class="faq">3.1. When invoking Forrest 0.4 from the
         forrest.antproxy.xml, the build fails because
         ${project.home} isn't resolved.
@@ -992,7 +886,7 @@
        &lt;classpath refid="forrest-classpath"/&gt;
        &lt;jvmarg value="-Dforrest.home=${forrest.home}"/&gt;</pre>
 </div>
-<a name="N102A9"></a><a name="odd_html"></a>
+<a name="N10227"></a><a name="odd_html"></a>
 <h4 class="faq">3.2. 
         After upgrading to 0.4 my HTML looks significantly different, and table
         widths are wrong. What happened?
@@ -1015,7 +909,7 @@
 <pre class="code">
   &lt;doctype-system&gt;http://www.w3.org/TR/html4/loose.dtd&lt;/doctype-system&gt;</pre>
 </div>
-<a name="N102BF"></a><a name="validation_error-doctype_root_null"></a>
+<a name="N1023D"></a><a name="validation_error-doctype_root_null"></a>
 <h4 class="faq">3.3. 
         When building my project, I get an validation error: Document root
           element "site", must match DOCTYPE root "null"..
@@ -1038,7 +932,7 @@
           listed to prevent an attempt at DTD-based validation.
         </p>
 </div>
-<a name="N102DC"></a><a name="building_error-custom_sitemap"></a>
+<a name="N1025A"></a><a name="building_error-custom_sitemap"></a>
 <h4 class="faq">3.4. 
         When building my project, I get any of these errors: 
 	menu.xmap (The system cannot find the file specified)
@@ -1054,9 +948,9 @@
           <a href="docs/upgrading_05.html">Upgrading to Forrest 0.5</a>).
         </p>
 </div>
-<a name="N102F1"></a><a name="general"></a>
+<a name="N1026F"></a><a name="general"></a>
 <h3 class="underlined_5">4. General</h3>
-<a name="N102F5"></a><a name="generating_menus"></a>
+<a name="N10273"></a><a name="generating_menus"></a>
 <h4 class="faq">4.1. What is the relationship between site.xml and
         book.xml?
       </h4>
@@ -1075,7 +969,7 @@
           See <a href="docs/linking.html">Menus and Linking</a>.
       </p>
 </div>
-<a name="N10310"></a><a name="docbook"></a>
+<a name="N1028E"></a><a name="docbook"></a>
 <h4 class="faq">4.2. 
         How do I use DocBook as the xml documentation format?
       </h4>
@@ -1133,7 +1027,7 @@
          for configuration guidance.
         </p>
 </div>
-<a name="N10331"></a><a name="version"></a>
+<a name="N102AF"></a><a name="version"></a>
 <h4 class="faq">4.3. 
         How to report which version of Forrest is being used and the
         properties that are set?
@@ -1152,7 +1046,7 @@
           Doing <span class="codefrag">'forrest -v'</span> will provide verbose build messages.
         </p>
 </div>
-<a name="N10345"></a><a name="logs"></a>
+<a name="N102C3"></a><a name="logs"></a>
 <h4 class="faq">4.4. 
         Where are the log files to find more infomation about errors?
       </h4>
@@ -1181,7 +1075,7 @@
           to the standard output.
         </p>
 </div>
-<a name="N10369"></a><a name="how_can_I_help"></a>
+<a name="N102E7"></a><a name="how_can_I_help"></a>
 <h4 class="faq">4.5. 
         How to help?
       </h4>
@@ -1198,7 +1092,7 @@
           else. Don't be shy!
         </p>
 </div>
-<a name="N10375"></a><a name="patch"></a>
+<a name="N102F3"></a><a name="patch"></a>
 <h4 class="faq">4.6. 
         How to contribute a patch?
       </h4>

Modified: forrest/site/faq.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/faq.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/faq.xml
URL: http://svn.apache.org/viewcvs/forrest/site/faq.xml?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/faq.xml (original)
+++ forrest/site/faq.xml Thu Feb 17 23:24:06 2005
@@ -79,25 +79,7 @@
          Set the <code>ANT_OPTS</code> environment variable before you run forrest.  The exact value you set
          it to is dependant on your JVM, but something like <code>ANT_OPTS=-Xmx500M</code> will probably work.
         </p>
-      </section></section><section id="technical"><title>2. Technical</title><section id="edit-content"><title>2.1. What tools can be used to edit the content?</title>
-        <p>If you are using the Apache Forrest xml
-          <link href="site:dtd-docs">document format</link> or DocBook
-          or other xml document types, then you can use any text editor
-          or even a dedicated xml editor. You must ensure valid xml. See our
-          <link href="site:catalog">configuration notes</link>
-          for various editors.
-        </p>
-        <p>There are content management systems like
-         <link href="site:references/lenya">Apache Lenya</link>.
-        </p>
-        <p>Remember that Forrest can also use other source formats, such as
-          OpenOffice.org docs or JSPWiki. Use the appropriate editor for those
-          document types and ensure that the document stucture is consistent.
-          Forrest can also use "html" as the source format, in which case you
-          can use text editors or "html editors" such as the one provided
-          with the Mozilla web browser.
-        </p>
-      </section><section id="PDF-output"><title>2.2. How can I generate one pdf-file out of
+      </section></section><section id="technical"><title>2. Technical</title><section id="PDF-output"><title>2.1. How can I generate one pdf-file out of
       the whole site or selected pages of the site?</title>
       <p>Add the following entries to your site.xml file:</p>
         <source xml:space="preserve">
@@ -117,13 +99,13 @@
          <link href="site:linking">site.xml</link> method for your site
          structure and navigation, rather than the old book.xml method.
        </p>
-       </section><section id="clickable-email-adress"><title>2.3. How can I generate html-pages to show a 
+       </section><section id="clickable-email-adress"><title>2.2. How can I generate html-pages to show a 
       'clickable' email-address (of the author-element)?</title>
        <p>You would override <code>
        src/core/context/skins/common/xslt/html/document2html.xsl</code>
        and edit the "headers/authors" template.
        </p>
-       </section><section id="CVS_revison_tags"><title>2.4. How can I generate html-pages to show the
+       </section><section id="CVS_revison_tags"><title>2.3. How can I generate html-pages to show the
       revision tag of cvs?</title>
       <p>If you have:<code>&lt;version&gt;$Revision: 1.30
       $&lt;/version&gt;</code>The '1.30' will be extracted and
@@ -132,7 +114,7 @@
       <link href="site:your-project"> Using Forrest</link> document.</p>
       <p>This technique could also be used for a modification date with
       $Date: 2004/01/15 08:52:47 $</p>
-      </section><section id="ignoring_javadocs"><title>2.5. 
+      </section><section id="ignoring_javadocs"><title>2.4. 
         How do I stop Forrest breaking on links to external files that may not
         exist, like javadocs?
       </title>
@@ -167,7 +149,7 @@
           <code>foo/bar</code>, but not <code>foo/bar/baz</code>
            &#8212; use <strong>foo/**</strong> to match that.
         </note>
-      </section><section id="link_raw"><title>2.6. How do I link to raw files such as config.txt and brochure.pdf?
+      </section><section id="link_raw"><title>2.5. How do I link to raw files such as config.txt and brochure.pdf?
       </title>
         <p>
           Place them in the <code>src/documentation/content</code> directory
@@ -187,7 +169,7 @@
           See the explanation and demonstration of "linking" in your local
           'forrest seed' site.
         </p>
-      </section><section id="claimed_patterns"><title>2.7. Some of my files are not being processed because they use
+      </section><section id="claimed_patterns"><title>2.6. Some of my files are not being processed because they use
       common filenames.
       </title>
         <p>
@@ -197,12 +179,10 @@
           community, howto</code>
         </p>
         <p>
-          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
-          (<link href="http://issues.cocoondev.org/browse/FOR-217">FOR-217</link>).
+          Sometimes there are workarounds, e.g. perhaps "my_site".
+          In future versions of Forrest we will attempt to deal with this issue.
         </p>
-      </section><section id="build_msg_a"><title>2.8. What do the symbols and numbers mean when Forrest lists each
+      </section><section id="build_msg_a"><title>2.7. What do the symbols and numbers mean when Forrest lists each
         document that it has built?
       </title>
         <source xml:space="preserve">
@@ -220,7 +200,7 @@
          Column 3 is the time taken.
          Column 4 is the page size.
         </p>
-      </section><section id="pdf_images"><title>2.9. Images don't display in PDFs. How do I fix this?</title>
+      </section><section id="pdf_images"><title>2.8. Images don't display in PDFs. How do I fix this?</title>
         <p>
 &#9;  Forrest uses <link href="http://xml.apache.org/fop/">Apache FOP</link>
           for rendering PDFs.  FOP cannot handle all image types natively, and
@@ -245,7 +225,7 @@
         </p>
         <note>Due to Sun's licensing, we cannot redistribute Jimi or JAI with
           Forrest.</note>
-      </section><section id="index.html"><title>2.10. 
+      </section><section id="index.html"><title>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?
       </title>
@@ -265,7 +245,7 @@
   &lt;map:match pattern="manual"&gt;
     &lt;map:redirect-to uri="manual/Introduction.html"/&gt;
   &lt;/map:match&gt;</source>
-     </section><section id="headless_operation"><title>2.11. 
+     </section><section id="headless_operation"><title>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.
       </title>
         <p>
@@ -278,7 +258,7 @@
           See also
           <link href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon FAQ</link>.
         </p>
-      </section><section id="catalog"><title>2.12. 
+      </section><section id="catalog"><title>2.11. 
         How do i configure my favourite XML editor or parser to find the
         local Forrest DTDs?
       </title>
@@ -287,7 +267,7 @@
           <link href="site:catalog">Using Catalog Entity Resolver for
           local DTDs</link>.
         </p>
-      </section><section id="label-entity"><title>2.13. 
+      </section><section id="label-entity"><title>2.12. 
         How to use special characters in the labels of the site.xml file?
       </title>
         <p>
@@ -302,54 +282,7 @@
         and see more discussion at
         <link href="http://issues.cocoondev.org/browse/FOR-244">Issue FOR-244</link>.
         </p>
-      </section><section id="encoding"><title>2.14. Does Forrest handle accents for non-English languages?</title>
-        <p>Yes, Forrest can process text in any language, so you can include:</p>
-        <ul>
-          <li>accents: á é í ó ú</li>
-          <li>diereses: ä ë ï ö ü</li>
-          <li>tildes: ã ñ &#297; õ &#361;</li>
-        </ul>
-        <p>This is because sources for Forrest docs are xml documents, which can include any of these,
-          provided the encoding declared by the xml doc matches the actual encoding used in the file.
-          For example if you declare the default encoding:</p>
-        <source xml:space="preserve">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</source>
-        <p>but the file content is actually using ISO-8859-1 then you will
-           receive validation errors, especially if 
-           you include some non-ASCII characters.</p>
-        <p>
-          This situation is commonly encountered when you edit the templates
-          created by <code>forrest seed</code> with your favorite 
-          (probably localized) editor without paying attention to the encoding,
-          or when you create a new file 
-          and simply copy the headers from another file.
-        </p>
-        <p>Although UTF-8 is an encoding well-suited for most languages,
-          it is not usually the default in popular editors or systems.
-          In UNIX-like systems, most popular editors can handle different encodings to 
-          write the file in disk. With some editors the encoding of the file is preserved, while with others the default
-          is used regardless of the original encoding. In most cases the encoding used to write files
-          can be controlled by setting the environment variable <code>LANG</code>
-          to an appropriate value, for instance:
-        </p>
-        <source xml:space="preserve">[localhost]$ export LANG=en_US.UTF-8</source>
-        <p>Of course the <em>appropriate</em> way to set the encoding depends on the editor/OS, 
-          but ultimately relys on the user preferences. So you can use the encoding you prefer, as long as 
-          the <code>encoding</code> attribute of the xml declaration matches the actual encoding of the file. 
-          This means 
-          that if you are not willing to abandon ISO-8859-1 you can always use the following declaration instead:</p>
-        <source xml:space="preserve">&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;</source>
-        <p>Another option is to use "character entities" such as
-        <code>&amp;ouml;</code> (ö) or the numeric form
-        <code>&amp;#246;</code> (ö).
-        </p>
-        <p>Another related issue is that your webserver needs to send http
-          headers with the matching charset definitions to the html page.
-        </p>
-        <p>Here are some references which explain further:
-          <link href="http://orixo.com/events/gt2004/bios.html#torsten">GT2004 presentation by Torsten Schlabach</link> and 
-          <link href="http://www.alanwood.net/unicode/">Alan Wood's Unicode resources</link>.
-        </p>
-      </section><section id="skin"><title>2.15. 
+      </section><section id="skin"><title>2.13. 
         How to make the site look better and change its skin?
       </title>
         <p>
@@ -364,7 +297,7 @@
         Some projects may have special needs and can define their
         <link href="site:your-project/new-skin">own skin</link>.
         </p>
-      </section><section id="xsp"><title>2.16. How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</title>
+      </section><section id="xsp"><title>2.14. How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</title>
         <p>First consider whether your needs would be better met by Cocoon itself, rather than Forrest.
         </p>
         <p>That said, there are valid reasons for wanting programmatically generated content, so here is how to enable
@@ -394,7 +327,7 @@
         </ol>
         <p>See also the 
         <link href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</link> Wiki page.</p>
-      </section><section id="breadcrumbs"><title>2.17. How do breadcrumbs work?  Why don't they work locally?</title>
+      </section><section id="breadcrumbs"><title>2.15. How do breadcrumbs work?  Why don't they work locally?</title>
       <p>Breadcrumbs begin with up to three URLs specified in
       <code>skinconf.xml</code>.  Here is what the Forrest site uses:</p>
       <source xml:space="preserve">
@@ -409,11 +342,6 @@
       the site locally, there is no domain and so
       there will be no extra breadcrumbs, only the ones that are specified
       in <code>skinconf.xml</code>.
-      </p>
-      </section><section id="run_port"><title>2.18. How do I make <code>forrest run</code> listen on a different port?</title>
-      <p><code>forrest run -Dforrest.jvmargs="-Djetty.port=80"</code></p>
-      <p>Or copy Forrest's src/core/context/jettyconf.xml file to your project's src/documentation
-      directory and set the port number in that file.  Then do <code>forrest run</code>
       </p>
       </section></section><section id="old_faqs"><title>3. Older versions</title><section id="unresolved_project.home"><title>3.1. When invoking Forrest 0.4 from the
         <code>forrest.antproxy.xml</code>, the build fails because

Modified: forrest/site/flyer.html
URL: http://svn.apache.org/viewcvs/forrest/site/flyer.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/flyer.html (original)
+++ forrest/site/flyer.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Apache Forrest: documentation framework</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -167,6 +167,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="flyer.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -281,7 +282,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/flyer.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/flyer.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/forrest-issues.html
URL: http://svn.apache.org/viewcvs/forrest/site/forrest-issues.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/forrest-issues.html (original)
+++ forrest/site/forrest-issues.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Open issues for the upcoming release</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -152,6 +152,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="forrest-issues.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -604,7 +605,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/forrest-issues.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/forrest-issues.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/guidelines.html
URL: http://svn.apache.org/viewcvs/forrest/site/guidelines.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/guidelines.html (original)
+++ forrest/site/guidelines.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Apache Forrest project guidelines</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -152,6 +152,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="guidelines.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -790,7 +791,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/guidelines.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/guidelines.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/howto/howto-asf-mirror.html
URL: http://svn.apache.org/viewcvs/forrest/site/howto/howto-asf-mirror.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/howto/howto-asf-mirror.html (original)
+++ forrest/site/howto/howto-asf-mirror.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Generate an ASF mirrors page using interactive web form</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li>
-<a class="base-not-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-not-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li class="current">
 <a class="base-selected" href="../howto/index.html">How-To</a>
@@ -118,9 +118,6 @@
 </div>
 <div class="menuitem">
 <a title="" href="../howto/howto-pdf-tab.html">Create tab PDF</a>
-</div>
-<div class="menuitem">
-<a title="" href="../howto/howto-corner-images.html">CSS corner SVG</a>
 </div>
 </div>
 <div id="credit"></div>

Modified: forrest/site/howto/howto-howto.html
URL: http://svn.apache.org/viewcvs/forrest/site/howto/howto-howto.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/howto/howto-howto.html (original)
+++ forrest/site/howto/howto-howto.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>How to write a How-To</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li>
-<a class="base-not-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-not-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li class="current">
 <a class="base-selected" href="../howto/index.html">How-To</a>
@@ -118,9 +118,6 @@
 </div>
 <div class="menuitem">
 <a title="" href="../howto/howto-pdf-tab.html">Create tab PDF</a>
-</div>
-<div class="menuitem">
-<a title="" href="../howto/howto-corner-images.html">CSS corner SVG</a>
 </div>
 </div>
 <div id="credit"></div>

Modified: forrest/site/howto/howto-pdf-tab.html
URL: http://svn.apache.org/viewcvs/forrest/site/howto/howto-pdf-tab.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/howto/howto-pdf-tab.html (original)
+++ forrest/site/howto/howto-pdf-tab.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>How to create a PDF document for each tab</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li>
-<a class="base-not-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-not-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li class="current">
 <a class="base-selected" href="../howto/index.html">How-To</a>
@@ -119,9 +119,6 @@
 <div class="menupage">
 <div class="menupagetitle">Create tab PDF</div>
 </div>
-<div class="menuitem">
-<a title="" href="../howto/howto-corner-images.html">CSS corner SVG</a>
-</div>
 </div>
 <div id="credit"></div>
 <div id="roundbottom">
@@ -170,7 +167,10 @@
 <a href="#sitemap">Create your project's main sitemap.xmap</a>
 </li>
 <li>
-<a href="#aggregator">Create another sitemap: pdf-tab.xmap</a>
+<a href="#aggregator">Create the aggregator sitemap pdf-tab.xmap</a>
+</li>
+<li>
+<a href="#workaround-202">Edit project sitemap.xmap</a>
 </li>
 <li>
 <a href="#mount">Edit project sitemap.xmap to mount pdf-tab.xmap</a>
@@ -249,72 +249,85 @@
 <div class="section">
 <p>The procedure outlined below will define a project
       <span class="codefrag">sitemap.xmap</span> and create a new
-      <span class="codefrag">pdf-tab.xmap</span>.
-    </p>
-<a name="N10051"></a><a name="sitemap"></a>
+      <span class="codefrag">pdf-tab.xmap</span> based on the <span class="codefrag">aggregate.xmap</span>
+    
+</p>
+<a name="N10054"></a><a name="sitemap"></a>
 <h3 class="underlined_5">Create your project's main sitemap.xmap</h3>
 <p>
-      If you do not have already a sitemap then create a new empty one in your
+      Simply copy the sitemap.xmap from the Forrest sitemaps at
+      <span class="codefrag">${FORREST_HOME}/context/sitemap.xmap</span> into your
       <span class="codefrag">src/documentation</span> directory (or wherever
       ${project.sitemap-dir} points to).
     </p>
-<a name="N1005E"></a><a name="aggregator"></a>
-<h3 class="underlined_5">Create another sitemap: pdf-tab.xmap</h3>
+<a name="N10064"></a><a name="aggregator"></a>
+<h3 class="underlined_5">Create the aggregator sitemap pdf-tab.xmap</h3>
+<p>
+    Copy the aggregate.xmap from Forrest sitemaps into your
+    ${project.sitemap-dir} and rename it to pdf-tab.xmap
+    </p>
+<a name="N1006E"></a><a name="workaround-202"></a>
+<h3 class="underlined_5">Edit project sitemap.xmap</h3>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+      This is a workaround for Issue FOR-202
+    </div>
+</div>
 <p>
-    Like before create an empty sitemap and name it pdf-tab.xmap.
+      Edit the project <span class="codefrag">sitemap.xmap</span> to comment-out the match
+      for the sitemap like this:
     </p>
-<a name="N10068"></a><a name="mount"></a>
+<pre class="code">
+&lt;!--
+&lt;map:pipeline internal-only="false"&gt;
+&lt;map:select type="exists"&gt;
+  &lt;map:when test="{project:sitemap}"&gt;
+    &lt;map:mount uri-prefix="" src="{project:sitemap}" check-reload="yes" /&gt;
+  &lt;/map:when&gt;  
+&lt;/map:select&gt;
+&lt;/map:pipeline
+--&gt;
+    </pre>
+<a name="N10082"></a><a name="mount"></a>
 <h3 class="underlined_5">Edit project sitemap.xmap to mount pdf-tab.xmap</h3>
 <p>
-      Your sitemap should look something like this.
+      Insert the following lines after the
+      <span class="codefrag">&lt;map:match pattern="site.xml"&gt;</span>
+      pipeline in the section called "SOURCE FORMATS".
     </p>
 <pre class="code">
-&lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;
-  &lt;map:pipelines&gt;
-    &lt;map:pipeline internal-only="false"&gt;
-      &lt;map:match pattern="**.xml"&gt;
-        &lt;!-- pdf-tab definitions --&gt;
-        &lt;map:match pattern="pdf-tab.xml"&gt;
-          &lt;map:mount uri-prefix="" src="pdf-tab.xmap"
-            check-reload="yes" /&gt;
-        &lt;/map:match&gt;
-        &lt;!-- end of pdf-tab definitions --&gt;
-      &lt;/map:match&gt;
-    &lt;/map:pipeline&gt;
-  &lt;/map:pipelines&gt;
-&lt;/map:sitemap&gt;
+...
+&lt;map:match pattern="pdf-tab.xml"&gt;
+   &lt;map:mount uri-prefix="" src="pdf-tab.xmap" check-reload="yes" /&gt;
+&lt;/map:match&gt;
+...
     </pre>
-<a name="N10076"></a><a name="edit-aggregator"></a>
+<a name="N10093"></a><a name="edit-aggregator"></a>
 <h3 class="underlined_5">Edit the file pdf-tab.xmap</h3>
 <p>
       The <span class="codefrag">&lt;map:match pattern="*.xml"&gt;</span> element
       should look like the following:
     </p>
 <pre class="code">
-&lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;
-  &lt;map:pipelines&gt;
-    &lt;map:pipeline internal-only="false"&gt;
-     &lt;map:match pattern="*.xml"&gt;
-	&lt;map:generate src="cocoon://abs-linkmap"/&gt;
-	  &lt;map:transform type="xpath"&gt;
-	  	&lt;map:parameter name="include" value="//*[@wholesite='true']"/&gt;
-		&lt;map:parameter name="exclude" value="//*[@wholesite='false']"/&gt;
-	  &lt;/map:transform&gt;
-	  &lt;map:transform src="resources/stylesheets/site2book.xsl" /&gt;
-	  &lt;map:transform src="resources/stylesheets/aggregates/book2cinclude.xsl"&gt;
-	     &lt;map:parameter name="title"
-		value="{conf:project-name}: Still My Foo Site"/&gt;
-	     &lt;/map:transform&gt;
-	  &lt;map:transform type="cinclude"/&gt;
-	  &lt;map:transform src="resources/stylesheets/aggregates/doc2doc-uniqueids.xsl"/&gt;
-	  &lt;map:transform src="resources/stylesheets/aggregates/docs2document.xsl"/&gt;
-	  &lt;map:serialize type="xml"/&gt;
-    &lt;/map:match&gt;    
-   &lt;/map:pipeline&gt;
-  &lt;/map:pipelines&gt;
-&lt;/map:sitemap&gt;
+&lt;map:match pattern="*.xml"&gt;
+  &lt;map:generate src="cocoon://abs-linkmap"/&gt;
+  &lt;map:transform type="xpath"&gt;
+	&lt;map:parameter name="include" value="//*[@wholesite='true']"/&gt;
+	&lt;map:parameter name="exclude" value="//*[@wholesite='false']"/&gt;
+  &lt;/map:transform&gt;
+  &lt;map:transform src="resources/stylesheets/site2book.xsl" /&gt;
+  &lt;map:transform src="resources/stylesheets/aggregates/book2cinclude.xsl"&gt;
+     &lt;map:parameter name="title"
+        value="{conf:project-name}: Still My Foo Site"/&gt;
+  &lt;/map:transform&gt;
+  &lt;map:transform type="cinclude"/&gt;
+  &lt;map:transform src="resources/stylesheets/aggregates/doc2doc-uniqueids.xsl"/&gt;
+  &lt;map:transform src="resources/stylesheets/aggregates/docs2document.xsl"/&gt;
+  &lt;map:serialize type="xml"/&gt;
+&lt;/map:match&gt;
     </pre>
-<a name="N10089"></a><a name="edit-site"></a>
+<a name="N100A6"></a><a name="edit-site"></a>
 <h3 class="underlined_5">Edit your site.xml</h3>
 <p>Add the following entry to your site.xml in the
       <span class="codefrag">&lt;about&gt;</span> element
@@ -355,7 +368,7 @@
 	 as the child (will cause a <span class="codefrag">stack overflow</span> if you do)!!!
 	</div>
 </div>
-<a name="N100B9"></a><a name="explain"></a>
+<a name="N100D6"></a><a name="explain"></a>
 <h3 class="underlined_5">Explanation of the operation</h3>
 <p>
       Line 4 of our example
@@ -403,10 +416,27 @@
 <span class="codefrag">&lt;map:parameter name="title" value="{conf:project-name}: Still My Foo Site"/&gt;</span>
     
 </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+      In the original <span class="codefrag">aggregate.xmap</span> there is the line
+      <br>
+      
+<span class="codefrag">&lt;map:parameter name="ignore" value="{1}"/&gt;</span>
+      
+<br>
+      just before the title definition
+      (<span class="codefrag">&lt;map:parameter name="title" value=".../&gt;</span>).
+      Be sure to delete it or comment it out if you like to generate a
+      pdf-file for specific sites. You only need it for the generation of
+      one pdf-file for the whole project (this is what
+      <span class="codefrag">aggregate.xmap</span> usually does).
+    </div>
+</div>
 </div>
 
   
-<a name="N100F1"></a><a name="Feedback and further development of this How-To"></a>
+<a name="N10121"></a><a name="Feedback and further development of this How-To"></a>
 <h2 class="underlined_10">Feedback and further development of this How-To</h2>
 <div class="section">
 <p>
@@ -417,6 +447,12 @@
       In the future, this ability will probably be incorporated into the
       main Forrest process.
     </p>
+<div class="frame fixme">
+<div class="label">Fixme (open)</div>
+<div class="content">
+      This document will need to be modified when Issue FOR-202 is solved.
+    </div>
+</div>
 </div>
 
 </div>

Modified: forrest/site/howto/howto-pdf-tab.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/howto/howto-pdf-tab.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/howto/index.html
URL: http://svn.apache.org/viewcvs/forrest/site/howto/index.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/howto/index.html (original)
+++ forrest/site/howto/index.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Overview of the How-To documents</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -67,7 +67,7 @@
 <a class="base-not-selected" href="../contrib.html">Project</a>
 </li>
 <li>
-<a class="base-not-selected" href="../docs/your-project.html">Documentation</a>
+<a class="base-not-selected" href="../docs/index.html">Documentation</a>
 </li>
 <li class="current">
 <a class="base-selected" href="../howto/index.html">How-To</a>
@@ -119,9 +119,6 @@
 <div class="menuitem">
 <a title="" href="../howto/howto-pdf-tab.html">Create tab PDF</a>
 </div>
-<div class="menuitem">
-<a title="" href="../howto/howto-corner-images.html">CSS corner SVG</a>
-</div>
 </div>
 <div id="credit"></div>
 <div id="roundbottom">
@@ -169,13 +166,6 @@
 <a href="../howto/howto-pdf-tab.html">How to create a PDF document for each tab</a>
         - Describes the generation of a PDF document for each
         group of documents that is defined by a tab.
-      </li>
-      
-<li>
-<a href="../howto/howto-corner-images.html">How to modify the color of generated corner images</a>
-        - Describes the use of CSS values from the skinconf.xml configuration
-        file to change the color of the corner images to be suitable for
-        your own skin colors. Advanced use explains editing the *.css too.
       </li>
     
 </ul>

Modified: forrest/site/howto/index.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/howto/index.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/index.html
URL: http://svn.apache.org/viewcvs/forrest/site/index.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/index.html (original)
+++ forrest/site/index.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Welcome to Apache Forrest</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -167,6 +167,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="index.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -396,20 +397,15 @@
         <a href="docs/dev/">current development</a>
         version from the source
         repository. All versions of Forrest include their own copy of the documentation.
-        To view it, do '<a href="http://forrest.apache.org/docs/build.html#run">forrest run</a>' and go to
+        To view it, do '<a href="http://forrest.apache.org/docs/../build.html#run">forrest run</a>' and go to
         http://127.0.0.1:8888/  (for versions after 0.6, do 'cd docs-author' first).
         The <a href="http://forrest.apache.org/">Apache Forrest website</a> is updated
         manually as needed, while we develop the 
-        <a class="external" href="site:forrestbot">forrestbot</a> deployment facility.
-           <!-- FIXME: It is out-of-date.
-           which produces the
-          <link href="http://forrestbot.cocoondev.org/">automatically
-            generated</link> site.
-            -->
+        <a href="proposal-asf-forrestbot.html">forrestbot</a> deployment facility.
       </p>
 </div>
     
-<a name="N1010E"></a><a name="news"></a>
+<a name="N1010C"></a><a name="news"></a>
 <h2 class="underlined_10">News and events</h2>
 <div class="section">
 <ul>
@@ -428,7 +424,7 @@
 </ul>
 </div>
     
-<a name="N1011E"></a><a name="help"></a>
+<a name="N1011C"></a><a name="help"></a>
 <h2 class="underlined_10">Help Wanted!</h2>
 <div class="section">
 <p>
@@ -460,9 +456,9 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <div id="logos">
-<a href="http://validator.w3.org/check/referer"><img style="height: 31px; width: 88px;" title="Valid HTML 4.01!" alt="Valid HTML 4.01!" src="skin/images/valid-html401.png" class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/check/referer"><img style="height: 31px; width: 88px;" title="Valid CSS!" alt="Valid CSS!" src="skin/images/vcss.png" class="logoImage"></a><a href="http://forrest.apache.org/"><img border="0" title="Built with Apache Forrest" alt="Built with Apache Forrest - logo" src="skin/images/built-with-forrest-button.png" style="width: 88px;height: 31px;"></a><a href="http://cocoon.apache.org/"><img border="0" title="Built with Apache Cocoon" alt="Built with Apache Cocoon - logo" src="images/built-with-cocoon.gif" style="width: 88px;height: 31px;"></a><a href="http://www.apache.org/foundation/thanks.html"><img border="0" title="thanks to ASF, thanks from ASF" alt="thanks to ASF, thanks from ASF - logo" src="images/icon.png" style="width: 26px;height: 22px;"></a>
+<a href="http://validator.w3.org/check/referer"><img style="height: 31px; width: 88px;" title="Valid HTML 4.01!" alt="Valid HTML 4.01!" src="skin/images/valid-html401.png" class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/"><img style="height: 31px; width: 88px;" title="Valid CSS!" alt="Valid CSS!" src="skin/images/vcss.png" class="logoImage"></a><a href="http://forrest.apache.org/"><img border="0" title="Built with Apache Forrest" alt="Built with Apache Forrest - logo" src="skin/images/built-with-forrest-button.png" style="width: 88px;height: 31px;"></a><a href="http://cocoon.apache.org/"><img border="0" title="Built with Apache Cocoon" alt="Built with Apache Cocoon - logo" src="images/built-with-cocoon.gif" style="width: 88px;height: 31px;"></a><a href="http://www.apache.org/foundation/thanks.html"><img border="0" title="thanks to ASF, thanks from ASF" alt="thanks to ASF, thanks from ASF - logo" src="images/icon.png" style="width: 26px;height: 22px;"></a>
 </div>
 <!--+
     |end bottomstrip

Modified: forrest/site/index.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/index.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/index.xml
URL: http://svn.apache.org/viewcvs/forrest/site/index.xml?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/index.xml (original)
+++ forrest/site/index.xml Thu Feb 17 23:24:06 2005
@@ -28,21 +28,6 @@
       </p>
     </section>
 
-    <section id="apachecon">
-      <title>Come to ApacheCon US 2004</title>
-      <p>
-        <link href="http://apachecon.com/2004/US/">
-          <img src="http://ApacheCon.Com/2004/US/logos/logo_only.gif" alt="apachecon 2004 logo" width="170" height="100"/>
-        </link>
-        <link href="http://apachecon.com/2004/US/">ApacheCon US 2004</link>
-          (13-17 November 2004). ApacheCon is the conference for all
-          things Apache. Come along and learn about a range of new
-          technologies, meet some Apache folks and share the knowledge.
-          See more information about
-         <link href="http://www.apache.org/foundation/conferences.html">Apache Conferences</link>.
-      </p>
-    </section>
-
     <section>
       <title>User-friendly</title>
       <p>
@@ -176,7 +161,7 @@
         releases. It is certainly usable now (despite not yet being version 1.x).
          See the growing list of 
          <link href="site:live-sites">example sites</link> including
-         many Apache sites.
+         Many Apache sites.
       </p>
       <p>
         In general, prior to 1.0, ensuring quality of design will be considered
@@ -208,23 +193,22 @@
     <section id="news">
       <title>News and events</title>
       <ul>
-        <li>Apache Forrest 0.6 was released on 2004-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.
-        </li>
         <li>The Forrest project has evolved to become a "top-level" Apache
-         project.
+         project. We are making good progress towards the 0.6 release
+         which has many efficiency and usability improvements.
+        </li>
+        <li>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.
         </li>
       </ul>
     </section>
     <section id="help">
       <title>Help Wanted!</title>
       <p>
-        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.
+        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!
       </p>
       <p>
         As with all Apache projects, Forrest is a meritocracy; the more you

Modified: forrest/site/license.html
URL: http://svn.apache.org/viewcvs/forrest/site/license.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/license.html (original)
+++ forrest/site/license.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Apache License</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -167,6 +167,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="license.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -406,7 +407,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/license.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/license.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/linkmap.html
URL: http://svn.apache.org/viewcvs/forrest/site/linkmap.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/linkmap.html (original)
+++ forrest/site/linkmap.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Site Linkmap</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -200,6 +200,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="linkmap.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -428,7 +429,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/linkmap.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/linkmap.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/live-sites.html
URL: http://svn.apache.org/viewcvs/forrest/site/live-sites.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/live-sites.html (original)
+++ forrest/site/live-sites.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Examples Built-With-Forrest</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -167,6 +167,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="live-sites.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -306,7 +307,7 @@
       
 <li>
 <a class="external" href="http://ws.apache.org/soap/">Apache SOAP</a> - an implementation of the SOAP submission</li>
-	  
+      
 <li>
 <a class="external" href="http://community.in-corp.com/postnuke/html/community.in-corp.com/tng/">Triathlon Northern Gauteng</a>
 </li>
@@ -325,7 +326,7 @@
 <li>
 <a class="external" href="http://gump.apache.org/">Apache Gump</a>
 </li>
-	    
+      
 <li>
 <a class="external" href="http://www.agssa.net/">AG Software</a>
 </li>
@@ -347,6 +348,9 @@
       
 <li>
 <a class="external" href="http://learnlinux.tsf.org.za/">Learn Linux</a> - developing Free/Open Source GNU/Linux Training Materials</li>
+      
+<li>
+<a class="external" href="http://computerdictionary.tsf.org.za">Computer Dictionary Project</a> - develop a DocBook XML computer nomenclature glossary database</li>
 <!--  <li><link href=""></link></li> -->
     
 </ul>
@@ -367,7 +371,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/live-sites.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/live-sites.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/mail-lists.html
URL: http://svn.apache.org/viewcvs/forrest/site/mail-lists.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/mail-lists.html (original)
+++ forrest/site/mail-lists.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Mailing Lists</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -152,6 +152,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="mail-lists.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -341,7 +342,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/mail-lists.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/mail-lists.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/mirrors.cgi
URL: http://svn.apache.org/viewcvs/forrest/site/mirrors.cgi?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/mirrors.cgi (original)
+++ forrest/site/mirrors.cgi Thu Feb 17 23:24:06 2005
@@ -1,6 +1,7 @@
 #!/bin/sh
 
-# Copyright 2002-2004 The Apache Software Foundation
+# Copyright 2002-2004 The Apache Software Foundation or its licensors,
+# as applicable.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

Modified: forrest/site/proposal-asf-forrestbot.html
URL: http://svn.apache.org/viewcvs/forrest/site/proposal-asf-forrestbot.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/proposal-asf-forrestbot.html (original)
+++ forrest/site/proposal-asf-forrestbot.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Draft: Proposal for ASF-wide Forrestbot</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -152,6 +152,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="proposal-asf-forrestbot.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -251,7 +252,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/proposal-asf-forrestbot.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/proposal-asf-forrestbot.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/proposal-asf-publish.html
URL: http://svn.apache.org/viewcvs/forrest/site/proposal-asf-publish.html?view=diff&r1=154250&r2=154251
==============================================================================
--- forrest/site/proposal-asf-publish.html (original)
+++ forrest/site/proposal-asf-publish.html Thu Feb 17 23:24:06 2005
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-version" content="0.6">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Draft: Proposal for ASF-wide documentation staging and publishing</title>
 <link type="text/css" href="skin/basic.css" rel="stylesheet">
@@ -152,6 +152,7 @@
     |start content
     +-->
 <div id="content">
+<div id="skinconf-txtlink"></div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="proposal-asf-publish.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
@@ -468,7 +469,7 @@
 //  --></script>
 </div>
 <div class="copyright">
- Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+ Copyright &copy; 2002-2005 The Apache Software Foundation.</div>
 <!--+
     |end bottomstrip
     +-->

Modified: forrest/site/proposal-asf-publish.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/proposal-asf-publish.pdf?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/skin/images/rc-b-l-15-1body-2menu-3menu.png
URL: http://svn.apache.org/viewcvs/forrest/site/skin/images/rc-b-l-15-1body-2menu-3menu.png?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/skin/images/rc-b-r-15-1body-2menu-3menu.png
URL: http://svn.apache.org/viewcvs/forrest/site/skin/images/rc-b-r-15-1body-2menu-3menu.png?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.

Modified: forrest/site/skin/images/rc-b-r-5-1header-2tab-selected-3tab-selected.png
URL: http://svn.apache.org/viewcvs/forrest/site/skin/images/rc-b-r-5-1header-2tab-selected-3tab-selected.png?view=diff&r1=154250&r2=154251
==============================================================================
Binary files - no diff available.