forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r354312 [15/17] - in /forrest/site: ./ docs_0_60/ docs_0_60/howto/ docs_0_60/howto/bugzilla-patch/ docs_0_70/ docs_0_70/howto/ docs_0_70/howto/cvs-ssh/ docs_0_80/ docs_0_80/howto/ docs_0_80/howto/cvs-ssh/ dtdx/ pluginDocs/plugins_0_70/ plug...
Date Tue, 06 Dec 2005 04:57:22 GMT
Modified: forrest/site/docs_0_80/howto/howto-structurer-dsl.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-structurer-dsl.html?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-structurer-dsl.html (original)
+++ forrest/site/docs_0_80/howto/howto-structurer-dsl.html Mon Dec  5 20:55:03 2005
@@ -434,11 +434,11 @@
 </div>
 <p> We developed<strong> the structurer</strong> to let the user decide 
       where to place elements in e.g. html pages. We started this work with the 
-      <span class="codefrag">skinconf.xml</span> where you could configure certain elements and 
+      <span class="codefrag ">skinconf.xml</span> where you could configure certain elements and 
       their positions. These elements were known under certain names. It was up 
       to the skin designer to support this configuration and the elements. </p>
 <p> The work started with grouping elements (the ones from skinconf). We 
-      used css-contracts that we added as @attributes e.g. <span class="codefrag">&lt;div id="content-main"/&gt;
+      used css-contracts that we added as @attributes e.g. <span class="codefrag ">&lt;div id="content-main"/&gt;
        </span>. That made it possible to use the same elements in different 
       skins. For the full list refer to the <a href="http://svn.apache.org/repos/asf/forrest/trunk/main/webapp/skins/leather-dev/contracts.initial.txt"> 
       initial contract list </a> 
@@ -452,8 +452,8 @@
 <strong>forrest:hook</strong>s are containers that are only used for 
       layout reasons. They <strong>do not</strong> add any content nor 
       functionality to the output. They add <strong>only</strong> layout 
-      information to the output. Actually e.g. a <span class="codefrag">&lt;forrest:hook name="layoutId"/&gt;
-      </span> will be transformed to <span class="codefrag">&lt;div id="layoutId"/&gt; 
+      information to the output. Actually e.g. a <span class="codefrag ">&lt;forrest:hook name="layoutId"/&gt;
+      </span> will be transformed to <span class="codefrag ">&lt;div id="layoutId"/&gt; 
       </span> 
 </p>
 <p> 
@@ -508,16 +508,16 @@
 </div>
 <p> In this section we will create a new structurer. We will override the 
         default structurer of the themer-plugin for the index page of the <a href="../../docs_0_80/howto/howto-structurer-install.html">v2</a>. For that we will create a 
-        file called <span class="codefrag">index.fv</span> and save it in our xdocs directory. 
+        file called <span class="codefrag ">index.fv</span> and save it in our xdocs directory. 
         This will make <strong>only</strong> the index.html page look different 
         from the rest of the project. </p>
 <p> Remember: pointing your browser to 
-        <span class="codefrag">http://localhost:8888/ls.contracts.html</span> will show a page 
+        <span class="codefrag ">http://localhost:8888/ls.contracts.html</span> will show a page 
         with all contracts and themes that you can use in your project provided 
         by forrest. </p>
 <p> Let us use the blank structurer from the earlier step and add the 
         content-main contract. In ls.contracts.html we find the information for 
-        how to use the contract in our structurer. Our <span class="codefrag">index.fv</span> 
+        how to use the contract in our structurer. Our <span class="codefrag ">index.fv</span> 
         should look like: </p>
 <pre class="code">&lt;forrest:views 
   xmlns:forrest="http://apache.org/forrest/templates/1.0"
@@ -540,16 +540,16 @@
 <p>A contract has to request the data model it want to transform. This 
         happends by defining forrest:properties which have the same name like 
         the contract. In our case we want the HTML rendered from intermediate 
-        format (**.body.xml). This we are going to include via: <span class="codefrag">&lt;jx:import uri="cocoon://#{$cocoon/parameters/getRequest}.body.xml"/&gt;
+        format (**.body.xml). This we are going to include via: <span class="codefrag ">&lt;jx:import uri="cocoon://#{$cocoon/parameters/getRequest}.body.xml"/&gt;
          </span>
 </p>
 <p>Contracts can offer some property configuration of the outcome of 
-            the transformation. In our case <span class="codefrag">&lt;forrest:property name="content-main-conf"&gt;
+            the transformation. In our case <span class="codefrag ">&lt;forrest:property name="content-main-conf"&gt;
         &lt;headings type="underlined"/&gt;
       &lt;/forrest:property&gt;. </span>
 </p>
 <p> Lets try our new structurer by pointing to 
-        <span class="codefrag">http://localhost:8888/index.html</span>. We will see only the 
+        <span class="codefrag ">http://localhost:8888/index.html</span>. We will see only the 
         main content. Now let us add the section navigation to our structurer. 
         The contract usage in the structurer can be looked up in 
         ls.contracts.html. Our structurer now looks like: </p>
@@ -584,7 +584,7 @@
         next to each other (left: nav-section; right: content-main). </p>
 <a name="N100E6"></a><a name="hookstructurer"></a>
 <h3 class="underlined_5">Hooks in the structurer</h3>
-<p> We will use now the first time a <span class="codefrag">&lt;forrest:hook name="layoutId"/&gt;
+<p> We will use now the first time a <span class="codefrag ">&lt;forrest:hook name="layoutId"/&gt;
          </span>. Hooks are the styling side of the structurer. We can imitate 
         arbitrary html skeleton with their help. Before we explain how to use 
         your own css in the structurer, we will use the default css. You can 
@@ -599,7 +599,7 @@
     border: thin dashed #565248;
 }
       </pre>
-<p> With this information we know to use <span class="codefrag">&lt;forrest:hook name="leftbar"/&gt;
+<p> With this information we know to use <span class="codefrag ">&lt;forrest:hook name="leftbar"/&gt;
         </span> and add contracts into that container. </p>
 <p> If we want to put the nav-section contract into the left-hand side 
         position of the site we need to place the contract into that hook. 
@@ -642,7 +642,7 @@
 <p>We now know how to place contracts and hooks in our structurer. Until 
         this stage we only used the common.css. CSS-support of the structurer 
         is as easy as placing contracts/hooks. To override the common.css 
-        stylesheet we use another tag within our structurer <span class="codefrag">&lt;forrest:css /&gt;
+        stylesheet we use another tag within our structurer <span class="codefrag ">&lt;forrest:css /&gt;
         </span>. </p>
 <p>You can add inline and linked css with the structurer. As soon as you 
         use forrest:css you will disable the fallback css support from 
@@ -665,8 +665,8 @@
 <div class="label">Note</div>
 <div class="content">
         
-<span class="codefrag">&lt;forrest:css /&gt;</span> needs to be the direct child of 
-        <span class="codefrag">&lt;forrest:view type="html"&gt;</span>
+<span class="codefrag ">&lt;forrest:css /&gt;</span> needs to be the direct child of 
+        <span class="codefrag ">&lt;forrest:view type="html"&gt;</span>
       
 </div>
 </div>
@@ -709,7 +709,7 @@
 &lt;/forrest:views&gt;
       </pre>
 <p>As a second example, let us change 
-        as well the content-main by adding another hook <span class="codefrag">&lt;forrest:hook name="content"/&gt;
+        as well the content-main by adding another hook <span class="codefrag ">&lt;forrest:hook name="content"/&gt;
         </span> We need to add the new layout container to our inline css: </p>
 <pre class="code">
 /* The actual content */

Modified: forrest/site/docs_0_80/howto/howto-structurer-install.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-structurer-install.html?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-structurer-install.html (original)
+++ forrest/site/docs_0_80/howto/howto-structurer-install.html Mon Dec  5 20:55:03 2005
@@ -421,7 +421,7 @@
         The first step is to build and deploy the internal.structurer and the output.themer plugins.
       </p>
 <p>
-        Run the script <span class="codefrag">etc/structurer.sh</span> *after* you did an svn update.
+        Run the script <span class="codefrag ">etc/structurer.sh</span> *after* you did an svn update.
       </p>
 <p>
         Otherwise build and deploy them manually. Do your usual 'svn update', then ...
@@ -475,8 +475,8 @@
 <h3 class="underlined_5">Test your new "dispatcher" based project</h3>
 <p> 
         Now you have finished the preparation and the setup to finally do
-        <span class="codefrag">'forrest run'</span> and
-        point your browser to <span class="codefrag">http://localhost:8888/</span> and you will see the default
+        <span class="codefrag ">'forrest run'</span> and
+        point your browser to <span class="codefrag ">http://localhost:8888/</span> and you will see the default
         dispatcher-based site.
       </p>
 <a name="N10090"></a><a name="availableContracts"></a>
@@ -490,7 +490,7 @@
        (ls.contracts and/or ls.contracts.project)
       </p>
 <p>
-        Now point your browser to e.g. <span class="codefrag">http://localhost:8888/ls.contracts.html</span> 
+        Now point your browser to e.g. <span class="codefrag ">http://localhost:8888/ls.contracts.html</span> 
         ... On this page you will find all contracts that you can use in your project.
       </p>
 </div>

Modified: forrest/site/docs_0_80/howto/howto-view-contracts.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-view-contracts.html?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-view-contracts.html (original)
+++ forrest/site/docs_0_80/howto/howto-view-contracts.html Mon Dec  5 20:55:03 2005
@@ -429,7 +429,7 @@
 <p>
       By working on the i18n integration for "pelt" we again encountered the reasons for using a different system 
       then "old fashion" skins. The maintenance problem was to change the captions of the skin features (contracts) to enable
-      support for i18n. The case is that the <span class="codefrag">site2xhtml.xsl</span> has a lot of repeating code. 
+      support for i18n. The case is that the <span class="codefrag ">site2xhtml.xsl</span> has a lot of repeating code. 
     </p>
 <p>
       For example the "last-publish"-contract could be found 2 times in the code.  
@@ -481,7 +481,7 @@
 <h3 class="underlined_5">Explaining the blank forrest:contract</h3>
 <p>
         To start a new forrest:contract you can copy the 'blank.ft' from
-        <span class="codefrag">org.apache.forrest.plugin.output.themer/resources/themes/common/html/blank.ft</span>. 
+        <span class="codefrag ">org.apache.forrest.plugin.output.themer/resources/themes/common/html/blank.ft</span>. 
       </p>
 <p>
         The 'blank.ft' is a simple xml file with the following code which you can use to base new contracts 
@@ -512,8 +512,8 @@
 
       </pre>
 <p>
-        The most important is the name of the contract <span class="codefrag">&lt;forrest:contract name="blank"/&gt;</span>. 
-        This name is the same as the file name of the contract (without file extension) <span class="codefrag">blank.ft</span>. 
+        The most important is the name of the contract <span class="codefrag ">&lt;forrest:contract name="blank"/&gt;</span>. 
+        This name is the same as the file name of the contract (without file extension) <span class="codefrag ">blank.ft</span>. 
       </p>
 <div class="note">
 <div class="label">Note</div>
@@ -522,7 +522,7 @@
       </div>
 </div>
 <p>
-        The <span class="codefrag">&lt;description/&gt;</span> tag needs to be filled in with some information
+        The <span class="codefrag ">&lt;description/&gt;</span> tag needs to be filled in with some information
         that is explaining the contract to the webdesigner. The better explained the more efficient
         for the webdesigner to pick the right contract.
       </p>
@@ -531,19 +531,19 @@
 &lt;/description&gt;
       </pre>
 <p>
-        In the <span class="codefrag">&lt;usage/&gt;</span> tag we have to explain how the designer can use 
+        In the <span class="codefrag ">&lt;usage/&gt;</span> tag we have to explain how the designer can use 
         the contract in his view.
       </p>
 <pre class="code">&lt;usage&gt;&lt;![CDATA[&lt;forrest:contract name="siteinfo-last-published-howto"/&gt;]]&gt;&lt;/usage&gt;
       </pre>
 <p>
         
-<span class="codefrag">&lt;forrest:template name="blank" body="false" head="false"&gt; </span> 
+<span class="codefrag ">&lt;forrest:template name="blank" body="false" head="false"&gt; </span> 
         That leads to the template attribute @body="true" and
 				@head="false". In xhtml a contract can add content to the &lt;body/&gt; or/and
 				&lt;head/&gt; part of &lt;html/&gt;. These values need to be changed when adding an actual template.
         Besides this, a xsl-template needs to indicate this in the naming. A template that adds content to the 
-        html body needs to end with "<span class="codefrag">-body</span>"!!!
+        html body needs to end with "<span class="codefrag ">-body</span>"!!!
       </p>
 <div class="note">
 <div class="label">Note</div>
@@ -575,7 +575,7 @@
 </div>
 <p> 
 				Now let us pick up the example we started with and create a "siteinfo-last-published-howto" contract.
-        Save the blank.ft to <span class="codefrag">{project.home}/src/documentation/resources/templates/siteinfo-last-published-howto.ft</span>.
+        Save the blank.ft to <span class="codefrag ">{project.home}/src/documentation/resources/templates/siteinfo-last-published-howto.ft</span>.
       </p>
 <p>
         Now the maintenance-optimized code (xpath="/html/body/*") was:
@@ -646,7 +646,7 @@
 <h3 class="underlined_5">Activating the contract</h3>
 <p>
         To see whether the new contract works we need to add it to our view.
-        The contract usage contains the contract-tag <span class="codefrag">&lt;forrest:contract name="siteinfo-last-published-howto"/&gt;</span>
+        The contract usage contains the contract-tag <span class="codefrag ">&lt;forrest:contract name="siteinfo-last-published-howto"/&gt;</span>
         Please see <a href="../../docs_0_80/howto/howto-view-dsl.html">Getting started with forrest:view DSL</a> for more details.
       </p>
 <div class="fixme">

Modified: forrest/site/docs_0_80/howto/howto-view-dsl.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-view-dsl.html?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-view-dsl.html (original)
+++ forrest/site/docs_0_80/howto/howto-view-dsl.html Mon Dec  5 20:55:03 2005
@@ -432,13 +432,13 @@
 </div>
 <p>
       We developed<strong> forrest:view</strong>  to let the user decide where to place elements in e.g. html pages.
-      We started this work with the <span class="codefrag">skinconf.xml</span> where you could configure certain elements and
+      We started this work with the <span class="codefrag ">skinconf.xml</span> where you could configure certain elements and
       their positions. These elements were known under certain names. It was up to the skin designer to support 
       this configuration and the elements.
     </p>
 <p>
      The work started with grouping elements (the ones from skinconf). We used css-contracts that 
-     we added as @attributes e.g. <span class="codefrag">&lt;div id="content-main"/&gt; </span>. That made it 
+     we added as @attributes e.g. <span class="codefrag ">&lt;div id="content-main"/&gt; </span>. That made it 
      possible to use the same elements in different skins. For the full list refer to the
       <a href="http://svn.apache.org/repos/asf/forrest/trunk/main/webapp/skins/leather-dev/contracts.initial.txt">
         initial contract list
@@ -454,8 +454,8 @@
      
 <strong>forrest:hook</strong>s are containers that are only used for layout reasons. They <strong>do not</strong> add 
      any content or functionality to the output. They add <strong>only</strong> layout information to 
-     the output. Actually a <span class="codefrag">&lt;forrest:hook name="layoutId"/&gt;</span> will be transformed
-     to <span class="codefrag">&lt;div id="layoutId"/&gt; </span>
+     the output. Actually a <span class="codefrag ">&lt;forrest:hook name="layoutId"/&gt;</span> will be transformed
+     to <span class="codefrag ">&lt;div id="layoutId"/&gt; </span>
     
 </p>
 <p>
@@ -484,17 +484,17 @@
 <p>
 				In this section we will create a new view. We will override the default view of the view-plugin
         for the index page of the <a href="../../docs_0_80/howto/howto-view-install.html">newSeed</a>.
-        For that we will create a file called <span class="codefrag">index.fv</span> and save it in our xdocs directory. 
+        For that we will create a file called <span class="codefrag ">index.fv</span> and save it in our xdocs directory. 
         This will make <strong>only</strong> the index.html page look different from the rest of the project.
 			</p>
 <p>
-        Remember: pointing your browser to <span class="codefrag">http://localhost:8888/ls.contracts.html</span> will
+        Remember: pointing your browser to <span class="codefrag ">http://localhost:8888/ls.contracts.html</span> will
         show a page with all contracts that you can use in your project.
       </p>
 <p>
         Let use the blank view from the earlier step and add the content-main contract. In 
         ls.contracts.html we find the information for how to use the contract in our view. Our 
-        <span class="codefrag">index.fv</span> should look like:
+        <span class="codefrag ">index.fv</span> should look like:
       </p>
 <pre class="code">&lt;forrest:views xmlns:forrest="http://apache.org/forrest/templates/1.0"&gt;
   &lt;forrest:view type="xhtml"&gt;
@@ -503,7 +503,7 @@
 &lt;/forrest:views&gt;
       </pre>
 <p>
-        Lets try our new view by pointing to <span class="codefrag">http://localhost:8888/index.html</span>. 
+        Lets try our new view by pointing to <span class="codefrag ">http://localhost:8888/index.html</span>. 
         We will see only the main content. Now let us add the section navigation to our view.
         The contract usage in the view can be looked up in ls.contracts.html. Our view now looks like:
       </p>
@@ -522,7 +522,7 @@
 <a name="N100D8"></a><a name="hookView"></a>
 <h3 class="underlined_5">Hooks in views</h3>
 <p>
-        We will use now the first time a <span class="codefrag">&lt;forrest:hook name="layoutId"/&gt;</span>.
+        We will use now the first time a <span class="codefrag ">&lt;forrest:hook name="layoutId"/&gt;</span>.
         Hooks are the styling side of views. We can imitate arbitrary html skeleton 
         with their help. Before we explain how to use your own css in views, we will use the default css.
         In the default.css we can find 
@@ -536,7 +536,7 @@
 }
       </pre>
 <p>
-        With this information we know to use <span class="codefrag">&lt;forrest:hook name="leftbar"/&gt;</span> 
+        With this information we know to use <span class="codefrag ">&lt;forrest:hook name="leftbar"/&gt;</span> 
         and add contracts into that container. 
       </p>
 <p>
@@ -564,10 +564,10 @@
 <p>
         We now know how to place contracts and hooks in our view. Until this stage we only used the default.css. 
         CSS-support of views is as easy as placing contracts/hooks. To override the default.css
-        stylesheet we use another tag within our view <span class="codefrag">&lt;forrest:css url="default.css"/&gt;</span>.
+        stylesheet we use another tag within our view <span class="codefrag ">&lt;forrest:css url="default.css"/&gt;</span>.
       </p>
 <p>
-        We will now create a file in <span class="codefrag">{project:skins-dir}{path}/{name}.css</span>. In our case
+        We will now create a file in <span class="codefrag ">{project:skins-dir}{path}/{name}.css</span>. In our case
         we will save a file called howTo.css in newSeed/src/documentation/skins/css/howTo.css containing only 
         the following css:
       </p>
@@ -582,14 +582,14 @@
 <p>
         We just changed the border-style to 'solid', the background to '#CCCCFF' and the color to '#000000'. 
         Now we have to add a new tag to tell that we want to override the default.css. We are doing this 
-        by adding the tag <span class="codefrag">&lt;forrest:css url="howTo.css"/&gt;</span> to our view.
+        by adding the tag <span class="codefrag ">&lt;forrest:css url="howTo.css"/&gt;</span> to our view.
       </p>
 <div class="note">
 <div class="label">Note</div>
 <div class="content">
         
-<span class="codefrag">&lt;forrest:css url="howTo.css"/&gt;</span> needs to be the direct child of 
-        <span class="codefrag">&lt;forrest:view type="xhtml"&gt;</span>
+<span class="codefrag ">&lt;forrest:css url="howTo.css"/&gt;</span> needs to be the direct child of 
+        <span class="codefrag ">&lt;forrest:view type="xhtml"&gt;</span>
       
 </div>
 </div>
@@ -606,7 +606,7 @@
 <p>
         Now you see a white page where the menu is surrounded by a solid border with the defined background.
          As a second example, let us change as well the content-main by adding another hook 
-         <span class="codefrag">&lt;forrest:hook name="content"/&gt;</span> We need to add the new layout container
+         <span class="codefrag ">&lt;forrest:hook name="content"/&gt;</span> We need to add the new layout container
          to our howTo.css:
       </p>
 <pre class="code">

Modified: forrest/site/docs_0_80/howto/howto-view-install.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-view-install.html?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-view-install.html (original)
+++ forrest/site/docs_0_80/howto/howto-view-install.html Mon Dec  5 20:55:03 2005
@@ -446,7 +446,7 @@
 ant local-deploy
       </pre>
 <p>
-        Alternatively, run the script <span class="codefrag">etc/views.sh</span>
+        Alternatively, run the script <span class="codefrag ">etc/views.sh</span>
       
 </p>
 <a name="N1005F"></a><a name="newSeed"></a>
@@ -488,13 +488,13 @@
 <pre class="code">
 forrest run
       </pre>
-<p>Then point to <span class="codefrag">http://localhost:8888/</span> and you will see the default
+<p>Then point to <span class="codefrag ">http://localhost:8888/</span> and you will see the default
         views-based site.</p>
 <a name="N10099"></a><a name="availableContracts"></a>
 <h3 class="underlined_5">Available contracts</h3>
 <p> 
 	     To start working with views, you need to know which contracts you can use. 
-	     For this we will install another plugin <span class="codefrag">org.apache.forrest.plugin.input.viewHelper.xhtml.ls</span>.
+	     For this we will install another plugin <span class="codefrag ">org.apache.forrest.plugin.input.viewHelper.xhtml.ls</span>.
 	     The setup is:
 	    </p>
 <pre class="code">
@@ -513,7 +513,7 @@
 project.required.plugins=org.apache.forrest.plugin.input.viewHelper.xhtml.ls
       </pre>
 <p>
-        Now point your browser to <span class="codefrag">http://localhost:8888/ls.contracts.html</span>. 
+        Now point your browser to <span class="codefrag ">http://localhost:8888/ls.contracts.html</span>. 
         On this page you will find all contracts that you can use in your project.
       </p>
 </div>

Modified: forrest/site/docs_0_80/libre-intro.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/libre-intro.html?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
--- forrest/site/docs_0_80/libre-intro.html (original)
+++ forrest/site/docs_0_80/libre-intro.html Mon Dec  5 20:55:03 2005
@@ -499,7 +499,7 @@
   &lt;/collection&gt;
 &lt;/collection&gt;</pre>
 <p>And it's not getting any harder in fact: only 2 elements,
-          <span class="codefrag">&lt;collection&gt;</span> and <span class="codefrag">&lt;item&gt;</span> and that should
+          <span class="codefrag ">&lt;collection&gt;</span> and <span class="codefrag ">&lt;item&gt;</span> and that should
           do. The first maps to a menu-group in the navigation, guess what the second
           maps to?</p>
 <p>The number and value (and its meaning) of the attributes on these
@@ -569,15 +569,15 @@
 <li>libre doesn't yet support external hrefs (should be easy
               though)</li> 
             
-<li>there is no difference between <span class="codefrag">&lt;menu&gt;</span> and
-              <span class="codefrag">&lt;menu-item&gt;</span>, there just is <span class="codefrag">&lt;entry&gt;</span>. It
-              will become a <span class="codefrag">&lt;collection&gt;</span> or <span class="codefrag">&lt;item&gt;</span> in
+<li>there is no difference between <span class="codefrag ">&lt;menu&gt;</span> and
+              <span class="codefrag ">&lt;menu-item&gt;</span>, there just is <span class="codefrag ">&lt;entry&gt;</span>. It
+              will become a <span class="codefrag ">&lt;collection&gt;</span> or <span class="codefrag ">&lt;item&gt;</span> in
               the output based on the fact if the location points to a directory resp. a
               file.</li> 
             
 <li>For locations that point to a filter it doesn't make sense, but
-              when it points to a directory it is nested <span class="codefrag">&lt;filter&gt;</span> and
-              <span class="codefrag">&lt;sort&gt;</span> elements get inherited down to the next level. </li> 
+              when it points to a directory it is nested <span class="codefrag ">&lt;filter&gt;</span> and
+              <span class="codefrag ">&lt;sort&gt;</span> elements get inherited down to the next level. </li> 
           
 </ul> 
           
@@ -591,18 +591,18 @@
 <pre class="code">&lt;auto&gt;</pre>
 <ul> 
             
-<li>Automatically generates more <span class="codefrag">&lt;collection&gt;</span>
-              and <span class="codefrag">&lt;item&gt;</span> elements in the output, based on the
-              specifications of the nested elements: <span class="codefrag">&lt;filter&gt;</span> (which
-              resources?) and <span class="codefrag">&lt;sort&gt;</span> (in which order?).</li> 
+<li>Automatically generates more <span class="codefrag ">&lt;collection&gt;</span>
+              and <span class="codefrag ">&lt;item&gt;</span> elements in the output, based on the
+              specifications of the nested elements: <span class="codefrag ">&lt;filter&gt;</span> (which
+              resources?) and <span class="codefrag ">&lt;sort&gt;</span> (in which order?).</li> 
           
 </ul>
 <pre class="code">&lt;filter logic="inverse" clear="no"&gt;</pre>
 <ul> 
             
 <li>This element wraps a so-called AttributeReader (there are
-              currently two of them: <span class="codefrag">&lt;xpath&gt;</span> and
-              <span class="codefrag">&lt;property&gt;</span>)</li> 
+              currently two of them: <span class="codefrag ">&lt;xpath&gt;</span> and
+              <span class="codefrag ">&lt;property&gt;</span>)</li> 
             
 <li>The AttributeReader is going to specify which
               information-element is going to be retrieved from the file or directory it is
@@ -615,7 +615,7 @@
               acceptance-logic (accept what normally should be rejected and vice versa).</li>
             
             
-<li>Using the <span class="codefrag">clear="yes"</span> attribute stops the
+<li>Using the <span class="codefrag ">clear="yes"</span> attribute stops the
               inheritance of the used filter strategy from the parent directory. Instead the
               default filter strategy (which is to accept all files) is slided in at this
               level.</li> 
@@ -625,20 +625,20 @@
 <ul> 
             
 <li>This element wraps a so called AttributeReader (there are
-              currently two of them: <span class="codefrag">&lt;xpath&gt;</span> and
-              <span class="codefrag">&lt;property&gt;</span>).</li> 
+              currently two of them: <span class="codefrag ">&lt;xpath&gt;</span> and
+              <span class="codefrag ">&lt;property&gt;</span>).</li> 
             
 <li>The AttributeReader is going to specify which
               information-element is going to be retrieved from the file or directory it is
               pointing at. This information element will be considered to be a simple
-              Key-String and <span class="codefrag">&lt;collection&gt;</span> and <span class="codefrag">&lt;item&gt;</span>
+              Key-String and <span class="codefrag ">&lt;collection&gt;</span> and <span class="codefrag ">&lt;item&gt;</span>
               elements in the output will appear in the order defined by the alphabetic
               sorting of these keys.</li> 
             
 <li>This wrapping sort element allows to reverse the order.
               (z-&gt;a instead of a-&gt;z)</li> 
             
-<li>Using the <span class="codefrag">clear="yes"</span> attribute stops the
+<li>Using the <span class="codefrag ">clear="yes"</span> attribute stops the
               inheritance of the used sort strategy from the parent directory. Instead the
               default sort strategy (which is to use default filesystem sorting, alphabetic
               on filename) is slided in at this level.</li> 
@@ -648,9 +648,9 @@
 <ul> 
             
 <li>The remainder of the elements inside the
-              <span class="codefrag">&lt;auto&gt;</span> tag specify the attributes that need to be applied to
-              the generated <span class="codefrag">&lt;collection&gt;</span> and <span class="codefrag">&lt;item&gt;</span>
-              elements in the output: <span class="codefrag">&lt;item label=".." href=".." YOURTAG=".."
+              <span class="codefrag ">&lt;auto&gt;</span> tag specify the attributes that need to be applied to
+              the generated <span class="codefrag ">&lt;collection&gt;</span> and <span class="codefrag ">&lt;item&gt;</span>
+              elements in the output: <span class="codefrag ">&lt;item label=".." href=".." YOURTAG=".."
               /&gt;</span>
 </li> 
             
@@ -671,39 +671,39 @@
 <ul> 
             
 <li>This element specifies an xpath AttributeReader to use inside
-              <span class="codefrag">&lt;filter&gt;</span>, <span class="codefrag">&lt;sort&gt;</span> or
+              <span class="codefrag ">&lt;filter&gt;</span>, <span class="codefrag ">&lt;sort&gt;</span> or
               {AttributeDefinitions}.</li> 
             
 <li>It allows to specify an xpath expression that should result in
               one single text node to be returned when applied to the root node of the xml
               file at the location of any given entry. The contents of this text-node is the
-              string value to sort (<span class="codefrag">&lt;sort&gt;</span> usage) or to fill in the
-              specified attribute (<span class="codefrag">&lt;label&gt;</span>, <span class="codefrag">&lt;href&gt;</span>...
-              use). When inside a <span class="codefrag">&lt;filter&gt;</span>: the presence of the node
+              string value to sort (<span class="codefrag ">&lt;sort&gt;</span> usage) or to fill in the
+              specified attribute (<span class="codefrag ">&lt;label&gt;</span>, <span class="codefrag ">&lt;href&gt;</span>...
+              use). When inside a <span class="codefrag ">&lt;filter&gt;</span>: the presence of the node
               results in passing the test.</li> 
           
 </ul>
 <div class="warning">
 <div class="label">Warning</div>
-<div class="content">This currently breaks for non xml (<span class="codefrag">*.gif</span>)
+<div class="content">This currently breaks for non xml (<span class="codefrag ">*.gif</span>)
             files, so get your filter right please, and in the mean time: sorry for not
-            being able to use it in the filter yet <span class="codefrag">:-(</span>.</div>
+            being able to use it in the filter yet <span class="codefrag ">:-(</span>.</div>
 </div>
 <pre class="code">&lt;property name="path" regex="(\.[\\/])*(.*)" substitute="$2"/&gt;
 &lt;property name="name"  mask="CVS"/&gt;</pre>
 <ul> 
             
 <li>This element specifies an xpath AttributeReader to use inside
-              <span class="codefrag">&lt;filter&gt;</span>, <span class="codefrag">&lt;sort&gt;</span> or
+              <span class="codefrag ">&lt;filter&gt;</span>, <span class="codefrag ">&lt;sort&gt;</span> or
               {AttributeDefinitions}.</li> 
             
 <li>It allows to specify a JavaBean-like property to read (this
               introspection behavior will probably not survive the future release) on the
               file at the 'location' of any given entry. The (object-)value of this property
               is automatically converted to a String (toString()) that becomes the value to
-              sort (<span class="codefrag">&lt;sort&gt;</span> usage) or to fill in the specified attribute
-              (<span class="codefrag">&lt;label&gt;</span>, <span class="codefrag">&lt;href&gt;</span>... use). When inside a
-              <span class="codefrag">&lt;filter&gt;</span>, the test passes if the read property is not null
+              sort (<span class="codefrag ">&lt;sort&gt;</span> usage) or to fill in the specified attribute
+              (<span class="codefrag ">&lt;label&gt;</span>, <span class="codefrag ">&lt;href&gt;</span>... use). When inside a
+              <span class="codefrag ">&lt;filter&gt;</span>, the test passes if the read property is not null
               or "".</li> 
             
 <li>Furthermore this element allows to express more elaborate
@@ -726,28 +726,28 @@
 <p>There are some things that libre is doing that you should be aware of.</p>
 <a name="N10175"></a><a name="No+libre.xml"></a>
 <h4>No libre.xml</h4>
-<p>When using an <span class="codefrag">&lt;auto&gt; </span>section, the filter will
-            NEVER accept the <span class="codefrag">libre.xml</span> file to be in the generated output. You
-            can however include a manual <span class="codefrag">&lt;entry&gt;</span> to point to the
-            <span class="codefrag">libre.xml</span> file if needed.</p>
+<p>When using an <span class="codefrag ">&lt;auto&gt; </span>section, the filter will
+            NEVER accept the <span class="codefrag ">libre.xml</span> file to be in the generated output. You
+            can however include a manual <span class="codefrag ">&lt;entry&gt;</span> to point to the
+            <span class="codefrag ">libre.xml</span> file if needed.</p>
 <a name="N1018B"></a><a name="No+Duplicates"></a>
 <h4>No Duplicates</h4>
-<p>You can combine multiple <span class="codefrag">&lt;entry&gt;</span> and
-            <span class="codefrag">&lt;auto&gt;</span> elements after each other. The system will make sure
-            that the resulting list of <span class="codefrag">&lt;collection&gt;</span> and
-            <span class="codefrag">&lt;item&gt;</span> will not contain duplicates. So the filters in
-            <span class="codefrag">&lt;auto&gt;</span> sections lower down the <span class="codefrag">libre.xml</span> file
+<p>You can combine multiple <span class="codefrag ">&lt;entry&gt;</span> and
+            <span class="codefrag ">&lt;auto&gt;</span> elements after each other. The system will make sure
+            that the resulting list of <span class="codefrag ">&lt;collection&gt;</span> and
+            <span class="codefrag ">&lt;item&gt;</span> will not contain duplicates. So the filters in
+            <span class="codefrag ">&lt;auto&gt;</span> sections lower down the <span class="codefrag ">libre.xml</span> file
             can include already accepted files or directories, they will only show up once
             in the output.</p>
 <a name="N101A8"></a><a name="Example+Constructs"></a>
 <h3 class="underlined_5">Example Constructs</h3>
 <p>Adding sorting and filtering to the filesystem with libre becomes a
           subtle play with editable filesystem properties, smart XML content and
-          <span class="codefrag">libre.xml</span> configs. This should be considered as the 'extended'
+          <span class="codefrag ">libre.xml</span> configs. This should be considered as the 'extended'
           contract between the following roles in the documentation system: the one
           choosing (or creating) the DTDs, the one applying those to create content and
           give the resulting files a name, the one that sets up the directories to store
-          those files and writes the <span class="codefrag">libre.xml</span> files.</p>
+          those files and writes the <span class="codefrag ">libre.xml</span> files.</p>
 <a name="N101B7"></a><a name="Sorting+your+files+or+your+menu+entries%3F"></a>
 <h4>Sorting your files or your menu entries?</h4>
 <p>In every case the very pragmatic approach can become something
@@ -778,14 +778,14 @@
 <ul> 
             
 <li>
-<span class="codefrag">&lt;filter&gt;</span>: only resources which name starts
+<span class="codefrag ">&lt;filter&gt;</span>: only resources which name starts
               with a 3-digit pattern</li> 
             
-<li>No <span class="codefrag">&lt;sort&gt;</span>: in their natural filesystem order
+<li>No <span class="codefrag ">&lt;sort&gt;</span>: in their natural filesystem order
               assured by the digit-prefix</li> 
             
 <li>
-<span class="codefrag">&lt;label&gt;</span>: hold a label attribute that strips
+<span class="codefrag ">&lt;label&gt;</span>: hold a label attribute that strips
               of the ugly number prefix</li> 
           
 </ul>
@@ -907,7 +907,7 @@
 <h4>Separating property-retrieval from formatting and
             testing</h4>
 <p>Playing around with the attributes in
-            <span class="codefrag">&lt;property&gt;</span>:</p>
+            <span class="codefrag ">&lt;property&gt;</span>:</p>
 <ul> 
             
 <li>poses hard to explain combinatory effects (@regex with
@@ -930,23 +930,23 @@
 &lt;/label&gt;</pre>
 <p>Allowing the formatter to be used around the xpath reader as well.
             And opening up the possibility to maybe format other stuff than Strings:
-            <span class="codefrag">&lt;dateformat format="dd/mmm/yy"&gt; </span>
+            <span class="codefrag ">&lt;dateformat format="dd/mmm/yy"&gt; </span>
 </p>
 <p>It would also clearly distinguish the semantical difference of
-            applying a test in the <span class="codefrag">&lt;filter&gt;</span> context:</p>
+            applying a test in the <span class="codefrag ">&lt;filter&gt;</span> context:</p>
 <pre class="code">&lt;filter&gt;
   &lt;regextest match="..."&gt;
     &lt;property ... /&gt;
   &lt;/regextest&gt;
 &lt;/filter&gt;</pre>
-<p>And more logically introduce other tests like <span class="codefrag">&lt;globtest
-            match="..."&gt;</span> or <span class="codefrag">&lt;availabletest&gt;</span> or...</p>
+<p>And more logically introduce other tests like <span class="codefrag ">&lt;globtest
+            match="..."&gt;</span> or <span class="codefrag ">&lt;availabletest&gt;</span> or...</p>
 <a name="N1028B"></a><a name="Replace+the+introspection+with+semantically+richer+named%0A++++++++++++properties+to+read."></a>
 <h4>Replace the introspection with semantically richer named
             properties to read.</h4>
-<p>Currently the <span class="codefrag">&lt;property
+<p>Currently the <span class="codefrag ">&lt;property
             name="someJavaBeanProp"&gt;</span> is applied in a java introspection for the
-            <span class="codefrag">getSomeJavaBeanProp()</span> on the <span class="codefrag">java.io.File</span> object that
+            <span class="codefrag ">getSomeJavaBeanProp()</span> on the <span class="codefrag ">java.io.File</span> object that
             is actually representing the node in the hierarchy at any given time. The DTD
             declares the attribute as of type CDATA. These decisions however:</p>
 <ul> 
@@ -954,7 +954,7 @@
 <li>lead to a lesser user guidance for the libre.xml writer using
               an XML (and DTD) savvy editor </li> 
             
-<li>leads to assuming the <span class="codefrag">libre.xml</span> editor has access
+<li>leads to assuming the <span class="codefrag ">libre.xml</span> editor has access
               to and knows how to interpret jdk javadoc</li> 
             
 <li>leads to poor semantical support and thus more possible RUNTIME
@@ -1013,9 +1013,9 @@
 <ul> 
           
 <li>do we need support for nested elements inside
-            <span class="codefrag">&lt;item&gt;</span> output (retrieved by e.g. xpath expressions)?</li> 
+            <span class="codefrag ">&lt;item&gt;</span> output (retrieved by e.g. xpath expressions)?</li> 
           
-<li>do we need an extra <span class="codefrag">&lt;constant&gt;</span> like
+<li>do we need an extra <span class="codefrag ">&lt;constant&gt;</span> like
             attributereader that would allow like book.xml to add fixed values for
             expressed attributes</li> 
           

Modified: forrest/site/docs_0_80/linking.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/linking.html?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
--- forrest/site/docs_0_80/linking.html (original)
+++ forrest/site/docs_0_80/linking.html Mon Dec  5 20:55:03 2005
@@ -408,7 +408,7 @@
 <div class="section">
 <p>
         This document describes Forrest's internal URI space; how it is managed
-        with the "<span class="codefrag">site.xml</span>" configuration file, how menus are generated,
+        with the "<span class="codefrag ">site.xml</span>" configuration file, how menus are generated,
         and how various link schemes (site: and ext:) operate.
         An overview of the implementation is also provided.
       </p>
@@ -419,9 +419,9 @@
 <h2 class="underlined_10">site.xml</h2>
 <div class="section">
 <p>
-        The "<span class="codefrag">site.xml</span>" configuration file is what we would call a "site map"
+        The "<span class="codefrag ">site.xml</span>" configuration file is what we would call a "site map"
         if Cocoon hadn't already claimed that term. 
-        The "<span class="codefrag">site.xml</span>" is a loosely structured XML file, acting as a map of the
+        The "<span class="codefrag ">site.xml</span>" is a loosely structured XML file, acting as a map of the
         site's contents.  It provides a unique identifier (an XPath address)
         for "nodes" of information in the website.  A "node" of site information
         can be:
@@ -434,17 +434,17 @@
 <li>A specific page, e.g. "the FAQ page"</li>
         
 <li>A specific section in a page, e.g. the "general" section of the FAQ
-          page (identified by <span class="codefrag">id="general"</span> attribute)</li>
+          page (identified by <span class="codefrag ">id="general"</span> attribute)</li>
       
 </ul>
 <p>
-        In addition to providing fine-grained addressing of site info, the <span class="codefrag">site.xml</span>
+        In addition to providing fine-grained addressing of site info, the <span class="codefrag ">site.xml</span>
         allows <em>metadata</em> to be associated with each node, using
-        attributes or child elements.  Most commonly, a <span class="codefrag">label</span>
+        attributes or child elements.  Most commonly, a <span class="codefrag ">label</span>
         attribute is used to provide a text description of the node.
       </p>
 <p>
-        There are currently two applications of <span class="codefrag">site.xml</span>
+        There are currently two applications of <span class="codefrag ">site.xml</span>
       
 </p>
 <dl>
@@ -454,21 +454,21 @@
 </dt>
         
 <dd>
-<span class="codefrag">site.xml</span> is used to generate the menus for the HTML website.</dd>
+<span class="codefrag ">site.xml</span> is used to generate the menus for the HTML website.</dd>
         
 <dt>
 <a href="#indirect-linking">Indirect linking</a>
 </dt>
         
 <dd>
-<span class="codefrag">site.xml</span> provides a basic aliasing mechanism for linking, e.g. one
+<span class="codefrag ">site.xml</span> provides a basic aliasing mechanism for linking, e.g. one
           can write &lt;link href="site:v0.80//changes"&gt; from anywhere in the site, and
           link to the "changes" information node (translated to changes.html).
           More on this below.</dd>
       
 </dl>
 <p>
-        Here is a sample <span class="codefrag">site.xml</span> ...
+        Here is a sample <span class="codefrag ">site.xml</span> ...
       </p>
 <pre class="code">
 &lt;?xml version="1.0"?&gt;
@@ -529,25 +529,25 @@
 <ul>
         
 <li>The root element must be "site", and normal content should be in the
-          namespace <span class="codefrag">http://apache.org/forrest/linkmap/1.0</span> (Feel
+          namespace <span class="codefrag ">http://apache.org/forrest/linkmap/1.0</span> (Feel
           free to mix in your own content (RDF, dublin core, etc) under new
           namespaces)</li>
         
-<li>Element names are used as identifiers.  The "<span class="codefrag">foo</span>" in
-          "<span class="codefrag">site:foo</span>" must therefore be a valid NMTOKEN.</li>
+<li>Element names are used as identifiers.  The "<span class="codefrag ">foo</span>" in
+          "<span class="codefrag ">site:foo</span>" must therefore be a valid NMTOKEN.</li>
         
-<li>Elements with <span class="codefrag">href</span> attributes can be used as identifiers
-          in "<span class="codefrag">site:</span>" URIs</li>
+<li>Elements with <span class="codefrag ">href</span> attributes can be used as identifiers
+          in "<span class="codefrag ">site:</span>" URIs</li>
         
 <li>Relative href attribute contents are "accumulated" by prepending hrefs
           from ancestor nodes</li>
         
-<li>Elements without <span class="codefrag">label</span> attributes (and their children)
+<li>Elements without <span class="codefrag ">label</span> attributes (and their children)
           are not displayed in the menu.</li>
         
-<li>Elements below <span class="codefrag">external-refs</span> are mapped to the
-          "<span class="codefrag">ext:</span>" scheme.  So "<span class="codefrag">ext:commons/resolver/</span>" becomes
-          "<span class="codefrag">http://xml.apache.org/commons/resolver/</span>"</li>
+<li>Elements below <span class="codefrag ">external-refs</span> are mapped to the
+          "<span class="codefrag ">ext:</span>" scheme.  So "<span class="codefrag ">ext:commons/resolver/</span>" becomes
+          "<span class="codefrag ">http://xml.apache.org/commons/resolver/</span>"</li>
       
 </ul>
 <p>
@@ -560,11 +560,11 @@
 <h2 class="underlined_10">Generating Menus</h2>
 <div class="section">
 <p>
-        Two files are used to define a site's tabs and menu (<span class="codefrag">site.xml</span> and
-        <span class="codefrag">tabs.xml</span>).  Both files are located in
-        <span class="codefrag">src/documentation/content/xdocs/</span>
+        Two files are used to define a site's tabs and menu (<span class="codefrag ">site.xml</span> and
+        <span class="codefrag ">tabs.xml</span>).  Both files are located in
+        <span class="codefrag ">src/documentation/content/xdocs/</span>
 </p>
-<p>Assume that our <span class="codefrag">tabs.xml</span> looks like this:</p>
+<p>Assume that our <span class="codefrag ">tabs.xml</span> looks like this:</p>
 <pre class="code">
 &lt;tabs ...&gt;
     &lt;tab id="home" label="Home" dir=""/&gt;
@@ -572,48 +572,48 @@
     &lt;tab id="howto" label="How-Tos" dir="community/howto"/&gt;
 &lt;/tabs&gt;
       </pre>
-<p>Using the "<span class="codefrag">site.xml</span>" listed above, we would get these menus:</p>
+<p>Using the "<span class="codefrag ">site.xml</span>" listed above, we would get these menus:</p>
 <p>
         
 <img alt="Menu generated from site.xml" src="images/menu.png">&nbsp;&nbsp;&nbsp;
         <img alt="Community menu generated from site.xml" src="images/menu2.png">&nbsp;&nbsp;&nbsp;
         <img alt="Howto menu generated from site.xml" src="images/menu3.png">
       </p>
-<p>When using the "<span class="codefrag">dir</span>" attribute as above the value of the
-      "<span class="codefrag">indexfile</span>" parameter is appended to the value of the 
-      "<span class="codefrag">dir</span>" attribute (together with a preceding '/'). For example,
+<p>When using the "<span class="codefrag ">dir</span>" attribute as above the value of the
+      "<span class="codefrag ">indexfile</span>" parameter is appended to the value of the 
+      "<span class="codefrag ">dir</span>" attribute (together with a preceding '/'). For example,
       the link for the community tab above is 
-      <span class="codefrag">community/mailLists.html</span>. Note that "<span class="codefrag">indexfile</span>"
-      defaults to "<span class="codefrag">index.html</span>" if no value is supplied. Therefore the
-      link for the howto tab is <span class="codefrag">community/howto/index.html</span>
+      <span class="codefrag ">community/mailLists.html</span>. Note that "<span class="codefrag ">indexfile</span>"
+      defaults to "<span class="codefrag ">index.html</span>" if no value is supplied. Therefore the
+      link for the howto tab is <span class="codefrag ">community/howto/index.html</span>
 </p>
 <a name="N100F0"></a><a name="tabs-external"></a>
 <h3 class="underlined_5">Tabs for External Resources</h3>
 <p>A tab can refer to an external resource by using the 
-        "<span class="codefrag">href</span>" attribute instead of the "<span class="codefrag">dir</span>" attribute.
-        The value of "<span class="codefrag">href</span>" should be the URI of the resource you wish 
+        "<span class="codefrag ">href</span>" attribute instead of the "<span class="codefrag ">dir</span>" attribute.
+        The value of "<span class="codefrag ">href</span>" should be the URI of the resource you wish 
         to link to. For example:</p>
 <pre class="code">
 &lt;tab id="apache" label="XML Apache" href="http://xml.apache.org/"/&gt;
         </pre>
-<p>Unlike the "<span class="codefrag">dir</span>" attribute, the value of "<span class="codefrag">href</span>"
+<p>Unlike the "<span class="codefrag ">dir</span>" attribute, the value of "<span class="codefrag ">href</span>"
         is left unmodified by Forrest unless it is root-relative and obviously 
         specifies a directory (ends in '/'). In which case /index.html will be 
         added.</p>
 <a name="N10110"></a><a name="selecting-entries"></a>
 <h3 class="underlined_5">Selecting menu entries</h3>
 <p>Forrest decides which menu entries to display, by examining the
-          "<span class="codefrag">tab</span>" attributes in the <span class="codefrag">site.xml</span> file. The children of 
-          all <span class="codefrag">site.xml</span> entries with a
-          "<span class="codefrag">tab</span>" which is equal to that of the current page, are
+          "<span class="codefrag ">tab</span>" attributes in the <span class="codefrag ">site.xml</span> file. The children of 
+          all <span class="codefrag ">site.xml</span> entries with a
+          "<span class="codefrag ">tab</span>" which is equal to that of the current page, are
           added to the menu, whilst the element itself forms the root of that
-          part of the menu (see the "<span class="codefrag">community</span>" element in the 
+          part of the menu (see the "<span class="codefrag ">community</span>" element in the 
           example below). Child elements that have a different 
-          "<span class="codefrag">tab</span>" attribute value will appear in the menu for their
+          "<span class="codefrag ">tab</span>" 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 "<span class="codefrag">howto-samples</span>" element
+          the appropriate name (see the "<span class="codefrag ">howto-samples</span>" element
           below).</p>
-<p>Consider our <span class="codefrag">site.xml</span> example:</p>
+<p>Consider our <span class="codefrag ">site.xml</span> example:</p>
 <pre class="code">
 &lt;site label="Forrest" href="" <strong>tab="home"</strong>
   xmlns="http://apache.org/forrest/linkmap/1.0"&gt;
@@ -638,25 +638,25 @@
         &lt;step1 label="Step 1" href="step1.html"/&gt;
       ...</pre>
 <p>
-          Every <span class="codefrag">site.xml</span> node can potentially have a "<span class="codefrag">tab</span>" attribute.  If
-          unspecified, nodes inherit the "<span class="codefrag">tab</span>" of their parent.  Thus
+          Every <span class="codefrag ">site.xml</span> node can potentially have a "<span class="codefrag ">tab</span>" attribute.  If
+          unspecified, nodes inherit the "<span class="codefrag ">tab</span>" of their parent.  Thus
           everything in the <strong>&lt;about&gt;</strong> section has an implicit
-          <span class="codefrag">tab="home" </span>attribute.</p>
+          <span class="codefrag ">tab="home" </span>attribute.</p>
 <div class="note">
 <div class="label">Note</div>
 <div class="content">You can see this by viewing your site's 
         <a href="../abs-menulinks">abs-menulinks</a> pipeline in a
           browser.</div>
 </div>
-<p>Say that the user is viewing the <span class="codefrag">linking.html</span>
+<p>Say that the user is viewing the <span class="codefrag ">linking.html</span>
           page.  The <strong>&lt;linking&gt;</strong> node has an implicit tab
-          value of "<span class="codefrag">home</span>".  Forrest will select <em>all nodes with
+          value of "<span class="codefrag ">home</span>".  Forrest will select <em>all nodes with
             tab="home"</em> and put them in the menu.
         </p>
 <a name="N1016A"></a><a name="other-menu-selection"></a>
 <h3 class="underlined_5">Alternative menu selection mechanisms.</h3>
 <p>
-          The "<span class="codefrag">tab</span>" attribute-based scheme for selecting a menu's
+          The "<span class="codefrag ">tab</span>" 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.
         </p>
@@ -675,11 +675,11 @@
           </p>
 <ul>
             
-<li>Edit <span class="codefrag">forrest.properties</span> and set
-              <span class="codefrag">project.menu-scheme=directories</span>
+<li>Edit <span class="codefrag ">forrest.properties</span> and set
+              <span class="codefrag ">project.menu-scheme=directories</span>
 </li>
             
-<li>Remove the "<span class="codefrag">id</span>" attributes from <span class="codefrag">tabs.xml</span>
+<li>Remove the "<span class="codefrag ">id</span>" attributes from <span class="codefrag ">tabs.xml</span>
               entries.</li>
           
 </ul>
@@ -687,19 +687,19 @@
 <h4>Specifying menus with book.xml</h4>
 <p>
             Historically, menus in Forrest have been generated from a
-            <span class="codefrag">book.xml</span> file, one per directory.  This mechanism is
-            still available, and if a <span class="codefrag">book.xml</span> is found, it will be
-            used in preference to the menu generated by the <span class="codefrag">site.xml</span> file. The <span class="codefrag">book.xml</span>
-            files can use "<span class="codefrag">site:</span>" URIs to ease the maintenance burden
+            <span class="codefrag ">book.xml</span> file, one per directory.  This mechanism is
+            still available, and if a <span class="codefrag ">book.xml</span> is found, it will be
+            used in preference to the menu generated by the <span class="codefrag ">site.xml</span> file. The <span class="codefrag ">book.xml</span>
+            files can use "<span class="codefrag ">site:</span>" URIs to ease the maintenance burden
             that led to obsolescence of book.xml files.  In general, however, we
-            recommend that users avoid <span class="codefrag">book.xml</span> files.
+            recommend that users avoid <span class="codefrag ">book.xml</span> files.
           </p>
 <a name="N101C3"></a><a name="tab-selection"></a>
 <h3 class="underlined_5">Selecting the current tab</h3>
 <p>
           The tab selection algorithm is quite simple: the tab with the
-          "<span class="codefrag">id</span>" which matches that of the current <span class="codefrag">site.xml</span>
-          node is "selected". However the interaction of <span class="codefrag">tabs.xml</span> and <span class="codefrag">site.xml</span>
+          "<span class="codefrag ">id</span>" which matches that of the current <span class="codefrag ">site.xml</span>
+          node is "selected". However the interaction of <span class="codefrag ">tabs.xml</span> and <span class="codefrag ">site.xml</span>
           while powerful, can be complex to establish.
         </p>
 <a name="N101D9"></a><a name="tab-site"></a>
@@ -720,8 +720,8 @@
           
 <li>
             The Forrest website also accompanies your software release
-            in the <span class="codefrag">site-author</span> directory, so
-            inspect its <span class="codefrag">tabs.xml</span> and <span class="codefrag">site.xml</span> to see how it is done. Also see the
+            in the <span class="codefrag ">site-author</span> directory, so
+            inspect its <span class="codefrag ">tabs.xml</span> and <span class="codefrag ">site.xml</span> to see how it is done. Also see the
             'forrest seed site' example. It is not as complex as the Forrest website.
           </li>
           
@@ -731,25 +731,25 @@
           
 <li>
             The value of the tab @id attribute cannot begin with a digit.
-            Likewise, element names in <span class="codefrag">tabs.xml</span> and <span class="codefrag">site.xml</span> cannot begin with a digit.
+            Likewise, element names in <span class="codefrag ">tabs.xml</span> and <span class="codefrag ">site.xml</span> cannot begin with a digit.
           </li>
           
 <li>
-            Add label attributes to <span class="codefrag">site.xml</span> elements to make the menus show.
-            With nested elements in <span class="codefrag">site.xml</span> if the outer element does not have a label
+            Add label attributes to <span class="codefrag ">site.xml</span> elements to make the menus show.
+            With nested elements in <span class="codefrag ">site.xml</span> if the outer element does not have a label
             attribute then the inner elements will not be displayed.
           </li>
           
 <li>
             To cause tabs and menu items to be highlighted, there need to be
-            corresponding elements in <span class="codefrag">site.xml</span> that have href attributes which match
+            corresponding elements in <span class="codefrag ">site.xml</span> that have href attributes which match
             the relevant path.
           </li>
           
 <li>
             When the tab points to a directory, then to make the tab highlighted
             when selected, you need an element which matches index.html within the
-            group of elements that define the menus for this tab in the <span class="codefrag">site.xml</span>
+            group of elements that define the menus for this tab in the <span class="codefrag ">site.xml</span>
             file. That element can be without a label attribute, so that it doesn't
             display as a menu item. However doing that causes that tab's menus
             to be collapsed.
@@ -758,7 +758,7 @@
 <li>
             Q: The tab link in my site assumes that 'index.html'
             is present in the linked-to directory. How do I fix this?
-            A: In <span class="codefrag">tabs.xml</span> use @href instead of @dir attribute and omit the trailing '/'.
+            A: In <span class="codefrag ">tabs.xml</span> use @href instead of @dir attribute and omit the trailing '/'.
             Which file to serve is then a concern of the sitemap.
             See more at the <a href="../docs_0_80/faq.html#tab-index">FAQ</a>.
           </li>
@@ -774,35 +774,35 @@
       is created from the titles of each section in your xdoc. By default only
       sections up to two levels deep are included and the table of contents is
       displayed at the top of the page. However, you can configure this
-      behaviour in <span class="codefrag">src/documentation/skinconf.xml</span> using the 
-      "<span class="codefrag">toc</span>" element.</p>
+      behaviour in <span class="codefrag ">src/documentation/skinconf.xml</span> using the 
+      "<span class="codefrag ">toc</span>" element.</p>
 <pre class="code">
 &lt;toc level="2" location="page"/&gt;
       </pre>
 <ul>
         
 <li>
-<strong><span class="codefrag">level</span></strong> - is the depth to which you
+<strong><span class="codefrag ">level</span></strong> - is the depth to which you
         want your table of contents to go. Setting it to "3" will therefore 
         include sections nested to 3 levels. Setting this to "0" will result in
         no table of contents being generated.</li>
         
 <li>
-<strong><span class="codefrag">location</span></strong> - indicates where you
+<strong><span class="codefrag ">location</span></strong> - indicates where you
         want the table of contents to be rendered. It can be set to one of
         three values:
           <ul>
             
 <li>
-<span class="codefrag">page</span> - the table of contents will be rendered
+<span class="codefrag ">page</span> - the table of contents will be rendered
             at the top of the body of your page</li>
             
 <li>
-<span class="codefrag">menu</span> - the table of contents will be rendered
+<span class="codefrag ">menu</span> - the table of contents will be rendered
             in the menu to the left of the body of the page</li>
             
 <li>
-<span class="codefrag">menu, page</span> - table of contents will be rendered
+<span class="codefrag ">menu, page</span> - table of contents will be rendered
             in both the page and the menu positions</li>
           
 </ul>
@@ -820,8 +820,8 @@
 <h3 class="underlined_5">Direct linking</h3>
 <p>
           In earlier versions of Forrest (and in similar systems), there has
-          been only one URI space: that of the generated site.  If <span class="codefrag">index.xml</span> wants to
-          link to <span class="codefrag">todo.xml</span> then <span class="codefrag">index.xml</span> would use
+          been only one URI space: that of the generated site.  If <span class="codefrag ">index.xml</span> wants to
+          link to <span class="codefrag ">todo.xml</span> then <span class="codefrag ">index.xml</span> would use
         </p>
 <pre class="code">
           &lt;a href="todo.html"&gt;to-do list&lt;a&gt;
@@ -852,8 +852,8 @@
           
 <dt>todo</dt>
           
-<dd>identifies the content in <span class="codefrag">todo.xml</span> by reference to a
-            "node" of content declared in <span class="codefrag">site.xml</span>
+<dd>identifies the content in <span class="codefrag ">todo.xml</span> by reference to a
+            "node" of content declared in <span class="codefrag ">site.xml</span>
 </dd>
         
 </dl>
@@ -866,13 +866,13 @@
 <a name="N102AC"></a><a name="resolve-site-uris"></a>
 <h4>Resolving site: URIs</h4>
 <p>
-            So how does "<span class="codefrag">site:v0.80//todo</span>" get resolved?  A full answer
+            So how does "<span class="codefrag ">site:v0.80//todo</span>" get resolved?  A full answer
             is provided in the <a href="#implementation">implementation</a>
-            section.  Essentially, the "<span class="codefrag">todo</span>" part has
-            "<span class="codefrag">/site//</span>" prepended, and "<span class="codefrag">/@href</span>" appended, to
-            form the string "<span class="codefrag">/site//todo/@href</span>".  This is
-            then used as an XPath expression in <span class="codefrag">site.xml</span> to identify the string
-            replacement, in this case "<span class="codefrag">todo.html</span>"
+            section.  Essentially, the "<span class="codefrag ">todo</span>" part has
+            "<span class="codefrag ">/site//</span>" prepended, and "<span class="codefrag ">/@href</span>" appended, to
+            form the string "<span class="codefrag ">/site//todo/@href</span>".  This is
+            then used as an XPath expression in <span class="codefrag ">site.xml</span> to identify the string
+            replacement, in this case "<span class="codefrag ">todo.html</span>"
           </p>
 <p>
             Thus by modifying the XPath prefix and suffix, almost any XML
@@ -882,33 +882,33 @@
 <div class="label">Note</div>
 <div class="content">
             Actually, the XPath is applied to XML generated dynamically from
-            <span class="codefrag">site.xml</span>.  The generated XML has each "@href" fully expanded ("absolutized")
+            <span class="codefrag ">site.xml</span>.  The generated XML has each "@href" fully expanded ("absolutized")
             and dot-dots (..) added as needed ("relativized").
           </div>
 </div>
 <p>
             Notice that the "//" allows us any degree of specificity when linking.
-            In the sample <span class="codefrag">site.xml</span> above, both "<span class="codefrag">site:v0.80//new_content_type</span>" and
-            "<span class="codefrag">site:about/your-project/new_content_type</span>" identify the
+            In the sample <span class="codefrag ">site.xml</span> above, both "<span class="codefrag ">site:v0.80//new_content_type</span>" and
+            "<span class="codefrag ">site:about/your-project/new_content_type</span>" identify the
             same node.  It is up to you to decide how specific to make links.  One
-            nice benefit of link "ambiguity" is that <span class="codefrag">site.xml</span> can be reorganized
+            nice benefit of link "ambiguity" is that <span class="codefrag ">site.xml</span> can be reorganized
             without breaking links.  For example, "new_content_type" currently
             identifies a node in "your-project".  By leaving that fact unspecified
-            in "<span class="codefrag">site:new_content_type</span>" we are free to make
+            in "<span class="codefrag ">site:new_content_type</span>" we are free to make
             "new_content_type" its own XML file, or a node in another file, in
             another category.
           </p>
 <a name="N102EA"></a><a name="resolve-ext-uris"></a>
 <h4>ext: URIs: linking to external URLs</h4>
 <p>
-            The "<span class="codefrag">ext:</span>" scheme was created partly to demonstrate the
+            The "<span class="codefrag ">ext:</span>" scheme was created partly to demonstrate the
             ease with which new schemes can be defined, and partly for practical
-            use. The "<span class="codefrag">ext:</span>" URIs identify nodes in <span class="codefrag">site.xml</span> below the
+            use. The "<span class="codefrag ">ext:</span>" URIs identify nodes in <span class="codefrag ">site.xml</span> below the
             &lt;external-refs&gt; node.  By convention, nodes here link to URLs
             outside the website, and are not listed in the menu generated from
-            the <span class="codefrag">site.xml</span> file.
+            the <span class="codefrag ">site.xml</span> file.
           </p>
-<p>Here is a <span class="codefrag">site.xml</span> snippet illustrating "<span class="codefrag">external-refs</span>":</p>
+<p>Here is a <span class="codefrag ">site.xml</span> snippet illustrating "<span class="codefrag ">external-refs</span>":</p>
 <pre class="code">
 &lt;site&gt;
   ...
@@ -925,34 +925,34 @@
 <p>
             As an example, &lt;a href="ext:commons/resolver"&gt;
             generates the link
-            <a href="http://xml.apache.org/commons/components/resolver/">http://xml.apache.org/components/resolver/</a>
+            <a href="http://xml.apache.org/commons/components/resolver/">http://xml.apache.org/commons/components/resolver/</a>
           
 </p>
 <p>
-            The general rules of <span class="codefrag">site.xml</span> and "<span class="codefrag">site:</span>" linking apply.
+            The general rules of <span class="codefrag ">site.xml</span> and "<span class="codefrag ">site:</span>" linking apply.
             Specifically, the "@href" aggregation makes defining large numbers of
             related URLs easy.
           </p>
 <a name="N1031D"></a><a name="source-uris"></a>
 <h4>Theory: source URIs</h4>
 <p>
-            The "<span class="codefrag">site:</span>" URIs like "<span class="codefrag">site:v0.80//todo</span>" are examples of
+            The "<span class="codefrag ">site:</span>" URIs like "<span class="codefrag ">site:v0.80//todo</span>" are examples of
             "<em>source</em>" URIs, in contrast to the more usual
-            <span class="codefrag">foo.html</span> style URIs, which we here call
+            <span class="codefrag ">foo.html</span> style URIs, which we here call
             "<em>destination</em>" URIs.  This introduces an important concept: that
             the "<em>source</em>" URI space exists and is independent of that of the
             generated site.  Furthermore, URIs (i.e. links) are first-class objects,
             on par with XML documents, in that just as XML content is transformed,
             so are the links.  Within the source URI space, we can have all sorts of
             interesting schemes (person: mail: google: java: etc). These will
-            all be translated into plain old "<span class="codefrag">http:</span>" or relative URIs
+            all be translated into plain old "<span class="codefrag ">http:</span>" or relative URIs
             in the destination URI space, just like exotic XML source formats are
             translated into plain old HTML in the output.
           </p>
 <a name="N1033C"></a><a name="future-schemes"></a>
 <h4>Future schemes</h4>
 <p>
-            So far, the "<span class="codefrag">site:</span>" and "<span class="codefrag">ext:</span>" schemes are defined.
+            So far, the "<span class="codefrag ">site:</span>" and "<span class="codefrag ">ext:</span>" schemes are defined.
             To give you some ideas on other things we'd like to implement (and
             wouldd welcome help to implement) here are a few possibilities.
           </p>
@@ -966,10 +966,10 @@
               
 <td colspan="1" rowspan="1">java</td>
               <td colspan="1" rowspan="1">java:org.apache.proj.SomeClass</td>
-              <td colspan="1" rowspan="1"><span class="codefrag">../../apidocs/org/apache/proj/SomeClass.html</span></td>
+              <td colspan="1" rowspan="1"><span class="codefrag ">../../apidocs/org/apache/proj/SomeClass.html</span></td>
               <td colspan="1" rowspan="1">
                 Links to documentation for a Java class (typically generated by
-                <span class="codefrag">javadoc</span>).
+                <span class="codefrag ">javadoc</span>).
               </td>
             
 </tr>
@@ -978,9 +978,9 @@
               
 <td colspan="1" rowspan="1">mail</td>
               <td colspan="1" rowspan="1">mail::&lt;Message-Id&gt;</td>
-              <td colspan="1" rowspan="1"><span class="codefrag">http://marc.theaimsgroup.com?t=12345678</span></td>
+              <td colspan="1" rowspan="1"><span class="codefrag ">http://marc.theaimsgroup.com?t=12345678</span></td>
               <td colspan="1" rowspan="1">
-                Links to an email, identified by its <span class="codefrag">Message-Id</span>
+                Links to an email, identified by its <span class="codefrag ">Message-Id</span>
                 header. Any mail archive website could be used.
               </td>
             
@@ -990,7 +990,7 @@
               
 <td colspan="1" rowspan="1">search</td>
               <td colspan="1" rowspan="1">search:&lt;searchterm&gt;</td>
-              <td colspan="1" rowspan="1"><span class="codefrag">http://www.google.com/search?q=searchterm</span></td>
+              <td colspan="1" rowspan="1"><span class="codefrag ">http://www.google.com/search?q=searchterm</span></td>
               <td colspan="1" rowspan="1">Link to set of results from a search engine</td>
             
 </tr>
@@ -999,10 +999,10 @@
               
 <td colspan="1" rowspan="1">person</td>
               <td colspan="1" rowspan="1">person:JT, person:JT/blog etc</td>
-              <td colspan="1" rowspan="1"><span class="codefrag">mailto:jefft&lt;at&gt;apache.org</span>,
-                <span class="codefrag">http://www.webweavertech.com/jefft/weblog/</span></td>
+              <td colspan="1" rowspan="1"><span class="codefrag ">mailto:jefft&lt;at&gt;apache.org</span>,
+                <span class="codefrag ">http://www.webweavertech.com/jefft/weblog/</span></td>
               <td colspan="1" rowspan="1">
-                A "<span class="codefrag">person:</span>" scheme could be used, say, to insert an
+                A "<span class="codefrag ">person:</span>" scheme could be used, say, to insert an
                 automatically obfuscated email address, or link to a URI in some
                 way associated with that person.
               </td>
@@ -1012,10 +1012,10 @@
 </table>
 <p>
             There are even more possibilities in specific environments.  In an
-            intranet, a "<span class="codefrag">project:XYZ</span>" scheme could identify company
+            intranet, a "<span class="codefrag ">project:XYZ</span>" scheme could identify company
             project pages.  In a project like <a href="http://ant.apache.org/">Apache
               Ant</a>, each Task could be identified with
-            <span class="codefrag">task:&lt;taskname&gt;</span>, e.g. <span class="codefrag">task:pathconvert</span>.
+            <span class="codefrag ">task:&lt;taskname&gt;</span>, e.g. <span class="codefrag ">task:pathconvert</span>.
           </p>
 </div>
     
@@ -1023,13 +1023,13 @@
 <h2 class="underlined_10">Concept</h2>
 <div class="section">
 <p>
-        The "<span class="codefrag">site:</span>" scheme and associated ideas for <span class="codefrag">site.xml</span> were
+        The "<span class="codefrag ">site:</span>" scheme and associated ideas for <span class="codefrag ">site.xml</span> were
         originally described in <a href="http://marc.theaimsgroup.com/?l=forrest-dev&m=103444028129281&w=2">the 'linkmap' RT
           email</a> to the forrest-dev list (RT means 'random thought'; a
         Cocoon invention).   Only section 2 has been implemented, and there is
         still significant work required to implement the full system
         described.  In particular, there is much scope for automating the
-        creation of <span class="codefrag">site.xml</span> (section 4).  However, what is currently implemented
+        creation of <span class="codefrag ">site.xml</span> (section 4).  However, what is currently implemented
         gains most of the advantages of the system.
       </p>
 </div>

Modified: forrest/site/docs_0_80/linking.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/linking.pdf?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
Binary files - no diff available.

Modified: forrest/site/docs_0_80/locationmap.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/locationmap.html?rev=354312&r1=354311&r2=354312&view=diff
==============================================================================
--- forrest/site/docs_0_80/locationmap.html (original)
+++ forrest/site/docs_0_80/locationmap.html Mon Dec  5 20:55:03 2005
@@ -376,7 +376,7 @@
 </ul>
 <p>In other words, the locationmap enables content to be retrieved from a location
         that is defined in a locationmap file (located at 
-        <span class="codefrag">PROJECT_HOME/src/documentation/content/locationmap.xml</span> file. The
+        <span class="codefrag ">PROJECT_HOME/src/documentation/content/locationmap.xml</span> file. The
         advantage of this is that the URL seen by the user need bear no relation to the location
         of the source document, thus Forrest can separate the client URL space from the source
         document URL space. Thus, using the locationmap it is possible to pull together
@@ -388,7 +388,7 @@
       the locationmap however the leaf does not identify a pipeline, but instead identifies
       a location string.</p>
 <p>Apache Forrest looks in the standard location for the source file first (by default
-      <span class="codefrag">PROJECT_HOME/src/documentation/content/...</span>), if a file is found in this
+      <span class="codefrag ">PROJECT_HOME/src/documentation/content/...</span>), if a file is found in this
       location then the locationmap is not consulted. However, if one is not found then the 
       locationmap is used to resolve the source file. The locationmap is resolved via the
       core sitemap, this means that you can generate it dynamically if you so wish. Simply
@@ -470,7 +470,7 @@
 <div class="section">
 <a name="N1008A"></a><a name="source-via-http"></a>
 <h3 class="underlined_5">Retrieving an XDoc via HTTP</h3>
-<p>Normally files are generated from <span class="codefrag">{project:content.xdocs}</span>.
+<p>Normally files are generated from <span class="codefrag ">{project:content.xdocs}</span>.
         Using the Locationmap it is possible to make these files come from elsewhere.
         This is useful if you want to pull files from different directory structures,
         or even remote repositories. For example, the following location match 
@@ -485,12 +485,12 @@
         </pre>
 <p>Note that because this is a wildcard matcher you can request any page
         from the svn server simply by requesting 
-        <span class="codefrag">/remoteDemo/PATH/TO/FILE/FILENAME.html</span>. In addition, we
+        <span class="codefrag ">/remoteDemo/PATH/TO/FILE/FILENAME.html</span>. In addition, we
         can request any other output format available via Forrest plugins.</p>
 <p>When including resources from remote repositories one has to
-        be careful about things like <span class="codefrag">site</span> and <span class="codefrag">ext</span>
+        be careful about things like <span class="codefrag ">site</span> and <span class="codefrag ">ext</span>
         linking. If the targets are not defined in the local 
-        <span class="codefrag">site.xml</span> file then these links will be broken.</p>
+        <span class="codefrag ">site.xml</span> file then these links will be broken.</p>
 <div class="warning">
 <div class="label">Warning</div>
 <div class="content">Because of the above limitation many of the links in the
@@ -506,8 +506,8 @@
         on open standards such as XML and XSLT and the Apache Software Stack, in particular the XML publishing 
         framework Apache Cocoon.</p>
 <p>The following locationmap matcher will instruct Forrest to retrieve content from
-        <span class="codefrag">http://lenya.zones.apache.org:8888/default/live/*.html?raw=true</span>, whenever a local URL of
-        <span class="codefrag">lenya/**</span> is encountered.</p>
+        <span class="codefrag ">http://lenya.zones.apache.org:8888/default/live/*.html?raw=true</span>, whenever a local URL of
+        <span class="codefrag ">lenya/**</span> is encountered.</p>
 <pre class="code">
  &lt;match pattern="lenya/**.xml"&gt;
    &lt;location src="http://lenya.zones.apache.org:8888/default/live/{1}.html?raw=true" /&gt;
@@ -515,7 +515,7 @@
         </pre>
 <p>However, since the source returned by this match is HTML and not XDoc we must convert this
         to our internal XDoc format before we can use it. We do this by adding the match below to our 
-        project's <span class="codefrag">sitemap.xmap</span> file.</p>
+        project's <span class="codefrag ">sitemap.xmap</span> file.</p>
 <pre class="code">
 &lt;map:match pattern="lenya/**.xml"&gt;
   &lt;map:generate type="html" src="{lm:{0}}" /&gt;
@@ -536,7 +536,7 @@
 &lt;/map:components&gt;
         </pre>
 <p>Since the HTML generator uses JTidy we need to make available a JTidy configuration file.
-        This is placed in <span class="codefrag">PROJECT_HOME/src/documentation/WEB-INF/jtidy.properties</span> (the
+        This is placed in <span class="codefrag ">PROJECT_HOME/src/documentation/WEB-INF/jtidy.properties</span> (the
         location can be changed in the above sitemap snippet). A sample config file is given below:</p>
 <pre class="code">
 indent=yes
@@ -575,8 +575,8 @@
    &lt;location src="http://www.domain.org/{1}.xml" /&gt;
  &lt;/match&gt;
         </pre>
-<p>With the above match in the locationmap, a link which has <span class="codefrag">href="lm:rewriteDemo/index"</span>
-        will be rewritten to an offsite address at <span class="codefrag">domain.org</span>
+<p>With the above match in the locationmap, a link which has <span class="codefrag ">href="lm:rewriteDemo/index"</span>
+        will be rewritten to an offsite address at <span class="codefrag ">domain.org</span>
 </p>
 </div>
   



Mime
View raw message