You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by as...@apache.org on 2007/09/08 22:17:47 UTC
svn commit: r573901 [12/44] - in /cocoon/site: site/ site/2.0/
site/2.0/developing/ site/2.0/faq/ site/2.0/howto/chaperon/
site/2.0/installing/ site/2.0/plan/ site/2.0/snippet/ site/2.0/tutorial/
site/2.0/userdocs/ site/2.0/userdocs/actions/ site/2.0/u...
Modified: cocoon/site/site/2.0/faq/faq-sitemap.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/faq/faq-sitemap.html?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/faq/faq-sitemap.html (original)
+++ cocoon/site/site/2.0/faq/faq-sitemap.html Sat Sep 8 13:17:41 2007
@@ -1,752 +1,752 @@
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Sitemap FAQs</title>
-<STYLE type="text/css">
-a.menu {
- color: #FFFFFF;
- text-align:left;
- font-size:12px;
- font-family: Verdana, Arial, Helvetica, sans-serif;
- font-weight:plain;
- text-decoration:none;
- padding-left: 14px
-}
-
-A.menu:hover {
- color: #FFCC00
-}
-
-
-.menutitle {
- color: #000000;
- text-align:left;
- font-size:10px;
- font-family: Verdana, Arial, Helvetica, sans-serif;
- font-weight:bold;
- padding-left: 8px
-}
-.menuselected {
- color: #FFCC00;
- text-align:left;
- font-size:12px;
- font-family: Verdana, Arial, Helvetica, sans-serif;
- font-weight:bold;
- padding-left: 14px
-}
-</STYLE>
-</head>
-<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
-<table border="0" cellpadding="0" cellspacing="0" width="100%">
-<tr>
-<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
-</tr>
-<tr>
-<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Sitemap FAQs</font></td>
-</tr>
-<tr>
-<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
-<table width="288" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr width="100%">
-<td align="left" valign="top" width="120">
-<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
-<tr>
-<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">Main</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">FAQs</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="index.html">Index</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Getting Started</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-install.html">Install</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-environment.html">Configure</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-cvs.html">CVS</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Using</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-c2.html">Configure C2</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-databases.html">Databases</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xsp.html">XSP</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xslt.html">XSLT</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-debugging.html">Debugging</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Sitemap</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Sitemap</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-generators.html">Generators</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-transformers.html">Transformers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-serializers.html">Serializers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-matchers.html">Matchers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-selectors.html">Selectors</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-actions.html">Actions</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-aggregators.html">Aggregators</a></td>
-</tr>
-<tr>
-<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-</table>
-</td><td>
-<table cellspacing="15" cellpadding="0" border="0">
-<tr>
-<td><font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Questions</font>
-<hr style="color: #0086b2" size="1">
-<blockquote>
-<ul>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-1">
- What are the steps to pre-compile the sitemap and XSP's?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-2">I don't want to hand edit the sitemap. Are there any
- tools?</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-3">How do I create some content which isn't directly visible to
- everyone?</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-4">How can I concatenate two xml files?</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-5">I want to use the XXX matcher/serializer/selecter/etc but there's no
- examples :(</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-6">
- I changed the sitemap, but my changes don't show in the browser.
- Do I need to restart the servlet container?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-7">When I add an action to a pipeline Cocoon returns an
- error.</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-8">
- What is the syntax for absolute filesystem pathnames.
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-9">
-What's the difference between having two pipelines with one matcher
-each, and one pipeline with two matchers?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-10">
-Where can I find more information about the sitemap?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-11">
- How can I add my FAQ to this document?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-12">
- How can I suggest improvements to existing FAQs?
- </a></font>
-</li>
-</ul>
-</blockquote>
-<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Answers</font>
-<hr style="color: #0086b2" size="1">
-<a name="faq-1">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- What are the steps to pre-compile the sitemap and XSP's?
- </b></font>
-
-
-
-<blockquote>
-<ul>
-
-<li>
-<font face="verdana, helvetica, sans serif">Set the auto-reload to false in your sitemap.xmap as follows:</font>
-</li>
-
-</ul>
-</blockquote>
-
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-<parameter name="auto-reload" value="false"/>
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-
-<blockquote>
-<ul>
-
-<li>
-<font face="verdana, helvetica, sans serif">Use "-Dbuild.precompile=true" in your build command line when you are
- building your WAR file.
- </font>
-</li>
-
-</ul>
-</blockquote>
-
-
-<a name="faq-2">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>I don't want to hand edit the sitemap. Are there any
- tools?</b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Try <a target="_blank" href="http://pollo.sourceforge.net/">this</a>
- by Bruno Dumon.</font>
-</p>
-
-
-<a name="faq-3">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How do I create some content which isn't directly visible to
- everyone?</b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Put the content in an internal pipeline...</font>
-</p>
-
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-<map:pipelines>
- <map:pipeline internal-only="true">
- <map:match pattern="int">
- <map:generate src="docs/description.xml"/>
- <map:serialize type="xml"/>
- </map:match>
- </map:pipeline>
- <map:pipeline>
- <map:match pattern="desc.html">
- <map:generate src="cocoon:/int"/>
- <map:transform src="stylesheets/description2html.xsl"/>
- <map:serialize type="html"/>
- </map:match>
- </map:pipeline>
-</map:pipelines>
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-
-
-<a name="faq-4">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How can I concatenate two xml files?</b></font>
-
-
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-<map:pipelines>
- <map:pipeline internal-only="true">
- <map:match pattern="one">
- <map:generate src="docs/one.xml"/>
- <map:serialize type="xml"/>
- </map:match>
- <map:match pattern="two">
- <map:generate src="docs/two.xml"/>
- <map:serialize type="xml"/>
- </map:match>
- </map:pipeline>
- <map:pipeline>
- <map:match pattern="desc.html">
- <map:aggregate element="newRootElement">
- <map:part src="cocoon:/one" element="firstXMLfile"/>
- <map:part src="cocoon:/two" element="secondXMLfile"/>
- </map:aggregate>
- <map:transform src="stylesheets/merge2html.xsl"/>
- <map:serialize type="html"/>
- </map:match>
- </map:pipeline>
-</map:pipelines>
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Where the element attribute names are replaced with something more
- meaningful! Note that the map:part element attributes can be left off,
- which results in the two parts being placed one immediately after the
- other.</font>
-</p>
-
-
-<a name="faq-5">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>I want to use the XXX matcher/serializer/selecter/etc but there's no
- examples :(</b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">If you've checked the sample webapps which come with Cocoon, and you've
- looked in the documentation, then check both the user and
- dev archives. If it hasn't been resolved before <b>first</b>
- email the user group and, after a <b>reasonable</b> (ie 1 or 2
- days) length of time (remember not everyone lives in your timezone) email
- the dev group.</font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Please don't cross-post to both the user and dev groups - very few people
- like getting bombarded!</font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Oh, and once you do get it working - how about documenting it and
- contributing it back to the group?</font>
-</p>
-
-
-<a name="faq-6">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- I changed the sitemap, but my changes don't show in the browser.
- Do I need to restart the servlet container?
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Cocoon lets you decide whether it needs to poll for sitemap changes
- (with its associated performance penalty) or not. It also lets you decide whether the re-compilation resulting from polling shoud happen in the
- background or in the foreground.</font>
-</p>
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">If you look at the cocoon.xconf file, you'll notice this element:</font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-<sitemap file="sitemap.xmap"
- reload-method="asynchron"
- check-reload="yes"/></pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Which means:</font>
-</p>
-
-<blockquote>
-<ul>
-
-<li>
-<font face="verdana, helvetica, sans serif">The <code><font face="courier, monospaced">check-reload</font></code> attribute determines if the sitemap
- is reloaded on change. Set to "no", the sitemap is generated once
- at startup. Set to "yes", the sitemap is regenerated if it changes.</font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">The <code><font face="courier, monospaced">reload-method</font></code> specifies the method for the
- regeneration:
- <blockquote>
-<ol>
-
-<li>
-<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">asynchron</font></code>: If the sitemap changes, the sitemap is
- regenerated at the next request in the background and the incoming
- request is served with the old sitemap. All subsequent requests
- are served with the old sitemap until the regeneration in the
- background has finished.</font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">synchron</font></code>: If the sitemap changes, the sitemap
- is regenerated at the next request. When the regeneration is
- finished, the request (and all subsequent ones) is served with
- the new sitemap.</font>
-</li>
-
-</ol>
-</blockquote>
-
-</font>
-</li>
-
-</ul>
-</blockquote>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- For a development environment, set the reload-method to "synchron" and the
- check-reload to "yes." For a production environment,
- set the reload-method to "asynchron." For more safety, set the check-reload
- to "no."
- </font>
-</p>
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">In a nutshell: By default, reload is "asynchron" which means:</font>
-</p>
-
-<blockquote>
-<ol>
-
-<li>
-<font face="verdana, helvetica, sans serif">Change sitemap</font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">Hit reload</font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">Wait while CPU goes up to 100% and back down to 0%</font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">Hit reload</font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">Voila - new sitemap is used! :)</font>
-</li>
-
-</ol>
-</blockquote>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Hence: you don't need to restart the servlet container.</font>
-</p>
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">For sub-sitemaps, this issue is defined in the mounting element:</font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-<map:mount uri-prefix="foo" src="file:///c:/foo/"
- check-reload="yes"
- reload-method="synchron"/></pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">With these settings Cocoon will react to any changes in the sub-sitemap,
- without even hitting the reload button twice. :)</font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Moreover, it is a good idea to use sub-sitemaps because they reduce
- overall compilation time. For example, changes to a single sub-sitemap won't
- require recompilation for the the main sitemap or other sub-sitemaps. This
- practice leads to greater degree of modularity.
- </font>
-</p>
-
-
-<a name="faq-7">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>When I add an action to a pipeline Cocoon returns an
- error.</b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Before the action was added to the pipeline it worked fine. After
- the change Cocoon seems not to find the file specified in the
- variable that is returned by the matcher.</font>
-</p>
-
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-<map:match pattern="*">
- <map:act type="validate-session">
- <map:generate type="serverpages" src="{../1}.xsp"/>
- </map:act>
- <map:serialize/>
-</map:match>
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Please note in the above example the
- "<b><code><font face="courier, monospaced">../1</font></code></b>".</font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Map objects returned from matchers, actions etc. are organised
- <i>hierarchically</i>. Therefore they are not replaced by new ones
- but older ones are still accessible through a path expression. Here
- "<code><font face="courier, monospaced">../1</font></code>" references key ("variable") "1" in the next to
- last Map. </font>
-</p>
-
-
-<a name="faq-8">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- What is the syntax for absolute filesystem pathnames.
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- In your sitemaps you may need to refer to some resource that is outside
- the webapp context (e.g. UNIX /foo/bar/this.xsl
- e.g. Windows C:\foo\bar\this.xsl). You need to use the file: convention.
- </font>
-</p>
-
-<blockquote>
-<ul>
-
-<li>
-<font face="verdana, helvetica, sans serif">UNIX ... <code><font face="courier, monospaced">file:///foo/bar/this.xsl</font></code></font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">Windows ... <code><font face="courier, monospaced">file:///C:/foo/bar/this.xsl</font></code></font>
-</li>
-
-</ul>
-</blockquote>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- See further explanation of
- <a href="../userdocs/concepts/sitemap.html#file-url">file: URLs</a>
- </font>
-</p>
-
-
-<a name="faq-9">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-What's the difference between having two pipelines with one matcher
-each, and one pipeline with two matchers?
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-If there is no other difference in pipeline declarations, then none, really. Note that pipelines can differ by:
- </font>
-</p>
-
-<blockquote>
-<ul>
-
-<li>
-<font face="verdana, helvetica, sans serif">
-visibility: internal-only="true" (not accessible for external requests) or not.
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
-error handling: using different <handle-errors>s.
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
-cachability (since 2.1): some requests can use cached responses
-from caching pipeline. Others, which should not be cached, can be
-handled by the non-caching pipeline implementation.
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
-logical grouping: logically-related components can be grouped into
-separate pipelines to improve readability and ease administrative concerns.
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
-ids: used to identify pipeline and other elements. See the "sitebuilder" sitemap editor
-in scratchpad samples for an example.
- </font>
-</li>
-
-</ul>
-</blockquote>
-
-
-<a name="faq-10">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-Where can I find more information about the sitemap?
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Learn more about advanced Sitemap features by downloading the free chapter, <a href="http://www.newriders.com/books/product.asp?product_id={C3C05052-BE3B-4E06-A60A-13FB40AF58F6}">A User's Look at the Cocoon architecture,</a> from Langham and Ziegeler's <i>Cocoon: Building XML Applications</i> available at the New Riders web site.
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Check out a draft XML Schema <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/cocoon-2.0/src/documentation/xdocs/drafts/sitemap-2.1-draft.xsd?rev=HEAD&content-type=text/plain">grammar for the Cocoon sitemap</a>, and some <a href="http://outerthought.net/sitemap/">external documentation</a> generated from this Schema. A poster diagram of the sitemap structure is also available.
- </font>
-</p>
-
-
-<a name="faq-11">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- How can I add my FAQ to this document?
- </b></font>
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
-</p>
-<a name="faq-12">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- How can I suggest improvements to existing FAQs?
- </b></font>
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Given the rapid pace of change with Cocoon, many individual FAQs quickly become out-of-date and confusing to new users. If you have the relevant knowledge, please consider updating other FAQs on this page for technical errors. If you see a few typos, please consider fixing them too. Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
-</p>
-</td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
-</tr>
-<tr>
-<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright © 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
-</tr>
-</table>
-</body>
-</html>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Sitemap FAQs</title>
+<STYLE type="text/css">
+a.menu {
+ color: #FFFFFF;
+ text-align:left;
+ font-size:12px;
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ font-weight:plain;
+ text-decoration:none;
+ padding-left: 14px
+}
+
+A.menu:hover {
+ color: #FFCC00
+}
+
+
+.menutitle {
+ color: #000000;
+ text-align:left;
+ font-size:10px;
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ font-weight:bold;
+ padding-left: 8px
+}
+.menuselected {
+ color: #FFCC00;
+ text-align:left;
+ font-size:12px;
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ font-weight:bold;
+ padding-left: 14px
+}
+</STYLE>
+</head>
+<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr>
+<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
+</tr>
+<tr>
+<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Sitemap FAQs</font></td>
+</tr>
+<tr>
+<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
+<table width="288" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr width="100%">
+<td align="left" valign="top" width="120">
+<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
+<tr>
+<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">Main</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">FAQs</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="index.html">Index</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Getting Started</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-install.html">Install</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-environment.html">Configure</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-cvs.html">CVS</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Using</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-c2.html">Configure C2</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-databases.html">Databases</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xsp.html">XSP</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xslt.html">XSLT</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-debugging.html">Debugging</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Sitemap</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Sitemap</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-generators.html">Generators</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-transformers.html">Transformers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-serializers.html">Serializers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-matchers.html">Matchers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-selectors.html">Selectors</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-actions.html">Actions</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-aggregators.html">Aggregators</a></td>
+</tr>
+<tr>
+<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+</table>
+</td><td>
+<table cellspacing="15" cellpadding="0" border="0">
+<tr>
+<td><font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Questions</font>
+<hr style="color: #0086b2" size="1">
+<blockquote>
+<ul>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-1">
+ What are the steps to pre-compile the sitemap and XSP's?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-2">I don't want to hand edit the sitemap. Are there any
+ tools?</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-3">How do I create some content which isn't directly visible to
+ everyone?</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-4">How can I concatenate two xml files?</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-5">I want to use the XXX matcher/serializer/selecter/etc but there's no
+ examples :(</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-6">
+ I changed the sitemap, but my changes don't show in the browser.
+ Do I need to restart the servlet container?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-7">When I add an action to a pipeline Cocoon returns an
+ error.</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-8">
+ What is the syntax for absolute filesystem pathnames.
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-9">
+What's the difference between having two pipelines with one matcher
+each, and one pipeline with two matchers?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-10">
+Where can I find more information about the sitemap?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-11">
+ How can I add my FAQ to this document?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-12">
+ How can I suggest improvements to existing FAQs?
+ </a></font>
+</li>
+</ul>
+</blockquote>
+<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Answers</font>
+<hr style="color: #0086b2" size="1">
+<a name="faq-1">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ What are the steps to pre-compile the sitemap and XSP's?
+ </b></font>
+
+
+
+<blockquote>
+<ul>
+
+<li>
+<font face="verdana, helvetica, sans serif">Set the auto-reload to false in your sitemap.xmap as follows:</font>
+</li>
+
+</ul>
+</blockquote>
+
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+<parameter name="auto-reload" value="false"/>
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+
+<blockquote>
+<ul>
+
+<li>
+<font face="verdana, helvetica, sans serif">Use "-Dbuild.precompile=true" in your build command line when you are
+ building your WAR file.
+ </font>
+</li>
+
+</ul>
+</blockquote>
+
+
+<a name="faq-2">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>I don't want to hand edit the sitemap. Are there any
+ tools?</b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Try <a target="_blank" href="http://pollo.sourceforge.net/">this</a>
+ by Bruno Dumon.</font>
+</p>
+
+
+<a name="faq-3">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How do I create some content which isn't directly visible to
+ everyone?</b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Put the content in an internal pipeline...</font>
+</p>
+
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+<map:pipelines>
+ <map:pipeline internal-only="true">
+ <map:match pattern="int">
+ <map:generate src="docs/description.xml"/>
+ <map:serialize type="xml"/>
+ </map:match>
+ </map:pipeline>
+ <map:pipeline>
+ <map:match pattern="desc.html">
+ <map:generate src="cocoon:/int"/>
+ <map:transform src="stylesheets/description2html.xsl"/>
+ <map:serialize type="html"/>
+ </map:match>
+ </map:pipeline>
+</map:pipelines>
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+
+
+<a name="faq-4">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How can I concatenate two xml files?</b></font>
+
+
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+<map:pipelines>
+ <map:pipeline internal-only="true">
+ <map:match pattern="one">
+ <map:generate src="docs/one.xml"/>
+ <map:serialize type="xml"/>
+ </map:match>
+ <map:match pattern="two">
+ <map:generate src="docs/two.xml"/>
+ <map:serialize type="xml"/>
+ </map:match>
+ </map:pipeline>
+ <map:pipeline>
+ <map:match pattern="desc.html">
+ <map:aggregate element="newRootElement">
+ <map:part src="cocoon:/one" element="firstXMLfile"/>
+ <map:part src="cocoon:/two" element="secondXMLfile"/>
+ </map:aggregate>
+ <map:transform src="stylesheets/merge2html.xsl"/>
+ <map:serialize type="html"/>
+ </map:match>
+ </map:pipeline>
+</map:pipelines>
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Where the element attribute names are replaced with something more
+ meaningful! Note that the map:part element attributes can be left off,
+ which results in the two parts being placed one immediately after the
+ other.</font>
+</p>
+
+
+<a name="faq-5">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>I want to use the XXX matcher/serializer/selecter/etc but there's no
+ examples :(</b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">If you've checked the sample webapps which come with Cocoon, and you've
+ looked in the documentation, then check both the user and
+ dev archives. If it hasn't been resolved before <b>first</b>
+ email the user group and, after a <b>reasonable</b> (ie 1 or 2
+ days) length of time (remember not everyone lives in your timezone) email
+ the dev group.</font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Please don't cross-post to both the user and dev groups - very few people
+ like getting bombarded!</font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Oh, and once you do get it working - how about documenting it and
+ contributing it back to the group?</font>
+</p>
+
+
+<a name="faq-6">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ I changed the sitemap, but my changes don't show in the browser.
+ Do I need to restart the servlet container?
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Cocoon lets you decide whether it needs to poll for sitemap changes
+ (with its associated performance penalty) or not. It also lets you decide whether the re-compilation resulting from polling shoud happen in the
+ background or in the foreground.</font>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">If you look at the cocoon.xconf file, you'll notice this element:</font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+<sitemap file="sitemap.xmap"
+ reload-method="asynchron"
+ check-reload="yes"/></pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Which means:</font>
+</p>
+
+<blockquote>
+<ul>
+
+<li>
+<font face="verdana, helvetica, sans serif">The <code><font face="courier, monospaced">check-reload</font></code> attribute determines if the sitemap
+ is reloaded on change. Set to "no", the sitemap is generated once
+ at startup. Set to "yes", the sitemap is regenerated if it changes.</font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">The <code><font face="courier, monospaced">reload-method</font></code> specifies the method for the
+ regeneration:
+ <blockquote>
+<ol>
+
+<li>
+<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">asynchron</font></code>: If the sitemap changes, the sitemap is
+ regenerated at the next request in the background and the incoming
+ request is served with the old sitemap. All subsequent requests
+ are served with the old sitemap until the regeneration in the
+ background has finished.</font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">synchron</font></code>: If the sitemap changes, the sitemap
+ is regenerated at the next request. When the regeneration is
+ finished, the request (and all subsequent ones) is served with
+ the new sitemap.</font>
+</li>
+
+</ol>
+</blockquote>
+
+</font>
+</li>
+
+</ul>
+</blockquote>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ For a development environment, set the reload-method to "synchron" and the
+ check-reload to "yes." For a production environment,
+ set the reload-method to "asynchron." For more safety, set the check-reload
+ to "no."
+ </font>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">In a nutshell: By default, reload is "asynchron" which means:</font>
+</p>
+
+<blockquote>
+<ol>
+
+<li>
+<font face="verdana, helvetica, sans serif">Change sitemap</font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">Hit reload</font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">Wait while CPU goes up to 100% and back down to 0%</font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">Hit reload</font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">Voila - new sitemap is used! :)</font>
+</li>
+
+</ol>
+</blockquote>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Hence: you don't need to restart the servlet container.</font>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">For sub-sitemaps, this issue is defined in the mounting element:</font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+<map:mount uri-prefix="foo" src="file:///c:/foo/"
+ check-reload="yes"
+ reload-method="synchron"/></pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">With these settings Cocoon will react to any changes in the sub-sitemap,
+ without even hitting the reload button twice. :)</font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Moreover, it is a good idea to use sub-sitemaps because they reduce
+ overall compilation time. For example, changes to a single sub-sitemap won't
+ require recompilation for the the main sitemap or other sub-sitemaps. This
+ practice leads to greater degree of modularity.
+ </font>
+</p>
+
+
+<a name="faq-7">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>When I add an action to a pipeline Cocoon returns an
+ error.</b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Before the action was added to the pipeline it worked fine. After
+ the change Cocoon seems not to find the file specified in the
+ variable that is returned by the matcher.</font>
+</p>
+
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+<map:match pattern="*">
+ <map:act type="validate-session">
+ <map:generate type="serverpages" src="{../1}.xsp"/>
+ </map:act>
+ <map:serialize/>
+</map:match>
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Please note in the above example the
+ "<b><code><font face="courier, monospaced">../1</font></code></b>".</font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Map objects returned from matchers, actions etc. are organised
+ <i>hierarchically</i>. Therefore they are not replaced by new ones
+ but older ones are still accessible through a path expression. Here
+ "<code><font face="courier, monospaced">../1</font></code>" references key ("variable") "1" in the next to
+ last Map. </font>
+</p>
+
+
+<a name="faq-8">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ What is the syntax for absolute filesystem pathnames.
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ In your sitemaps you may need to refer to some resource that is outside
+ the webapp context (e.g. UNIX /foo/bar/this.xsl
+ e.g. Windows C:\foo\bar\this.xsl). You need to use the file: convention.
+ </font>
+</p>
+
+<blockquote>
+<ul>
+
+<li>
+<font face="verdana, helvetica, sans serif">UNIX ... <code><font face="courier, monospaced">file:///foo/bar/this.xsl</font></code></font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">Windows ... <code><font face="courier, monospaced">file:///C:/foo/bar/this.xsl</font></code></font>
+</li>
+
+</ul>
+</blockquote>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ See further explanation of
+ <a href="../userdocs/concepts/sitemap.html#file-url">file: URLs</a>
+ </font>
+</p>
+
+
+<a name="faq-9">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+What's the difference between having two pipelines with one matcher
+each, and one pipeline with two matchers?
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+If there is no other difference in pipeline declarations, then none, really. Note that pipelines can differ by:
+ </font>
+</p>
+
+<blockquote>
+<ul>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+visibility: internal-only="true" (not accessible for external requests) or not.
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+error handling: using different <handle-errors>s.
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+cachability (since 2.1): some requests can use cached responses
+from caching pipeline. Others, which should not be cached, can be
+handled by the non-caching pipeline implementation.
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+logical grouping: logically-related components can be grouped into
+separate pipelines to improve readability and ease administrative concerns.
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ids: used to identify pipeline and other elements. See the "sitebuilder" sitemap editor
+in scratchpad samples for an example.
+ </font>
+</li>
+
+</ul>
+</blockquote>
+
+
+<a name="faq-10">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+Where can I find more information about the sitemap?
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Learn more about advanced Sitemap features by downloading the free chapter, <a href="http://www.newriders.com/books/product.asp?product_id={C3C05052-BE3B-4E06-A60A-13FB40AF58F6}">A User's Look at the Cocoon architecture,</a> from Langham and Ziegeler's <i>Cocoon: Building XML Applications</i> available at the New Riders web site.
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Check out a draft XML Schema <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/cocoon-2.0/src/documentation/xdocs/drafts/sitemap-2.1-draft.xsd?rev=HEAD&content-type=text/plain">grammar for the Cocoon sitemap</a>, and some <a href="http://outerthought.net/sitemap/">external documentation</a> generated from this Schema. A poster diagram of the sitemap structure is also available.
+ </font>
+</p>
+
+
+<a name="faq-11">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ How can I add my FAQ to this document?
+ </b></font>
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
+</p>
+<a name="faq-12">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ How can I suggest improvements to existing FAQs?
+ </b></font>
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Given the rapid pace of change with Cocoon, many individual FAQs quickly become out-of-date and confusing to new users. If you have the relevant knowledge, please consider updating other FAQs on this page for technical errors. If you see a few typos, please consider fixing them too. Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
+</p>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
+</tr>
+<tr>
+<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright © 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
+</tr>
+</table>
+</body>
+</html>