forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r357603 [2/11] - 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/ plugi...
Date Mon, 19 Dec 2005 01:33:15 GMT
Modified: forrest/site/docs_0_60/howto/howto-pdf-tab.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/howto/howto-pdf-tab.html?rev=357603&r1=357602&r2=357603&view=diff
==============================================================================
--- forrest/site/docs_0_60/howto/howto-pdf-tab.html (original)
+++ forrest/site/docs_0_60/howto/howto-pdf-tab.html Sun Dec 18 17:31:25 2005
@@ -351,16 +351,16 @@
 <h2 class="underlined_10">Steps</h2>
 <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> based on the <span class="codefrag ">aggregate.xmap</span>
+      <span class="codefrag">sitemap.xmap</span> and create a new
+      <span class="codefrag">pdf-tab.xmap</span> based on the <span class="codefrag">aggregate.xmap</span>
     
 </p>
 <a name="N10040"></a><a name="sitemap"></a>
 <h3 class="underlined_5">Create your project's main sitemap.xmap</h3>
 <p>
       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
+      <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="N10050"></a><a name="aggregator"></a>
@@ -378,7 +378,7 @@
     </div>
 </div>
 <p>
-      Edit the project <span class="codefrag ">sitemap.xmap</span> to comment-out the match
+      Edit the project <span class="codefrag">sitemap.xmap</span> to comment-out the match
       for the sitemap like this:
     </p>
 <pre class="code">
@@ -396,7 +396,7 @@
 <h3 class="underlined_5">Edit project sitemap.xmap to mount pdf-tab.xmap</h3>
 <p>
       Insert the following lines after the
-      <span class="codefrag ">&lt;map:match pattern="site.xml"&gt;</span>
+      <span class="codefrag">&lt;map:match pattern="site.xml"&gt;</span>
       pipeline in the section called "SOURCE FORMATS".
     </p>
 <pre class="code">
@@ -409,7 +409,7 @@
 <a name="N1007F"></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
+      The <span class="codefrag">&lt;map:match pattern="*.xml"&gt;</span> element
       should look like the following:
     </p>
 <pre class="code">
@@ -433,7 +433,7 @@
 <a name="N10092"></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
+      <span class="codefrag">&lt;about&gt;</span> element
     </p>
 <pre class="code">... 
 &lt;whole_foosite href="pdf-tab.html" label="sub site" /&gt;
@@ -453,11 +453,11 @@
     </pre>
 <p>
       This allows you to link to it via a
-      <span class="codefrag ">&lt;link href="site:v0.60//whole_foosite"&gt;</span>
+      <span class="codefrag">&lt;link href="site:v0.60//whole_foosite"&gt;</span>
       reference. 
     </p>
 <p>Add to every element that should be included in the pdf-tab.pdf
-      the attribute <span class="codefrag ">wholesite="true"</span>
+      the attribute <span class="codefrag">wholesite="true"</span>
 </p>
 <pre class="code">
 &lt;sample-wiki label="Wiki page" href="wiki-sample.html"
@@ -467,8 +467,8 @@
 <div class="label">Note</div>
 <div class="content">This attribute will be inherited by all children of the element. 
 	 Do not use it in the parent element that contains the 
-	 <span class="codefrag ">&lt;whole_foosite href="pdf-tab.html" label="pdf-tab" /&gt;</span> 
-	 as the child (will cause a <span class="codefrag ">stack overflow</span> if you do)!!!
+	 <span class="codefrag">&lt;whole_foosite href="pdf-tab.html" label="pdf-tab" /&gt;</span> 
+	 as the child (will cause a <span class="codefrag">stack overflow</span> if you do)!!!
 	</div>
 </div>
 <a name="N100C2"></a><a name="explain"></a>
@@ -477,9 +477,9 @@
       Line 4 of our example
       <br>
       
-<span class="codefrag ">&lt;map:parameter name="include" value="//*[@wholesite='true']"/&gt;</span>
+<span class="codefrag">&lt;map:parameter name="include" value="//*[@wholesite='true']"/&gt;</span>
       looks at your site.xml and will match every element containing the
-      <span class="codefrag ">wholesite="true"</span> attribute. For example, to use the "samples"
+      <span class="codefrag">wholesite="true"</span> attribute. For example, to use the "samples"
       tab ...
     </p>
 <pre class="code">
@@ -491,8 +491,8 @@
     </pre>
 <p>
       It matches <strong>all</strong> of the elements that contain
-      <span class="codefrag ">wholesite="true"</span>
-      (in our example <span class="codefrag ">&lt;samples&gt;</span>
+      <span class="codefrag">wholesite="true"</span>
+      (in our example <span class="codefrag">&lt;samples&gt;</span>
       and its "children") for the content of the pdf file to be generated.
     </p>
 <pre class="code"> 
@@ -507,33 +507,33 @@
     </pre>
 <p>
       This example shows that you can as well exclude site(s) from the aggregation 
-      by using the <span class="codefrag ">wholesite="false"</span> attribute. This attribute will be as well inherited 
+      by using the <span class="codefrag">wholesite="false"</span> attribute. This attribute will be as well inherited 
       by all children of the element.
     </p>
 <p>
       Line 8 defines the title of the pdf file by taking the content
       of the project-name variable in
-      <span class="codefrag ">skinconf.xml</span> and adding some funny text:
+      <span class="codefrag">skinconf.xml</span> and adding some funny text:
       <br>
       
-<span class="codefrag ">&lt;map:parameter name="title" value="{conf:project-name}: Still My Foo Site"/&gt;</span>
+<span class="codefrag">&lt;map:parameter name="title" value="{conf:project-name}: Still My Foo Site"/&gt;</span>
     
 </p>
 <div class="note">
 <div class="label">Note</div>
 <div class="content">
-      In the original <span class="codefrag ">aggregate.xmap</span> there is the line
+      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>
+<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>).
+      (<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).
+      <span class="codefrag">aggregate.xmap</span> usually does).
     </div>
 </div>
 </div>

Modified: forrest/site/docs_0_60/linking.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/linking.html?rev=357603&r1=357602&r2=357603&view=diff
==============================================================================
--- forrest/site/docs_0_60/linking.html (original)
+++ forrest/site/docs_0_60/linking.html Sun Dec 18 17:31:25 2005
@@ -348,7 +348,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>
@@ -359,9 +359,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:
@@ -374,17 +374,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>
@@ -394,21 +394,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="#semantic_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.60//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> ... a modified version from Forrest's
+        Here is a sample <span class="codefrag">site.xml</span> ... a modified version from Forrest's
         own <a href="http://forrest.apache.org/">website</a>:
       </p>
 <pre class="code">
@@ -470,25 +470,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>
 </div>
@@ -498,11 +498,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;
@@ -510,48 +510,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="N100ED"></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="N1010D"></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;
@@ -576,25 +576,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="N10167"></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>
@@ -613,11 +613,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>
@@ -625,21 +625,21 @@
 <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="N101C0"></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>
+          "<span class="codefrag">id</span>" which matches that of the current <span class="codefrag">site.xml</span>
           node is "selected". If you experience any problems, try to add a 
-          <span class="codefrag ">&lt;foo label="Foo" href="index.html"/&gt;</span> to the
-          <span class="codefrag ">site.xml</span> configuration.
+          <span class="codefrag">&lt;foo label="Foo" href="index.html"/&gt;</span> to the
+          <span class="codefrag">site.xml</span> configuration.
         </p>
 </div>
 
@@ -651,35 +651,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>
@@ -697,8 +697,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;link href="todo.html"&gt;to-do list&lt;link&gt;
@@ -729,8 +729,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>
@@ -743,13 +743,13 @@
 <a name="N1025E"></a><a name="resolve-site-uris"></a>
 <h4>Resolving site: URIs</h4>
 <p>
-            So how does "<span class="codefrag ">site:todo</span>" get resolved?  A full answer
+            So how does "<span class="codefrag">site: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
@@ -759,33 +759,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: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: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="N1029C"></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;
   ...
@@ -806,30 +806,30 @@
           
 </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="N102CF"></a><a name="source-uris"></a>
 <h4>Theory: source URIs</h4>
 <p>
-            The "<span class="codefrag ">site:</span>" URIs like "<span class="codefrag ">site:todo</span>" are examples of
+            The "<span class="codefrag">site:</span>" URIs like "<span class="codefrag">site: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="N102EE"></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>
@@ -843,10 +843,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>
@@ -855,9 +855,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>
             
@@ -867,7 +867,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>
@@ -876,10 +876,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>
@@ -889,10 +889,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>
     
@@ -900,13 +900,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_60/project-sitemap.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/project-sitemap.html?rev=357603&r1=357602&r2=357603&view=diff
==============================================================================
--- forrest/site/docs_0_60/project-sitemap.html (original)
+++ forrest/site/docs_0_60/project-sitemap.html Sun Dec 18 17:31:25 2005
@@ -318,7 +318,7 @@
 <a name="N10029"></a><a name="how"></a>
 <h2 class="underlined_10">How does it work?</h2>
 <div class="section">
-<p>If a project has a <span class="codefrag ">sitemap.xmap</span> file in it's 
+<p>If a project has a <span class="codefrag">sitemap.xmap</span> file in it's 
       documentation dir, that gets mounted automatically by Forrest and 
       becomes part of the processing: it is a preprocessing step, and 
       is the first one to handle the request. Because of this it can 

Modified: forrest/site/docs_0_60/searching.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/searching.html?rev=357603&r1=357602&r2=357603&view=diff
==============================================================================
--- forrest/site/docs_0_60/searching.html (original)
+++ forrest/site/docs_0_60/searching.html Sun Dec 18 17:31:25 2005
@@ -312,15 +312,15 @@
 	functionality is implemented on Google's end, you do not need
 	any additional capability on your Forrest server (which may
 	well be a simple static web server serving content generated
-	with <span class="codefrag ">forrest site</span>).</p>
+	with <span class="codefrag">forrest site</span>).</p>
 <p>To use Google SiteSearch in your Forrest application, open
-	your <span class="codefrag ">skinconf.xml</span> file. By default this file is
-	in the <span class="codefrag ">src/documentation</span> subdirectory of your
-	Forrest repository root. Find the <span class="codefrag ">&lt;search&gt;</span>
+	your <span class="codefrag">skinconf.xml</span> file. By default this file is
+	in the <span class="codefrag">src/documentation</span> subdirectory of your
+	Forrest repository root. Find the <span class="codefrag">&lt;search&gt;</span>
 	element; it should be near the top of the file. If the element
 	does not exist, create it below the
-	<span class="codefrag ">&lt;skinconfig&gt;</span> opening tag. If there is any
-	attribute named <span class="codefrag ">provider</span>, remove it. The element
+	<span class="codefrag">&lt;skinconfig&gt;</span> opening tag. If there is any
+	attribute named <span class="codefrag">provider</span>, remove it. The element
 	should look similar to this:</p>
 <pre class="code">&lt;search name="MyProject"
 	domain="myproject.com"/&gt;</pre>
@@ -345,26 +345,26 @@
 	entirely in Java. To use Lucene-based search with your Forrest
 	documentation, you will need to run Forrest in a Java servlet
 	environment (such as Tomcat or Jetty). Lucene-based searching
-	will not work in a static site generated with the '<span class="codefrag ">forrest
+	will not work in a static site generated with the '<span class="codefrag">forrest
 	  site</span>' command.</p>
 <p>In order to enable Lucene-based full-text search in your
 	Forrest application, you must first edit your
-	<span class="codefrag ">skinconf.xml</span> file. Locate the
-	<span class="codefrag ">&lt;search&gt;</span> element. If the element does not
+	<span class="codefrag">skinconf.xml</span> file. Locate the
+	<span class="codefrag">&lt;search&gt;</span> element. If the element does not
 	exist, insert it right underneath the
-	<span class="codefrag ">&lt;skinconfig&gt;</span> opening tag. Add an attribute
-	named <span class="codefrag ">provider</span> with a value of
-	<span class="codefrag ">lucene</span>, so that the element looks similar to
+	<span class="codefrag">&lt;skinconfig&gt;</span> opening tag. Add an attribute
+	named <span class="codefrag">provider</span> with a value of
+	<span class="codefrag">lucene</span>, so that the element looks similar to
 	this:</p>
 <pre class="code">&lt;search name="MyProject" domain="myproject.com"
 	provider="lucene"/&gt;</pre>
 <p>Next, create and run your Forrest webapp. This may mean
-	simply invoking <span class="codefrag ">forrest run</span>, or building and
-	bundling a servlet webapp (with <span class="codefrag ">forrest webapp</span>),
+	simply invoking <span class="codefrag">forrest run</span>, or building and
+	bundling a servlet webapp (with <span class="codefrag">forrest webapp</span>),
 	and then deploying it to your servlet container.</p>
 <p>You can now build a Lucene search index by pointing your web
 	browser at
-	<span class="codefrag ">http://localhost:8888/lucene-update.html</span>. This
+	<span class="codefrag">http://localhost:8888/lucene-update.html</span>. This
 	generates the search index and provides some information about
 	the index generation process.</p>
 <div class="note">
@@ -372,7 +372,7 @@
 <div class="content">You may have to substitute a different hostname, port, or
 	path, depending on your configuration. The path mentioned here
 	reflects Forrest's default settings when invoked as
-	<span class="codefrag ">forrest run</span>.</div>
+	<span class="codefrag">forrest run</span>.</div>
 </div>
 <p>Now you can utilize the full-text search box, located in the
 	top-right corner of the rendered Forrest pages. Search results
@@ -399,8 +399,8 @@
 	usable servlet-capable web server at your disposal (meaning
 	you can't use Lucene, either).</p>
 <p>To disable full-text search completely, open the
-	<span class="codefrag ">skinconf.xml</span> file and remove (or comment out) the
-	entire <span class="codefrag ">&lt;search&gt;</span> element.</p>
+	<span class="codefrag">skinconf.xml</span> file and remove (or comment out) the
+	entire <span class="codefrag">&lt;search&gt;</span> element.</p>
 </div>
   
 </div>

Modified: forrest/site/docs_0_60/sitemap-ref.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/sitemap-ref.html?rev=357603&r1=357602&r2=357603&view=diff
==============================================================================
--- forrest/site/docs_0_60/sitemap-ref.html (original)
+++ forrest/site/docs_0_60/sitemap-ref.html Sun Dec 18 17:31:25 2005
@@ -386,18 +386,18 @@
       </p>
 <p>
         You can add pre-processing sitemaps to your project
-        <span class="codefrag ">src/documentation</span> directory (or wherever
-        <span class="codefrag ">${project.sitemap-dir}</span> points to). Any match that
+        <span class="codefrag">src/documentation</span> directory (or wherever
+        <span class="codefrag">${project.sitemap-dir}</span> points to). Any match that
         is not handled, passes through to be handled by the default Forrest
         sitemaps - obviously extremely powerful. The capability is described
         in 
         "<a href="../docs_0_60/project-sitemap.html">Using project sitemaps</a>".
       </p>
 <p>
-        Another way to experiment with the sitemap is to do '<span class="codefrag ">forrest
+        Another way to experiment with the sitemap is to do '<span class="codefrag">forrest
         run</span>' on a Forrest-using site.  Changes to the core
-        <span class="codefrag ">*.xmap</span> files will now be immediately visible
-        at <span class="codefrag ">&gt;http://localhost:8888/</span>
+        <span class="codefrag">*.xmap</span> files will now be immediately visible
+        at <span class="codefrag">&gt;http://localhost:8888/</span>
       
 </p>
 </div>
@@ -462,7 +462,7 @@
 <tr>
           
 <th colspan="1" rowspan="1">raw.xmap</th>
-          <td colspan="1" rowspan="1">Serves files located in <span class="codefrag ">src/documentation/content/</span>
+          <td colspan="1" rowspan="1">Serves files located in <span class="codefrag">src/documentation/content/</span>
             that are not to be modified by Forrest.</td>
         
 </tr>
@@ -487,7 +487,7 @@
 <th colspan="1" rowspan="1">status.xmap</th>
           <td colspan="1" rowspan="1">Generates <a href="../docs_0_60/changes.html">changes</a> and 
           <a href="../docs_0_60/todo.html">todo</a> pages from a single
-            <span class="codefrag ">status.xml</span> in the project root.
+            <span class="codefrag">status.xml</span> in the project root.
           </td>
         
 </tr>
@@ -559,13 +559,13 @@
         format.
       </p>
 <p>
-        Source pipelines always have a "<span class="codefrag ">.xml</span>" extension.  Thus, 
+        Source pipelines always have a "<span class="codefrag">.xml</span>" extension.  Thus, 
         <a href="../index.xml">index.xml</a> gives you the XML source for the
         index page.  Likewise, <a href="../docs_0_60/faq.html">faq.xml</a> gives you XML
         for the FAQ (transformed from FAQ syntax), and 
         <a href="../changes.xml">changes.xml</a> returns XML from the status.xml file.
-        Take any page, and replace its extension (<span class="codefrag ">.html</span> or
-        <span class="codefrag ">.pdf</span>) with <span class="codefrag ">.xml</span> and you'll have the Source
+        Take any page, and replace its extension (<span class="codefrag">.html</span> or
+        <span class="codefrag">.pdf</span>) with <span class="codefrag">.xml</span> and you'll have the Source
         XML.
       </p>
 <p>
@@ -590,8 +590,8 @@
 <h3 class="underlined_5">forrest.xmap</h3>
 <p>
           Most of the usual Source pipelines are defined in
-          <span class="codefrag ">forrest.xmap</span> which is the default (fallback) handler for
-          <span class="codefrag ">**.xml</span> pages. The forrest.xmap uses the 
+          <span class="codefrag">forrest.xmap</span> which is the default (fallback) handler for
+          <span class="codefrag">**.xml</span> pages. The forrest.xmap uses the 
           <a href="../docs_0_60/cap.html">SourceTypeAction</a> to determine the type of XML
           it is processing, and converts it to document-v13 if necessary.
         </p>
@@ -611,8 +611,8 @@
 <a name="N10175"></a><a name="other_source"></a>
 <h3 class="underlined_5">Other source pipelines</h3>
 <p>As mentioned above, all non-core Source pipelines are distributed in
-          independent <span class="codefrag ">*.xmap</span> files.  There is a block of
-          <span class="codefrag ">sitemap.xmap</span> which simply delegates certain requests to
+          independent <span class="codefrag">*.xmap</span> files.  There is a block of
+          <span class="codefrag">sitemap.xmap</span> which simply delegates certain requests to
           these subsitemaps:</p>
 <pre class="code">
       &lt;!-- Body content --&gt;
@@ -649,14 +649,14 @@
             specific about which URLs it handles, and relies on the caller (the
             section listed above) to only pass relevant requests to it.  We term
             this "binding a URL" to a pipeline.</p>
-<p>For instance, the main pipeline in <span class="codefrag ">faq.xmap</span> matches
-            <span class="codefrag ">**.xml</span>, but only <span class="codefrag ">**faq.xml</span> requests are
+<p>For instance, the main pipeline in <span class="codefrag">faq.xmap</span> matches
+            <span class="codefrag">**.xml</span>, but only <span class="codefrag">**faq.xml</span> requests are
             sent to it.</p>
 <p>This "late binding" is useful, because the whole URL space is
-            managed in <span class="codefrag ">sitemap.xmap</span> and not spread over lots of
-            *.xmap files.  For instance, say you wish all <span class="codefrag ">*.xml</span>
-            inside a "<span class="codefrag ">faq/</span>" directory to be processed as FAQs.  Just
-            override <span class="codefrag ">sitemap.xmap</span> and redefine the relevant source
+            managed in <span class="codefrag">sitemap.xmap</span> and not spread over lots of
+            *.xmap files.  For instance, say you wish all <span class="codefrag">*.xml</span>
+            inside a "<span class="codefrag">faq/</span>" directory to be processed as FAQs.  Just
+            override <span class="codefrag">sitemap.xmap</span> and redefine the relevant source
             matcher:</p>
 <pre class="code">
         &lt;map:match pattern="**faq.xml"&gt;
@@ -669,7 +669,7 @@
 <h2 class="underlined_10">Output pipelines</h2>
 <div class="section">
 <p>
-        To recap, we now have a <span class="codefrag ">*.xml</span> pipeline defined for each
+        To recap, we now have a <span class="codefrag">*.xml</span> pipeline defined for each
         page in the site, emitting standardized XML.  These pipeline definitions
         are located in various *.xmap files, notably forrest.xmap
       </p>
@@ -683,7 +683,7 @@
           Easiest case first; PDFs don't require menus or headers, so we can
           simply transform our intermediate format into XSL:FO, and from there
           to PDF.  This is done by the following matcher in
-          <span class="codefrag ">sitemap.xmap</span> ...
+          <span class="codefrag">sitemap.xmap</span> ...
         </p>
 <pre class="code">
 1   &lt;map:match type="regexp" pattern="^(.*?)([^/]*).pdf$"&gt;
@@ -700,11 +700,11 @@
 <ol>
           
 <li>The first line uses a matching regexp to break the URL into
-            directory <span class="codefrag ">(.*?)</span> and filename
-            <span class="codefrag ">([^/]*)</span> parts.</li>
+            directory <span class="codefrag">(.*?)</span> and filename
+            <span class="codefrag">([^/]*)</span> parts.</li>
           
 <li>We then generate XML from a <a href="#source_pipelines">Source
-              pipeline</a>, with the URL <span class="codefrag ">cocoon:/{1}{2}.xml</span>
+              pipeline</a>, with the URL <span class="codefrag">cocoon:/{1}{2}.xml</span>
 </li>
           
 <li>We then expand any XInclude statements..</li>
@@ -720,8 +720,8 @@
 <h3 class="underlined_5">HTML output</h3>
 <p>Generating HTML pages is more complicated, because we have to merge
           the page body with a menu and tabs, and then add a header and footer.
-          Here is the <span class="codefrag ">*.html</span> matcher in
-          <span class="codefrag ">sitemap.xmap</span> ...</p>
+          Here is the <span class="codefrag">*.html</span> matcher in
+          <span class="codefrag">sitemap.xmap</span> ...</p>
 <pre class="code">
           &lt;map:match pattern="*.html"&gt;
             &lt;map:aggregate element="site"&gt;
@@ -740,7 +740,7 @@
           aggregating <a href="../body-index.html">body-index.html</a> and
           <a href="../menu-index.html">menu-index.html</a> and 
           <a href="../tab-index.html">tab-index.html</a> and then applying the
-          <span class="codefrag ">site2xhtml.xsl</span> stylesheet to the result.
+          <span class="codefrag">site2xhtml.xsl</span> stylesheet to the result.
         </p>
 <p>
           There is a nearly identical matcher for HTML files in subdirectories:
@@ -791,7 +791,7 @@
 <li>
             
 <p>We then apply a custom-written
-              <span class="codefrag ">IdGeneratorTransformer</span>, which ensures that every
+              <span class="codefrag">IdGeneratorTransformer</span>, which ensures that every
               &lt;section&gt; has an "id" attribute if one is not supplied, by generating one from the
               &lt;title&gt; if necessary.  For example, &lt;idgen&gt; will
               transform:</p>
@@ -810,9 +810,9 @@
               ...
             </pre>
             
-<p>Later, the <span class="codefrag ">document2html.xsl</span> stylesheet will create
+<p>Later, the <span class="codefrag">document2html.xsl</span> stylesheet will create
               an &lt;a name&gt; element for every section, allowing this section to
-              be referred to as <span class="codefrag ">index.html#How+to+boil+eggs</span>.</p>
+              be referred to as <span class="codefrag">index.html#How+to+boil+eggs</span>.</p>
           
 </li>
           
@@ -827,7 +827,7 @@
 </ol>
 <a name="N10291"></a><a name="menu_pipeline"></a>
 <h3 class="underlined_5">Page menu</h3>
-<p>In the <span class="codefrag ">sitemap.xmap</span> file, the matcher generating HTML for the menu is:</p>
+<p>In the <span class="codefrag">sitemap.xmap</span> file, the matcher generating HTML for the menu is:</p>
 <pre class="code">
       &lt;map:match pattern="**menu-*.html"&gt;
         &lt;map:generate src="cocoon:/{1}book-{2}.html"/&gt;
@@ -840,7 +840,7 @@
       </pre>
 <p>We get XML from a "book" pipeline, 
         <a href="#linkrewriting_impl">rewrite links</a>, and apply the
-          <span class="codefrag ">book2menu.xsl</span> stylesheet to generate HTML.</p>
+          <span class="codefrag">book2menu.xsl</span> stylesheet to generate HTML.</p>
 <p>How the menu XML is actually generated (the *book-*.html pipeline) is
           sufficiently complex to require a 
           <a href="#menu_xml_generation">section of its own</a>.</p>
@@ -857,23 +857,23 @@
        &lt;/map:call&gt;
      &lt;/map:match&gt;
            </pre>
-<p>All the smarts are in the <span class="codefrag ">tab2menu.xsl</span> stylesheet, which
+<p>All the smarts are in the <span class="codefrag">tab2menu.xsl</span> stylesheet, which
           needs to choose the correct tab based on the current path.  Currently,
           a "longest matching path" algorithm is implemented.  See the
-          <span class="codefrag ">tab2menu.xsl</span> stylesheet for details.</p>
+          <span class="codefrag">tab2menu.xsl</span> stylesheet for details.</p>
 </div>
 
     
 <a name="N102D3"></a><a name="menu_xml_generation"></a>
 <h2 class="underlined_10">Menu XML generation</h2>
 <div class="section">
-<p>The "book" pipeline is defined in <span class="codefrag ">sitemap.xmap</span>as:</p>
+<p>The "book" pipeline is defined in <span class="codefrag">sitemap.xmap</span>as:</p>
 <pre class="code">
         &lt;map:match pattern="**book-*.html"&gt;
           &lt;map:mount uri-prefix="" src="menu.xmap" check-reload="yes" /&gt;
         &lt;/map:match&gt;
         </pre>
-<p>Meaning that it is defined in the <span class="codefrag ">menu.xmap</span> file.  In there we find
+<p>Meaning that it is defined in the <span class="codefrag">menu.xmap</span> file.  In there we find
         the real definition, which is quite complicated, because there are three
         supported menu systems (see <a href="../docs_0_60/linking.html">menus and
           linking</a>).  We will not go through the sitemap itself
@@ -884,7 +884,7 @@
           root-relative.</li>
         
 <li>
-<p>Depending on the <span class="codefrag ">forrest.menu-scheme</span> property, we
+<p>Depending on the <span class="codefrag">forrest.menu-scheme</span> property, we
             now apply one of the two algorithms for choosing a set of menu links
             (described in <a href="../docs_0_60/linking.html#menu_generation">menu
               generation</a>):</p>
@@ -902,12 +902,12 @@
               
 <p>
                 For example, say our current page's path is
-                <span class="codefrag ">community/howto/index.html</span>.  In
-                <span class="codefrag ">site.xml</span> we look for the node with this
-                "<span class="codefrag ">href</span>" and discover its "<span class="codefrag ">tab</span>" attribute
-                value is "<span class="codefrag ">howtos</span>".  We then prune the
-                <span class="codefrag ">site.xml</span>-derived content to contain only nodes with
-                <span class="codefrag ">tab="howtos"</span>.
+                <span class="codefrag">community/howto/index.html</span>.  In
+                <span class="codefrag">site.xml</span> we look for the node with this
+                "<span class="codefrag">href</span>" and discover its "<span class="codefrag">tab</span>" attribute
+                value is "<span class="codefrag">howtos</span>".  We then prune the
+                <span class="codefrag">site.xml</span>-derived content to contain only nodes with
+                <span class="codefrag">tab="howtos"</span>.
               </p>
               
 <p>
@@ -927,7 +927,7 @@
 <li>
               
 <p>For "directory" menu generation, we simply use an
-                <span class="codefrag ">XPathTransformer</span> to include only pages in the
+                <span class="codefrag">XPathTransformer</span> to include only pages in the
                 current page's directory, or below:</p>
               
 <pre class="code">
@@ -937,10 +937,10 @@
                 </pre>
               
 <p>
-                Here, the "<span class="codefrag ">{1}</span>" is the directory part of the current
+                Here, the "<span class="codefrag">{1}</span>" is the directory part of the current
                 page.  So if our current page is
-                <span class="codefrag ">community/howto/index.html</span> then "<span class="codefrag ">{1}</span>" will
-                be <span class="codefrag ">community/howto/</span> and the transformer will
+                <span class="codefrag">community/howto/index.html</span> then "<span class="codefrag">{1}</span>" will
+                be <span class="codefrag">community/howto/</span> and the transformer will
                 include all nodes in that directory.
               </p>
             
@@ -948,18 +948,18 @@
           
 </ul>
           
-<p>We now have a <span class="codefrag ">site.xml</span> subset relevant to our current
+<p>We now have a <span class="codefrag">site.xml</span> subset relevant to our current
             page.</p>
         
 </li>
         
-<li>The "<span class="codefrag ">href</span>" nodes in this are then made relative to the
+<li>The "<span class="codefrag">href</span>" nodes in this are then made relative to the
           current page.</li>
         
-<li>The XML is then transformed into a legacy "<span class="codefrag ">book.xml</span>"
+<li>The XML is then transformed into a legacy "<span class="codefrag">book.xml</span>"
           format, for compatibility with existing stylesheets, and this XML
           format is returned (hence the name of the matcher:
-          <span class="codefrag ">**book-*.html</span>).</li>
+          <span class="codefrag">**book-*.html</span>).</li>
       
 </ol>
 </div>
@@ -968,7 +968,7 @@
 <a name="N10359"></a><a name="linkrewriting_impl"></a>
 <h2 class="underlined_10">Link rewriting</h2>
 <div class="section">
-<p>In numerous places in <span class="codefrag ">sitemap.xmap</span> you will see the
+<p>In numerous places in <span class="codefrag">sitemap.xmap</span> you will see the
         "linkrewriter" transformer in action.  For example:</p>
 <pre class="code">&lt;map:transform type="linkrewriter" src="cocoon:/{1}linkmap-{2}.html"/&gt;</pre>
 <p>This statement is Cocoon's linking system in action.  A full
@@ -977,7 +977,7 @@
 <a name="N10370"></a><a name="input_modules"></a>
 <h3 class="underlined_5">Cocoon foundations: Input Modules</h3>
 <p>
-          The implementation of <span class="codefrag ">site:</span> linking is heavily based on
+          The implementation of <span class="codefrag">site:</span> linking is heavily based on
           Cocoon <a href="http://cocoon.apache.org/2.1/userdocs/concepts/modules.html">Input Modules</a>, a
           little-known but quite powerful aspect of Cocoon.  Input Modules are
           generic Components which simply allow you to look up a value with a
@@ -985,21 +985,21 @@
           querying an underlying data source.
         </p>
 <p>
-          In particular, Cocoon contains an <span class="codefrag ">XMLFileModule</span>, which
+          In particular, Cocoon contains an <span class="codefrag">XMLFileModule</span>, which
           lets one look up the value of an XML node, by interpreting the key as
           an XPath expression.  Cocoon also has a
-          <span class="codefrag ">SimpleMappingMetaModule</span>, which allows the key to be
+          <span class="codefrag">SimpleMappingMetaModule</span>, which allows the key to be
           rewritten before it is used to look up a value.
         </p>
 <p>
-          The idea for putting these together to rewrite "<span class="codefrag ">site:</span>"
+          The idea for putting these together to rewrite "<span class="codefrag">site:</span>"
           links was described in <a href="http://marc.theaimsgroup.com/?t=103992708800001&r=1&w=2">this
             thread</a>. The idea is to write a Cocoon Transformer that
           triggers on encountering &lt;link
-          href="<span class="codefrag ">scheme:address</span>"&gt;, and interprets the
-          <span class="codefrag ">scheme:address</span> internal URI as
-          <span class="codefrag ">inputmodule:key</span>.  The transformer then uses the named
-          InputModule to look up the key value. The <span class="codefrag ">scheme:address</span>
+          href="<span class="codefrag">scheme:address</span>"&gt;, and interprets the
+          <span class="codefrag">scheme:address</span> internal URI as
+          <span class="codefrag">inputmodule:key</span>.  The transformer then uses the named
+          InputModule to look up the key value. The <span class="codefrag">scheme:address</span>
           URI is then rewritten with the found value.  This transformer was
           implemented as 
           <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=15611">LinkRewriterTransformer</a>,
@@ -1008,7 +1008,7 @@
 <a name="N103A4"></a><a name="implement_rewriting"></a>
 <h3 class="underlined_5">Implementing "site:" rewriting</h3>
 <p>
-          Using the above components, "<span class="codefrag ">site:</span>" URI rewriting is
+          Using the above components, "<span class="codefrag">site:</span>" URI rewriting is
           accomplished as follows.
         </p>
 <a name="N103B3"></a><a name="cocoon_xconf"></a>
@@ -1034,26 +1034,26 @@
             
 <li>
 <strong>linkmap</strong> will provide access to the contents of
-              <span class="codefrag ">site.xml</span>; for example, <span class="codefrag ">linkmap:/site/about/index/@href</span>
+              <span class="codefrag">site.xml</span>; for example, <span class="codefrag">linkmap:/site/about/index/@href</span>
               would return the value "index.html".</li>
             
 <li>
 <strong>site</strong> provides a "mask" over
-              <strong>linkmap</strong> such that <span class="codefrag ">site:index</span> expands
-              to <span class="codefrag ">linkmap:/site//index/@href</span>
+              <strong>linkmap</strong> such that <span class="codefrag">site:index</span> expands
+              to <span class="codefrag">linkmap:/site//index/@href</span>
             
 </li>
             
 <li>
 <strong>ext</strong> provides another "mask" over
-              <strong>linkmap</strong>, such that <span class="codefrag ">ext:ant</span> would
-              expand to <span class="codefrag ">linkmap:/site/external-refs//ant/@href</span>
+              <strong>linkmap</strong>, such that <span class="codefrag">ext:ant</span> would
+              expand to <span class="codefrag">linkmap:/site/external-refs//ant/@href</span>
             
 </li>
           
 </ul>
 <p>However at the moment, we have only declared the input modules.
-            They will be configured in <span class="codefrag ">sitemap.xmap</span> as described in
+            They will be configured in <span class="codefrag">sitemap.xmap</span> as described in
             the next section.</p>
 <a name="N103F1"></a><a name="sitemap"></a>
 <h4>sitemap.xmap</h4>
@@ -1110,39 +1110,39 @@
                   &lt;file src="{src}" reloadable="false" /&gt;
               &lt;/input-module&gt;</pre>
               
-<p>The "<span class="codefrag ">{src}</span>" text is expanded to the value of the
-                "<span class="codefrag ">src</span>" attribute in the "<span class="codefrag ">linkrewriter</span>"
-                instance, namely "<span class="codefrag ">cocoon:/{1}linkmap-{2}.html</span>"
-                Thus the <span class="codefrag ">linkmap</span> module reads dynamically
+<p>The "<span class="codefrag">{src}</span>" text is expanded to the value of the
+                "<span class="codefrag">src</span>" attribute in the "<span class="codefrag">linkrewriter</span>"
+                instance, namely "<span class="codefrag">cocoon:/{1}linkmap-{2}.html</span>"
+                Thus the <span class="codefrag">linkmap</span> module reads dynamically
                 generated XML specific to the current request.</p>
             
 </li>
             
 <li>
               
-<p>One level out, we configure the "<span class="codefrag ">site</span>" and
-                "<span class="codefrag ">ext</span>" input modules, to map onto our dynamically
-                configured "<span class="codefrag ">linkmap</span>" module.</p>
+<p>One level out, we configure the "<span class="codefrag">site</span>" and
+                "<span class="codefrag">ext</span>" input modules, to map onto our dynamically
+                configured "<span class="codefrag">linkmap</span>" module.</p>
             
 </li>
             
 <li>
               
 <p>Then at the outermost level, we configure the
-                "<span class="codefrag ">linkrewriter</span>" transformer.  First we tell it which
+                "<span class="codefrag">linkrewriter</span>" transformer.  First we tell it which
                 attributes to consider rewriting:</p>
               
 <pre class="code">
                 &lt;link-attrs&gt;href src&lt;/link-attrs&gt;
                 &lt;schemes&gt;site ext&lt;/schemes&gt;</pre>
               
-<p>So, "<span class="codefrag ">href</span>" and "<span class="codefrag ">src</span>" attributes starting
-                with "<span class="codefrag ">site:</span>" or "<span class="codefrag ">ext:</span>" are rewritten.</p>
+<p>So, "<span class="codefrag">href</span>" and "<span class="codefrag">src</span>" attributes starting
+                with "<span class="codefrag">site:</span>" or "<span class="codefrag">ext:</span>" are rewritten.</p>
 
               
-<p>By nesting the "<span class="codefrag ">site</span>" and "<span class="codefrag ">ext</span>" input
-                modules in the "<span class="codefrag ">linkrewriter</span>" configuration, we tell
-                "<span class="codefrag ">linkrewriter</span>" to use these two input modules when
+<p>By nesting the "<span class="codefrag">site</span>" and "<span class="codefrag">ext</span>" input
+                modules in the "<span class="codefrag">linkrewriter</span>" configuration, we tell
+                "<span class="codefrag">linkrewriter</span>" to use these two input modules when
                 rewriting links.</p>
             
 </li>
@@ -1150,20 +1150,20 @@
 </ul>
 <p>
             The end result is that, for example, the source XML for the
-            <span class="codefrag ">community/body-index.html</span> page has its links rewritten
+            <span class="codefrag">community/body-index.html</span> page has its links rewritten
             by an XMLFileModule reading XML from
-            <span class="codefrag ">cocoon:/community/linkmap-index.html</span>
+            <span class="codefrag">cocoon:/community/linkmap-index.html</span>
           
 </p>
 <a name="N10464"></a><a name="dynamic_linkmap"></a>
 <h4>Dynamically generating a linkmap</h4>
 <p>
             Why do we need this "linkmap" pipeline generating dynamic XML from
-            <span class="codefrag ">site.xml</span>, instead of just using <span class="codefrag ">site.xml</span> directly?  The reasons are described
+            <span class="codefrag">site.xml</span>, instead of just using <span class="codefrag">site.xml</span> directly?  The reasons are described
             in <a href="http://marc.theaimsgroup.com/?l=forrest-dev&m=103444028129281&w=2">the linkmap RT</a>: we need to
             concatenate @hrefs and add dot-dots to the paths, depending on which
             directory the linkee is in.  This is done with the following
-            pipelines in <span class="codefrag ">linkmap.xmap</span> ...
+            pipelines in <span class="codefrag">linkmap.xmap</span> ...
           </p>
 <pre class="code">
 &lt;!-- site.xml with @href's appended to be context-relative. --&gt;

Modified: forrest/site/docs_0_60/todo.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/todo.html?rev=357603&r1=357602&r2=357603&view=diff
==============================================================================
--- forrest/site/docs_0_60/todo.html (original)
+++ forrest/site/docs_0_60/todo.html Sun Dec 18 17:31:25 2005
@@ -316,7 +316,7 @@
         
         This info can then be made public to the sitemap (via XMLFileModule
         attributes) and the stylesheets (through
-        <span class="codefrag ">document(cocoon:/...)</span> calls or inlined with source XML).
+        <span class="codefrag">document(cocoon:/...)</span> calls or inlined with source XML).
          &rarr; open</li>
 <li>
 <strong>[code]</strong> 

Modified: forrest/site/docs_0_60/upgrading_06.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/upgrading_06.html?rev=357603&r1=357602&r2=357603&view=diff
==============================================================================
--- forrest/site/docs_0_60/upgrading_06.html (original)
+++ forrest/site/docs_0_60/upgrading_06.html Sun Dec 18 17:31:25 2005
@@ -378,7 +378,7 @@
 <h2 class="underlined_10">Run a clean target after upgrade</h2>
 <div class="section">
 <p>To avoid any issue with old classes being loaded, run a
-        '<span class="codefrag ">forrest clean</span>' in your project directory, after you
+        '<span class="codefrag">forrest clean</span>' in your project directory, after you
         upgraded to this version.
       </p>
 </div>
@@ -393,7 +393,7 @@
 <p>
       Take advantage of the separation of concerns. In a new workspace,
       create a fresh
-      '<span class="codefrag ">forrest seed</span>' site, then tweak its forrest.properties
+      '<span class="codefrag">forrest seed</span>' site, then tweak its forrest.properties
       and skinconf.xml until it reflects your old site.
       When it is ready, replace your project's skinconf.xml and
       forrest.properties files.
@@ -440,10 +440,10 @@
       them synchonised. This will enable hassle-free update to
       future Forrest versions.</p>
 <p>
-        If your old project did not use any customised <span class="codefrag ">*.xmap</span> 
+        If your old project did not use any customised <span class="codefrag">*.xmap</span> 
         files, then your upgrade process will be easy (you can safely skip this
         section).</p>
-<p>If your project did use custom <span class="codefrag ">*.xmaps</span>, with matchers for 
+<p>If your project did use custom <span class="codefrag">*.xmaps</span>, with matchers for 
         special circumstances (for example special doctypes that you 
         were handling) then you will need to be prepared to make some changes. 
         Hopefully with the new functionality of Forrest, you can do away with 
@@ -457,16 +457,16 @@
       there is now an extension mechanism for the sitemap (as opposed to 
       a replacement mechanism).</p>
 <p>When upgrading to Forrest 0.6 you need to copy customised matchers 
-      in any of your projects <span class="codefrag ">*.xmap</span> files into your projects 
-      <span class="codefrag ">sitemap.xmap</span> file. Any matchers in your project 
-      <span class="codefrag ">*.xmap</span> files that duplicate ones in Forrests own 
-      <span class="codefrag ">*.xmaps</span> can now be removed. This will ensure that future 
+      in any of your projects <span class="codefrag">*.xmap</span> files into your projects 
+      <span class="codefrag">sitemap.xmap</span> file. Any matchers in your project 
+      <span class="codefrag">*.xmap</span> files that duplicate ones in Forrests own 
+      <span class="codefrag">*.xmaps</span> can now be removed. This will ensure that future 
       enhancements to these matchers in Forrest will automatically be included 
       in your project.</p>
 <p>Move your old sitemap out of the way, copy a default one from a fresh
       'forrest seed', and add the specific matches that you require.</p>
 <p>The good news is that this process makes upgrading to future versions
-      of Forrest much simpler, because your project <span class="codefrag ">*.xmap</span> files will 
+      of Forrest much simpler, because your project <span class="codefrag">*.xmap</span> files will 
       contain only your customisations. As a result there will no longer be a
       need to merge your custom xmaps with the updated ones in upcoming versions of 
       Forrest.</p>
@@ -495,8 +495,8 @@
 <p>
       Various capabilities have been added to the skinconfig.
       See the new descriptions in the 
-      '<span class="codefrag ">forrest seed</span>' site
-      <span class="codefrag ">src/documentation/skinconf.xml</span> and synchronise yours.
+      '<span class="codefrag">forrest seed</span>' site
+      <span class="codefrag">src/documentation/skinconf.xml</span> and synchronise yours.
       </p>
 <p>For example, to use different colors (e.g. the light blue of the old
       krysalis skin), CSS colors can be specified in skinconf.xml
@@ -512,7 +512,7 @@
 <h2 class="underlined_10">forrest.antproxy.xml is obsolete in favor of Ant's &lt;import&gt; task</h2>
 <div class="section">
 <p>
-      Projects that use <span class="codefrag ">forrest.antproxy.xml</span> via an Ant build
+      Projects that use <span class="codefrag">forrest.antproxy.xml</span> via an Ant build
       task to invoke Forrest, will receive
       an error message directing them to this document.
       Please see the <a href="../docs_0_60/your-project.html#invoking_from_ant">Invoking
@@ -529,7 +529,7 @@
       The .ehtml input file format has been deprecated and will likely be
       removed in the next release.
       Please convert all .ehtml files to .html files.
-      If you do '<span class="codefrag ">forrest seed</span>' there is a sample html source file.
+      If you do '<span class="codefrag">forrest seed</span>' there is a sample html source file.
       </p>
 </div>
 

Modified: forrest/site/docs_0_60/validation.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/validation.html?rev=357603&r1=357602&r2=357603&view=diff
==============================================================================
--- forrest/site/docs_0_60/validation.html (original)
+++ forrest/site/docs_0_60/validation.html Sun Dec 18 17:31:25 2005
@@ -309,7 +309,7 @@
         By default, Forrest will validate your XML before generating
         HTML or a webapp from it, and fail if any XML files are not valid.
         Validation can be performed manually by doing
-        '<span class="codefrag ">forrest validate</span>' in the project root directory.
+        '<span class="codefrag">forrest validate</span>' in the project root directory.
       </p>
 <p>
         For an XML file to be valid, it <em>must</em> have a document type
@@ -323,7 +323,7 @@
         project.  In validated sections, it is possible for projects to specify
         exactly what files they want (and don't want) validated.  Forrest
         validation is controlled through a set of properties in
-        <span class="codefrag ">forrest.properties</span>:
+        <span class="codefrag">forrest.properties</span>:
       </p>
 <pre class="code">
 ##############
@@ -350,18 +350,18 @@
       </pre>
 <p>
         For example, to avoid validating
-        <span class="codefrag ">${project.xdocs-dir}</span>/slides.xml and everything inside the
-        <span class="codefrag ">${project.xdocs-dir}/manual/</span> directory, add this to
-        <span class="codefrag ">forrest.properties</span>:
+        <span class="codefrag">${project.xdocs-dir}</span>/slides.xml and everything inside the
+        <span class="codefrag">${project.xdocs-dir}/manual/</span> directory, add this to
+        <span class="codefrag">forrest.properties</span>:
       </p>
 <pre class="code">forrest.validate.xdocs.excludes=slides.xml, manual/**</pre>
 <div class="note">
 <div class="label">Note</div>
 <div class="content">
-        The <span class="codefrag ">failonerror</span> properties only work for files validated
+        The <span class="codefrag">failonerror</span> properties only work for files validated
         with Ant's &lt;xmlvalidate&gt; and not (yet) for those validated
-        with &lt;jing&gt;, where <span class="codefrag ">failonerror</span> defaults to
-        <span class="codefrag ">true</span>.
+        with &lt;jing&gt;, where <span class="codefrag">failonerror</span> defaults to
+        <span class="codefrag">true</span>.
       </div>
 </div>
 </div>
@@ -373,12 +373,12 @@
 <p>
         Forrest provides an <a href="http://www.oasis-open.org/committees/entity/spec.html">OASIS Catalog</a>
         [see <a href="http://xml.apache.org/commons/components/resolver/resolver-article.html">tutorial</a>]
-        <span class="codefrag ">forrest/src/core/context/resources/schema/catalog.xcat</span>
+        <span class="codefrag">forrest/src/core/context/resources/schema/catalog.xcat</span>
         as a means of associating public identifiers
-        (e.g. <span class="codefrag ">-//APACHE//DTD Documentation V1.1//EN</span> above) with DTDs.
+        (e.g. <span class="codefrag">-//APACHE//DTD Documentation V1.1//EN</span> above) with DTDs.
         If you <a href="../docs_0_60/your-project.html#adding_new_content_type">add a new content type</a>, you
-        should add the DTD to <span class="codefrag ">${project.schema-dir}/dtd/</span> and add
-        an entry to the <span class="codefrag ">${project.schema-dir}/catalog.xcat</span> file.  This
+        should add the DTD to <span class="codefrag">${project.schema-dir}/dtd/</span> and add
+        an entry to the <span class="codefrag">${project.schema-dir}/catalog.xcat</span> file.  This
         section describes the details of this process.
       </p>
 <a name="N1006A"></a><a name="Creating+or+extending+a+DTD"></a>
@@ -408,13 +408,13 @@
         </pre>
 <p>
           The document-v13 entities are defined in a reusable 'module':
-          <span class="codefrag ">forrest/src/core/context/resources/schema/dtd/document-v13.mod</span>
+          <span class="codefrag">forrest/src/core/context/resources/schema/dtd/document-v13.mod</span>
           The
-          <span class="codefrag ">forrest/src/core/context/resources/schema/dtd/document-v13.dtd</span>
+          <span class="codefrag">forrest/src/core/context/resources/schema/dtd/document-v13.dtd</span>
           file provides a full description and basic example of how to pull in
           modules.  In our example, our DTD reuses modules
-          <span class="codefrag ">common-charents-v10.mod</span> and
-          <span class="codefrag ">document-v13.mod</span>.  Here is the full DTD, with
+          <span class="codefrag">common-charents-v10.mod</span> and
+          <span class="codefrag">document-v13.mod</span>.  Here is the full DTD, with
           explanation to follow.
         </p>
 <pre class="code">
@@ -489,20 +489,20 @@
 &lt;!-- =============================================================== --&gt;
         </pre>
 <p>This custom DTD should be placed in your project resources
-        directory at <span class="codefrag ">src/documentation/resources/schema/dtd/</span>
+        directory at <span class="codefrag">src/documentation/resources/schema/dtd/</span>
 </p>
 <p>
           The &lt;!ENTITY % ... &gt; blocks are so-called 
           <a href="http://www.xml.com/axml/target.html#dt-PERef">parameter
             entities</a>.  They are like macros, whose content will be
           inserted when a parameter-entity reference, like
-          <span class="codefrag ">%common-charents;</span> or <span class="codefrag ">%document;</span> is
+          <span class="codefrag">%common-charents;</span> or <span class="codefrag">%document;</span> is
           inserted.
         </p>
 <p>
           In our DTD, we first pull in the 'common-charents' entity, which
           defines character symbol sets.  We then define the 'document'
-          entity.  However, before the <span class="codefrag ">%document;</span> PE reference, we
+          entity.  However, before the <span class="codefrag">%document;</span> PE reference, we
           first override the 'local.section' entity.  This is a hook into
           document-v13.mod.  By setting its value to '|release', we declare
           that our &lt;release&gt; element is to be allowed wherever "local
@@ -534,7 +534,7 @@
           "download-v10.dtd"&gt;
         </pre>
 <p>
-          We only care about the quoted section after <span class="codefrag ">PUBLIC</span>, called
+          We only care about the quoted section after <span class="codefrag">PUBLIC</span>, called
           the "public identifier", which globally identifies our document type.
           We cannot rely on the subsequent "system identifier" part
           ("download-v10.dtd"), because as a relative reference it is liable to
@@ -551,11 +551,11 @@
 </div>
 <p>
           Forrest provides a standard catalog file at
-          <span class="codefrag ">forrest/src/core/context/resources/schema/catalog.xcat</span>
+          <span class="codefrag">forrest/src/core/context/resources/schema/catalog.xcat</span>
           for the document
           types that Forrest provides.  Projects can augment this with their
           own catalog file located in
-          <span class="codefrag ">${project.schema-dir}/catalog.xcat</span>
+          <span class="codefrag">${project.schema-dir}/catalog.xcat</span>
         
 </p>
 <p>
@@ -573,24 +573,24 @@
 <p>
           The format is described in <a href="http://www.oasis-open.org/committees/entity/spec.html">the
           spec</a>, and is fairly simple and very powerful.
-          The "<span class="codefrag ">public</span>" elements map
+          The "<span class="codefrag">public</span>" elements map
           a public identifier to a DTD (relative to the catalog file).
         </p>
 <p>
-          Next specify the full path to your <span class="codefrag ">catalog.xcat</span> in the
-          <span class="codefrag ">src/documentation/classes/CatalogManager.properties</span> file.
+          Next specify the full path to your <span class="codefrag">catalog.xcat</span> in the
+          <span class="codefrag">src/documentation/classes/CatalogManager.properties</span> file.
           Cocoon needs this file when it starts to run. A template file is
           provided in the "fresh-site" when you do the
-          '<span class="codefrag ">forrest seed</span>' to commence a new project.
+          '<span class="codefrag">forrest seed</span>' to commence a new project.
         </p>
 <p>
           We now have a custom DTD and a catalog mapping which lets both
           Forrest and Cocoon
-          locate the DTD.  Now if we were to run <span class="codefrag ">'forrest validate'</span>
+          locate the DTD.  Now if we were to run <span class="codefrag">'forrest validate'</span>
           our download file would validate along with all the others.  If
-          something goes wrong, try running <span class="codefrag ">'forrest -v validate'</span> to
+          something goes wrong, try running <span class="codefrag">'forrest -v validate'</span> to
           see the error in more detail. Remember to raise the "verbosity"
-          level in <span class="codefrag ">cocoon.xconf</span> if you suspect problems
+          level in <span class="codefrag">cocoon.xconf</span> if you suspect problems
           with your catalog.
         </p>
 </div>
@@ -601,8 +601,8 @@
 <div class="section">
 <p>
         Look at the source of this document
-        (<span class="codefrag ">xdocs/docs/validation.xml</span>) and see how the entity set
-        <span class="codefrag ">"Numeric and Special Graphic"</span> is declared in the
+        (<span class="codefrag">xdocs/docs/validation.xml</span>) and see how the entity set
+        <span class="codefrag">"Numeric and Special Graphic"</span> is declared in the
         document type declaration.
       </p>
 <table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -644,10 +644,10 @@
       </p>
 <p>
         The RNG grammars to do this are located in the
-        <span class="codefrag ">src/core/context/resources/schema/relaxng</span> directory.
+        <span class="codefrag">src/core/context/resources/schema/relaxng</span> directory.
         If you want to
         know more about this, and perhaps extend it for your own use, then
-        see <span class="codefrag ">src/core/context/resources/schema/relaxng/README.txt</span>
+        see <span class="codefrag">src/core/context/resources/schema/relaxng/README.txt</span>
         and the Ant targets in the various build.xml files.
       </p>
 </div>



Mime
View raw message