You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by jo...@apache.org on 2003/07/11 02:32:55 UTC

cvs commit: cocoon-site/site/2.1/userdocs/generators xpathdirectory-generator.html xpathdirectory-generator.pdf directory-generator.html directory-generator.pdf error-generator.html error-generator.pdf extractor-generator.html extractor-generator.pdf file-generator.html file-generator.pdf generators.html generators.pdf html-generator.html html-generator.pdf imagedirectory-generator.html imagedirectory-generator.pdf jsp-generator.html jsp-generator.pdf linkstatus-generator.html linkstatus-generator.pdf php-generator.html php-generator.pdf profile-generator.html profile-generator.pdf request-generator.html request-generator.pdf script-generator.html script-generator.pdf search-generator.html search-generator.pdf serverpages-generator.html serverpages-generator.pdf status-generator.html status-generator.pdf stream-generator.html stream-generator.pdf telnet.txt velocity-generator.html velocity-generator.pdf wsproxy-generator.html wsproxy-generator.pdf xmldb-generator.html xmldb-generator.pdf xmldbcollection-generator.html xmldbcollection-generator.pdf

joerg       2003/07/10 17:32:54

  Modified:    site/2.1/userdocs/generators directory-generator.html
                        directory-generator.pdf error-generator.html
                        error-generator.pdf extractor-generator.html
                        extractor-generator.pdf file-generator.html
                        file-generator.pdf generators.html generators.pdf
                        html-generator.html html-generator.pdf
                        imagedirectory-generator.html
                        imagedirectory-generator.pdf jsp-generator.html
                        jsp-generator.pdf linkstatus-generator.html
                        linkstatus-generator.pdf php-generator.html
                        php-generator.pdf profile-generator.html
                        profile-generator.pdf request-generator.html
                        request-generator.pdf script-generator.html
                        script-generator.pdf search-generator.html
                        search-generator.pdf serverpages-generator.html
                        serverpages-generator.pdf status-generator.html
                        status-generator.pdf stream-generator.html
                        stream-generator.pdf telnet.txt
                        velocity-generator.html velocity-generator.pdf
                        wsproxy-generator.html wsproxy-generator.pdf
                        xmldb-generator.html xmldb-generator.pdf
                        xmldbcollection-generator.html
                        xmldbcollection-generator.pdf
  Added:       site/2.1/userdocs/generators xpathdirectory-generator.html
                        xpathdirectory-generator.pdf
  Log:
  and the next directory (I don't want to search for the files on my disk, while I can have some online :)
  
  Revision  Changes    Path
  1.5       +479 -465  cocoon-site/site/2.1/userdocs/generators/directory-generator.html
  
  Index: directory-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/directory-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- directory-generator.html	21 May 2003 15:23:43 -0000	1.4
  +++ directory-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,465 +1,479 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Directory Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Directory Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Directory Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="directory-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler,&nbsp;Frank Ridderbusch,&nbsp;John Morrison</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Directory+Generator">Directory Generator</a>
  -</li>
  -<li>
  -<a href="#Configuration">Configuration</a>
  -</li>
  -<li>
  -<a href="#DTD">DTD</a>
  -</li>
  -<li>
  -<a href="#Example">Example</a>
  -</li>
  -</ul>
  -        
  -<a name="N10024"></a><a name="Directory+Generator"></a>
  -<h3>Directory Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>Generates an XML directory listing.</p>
  -<p>The root node of the generated document will normally be a
  -                <span class="codefrag">directory</span> node, and a directory node can contain
  -                zero or more <span class="codefrag">file</span> or <span class="codefrag">directory</span> nodes.
  -                A file node has no children. Each node will contain the
  -                following attributes:
  -            </p>
  -<ul>
  -                
  -<li>name : the name of the file or directory</li>
  -                
  -<li>lastModified : the time the file was last modified,
  -                    measured as the number of milliseconds since the epoch (as
  -                    in java.io.File.lastModified)</li>
  -                
  -<li>size : the file size in bytes (as returned by
  -                    java.io.File.length)</li>
  -                
  -<li>date (optional) : the time the file was last modified in
  -                    human-readable form</li>
  -            
  -</ul>
  -<p>All generated elements have the namespace
  -                <span class="codefrag">http://apache.org/cocoon/directory/2.0</span>. The root
  -                <span class="codefrag">directory</span> node has the attribute
  -                <span class="codefrag">requested</span> with the value <span class="codefrag">true</span>. The
  -                sort order is described by the attribute <span class="codefrag">sort</span>,
  -                which defaults to sorting according to <span class="codefrag">name</span>.
  -            </p>
  -<ul>
  -                
  -<li>Name : directory</li>
  -                
  -<li>Class: org.apache.cocoon.generation.DirectoryGenerator</li>
  -                
  -<li>Cacheable: no.</li>
  -            
  -</ul>
  -<pre class="code">
  -&lt;map:generate type="directory" src="the_directory"/&gt;</pre>
  -</div>
  -        
  -<a name="N1006E"></a><a name="Configuration"></a>
  -<h3>Configuration</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The following parameter can be specified in the pipeline for the
  -                generate command:
  -            </p>
  -<ul>
  -                
  -<li>depth (optional) : Sets how deep Directory Generator should
  -                    delve into the directory structure. If set to 1 (the
  -                    default), only the starting directory's immediate contents
  -                    will be returned.</li>
  -                
  -<li>dateFormat (optional) :  Sets the format for the date
  -                    attribute of each node, as described in
  -                    java.text.SimpleDateFormat. If unset, the default format
  -                    for the current locale will be used.</li>
  -                
  -<li>root (optional) : The root pattern. This is a regular
  -                    expression as described
  -                    <a href="http://jakarta.apache.org/regexp/apidocs/org/apache/regexp/RE.html">here.</a>
  -</li>
  -                
  -<li>include (optional) : The include pattern. Also a
  -                    regular expression.</li>
  -                
  -<li>exclude (optional) : The exclude pattern. Also a
  -                    regular expression.</li>
  -                
  -<li>sort (optional) : This parameter determines the order in
  -                    which the <span class="codefrag">file</span> and <span class="codefrag">directory</span> nodes
  -                    are returned. Default sort order is as defined by the
  -                    system. Possible values are "name", "size", "time", and
  -                    "directory". "directory" is the same as "name", except that
  -                    directory entries are listed first.</li>
  -                
  -<li>reverse (optional) : This parameter reverses the sort order.
  -                    reverse="false" is the default.</li>
  -            
  -</ul>
  -</div>
  -        
  -<a name="N10098"></a><a name="DTD"></a>
  -<h3>DTD</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>XML generated by directory generator uses namespace
  -                <span class="codefrag">http://apache.org/cocoon/status/2.0</span>. The DTD
  -                of XML generated by directory generator:
  -            </p>
  -<pre class="code">
  -&lt;!ELEMENT directory (directory|file)*&gt;
  -&lt;!ATTLIST directory
  -    name         CDATA #REQUIRED
  -    lastModified CDATA #REQUIRED
  -    date         CDATA #IMPLIED
  -    size         CDATA #IMPLIED
  -    sort         CDATA #IMPLIED
  -    reverse      CDATA #IMPLIED
  -    requested    CDATA #IMPLIED&gt;
  -
  -&lt;!ELEMENT file #EMPTY&gt;
  -&lt;!ATTLIST file
  -    name         CDATA #REQUIRED
  -    lastModified CDATA #REQUIRED
  -    date         CDATA #IMPLIED
  -    size         CDATA #IMPLIED&gt;
  -</pre>
  -</div>
  -        
  -<a name="N100A9"></a><a name="Example"></a>
  -<h3>Example</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The current directory generator may generate following xml:</p>
  -<pre class="code">
  -&lt;dir:directory xmlns:dir="http://apache.org/cocoon/directory/2.0"
  -    name="stylesheets"
  -    lastModified="1019666489000"
  -    date="24.04.02 18:41"
  -    size="461"
  -    sort="name"
  -    reverse="false"
  -    requested="true"&gt;
  -    &lt;dir:directory name="sites" lastModified="1019666489000"
  -        date="24.04.02 18:41" size="118"/&gt;
  -    &lt;dir:file name="dynamic-page2html.xsl" lastModified="1019666489000"
  -        date="24.04.02 18:41" size="1832"/&gt;
  -    &lt;dir:file name="simple-xml2html.xsl" lastModified="1019666489000"
  -        date="24.04.02 18:41" size="12676"/&gt;
  -&lt;/dir:directory&gt;
  -            </pre>
  -</div>
  -    
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Directory Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Directory Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Directory Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="directory-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler,&nbsp;Frank Ridderbusch,&nbsp;John Morrison,&nbsp;J&ouml;rg Heinicke</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Directory+Generator">Directory Generator</a>
  +</li>
  +<li>
  +<a href="#Configuration">Configuration</a>
  +</li>
  +<li>
  +<a href="#DTD">DTD</a>
  +</li>
  +<li>
  +<a href="#Example">Example</a>
  +</li>
  +</ul>
  +    
  +<a name="N10028"></a><a name="Directory+Generator"></a>
  +<h3>Directory Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>Generates an XML directory listing.</p>
  +<ul>
  +        
  +<li>Name: directory</li>
  +        
  +<li>Class: org.apache.cocoon.generation.DirectoryGenerator</li>
  +        
  +<li>Cacheable: yes</li>
  +      
  +</ul>
  +<p>The root node of the generated document will normally be a <span class="codefrag">directory</span> node. A
  +          directory node can contain zero or more <span class="codefrag">file</span> or <span class="codefrag">directory</span> nodes.
  +          A file node has no children. All generated elements have the namespace
  +          <span class="codefrag">http://apache.org/cocoon/directory/2.0</span>.
  +      </p>
  +<p>Each node will contain the following attributes:</p>
  +<ul>
  +        
  +<li>
  +<span class="codefrag">name</span>: the name of the file or directory.</li>
  +        
  +<li>
  +<span class="codefrag">lastModified</span>: the time the file was last modified, measured as the number
  +            of milliseconds since the epoch (as in <span class="codefrag">java.io.File.lastModified</span>).</li>
  +        
  +<li>
  +<span class="codefrag">date</span>: the time the file was last modified in human-readable form.</li>
  +        
  +<li>
  +<span class="codefrag">size</span>: the file size (or 0 for directories).</li>
  +      
  +</ul>
  +<p>Additionally the node for the requested directory has the attributes:</p>
  +<ul>
  +        
  +<li>
  +<span class="codefrag">requested</span>: with the value set to <span class="codefrag">true</span>.</li>
  +        
  +<li>
  +<span class="codefrag">sort</span>: the sort order of the <span class="codefrag">file</span> and <span class="codefrag">directory</span>
  +                               nodes.</li>
  +        
  +<li>
  +<span class="codefrag">reverse</span>: determines whether reverse sort was chosen.</li>
  +      
  +</ul>
  +<p>This node needs not to be the root node as you will see later.</p>
  +</div>
  +    
  +<a name="N1008A"></a><a name="Configuration"></a>
  +<h3>Configuration</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<pre class="code">
  +  &lt;map:generate type="directory" src="the/requested/directory"&gt;
  +    &lt;map:parameter name="depth" value="2"/&gt;
  +  &lt;/map:generate&gt;
  +      </pre>
  +<p>The <span class="codefrag">src</span> attribute on the <span class="codefrag">&lt;map:generate/&gt;</span> must be set to the
  +          directory the XML listing should be created of. This is the <em>requested</em> directory.
  +      </p>
  +<p>The following parameter are all optional and can be specified in the pipeline for the
  +          generate command (as seen in the example above for the parameter <span class="codefrag">depth</span>):
  +      </p>
  +<ul>
  +        
  +<li>depth: Sets how deep Directory Generator should delve into the directory structure. If
  +            set to 1 (the default), only the starting directory's immediate contents will be
  +            returned.</li>
  +        
  +<li>dateFormat: Sets the format for the date attribute of each node as described in
  +            <span class="codefrag">java.text.SimpleDateFormat</span>. If unset, the default format for the current
  +            locale will be used.</li>
  +        
  +<li>refreshDelay: Sets the delay (in seconds, default is 1) between checks for updates on
  +            the file system. So this option influences the caching of the directory listing.</li>
  +        
  +<li>sort: Sets the sort order in which the <span class="codefrag">file</span> and <span class="codefrag">directory</span>
  +            nodes are returned. Possible values are <span class="codefrag">name</span>, <span class="codefrag">size</span>,
  +            <span class="codefrag">time</span> and <span class="codefrag">directory</span> (where <span class="codefrag">directory</span> is the same
  +            as <span class="codefrag">name</span>, except that directory entries are listed first). The default sort
  +            order is <span class="codefrag">name</span>.</li>
  +        
  +<li>reverse: Reverses the sort order, defaults to <span class="codefrag">false</span>.</li>
  +        
  +<li>root: The root pattern. From the requested director upwards a directory is searched
  +            using this pattern, that is added as root node to the document. The path from this root
  +            node down to the requested directory will also be in the output. If no root pattern is
  +            specified or no ancestor of the requested directory matches this pattern, the requested
  +            directory will be the root in the output document.<br>
  +            The pattern is a regular expression as described in the API docs of the
  +            <a href="http://jakarta.apache.org/regexp/apidocs/org/apache/regexp/RE.html">
  +            Apache RegExp project</a>.</li>
  +        
  +<li>include: The include pattern. Specifies the directories and files that should be
  +            included. Also a regular expression.</li>
  +        
  +<li>exclude: The exclude pattern. Specifies the directories and files that should be
  +            excluded. Also a regular expression.</li>
  +      
  +</ul>
  +</div>
  +    
  +<a name="N100E9"></a><a name="DTD"></a>
  +<h3>DTD</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>XML generated by Directory Generator uses namespace
  +          <span class="codefrag">http://apache.org/cocoon/status/2.0</span>. The DTD of XML generated by Directory
  +          Generator:
  +      </p>
  +<pre class="code">
  +  &lt;!ELEMENT directory (directory|file)*&gt;
  +  &lt;!ATTLIST directory
  +    name         CDATA #REQUIRED
  +    lastModified CDATA #REQUIRED
  +    date         CDATA #REQUIRED
  +    size         CDATA #REQUIRED
  +    requested    CDATA #IMPLIED
  +    sort         CDATA #IMPLIED
  +    reverse      CDATA #IMPLIED&gt;
  +
  +  &lt;!ELEMENT file #EMPTY&gt;
  +  &lt;!ATTLIST file
  +    name         CDATA #REQUIRED
  +    lastModified CDATA #REQUIRED
  +    date         CDATA #REQUIRED
  +    size         CDATA #REQUIRED&gt;
  +      </pre>
  +</div>
  +    
  +<a name="N100FA"></a><a name="Example"></a>
  +<h3>Example</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The current Directory Generator may generate following xml:</p>
  +<pre class="code">
  +&lt;dir:directory xmlns:dir="http://apache.org/cocoon/directory/2.0"
  +    name="stylesheets" lastModified="1056668768203" date="27.06.03 01:06" size="0"
  +    requested="true" sort="name" reverse="false"&gt;
  +  &lt;dir:directory name="sites" lastModified="1056668768203" date="27.06.03 01:06" size="0"/&gt;
  +  &lt;dir:file name="dynamic-page2html.xsl" lastModified="1056668768203" date="27.06.03 01:06" size="0"/&gt;
  +  &lt;dir:file name="simple-xml2html.xsl" lastModified="1056668768203" date="27.06.03 01:06" size="1234"/&gt;
  +&lt;/dir:directory&gt;
  +      </pre>
  +</div>
  +  
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +99 -103   cocoon-site/site/2.1/userdocs/generators/directory-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +443 -439  cocoon-site/site/2.1/userdocs/generators/error-generator.html
  
  Index: error-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/error-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- error-generator.html	21 May 2003 15:23:43 -0000	1.4
  +++ error-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,439 +1,443 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Error Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Error Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Error Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="error-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Bernhard Huber</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Error+Generator">Error Generator</a>
  -</li>
  -<li>
  -<a href="#DTD">DTD</a>
  -</li>
  -<li>
  -<a href="#Example">Example</a>
  -</li>
  -</ul>
  -  
  -<a name="N1001C"></a><a name="Error+Generator"></a>
  -<h3>Error Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -    The error generator creates xml content describing an error condition.
  -    When an error occurs in a pipeline with a defined an error handler, the
  -    sitemap manager activates the error generator, feeding it the cause of
  -    the error. 
  -   </p>
  -<ul>
  -    
  -<li>Name : !error-notifier!</li>
  -    
  -<li>Class: org.apache.cocoon.sitemap.ErrorNotifier</li>
  -    
  -<li>Cacheable: no.</li>
  -    
  -<li>Mode: sitemap internal</li>
  -   
  -</ul>
  -</div>
  -  
  -<a name="N10034"></a><a name="DTD"></a>
  -<h3>DTD</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -    XML generated by error generator uses the 
  -    namespace <span class="codefrag">http://apache.org/cocoon/error/2.0</span> and
  -    the <span class="codefrag">error</span> prefix.
  -   </p>
  -<p>
  -    Usually the error condition is described by a throwable object.
  -    The information of this throwable object is used by the
  -    error generator to produce the xml content.
  -    The various elements of the xml content include the following.
  -   </p>
  -<ul>
  -    
  -<li>
  -     The element <span class="codefrag">notify</span> is the root element, having
  -     attributes <span class="codefrag">type</span> and <span class="codefrag">sender</span>.
  -     The attribute <span class="codefrag">type</span> has fixed value <span class="codefrag">error</span>.
  -     The attribute <span class="codefrag">sender</span> describes the sender of the
  -     error notification object. In the current implementation, it has 
  -     fixed value <span class="codefrag">org.apache.cocoon.sitemap.ErrorNotifier</span>.
  -    </li>
  -    
  -<li>
  -     The element <span class="codefrag">title</span> stores the title of the eror notification.
  -     In the current implementation, it has fixed value <span class="codefrag">Cocoon error</span>.
  -    </li>
  -    
  -<li>
  -     The <span class="codefrag">source</span> element stores the class name of the throwable object
  -     of the error notification.
  -    </li>
  -    
  -<li>
  -     The <span class="codefrag">message</span> element stores the <span class="codefrag">getMessage()</span> result 
  -     of the throwable object of the error notification, and may be empty.
  -    </li>
  -    
  -<li>
  -     The <span class="codefrag">description</span> element stores the <span class="codefrag">toString()</span> result 
  -     of the throwable object of the error notification.
  -    </li>
  -    
  -<li>
  -     Optional <span class="codefrag">extra</span> elements stores nested exceptions
  -     of the throwable object of the error notification.
  -    </li>
  -   
  -</ul>
  -<pre class="code">
  -&lt;!ELEMENT notify (title, source, message, description, extra*)&gt;
  -&lt;!ATTLIST notiy 
  -  type CDATA #REQUIRED
  -  sender CDATA #REQUIRED
  -&gt;
  -&lt;!ELEMENT title #PCDATA&gt;
  -&lt;!ELEMENT source #PCDATA&gt;
  -&lt;!ELEMENT message #PCDATA&gt;
  -&lt;!ELEMENT description #PCDATA&gt;
  -&lt;!ELEMENT extra #PCDATA&gt;
  -&lt;!ATTLIST extra description #CDATA&gt;
  -&lt;!ELEMENT statusinfo (group|value)*&gt;
  -</pre>
  -</div>
  -  
  -<a name="N1008D"></a><a name="Example"></a>
  -<h3>Example</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -    The following example outputs the xml content of 
  -    an error generator:
  -   </p>
  -<pre class="code">
  -&lt;?xml version="1.0"
  - xmlns:error="http://apache.org/cocoon/error/2.0
  - encoding="UTF-8"?&gt;
  - 
  -&lt;error:notify
  - error:type="error" 
  - error:sender="org.apache.cocoon.sitemap.ErrorNotifier"&gt;
  - 
  - &lt;error:title&gt;Cocoon error&lt;/error:title&gt;
  - &lt;error:source&gt;java.lang.NullPointerException&lt;/error:source&gt;
  - &lt;error:message&gt;&lt;/error:message&gt;
  - &lt;error:description&gt;&lt;/error:description&gt;
  - &lt;error:extra description=""&gt;&lt;/error:extra&gt;
  -&lt;/error:notify&gt;
  -</pre>
  -</div>
  - 
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Notifying Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Notifying Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Notifying Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="error-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Bernhard Huber</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Notifying+Generator">Notifying Generator</a>
  +</li>
  +<li>
  +<a href="#DTD">DTD</a>
  +</li>
  +<li>
  +<a href="#Example">Example</a>
  +</li>
  +</ul>
  +  
  +<a name="N1001C"></a><a name="Notifying+Generator"></a>
  +<h3>Notifying Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +    The notifying generator creates XML content describing an error condition.
  +    When an error occurs in a pipeline with a defined an error handler, the
  +    sitemap manager activates the error generator, feeding it the cause of
  +    the error. 
  +   </p>
  +<ul>
  +    
  +<li>Name : &lt;notifier&gt;</li>
  +    
  +<li>Class: org.apache.cocoon.sitemap.NotifyingGenerator</li>
  +    
  +<li>Cacheable: No.</li>
  +    
  +<li>Mode: Sitemap internal</li>
  +   
  +</ul>
  +</div>
  +  
  +<a name="N10034"></a><a name="DTD"></a>
  +<h3>DTD</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +    XML generated by notifying generator uses the 
  +    namespace <span class="codefrag">http://apache.org/cocoon/error/2.0</span> and
  +    the <span class="codefrag">error</span> prefix.
  +   </p>
  +<p>
  +    Usually the error condition is described by a throwable object.
  +    The information of this throwable object is used by the
  +    error generator to produce the xml content.
  +    The various elements of the xml content include the following.
  +   </p>
  +<ul>
  +    
  +<li>
  +     The element <span class="codefrag">notify</span> is the root element, having
  +     attributes <span class="codefrag">type</span> and <span class="codefrag">sender</span>.
  +     The attribute <span class="codefrag">type</span> has fixed value <span class="codefrag">error</span>.
  +     The attribute <span class="codefrag">sender</span> describes the sender of the
  +     error notification object. In the current implementation, it has 
  +     fixed value <span class="codefrag">org.apache.cocoon.sitemap.ErrorNotifier</span>.
  +    </li>
  +    
  +<li>
  +     The element <span class="codefrag">title</span> stores the title of the eror notification.
  +     In the current implementation, it has fixed value <span class="codefrag">Cocoon error</span>.
  +    </li>
  +    
  +<li>
  +     The <span class="codefrag">source</span> element stores the class name of the throwable object
  +     of the error notification.
  +    </li>
  +    
  +<li>
  +     The <span class="codefrag">message</span> element stores the <span class="codefrag">getMessage()</span> result 
  +     of the throwable object of the error notification, and may be empty.
  +    </li>
  +    
  +<li>
  +     The <span class="codefrag">description</span> element stores the <span class="codefrag">toString()</span> result 
  +     of the throwable object of the error notification.
  +    </li>
  +    
  +<li>
  +     Optional <span class="codefrag">extra</span> elements stores nested exceptions
  +     of the throwable object of the error notification.
  +    </li>
  +   
  +</ul>
  +<pre class="code">
  +&lt;!ELEMENT notify (title, source, message, description, extra*)&gt;
  +&lt;!ATTLIST notiy 
  +  type CDATA #REQUIRED
  +  sender CDATA #REQUIRED
  +&gt;
  +&lt;!ELEMENT title #PCDATA&gt;
  +&lt;!ELEMENT source #PCDATA&gt;
  +&lt;!ELEMENT message #PCDATA&gt;
  +&lt;!ELEMENT description #PCDATA&gt;
  +&lt;!ELEMENT extra #PCDATA&gt;
  +&lt;!ATTLIST extra description #CDATA&gt;
  +&lt;!ELEMENT statusinfo (group|value)*&gt;
  +</pre>
  +</div>
  +  
  +<a name="N1008D"></a><a name="Example"></a>
  +<h3>Example</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +    The following example outputs the xml content of 
  +    an error generator:
  +   </p>
  +<pre class="code">
  +&lt;?xml version="1.0"
  + xmlns:error="http://apache.org/cocoon/error/2.0
  + encoding="UTF-8"?&gt;
  + 
  +&lt;error:notify
  + error:type="error" 
  + error:sender="org.apache.cocoon.sitemap.ErrorNotifier"&gt;
  + 
  + &lt;error:title&gt;Cocoon error&lt;/error:title&gt;
  + &lt;error:source&gt;java.lang.NullPointerException&lt;/error:source&gt;
  + &lt;error:message&gt;&lt;/error:message&gt;
  + &lt;error:description&gt;&lt;/error:description&gt;
  + &lt;error:extra description=""&gt;&lt;/error:extra&gt;
  +&lt;/error:notify&gt;
  +</pre>
  +</div>
  + 
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +60 -77    cocoon-site/site/2.1/userdocs/generators/error-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +347 -343  cocoon-site/site/2.1/userdocs/generators/extractor-generator.html
  
  Index: extractor-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/extractor-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- extractor-generator.html	21 May 2003 15:23:43 -0000	1.4
  +++ extractor-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,343 +1,347 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Fragment Extractor Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Fragment Extractor Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Fragment Extractor Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="extractor-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Fragment+Extractor+Generator">Fragment Extractor Generator</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Fragment+Extractor+Generator"></a>
  -<h3>Fragment Extractor Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p> FragmentExtractor is a transformer-generator pair which is designed to allow
  - sitemap managers to extract certain nodes from a SAX stream and move them
  - into a separate pipeline. The main use for this is to extract inline SVG
  - images and serve them up through a separate pipeline, usually serializing
  - them to PNG or JPEG format first.</p>
  -<ul>
  -				
  -<li>Name : extractor</li>
  -				
  -<li>Class: org.apache.cocoon.generation.FragmentExtractorGenerator</li>
  -				
  -<li>Cacheable: no.</li>
  -			
  -</ul>
  -<pre class="code">
  -     
  -  &lt;map:generate type="extractor"/&gt;
  -     
  -</pre>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Fragment Extractor Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Fragment Extractor Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Fragment Extractor Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="extractor-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Fragment+Extractor+Generator">Fragment Extractor Generator</a>
  +</li>
  +</ul>
  +		
  +<a name="N1001C"></a><a name="Fragment+Extractor+Generator"></a>
  +<h3>Fragment Extractor Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p> FragmentExtractor is a transformer-generator pair which is designed to allow
  + sitemap managers to extract certain nodes from a SAX stream and move them
  + into a separate pipeline. The main use for this is to extract inline SVG
  + images and serve them up through a separate pipeline, usually serializing
  + them to PNG or JPEG format first.</p>
  +<ul>
  +				
  +<li>Name : extractor</li>
  +				
  +<li>Class: org.apache.cocoon.generation.FragmentExtractorGenerator</li>
  +				
  +<li>Cacheable: no.</li>
  +			
  +</ul>
  +<pre class="code">
  +     
  +  &lt;map:generate type="extractor"/&gt;
  +     
  +</pre>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +43 -60    cocoon-site/site/2.1/userdocs/generators/extractor-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +353 -349  cocoon-site/site/2.1/userdocs/generators/file-generator.html
  
  Index: file-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/file-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- file-generator.html	21 May 2003 15:23:43 -0000	1.4
  +++ file-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,349 +1,353 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>File Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">File Generator</font></span>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>File Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="file-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#File+Generator">File Generator</a>
  -</li>
  -</ul>
  -		 
  -<a name="N1001C"></a><a name="File+Generator"></a>
  -<h3>File Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The file generator reads an xml document from the local file system or from any url.
  -	               While url generator may appear to be a more suitable name, it's known as the file generator for historical reasons.</p>
  -<p>The file generator is the default generator.</p>
  -<ul>
  -				
  -<li>Name : file</li>
  -				
  -<li>Class: org.apache.cocoon.generation.FileGenerator</li>
  -				
  -<li>Cacheable: yes - uses the last modification date of the xml document for validation.</li>
  -			
  -</ul>
  -<p>The location of the source xml document is specified in
  -                     the pipeline by the src attribute.</p>
  -<pre class="code">
  -     
  -  &lt;map:generate src="document.xml" type="file"/&gt;
  -  &lt;!-- The type attribute can be omitted as it is the default generator. --&gt;
  -     
  -</pre>
  -<p>
  -    You can use an absolute filesystem pathname. See the explanation of
  -    <a href="../concepts/sitemap.html#file-url">file: URLs</a>
  -   
  -</p>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>File Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">File Generator</font></span>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>File Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="file-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#File+Generator">File Generator</a>
  +</li>
  +</ul>
  +		 
  +<a name="N1001C"></a><a name="File+Generator"></a>
  +<h3>File Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The file generator reads an xml document from the local file system or from any url.
  +	               While url generator may appear to be a more suitable name, it's known as the file generator for historical reasons.</p>
  +<p>The file generator is the default generator.</p>
  +<ul>
  +				
  +<li>Name : file</li>
  +				
  +<li>Class: org.apache.cocoon.generation.FileGenerator</li>
  +				
  +<li>Cacheable: yes - uses the last modification date of the xml document for validation.</li>
  +			
  +</ul>
  +<p>The location of the source xml document is specified in
  +                     the pipeline by the src attribute.</p>
  +<pre class="code">
  +     
  +  &lt;map:generate src="document.xml" type="file"/&gt;
  +  &lt;!-- The type attribute can be omitted as it is the default generator. --&gt;
  +     
  +</pre>
  +<p>
  +    You can use an absolute filesystem pathname. See the explanation of
  +    <a href="../concepts/sitemap.html#file-url">file: URLs</a>
  +   
  +</p>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +53 -83    cocoon-site/site/2.1/userdocs/generators/file-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +434 -424  cocoon-site/site/2.1/userdocs/generators/generators.html
  
  Index: generators.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/generators.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- generators.html	21 May 2003 15:23:44 -0000	1.4
  +++ generators.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,424 +1,434 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Generators in Cocoon</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Overview</font></span>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Generators in Cocoon</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="generators.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Goal">Goal</a>
  -</li>
  -<li>
  -<a href="#Overview">Overview</a>
  -</li>
  -<li>
  -<a href="#The+Generators+in+Apache+Cocoon">The Generators in Apache Cocoon</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Goal"></a>
  -<h3>Goal</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>This document lists all of the available generators of Apache Cocoon and
  -                     describes their purpose.</p>
  -</div>
  -		 
  -<a name="N10025"></a><a name="Overview"></a>
  -<h3>Overview</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>A generator is the starting point of an xml pipeline. It generates XML content as SAX events and initializes pipeline processing. Every pipeline match containing a generator must be terminated by a serializer.
  -  </p>
  -<p>
  -In the sitemap file, each generator has a unique name which is mapped to a java class. One generator name must be declared as the default generator. Each generator may have additional configuration information specified in child elements.
  -  </p>
  -<p>
  -For conceptual information on generators see the user's guide document <a href="../concepts/sitemap.html">The Sitemap</a>.
  -  </p>
  -</div>
  -		 
  -<a name="N10038"></a><a name="The+Generators+in+Apache+Cocoon"></a>
  -<h3>The Generators in Apache Cocoon</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<ul>
  -				
  -<li>
  -<a href="file-generator.html">File Generator</a> (The default generator)</li>
  -				
  -<li>
  -<a href="html-generator.html">HTML Generator</a> (optional)</li>
  -				
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -				
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -				
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -				
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -				
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -				
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -				
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -				
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -				
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -				
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -				
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -				
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -				
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -				
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -				
  -<li>
  -<a href="php-generator.html">Php Generator</a> (optional)</li>
  -				
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a> (optional)</li>
  -				
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a> (optional)</li>
  -			
  -</ul>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Generators in Cocoon</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Overview</font></span>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Generators in Cocoon</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="generators.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Goal">Goal</a>
  +</li>
  +<li>
  +<a href="#Overview">Overview</a>
  +</li>
  +<li>
  +<a href="#The+Generators+in+Apache+Cocoon">The Generators in Apache Cocoon</a>
  +</li>
  +</ul>
  +    
  +<a name="N1001C"></a><a name="Goal"></a>
  +<h3>Goal</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>This document lists all of the available generators of Apache Cocoon and describes their
  +       purpose.</p>
  +</div>
  +    
  +<a name="N10025"></a><a name="Overview"></a>
  +<h3>Overview</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>A generator is the starting point of an xml pipeline. It generates XML content as SAX
  +        events and initializes pipeline processing. Every pipeline match containing a generator
  +        must be terminated by a serializer.
  +      </p>
  +<p>In the sitemap file, each generator has a unique name which is mapped to a Java class. One
  +        generator name must be declared as the default generator. Each generator may have additional
  +        configuration information specified in child elements.
  +      </p>
  +<p>For conceptual information on generators see the user's guide document
  +        <a href="../concepts/sitemap.html">The Sitemap</a>.
  +      </p>
  +</div>
  +    
  +<a name="N10038"></a><a name="The+Generators+in+Apache+Cocoon"></a>
  +<h3>The Generators in Apache Cocoon</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<ul>
  +        
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +        
  +<li>
  +<a href="file-generator.html">File Generator</a> (The default generator)</li>
  +        
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a> (optional: Batik block)</li>
  +        
  +<li>
  +<a href="html-generator.html">HTML Generator</a> (optional: HTML block)</li>
  +        
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +        
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a> (optional: JSP block)</li>
  +        
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +        
  +<li>MP3 Directory Generator (no documentation exists)</li>
  +        
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +        
  +<li>
  +<a href="php-generator.html">Php Generator</a> (optional: PHP block)</li>
  +        
  +<li>
  +<a href="profile-generator.html">Profile Generator</a> (optional: Profiler block)</li>
  +        
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +        
  +<li>
  +<a href="script-generator.html">Script Generator</a> (optional: BSF block)</li>
  +        
  +<li>
  +<a href="search-generator.html">Search Generator</a> (optional: Lucene block)</li>
  +        
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +        
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +        
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +        
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a> (optional: Velocity block)</li>
  +        
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a> (optional: Proxy block)</li>
  +        
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a> (optional: XMLDB block)</li>
  +        
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a> (optional: XMLDB block)</li>
  +        
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +      
  +</ul>
  +</div>
  +  
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +156 -693  cocoon-site/site/2.1/userdocs/generators/generators.pdf
  
  	<<Binary file>>
  
  
  1.5       +390 -386  cocoon-site/site/2.1/userdocs/generators/html-generator.html
  
  Index: html-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/html-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- html-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ html-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,386 +1,390 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>HTML Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">HTML Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>HTML Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="html-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler,&nbsp;Sylvain Wallez,&nbsp;Gianugo Rabellino </font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#HTML+Generator">HTML Generator</a>
  -</li>
  -<li>
  -<a href="#Configuring+JTidy">Configuring JTidy</a>
  -</li>
  -</ul>
  -		
  -<a name="N10024"></a><a name="HTML+Generator"></a>
  -<h3>HTML Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The html generator reads an html document from the local file system or from any url.
  -	               It acts similar to the file generator with the difference that it reads
  -                     html documents and converts them using <a href="http://sourceforge.net/projects/jtidy">JTidy</a>
  -                     to xhtml.</p>
  -<p>This generator is optional and requires the jtidy package
  -                     in the lib directory when building Cocoon. However,
  -                     the distribution includes this package already.</p>
  -<ul>
  -				
  -<li>Name : html</li>
  -				
  -<li>Class: org.apache.cocoon.generation.HTMLGenerator</li>
  -				
  -<li>Cacheable: yes - uses the last modification date of the html document for validation.</li>
  -			
  -</ul>
  -<p>The location of the source html document is specified in
  -                     the pipeline by the src attribute.</p>
  -<pre class="code">
  -   
  -  &lt;map:generate src="document.html" type="html"/&gt;
  -     
  -</pre>
  -<p>The html generator, however, can operate also on a request
  -      attribute or on a XML POST request. This can be done also by the
  -      <a href="stream-generator.html">stream generator</a>, with whom
  -      it shares the syntax: the added bonus here is that you can
  -      "sanitize" a possibly non well-formed XML snippet for further
  -      reuse later. In order to use this feature for request attributes, 
  -      just omit the "src" attribute and set a parameter like the following 
  -      one in the sitemap:</p>
  -<pre class="code">
  -
  -  &lt;map:parameter name="form-name" value="my-request-attribute"/&gt;
  -
  -</pre>
  -</div>
  -		
  -<a name="N10054"></a><a name="Configuring+JTidy"></a>
  -<h3>Configuring JTidy</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>Without any configuration, the generator produces an XHTML document, with the proper namespace. However,
  -		     JTidy offers a full range of options for converting the HTML document to XML.</p>
  -<p>These options can be specified in a properties file (key=value pairs) whose location is given in the
  -		     component configuration :</p>
  -<pre class="code">
  -		    
  -  &lt;map:generator type="html" src="org.apache.cocoon.generation.HTMLGenerator"&gt;
  -    &lt;jtidy-config&gt;jtidy.properties&lt;/jtidy-config&gt;
  -  &lt;/map:generator&gt;
  -		    
  -		  </pre>
  -<p>The <span class="codefrag">jtidy-config</span> URL can be either relative (to the application context), one of Cocoon's special
  -		     protocols such as <span class="codefrag">resouce:</span> which searches the file in the classpath.</p>
  -<p>For more information on the available configurations, please refer to the
  -		     <a href="http://www.w3.org/People/Raggett/tidy/">original Tidy page</a>. Beware that configuration
  -		     examples shown there use the ':' as a separator when JTidy requires a '=' as it is a standard Java properties file.
  -		  </p>
  -</div>
  -
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>HTML Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">HTML Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>HTML Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="html-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler,&nbsp;Sylvain Wallez,&nbsp;Gianugo Rabellino </font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#HTML+Generator">HTML Generator</a>
  +</li>
  +<li>
  +<a href="#Configuring+JTidy">Configuring JTidy</a>
  +</li>
  +</ul>
  +		
  +<a name="N10024"></a><a name="HTML+Generator"></a>
  +<h3>HTML Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The html generator reads an html document from the local file system or from any url.
  +	               It acts similar to the file generator with the difference that it reads
  +                     html documents and converts them using <a href="http://sourceforge.net/projects/jtidy">JTidy</a>
  +                     to xhtml.</p>
  +<p>This generator is optional and requires the jtidy package
  +                     in the lib directory when building Cocoon. However,
  +                     the distribution includes this package already.</p>
  +<ul>
  +				
  +<li>Name : html</li>
  +				
  +<li>Class: org.apache.cocoon.generation.HTMLGenerator</li>
  +				
  +<li>Cacheable: yes - uses the last modification date of the html document for validation.</li>
  +			
  +</ul>
  +<p>The location of the source html document is specified in
  +                     the pipeline by the src attribute.</p>
  +<pre class="code">
  +   
  +  &lt;map:generate src="document.html" type="html"/&gt;
  +     
  +</pre>
  +<p>The html generator, however, can operate also on a request
  +      attribute or on a XML POST request. This can be done also by the
  +      <a href="stream-generator.html">stream generator</a>, with whom
  +      it shares the syntax: the added bonus here is that you can
  +      "sanitize" a possibly non well-formed XML snippet for further
  +      reuse later. In order to use this feature for request attributes, 
  +      just omit the "src" attribute and set a parameter like the following 
  +      one in the sitemap:</p>
  +<pre class="code">
  +
  +  &lt;map:parameter name="form-name" value="my-request-attribute"/&gt;
  +
  +</pre>
  +</div>
  +		
  +<a name="N10054"></a><a name="Configuring+JTidy"></a>
  +<h3>Configuring JTidy</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>Without any configuration, the generator produces an XHTML document, with the proper namespace. However,
  +		     JTidy offers a full range of options for converting the HTML document to XML.</p>
  +<p>These options can be specified in a properties file (key=value pairs) whose location is given in the
  +		     component configuration :</p>
  +<pre class="code">
  +		    
  +  &lt;map:generator type="html" src="org.apache.cocoon.generation.HTMLGenerator"&gt;
  +    &lt;jtidy-config&gt;jtidy.properties&lt;/jtidy-config&gt;
  +  &lt;/map:generator&gt;
  +		    
  +		  </pre>
  +<p>The <span class="codefrag">jtidy-config</span> URL can be either relative (to the application context), one of Cocoon's special
  +		     protocols such as <span class="codefrag">resouce:</span> which searches the file in the classpath.</p>
  +<p>For more information on the available configurations, please refer to the
  +		     <a href="http://www.w3.org/People/Raggett/tidy/">original Tidy page</a>. Beware that configuration
  +		     examples shown there use the ':' as a separator when JTidy requires a '=' as it is a standard Java properties file.
  +		  </p>
  +</div>
  +
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +79 -161   cocoon-site/site/2.1/userdocs/generators/html-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +344 -394  cocoon-site/site/2.1/userdocs/generators/imagedirectory-generator.html
  
  Index: imagedirectory-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/imagedirectory-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- imagedirectory-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ imagedirectory-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,394 +1,344 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Image Directory Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Image Directory Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Image Directory Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="imagedirectory-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Image+Directory+Generator">Image Directory Generator</a>
  -</li>
  -<li>
  -<a href="#Configuration">Configuration</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Image+Directory+Generator"></a>
  -<h3>Image Directory Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>Generates an XML directory listing. This is an extension of
  -                     the <a href="directory-generator.html">Directory Generator</a>.
  -                     It checks if the contained files are images and adds their size
  -                     to the attributes.</p>
  -<p>
  - The root node of the generated document will normally be a
  - <span class="codefrag">directory</span> node, and a directory node can contain zero
  - or more <span class="codefrag">file</span> or <span class="codefrag">directory</span> nodes. A file node has no
  - children. Each node will contain the following attributes:</p>
  -<ul>
  -	
  -<li>name : the name of the file or directory</li>
  -      
  -<li>lastModified : the time the file was last modified, measured as the number of
  -   milliseconds since the epoch (as in java.io.File.lastModified)</li>
  -      
  -<li>date (optional) : the time the file was last modified in human-readable form</li>
  -      
  -<li>width (optional) : the width of the image if it is an image file</li>
  -      
  -<li>height (optional) : the height of the image if it is an image file</li>
  -      
  -<li>comment (optional) : the comment of the image if there is one inside the image file (jpeg only)</li>
  -   
  -</ul>
  -<p>All generated elements have the namespace
  -         <span class="codefrag">http://apache.org/cocoon/directory/2.0</span>. The root <span class="codefrag">directory</span>
  -         node has the attribute <span class="codefrag">requested</span> with the value <span class="codefrag">true</span>.</p>
  -<ul>
  -				
  -<li>Name : imagedirectory</li>
  -				
  -<li>Class: org.apache.cocoon.generation.ImageDirectoryGenerator</li>
  -				
  -<li>Cacheable: no.</li>
  -			
  -</ul>
  -<pre class="code">
  -     
  -  &lt;map:generate type="imagedirectory" src="the_directory"/&gt;
  -     
  -</pre>
  -</div>
  -
  -<a name="N1006A"></a><a name="Configuration"></a>
  -<h3>Configuration</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The following parameter can be specified in the pipeline for 
  -   the generate command:</p>
  -<ul>
  -
  -<li>depth (optional) : Sets how deep Image Directory Generator should delve into the
  - directory structure. If set to 1 (the default), only the starting
  - directory's immediate contents will be returned.</li>
  -
  -<li>dateFormat (optional) :  Sets the format for the date attribute of each node, as
  - described in java.text.SimpleDateFormat. If unset, the default
  - format for the current locale will be used.</li>
  -
  -<li>root (optional) : The root pattern</li>
  -
  -<li>include (optional) : The include pattern</li>
  -
  -<li>exclude (optional) : The exclude pattern</li>
  -
  -</ul>
  -</div>
  -
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Image Directory Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Image Directory Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Image Directory Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="imagedirectory-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Image+Directory+Generator">Image Directory Generator</a>
  +</li>
  +</ul>
  +    
  +<a name="N1001C"></a><a name="Image+Directory+Generator"></a>
  +<h3>Image Directory Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>Generates an XML directory listing. This is an extension of the
  +      	<a href="directory-generator.html">Directory Generator</a>.</p>
  +<ul>
  +        
  +<li>Name: imagedirectory</li>
  +        
  +<li>Class: org.apache.cocoon.generation.ImageDirectoryGenerator</li>
  +        
  +<li>Cacheable: yes</li>
  +      
  +</ul>
  +<p>The Image Directory provides all the functionality of the
  +      	<a href="directory-generator.html">Directory Generator</a>. Additionally it
  +        ensures that the files are images and adds their dimensions (<span class="codefrag">width</span>
  +        and <span class="codefrag">height</span>) to the attributes. It is configured in the same way as the
  +        Directory Generator.</p>
  +</div>
  +  
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +57 -107   cocoon-site/site/2.1/userdocs/generators/imagedirectory-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +482 -478  cocoon-site/site/2.1/userdocs/generators/jsp-generator.html
  
  Index: jsp-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/jsp-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- jsp-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ jsp-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,478 +1,482 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>JSP Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">JSP Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>JSP Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="jsp-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#JSP+Generator">JSP Generator</a>
  -</li>
  -<li>
  -<a href="#JSPEngine">JSPEngine</a>
  -<ul class="minitoc">
  -<li>
  -<a href="#JSPEngineImpl">JSPEngineImpl</a>
  -</li>
  -<li>
  -<a href="#JSPEngineImplWLS">JSPEngineImplWLS</a>
  -</li>
  -<li>
  -<a href="#JSPEngineImplNamedDispatcherInclude">JSPEngineImplNamedDispatcherInclude</a>
  -</li>
  -</ul>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="JSP+Generator"></a>
  -<h3>JSP Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The JspGenerator selects a JSPEngine component. The JSPEngine component
  -                          launches a JSP servlet engine of your servlet container, 
  -                          feeds the HttpRequest into the 
  -                          JSP servlet engine, and pipes the jsp response as SAX events into Cocoon.
  -                          The JSP page is specified by the HttpRequest.
  -                        </p>
  -<p>
  -                          This way you can continue to use your JSP pages. 
  -                          Your migration from JSP to XSP may be done step by step. 
  -                          You may specify your JSP pages either as JSP scriptlets or as JSP-XML.
  -                          But keep in mind that your JSP output should be valid XML.
  -                        </p>
  -<ul>
  -				
  -<li>Name : jsp</li>
  -				
  -<li>Class: org.apache.cocoon.generation.JspGenerator</li>
  -				
  -<li>Cacheable: ?.</li>
  -			
  -</ul>
  -<pre class="code">
  -&lt;map:generate type="jsp"/&gt;
  -</pre>
  -</div>
  -                
  -<a name="N10039"></a><a name="JSPEngine"></a>
  -<h3>JSPEngine</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>As JSP servlet engines are implemented differently, you may have to
  -                    select the appropriate JSPEngine component. 
  -                    The default is a JSPEngine working with Tomcat's JSP servlet engine Jasper.
  -                    You may override the cocoon.roles by your own my.roles, as described 
  -                    in the <a href="../../faq/index.html">FAQs</a>.
  -                  </p>
  -<p>The JSPEngine component of Tomcat's JSPEngine is implemented in JSPEngineImpl. 
  -                    If you want to use another JSPEngine component, you may specify it in a my.roles file.
  -                    The following sample specify in file WEB-INF/my.roles a JSPEngine workging with WebLogicServer:
  -                  </p>
  -<pre class="code">
  -&lt;?xml version="1.0"?&gt;
  -&lt;role-list&gt;
  -  &lt;role name="org.apache.cocoon.components.jsp.JSPEngine"
  -    shorthand="jsp-engine"
  -    default-class="org.apache.cocoon.components.jsp.JSPEngineImplWLS"/&gt;
  -&lt;/role-list&gt;
  -</pre>
  -<p>Defining the file my.roles this way you must ensure that your 
  -                    cocoon.xconf refernces my.roles, like that:
  -                  </p>
  -<pre class="code">
  -...
  -&lt;cocoon version="2.0" user-roles="WEB-INF/my.roles"&gt;
  -...
  -</pre>
  -<p>Currently there are tree JSPEngine components available:
  -                  </p>
  -<table class="ForrestTable" cellspacing="1" cellpadding="4">
  -                    
  -<tr>
  -<th colspan="1" rowspan="1">JSPEngine</th><th colspan="1" rowspan="1">ServletEngine</th>
  -</tr>
  -                    
  -<tr>
  -<td colspan="1" rowspan="1">JSPEngineImpl</td><td colspan="1" rowspan="1">Tomcat, generic jsp servlet class</td>
  -</tr>
  -                    
  -<tr>
  -<td colspan="1" rowspan="1">JSPEngineImplWLS</td><td colspan="1" rowspan="1">WebLogic 5.1, 6.0(?)</td>
  -</tr>
  -                    
  -<tr>
  -<td colspan="1" rowspan="1">JSPEngineImplNamedDispactcherInclude</td><td colspan="1" rowspan="1">Generic JSP Servlet</td>
  -</tr>
  -                  
  -</table>
  -<p>The next sections describe the settings of the JSPEngine components.
  -                  </p>
  -<a name="N10086"></a><a name="JSPEngineImpl"></a>
  -<h4>JSPEngineImpl</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>This JSPEngine is the default engine selected in cocoon.roles. 
  -                      By default it uses Tomcats' JASPER  JSP servlet engine.
  -                    </p>
  -<p>Running under a different JSP servlet engine, you can try to change the settings
  -                      in cocoon.xconf, by modifying parameter name servlet-class to your needs.
  -                    </p>
  -<pre class="code">
  -&lt;jsp-engine&gt;
  -  &lt;parameter name="servlet-class"
  -             value="my.servlet.MyJspServletOfMyServletEngine"/&gt;
  -&lt;/jsp-engine&gt;
  -</pre>
  -<p>JSPEngineImpl instances directly the JSP servlet engine class, and services
  -                      HttpRequest to this instance.
  -                    </p>
  -<p>JSPEngineImplNamedDispatcherInclude delegates the selection of a JSP servlet engine
  -                      instance to the servlet engine. It selects by servlet-name, and not by servlet-class.
  -                      This is the key differences of these two implementations.
  -                    </p>
  -</div>
  -<a name="N1009D"></a><a name="JSPEngineImplWLS"></a>
  -<h4>JSPEngineImplWLS</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>This JSPEngine is implemented especially for WebLogic 5.1. WebLogic 6.0, and WebLogic 6.1
  -                      may work, too. JSPEngineImplWLS finds the named request dispatch for jsp, the jsp response
  -                      is piped into Cocoon.
  -                    </p>
  -<p>The name of the JSP servlet is by default set to '*.jsp'. This is the default servlet name
  -                      of the JSP servlet engine under WLS. You may adopt the parameter servlet-name to your needs.
  -                    </p>
  -<p>If you want to specify a different JSP servlet name, you can change the settings
  -                      in cocoon.xconf, by modifying the parameter servlet-name.
  -                    </p>
  -<pre class="code">
  -&lt;jsp-engine&gt;
  -  &lt;parameter name="servlet-name"
  -             value="MyNameOfMyJspServletOfMyServletEngine"/&gt;
  -&lt;/jsp-engine&gt;
  -</pre>
  -</div>
  -<a name="N100B1"></a><a name="JSPEngineImplNamedDispatcherInclude"></a>
  -<h4>JSPEngineImplNamedDispatcherInclude</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>This JSPEngine is implemented like JSPEnginImplWLS without using any WebLogic classes.
  -                      You may try to use this JSPEngine if JSPEngineImpl does not meet your requirements.
  -                    </p>
  -<p>The name of the JSP servlet is by default set to '*.jsp'. This is the default servlet name
  -                      of the jsp servlet engine under WLS. You may adopt the parameter servlet-name to your needs.
  -                    </p>
  -<p>If you want to specify a different JSP servlet name, you can change the settings
  -                      in cocoon.xconf, by modifying the parameter servlet-name.
  -                    </p>
  -<pre class="code">
  -&lt;jsp-engine&gt;
  -  &lt;parameter name="servlet-name"
  -             value="MyNameOfMyJspServletOfMyServletEngine"/&gt;
  -&lt;/jsp-engine&gt;
  -</pre>
  -</div>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>JSP Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">JSP Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>JSP Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="jsp-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#JSP+Generator">JSP Generator</a>
  +</li>
  +<li>
  +<a href="#JSPEngine">JSPEngine</a>
  +<ul class="minitoc">
  +<li>
  +<a href="#JSPEngineImpl">JSPEngineImpl</a>
  +</li>
  +<li>
  +<a href="#JSPEngineImplWLS">JSPEngineImplWLS</a>
  +</li>
  +<li>
  +<a href="#JSPEngineImplNamedDispatcherInclude">JSPEngineImplNamedDispatcherInclude</a>
  +</li>
  +</ul>
  +</li>
  +</ul>
  +		
  +<a name="N1001C"></a><a name="JSP+Generator"></a>
  +<h3>JSP Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The JspGenerator selects a JSPEngine component. The JSPEngine component
  +                          launches a JSP servlet engine of your servlet container, 
  +                          feeds the HttpRequest into the 
  +                          JSP servlet engine, and pipes the jsp response as SAX events into Cocoon.
  +                          The JSP page is specified by the HttpRequest.
  +                        </p>
  +<p>
  +                          This way you can continue to use your JSP pages. 
  +                          Your migration from JSP to XSP may be done step by step. 
  +                          You may specify your JSP pages either as JSP scriptlets or as JSP-XML.
  +                          But keep in mind that your JSP output should be valid XML.
  +                        </p>
  +<ul>
  +				
  +<li>Name : jsp</li>
  +				
  +<li>Class: org.apache.cocoon.generation.JspGenerator</li>
  +				
  +<li>Cacheable: ?.</li>
  +			
  +</ul>
  +<pre class="code">
  +&lt;map:generate type="jsp"/&gt;
  +</pre>
  +</div>
  +                
  +<a name="N10039"></a><a name="JSPEngine"></a>
  +<h3>JSPEngine</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>As JSP servlet engines are implemented differently, you may have to
  +                    select the appropriate JSPEngine component. 
  +                    The default is a JSPEngine working with Tomcat's JSP servlet engine Jasper.
  +                    You may override the cocoon.roles by your own my.roles, as described 
  +                    in the <a href="../../faq/index.html">FAQs</a>.
  +                  </p>
  +<p>The JSPEngine component of Tomcat's JSPEngine is implemented in JSPEngineImpl. 
  +                    If you want to use another JSPEngine component, you may specify it in a my.roles file.
  +                    The following sample specify in file WEB-INF/my.roles a JSPEngine workging with WebLogicServer:
  +                  </p>
  +<pre class="code">
  +&lt;?xml version="1.0"?&gt;
  +&lt;role-list&gt;
  +  &lt;role name="org.apache.cocoon.components.jsp.JSPEngine"
  +    shorthand="jsp-engine"
  +    default-class="org.apache.cocoon.components.jsp.JSPEngineImplWLS"/&gt;
  +&lt;/role-list&gt;
  +</pre>
  +<p>Defining the file my.roles this way you must ensure that your 
  +                    cocoon.xconf refernces my.roles, like that:
  +                  </p>
  +<pre class="code">
  +...
  +&lt;cocoon version="2.0" user-roles="WEB-INF/my.roles"&gt;
  +...
  +</pre>
  +<p>Currently there are tree JSPEngine components available:
  +                  </p>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +                    
  +<tr>
  +<th colspan="1" rowspan="1">JSPEngine</th><th colspan="1" rowspan="1">ServletEngine</th>
  +</tr>
  +                    
  +<tr>
  +<td colspan="1" rowspan="1">JSPEngineImpl</td><td colspan="1" rowspan="1">Tomcat, generic jsp servlet class</td>
  +</tr>
  +                    
  +<tr>
  +<td colspan="1" rowspan="1">JSPEngineImplWLS</td><td colspan="1" rowspan="1">WebLogic 5.1, 6.0(?)</td>
  +</tr>
  +                    
  +<tr>
  +<td colspan="1" rowspan="1">JSPEngineImplNamedDispactcherInclude</td><td colspan="1" rowspan="1">Generic JSP Servlet</td>
  +</tr>
  +                  
  +</table>
  +<p>The next sections describe the settings of the JSPEngine components.
  +                  </p>
  +<a name="N10086"></a><a name="JSPEngineImpl"></a>
  +<h4>JSPEngineImpl</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>This JSPEngine is the default engine selected in cocoon.roles. 
  +                      By default it uses Tomcats' JASPER  JSP servlet engine.
  +                    </p>
  +<p>Running under a different JSP servlet engine, you can try to change the settings
  +                      in cocoon.xconf, by modifying parameter name servlet-class to your needs.
  +                    </p>
  +<pre class="code">
  +&lt;jsp-engine&gt;
  +  &lt;parameter name="servlet-class"
  +             value="my.servlet.MyJspServletOfMyServletEngine"/&gt;
  +&lt;/jsp-engine&gt;
  +</pre>
  +<p>JSPEngineImpl instances directly the JSP servlet engine class, and services
  +                      HttpRequest to this instance.
  +                    </p>
  +<p>JSPEngineImplNamedDispatcherInclude delegates the selection of a JSP servlet engine
  +                      instance to the servlet engine. It selects by servlet-name, and not by servlet-class.
  +                      This is the key differences of these two implementations.
  +                    </p>
  +</div>
  +<a name="N1009D"></a><a name="JSPEngineImplWLS"></a>
  +<h4>JSPEngineImplWLS</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>This JSPEngine is implemented especially for WebLogic 5.1. WebLogic 6.0, and WebLogic 6.1
  +                      may work, too. JSPEngineImplWLS finds the named request dispatch for jsp, the jsp response
  +                      is piped into Cocoon.
  +                    </p>
  +<p>The name of the JSP servlet is by default set to '*.jsp'. This is the default servlet name
  +                      of the JSP servlet engine under WLS. You may adopt the parameter servlet-name to your needs.
  +                    </p>
  +<p>If you want to specify a different JSP servlet name, you can change the settings
  +                      in cocoon.xconf, by modifying the parameter servlet-name.
  +                    </p>
  +<pre class="code">
  +&lt;jsp-engine&gt;
  +  &lt;parameter name="servlet-name"
  +             value="MyNameOfMyJspServletOfMyServletEngine"/&gt;
  +&lt;/jsp-engine&gt;
  +</pre>
  +</div>
  +<a name="N100B1"></a><a name="JSPEngineImplNamedDispatcherInclude"></a>
  +<h4>JSPEngineImplNamedDispatcherInclude</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>This JSPEngine is implemented like JSPEnginImplWLS without using any WebLogic classes.
  +                      You may try to use this JSPEngine if JSPEngineImpl does not meet your requirements.
  +                    </p>
  +<p>The name of the JSP servlet is by default set to '*.jsp'. This is the default servlet name
  +                      of the jsp servlet engine under WLS. You may adopt the parameter servlet-name to your needs.
  +                    </p>
  +<p>If you want to specify a different JSP servlet name, you can change the settings
  +                      in cocoon.xconf, by modifying the parameter servlet-name.
  +                    </p>
  +<pre class="code">
  +&lt;jsp-engine&gt;
  +  &lt;parameter name="servlet-name"
  +             value="MyNameOfMyJspServletOfMyServletEngine"/&gt;
  +&lt;/jsp-engine&gt;
  +</pre>
  +</div>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +82 -99    cocoon-site/site/2.1/userdocs/generators/jsp-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +436 -432  cocoon-site/site/2.1/userdocs/generators/linkstatus-generator.html
  
  Index: linkstatus-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/linkstatus-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- linkstatus-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ linkstatus-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,432 +1,436 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>LinkStatus Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">LinkStatus Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>LinkStatus Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="linkstatus-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<h3>in @doctitle@</h3>
  -<p>
  -<font size="-2">by&nbsp;Bernhard Huber</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#LinkStatus+Generator">LinkStatus Generator</a>
  -</li>
  -</ul>
  -  
  -<a name="N1001F"></a><a name="LinkStatus+Generator"></a>
  -<h3>LinkStatus Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -    The LinkStatus Generator emits a list of links that are reachable. Please note that it is available only in Cocoon 2.1.
  -   </p>
  -<p>
  -    The LinkStatusGenerator has serveral configuration options.
  -   </p>
  -<dl>
  -     
  -<dt>include-name</dt>
  -     
  -<dd>RE pattern for including links
  -       <br>
  -       By default <span class="codefrag">include-name</span> is empty.
  -     </dd>
  -     
  -<dt>exclude-name</dt>
  -     
  -<dd>RE pattern for excluding links.
  -       <br>
  -       By default <span class="codefrag">exclude-name</span> is defined as
  -       <span class="codefrag">.*\.gif(\?.*)?$,
  -         .*\.png(\?.*)?$,
  -         .*\.jpe?g(\?.*)?$,
  -         .*\.js(\?.*)?$,
  -         .*\.css(\?.*)?$
  -       </span>.
  -     </dd>
  -     
  -<dt>link-content-type</dt>
  -     
  -<dd>expected MIME type of xml document requested on view
  -       <em>link-query-view</em>
  -       
  -<br>
  -       By default <span class="codefrag">link-content-type</span> is set to 
  -       <span class="codefrag">application/x-cocoon-links</span>.
  -     </dd>
  -     
  -<dt>link-view-query</dt>
  -     
  -<dd>A query-string appended to the crawling URL
  -       <br>
  -       By default <span class="codefrag">link-view-query</span> is set to
  -       <span class="codefrag">cocoon-view=links</span>.
  -     </dd>
  -     
  -<dt>user-agent</dt>
  -     
  -<dd>HTTP user-agent for requesting links,
  -       By default <span class="codefrag">user-agent</span> is set to
  -       value of <span class="codefrag">org.apache.cocoon.Constants.COMPLETE_NAME</span>,
  -       ie. <span class="codefrag">Apache Cocoon 2.1-dev</span>
  -     
  -</dd>
  -     
  -<dt>accept</dt>
  -     
  -<dd>Not currently used</dd>
  -   
  -</dl>
  -<ul>
  -    
  -<li>Name : linkStatus</li>
  -    
  -<li>Class: org.apache.cocoon.generation.LinkStatusGenerator</li>
  -    
  -<li>Cacheable: no.</li>
  -   
  -</ul>
  -<p>
  -    A simple example might help to use the LinkStatusGenerator effectivly:
  -   </p>
  -<p>
  -    Add the LinkStatusGenerator to the components in your sitemap.xmap
  -   </p>
  -<pre class="code">
  -...
  -&lt;map:components&gt;
  -...
  -  &lt;map:generators default="file"&gt;
  -  ...
  -    &lt;map:generator name="linkStatus"
  -      src="org.apache.cocoon.generation.LinkStatusGenerator"/&gt;
  -  &lt;/map:generators&gt;
  -  &lt;map:serialize default="html"&gt;
  -    &lt;map:serializer name="links"
  -      src="org.apache.cocoon.serialization.LinkSerializer"/&gt;
  -  &lt;/map:serialize&gt;
  -&lt;/map:components&gt;
  -&lt;map:views&gt;
  -  &lt;map:view&gt;
  -    &lt;map:view from-position="last" name="links"&gt;
  -      &lt;map:serialize type="links"/&gt;
  -    &lt;/map:view&gt;
  -    ...
  -&lt;/map:view&gt;
  -</pre>
  -<p>
  -     Next define in your pipeline to use the LinkStatusGenerator
  -   </p>
  -<pre class="code">
  -&lt;map:match pattern="/linkStatus"&gt;
  -  &lt;map:generate type="linkStatus" name="my-root"/&gt;
  -  ...
  -  &lt;map:serialize/&gt;
  -&lt;/map:match&gt;
  -</pre>
  -</div>
  - 
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>LinkStatus Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">LinkStatus Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>LinkStatus Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="linkstatus-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<h3>in @doctitle@</h3>
  +<p>
  +<font size="-2">by&nbsp;Bernhard Huber</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#LinkStatus+Generator">LinkStatus Generator</a>
  +</li>
  +</ul>
  +  
  +<a name="N1001F"></a><a name="LinkStatus+Generator"></a>
  +<h3>LinkStatus Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +    The LinkStatus Generator emits a list of links that are reachable. Please note that it is available only in Cocoon 2.1.
  +   </p>
  +<p>
  +    The LinkStatusGenerator has serveral configuration options.
  +   </p>
  +<dl>
  +     
  +<dt>include-name</dt>
  +     
  +<dd>RE pattern for including links
  +       <br>
  +       By default <span class="codefrag">include-name</span> is empty.
  +     </dd>
  +     
  +<dt>exclude-name</dt>
  +     
  +<dd>RE pattern for excluding links.
  +       <br>
  +       By default <span class="codefrag">exclude-name</span> is defined as
  +       <span class="codefrag">.*\.gif(\?.*)?$,
  +         .*\.png(\?.*)?$,
  +         .*\.jpe?g(\?.*)?$,
  +         .*\.js(\?.*)?$,
  +         .*\.css(\?.*)?$
  +       </span>.
  +     </dd>
  +     
  +<dt>link-content-type</dt>
  +     
  +<dd>expected MIME type of xml document requested on view
  +       <em>link-query-view</em>
  +       
  +<br>
  +       By default <span class="codefrag">link-content-type</span> is set to 
  +       <span class="codefrag">application/x-cocoon-links</span>.
  +     </dd>
  +     
  +<dt>link-view-query</dt>
  +     
  +<dd>A query-string appended to the crawling URL
  +       <br>
  +       By default <span class="codefrag">link-view-query</span> is set to
  +       <span class="codefrag">cocoon-view=links</span>.
  +     </dd>
  +     
  +<dt>user-agent</dt>
  +     
  +<dd>HTTP user-agent for requesting links,
  +       By default <span class="codefrag">user-agent</span> is set to
  +       value of <span class="codefrag">org.apache.cocoon.Constants.COMPLETE_NAME</span>,
  +       ie. <span class="codefrag">Apache Cocoon 2.1-dev</span>
  +     
  +</dd>
  +     
  +<dt>accept</dt>
  +     
  +<dd>Not currently used</dd>
  +   
  +</dl>
  +<ul>
  +    
  +<li>Name : linkStatus</li>
  +    
  +<li>Class: org.apache.cocoon.generation.LinkStatusGenerator</li>
  +    
  +<li>Cacheable: no.</li>
  +   
  +</ul>
  +<p>
  +    A simple example might help to use the LinkStatusGenerator effectivly:
  +   </p>
  +<p>
  +    Add the LinkStatusGenerator to the components in your sitemap.xmap
  +   </p>
  +<pre class="code">
  +...
  +&lt;map:components&gt;
  +...
  +  &lt;map:generators default="file"&gt;
  +  ...
  +    &lt;map:generator name="linkStatus"
  +      src="org.apache.cocoon.generation.LinkStatusGenerator"/&gt;
  +  &lt;/map:generators&gt;
  +  &lt;map:serialize default="html"&gt;
  +    &lt;map:serializer name="links"
  +      src="org.apache.cocoon.serialization.LinkSerializer"/&gt;
  +  &lt;/map:serialize&gt;
  +&lt;/map:components&gt;
  +&lt;map:views&gt;
  +  &lt;map:view&gt;
  +    &lt;map:view from-position="last" name="links"&gt;
  +      &lt;map:serialize type="links"/&gt;
  +    &lt;/map:view&gt;
  +    ...
  +&lt;/map:view&gt;
  +</pre>
  +<p>
  +     Next define in your pipeline to use the LinkStatusGenerator
  +   </p>
  +<pre class="code">
  +&lt;map:match pattern="/linkStatus"&gt;
  +  &lt;map:generate type="linkStatus" name="my-root"/&gt;
  +  ...
  +  &lt;map:serialize/&gt;
  +&lt;/map:match&gt;
  +</pre>
  +</div>
  + 
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +47 -64    cocoon-site/site/2.1/userdocs/generators/linkstatus-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +346 -342  cocoon-site/site/2.1/userdocs/generators/php-generator.html
  
  Index: php-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/php-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- php-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ php-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,342 +1,346 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Php Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Php Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Php Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="php-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Php+Generator">Php Generator</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Php+Generator"></a>
  -<h3>Php Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>????.</p>
  -<ul>
  -				
  -<li>Name : php</li>
  -				
  -<li>Class: org.apache.cocoon.generation.PhpGenerator</li>
  -				
  -<li>Cacheable: no.</li>
  -			
  -</ul>
  -<p>This generator is optional and not available in the binary distribution.
  -                     However if you want to use it, you have to retrieve the php java servlet,
  -                     copy the jar file into the lib directory of cocoon and rebuild.</p>
  -<pre class="code">
  -     
  -  &lt;map:generate type="php"/&gt;
  -     
  -</pre>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Php Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Php Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Php Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="php-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Php+Generator">Php Generator</a>
  +</li>
  +</ul>
  +		
  +<a name="N1001C"></a><a name="Php+Generator"></a>
  +<h3>Php Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>????.</p>
  +<ul>
  +				
  +<li>Name : php</li>
  +				
  +<li>Class: org.apache.cocoon.generation.PhpGenerator</li>
  +				
  +<li>Cacheable: no.</li>
  +			
  +</ul>
  +<p>This generator is optional and not available in the binary distribution.
  +                     However if you want to use it, you have to retrieve the php java servlet,
  +                     copy the jar file into the lib directory of cocoon and rebuild.</p>
  +<pre class="code">
  +     
  +  &lt;map:generate type="php"/&gt;
  +     
  +</pre>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +43 -60    cocoon-site/site/2.1/userdocs/generators/php-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +443 -439  cocoon-site/site/2.1/userdocs/generators/profile-generator.html
  
  Index: profile-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/profile-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- profile-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ profile-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,439 +1,443 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Profile Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Profile Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Profile Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="profile-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Bruno Dumon,&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Profile+Generator">Profile Generator</a>
  -</li>
  -</ul>
  -    
  -<a name="N10020"></a><a name="Profile+Generator"></a>
  -<h3>Profile Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The profile generator creates xml from the current profiler
  -        measurement results of cocoon.</p>
  -<p>If you just want to use the Cocoon profiler, look at <a href="../concepts/profiler.html">this document</a>.</p>
  -<ul>
  -        
  -<li>Name : profile</li>
  -        
  -<li>Class: org.apache.cocoon.components.profiler.ProfilerGenerator</li>
  -        
  -<li>Cacheable: no</li>
  -      
  -</ul>
  -<p>When no parameters are specified, the profiler generator will simply
  -        generate all available information. Here is some example output:</p>
  -<pre class="code">&lt;profilerinfo date="Mar 24, 2003 5:10:56 PM" xmlns="http://apache.org/cocoon/profiler/1.0"&gt;
  -  &lt;pipeline count="2" key="4704447257427244431" processingTime="378" uri="caching-testsite.html"&gt;
  -    &lt;average time="189"&gt;
  -      &lt;component offset="0" role="file" source="test.xml" time="1"/&gt;
  -      &lt;component offset="1" role="xslt" source="test2page.xsl" time="58"/&gt;
  -      &lt;component offset="2" role="xslt" source="page2html.xsl" time="115"/&gt;
  -      &lt;component offset="3" role="html" time="2"/&gt;
  -    &lt;/average&gt;
  -    &lt;result index="0" time="128"&gt;
  -      &lt;component index="0" processing="0" role="file" setup="0"
  -        source="test.xml" time="0"/&gt;
  -      &lt;component index="1" processing="0" role="xslt" setup="59"
  -        source="test2page.xsl" time="59"/&gt;
  -      &lt;component index="2" processing="0" role="xslt" setup="65"
  -        source="page2html.xsl" time="65"/&gt;
  -      &lt;component index="3" processing="0" role="html" setup="0" time="0"/&gt;
  -    &lt;/result&gt;
  -    &lt;result index="1" time="250"&gt;
  -      &lt;component index="0" processing="1" role="file" setup="1"
  -        source="test.xml" time="2"/&gt;
  -      &lt;component index="1" processing="1" role="xslt" setup="56"
  -        source="test2page.xsl" time="57"/&gt;
  -      &lt;component index="2" processing="21" role="xslt" setup="145"
  -        source="page2html.xsl" time="166"/&gt;
  -      &lt;component index="3" processing="5" role="html" setup="0" time="5"/&gt;
  -    &lt;/result&gt;
  -  &lt;/pipeline&gt;
  -  &lt;pipeline count="1" key="-1812911851413592444" processingTime="190" uri="noncaching-testsite.html"&gt;
  -    &lt;average time="190"&gt;
  -      &lt;component offset="0" role="file" source="test.xml" time="1"/&gt;
  -      &lt;component offset="1" role="xslt" source="test2page.xsl" time="86"/&gt;
  -      &lt;component offset="2" role="xslt" source="page2html.xsl" time="70"/&gt;
  -      &lt;component offset="3" role="html" time="19"/&gt;
  -    &lt;/average&gt;
  -    &lt;result index="0" time="190"&gt;
  -      &lt;component index="0" processing="1" role="file" setup="0"
  -        source="test.xml" time="1"/&gt;
  -      &lt;component index="1" processing="3" role="xslt" setup="83"
  -        source="test2page.xsl" time="86"/&gt;
  -      &lt;component index="2" processing="7" role="xslt" setup="63"
  -        source="page2html.xsl" time="70"/&gt;
  -      &lt;component index="3" processing="19" role="html" setup="0" time="19"/&gt;
  -    &lt;/result&gt;
  -  &lt;/pipeline&gt;
  -&lt;/profilerinfo&gt;</pre>
  -<p>The output consists of a <span class="codefrag">profilerinfo</span> element containing
  -        a number of <span class="codefrag">pipeline</span> elements.  Each pipeline is
  -        identified by a key. The pipeline element contains one
  -        <span class="codefrag">average</span> element (containing the average results) and one
  -        or more <span class="codefrag">result</span> elements for the individual results
  -        (by default only the last 10 results are remembered). Each result element
  -        contains a number of <span class="codefrag">component</span> elements, one for each
  -        component (generator, transformer, serializer) in the pipeline.</p>
  -<p>All elements have the namespace
  -        <span class="codefrag">http://apache.org/cocoon/profiler/1.0</span>.</p>
  -<p>On the component element, there are three attributes indicating timings:</p>
  -<dl>
  -        
  -<dt>setup</dt>
  -        
  -<dd>time spent in the component's setup method</dd>
  -        
  -<dt>processing</dt>
  -        
  -<dd>time spent processing the SAX events</dd>
  -        
  -<dt>time</dt>
  -        
  -<dd>sum of the processing and setup times</dd>
  -      
  -</dl>
  -<p>The output of the profiler generator can be tuned using the following
  -        request parameters:</p>
  -<dl>
  -        
  -<dt>key</dt>
  -        
  -<dd>limit the output to the pipeline with this key</dd>
  -        
  -<dt>result</dt>
  -        
  -<dd>to be used in combination with key, causes only the result with
  -          this index to be included. In this case some additional information
  -          about the environment (request parameters and session attributes)
  -          will be returned.</dd>
  -        
  -<dt>component</dt>
  -        
  -<dd>to be used in combination with key and result. When this parameter
  -          is specified, the XML that was generated by the component with this
  -          index will be included in the output (as child of the specified
  -          component element).</dd>
  -        
  -<dt>fragmentonly</dt>
  -        
  -<dd>to be used in combination with key, result and component. If this
  -          parameter is true, only the XML that was generated by the specified
  -          component will be returned, without additional profiler information
  -          around it.</dd>
  -      
  -</dl>
  -</div>
  -  
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Profile Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Profile Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Profile Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="profile-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Bruno Dumon,&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Profile+Generator">Profile Generator</a>
  +</li>
  +</ul>
  +    
  +<a name="N10020"></a><a name="Profile+Generator"></a>
  +<h3>Profile Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The profile generator creates xml from the current profiler
  +        measurement results of cocoon.</p>
  +<p>If you just want to use the Cocoon profiler, look at <a href="../concepts/profiler.html">this document</a>.</p>
  +<ul>
  +        
  +<li>Name : profile</li>
  +        
  +<li>Class: org.apache.cocoon.components.profiler.ProfilerGenerator</li>
  +        
  +<li>Cacheable: no</li>
  +      
  +</ul>
  +<p>When no parameters are specified, the profiler generator will simply
  +        generate all available information. Here is some example output:</p>
  +<pre class="code">&lt;profilerinfo date="Mar 24, 2003 5:10:56 PM" xmlns="http://apache.org/cocoon/profiler/1.0"&gt;
  +  &lt;pipeline count="2" key="4704447257427244431" processingTime="378" uri="caching-testsite.html"&gt;
  +    &lt;average time="189"&gt;
  +      &lt;component offset="0" role="file" source="test.xml" time="1"/&gt;
  +      &lt;component offset="1" role="xslt" source="test2page.xsl" time="58"/&gt;
  +      &lt;component offset="2" role="xslt" source="page2html.xsl" time="115"/&gt;
  +      &lt;component offset="3" role="html" time="2"/&gt;
  +    &lt;/average&gt;
  +    &lt;result index="0" time="128"&gt;
  +      &lt;component index="0" processing="0" role="file" setup="0"
  +        source="test.xml" time="0"/&gt;
  +      &lt;component index="1" processing="0" role="xslt" setup="59"
  +        source="test2page.xsl" time="59"/&gt;
  +      &lt;component index="2" processing="0" role="xslt" setup="65"
  +        source="page2html.xsl" time="65"/&gt;
  +      &lt;component index="3" processing="0" role="html" setup="0" time="0"/&gt;
  +    &lt;/result&gt;
  +    &lt;result index="1" time="250"&gt;
  +      &lt;component index="0" processing="1" role="file" setup="1"
  +        source="test.xml" time="2"/&gt;
  +      &lt;component index="1" processing="1" role="xslt" setup="56"
  +        source="test2page.xsl" time="57"/&gt;
  +      &lt;component index="2" processing="21" role="xslt" setup="145"
  +        source="page2html.xsl" time="166"/&gt;
  +      &lt;component index="3" processing="5" role="html" setup="0" time="5"/&gt;
  +    &lt;/result&gt;
  +  &lt;/pipeline&gt;
  +  &lt;pipeline count="1" key="-1812911851413592444" processingTime="190" uri="noncaching-testsite.html"&gt;
  +    &lt;average time="190"&gt;
  +      &lt;component offset="0" role="file" source="test.xml" time="1"/&gt;
  +      &lt;component offset="1" role="xslt" source="test2page.xsl" time="86"/&gt;
  +      &lt;component offset="2" role="xslt" source="page2html.xsl" time="70"/&gt;
  +      &lt;component offset="3" role="html" time="19"/&gt;
  +    &lt;/average&gt;
  +    &lt;result index="0" time="190"&gt;
  +      &lt;component index="0" processing="1" role="file" setup="0"
  +        source="test.xml" time="1"/&gt;
  +      &lt;component index="1" processing="3" role="xslt" setup="83"
  +        source="test2page.xsl" time="86"/&gt;
  +      &lt;component index="2" processing="7" role="xslt" setup="63"
  +        source="page2html.xsl" time="70"/&gt;
  +      &lt;component index="3" processing="19" role="html" setup="0" time="19"/&gt;
  +    &lt;/result&gt;
  +  &lt;/pipeline&gt;
  +&lt;/profilerinfo&gt;</pre>
  +<p>The output consists of a <span class="codefrag">profilerinfo</span> element containing
  +        a number of <span class="codefrag">pipeline</span> elements.  Each pipeline is
  +        identified by a key. The pipeline element contains one
  +        <span class="codefrag">average</span> element (containing the average results) and one
  +        or more <span class="codefrag">result</span> elements for the individual results
  +        (by default only the last 10 results are remembered). Each result element
  +        contains a number of <span class="codefrag">component</span> elements, one for each
  +        component (generator, transformer, serializer) in the pipeline.</p>
  +<p>All elements have the namespace
  +        <span class="codefrag">http://apache.org/cocoon/profiler/1.0</span>.</p>
  +<p>On the component element, there are three attributes indicating timings:</p>
  +<dl>
  +        
  +<dt>setup</dt>
  +        
  +<dd>time spent in the component's setup method</dd>
  +        
  +<dt>processing</dt>
  +        
  +<dd>time spent processing the SAX events</dd>
  +        
  +<dt>time</dt>
  +        
  +<dd>sum of the processing and setup times</dd>
  +      
  +</dl>
  +<p>The output of the profiler generator can be tuned using the following
  +        request parameters:</p>
  +<dl>
  +        
  +<dt>key</dt>
  +        
  +<dd>limit the output to the pipeline with this key</dd>
  +        
  +<dt>result</dt>
  +        
  +<dd>to be used in combination with key, causes only the result with
  +          this index to be included. In this case some additional information
  +          about the environment (request parameters and session attributes)
  +          will be returned.</dd>
  +        
  +<dt>component</dt>
  +        
  +<dd>to be used in combination with key and result. When this parameter
  +          is specified, the XML that was generated by the component with this
  +          index will be included in the output (as child of the specified
  +          component element).</dd>
  +        
  +<dt>fragmentonly</dt>
  +        
  +<dd>to be used in combination with key, result and component. If this
  +          parameter is true, only the XML that was generated by the specified
  +          component will be returned, without additional profiler information
  +          around it.</dd>
  +      
  +</dl>
  +</div>
  +  
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +67 -97    cocoon-site/site/2.1/userdocs/generators/profile-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +418 -414  cocoon-site/site/2.1/userdocs/generators/request-generator.html
  
  Index: request-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/request-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- request-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ request-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,414 +1,418 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Request Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Request Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Request Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="request-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Request+Generator">Request Generator</a>
  -</li>
  -</ul>
  -        
  -<a name="N1001C"></a><a name="Request+Generator"></a>
  -<h3>Request Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The request generator uses the current request to produce xml data.
  -                     It converts some of the information contained in the request
  -                     to structured xml.</p>
  -<ul>
  -                
  -<li>Name : request</li>
  -                
  -<li>Class: org.apache.cocoon.generation.RequestGenerator</li>
  -                
  -<li>Cacheable: no.</li>
  -            
  -</ul>
  -<pre class="code">
  -&lt;map:generate type="request"/&gt;
  -&lt;!-- The src attribute is optional --&gt;
  -</pre>
  -<p>The output has the following schema. All elements have the namespace
  -               <span class="codefrag">http://apache.org/cocoon/request/2.0</span>
  -</p>
  -<pre class="code">
  -&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  -
  -&lt;!-- The root element is request. The target attribute is the 
  -     requested uri and the source attribute is the optional 
  -     source attribute of the sitemap entry for this pipeline. --&gt;
  -&lt;request target="/cocoon/request" source=""
  -         xmlns="http://apache.org/cocoon/request/2.0"&gt;
  -
  -  &lt;!-- First the headers: --&gt;
  -  &lt;requestHeaders&gt;
  -    &lt;header name="accept-language"&gt;de&lt;/header&gt;
  -    &lt;header name="connection"&gt;Keep-Alive&lt;/header&gt;
  -    &lt;header name="accept"&gt;image/gif, image/x-xbitmap, image/jpeg,
  -      image/pjpeg, */*&lt;/header&gt;
  -    &lt;header name="host"&gt;thehost.serving.cocoon&lt;/header&gt;
  -    &lt;header name="accept-encoding"&gt;gzip, deflate&lt;/header&gt;
  -    &lt;header name="user-agent"&gt;Browser User Agent&lt;/header&gt;
  -    &lt;header name="referer"&gt;http://thehost.serving.cocoon/cocoon/welcome
  -      &lt;/header&gt;
  -  &lt;/requestHeaders&gt;
  -
  -  &lt;!-- All request parameters: --&gt;
  -  &lt;requestParameters&gt;
  -    &lt;!-- Create a parameter element for each parameter --&gt;
  -    &lt;parameter name="login"&gt;
  -      &lt;!-- Create a value element for each value --&gt;
  -      &lt;value&gt;test&lt;/value&gt;
  -    &lt;/parameter&gt;
  -  &lt;/requestParameters&gt;
  -
  -  &lt;!-- All request attributes; see below the note on generate-attributes parameter. 
  -       (This feature is available startign with version 2.1 --&gt;
  -  &lt;requestAttributes&gt;
  -    &lt;!-- Create an attribute element for each attribute --&gt;
  -    &lt;attribute name="errorMessage"&gt;
  -      &lt;!-- Create a value element for the attribute value --&gt;
  -      &lt;value&gt;I was put here by an earlier action.&lt;/value&gt;
  -    &lt;/attribute&gt;
  -  &lt;/requestAttributes&gt;
  -
  -  &lt;!-- All configuration parameters: --&gt;
  -  &lt;configurationParameters&gt;
  -    &lt;!-- Create a parameter element for each parameter specified 
  -         in the pipeline for this generator--&gt;
  -    &lt;parameter name="test_sitemap_parameter"&gt;the value&lt;/parameter&gt;
  -  &lt;/configurationParameters&gt;
  -
  -&lt;/request&gt;
  -</pre>
  -<div class="frame note">
  -<div class="label">Note</div>
  -<div class="content">If you want request attributes to be generated, you must specify <span class="codefrag">generate-attributes</span> parameter at generator definition or invocation in the sitemap.</div>
  -</div>
  -<pre class="code">
  -&lt;!-- This will turn on attribute generation on by default --&gt;
  -&lt;map:generator name="request" src="org.apache.cocoon.generation.RequestGenerator"&gt; 
  -    &lt;map:parameter name="generate-attributes" value="true"/&gt;
  -&lt;/map:generator&gt;
  -
  -&lt;!-- or --&gt;
  -
  -    &lt;!-- This will turn on attribute generation for this invocation only. --&gt;
  -    &lt;map:match pattern="request"&gt;
  -        &lt;map:generate type="request"&gt;
  -	    &lt;map:parameter name="generate-attributes" value="true"/&gt;
  -        &lt;/map:generate&gt;
  -    &lt;/map:match&gt;
  -
  -
  -</pre>
  -</div>
  -    
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Request Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Request Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Request Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="request-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Request+Generator">Request Generator</a>
  +</li>
  +</ul>
  +        
  +<a name="N1001C"></a><a name="Request+Generator"></a>
  +<h3>Request Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The request generator uses the current request to produce xml data.
  +                     It converts some of the information contained in the request
  +                     to structured xml.</p>
  +<ul>
  +                
  +<li>Name : request</li>
  +                
  +<li>Class: org.apache.cocoon.generation.RequestGenerator</li>
  +                
  +<li>Cacheable: no.</li>
  +            
  +</ul>
  +<pre class="code">
  +&lt;map:generate type="request"/&gt;
  +&lt;!-- The src attribute is optional --&gt;
  +</pre>
  +<p>The output has the following schema. All elements have the namespace
  +               <span class="codefrag">http://apache.org/cocoon/request/2.0</span>
  +</p>
  +<pre class="code">
  +&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  +
  +&lt;!-- The root element is request. The target attribute is the 
  +     requested uri and the source attribute is the optional 
  +     source attribute of the sitemap entry for this pipeline. --&gt;
  +&lt;request target="/cocoon/request" source=""
  +         xmlns="http://apache.org/cocoon/request/2.0"&gt;
  +
  +  &lt;!-- First the headers: --&gt;
  +  &lt;requestHeaders&gt;
  +    &lt;header name="accept-language"&gt;de&lt;/header&gt;
  +    &lt;header name="connection"&gt;Keep-Alive&lt;/header&gt;
  +    &lt;header name="accept"&gt;image/gif, image/x-xbitmap, image/jpeg,
  +      image/pjpeg, */*&lt;/header&gt;
  +    &lt;header name="host"&gt;thehost.serving.cocoon&lt;/header&gt;
  +    &lt;header name="accept-encoding"&gt;gzip, deflate&lt;/header&gt;
  +    &lt;header name="user-agent"&gt;Browser User Agent&lt;/header&gt;
  +    &lt;header name="referer"&gt;http://thehost.serving.cocoon/cocoon/welcome
  +      &lt;/header&gt;
  +  &lt;/requestHeaders&gt;
  +
  +  &lt;!-- All request parameters: --&gt;
  +  &lt;requestParameters&gt;
  +    &lt;!-- Create a parameter element for each parameter --&gt;
  +    &lt;parameter name="login"&gt;
  +      &lt;!-- Create a value element for each value --&gt;
  +      &lt;value&gt;test&lt;/value&gt;
  +    &lt;/parameter&gt;
  +  &lt;/requestParameters&gt;
  +
  +  &lt;!-- All request attributes; see below the note on generate-attributes parameter. 
  +       (This feature is available startign with version 2.1 --&gt;
  +  &lt;requestAttributes&gt;
  +    &lt;!-- Create an attribute element for each attribute --&gt;
  +    &lt;attribute name="errorMessage"&gt;
  +      &lt;!-- Create a value element for the attribute value --&gt;
  +      &lt;value&gt;I was put here by an earlier action.&lt;/value&gt;
  +    &lt;/attribute&gt;
  +  &lt;/requestAttributes&gt;
  +
  +  &lt;!-- All configuration parameters: --&gt;
  +  &lt;configurationParameters&gt;
  +    &lt;!-- Create a parameter element for each parameter specified 
  +         in the pipeline for this generator--&gt;
  +    &lt;parameter name="test_sitemap_parameter"&gt;the value&lt;/parameter&gt;
  +  &lt;/configurationParameters&gt;
  +
  +&lt;/request&gt;
  +</pre>
  +<div class="frame note">
  +<div class="label">Note</div>
  +<div class="content">If you want request attributes to be generated, you must specify <span class="codefrag">generate-attributes</span> parameter at generator definition or invocation in the sitemap.</div>
  +</div>
  +<pre class="code">
  +&lt;!-- This will turn on attribute generation on by default --&gt;
  +&lt;map:generator name="request" src="org.apache.cocoon.generation.RequestGenerator"&gt; 
  +    &lt;map:parameter name="generate-attributes" value="true"/&gt;
  +&lt;/map:generator&gt;
  +
  +&lt;!-- or --&gt;
  +
  +    &lt;!-- This will turn on attribute generation for this invocation only. --&gt;
  +    &lt;map:match pattern="request"&gt;
  +        &lt;map:generate type="request"&gt;
  +	    &lt;map:parameter name="generate-attributes" value="true"/&gt;
  +        &lt;/map:generate&gt;
  +    &lt;/map:match&gt;
  +
  +
  +</pre>
  +</div>
  +    
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.3       +47 -64    cocoon-site/site/2.1/userdocs/generators/request-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +343 -339  cocoon-site/site/2.1/userdocs/generators/script-generator.html
  
  Index: script-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/script-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- script-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ script-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,339 +1,343 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Script Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Script Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Script Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="script-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Script+Generator">Script Generator</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Script+Generator"></a>
  -<h3>Script Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>????.</p>
  -<ul>
  -				
  -<li>Name : script</li>
  -				
  -<li>Class: org.apache.cocoon.generation.ScriptGenerator</li>
  -				
  -<li>Cacheable: ????.</li>
  -			
  -</ul>
  -<pre class="code">
  -     
  -  &lt;map:generate type="script"/&gt;
  -     
  -</pre>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Script Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Script Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Script Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="script-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Script+Generator">Script Generator</a>
  +</li>
  +</ul>
  +		
  +<a name="N1001C"></a><a name="Script+Generator"></a>
  +<h3>Script Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>????.</p>
  +<ul>
  +				
  +<li>Name : script</li>
  +				
  +<li>Class: org.apache.cocoon.generation.ScriptGenerator</li>
  +				
  +<li>Cacheable: ????.</li>
  +			
  +</ul>
  +<pre class="code">
  +     
  +  &lt;map:generate type="script"/&gt;
  +     
  +</pre>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +43 -60    cocoon-site/site/2.1/userdocs/generators/script-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +683 -679  cocoon-site/site/2.1/userdocs/generators/search-generator.html
  
  Index: search-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/search-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- search-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ search-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,679 +1,683 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Search Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Search Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Search Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="search-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Bernhard Huber</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Search+Generator">Search Generator</a>
  -</li>
  -<li>
  -<a href="#Configuration">Configuration</a>
  -</li>
  -<li>
  -<a href="#Query+Parameters">Query Parameters</a>
  -</li>
  -<li>
  -<a href="#Using+SearchGenerator">Using SearchGenerator</a>
  -</li>
  -<li>
  -<a href="#DTD">DTD</a>
  -</li>
  -<li>
  -<a href="#Example">Example</a>
  -</li>
  -</ul>
  -    
  -<a name="N1001C"></a><a name="Search+Generator"></a>
  -<h3>Search Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -        The search generator creates xml content resulting from an indexing search.
  -        Speaking simply, SearchGenerator takes a query-string passes it to search engine.
  -        The hits delivered by the search engine are wrapped into xml output, feed into 
  -        the pipeline.
  -      </p>
  -<p>
  -        The xml content generated by SearchGenerator is described later.
  -      </p>
  -<ul>
  -        
  -<li>Name : search</li>
  -        
  -<li>Class: org.apache.cocoon.generation.SearchGenerator</li>
  -        
  -<li>Cacheable: no.</li>
  -      
  -</ul>
  -<pre class="code">
  -&lt;map:generate type="search"/&gt;
  -</pre>
  -<p>or</p>
  -<pre class="code">
  -&lt;map:generate type="search"&gt;
  -	&lt;query&gt;your query string&lt;/query&gt;
  -&lt;/map:generate&gt;
  -</pre>
  -</div>
  -    
  -<a name="N10041"></a><a name="Configuration"></a>
  -<h3>Configuration</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -        Configuring of the SearchGenerator involves mainly setting up 
  -        configuration needed by avalon component used for searching.
  -        As today SearchGenerator uses the Avalon component
  -        <span class="codefrag">org.apache.cocoon.components.search.LuceneCocoonSearcher</span>
  -        for searching, the configuration is tailored for this component.
  -      </p>
  -<table class="ForrestTable" cellspacing="1" cellpadding="4">
  -        
  -<tr>
  -          
  -<th colspan="1" rowspan="1">Parameter Name</th><th colspan="1" rowspan="1">Default</th><th colspan="1" rowspan="1">Description</th>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">analyzer</td><td colspan="1" rowspan="1">org.apache.lucene.analysis.standard.StandardAnalyzer</td>
  -          <td colspan="1" rowspan="1">
  -            This parameter defines the analyzer to use for searching. Take care to use a
  -            compatible analyzer as used when generating the index.
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">index</td><td colspan="1" rowspan="1">index</td>
  -          <td colspan="1" rowspan="1">
  -            This parameter defines a filesystem directory, expecting to be the 
  -            location of the lucene filesystem index directory.
  -            Relative directory names are resolved relative to Cocoon's 
  -            working directory.
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">query-string</td><td colspan="1" rowspan="1">QueryString</td>
  -          <td colspan="1" rowspan="1">
  -            This parameter specifies the name of the query paramter name used
  -            for passing the query-string, eg. 
  -            <span class="codefrag">http://foo/bar?queryString=cocoon</span>, for generating
  -            xml content for query "cocoon".
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">page-length</td><td colspan="1" rowspan="1">PageLength</td>
  -          <td colspan="1" rowspan="1">
  -            This parameter specifies the name of the query parameter name used
  -            for passing the page length. The page length specifies the number of
  -            hits generated into the xml content. A negative page length value
  -            will generate all hits into the xml content.
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">start-index</td><td colspan="1" rowspan="1">StartIndex</td>
  -          <td colspan="1" rowspan="1">
  -            This parameter specifies the name of the query parameter name used
  -            for passing the start index of the hits result. This query parameter
  -            has higher precedence than query parameter defined by
  -            start-next-index, and start-previous-index.
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">start-next-index</td><td colspan="1" rowspan="1">StartNextIndex</td>
  -          <td colspan="1" rowspan="1">
  -            This parameter specifies the name of the query parameter name used
  -            for passing the start index of the hits result. 
  -            Use this if you have a form defining both next and previous
  -            navigation control.
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">start-previous-index</td><td colspan="1" rowspan="1">StartPreviousIndex</td>
  -          <td colspan="1" rowspan="1">
  -            This parameter specifies the name of the query parameter name used
  -            for passing the start index of the hits result.
  -            Use this if you have a form defining both next and previous 
  -            navigation control.
  -          </td>
  -        
  -</tr>
  -      
  -</table>
  -</div>
  -    
  -<a name="N100DA"></a><a name="Query+Parameters"></a>
  -<h3>Query Parameters</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -        This generator accepts following query parameters, the table below assumes
  -        the default settings of the setup parameters.
  -      </p>
  -<table class="ForrestTable" cellspacing="1" cellpadding="4">
  -        
  -<tr>
  -          
  -<th colspan="1" rowspan="1">Query Parameter Name</th><th colspan="1" rowspan="1">Default</th><th colspan="1" rowspan="1">Description</th>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">queryString</td><td colspan="1" rowspan="1">No default</td>
  -          <td colspan="1" rowspan="1">
  -            Specifies the query string, parsable by the search engine.
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">pageLength</td><td colspan="1" rowspan="1">10</td>
  -          <td colspan="1" rowspan="1">
  -            This value specifies the number of hits displayed per page.
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">startIndex</td><td colspan="1" rowspan="1">0</td>
  -          <td colspan="1" rowspan="1">
  -            Start displaying hits starting from this index (counting starts 
  -            at 0).
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">startNextIndex</td><td colspan="1" rowspan="1">0</td>
  -          <td colspan="1" rowspan="1">
  -            Start displaying hits starting from this index (counting start at 0).
  -          </td>
  -        
  -</tr>
  -        
  -<tr>
  -          
  -<td colspan="1" rowspan="1">startPreviousIndex</td><td colspan="1" rowspan="1">0</td>
  -          <td colspan="1" rowspan="1">
  -            Start displaying hits starting from this index (counting starts 
  -            at 0). 
  -          </td>
  -        
  -</tr>
  -      
  -</table>
  -</div>
  -    
  -<a name="N1014B"></a><a name="Using+SearchGenerator"></a>
  -<h3>Using SearchGenerator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -        Using the SearchGenerator needs some configuration steps regarding
  -        <span class="codefrag">cocoon.xconf</span>, and the sitemap mounting a pipeline
  -        defining a SearchGenerator generation step. Moreover you will 
  -        have to define some XSLT processing for reendering the xml content
  -        of the SearchGenerator.
  -      </p>
  -<p>
  -        As SearchGenerator uses some avalon components be sure to configure
  -        your <span class="codefrag">cocoon.xconf</span> properly. The avalon
  -        componet <span class="codefrag">org.apache.cocoon.components.search.LuceneCocoonSearcher</span>
  -        is used by SearchGenerator.
  -        Usually this component is specified in 
  -        <span class="codefrag">cocoon.roles</span>, and the <span class="codefrag">cocoon.xconf</span> file
  -        for the default cocoon webapp.
  -      </p>
  -<p>
  -        Inside of a sitemap you have to define the SearchGenerator in the
  -        generator componenets section.
  -      </p>
  -<p>
  -        Moreover you have to match a URI to the SearchGenerator processing, the
  -        following example matches the URI <span class="codefrag">findIt</span> to the 
  -        SearchGenerator processing. The stylesheet <span class="codefrag">search2html.xsl</span>
  -        transforms the xml content of SearchGenerator to html:
  -      </p>
  -<pre class="code">
  -&lt;map:match pattern="findIt"&gt;
  -  &lt;map:generate type="search"/&gt;
  -  &lt;map:transform type="log"/&gt;
  -  &lt;map:transform src="stylesheets/search2html.xsl"/&gt;
  -  &lt;map:serialize/&gt;
  -&lt;/map:match&gt;
  -</pre>
  -</div>
  -    
  -<a name="N10177"></a><a name="DTD"></a>
  -<h3>DTD</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>XML generated by SearchGenerator uses namespace 
  -      <span class="codefrag">http://apache.org/cocoon/search/1.0</span>.
  -      The DTD of XML generated by SearchGenerator:
  -      </p>
  -<pre class="code">
  -&lt;!ELEMENT results (hits,navigation)?&gt;
  -
  -&lt;!ATTLIST results
  -   date CDATA #IMPLIED
  -   query-string CDATA #IMPLIED
  -   start-index CDATA #IMPLIED
  -   page-length CDATA #IMPLIED
  -&gt;
  -
  -&lt;!ELEMENT hits (hit)*&gt;
  -&lt;!ATTLIST hits
  -   total-count CDATA #IMPLIED
  -   count-of-pages CDATA #IMPLIED
  -&gt;
  -
  -&lt;!ELEMENT hit (#PCDATA)&gt;
  -&lt;!ATTLIST hit
  -   rank CDATA #REQUIRED
  -   score CDATA #IMPLIED
  -   uri CDATA #IMPLIED
  -&gt;
  -
  -&lt;!ELEMENT field (#PCDATA)&gt;
  -&lt;!ATTLIST field
  -   name CDATA #REQUIRED
  -&gt;
  -
  -&lt;!ELEMENT navigation (navigation-page)*&gt;
  -&lt;!ATTLIST navigation
  -   total-count CDATA #IMPLIED
  -   count-of-pages CDATA #IMPLIED
  -&gt;
  -
  -&lt;!ELEMENT navigation-page EMPTY&gt;
  -&lt;!ATTLIST navigation
  -   start-index CDATA #IMPLIED
  -&gt;
  -</pre>
  -</div>
  -    
  -<a name="N10188"></a><a name="Example"></a>
  -<h3>Example</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The search generator generates following xml content, for the query
  -        <span class="codefrag">query-string=cocoon&amp;start-index=0&amp;page-length=10</span>.
  -      </p>
  -<pre class="code">
  -&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  -&lt;search:results date="1008437081064" 
  - query-string="cocoon" start-index="0" page-length="10"
  - xmlns:search="http://apache.org/cocoon/search/1.0"
  - xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  - &lt;search:hits total-count="125" count-of-pages="13"&gt;
  -   &lt;search:hit rank="0" score="1.0" 
  -     uri="http://localhost:8080/cocoon/documents/hosting.html"/&gt;
  -   &lt;search:hit rank="1" score="1.0" 
  -     uri="http://localhost:8080/cocoon/documents/hosting.html"/&gt;
  -   &lt;search:hit rank="2" score="1.0"
  -     uri="http://localhost:8080/cocoon/documents/hosting.html"/&gt;
  -   &lt;search:hit rank="3" score="0.93121004"
  -     uri="http://localhost:8080/cocoon/documents/userdocs/actions/actions.html"/&gt;
  -   &lt;search:hit rank="4" score="0.93121004"
  -     uri="http://localhost:8080/cocoon/documents/userdocs/actions/actions.html"/&gt;
  -   &lt;search:hit rank="5" score="0.7112235"
  -     uri="http://localhost:8080/cocoon/documents/mail-archives.html"/&gt;
  -   &lt;search:hit rank="6" score="0.70967746"
  -     uri="http://localhost:8080/cocoon/documents/userdocs/
  -     serializers/link-serializer.html"/&gt;
  -   &lt;search:hit rank="7" score="0.6881721"
  -     uri="http://localhost:8080/cocoon/documents/userdocs/
  -     serializers/text-serializer.html"/&gt;
  -   &lt;search:hit rank="8" score="0.6881721"
  -     uri="http://localhost:8080/cocoon/documents/userdocs/
  -     serializers/vrml-serializer.html"/&gt;
  -   &lt;search:hit rank="9" score="0.6666666" 
  -     uri="http://localhost:8080/cocoon/documents/userdocs/
  -     serializers/svgpng-serializer.html"/&gt;
  - &lt;/search:hits&gt;
  - &lt;search:navigation total-count="125" count-of-pages="13"
  -   has-next="true" has-previous="false" next-index="10" previous-index="0"&gt;
  -   &lt;search:navigation-page start-index="0"/&gt;
  -   &lt;search:navigation-page start-index="10"/&gt;
  -   &lt;search:navigation-page start-index="20"/&gt;
  -   &lt;search:navigation-page start-index="30"/&gt;
  -   &lt;search:navigation-page start-index="40"/&gt;
  -   &lt;search:navigation-page start-index="50"/&gt;
  -   &lt;search:navigation-page start-index="60"/&gt;
  -   &lt;search:navigation-page start-index="70"/&gt;
  -   &lt;search:navigation-page start-index="80"/&gt;
  -   &lt;search:navigation-page start-index="90"/&gt;
  -   &lt;search:navigation-page start-index="100"/&gt;
  -   &lt;search:navigation-page start-index="110"/&gt;
  -   &lt;search:navigation-page start-index="120"/&gt;
  - &lt;/search:navigation&gt;
  -&lt;/search:results&gt;
  -</pre>
  -</div>
  -  
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Search Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Search Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Search Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="search-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Bernhard Huber</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Search+Generator">Search Generator</a>
  +</li>
  +<li>
  +<a href="#Configuration">Configuration</a>
  +</li>
  +<li>
  +<a href="#Query+Parameters">Query Parameters</a>
  +</li>
  +<li>
  +<a href="#Using+SearchGenerator">Using SearchGenerator</a>
  +</li>
  +<li>
  +<a href="#DTD">DTD</a>
  +</li>
  +<li>
  +<a href="#Example">Example</a>
  +</li>
  +</ul>
  +    
  +<a name="N1001C"></a><a name="Search+Generator"></a>
  +<h3>Search Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +        The search generator creates xml content resulting from an indexing search.
  +        Speaking simply, SearchGenerator takes a query-string passes it to search engine.
  +        The hits delivered by the search engine are wrapped into xml output and fed into 
  +        the pipeline.
  +      </p>
  +<p>
  +        The xml content generated by SearchGenerator is described later.
  +      </p>
  +<ul>
  +        
  +<li>Name : search</li>
  +        
  +<li>Class: org.apache.cocoon.generation.SearchGenerator</li>
  +        
  +<li>Cacheable: no.</li>
  +      
  +</ul>
  +<pre class="code">
  +&lt;map:generate type="search"/&gt;
  +</pre>
  +<p>or</p>
  +<pre class="code">
  +&lt;map:generate type="search"&gt;
  +	&lt;query&gt;your query string&lt;/query&gt;
  +&lt;/map:generate&gt;
  +</pre>
  +</div>
  +    
  +<a name="N10041"></a><a name="Configuration"></a>
  +<h3>Configuration</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +        Configuring of the SearchGenerator involves mainly setting up 
  +        configuration needed by avalon component used for searching.
  +        As today SearchGenerator uses the Avalon component
  +        <span class="codefrag">org.apache.cocoon.components.search.LuceneCocoonSearcher</span>
  +        for searching, the configuration is tailored for this component.
  +      </p>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +        
  +<tr>
  +          
  +<th colspan="1" rowspan="1">Parameter Name</th><th colspan="1" rowspan="1">Default</th><th colspan="1" rowspan="1">Description</th>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">analyzer</td><td colspan="1" rowspan="1">org.apache.lucene.analysis.standard.StandardAnalyzer</td>
  +          <td colspan="1" rowspan="1">
  +            This parameter defines the analyzer to use for searching. Take care to use a
  +            compatible analyzer as used when generating the index.
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">index</td><td colspan="1" rowspan="1">index</td>
  +          <td colspan="1" rowspan="1">
  +            This parameter defines a filesystem directory, expecting to be the 
  +            location of the lucene filesystem index directory.
  +            Relative directory names are resolved relative to Cocoon's 
  +            working directory.
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">query-string</td><td colspan="1" rowspan="1">QueryString</td>
  +          <td colspan="1" rowspan="1">
  +            This parameter specifies the name of the query parameter name used
  +            for passing the query-string, eg. 
  +            <span class="codefrag">http://foo/bar?queryString=cocoon</span>, for generating
  +            xml content for query "cocoon".
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">page-length</td><td colspan="1" rowspan="1">PageLength</td>
  +          <td colspan="1" rowspan="1">
  +            This parameter specifies the name of the query parameter name used
  +            for passing the page length. The page length specifies the number of
  +            hits generated into the xml content. A negative page length value
  +            will generate all hits into the xml content.
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">start-index</td><td colspan="1" rowspan="1">StartIndex</td>
  +          <td colspan="1" rowspan="1">
  +            This parameter specifies the name of the query parameter name used
  +            for passing the start index of the hits result. This query parameter
  +            has higher precedence than query parameter defined by
  +            start-next-index, and start-previous-index.
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">start-next-index</td><td colspan="1" rowspan="1">StartNextIndex</td>
  +          <td colspan="1" rowspan="1">
  +            This parameter specifies the name of the query parameter name used
  +            for passing the start index of the hits result. 
  +            Use this if you have a form defining both next and previous
  +            navigation control.
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">start-previous-index</td><td colspan="1" rowspan="1">StartPreviousIndex</td>
  +          <td colspan="1" rowspan="1">
  +            This parameter specifies the name of the query parameter name used
  +            for passing the start index of the hits result.
  +            Use this if you have a form defining both next and previous 
  +            navigation control.
  +          </td>
  +        
  +</tr>
  +      
  +</table>
  +</div>
  +    
  +<a name="N100DA"></a><a name="Query+Parameters"></a>
  +<h3>Query Parameters</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +        This generator accepts following query parameters, the table below assumes
  +        the default settings of the setup parameters.
  +      </p>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +        
  +<tr>
  +          
  +<th colspan="1" rowspan="1">Query Parameter Name</th><th colspan="1" rowspan="1">Default</th><th colspan="1" rowspan="1">Description</th>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">queryString</td><td colspan="1" rowspan="1">No default</td>
  +          <td colspan="1" rowspan="1">
  +            Specifies the query string, parsable by the search engine.
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">pageLength</td><td colspan="1" rowspan="1">10</td>
  +          <td colspan="1" rowspan="1">
  +            This value specifies the number of hits displayed per page.
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">startIndex</td><td colspan="1" rowspan="1">0</td>
  +          <td colspan="1" rowspan="1">
  +            Start displaying hits starting from this index (counting starts 
  +            at 0).
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">startNextIndex</td><td colspan="1" rowspan="1">0</td>
  +          <td colspan="1" rowspan="1">
  +            Start displaying hits starting from this index (counting start at 0).
  +          </td>
  +        
  +</tr>
  +        
  +<tr>
  +          
  +<td colspan="1" rowspan="1">startPreviousIndex</td><td colspan="1" rowspan="1">0</td>
  +          <td colspan="1" rowspan="1">
  +            Start displaying hits starting from this index (counting starts 
  +            at 0). 
  +          </td>
  +        
  +</tr>
  +      
  +</table>
  +</div>
  +    
  +<a name="N1014B"></a><a name="Using+SearchGenerator"></a>
  +<h3>Using SearchGenerator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +        Using the SearchGenerator needs some configuration steps regarding
  +        <span class="codefrag">cocoon.xconf</span>, and the sitemap mounting a pipeline
  +        defining a SearchGenerator generation step. Moreover you will 
  +        have to define some XSLT processing for reendering the xml content
  +        of the SearchGenerator.
  +      </p>
  +<p>
  +        As SearchGenerator uses some avalon components be sure to configure
  +        your <span class="codefrag">cocoon.xconf</span> properly. The avalon
  +        component <span class="codefrag">org.apache.cocoon.components.search.LuceneCocoonSearcher</span>
  +        is used by the SearchGenerator.
  +        Usually this component is specified in 
  +        <span class="codefrag">cocoon.roles</span> and the <span class="codefrag">cocoon.xconf</span> file
  +        for the default cocoon webapp.
  +      </p>
  +<p>
  +        Inside of a sitemap you have to define the SearchGenerator in the
  +        generator componenets section.
  +      </p>
  +<p>
  +        Moreover you have to match a URI to the SearchGenerator processing, the
  +        following example matches the URI <span class="codefrag">findIt</span> to the 
  +        SearchGenerator processing. The stylesheet <span class="codefrag">search2html.xsl</span>
  +        transforms the xml content of SearchGenerator to html:
  +      </p>
  +<pre class="code">
  +&lt;map:match pattern="findIt"&gt;
  +  &lt;map:generate type="search"/&gt;
  +  &lt;map:transform type="log"/&gt;
  +  &lt;map:transform src="stylesheets/search2html.xsl"/&gt;
  +  &lt;map:serialize/&gt;
  +&lt;/map:match&gt;
  +</pre>
  +</div>
  +    
  +<a name="N10177"></a><a name="DTD"></a>
  +<h3>DTD</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>XML generated by SearchGenerator uses namespace 
  +      <span class="codefrag">http://apache.org/cocoon/search/1.0</span>.
  +      The DTD of XML generated by SearchGenerator:
  +      </p>
  +<pre class="code">
  +&lt;!ELEMENT results (hits,navigation)?&gt;
  +
  +&lt;!ATTLIST results
  +   date CDATA #IMPLIED
  +   query-string CDATA #IMPLIED
  +   start-index CDATA #IMPLIED
  +   page-length CDATA #IMPLIED
  +&gt;
  +
  +&lt;!ELEMENT hits (hit)*&gt;
  +&lt;!ATTLIST hits
  +   total-count CDATA #IMPLIED
  +   count-of-pages CDATA #IMPLIED
  +&gt;
  +
  +&lt;!ELEMENT hit (#PCDATA)&gt;
  +&lt;!ATTLIST hit
  +   rank CDATA #REQUIRED
  +   score CDATA #IMPLIED
  +   uri CDATA #IMPLIED
  +&gt;
  +
  +&lt;!ELEMENT field (#PCDATA)&gt;
  +&lt;!ATTLIST field
  +   name CDATA #REQUIRED
  +&gt;
  +
  +&lt;!ELEMENT navigation (navigation-page)*&gt;
  +&lt;!ATTLIST navigation
  +   total-count CDATA #IMPLIED
  +   count-of-pages CDATA #IMPLIED
  +&gt;
  +
  +&lt;!ELEMENT navigation-page EMPTY&gt;
  +&lt;!ATTLIST navigation
  +   start-index CDATA #IMPLIED
  +&gt;
  +</pre>
  +</div>
  +    
  +<a name="N10188"></a><a name="Example"></a>
  +<h3>Example</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The search generator generates following xml content, for the query
  +        <span class="codefrag">query-string=cocoon&amp;start-index=0&amp;page-length=10</span>.
  +      </p>
  +<pre class="code">
  +&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  +&lt;search:results date="1008437081064" 
  + query-string="cocoon" start-index="0" page-length="10"
  + xmlns:search="http://apache.org/cocoon/search/1.0"
  + xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  + &lt;search:hits total-count="125" count-of-pages="13"&gt;
  +   &lt;search:hit rank="0" score="1.0" 
  +     uri="http://localhost:8080/cocoon/documents/hosting.html"/&gt;
  +   &lt;search:hit rank="1" score="1.0" 
  +     uri="http://localhost:8080/cocoon/documents/hosting.html"/&gt;
  +   &lt;search:hit rank="2" score="1.0"
  +     uri="http://localhost:8080/cocoon/documents/hosting.html"/&gt;
  +   &lt;search:hit rank="3" score="0.93121004"
  +     uri="http://localhost:8080/cocoon/documents/userdocs/actions/actions.html"/&gt;
  +   &lt;search:hit rank="4" score="0.93121004"
  +     uri="http://localhost:8080/cocoon/documents/userdocs/actions/actions.html"/&gt;
  +   &lt;search:hit rank="5" score="0.7112235"
  +     uri="http://localhost:8080/cocoon/documents/mail-archives.html"/&gt;
  +   &lt;search:hit rank="6" score="0.70967746"
  +     uri="http://localhost:8080/cocoon/documents/userdocs/
  +     serializers/link-serializer.html"/&gt;
  +   &lt;search:hit rank="7" score="0.6881721"
  +     uri="http://localhost:8080/cocoon/documents/userdocs/
  +     serializers/text-serializer.html"/&gt;
  +   &lt;search:hit rank="8" score="0.6881721"
  +     uri="http://localhost:8080/cocoon/documents/userdocs/
  +     serializers/vrml-serializer.html"/&gt;
  +   &lt;search:hit rank="9" score="0.6666666" 
  +     uri="http://localhost:8080/cocoon/documents/userdocs/
  +     serializers/svgpng-serializer.html"/&gt;
  + &lt;/search:hits&gt;
  + &lt;search:navigation total-count="125" count-of-pages="13"
  +   has-next="true" has-previous="false" next-index="10" previous-index="0"&gt;
  +   &lt;search:navigation-page start-index="0"/&gt;
  +   &lt;search:navigation-page start-index="10"/&gt;
  +   &lt;search:navigation-page start-index="20"/&gt;
  +   &lt;search:navigation-page start-index="30"/&gt;
  +   &lt;search:navigation-page start-index="40"/&gt;
  +   &lt;search:navigation-page start-index="50"/&gt;
  +   &lt;search:navigation-page start-index="60"/&gt;
  +   &lt;search:navigation-page start-index="70"/&gt;
  +   &lt;search:navigation-page start-index="80"/&gt;
  +   &lt;search:navigation-page start-index="90"/&gt;
  +   &lt;search:navigation-page start-index="100"/&gt;
  +   &lt;search:navigation-page start-index="110"/&gt;
  +   &lt;search:navigation-page start-index="120"/&gt;
  + &lt;/search:navigation&gt;
  +&lt;/search:results&gt;
  +</pre>
  +</div>
  +  
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +91 -108   cocoon-site/site/2.1/userdocs/generators/search-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +343 -339  cocoon-site/site/2.1/userdocs/generators/serverpages-generator.html
  
  Index: serverpages-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/serverpages-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- serverpages-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ serverpages-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,339 +1,343 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Server Pages Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Server Pages Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Server Pages Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="serverpages-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Server+Pages+Generator">Server Pages Generator</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Server+Pages+Generator"></a>
  -<h3>Server Pages Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>????.</p>
  -<ul>
  -				
  -<li>Name : serverpages</li>
  -				
  -<li>Class: org.apache.cocoon.generation.ServerPagesGenerator</li>
  -				
  -<li>Cacheable: ????.</li>
  -			
  -</ul>
  -<pre class="code">
  -     
  -  &lt;map:generate type="serverpages"/&gt;
  -     
  -</pre>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Server Pages Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Server Pages Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Server Pages Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="serverpages-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Server+Pages+Generator">Server Pages Generator</a>
  +</li>
  +</ul>
  +		
  +<a name="N1001C"></a><a name="Server+Pages+Generator"></a>
  +<h3>Server Pages Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>????.</p>
  +<ul>
  +				
  +<li>Name : serverpages</li>
  +				
  +<li>Class: org.apache.cocoon.generation.ServerPagesGenerator</li>
  +				
  +<li>Cacheable: ????.</li>
  +			
  +</ul>
  +<pre class="code">
  +     
  +  &lt;map:generate type="serverpages"/&gt;
  +     
  +</pre>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +43 -60    cocoon-site/site/2.1/userdocs/generators/serverpages-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +423 -419  cocoon-site/site/2.1/userdocs/generators/status-generator.html
  
  Index: status-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/status-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- status-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ status-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,419 +1,423 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Status Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Status Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Status Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="status-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Status+Generator">Status Generator</a>
  -</li>
  -<li>
  -<a href="#DTD">DTD</a>
  -</li>
  -<li>
  -<a href="#Example">Example</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Status+Generator"></a>
  -<h3>Status Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The status generator creates xml from the current status of cocoon.</p>
  -<p>The information is surrounded by the root element <span class="codefrag">statusinfo</span>
  -                     and grouped with the elements <span class="codefrag">group</span> and <span class="codefrag">value</span>.</p>
  -<p>The <span class="codefrag">statusinfo</span> element has the attributes <span class="codefrag">host</span>
  -                     and <span class="codefrag">date</span>.</p>
  -<p>A group collects several informations about one topic. The topic
  -                     is set by the attribute <span class="codefrag">name</span> of the group. A group
  -                     can have subgroups (element <span class="codefrag">group</span>) or values.</p>
  -<p>Each value has a name specified by the attribute <span class="codefrag">name</span> and can
  -                     consist of one or several <span class="codefrag">line</span>.</p>
  -<p>All elements have the namespace <span class="codefrag">http://apache.org/cocoon/status/2.0</span>.</p>
  -<ul>
  -				
  -<li>Name : status</li>
  -				
  -<li>Class: org.apache.cocoon.generation.StatusGenerator</li>
  -				
  -<li>Cacheable: no.</li>
  -			
  -</ul>
  -<pre class="code">
  -     
  -  &lt;map:generate type="status"/&gt;
  -     
  -</pre>
  -</div>
  -                
  -<a name="N10066"></a><a name="DTD"></a>
  -<h3>DTD</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>XML generated by status generator uses namespace 
  -                  <span class="codefrag">http://apache.org/cocoon/status/2.0</span>. The DTD of XML
  -                  generated by status generator:
  -                </p>
  -<pre class="code">
  -&lt;!ELEMENT statusinfo (group|value)*&gt;
  -
  -&lt;!ATTLIST statusinfo
  -   date CDATA #IMPLIED
  -   host CDATA #IMPLIED
  -&gt;
  -
  -&lt;!ELEMENT group (group|value)*&gt;
  -&lt;!ATTLIST group
  -   name CDATA #IMPLIED
  -&gt;
  -
  -&lt;!ELEMENT value (line)+&gt;
  -&lt;!ATTLIST value
  -   name CDATA #REQUIRED
  -
  -&lt;!ELEMENT line (#PCDATA)+&gt;
  -</pre>
  -</div>
  -		
  -<a name="N10077"></a><a name="Example"></a>
  -<h3>Example</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>The current status generator outputs information about the jvm:</p>
  -<pre class="code">
  -     
  -&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  -&lt;statusinfo date="16.07.2001 16:46:20" host="myhost" 
  -            xmlns="http://apache.org/cocoon/status/2.0" 
  -            xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  -  &lt;group name="vm"&gt;
  -    &lt;group name="memory"&gt;
  -      &lt;value name="total"&gt;&lt;line&gt;11788288&lt;/line&gt;&lt;/value&gt;
  -      &lt;value name="free"&gt;&lt;line&gt;2778208&lt;/line&gt;&lt;/value&gt;
  -    &lt;/group&gt;
  -    &lt;group name="jre"&gt;
  -      &lt;value name="version"&gt;&lt;line&gt;1.3.0&lt;/line&gt;&lt;/value&gt;
  -      &lt;value type="simple" href="http://java.sun.com/" name="java-vendor"&gt;
  -        &lt;line&gt;Sun Microsystems Inc.&lt;/line&gt;
  -      &lt;/value&gt;
  -    &lt;/group&gt;
  -    &lt;group name="operating-system"&gt;
  -      &lt;value name="name"&gt;&lt;line&gt;Windows 2000&lt;/line&gt;&lt;/value&gt;
  -      &lt;value name="architecture"&gt;&lt;line&gt;x86&lt;/line&gt;&lt;/value&gt;
  -      &lt;value name="version"&gt;&lt;line&gt;5.0&lt;/line&gt;&lt;/value&gt;
  -    &lt;/group&gt;
  -    &lt;value name="classpath"&gt;
  -      &lt;line&gt;classes&lt;/line&gt;
  -      &lt;line&gt;lib\ant.jar&lt;/line&gt;
  -      &lt;line&gt;lib\jasper.jar&lt;/line&gt;
  -    &lt;/value&gt;
  -  &lt;/group&gt;
  -&lt;/statusinfo&gt;     
  -</pre>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Status Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Status Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Status Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="status-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Status+Generator">Status Generator</a>
  +</li>
  +<li>
  +<a href="#DTD">DTD</a>
  +</li>
  +<li>
  +<a href="#Example">Example</a>
  +</li>
  +</ul>
  +		
  +<a name="N1001C"></a><a name="Status+Generator"></a>
  +<h3>Status Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The status generator creates xml from the current status of cocoon.</p>
  +<p>The information is surrounded by the root element <span class="codefrag">statusinfo</span>
  +                     and grouped with the elements <span class="codefrag">group</span> and <span class="codefrag">value</span>.</p>
  +<p>The <span class="codefrag">statusinfo</span> element has the attributes <span class="codefrag">host</span>
  +                     and <span class="codefrag">date</span>.</p>
  +<p>A group collects several informations about one topic. The topic
  +                     is set by the attribute <span class="codefrag">name</span> of the group. A group
  +                     can have subgroups (element <span class="codefrag">group</span>) or values.</p>
  +<p>Each value has a name specified by the attribute <span class="codefrag">name</span> and can
  +                     consist of one or several <span class="codefrag">line</span>.</p>
  +<p>All elements have the namespace <span class="codefrag">http://apache.org/cocoon/status/2.0</span>.</p>
  +<ul>
  +				
  +<li>Name : status</li>
  +				
  +<li>Class: org.apache.cocoon.generation.StatusGenerator</li>
  +				
  +<li>Cacheable: no.</li>
  +			
  +</ul>
  +<pre class="code">
  +     
  +  &lt;map:generate type="status"/&gt;
  +     
  +</pre>
  +</div>
  +                
  +<a name="N10066"></a><a name="DTD"></a>
  +<h3>DTD</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>XML generated by status generator uses namespace 
  +                  <span class="codefrag">http://apache.org/cocoon/status/2.0</span>. The DTD of XML
  +                  generated by status generator:
  +                </p>
  +<pre class="code">
  +&lt;!ELEMENT statusinfo (group|value)*&gt;
  +
  +&lt;!ATTLIST statusinfo
  +   date CDATA #IMPLIED
  +   host CDATA #IMPLIED
  +&gt;
  +
  +&lt;!ELEMENT group (group|value)*&gt;
  +&lt;!ATTLIST group
  +   name CDATA #IMPLIED
  +&gt;
  +
  +&lt;!ELEMENT value (line)+&gt;
  +&lt;!ATTLIST value
  +   name CDATA #REQUIRED
  +
  +&lt;!ELEMENT line (#PCDATA)+&gt;
  +</pre>
  +</div>
  +		
  +<a name="N10077"></a><a name="Example"></a>
  +<h3>Example</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The current status generator outputs information about the jvm:</p>
  +<pre class="code">
  +     
  +&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  +&lt;statusinfo date="16.07.2001 16:46:20" host="myhost" 
  +            xmlns="http://apache.org/cocoon/status/2.0" 
  +            xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  +  &lt;group name="vm"&gt;
  +    &lt;group name="memory"&gt;
  +      &lt;value name="total"&gt;&lt;line&gt;11788288&lt;/line&gt;&lt;/value&gt;
  +      &lt;value name="free"&gt;&lt;line&gt;2778208&lt;/line&gt;&lt;/value&gt;
  +    &lt;/group&gt;
  +    &lt;group name="jre"&gt;
  +      &lt;value name="version"&gt;&lt;line&gt;1.3.0&lt;/line&gt;&lt;/value&gt;
  +      &lt;value type="simple" href="http://java.sun.com/" name="java-vendor"&gt;
  +        &lt;line&gt;Sun Microsystems Inc.&lt;/line&gt;
  +      &lt;/value&gt;
  +    &lt;/group&gt;
  +    &lt;group name="operating-system"&gt;
  +      &lt;value name="name"&gt;&lt;line&gt;Windows 2000&lt;/line&gt;&lt;/value&gt;
  +      &lt;value name="architecture"&gt;&lt;line&gt;x86&lt;/line&gt;&lt;/value&gt;
  +      &lt;value name="version"&gt;&lt;line&gt;5.0&lt;/line&gt;&lt;/value&gt;
  +    &lt;/group&gt;
  +    &lt;value name="classpath"&gt;
  +      &lt;line&gt;classes&lt;/line&gt;
  +      &lt;line&gt;lib\ant.jar&lt;/line&gt;
  +      &lt;line&gt;lib\jasper.jar&lt;/line&gt;
  +    &lt;/value&gt;
  +  &lt;/group&gt;
  +&lt;/statusinfo&gt;     
  +</pre>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +60 -77    cocoon-site/site/2.1/userdocs/generators/status-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +426 -422  cocoon-site/site/2.1/userdocs/generators/stream-generator.html
  
  Index: stream-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/stream-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- stream-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ stream-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,422 +1,426 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Stream Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Stream Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Stream Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="stream-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Kinga Dziembowska,&nbsp;Davanum Srinivas</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Stream+Generator">Stream Generator</a>
  -<ul class="minitoc">
  -<li>
  -<a href="#PostInputStream">PostInputStream</a>
  -</li>
  -<li>
  -<a href="#See+it+in+Action">See it in Action</a>
  -</li>
  -</ul>
  -</li>
  -</ul>
  -		
  -<a name="N10020"></a><a name="Stream+Generator"></a>
  -<h3>Stream Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -      	      The StreamGenerator is a class that reads XML from an HttpRequest 
  -            	InputStream and generates SAX Events. StreamGenerator expects 
  -	            XML data coming as POST message. 
  -      	      </p>
  -<ul>
  -				
  -<li>Name : stream</li>
  -				
  -<li>Class: org.apache.cocoon.generation.StreamGenerator</li>
  -				
  -<li>Cacheable: no.</li>
  -			
  -</ul>
  -<p>
  -         		For POST requests with mimetype of application/x-www-form-urlencoded, 
  -		      the xml data expects to be associated with the name specified 
  -            	in the sitemap parameter.
  -	            </p>
  -<p>
  -            	For POST requests with mimetypes: text/plain, text/xml, application/xml 
  -	            the xml data is in the body of the POST request and its length is 
  -      	      specified by the value returned by getContentLength() method.
  -            	</p>
  -<a name="N1003A"></a><a name="PostInputStream"></a>
  -<h4>PostInputStream</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -	            The StreamGenerator uses helper class org.apache.cocoon.util.PostInputStream 
  -      	      for InputStream reading operations. At the time that Parser reads the data 
  -            	out of InputStream - Parser has no knowledge about the length of data to be
  -	            read. The only way to signal to the Parser that all data was read from the 
  -      	      InputStream is to control reading   operation - PostInputStream- and to 
  -            	return to the requestor -1 when the number of bytes read is equal to the 
  -	            getContentLength() value.
  -      	      </p>
  -</div>
  -<a name="N10043"></a><a name="See+it+in+Action"></a>
  -<h4>See it in Action</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -            	The Generator is a generic object, i.e. it can process any stream out of the 
  -      	      POST message there are two ways to see StreamGenerator in action:
  -	            </p>
  -<ul>
  -	                
  -<li>To invoke URL http://localhost:8080/cocoon/Order</li>
  -      	          
  -<li>To use telnet program to generate POST request</li>
  -            	
  -</ul>
  -<p>  
  -	            The first option is not a "pure" stream invocation, but it is quick way to 
  -            	observe desired effects. The result of this invocation is a form containing 
  -      	      the XML document embedded in the textarea of the form. Submission of this 
  -	            form will invoke StreamGenerator. The testarea name/value par is specified 
  -            	as a parameter in the sitemap definition for the StreamGenerator. The expected 
  -      	      result is the submitted xml document send back to the browser.
  -	            </p>
  -<p>
  -      	      The second or "pure" option of testing StreamGenerator "in action," requires the 
  -	            use of Telnet program or any other process able to generate correct POST message. 
  -            	The procedure is:
  -      	      </p>
  -<ul>
  -            	    
  -<li>To invoke telnet, connect to localhost 8080 and to use content of 
  -      	              <a href="telnet.txt">telnet.txt</a> file as a post message. 
  -	                </li>
  -            	    
  -<li>Here, the Copy-Paste method should be used.</li>
  -      	          
  -<li>Remember to hit the enter button twice enter after the contents of the post are set in telnet.</li>
  -	            
  -</ul>
  -<p>
  -      	      It is important because Content-len is calculated assuming two "enter" in the end of http message. 
  -	            Once again, the performed task results in the mirror of the original document being sent back to the requestor. 
  -            	</p>
  -<p>
  -	            The "pure" stream generation can be observed using the telnet utility where you can invoke a 
  -            	message targeting my processing. Any other method is good (URL object connection) as 
  -      	      long the message is well formed.
  -	            </p>
  -<pre class="code">
  -     
  -  &lt;map:generate type="stream"/&gt;
  -     
  -</pre>
  -</div>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Stream Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Stream Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Stream Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="stream-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Kinga Dziembowska,&nbsp;Davanum Srinivas</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Stream+Generator">Stream Generator</a>
  +<ul class="minitoc">
  +<li>
  +<a href="#PostInputStream">PostInputStream</a>
  +</li>
  +<li>
  +<a href="#See+it+in+Action">See it in Action</a>
  +</li>
  +</ul>
  +</li>
  +</ul>
  +		
  +<a name="N10020"></a><a name="Stream+Generator"></a>
  +<h3>Stream Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +      	      The StreamGenerator is a class that reads XML from an HttpRequest 
  +            	InputStream and generates SAX Events. StreamGenerator expects 
  +	            XML data coming as POST message. 
  +      	      </p>
  +<ul>
  +				
  +<li>Name : stream</li>
  +				
  +<li>Class: org.apache.cocoon.generation.StreamGenerator</li>
  +				
  +<li>Cacheable: no.</li>
  +			
  +</ul>
  +<p>
  +         		For POST requests with mimetype of application/x-www-form-urlencoded, 
  +		      the xml data expects to be associated with the name specified 
  +            	in the sitemap parameter.
  +	            </p>
  +<p>
  +            	For POST requests with mimetypes: text/plain, text/xml, application/xml 
  +	            the xml data is in the body of the POST request and its length is 
  +      	      specified by the value returned by getContentLength() method.
  +            	</p>
  +<a name="N1003A"></a><a name="PostInputStream"></a>
  +<h4>PostInputStream</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +	            The StreamGenerator uses helper class org.apache.cocoon.util.PostInputStream 
  +      	      for InputStream reading operations. At the time that Parser reads the data 
  +            	out of InputStream - Parser has no knowledge about the length of data to be
  +	            read. The only way to signal to the Parser that all data was read from the 
  +      	      InputStream is to control reading   operation - PostInputStream- and to 
  +            	return to the requestor -1 when the number of bytes read is equal to the 
  +	            getContentLength() value.
  +      	      </p>
  +</div>
  +<a name="N10043"></a><a name="See+it+in+Action"></a>
  +<h4>See it in Action</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +            	The Generator is a generic object, i.e. it can process any stream out of the 
  +      	      POST message there are two ways to see StreamGenerator in action:
  +	            </p>
  +<ul>
  +	                
  +<li>To invoke URL http://localhost:8080/cocoon/Order</li>
  +      	          
  +<li>To use telnet program to generate POST request</li>
  +            	
  +</ul>
  +<p>  
  +	            The first option is not a "pure" stream invocation, but it is quick way to 
  +            	observe desired effects. The result of this invocation is a form containing 
  +      	      the XML document embedded in the textarea of the form. Submission of this 
  +	            form will invoke StreamGenerator. The testarea name/value par is specified 
  +            	as a parameter in the sitemap definition for the StreamGenerator. The expected 
  +      	      result is the submitted xml document send back to the browser.
  +	            </p>
  +<p>
  +      	      The second or "pure" option of testing StreamGenerator "in action," requires the 
  +	            use of Telnet program or any other process able to generate correct POST message. 
  +            	The procedure is:
  +      	      </p>
  +<ul>
  +            	    
  +<li>To invoke telnet, connect to localhost 8080 and to use content of 
  +      	              <a href="telnet.txt">telnet.txt</a> file as a post message. 
  +	                </li>
  +            	    
  +<li>Here, the Copy-Paste method should be used.</li>
  +      	          
  +<li>Remember to hit the enter button twice enter after the contents of the post are set in telnet.</li>
  +	            
  +</ul>
  +<p>
  +      	      It is important because Content-len is calculated assuming two "enter" in the end of http message. 
  +	            Once again, the performed task results in the mirror of the original document being sent back to the requestor. 
  +            	</p>
  +<p>
  +	            The "pure" stream generation can be observed using the telnet utility where you can invoke a 
  +            	message targeting my processing. Any other method is good (URL object connection) as 
  +      	      long the message is well formed.
  +	            </p>
  +<pre class="code">
  +     
  +  &lt;map:generate type="stream"/&gt;
  +     
  +</pre>
  +</div>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +74 -104   cocoon-site/site/2.1/userdocs/generators/stream-generator.pdf
  
  	<<Binary file>>
  
  
  1.3       +55 -55    cocoon-site/site/2.1/userdocs/generators/telnet.txt
  
  Index: telnet.txt
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/telnet.txt,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- telnet.txt	21 May 2003 17:47:57 -0000	1.2
  +++ telnet.txt	11 Jul 2003 00:32:52 -0000	1.3
  @@ -1,55 +1,55 @@
  -POST /cocoon/request1 HTTP/1.1
  -Content-Type: text/plain
  -Content-Length:1513
  -
  -<?xml version="1.0"?>
  -<Orders>
  -	<OrderID>20259</OrderID>
  -	<CustomerID>WWWWWWW</CustomerID>
  -	<EmployeeID>6</EmployeeID>
  -	<OrderDate>2001-05-05 00:00:00</OrderDate>
  -	<RequiredDate>2001-06-05 00:00:00</RequiredDate>
  -	<ShippedDate>2001-06-01 00:00:00</ShippedDate>
  -	<ShipVia>1</ShipVia>
  -	<Freight>11.6100</Freight>
  -	<ShipName>Thoms White</ShipName>
  -	<ShipAddress>Somestr. 48</ShipAddress>
  -	<ShipCity>Munster</ShipCity>
  -	<ShipRegion>West</ShipRegion>
  -	<ShipPostalCode>00000</ShipPostalCode>
  -	<ShipCountry>Germany</ShipCountry>
  -	<OrderDetails>
  -		<OrderID>20259</OrderID>
  -		<ProductID>51</ProductID>
  -		<UnitPrice>42.4000</UnitPrice>
  -		<Quantity>40</Quantity>
  -		<Discount>0.0</Discount>
  -	</OrderDetails>
  -	<OrderDetails>
  -		<OrderID>20259</OrderID>
  -		<ProductID>14</ProductID>
  -		<UnitPrice>18.6000</UnitPrice>
  -		<Quantity>9</Quantity>
  -		<Discount>0.0</Discount>
  -	</OrderDetails>
  -	<OrderDetails>
  -		<OrderID>20259</OrderID>
  -		<ProductID>7</ProductID>
  -		<UnitPrice>12.4000</UnitPrice>
  -		<Quantity>30</Quantity>
  -		<Discount>0.0</Discount>
  -	</OrderDetails>
  -	<Customers>
  -		<CustomerID>WWWWWWW</CustomerID>
  -		<CompanyName>Thomas White</CompanyName>
  -		<ContactName>Karin Black</ContactName>
  -		<ContactTitle>Marketing Manager</ContactTitle>
  -		<Address>Somestr. 48</Address>
  -		<City>Munster</City>
  -		<Region>West</Region>
  -		<PostalCode>00000</PostalCode>
  -		<Country>Germany</Country>
  -		<Phone>xxxx-yyyyyy</Phone>
  -		<Fax>xxxx-yyyyyy</Fax>
  -	</Customers>
  -</Orders>
  +POST /cocoon/request1 HTTP/1.1
  +Content-Type: text/plain
  +Content-Length:1513
  +
  +<?xml version="1.0"?>
  +<Orders>
  +	<OrderID>20259</OrderID>
  +	<CustomerID>WWWWWWW</CustomerID>
  +	<EmployeeID>6</EmployeeID>
  +	<OrderDate>2001-05-05 00:00:00</OrderDate>
  +	<RequiredDate>2001-06-05 00:00:00</RequiredDate>
  +	<ShippedDate>2001-06-01 00:00:00</ShippedDate>
  +	<ShipVia>1</ShipVia>
  +	<Freight>11.6100</Freight>
  +	<ShipName>Thoms White</ShipName>
  +	<ShipAddress>Somestr. 48</ShipAddress>
  +	<ShipCity>Munster</ShipCity>
  +	<ShipRegion>West</ShipRegion>
  +	<ShipPostalCode>00000</ShipPostalCode>
  +	<ShipCountry>Germany</ShipCountry>
  +	<OrderDetails>
  +		<OrderID>20259</OrderID>
  +		<ProductID>51</ProductID>
  +		<UnitPrice>42.4000</UnitPrice>
  +		<Quantity>40</Quantity>
  +		<Discount>0.0</Discount>
  +	</OrderDetails>
  +	<OrderDetails>
  +		<OrderID>20259</OrderID>
  +		<ProductID>14</ProductID>
  +		<UnitPrice>18.6000</UnitPrice>
  +		<Quantity>9</Quantity>
  +		<Discount>0.0</Discount>
  +	</OrderDetails>
  +	<OrderDetails>
  +		<OrderID>20259</OrderID>
  +		<ProductID>7</ProductID>
  +		<UnitPrice>12.4000</UnitPrice>
  +		<Quantity>30</Quantity>
  +		<Discount>0.0</Discount>
  +	</OrderDetails>
  +	<Customers>
  +		<CustomerID>WWWWWWW</CustomerID>
  +		<CompanyName>Thomas White</CompanyName>
  +		<ContactName>Karin Black</ContactName>
  +		<ContactTitle>Marketing Manager</ContactTitle>
  +		<Address>Somestr. 48</Address>
  +		<City>Munster</City>
  +		<Region>West</Region>
  +		<PostalCode>00000</PostalCode>
  +		<Country>Germany</Country>
  +		<Phone>xxxx-yyyyyy</Phone>
  +		<Fax>xxxx-yyyyyy</Fax>
  +	</Customers>
  +</Orders>
  
  
  
  1.5       +465 -461  cocoon-site/site/2.1/userdocs/generators/velocity-generator.html
  
  Index: velocity-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/velocity-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- velocity-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ velocity-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,461 +1,465 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Velocity Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Velocity Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Velocity Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="velocity-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<h3>in @doctitle@</h3>
  -<p>
  -<font size="-2">by&nbsp;Carsten Ziegeler</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Velocity+Generator">Velocity Generator</a>
  -<ul class="minitoc">
  -<li>
  -<a href="#Sitemap+Configuration">Sitemap Configuration</a>
  -</li>
  -</ul>
  -</li>
  -</ul>
  -  
  -<a name="N1001F"></a><a name="Velocity+Generator"></a>
  -<h3>Velocity Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -   Allows Velocity template to be used as a generator. 
  -   Builds upon the Velocity servlet functionality - overrides 
  -   the output method in order to pipe the results into SAX events.
  -  </p>
  -<ul>
  -   
  -<li>Name : velocity</li>
  -   
  -<li>Class: org.apache.cocoon.generation.VelocityGenerator</li>
  -   
  -<li>Cacheable: ????.</li>
  -  
  -</ul>
  -<pre class="code">
  -
  -&lt;map:generate type="velocity"/&gt;
  -
  -  </pre>
  -<p>
  -   Cocoon Generator that produces dynamic XML SAX events
  -   from a Velocity template file.
  -  </p>
  -<a name="N1003B"></a><a name="Sitemap+Configuration"></a>
  -<h4>Sitemap Configuration</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -    Attributes:
  -   </p>
  -<dl>
  -    
  -<dt>usecache (optional; default: 'false')</dt> 
  -    
  -<dd>
  -     set to 'true' to enable template caching on the 'cocoon'
  -     resource loader
  -    </dd>
  -   
  -    
  -<dt>checkInterval (optional; default: '0')</dt>
  -    
  -<dd>
  -     This is the number of seconds between modification checks when
  -     caching is turned on.  When this is an integer &gt; 0, this represents
  -     the number of seconds between checks to see if the template was
  -     modified. If the template has been modified since last check, then
  -     it is reloaded and reparsed. Otherwise nothing is done. When &lt;= 0,
  -     no modification checks will take place, and assuming that the
  -     property cache (above) is true, once a template is loaded and
  -     parsed the first time it is used, it will not be checked or
  -     reloaded after that until the application or servlet engine is
  -     restarted.
  -    </dd>
  -   
  -</dl>
  -<p>
  -   Child Elements:
  -   </p>
  -<dl>
  -    
  -<dt>&lt;property key="propertyKey" value="propertyValue"/&gt;
  -     (optional; 0..n)</dt>
  -    
  -<dd>
  -     An additional property to pass along to the Velocity template
  -     engine during initialization
  -    </dd>
  -    
  -    
  -<dt>&lt;resource-loader name="loaderName" class="javaClassName"/&gt;
  -     (optional; 0..n; children: property*)</dt>
  -    
  -<dd>
  -     The default configuration uses the 'cocoon' resource loader
  -     which resolves resources via the Cocoon SourceResolver. Additional
  -     resource loaders can be added with this configuration
  -     element. Configuration properties for the resource loader can be
  -     specified by adding a child property element of the resource-loader
  -     element. The prefix '&lt;name&gt;.resource.loader.' is
  -     automatically added to the property name.
  -    </dd>
  -    
  -    
  -<dt>&lt;export-object key="objectMapKey" name="velocityContextName"/&gt;
  -     (optional; 0..n)</dt>
  -    
  -<dd>
  -     Export the object specified by <em>key</em> from the Cocoon
  -     object map to the Velocity context of the template.  The object can
  -     be accessed from the template as <em>name</em>. Be careful to use a
  -     valid VTL variable name.
  -    </dd>
  -   
  -</dl>
  -<p>
  -    Default Java objects exported to the Velocity context:
  -   </p>
  -<dl>
  -    
  -<dt>request (org.apache.cocoon.environment.Request)</dt>
  -    
  -<dd>The Cocoon current request</dd>
  -    
  -    
  -<dt>template (java.lang.String)</dt>
  -    
  -<dd>The path of the template file currently being evaluated</dd>
  -    
  -    
  -<dt>response (org.apache.cocoon.environment.Response)</dt>
  -    
  -<dd>The Cocoon response associated with the current request</dd>
  -    
  -    
  -<dt>context (org.apache.cocoon.environment.Context)</dt>
  -    
  -<dd>The Cocoon context associated with the current request</dd>
  -    
  -    
  -<dt>parameters (org.apache.avalon.framework.parameters.Parameters)</dt>
  -    
  -<dd>Any parameters passed to the generator in the pipeline</dd>
  -   
  -</dl>
  -<p>
  -    Additional Java objects can be exported from the Cocoon object
  -    map to the Velocity context by adding one or more &lt;export-object
  -    key="objectMapKey" name="velocityContextName"/&gt; child elements
  -    to the generator configuration in the sitemap.
  -   </p>
  -</div>
  -</div>
  - 
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Velocity Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Velocity Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Velocity Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="velocity-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<h3>in @doctitle@</h3>
  +<p>
  +<font size="-2">by&nbsp;Carsten Ziegeler</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Velocity+Generator">Velocity Generator</a>
  +<ul class="minitoc">
  +<li>
  +<a href="#Sitemap+Configuration">Sitemap Configuration</a>
  +</li>
  +</ul>
  +</li>
  +</ul>
  +  
  +<a name="N1001F"></a><a name="Velocity+Generator"></a>
  +<h3>Velocity Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +   Allows Velocity template to be used as a generator. 
  +   Builds upon the Velocity servlet functionality - overrides 
  +   the output method in order to pipe the results into SAX events.
  +  </p>
  +<ul>
  +   
  +<li>Name : velocity</li>
  +   
  +<li>Class: org.apache.cocoon.generation.VelocityGenerator</li>
  +   
  +<li>Cacheable: ????.</li>
  +  
  +</ul>
  +<pre class="code">
  +
  +&lt;map:generate type="velocity"/&gt;
  +
  +  </pre>
  +<p>
  +   Cocoon Generator that produces dynamic XML SAX events
  +   from a Velocity template file.
  +  </p>
  +<a name="N1003B"></a><a name="Sitemap+Configuration"></a>
  +<h4>Sitemap Configuration</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +    Attributes:
  +   </p>
  +<dl>
  +    
  +<dt>usecache (optional; default: 'false')</dt> 
  +    
  +<dd>
  +     set to 'true' to enable template caching on the 'cocoon'
  +     resource loader
  +    </dd>
  +   
  +    
  +<dt>checkInterval (optional; default: '0')</dt>
  +    
  +<dd>
  +     This is the number of seconds between modification checks when
  +     caching is turned on.  When this is an integer &gt; 0, this represents
  +     the number of seconds between checks to see if the template was
  +     modified. If the template has been modified since last check, then
  +     it is reloaded and reparsed. Otherwise nothing is done. When &lt;= 0,
  +     no modification checks will take place, and assuming that the
  +     property cache (above) is true, once a template is loaded and
  +     parsed the first time it is used, it will not be checked or
  +     reloaded after that until the application or servlet engine is
  +     restarted.
  +    </dd>
  +   
  +</dl>
  +<p>
  +   Child Elements:
  +   </p>
  +<dl>
  +    
  +<dt>&lt;property key="propertyKey" value="propertyValue"/&gt;
  +     (optional; 0..n)</dt>
  +    
  +<dd>
  +     An additional property to pass along to the Velocity template
  +     engine during initialization
  +    </dd>
  +    
  +    
  +<dt>&lt;resource-loader name="loaderName" class="javaClassName"/&gt;
  +     (optional; 0..n; children: property*)</dt>
  +    
  +<dd>
  +     The default configuration uses the 'cocoon' resource loader
  +     which resolves resources via the Cocoon SourceResolver. Additional
  +     resource loaders can be added with this configuration
  +     element. Configuration properties for the resource loader can be
  +     specified by adding a child property element of the resource-loader
  +     element. The prefix '&lt;name&gt;.resource.loader.' is
  +     automatically added to the property name.
  +    </dd>
  +    
  +    
  +<dt>&lt;export-object key="objectMapKey" name="velocityContextName"/&gt;
  +     (optional; 0..n)</dt>
  +    
  +<dd>
  +     Export the object specified by <em>key</em> from the Cocoon
  +     object map to the Velocity context of the template.  The object can
  +     be accessed from the template as <em>name</em>. Be careful to use a
  +     valid VTL variable name.
  +    </dd>
  +   
  +</dl>
  +<p>
  +    Default Java objects exported to the Velocity context:
  +   </p>
  +<dl>
  +    
  +<dt>request (org.apache.cocoon.environment.Request)</dt>
  +    
  +<dd>The Cocoon current request</dd>
  +    
  +    
  +<dt>template (java.lang.String)</dt>
  +    
  +<dd>The path of the template file currently being evaluated</dd>
  +    
  +    
  +<dt>response (org.apache.cocoon.environment.Response)</dt>
  +    
  +<dd>The Cocoon response associated with the current request</dd>
  +    
  +    
  +<dt>context (org.apache.cocoon.environment.Context)</dt>
  +    
  +<dd>The Cocoon context associated with the current request</dd>
  +    
  +    
  +<dt>parameters (org.apache.avalon.framework.parameters.Parameters)</dt>
  +    
  +<dd>Any parameters passed to the generator in the pipeline</dd>
  +   
  +</dl>
  +<p>
  +    Additional Java objects can be exported from the Cocoon object
  +    map to the Velocity context by adding one or more &lt;export-object
  +    key="objectMapKey" name="velocityContextName"/&gt; child elements
  +    to the generator configuration in the sitemap.
  +   </p>
  +</div>
  +</div>
  + 
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +52 -69    cocoon-site/site/2.1/userdocs/generators/velocity-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +721 -666  cocoon-site/site/2.1/userdocs/generators/wsproxy-generator.html
  
  Index: wsproxy-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/wsproxy-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- wsproxy-generator.html	21 May 2003 15:23:44 -0000	1.4
  +++ wsproxy-generator.html	11 Jul 2003 00:32:52 -0000	1.5
  @@ -1,666 +1,721 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Portal Syndication with Web Services and Cocoon</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">Web Service Proxy Generator</font></span>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>Portal Syndication with Web Services and Cocoon</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="wsproxy-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Ivelin Ivanov</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#What+Is+Web+Syndication%3F">What Is Web Syndication?</a>
  -</li>
  -<li>
  -<a href="#Going+beyond+RSS+with+Web+services+">Going beyond RSS with Web services </a>
  -<ul class="minitoc">
  -<li>
  -<a href="#Web+Services+Experience+Language+%28WSXL%29">Web Services Experience Language (WSXL)</a>
  -</li>
  -<li>
  -<a href="#Web+Services+Inspection+Language+%28WSIL%29">Web Services Inspection Language (WSIL)</a>
  -</li>
  -<li>
  -<a href="#Web+Services+for+Remote+Portals+%28WSRP%29">Web Services for Remote Portals (WSRP)</a>
  -</li>
  -<li>
  -<a href="#Web+Services+for+Interactive+Applications+">Web Services for Interactive Applications </a>
  -</li>
  -</ul>
  -</li>
  -<li>
  -<a href="#Apache+Cocoon">Apache Cocoon</a>
  -</li>
  -<li>
  -<a href="#Web+Services+Proxy+to+the+rescue">Web Services Proxy to the rescue</a>
  -</li>
  -<li>
  -<a href="#Conclusion">Conclusion</a>
  -<ul class="minitoc">
  -<li>
  -<a href="#Have+more+questions%3F+">Have more questions? </a>
  -</li>
  -</ul>
  -</li>
  -</ul>
  -    
  -<a name="N10013"></a><a name="What+Is+Web+Syndication%3F"></a>
  -<h3>What Is Web Syndication?</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -Web Site Syndication has gained popularity as more and more web sites cross reference each other, not only by a single hyperlink, but also by embedding parts of their content. The idea was pioneered by Netscape with their Rich Site Summary (RSS) (<a href="http://www.oasis-open.org/cover/rss.html">http://www.oasis-open.org/cover/rss.html</a>) XML format. RSS was developed in early 1999 to populate Netscape's My Netscape portal with external newsfeeds ("channels"). Since then RSS has taken on a life of its own and now thousands of Web sites use RSS as a "what's new" mechanism to drive traffic their way.      
  -      </p>
  -<p>
  -The current RSS 1.0 standard is an application of Resource Description Framework (RDF) (<a href="http://www.w3.org/TR/rdf-schema/">http://www.w3.org/TR/rdf-schema/</a>). RDF is a framework for describing and interchanging metadata. The RDF framework is extensible and allows adding new types of entities. It also gives meaning to resources to enable automated processing of Web resources.
  -</p>
  -<p>
  -RSS is unarguably an example of an organically grown and widely accepted standard. For long it was not endorsed by any of the popular standards committees. Even so it quickly became popular and found a large number of creative uses. Lately though it has reached its limits. There is a demand for more advanced portal syndication which RSS cannot satisfy.
  -</p>
  -</div>
  -
  -
  -    
  -<a name="N1002A"></a><a name="Going+beyond+RSS+with+Web+services+"></a>
  -<h3>Going beyond RSS with Web services </h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -Latest generation web portals demand more than simply posting cross linked news stories from RSS. Embedding and personalizing rich content and behavior from remote portals is becoming necessity. Limited success has been achieved through complex and sophisticated backend integration via proprietary or Web Services compliant protocols. Recognizing the growing demand, influential organizations have attempted to develop new languages such as:
  -</p>
  -<a name="N10032"></a><a name="Web+Services+Experience+Language+%28WSXL%29"></a>
  -<h4>Web Services Experience Language (WSXL)</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -      (<a href="http://www.webservices.org/index.php/article/articleview/345/">http://www.webservices.org/index.php/article/articleview/345/</a>)
  -      </p>
  -<p>
  -        
  -<em>
  -        "WSXL is a Web services centric component model for interactive Web applications. WSXL   is designed to achieve two main goals: enable businesses to distribute Web applications   through       multiple revenue channels, and enable new services or applications to be created by   leveraging       existing applications across the Web."       
  -        </em>
  -      
  -</p>
  -</div>
  -<a name="N10045"></a><a name="Web+Services+Inspection+Language+%28WSIL%29"></a>
  -<h4>Web Services Inspection Language (WSIL)</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -      (<a href="http://www.webservices.org/index.php/article/articleview/85/">http://www.webservices.org/index.php/article/articleview/85/</a>)
  -      </p>
  -<p>
  -        
  -<em>
  -       "The specification allows a Web services provider to publish a WS-Inspection (WSIL) document which lists the services on offer and their corresponding WSDL (Web services description language) files. The convention is that the WSIL document should be called "inspection.wsil" and be located at a common entry point to the web site. This paves the way for future Web services "crawlers" to locate and parse WSIL documents for Web service search engines."        
  -        </em>
  -      
  -</p>
  -</div>
  -<a name="N10058"></a><a name="Web+Services+for+Remote+Portals+%28WSRP%29"></a>
  -<h4>Web Services for Remote Portals (WSRP)</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -      (<a href="http://www.oasis-open.org/committees/wsrp/">http://www.oasis-open.org/committees/wsrp/</a>)
  -      </p>
  -<p>
  -        
  -<em>
  -      "Defining an XML and Web services standard that will allow the plug-n-play of visual, user-facing Web services with portals or other intermediary Web applications"         
  -        </em>
  -      
  -</p>
  -</div>
  -<a name="N1006B"></a><a name="Web+Services+for+Interactive+Applications+"></a>
  -<h4>Web Services for Interactive Applications </h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -      (<a href="http://www.oasis-open.org/committees/wsia/">http://www.oasis-open.org/committees/wsia/</a>)
  -      </p>
  -<p>
  -        
  -<em>
  -      "Create an XML and web services centric framework for interactive web applications. The designs must achieve two main goals: enable businesses to distribute web applications through multiple revenue channels, and enable new services or applications to be created by leveraging existing applications across the Web. "       
  -        </em>
  -      
  -</p>
  -</div>
  -<p>
  -While these efforts are certainly worthwhile and promising, it will most likely take years before they pass the filters of real life use before they can claim widespread adoption. All of them ask for a thick infrastructure layer to support implementations. While possible, it is unlikely that mainstream deployment will be achieved instantly.
  -</p>
  -<p>
  -Not all is lost though. Fortunately, there is way to satisfy a large portion of the syndication requirements by applying already established technologies and tools. We will illustrate the architecture of a possible solution using an open source framework for XML Publishing - Apache Cocoon.
  -</p>
  -</div>
  -
  -
  -
  -<a name="N10085"></a><a name="Apache+Cocoon"></a>
  -<h3>Apache Cocoon</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -      (<a href="http://cocoon.apache.org/index.html">http://cocoon.apache.org/index.html</a>)
  -      </p>
  -<p>
  -        
  -<em>
  -      "Apache Cocoon is an XML publishing framework that raises the usage of XML and XSLT technologies for server applications to a new level. Designed for performance and scalability around pipelined SAX processing, Cocoon offers a flexible environment based on a separation of concerns between content, logic, and style. To top this all off, Cocoon's centralized configuration system and sophisticated caching help you to create, deploy, and maintain rock-solid XML server applications"    
  -        </em>
  -      
  -</p>
  -<p>
  -First, let's describe a typical use case scenario: User logs in to a familiar portal and happily surfs about. At some point the user clicks on a link which leads to a strange page. It has the portal logo, even shows the same login id but still looks very different and unfriendly... After some time and frustration the user gets used to switching back and forth between the two faces of the portal... while looking for another provider which offers both services in a coherent graphical interface.
  -      </p>
  -<p>
  -For those who have never had similar experience, we will give a popular example. Yahoo! Autos (<a href="http://autos.yahoo.com/finance.html?refsrc=autos/insurance">http://autos.yahoo.com/finance.html?refsrc=autos/insurance</a>) 
  -offers an easy to use interactive catalog of cars. However when it comes to insuring an automobile, applying for a loan or buying a car, the web site hyperlinks to a co-branded page of another company. For example Lending Tree 
  -(<a href="https://www.lendingtree.com/newauto/secure/ctl_borrower.asp?page=loan_selection&verb=continue&O_loan_type=LOAN_TYPE_AUTO&bp=yahooautos&source=40050&alliance=true&SITEID=&templxlname=&templxssn1=&templxssn2=&templxssn3=">https://www.lendingtree.com/newauto/.....</a> )
  - will show Yahoo! Autos logo at the top of the screen, however the rest of the page looks very different than any other Yahoo! page. All the personalization spoils that a Yahoo! user enjoys are lost as soon as the application for a loan begins. Not only the colors and layout are different. A login session with Yahoo! does not carry over to Lending Tree. On top of that a pop-up window appears when switching between the two sites, which reads "You are about to view pages over a secure connection...". When added up these "negligible" inadequacies, lead to an overall poor experience, which is certainly not the original intent of the Yahoo! content producers.
  -</p>
  -<p>
  -Now as we have an idea of how things are not supposed to work, we will show that outsourcing interactive components to a third party site, while preserving the look &amp; feel of the original portal is still possible when done right. As we mentioned Cocoon offers a solution. Since Cocoon is a very sophisticated framework, an indepth analysis of its features is beyond the scope of this text to cover. 
  -</p>
  -</div>
  -    
  -    
  -    
  -<a name="N100A9"></a><a name="Web+Services+Proxy+to+the+rescue"></a>
  -<h3>Web Services Proxy to the rescue</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -The latest version of Cocoon is 2.1, and it has a new Web Service Proxy component. It is this component which we shall focus on for the reminder of the text. To follow the rest of the article, it will be useful (but not essential) to have a basic knowledge of Cocoon 2.
  -</p>
  -<p>
  -Combined with the <a href="../../howto/xmlform-wizard/howto-xmlform-wizard.html">XMLForm</a> component of Cocoon 2 and XSLT, the Web Service Proxy component allows vendors to share interactive content with little effort. The Web Service Proxy takes advantage of the fact that a Cocoon web application produces XML content which is later translated into multiple presentation formats, like HTML or WML. Once the proxy is plugged in the Cocoon sitemap, it transparently pipes browser requests to a remote web application and returns the response back to the sitemap for local styling. Receiving a client independent XML format, allows the local site to pull content and style it with XSLT with the desired Look &amp; Feel.
  -</p>
  -<p>
  -        
  -<strong>
  -          Q. Ok, styling presentation is easy to understand, but how is a form submitted to the original site? 
  -        </strong>
  -      
  -</p>
  -<p>
  -      The XMLForm component is the answer. It uses W3C XForms included in the XML content which allows the end user to directly interact with the remote server through the embedding site. The form markup in the XML content of an embedded page uses relative URL address for the target action, when the end user submits, the form data is sent to the containing site, which captures the form data and the relative URL. The Web Service Proxy then takes this information and re-submits it to the original site. It then reads the XML response and makes it available to the sitemap for styling again.
  -      </p>
  -<p>
  -        
  -<strong>
  -          Q. Hmm... a typical web application maintains a user session while navigating. How is the containing site propagating the end user session to the embedded site? 
  -        </strong>
  -      
  -</p>
  -<p>
  -The answer is simple. The Web Service Proxy simply hooks to the end user session, and automatically starts its own session with the remote site. If the remote site requires authentication, then the developer of the local web site has to pass the user credentials as parameters to the WebServiceProxyGenerator.
  -      </p>
  -<p>
  -        
  -<strong>
  -          Q. What transport protocols are supported? 
  -        </strong>
  -      
  -</p>
  -<p>
  -HTTP 1.0, HTTP 1.1, HTTPS.
  -      </p>
  -<p>
  -Below we will illustrate the architecture of the solution with some example code and figures.
  -      </p>
  -<div align="center">
  -<img class="figure" alt="Figure 1 - Traditional Http Proxy vs Cocoon Web Service Proxy" src="images/wsproxy_Proxies.png"></div>
  -<p>
  -        
  -<em>
  -Figure 1 - Architecture of the Web Service Proxy Solution. As opposed to a traditional proxy server, the Web Services Proxy captures user input and allows the web site to remain coherent even when the functionality for some of its components is delivered remotely.       
  -        </em>
  -      
  -</p>
  -<div align="center">
  -<img class="figure" alt="Figure 2 - Illustration of the data flow for a composite page" src="images/wsproxy_CompositePage.png"></div>
  -<p>
  -        
  -<em>
  -Figure 2 - Illustration of the data flow for a composite page. Some of the content is locally constructed, the rest is obtained remotely. Finally the same styling is applied and the user facing page appears consistent.       
  -        </em>
  -      
  -</p>
  -<p>
  -      Now we will show a snippet of the sitemap which employs the Web Service Proxy. Notice its brevity! The Web Service Proxy completely handles the content and navigation logic between the two portals. Only stylesheets are additionally required to translate the remotely retrieved documents into a user friendly format.
  -      </p>
  -<pre class="code">
  -  &lt;?xml version="1.0"?&gt;
  -  &lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;
  -
  -    &lt;!-- =========================== Components ==================   --&gt;
  -    &lt;map:components&gt;
  -      &lt;map:generators default="file"&gt;
  -        &lt;map:generator name="wsproxy"
  -          src="org.apache.cocoon.generation.WebServiceProxyGenerator"
  -          logger="webapp.wsproxy"/&gt;
  -      &lt;/map:generators&gt;
  -    &lt;/map:components&gt;
  -
  -  ....
  -
  -    &lt;!-- =========================== Pipelines ======================       --&gt;
  -    &lt;map:pipelines&gt;
  -      &lt;map:pipeline&gt;
  -
  -        &lt;!-- Interactive Web Application Syndication  --&gt;
  -        &lt;map:match pattern="*"&gt;
  -          &lt;map:generate type="wsproxy"
  -            src="http://{header:host}/cocoon/samples/xmlform/wizard?cocoon-view=xml"
  -            label="xml"/&gt;
  -          &lt;map:transform src="stylesheets/newWizard2html.xsl" /&gt;
  -          &lt;map:transform src="context://samples/stylesheets/xmlform/xmlform2html.xsl"/&gt;
  -          &lt;map:serialize type="html"/&gt;
  -        &lt;/map:match&gt;
  -      &lt;/map:pipeline&gt;
  -    &lt;/map:pipelines&gt;
  -  &lt;/map:sitemap&gt;
  -  &lt;!-- end of file --&gt;
  - 
  -</pre>
  -<div align="center">
  -<img class="figure" alt="Figure 3 - sequence diagram " src="images/wsproxy_Sequence.png"></div>
  -<p>
  -        
  -<em>
  -Figure 3 - Above is a sequence diagram outlining the interaction between the key participants in a syndication session.     
  -        </em>
  -      
  -</p>
  -<div align="center">
  -<img class="figure" alt="screen shot 1" src="images/wsproxy_Screenshot1.png"></div>
  -<p>
  -        
  -<em>
  -Figure 4 - Sample screenshot from a remotely enabled application as it appears standalone.     
  -        </em>
  -      
  -</p>
  -<div align="center">
  -<img class="figure" alt="screen shot 2" src="images/wsproxy_Screenshot2.png"></div>
  -<p>
  -        
  -<em>
  -Figure 5 - Sample screenshot from the same application, embedded in another web application.   
  -        </em>
  -      
  -</p>
  -<p>
  -The content of the original XML page behind these two screenshot follows:
  -      </p>
  -<pre class="code">
  -
  - &lt;?xml version="1.0"?&gt;
  -  &lt;document xmlns:xf="http://apache.org/cocoon/xmlform/1.0"&gt;
  -    &lt;xf:form id="form-feedback" view="userIdentity" action="wizard" method="GET"&gt;
  -      &lt;xf:caption&gt;Personal Information&lt;/xf:caption&gt;
  -      &lt;error&gt;
  -        &lt;xf:violations class="error"/&gt;
  -      &lt;/error&gt;
  -      &lt;xf:textbox ref="firstName"&gt;
  -        &lt;xf:caption&gt;First Name&lt;/xf:caption&gt;
  -        &lt;xf:violations class="error"/&gt;
  -      &lt;/xf:textbox&gt;
  -
  -      ....
  -
  -      &lt;xf:selectMany ref="role" selectUIType="listbox"&gt;
  -        &lt;xf:caption&gt;Professional roles&lt;/xf:caption&gt;
  -        &lt;xf:item&gt;
  -          &lt;xf:caption&gt;Geek&lt;/xf:caption&gt;
  -          &lt;xf:value&gt;Geek&lt;/xf:value&gt;
  -        &lt;/xf:item&gt;
  -        &lt;xf:item&gt;
  -          &lt;xf:caption&gt;Hacker&lt;/xf:caption&gt;
  -          &lt;xf:value&gt;Hacker&lt;/xf:value&gt;
  -        &lt;/xf:item&gt;
  -        ....
  -      &lt;/xf:selectMany&gt;
  -      ...
  -      &lt;!-- hidden model attribute --&gt;
  -      &lt;xf:hidden ref="hidden"&gt;
  -        &lt;xf:value&gt;true&lt;/xf:value&gt;
  -      &lt;/xf:hidden&gt;
  -      ...
  -      &lt;xf:submit id="next" class="button"&gt;
  -        &lt;xf:caption&gt;Next&lt;/xf:caption&gt;
  -      &lt;/xf:submit&gt;
  -    &lt;/xf:form&gt;
  -
  -    &lt;xf:output ref="count" id="show_count" form="form-feedback" class="info"&gt;
  -      &lt;xf:caption&gt;Visits Count&lt;/xf:caption&gt;
  -    &lt;/xf:output&gt;
  -
  -  &lt;/document&gt;
  -
  - 
  -</pre>
  -<p>
  -The listing above contains markup in the XMLForm namespace. It is a presentation independent way to specify input controls. Being XForms compliant it is easy to learn and use. The XSLT stylesheets used to convert the XML above are very simple and will not be listed here. They can found in the Cocoon 2.1 distribution.
  -</p>
  -</div>
  -    
  -<a name="N1011C"></a><a name="Conclusion"></a>
  -<h3>Conclusion</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -The Web Service Proxy component is tightly integrated with the Cocoon framework and is particularly convenient to use in combination with XMLForm to enable syndication of Web site functionality. With the presented sample, we only scratched the service of the possible applications. It is easy to see though for a creative mind how it can be extended in multiple directions. Although the solution we offered is conveniently applied with Cocoon, the concepts are generally applicable outside the framework as well. Exposing a Web Application functionality via XML is not just a "neat" feature any more. It opens the gates to a constellation of opportunities, not possible with the classical Model-2 approach where the business logic is directly tied to a graphical output like HTML.
  -    </p>
  -<a name="N10124"></a><a name="Have+more+questions%3F+"></a>
  -<h4>Have more questions? </h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -        Look at the online demo available in the Cocoon distribution via: 
  -<span class="codefrag">http://localhost:8080/cocoon/samples/webserviceproxy/</span>
  -      
  -</p>
  -<p>
  -        Then study the source code and if you still have questions, join the cocoon users email list and ask. If you have ideas for improvement then you are more than welcome to discuss it on the cocoon development email list and eventually submit a patch through the Apache bug tracking system.
  -      </p>
  -</div>
  -</div>
  -  
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>Portal Syndication with Web Services and Cocoon</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">Web Service Proxy Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>Portal Syndication with Web Services and Cocoon</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="wsproxy-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Ivelin Ivanov</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#What+Is+Web+Syndication%3F">What Is Web Syndication?</a>
  +</li>
  +<li>
  +<a href="#Going+beyond+RSS+with+Web+Services">Going beyond RSS with Web Services</a>
  +<ul class="minitoc">
  +<li>
  +<a href="#Web+Services+Experience+Language+%28WSXL%29">Web Services Experience Language (WSXL)</a>
  +</li>
  +<li>
  +<a href="#Web+Services+Inspection+Language+%28WSIL%29">Web Services Inspection Language (WSIL)</a>
  +</li>
  +<li>
  +<a href="#Web+Services+for+Remote+Portals+%28WSRP%29">Web Services for Remote Portals (WSRP)</a>
  +</li>
  +<li>
  +<a href="#Web+Services+for+Interactive+Applications">Web Services for Interactive Applications</a>
  +</li>
  +</ul>
  +</li>
  +<li>
  +<a href="#Apache+Cocoon">Apache Cocoon</a>
  +</li>
  +<li>
  +<a href="#Web+Services+Proxy+to+the+rescue">Web Services Proxy to the rescue</a>
  +</li>
  +<li>
  +<a href="#Conclusion">Conclusion</a>
  +<ul class="minitoc">
  +<li>
  +<a href="#Have+more+questions%3F">Have more questions?</a>
  +</li>
  +</ul>
  +</li>
  +</ul>
  +    
  +<a name="N1001C"></a><a name="What+Is+Web+Syndication%3F"></a>
  +<h3>What Is Web Syndication?</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>Web Site Syndication has gained popularity as more and more web sites cross reference each
  +        other, not only by a single hyperlink, but also by embedding parts of their content. The
  +        idea was pioneered by Netscape with their Rich Site Summary (RSS)
  +        (<a href="http://www.oasis-open.org/cover/rss.html">http://www.oasis-open.org/cover/rss.html</a>)
  +        XML format. RSS was developed in early 1999 to populate Netscape's My Netscape portal with
  +        external newsfeeds ("channels"). Since then RSS has taken on a life of its own and now
  +        thousands of Web sites use RSS as a "what's new" mechanism to drive traffic their way.
  +      </p>
  +<p>The current RSS 1.0 standard is an application of Resource Description Framework (RDF)
  +        (<a href="http://www.w3.org/TR/rdf-schema/">http://www.w3.org/TR/rdf-schema/</a>). RDF
  +        is a framework for describing and interchanging metadata. The RDF framework is extensible
  +        and allows adding new types of entities. It also gives meaning to resources to enable
  +        automated processing of Web resources.
  +      </p>
  +<p>RSS is unarguably an example of an organically grown and widely accepted standard. For long
  +        it was not endorsed by any of the popular standards committees. Even so it quickly became
  +        popular and found a large number of creative uses. Lately though it has reached its limits.
  +        There is a demand for more advanced portal syndication which RSS cannot satisfy.
  +      </p>
  +</div>
  +
  +    
  +<a name="N10033"></a><a name="Going+beyond+RSS+with+Web+Services"></a>
  +<h3>Going beyond RSS with Web Services</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>Latest generation web portals demand more than simply posting cross linked news stories
  +        from RSS. Embedding and personalizing rich content and behavior from remote portals is
  +        becoming necessity. Limited success has been achieved through complex and sophisticated
  +        backend integration via proprietary or Web Services compliant protocols. Recognizing the
  +        growing demand, influential organizations have attempted to develop new languages such as:
  +      </p>
  +<a name="N1003B"></a><a name="Web+Services+Experience+Language+%28WSXL%29"></a>
  +<h4>Web Services Experience Language (WSXL)</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +          (<a href="http://www.webservices.org/index.php/article/articleview/345/">http://www.webservices.org/index.php/article/articleview/345/</a>)
  +        </p>
  +<p>
  +          
  +<em>"WSXL is a Web services centric component model for interactive Web applications. WSXL
  +            is designed to achieve two main goals: enable businesses to distribute Web applications
  +            through multiple revenue channels and enable new services or applications to be created
  +            by leveraging existing applications across the Web."
  +          </em>
  +        
  +</p>
  +</div>
  +<a name="N1004E"></a><a name="Web+Services+Inspection+Language+%28WSIL%29"></a>
  +<h4>Web Services Inspection Language (WSIL)</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +          (<a href="http://www.webservices.org/index.php/article/articleview/85/">http://www.webservices.org/index.php/article/articleview/85/</a>)
  +        </p>
  +<p>
  +          
  +<em>"The specification allows a Web services provider to publish a WS-Inspection (WSIL)
  +            document which lists the services on offer and their corresponding WSDL (Web services
  +            description language) files. The convention is that the WSIL document should be called
  +            "inspection.wsil" and be located at a common entry point to the web site. This paves the
  +            way for future Web services "crawlers" to locate and parse WSIL documents for Web
  +            service search engines."        
  +          </em>
  +        
  +</p>
  +</div>
  +<a name="N10061"></a><a name="Web+Services+for+Remote+Portals+%28WSRP%29"></a>
  +<h4>Web Services for Remote Portals (WSRP)</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +          (<a href="http://www.oasis-open.org/committees/wsrp/">http://www.oasis-open.org/committees/wsrp/</a>)
  +        </p>
  +<p>
  +          
  +<em>"Defining an XML and Web services standard that will allow the plug-n-play of visual,
  +            user-facing Web services with portals or other intermediary Web applications"
  +          </em>
  +        
  +</p>
  +</div>
  +<a name="N10074"></a><a name="Web+Services+for+Interactive+Applications"></a>
  +<h4>Web Services for Interactive Applications</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +          (<a href="http://www.oasis-open.org/committees/wsia/">http://www.oasis-open.org/committees/wsia/</a>)
  +        </p>
  +<p>
  +          
  +<em>"Create an XML and web services centric framework for interactive web applications.
  +            The designs must achieve two main goals: enable businesses to distribute web
  +            applications through multiple revenue channels, and enable new services or applications
  +            to be created by leveraging existing applications across the Web."
  +          </em>
  +        
  +</p>
  +</div>
  +<p>While these efforts are certainly worthwhile and promising, it will most likely take years
  +        before they pass the filters of real life use before they can claim widespread adoption. All
  +        of them ask for a thick infrastructure layer to support implementations. While possible, it
  +        is unlikely that mainstream deployment will be achieved instantly.
  +      </p>
  +<p>Not all is lost though. Fortunately, there is way to satisfy a large portion of the
  +        syndication requirements by applying already established technologies and tools. We will
  +        illustrate the architecture of a possible solution using an open source framework for XML
  +        Publishing - Apache Cocoon.
  +      </p>
  +</div>
  +
  +    
  +<a name="N1008E"></a><a name="Apache+Cocoon"></a>
  +<h3>Apache Cocoon</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +        (<a href="http://cocoon.apache.org/index.html">http://cocoon.apache.org/index.html</a>)
  +      </p>
  +<p>
  +        
  +<em>"Apache Cocoon is an XML publishing framework that raises the usage of XML and XSLT
  +          technologies for server applications to a new level. Designed for performance and
  +          scalability around pipelined SAX processing, Cocoon offers a flexible environment based
  +          on a separation of concerns between content, logic and style. To top this all off,
  +          Cocoon's centralized configuration system and sophisticated caching help you to create,
  +          deploy and maintain rock-solid XML server applications".
  +        </em>
  +      
  +</p>
  +<p>First, let's describe a typical use case scenario: User logs in to a familiar portal and
  +        happily surfs about. At some point the user clicks on a link which leads to a strange page.
  +        It has the portal logo, even shows the same login id but still looks very different and
  +        unfriendly ... After some time and frustration the user gets used to switching back and
  +        forth between the two faces of the portal ... while looking for another provider which
  +        offers both services in a coherent graphical interface.
  +      </p>
  +<p>For those who have never had similar experience, we will give a popular example. Yahoo! Autos
  +        (<a href="http://autos.yahoo.com/finance.html?refsrc=autos/insurance">http://autos.yahoo.com/finance.html?refsrc=autos/insurance</a>)
  +        offers an easy to use interactive catalog of cars. However when it comes to insuring an
  +        automobile, applying for a loan or buying a car, the web site hyperlinks to a co-branded
  +        page of another company. For example Lending Tree
  +        (<a href="https://www.lendingtree.com/newauto/secure/ctl_borrower.asp?page=loan_selection&verb=continue&O_loan_type=LOAN_TYPE_AUTO&bp=yahooautos&source=40050&alliance=true&SITEID=&templxlname=&templxssn1=&templxssn2=&templxssn3=">https://www.lendingtree.com/newauto/.....</a> )
  +        will show Yahoo! Autos logo at the top of the screen, however the rest of the page looks
  +        very different than any other Yahoo! page. All the personalization spoils that a Yahoo! user
  +        enjoys are lost as soon as the application for a loan begins. Not only the colors and layout
  +        are different. A login session with Yahoo! does not carry over to Lending Tree. On top of
  +        that a pop-up window appears when switching between the two sites, which reads "You are
  +        about to view pages over a secure connection ...". When added up these "negligible"
  +        inadequacies, lead to an overall poor experience, which is certainly not the original
  +        intent of the Yahoo! content producers.
  +      </p>
  +<p>Now as we have an idea of how things are not supposed to work, we will show that
  +        outsourcing interactive components to a third party site, while preserving the look &amp;
  +        feel of the original portal is still possible when done right. As we mentioned Cocoon offers
  +        a solution. Since Cocoon is a very sophisticated framework, an indepth analysis of its
  +        features is beyond the scope of this text to cover.
  +      </p>
  +</div>
  +
  +    
  +<a name="N100B2"></a><a name="Web+Services+Proxy+to+the+rescue"></a>
  +<h3>Web Services Proxy to the rescue</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The latest version of Cocoon is 2.1 and it has a new Web Service Proxy component. It is
  +        this component which we shall focus on for the reminder of the text. To follow the rest of
  +        the article, it will be useful (but not essential) to have a basic knowledge of Cocoon 2.
  +      </p>
  +<p>Combined with the <a href="../../howto/xmlform-wizard/howto-xmlform-wizard.html">XMLForm</a>
  +        component of Cocoon 2 and XSLT, the Web Service Proxy component allows vendors to share
  +        interactive content with little effort. The Web Service Proxy takes advantage of the fact
  +        that a Cocoon web application produces XML content, which is later translated into multiple
  +        presentation formats, like HTML or WML. Once the proxy is plugged in the Cocoon sitemap, it
  +        transparently pipes browser requests to a remote web application and returns the response
  +        back to the sitemap for local styling. Receiving a client independent XML format, allows the
  +        local site to pull content and style it with XSLT with the desired Look &amp; Feel.
  +      </p>
  +<p>
  +        
  +<strong>
  +          Q. Ok, styling presentation is easy to understand, but how is a form submitted to the original site?
  +        </strong>
  +      
  +</p>
  +<p>The XMLForm component is the answer. It uses W3C XForms included in the XML content which
  +        allows the end user to directly interact with the remote server through the embedding site.
  +        The form markup in the XML content of an embedded page uses relative URL address for the
  +        target action, when the end user submits, the form data is sent to the containing site,
  +        which captures the form data and the relative URL. The Web Service Proxy then takes this
  +        information and re-submits it to the original site. It then reads the XML response and makes
  +        it available to the sitemap for styling again.
  +      </p>
  +<p>
  +        
  +<strong>Q. Hmm ... a typical web application maintains a user session while navigating.
  +          How is the containing site propagating the end user session to the embedded site?
  +        </strong>
  +      
  +</p>
  +<p>The answer is simple. The Web Service Proxy simply hooks to the end user session and
  +        automatically starts its own session with the remote site. If the remote site requires
  +        authentication, then the developer of the local web site has to pass the user credentials
  +        as parameters to the WebServiceProxyGenerator.
  +      </p>
  +<p>
  +        
  +<strong>Q. What transport protocols are supported?</strong>
  +      
  +</p>
  +<p>HTTP 1.0, HTTP 1.1, HTTPS.</p>
  +<p>Below we will illustrate the architecture of the solution with some example code and
  +        figures.
  +      </p>
  +<div align="center">
  +<img class="figure" alt="Figure 1 - Traditional Http Proxy vs Cocoon Web Service Proxy" src="images/wsproxy_Proxies.png"></div>
  +<p>
  +        
  +<em>Figure 1 - Architecture of the Web Service Proxy Solution. As opposed to a traditional
  +          proxy server, the Web Services Proxy captures user input and allows the web site to remain
  +          coherent even when the functionality for some of its components is delivered remotely.
  +        </em>
  +      
  +</p>
  +<div align="center">
  +<img class="figure" alt="Figure 2 - Illustration of the data flow for a composite page" src="images/wsproxy_CompositePage.png"></div>
  +<p>
  +        
  +<em>Figure 2 - Illustration of the data flow for a composite page. Some of the content is
  +          locally constructed, the rest is obtained remotely. Finally the same styling is applied
  +          and the user facing page appears consistent.
  +        </em>
  +      
  +</p>
  +<p>Now we will show a snippet of the sitemap which employs the Web Service Proxy. Notice its
  +        brevity! The Web Service Proxy completely handles the content and navigation logic between
  +        the two portals. Only stylesheets are additionally required to translate the remotely
  +        retrieved documents into a user friendly format.
  +      </p>
  +<pre class="code">
  +  &lt;?xml version="1.0"?&gt;
  +  &lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;
  +
  +    &lt;!-- =========================== Components ================== --&gt;
  +    &lt;map:components&gt;
  +      &lt;map:generators default="file"&gt;
  +        &lt;map:generator name="wsproxy" logger="sitemap.generator.wsproxy"
  +          src="org.apache.cocoon.generation.WebServiceProxyGenerator"/&gt;
  +      &lt;/map:generators&gt;
  +    &lt;/map:components&gt;
  +
  +    &lt;!-- =========================== Pipelines =================== --&gt;
  +    &lt;map:pipelines&gt;
  +      &lt;map:pipeline&gt;
  +        &lt;!-- Interactive Web Application Syndication  --&gt;
  +        &lt;map:match pattern="*"&gt;
  +          &lt;map:generate type="wsproxy" label="xml"
  +            src="http://{request:serverName}:{request:serverPort}{request:contextPath}/samples/xmlform/wizard?cocoon-view=xml"/&gt;
  +          &lt;map:transform src="stylesheets/newWizard2html.xsl"/&gt;
  +          &lt;map:transform src="context://samples/stylesheets/xmlform/xmlform2html.xsl"/&gt;
  +          &lt;map:serialize type="html"/&gt;
  +        &lt;/map:match&gt;
  +      &lt;/map:pipeline&gt;
  +    &lt;/map:pipelines&gt;
  +  &lt;/map:sitemap&gt;
  +   </pre>
  +<div align="center">
  +<img class="figure" alt="Figure 3 - sequence diagram" src="images/wsproxy_Sequence.png"></div>
  +<p>
  +        
  +<em>Figure 3 - Above is a sequence diagram outlining the interaction between the key
  +          participants in a syndication session.
  +        </em>
  +      
  +</p>
  +<div align="center">
  +<img class="figure" alt="screen shot 1" src="images/wsproxy_Screenshot1.png"></div>
  +<p>
  +        
  +<em>Figure 4 - Sample screenshot from a remotely enabled application as it appears
  +          standalone.
  +        </em>
  +      
  +</p>
  +<div align="center">
  +<img class="figure" alt="screen shot 2" src="images/wsproxy_Screenshot2.png"></div>
  +<p>
  +        
  +<em>Figure 5 - Sample screenshot from the same application embedded in another web
  +          application.
  +        </em>
  +      
  +</p>
  +<p>The content of the original XML page behind these two screenshot follows:</p>
  +<pre class="code">
  +  &lt;?xml version="1.0"?&gt;
  +  &lt;document xmlns:xf="http://apache.org/cocoon/xmlform/1.0"&gt;
  +    &lt;xf:form id="form-feedback" view="userIdentity" action="wizard" method="GET"&gt;
  +      &lt;xf:caption&gt;Personal Information&lt;/xf:caption&gt;
  +      &lt;error&gt;
  +        &lt;xf:violations class="error"/&gt;
  +      &lt;/error&gt;
  +      &lt;xf:textbox ref="firstName"&gt;
  +        &lt;xf:caption&gt;First Name&lt;/xf:caption&gt;
  +        &lt;xf:violations class="error"/&gt;
  +      &lt;/xf:textbox&gt;
  +      ...
  +      &lt;xf:selectMany ref="role" selectUIType="listbox"&gt;
  +        &lt;xf:caption&gt;Professional roles&lt;/xf:caption&gt;
  +        &lt;xf:item&gt;
  +          &lt;xf:caption&gt;Geek&lt;/xf:caption&gt;
  +          &lt;xf:value&gt;Geek&lt;/xf:value&gt;
  +        &lt;/xf:item&gt;
  +        &lt;xf:item&gt;
  +          &lt;xf:caption&gt;Hacker&lt;/xf:caption&gt;
  +          &lt;xf:value&gt;Hacker&lt;/xf:value&gt;
  +        &lt;/xf:item&gt;
  +        ...
  +      &lt;/xf:selectMany&gt;
  +      ...
  +      &lt;!-- hidden model attribute --&gt;
  +      &lt;xf:hidden ref="hidden"&gt;
  +        &lt;xf:value&gt;true&lt;/xf:value&gt;
  +      &lt;/xf:hidden&gt;
  +      ...
  +      &lt;xf:submit id="next" class="button"&gt;
  +        &lt;xf:caption&gt;Next&lt;/xf:caption&gt;
  +      &lt;/xf:submit&gt;
  +    &lt;/xf:form&gt;
  +
  +    &lt;xf:output ref="count" id="show_count" form="form-feedback" class="info"&gt;
  +      &lt;xf:caption&gt;Visits Count&lt;/xf:caption&gt;
  +    &lt;/xf:output&gt;
  +  &lt;/document&gt;
  +   </pre>
  +<p>The listing above contains markup in the XMLForm namespace. It is a presentation
  +        independent way to specify input controls. Being XForms compliant it is easy to learn and
  +        use. The XSLT stylesheets used to convert the XML above are very simple and will not be
  +        listed here. They can found in the Cocoon 2.1 distribution.
  +      </p>
  +</div>
  +
  +    
  +<a name="N10125"></a><a name="Conclusion"></a>
  +<h3>Conclusion</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>The Web Service Proxy component is tightly integrated with the Cocoon framework and is
  +        particularly convenient to use in combination with XMLForm to enable syndication of website
  +        functionality. With the presented sample, we only scratched the service of the possible
  +        applications. It is easy to see though for a creative mind how it can be extended in
  +        multiple directions. Although the solution we offered is conveniently applied with Cocoon,
  +        the concepts are generally applicable outside the framework as well. Exposing a Web
  +        Application functionality via XML is not just a "neat" feature any more. It opens the gates
  +        to a constellation of opportunities, not possible with the classical Model-2 approach where
  +        the business logic is directly tied to a graphical output like HTML.
  +      </p>
  +<a name="N1012D"></a><a name="Have+more+questions%3F"></a>
  +<h4>Have more questions?</h4>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>Look at the online demo available in the Cocoon distribution in the samples:
  +          <span class="codefrag">http://{host}:{port}/{contextPath}/samples/proxy/</span>.
  +        </p>
  +<p>Then study the source code and if you still have questions, join the cocoon users email
  +          list and ask. If you have ideas for improvement then you are more than welcome to discuss
  +          it on the cocoon development email list and eventually submit a patch through the Apache
  +          bug tracking system.
  +        </p>
  +</div>
  +</div>
  +  
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.3       +359 -348  cocoon-site/site/2.1/userdocs/generators/wsproxy-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +378 -374  cocoon-site/site/2.1/userdocs/generators/xmldb-generator.html
  
  Index: xmldb-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/xmldb-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- xmldb-generator.html	21 May 2003 15:23:45 -0000	1.4
  +++ xmldb-generator.html	11 Jul 2003 00:32:53 -0000	1.5
  @@ -1,374 +1,378 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>XML:DB Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">XML:DB Generator</font></span>
  -</li>
  -    
  -<li>
  -<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>XML:DB Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="xmldb-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Gianugo Rabellino</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Warning%21">Warning!</a>
  -</li>
  -<li>
  -<a href="#XML%3ADB+Generator">XML:DB Generator</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Warning%21"></a>
  -<h3>Warning!</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -        The XML:DB generators are currently unmaintained and going to be 
  -        deprecated soon. Please use the XML:DB pseudo-protocol instead.
  -      </p>
  -</div>
  -		
  -<a name="N10025"></a><a name="XML%3ADB+Generator"></a>
  -<h3>XML:DB Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -         Generates XML documents out of an XML:DB compliant database. XML:DB
  -         is a generic API developed by the XML:DB group in order to allow access
  -         via a consistent API to the upcoming XML databases such as dbXML,
  -         Ozone and eXist (as of now only the first one has an almost compliant
  -         API implementation).
  -         For the sake of this document, an XML:DB compliant database can be 
  -         seen as a filesystem where directories are called "collections" and 
  -         files are called "resources".
  -      </p>
  -<ul>
  -        
  -<li>Name: xmldb</li>
  -        
  -<li>Class: org.apache.cocoon.generation.XMLDBGenerator</li>
  -        
  -<li>Cacheable: no</li>
  -      
  -</ul>
  -<p>
  -         The generator needs to be configured in a "JDBCish" way: a driver 
  -         (a class name) must be provided, together with a "base" URI. An example
  -         configuration, based on the stock dbXML implementation, will look like 
  -         this:
  -      </p>
  -<pre class="code">
  -&lt;map:generator name="xmldb"
  -               src="org.apache.cocoon.generation.XMLDBGenerator"
  -               label="content"&gt;
  -  &lt;driver&gt;org.dbxml.client.xmldb.DatabaseImpl&lt;/driver&gt;
  -  &lt;base&gt;xmldb:dbxml:///db/&lt;/base&gt;
  -&lt;/map:generator&gt;
  -</pre>
  -<p>
  -         Note that the content of the "base" tag will be prepended to the 
  -         requested resource. It's important to keep a trailing slash at the
  -         end of the <span class="codefrag">base</span> tag.
  -      </p>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>XML:DB Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">XML:DB Generator</font></span>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>XML:DB Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="xmldb-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Gianugo Rabellino</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Warning%21">Warning!</a>
  +</li>
  +<li>
  +<a href="#XML%3ADB+Generator">XML:DB Generator</a>
  +</li>
  +</ul>
  +		
  +<a name="N1001C"></a><a name="Warning%21"></a>
  +<h3>Warning!</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +        The XML:DB generators are currently unmaintained and going to be 
  +        deprecated soon. Please use the XML:DB pseudo-protocol instead.
  +      </p>
  +</div>
  +		
  +<a name="N10025"></a><a name="XML%3ADB+Generator"></a>
  +<h3>XML:DB Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +         Generates XML documents out of an XML:DB compliant database. XML:DB
  +         is a generic API developed by the XML:DB group in order to allow access
  +         via a consistent API to the upcoming XML databases such as dbXML,
  +         Ozone and eXist (as of now only the first one has an almost compliant
  +         API implementation).
  +         For the sake of this document, an XML:DB compliant database can be 
  +         seen as a filesystem where directories are called "collections" and 
  +         files are called "resources".
  +      </p>
  +<ul>
  +        
  +<li>Name: xmldb</li>
  +        
  +<li>Class: org.apache.cocoon.generation.XMLDBGenerator</li>
  +        
  +<li>Cacheable: no</li>
  +      
  +</ul>
  +<p>
  +         The generator needs to be configured in a "JDBCish" way: a driver 
  +         (a class name) must be provided, together with a "base" URI. An example
  +         configuration, based on the stock dbXML implementation, will look like 
  +         this:
  +      </p>
  +<pre class="code">
  +&lt;map:generator name="xmldb"
  +               src="org.apache.cocoon.generation.XMLDBGenerator"
  +               label="content"&gt;
  +  &lt;driver&gt;org.dbxml.client.xmldb.DatabaseImpl&lt;/driver&gt;
  +  &lt;base&gt;xmldb:dbxml:///db/&lt;/base&gt;
  +&lt;/map:generator&gt;
  +</pre>
  +<p>
  +         Note that the content of the "base" tag will be prepended to the 
  +         requested resource. It's important to keep a trailing slash at the
  +         end of the <span class="codefrag">base</span> tag.
  +      </p>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +55 -72    cocoon-site/site/2.1/userdocs/generators/xmldb-generator.pdf
  
  	<<Binary file>>
  
  
  1.5       +380 -376  cocoon-site/site/2.1/userdocs/generators/xmldbcollection-generator.html
  
  Index: xmldbcollection-generator.html
  ===================================================================
  RCS file: /home/cvs/cocoon-site/site/2.1/userdocs/generators/xmldbcollection-generator.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- xmldbcollection-generator.html	21 May 2003 15:23:45 -0000	1.4
  +++ xmldbcollection-generator.html	11 Jul 2003 00:32:53 -0000	1.5
  @@ -1,376 +1,380 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  -<html>
  -<head>
  -<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>XML:DB Collection Generator</title>
  -<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  -</head>
  -<body text="#000000" bgcolor="#FFFFFF">
  -<!--================= start Navigation Path ==================-->
  -<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Navigation Path ==================-->
  -<!--================= start Banner ==================-->
  -<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td bgcolor="#294563"><a href="http://xml.apache.org"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/group-logo.gif"></a></td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  -<tr>
  -<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  -<br>
  -<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  -                      the Apache Cocoon site
  -                      
  -                      
  -                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" bgcolor="#294563" colspan="2">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td width="8"><img alt="" height="8" width="8" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  -<table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  -</tr>
  -</table>
  -</td>
  -</tr>
  -</table>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -<!--================= end Banner ==================-->
  -<!--================= start Menu, NavBar, Content ==================-->
  -<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td valign="top">
  -<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<!--================= start left top NavBar ==================-->
  -<td rowspan="3" valign="top">
  -<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  -</tr>
  -<tr>
  -<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td>
  -<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  -<!--================= start Menu items ==================-->
  -<div class="menu">
  -<ul>
  -<li>
  -<font color="#CFDCED">Navigation</font>
  -<ul>
  -    
  -<li>
  -<a href="../../index.html">Main</a>
  -</li>
  -    
  -<li>
  -<a href="../index.html">User Documentation</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Generators</font>
  -<ul>
  -    
  -<li>
  -<a href="generators.html">Overview</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Default</font>
  -<ul>
  -    
  -<li>
  -<a href="file-generator.html">File Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Core</font>
  -<ul>
  -    
  -<li>
  -<a href="html-generator.html">HTML Generator</a>
  -</li>
  -    
  -<li>
  -<a href="directory-generator.html">Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="imagedirectory-generator.html">Image Directory Generator</a>
  -</li>
  -    
  -<li>
  -<a href="extractor-generator.html">Fragment Extractor Generator</a>
  -</li>
  -    
  -<li>
  -<a href="jsp-generator.html">JSP Generator</a>
  -</li>
  -    
  -<li>
  -<a href="script-generator.html">Script Generator</a>
  -</li>
  -    
  -<li>
  -<a href="serverpages-generator.html">Server Pages Generator</a>
  -</li>
  -    
  -<li>
  -<a href="velocity-generator.html">Velocity Generator</a>
  -</li>
  -    
  -<li>
  -<a href="request-generator.html">Request Generator</a>
  -</li>
  -    
  -<li>
  -<a href="status-generator.html">Status Generator</a>
  -</li>
  -    
  -<li>
  -<a href="stream-generator.html">Stream Generator</a>
  -</li>
  -    
  -<li>
  -<a href="profile-generator.html">Profile Generator</a>
  -</li>
  -    
  -<li>
  -<a href="error-generator.html">Error Generator</a>
  -</li>
  -    
  -<li>
  -<a href="search-generator.html">Search Generator</a>
  -</li>
  -    
  -<li>
  -<a href="linkstatus-generator.html">LinkStatus Generator</a>
  -</li>
  -    
  -<li>
  -<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  -</li>
  -  
  -</ul>
  -</li>
  -<li>
  -<font color="#CFDCED">Optional</font>
  -<ul>
  -    
  -<li>
  -<a href="php-generator.html">Php Generator</a>
  -</li>
  -    
  -<li>
  -<a href="xmldb-generator.html">XML:DB Generator</a>
  -</li>
  -    
  -<li>
  -<span class="sel"><font color="#ffcc00">XML:DB Collection Generator</font></span>
  -</li>
  -  
  -</ul>
  -</li>
  -</ul>
  -</div>
  -<!--================= end Menu items ==================-->
  -</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  -</tr>
  -<tr>
  -<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -</table>
  -</td><td valign="top" width="100%">
  -<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  -<!--================= start middle NavBar ==================-->
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  -                &nbsp;
  -                
  -                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<tr>
  -<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end middle NavBar ==================-->
  -<!--================= start Content==================-->
  -<tr>
  -<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td><td align="left" width="100%">
  -<div class="content">
  -<table class="title" summary="">
  -<tr>
  -<td valign="middle">
  -<h1>XML:DB Collection Generator</h1>
  -</td><script Language="Javascript">
  -
  -function printit(){  
  -if (window.print) {
  -    window.print() ;  
  -} else {
  -    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  -document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  -    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  -}
  -}
  -</script><script Language="Javascript">  
  -var NS = (navigator.appName == "Netscape");
  -var VERSION = parseInt(navigator.appVersion);
  -if (VERSION > 3) {
  -    document.write('<td nowrap="nowrap" width="40" align="center">');     
  -    document.write('  <a class="dida" href="javascript:printit()">');        
  -    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" border="0"><br>');   
  -    document.write('  print</a>');   
  -    document.write('</td>');           
  -}
  -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="xmldbcollection-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" border="0"><br>
  -          PDF</a></td>
  -</tr>
  -</table>
  -<p>
  -<font size="-2">by&nbsp;Gianugo Rabellino</font>
  -</p>
  -<ul class="minitoc">
  -<li>
  -<a href="#Warning%21">Warning!</a>
  -</li>
  -<li>
  -<a href="#XML%3ADB+Collection+Generator">XML:DB Collection Generator</a>
  -</li>
  -</ul>
  -		
  -<a name="N1001C"></a><a name="Warning%21"></a>
  -<h3>Warning!</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -        The XML:DB generators are currently unmaintained and going to be 
  -        deprecated soon. Please use the XML:DB pseudo-protocol instead.
  -      </p>
  -</div>
  -		
  -<a name="N10025"></a><a name="XML%3ADB+Collection+Generator"></a>
  -<h3>XML:DB Collection Generator</h3>
  -<div style="margin-left: 0 ; border: 2px">
  -<p>
  -        As for the filesystem there are two generators provided (a file
  -        generator and a directory generator), so is for XML:DB, which 
  -        can roughly be tought as an XML filesystem, where Collections
  -        stand for directories and Resources stand for (XML) files.
  -      </p>
  -<p>
  -        This generator outputs a list of collections and resources
  -        given a starting collection. It can be used together with
  -        the XMLDBGeneratot, and coupled with the appropriate XSLT, 
  -        to easily navigate any XML:DB compliant database. 
  -      </p>
  -<ul>
  -        
  -<li>Name: xmldbcollection</li>
  -        
  -<li>Class: org.apache.cocoon.generation.XMLDBCollectionGenerator</li>
  -        
  -<li>Cacheable: no</li>
  -      
  -</ul>
  -<p>
  -         The configuration is the same of the XMLDBGenerator: it needsi
  -         a driver (a class name) and base URI. An example
  -         configuration, based on the stock dbXML implementation, will look like 
  -         this:
  -      </p>
  -<pre class="code">
  -&lt;map:generator name="xmldbcollection"
  -               src="org.apache.cocoon.generation.XMLDBGenerator"
  -               label="content"&gt;
  -  &lt;driver&gt;org.dbxml.client.xmldb.DatabaseImpl&lt;/driver&gt;
  -  &lt;base&gt;xmldb:dbxml:///db/&lt;/base&gt;
  -&lt;/map:generator&gt;
  -</pre>
  -<p>
  -         Note that the content of the "base" tag will be prepended to the 
  -         requested resource. It's important to keep a trailing slash at the
  -         end of the <span class="codefrag">base</span> tag.
  -      </p>
  -</div>
  -	
  -</div>
  -</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif"></td>
  -</tr>
  -<!--================= end Content==================-->
  -</table>
  -</td>
  -</tr>
  -</table>
  -<!--================= end Menu, NavBar, Content ==================-->
  -<!--================= start Footer ==================-->
  -<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  -<tr>
  -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  -</tr>
  -<tr>
  -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  -          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  -              document.write(" - "+"Last Published: " + document.lastModified);
  -            //  --></script></font></td>
  -</tr>
  -<tr>
  -<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  -</tr>
  -</table>
  -<!--================= end Footer ==================-->
  -</body>
  -</html>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<html>
  +<head>
  +<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  +<title>XML:DB Collection Generator</title>
  +<link type="text/css" href="../../skin/page.css" rel="stylesheet">
  +</head>
  +<body text="#000000" bgcolor="#FFFFFF">
  +<!--================= start Navigation Path ==================-->
  +<table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Navigation Path ==================-->
  +<!--================= start Banner ==================-->
  +<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<!--================= start Group Logo ==================-->
  +<td bgcolor="#294563"><a href=""></a></td>
  +<!--================= end Group Logo ==================-->
  +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  +<!--================= end Project Logo ==================-->
  +<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  +<form target="_blank" action="http://www.google.com/search" method="get">
  +<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  +<tr>
  +<td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  +<br>
  +<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
  +                      the Apache Cocoon site
  +                      
  +                      
  +                    </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  +</tr>
  +</table>
  +</form>
  +</td>
  +<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" bgcolor="#294563" colspan="2">
  +<!--================= start Tabs ==================-->
  +<div class="tab">
  +<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  +<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +</table>
  +</div>
  +<!--================= end Tabs ==================-->
  +</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +<!--================= end Banner ==================-->
  +<!--================= start Menu, NavBar, Content ==================-->
  +<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td valign="top">
  +<table summary="menu" border="0" cellspacing="0" cellpadding="0">
  +<tr>
  +<!--================= start left top NavBar ==================-->
  +<td rowspan="3" valign="top">
  +<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  +</tr>
  +<tr>
  +<td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td>
  +<!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  +<!--================= start Menu items ==================-->
  +<div class="menu">
  +<ul>
  +<li>
  +<font color="#CFDCED">Navigation</font>
  +<ul>
  +    
  +<li>
  +<a href="../../index.html">Main</a>
  +</li>
  +    
  +<li>
  +<a href="../index.html">User Documentation</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Generators</font>
  +<ul>
  +    
  +<li>
  +<a href="generators.html">Overview</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Default</font>
  +<ul>
  +    
  +<li>
  +<a href="file-generator.html">File Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Core</font>
  +<ul>
  +    
  +<li>
  +<a href="directory-generator.html">Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="imagedirectory-generator.html">Image Directory Generator</a>
  +</li>
  +    
  +<li>
  +<a href="linkstatus-generator.html">LinkStatus Generator</a>
  +</li>
  +    
  +<li>
  +<a href="error-generator.html">Notifying Generator</a>
  +</li>
  +    
  +<li>
  +<a href="request-generator.html">Request Generator</a>
  +</li>
  +    
  +<li>
  +<a href="serverpages-generator.html">Server Pages Generator</a>
  +</li>
  +    
  +<li>
  +<a href="status-generator.html">Status Generator</a>
  +</li>
  +    
  +<li>
  +<a href="stream-generator.html">Stream Generator</a>
  +</li>
  +    
  +<li>
  +<a href="xpathdirectory-generator.html">XPath Directory Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +<li>
  +<font color="#CFDCED">Optional</font>
  +<ul>
  +    
  +<li>
  +<a href="extractor-generator.html">Fragment Extractor Generator</a>
  +</li>
  +    
  +<li>
  +<a href="html-generator.html">HTML Generator</a>
  +</li>
  +    
  +<li>
  +<a href="jsp-generator.html">JSP Generator</a>
  +</li>
  +    
  +<li>
  +<a href="php-generator.html">Php Generator</a>
  +</li>
  +    
  +<li>
  +<a href="profile-generator.html">Profile Generator</a>
  +</li>
  +    
  +<li>
  +<a href="script-generator.html">Script Generator</a>
  +</li>
  +    
  +<li>
  +<a href="search-generator.html">Search Generator</a>
  +</li>
  +    
  +<li>
  +<a href="velocity-generator.html">Velocity Generator</a>
  +</li>
  +    
  +<li>
  +<a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  +</li>
  +    
  +<li>
  +<span class="sel"><font color="#ffcc00">XML:DB Collection Generator</font></span>
  +</li>
  +    
  +<li>
  +<a href="xmldb-generator.html">XML:DB Generator</a>
  +</li>
  +  
  +</ul>
  +</li>
  +</ul>
  +</div>
  +<!--================= end Menu items ==================-->
  +</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  +</tr>
  +<tr>
  +<td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +</table>
  +</td><td valign="top" width="100%">
  +<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  +<!--================= start middle NavBar ==================-->
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
  +                &nbsp;
  +                
  +                </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<tr>
  +<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end middle NavBar ==================-->
  +<!--================= start Content==================-->
  +<tr>
  +<td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  +<div class="content">
  +<table class="title" summary="">
  +<tr>
  +<td valign="middle">
  +<h1>XML:DB Collection Generator</h1>
  +</td><script Language="Javascript">
  +
  +function printit(){  
  +if (window.print) {
  +    window.print() ;  
  +} else {
  +    var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  +document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
  +    WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  +}
  +}
  +</script><script Language="Javascript">  
  +var NS = (navigator.appName == "Netscape");
  +var VERSION = parseInt(navigator.appVersion);
  +if (VERSION > 3) {
  +    document.write('<td nowrap="nowrap" width="40" align="center">');     
  +    document.write('  <a class="dida" href="javascript:printit()">');        
  +    document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
  +    document.write('  print</a>');   
  +    document.write('</td>');           
  +}
  +</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="xmldbcollection-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
  +          PDF</a></td>
  +</tr>
  +</table>
  +<p>
  +<font size="-2">by&nbsp;Gianugo Rabellino</font>
  +</p>
  +<ul class="minitoc">
  +<li>
  +<a href="#Warning%21">Warning!</a>
  +</li>
  +<li>
  +<a href="#XML%3ADB+Collection+Generator">XML:DB Collection Generator</a>
  +</li>
  +</ul>
  +		
  +<a name="N1001C"></a><a name="Warning%21"></a>
  +<h3>Warning!</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +        The XML:DB generators are currently unmaintained and going to be 
  +        deprecated soon. Please use the XML:DB pseudo-protocol instead.
  +      </p>
  +</div>
  +		
  +<a name="N10025"></a><a name="XML%3ADB+Collection+Generator"></a>
  +<h3>XML:DB Collection Generator</h3>
  +<div style="margin-left: 0 ; border: 2px">
  +<p>
  +        As for the filesystem there are two generators provided (a file
  +        generator and a directory generator), so is for XML:DB, which 
  +        can roughly be tought as an XML filesystem, where Collections
  +        stand for directories and Resources stand for (XML) files.
  +      </p>
  +<p>
  +        This generator outputs a list of collections and resources
  +        given a starting collection. It can be used together with
  +        the XMLDBGeneratot, and coupled with the appropriate XSLT, 
  +        to easily navigate any XML:DB compliant database. 
  +      </p>
  +<ul>
  +        
  +<li>Name: xmldbcollection</li>
  +        
  +<li>Class: org.apache.cocoon.generation.XMLDBCollectionGenerator</li>
  +        
  +<li>Cacheable: no</li>
  +      
  +</ul>
  +<p>
  +         The configuration is the same of the XMLDBGenerator: it needsi
  +         a driver (a class name) and base URI. An example
  +         configuration, based on the stock dbXML implementation, will look like 
  +         this:
  +      </p>
  +<pre class="code">
  +&lt;map:generator name="xmldbcollection"
  +               src="org.apache.cocoon.generation.XMLDBGenerator"
  +               label="content"&gt;
  +  &lt;driver&gt;org.dbxml.client.xmldb.DatabaseImpl&lt;/driver&gt;
  +  &lt;base&gt;xmldb:dbxml:///db/&lt;/base&gt;
  +&lt;/map:generator&gt;
  +</pre>
  +<p>
  +         Note that the content of the "base" tag will be prepended to the 
  +         requested resource. It's important to keep a trailing slash at the
  +         end of the <span class="codefrag">base</span> tag.
  +      </p>
  +</div>
  +	
  +</div>
  +</td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  +</tr>
  +<!--================= end Content==================-->
  +</table>
  +</td>
  +</tr>
  +</table>
  +<!--================= end Menu, NavBar, Content ==================-->
  +<!--================= start Footer ==================-->
  +<table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  +<tr>
  +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  +</tr>
  +<tr>
  +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
  +          1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
  +              document.write(" - "+"Last Published: " + document.lastModified);
  +            //  --></script></font></td>
  +</tr>
  +<tr>
  +<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  +</tr>
  +</table>
  +<!--================= end Footer ==================-->
  +</body>
  +</html>
  
  
  
  1.2       +55 -72    cocoon-site/site/2.1/userdocs/generators/xmldbcollection-generator.pdf
  
  	<<Binary file>>
  
  
  1.1                  cocoon-site/site/2.1/userdocs/generators/xpathdirectory-generator.html
  
  Index: xpathdirectory-generator.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  <html>
  <head>
  <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  <title>XPath Directory Generator</title>
  <link type="text/css" href="../../skin/page.css" rel="stylesheet">
  </head>
  <body text="#000000" bgcolor="#FFFFFF">
  <!--================= start Navigation Path ==================-->
  <table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  </tr>
  <tr>
  <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  </table>
  <!--================= end Navigation Path ==================-->
  <!--================= start Banner ==================-->
  <table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <!--================= start Group Logo ==================-->
  <td bgcolor="#294563"><a href=""></a></td>
  <!--================= end Group Logo ==================-->
  <!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/"><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td>
  <!--================= end Project Logo ==================-->
  <!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  <form target="_blank" action="http://www.google.com/search" method="get">
  <table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  <tr>
  <td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <tr>
  <td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit">
  <br>
  <font face="Arial, Helvetica, Sans-serif" size="2" color="white">
                        the Apache Cocoon site
                        
                        
                      </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <tr>
  <td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td>
  </tr>
  </table>
  </form>
  </td>
  <!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <tr>
  <td valign="bottom" bgcolor="#294563" colspan="2">
  <!--================= start Tabs ==================-->
  <div class="tab">
  <table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td width="6"><img alt="" height="8" width="6" src="../../skin/images/spacer.gif"></td><td valign="bottom">
  <table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="../../index.html"><font color="#000000">Home</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../../skin/images/tabSel-right.gif"></td>
  </tr>
  </table>
  </td>
  </tr>
  </table>
  </div>
  <!--================= end Tabs ==================-->
  </td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <tr>
  <td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  </table>
  <!--================= end Banner ==================-->
  <!--================= start Menu, NavBar, Content ==================-->
  <table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td valign="top">
  <table summary="menu" border="0" cellspacing="0" cellpadding="0">
  <tr>
  <!--================= start left top NavBar ==================-->
  <td rowspan="3" valign="top">
  <table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <tr>
  <td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  </tr>
  <tr>
  <td bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  </table>
  </td>
  <!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  <!--================= start Menu items ==================-->
  <div class="menu">
  <ul>
  <li>
  <font color="#CFDCED">Navigation</font>
  <ul>
      
  <li>
  <a href="../../index.html">Main</a>
  </li>
      
  <li>
  <a href="../index.html">User Documentation</a>
  </li>
    
  </ul>
  </li>
  <li>
  <font color="#CFDCED">Generators</font>
  <ul>
      
  <li>
  <a href="generators.html">Overview</a>
  </li>
    
  </ul>
  </li>
  <li>
  <font color="#CFDCED">Default</font>
  <ul>
      
  <li>
  <a href="file-generator.html">File Generator</a>
  </li>
    
  </ul>
  </li>
  <li>
  <font color="#CFDCED">Core</font>
  <ul>
      
  <li>
  <a href="directory-generator.html">Directory Generator</a>
  </li>
      
  <li>
  <a href="imagedirectory-generator.html">Image Directory Generator</a>
  </li>
      
  <li>
  <a href="linkstatus-generator.html">LinkStatus Generator</a>
  </li>
      
  <li>
  <a href="error-generator.html">Notifying Generator</a>
  </li>
      
  <li>
  <a href="request-generator.html">Request Generator</a>
  </li>
      
  <li>
  <a href="serverpages-generator.html">Server Pages Generator</a>
  </li>
      
  <li>
  <a href="status-generator.html">Status Generator</a>
  </li>
      
  <li>
  <a href="stream-generator.html">Stream Generator</a>
  </li>
      
  <li>
  <span class="sel"><font color="#ffcc00">XPath Directory Generator</font></span>
  </li>
    
  </ul>
  </li>
  <li>
  <font color="#CFDCED">Optional</font>
  <ul>
      
  <li>
  <a href="extractor-generator.html">Fragment Extractor Generator</a>
  </li>
      
  <li>
  <a href="html-generator.html">HTML Generator</a>
  </li>
      
  <li>
  <a href="jsp-generator.html">JSP Generator</a>
  </li>
      
  <li>
  <a href="php-generator.html">Php Generator</a>
  </li>
      
  <li>
  <a href="profile-generator.html">Profile Generator</a>
  </li>
      
  <li>
  <a href="script-generator.html">Script Generator</a>
  </li>
      
  <li>
  <a href="search-generator.html">Search Generator</a>
  </li>
      
  <li>
  <a href="velocity-generator.html">Velocity Generator</a>
  </li>
      
  <li>
  <a href="wsproxy-generator.html">Web Service Proxy Generator</a>
  </li>
      
  <li>
  <a href="xmldbcollection-generator.html">XML:DB Collection Generator</a>
  </li>
      
  <li>
  <a href="xmldb-generator.html">XML:DB Generator</a>
  </li>
    
  </ul>
  </li>
  </ul>
  </div>
  <!--================= end Menu items ==================-->
  </td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <tr>
  <td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../../skin/images/menu-right.gif"></td>
  </tr>
  <tr>
  <td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  </table>
  </td><td valign="top" width="100%">
  <table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  <!--================= start middle NavBar ==================-->
  <tr>
  <td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <tr>
  <td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
                  &nbsp;
                  
                  </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
                  &nbsp;
                  
                  </font><img width="10" height="8" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <tr>
  <td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <!--================= end middle NavBar ==================-->
  <!--================= start Content==================-->
  <tr>
  <td align="left" width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td align="left" width="100%">
  <div class="content">
  <table class="title" summary="">
  <tr>
  <td valign="middle">
  <h1>XPath Directory Generator</h1>
  </td><script Language="Javascript">
  
  function printit(){  
  if (window.print) {
      window.print() ;  
  } else {
      var WebBrowser = '<OBJECT CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0" ID="WebBrowser1"></OBJECT>';
  document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
      WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box    WebBrowser1.outerHTML = "";  
  }
  }
  </script><script Language="Javascript">  
  var NS = (navigator.appName == "Netscape");
  var VERSION = parseInt(navigator.appVersion);
  if (VERSION > 3) {
      document.write('<td nowrap="nowrap" width="40" align="center">');     
      document.write('  <a class="dida" href="javascript:printit()">');        
      document.write('    <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>');   
      document.write('  print</a>');   
      document.write('</td>');           
  }
  </script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="xpathdirectory-generator.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
            PDF</a></td>
  </tr>
  </table>
  <p>
  <font size="-2">by&nbsp;J&ouml;rg Heinicke</font>
  </p>
  <ul class="minitoc">
  <li>
  <a href="#XPath+Directory+Generator">XPath Directory Generator</a>
  </li>
  <li>
  <a href="#Additional+Configuration">Additional Configuration</a>
  </li>
  <li>
  <a href="#Extended+DTD">Extended DTD</a>
  </li>
  <li>
  <a href="#Example">Example</a>
  </li>
  </ul>
      
  <a name="N1001C"></a><a name="XPath+Directory+Generator"></a>
  <h3>XPath Directory Generator</h3>
  <div style="margin-left: 0 ; border: 2px">
  <p>Generates an XML directory listing performing XPath queries on XML files.</p>
  <ul>
          
  <li>Name: xpathdirectory</li>
          
  <li>Class: org.apache.cocoon.generation.XPathDirectoryGenerator</li>
          
  <li>Cacheable: yes</li>
        
  </ul>
  <p>The XPath Directory Generator provides all the functionality of the
          <a href="directory-generator.html">Directory Generator</a>. Additionaly it is possible
          to get XML snippets out of the XML files the Directory Generator finds.</p>
  </div>
      
  <a name="N10038"></a><a name="Additional+Configuration"></a>
  <h3>Additional Configuration</h3>
  <div style="margin-left: 0 ; border: 2px">
  <pre class="code">
    &lt;map:generate type="xpathdirectory" src="the/requested/directory"&gt;
      &lt;map:parameter name="xpath" value="/article/title|/article/abstract"/&gt;
      &lt;map:parameter name="xmlFiles" value="\.x.*$"/&gt;
    &lt;/map:generate&gt;
        </pre>
  <p>The XPath Directory Generator has two additional parameters, both are optional.</p>
  <ul>
          
  <li>xpath: Sets the XPath the XPath Directory Generator should use for queries on XML files.
              If you don't set this parameter it will behave like the Directory Generator.</li>
          
  <li>xmlFiles: The xml files pattern. Specifies the files that should be handled as XML
              files. XPath queries will only be tried on files matching this pattern. The XPath
              Directory Generator does not fail on non-XML files or files that are not
              well-formed or not valid. All Exceptions on parsing the files will be caught and
              ignored. But of course, useless parsing, throwing and catching exceptions is very
              time consuming, so the <span class="codefrag">xmlFiles</span> pattern should not be too generic.<br>
              If you specify an empty pattern all files will be handled as XML files. The default
              pattern when not specifying this parameter is <span class="codefrag">\.xml$</span>, so that all files
              ending <span class="codefrag">.xml</span> are handled as XML files.<br>
              The pattern is a regular expression as described in the API docs of the
              <a href="http://jakarta.apache.org/regexp/apidocs/org/apache/regexp/RE.html">
              Apache RegExp project</a>.</li>
        
  </ul>
  </div>
      
  <a name="N10060"></a><a name="Extended+DTD"></a>
  <h3>Extended DTD</h3>
  <div style="margin-left: 0 ; border: 2px">
  <pre class="code">
    &lt;!ELEMENT directory (directory|file)*&gt;
    &lt;!ATTLIST directory
      name         CDATA #REQUIRED
      lastModified CDATA #REQUIRED
      date         CDATA #REQUIRED
      size         CDATA #REQUIRED
      requested    CDATA #IMPLIED
      sort         CDATA #IMPLIED
      reverse      CDATA #IMPLIED&gt;
  
    &lt;!ELEMENT file (xpath?)&gt;
    &lt;!ATTLIST file
      name         CDATA #REQUIRED
      lastModified CDATA #REQUIRED
      date         CDATA #REQUIRED
      size         CDATA #REQUIRED&gt;
  
    &lt;!ELEMENT xpath #ALL&gt;
    &lt;!ATTLIST xpath
      query        CDATA #REQUIRED&gt;
        </pre>
  </div>
      
  <a name="N1006B"></a><a name="Example"></a>
  <h3>Example</h3>
  <div style="margin-left: 0 ; border: 2px">
  <p>The current XPath Directory Generator may generate following xml:</p>
  <pre class="code">
  &lt;dir:directory xmlns:dir="http://apache.org/cocoon/directory/2.0"
      name="articles" lastModified="1057183738609" date="03.07.03 00:08" size="0"
      requested="true" sort="name" reverse="false"&gt;
    &lt;dir:directory name="images" lastModified="1057183738609" date="03.07.03 00:08" size="0"/&gt;
    &lt;dir:file name="article1.xml" lastModified="1057183738609" date="03.07.03 00:08" size="123"&gt;
      &lt;dir:xpath query="/article/title"&gt;
        &lt;title&gt;My first article!&lt;/title&gt;
      &lt;/dir:xpath&gt;
    &lt;/dir:file&gt;
    &lt;dir:file name="article2.html" lastModified="1057183738609" date="03.07.03 00:08" size="345"/&gt;
    &lt;dir:file name="article2.xml" lastModified="1057183738609" date="03.07.03 00:08" size="234"&gt;
      &lt;dir:xpath query="/article/title"&gt;
        &lt;title&gt;My second article!&lt;/title&gt;
      &lt;/dir:xpath&gt;
    &lt;/dir:file&gt;
  &lt;/dir:directory&gt;
        </pre>
  </div>
    
  </div>
  </td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td>
  </tr>
  <!--================= end Content==================-->
  </table>
  </td>
  </tr>
  </table>
  <!--================= end Menu, NavBar, Content ==================-->
  <!--================= start Footer ==================-->
  <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  <tr>
  <td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
  </tr>
  <tr>
  <td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
            1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
                document.write(" - "+"Last Published: " + document.lastModified);
              //  --></script></font></td>
  </tr>
  <tr>
  <td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  </tr>
  </table>
  <!--================= end Footer ==================-->
  </body>
  </html>
  
  
  
  1.1                  cocoon-site/site/2.1/userdocs/generators/xpathdirectory-generator.pdf
  
  	<<Binary file>>