cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From asav...@apache.org
Subject svn commit: r573901 [11/44] - in /cocoon/site: site/ site/2.0/ site/2.0/developing/ site/2.0/faq/ site/2.0/howto/chaperon/ site/2.0/installing/ site/2.0/plan/ site/2.0/snippet/ site/2.0/tutorial/ site/2.0/userdocs/ site/2.0/userdocs/actions/ site/2.0/u...
Date Sat, 08 Sep 2007 20:17:47 GMT
Modified: cocoon/site/site/2.0/faq/faq-serializers.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/faq/faq-serializers.html?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/faq/faq-serializers.html (original)
+++ cocoon/site/site/2.0/faq/faq-serializers.html Sat Sep  8 13:17:41 2007
@@ -1,413 +1,413 @@
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Cocoon Sitemap Serializer FAQs</title>
-<STYLE type="text/css">
-a.menu {
-	color: #FFFFFF;
-    text-align:left;               
-    font-size:12px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:plain;
-    text-decoration:none;
-    padding-left: 14px
-}
-
-A.menu:hover {
-	color: #FFCC00
-}
-
-
-.menutitle {
-	color: #000000;
-    text-align:left;               
-    font-size:10px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:bold;
-    padding-left: 8px
-}
-.menuselected {
-	color: #FFCC00;
-    text-align:left;               
-    font-size:12px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:bold;
-    padding-left: 14px
-}
-</STYLE>
-</head>
-<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4"
alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
-<table border="0" cellpadding="0" cellspacing="0" width="100%">
-<tr>
-<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0"
vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif"
rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td
align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0"
hspace="0" src="images/right.gif" height="60" width="29"></td>
-</tr>
-<tr>
-<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font
color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Cocoon Sitemap Serializer
FAQs</font></td>
-</tr>
-<tr>
-<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2"
align="right">
-<table width="288" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img
border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96"
alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20"
width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0"
hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td
align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img
border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96"
alt="http://www.w3.org/"></a></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr width="100%">
-<td align="left" valign="top" width="120">
-<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
-<tr>
-<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif"
hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="../index.html">Main</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img
width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">FAQs</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="index.html">Index</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img
width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Getting Started</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-install.html">Install</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-configure-environment.html">Configure</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-cvs.html">CVS</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img
width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Using</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-configure-c2.html">Configure C2</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-databases.html">Databases</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-xsp.html">XSP</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-xslt.html">XSLT</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-debugging.html">Debugging</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img
width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Sitemap</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-sitemap.html">Sitemap</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-generators.html">Generators</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-transformers.html">Transformers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span
class="menuselected">Serializers</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-matchers.html">Matchers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-selectors.html">Selectors</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-actions.html">Actions</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-aggregators.html">Aggregators</a></td>
-</tr>
-<tr>
-<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif"
hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-</table>
-</td><td>
-<table cellspacing="15" cellpadding="0" border="0">
-<tr>
-<td><font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Questions</font>
-<hr style="color: #0086b2" size="1">
-<blockquote>
-<ul>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-1">
-  What is a serializer?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-2">
-  What is the easiest way to generate XHTML output?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-3">
-How can I remove the DTD declaration at the top of my HTML
-pages created from pipelines with the default (HTML) serializer?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-4">
-How can I remove namespaces from my xml files?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-5">
-  How can I add my FAQ to this document? 
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-6">
-  How can I suggest improvements to existing FAQs?
- </a></font>
-</li>
-</ul>
-</blockquote>
-<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Answers</font>
-<hr style="color: #0086b2" size="1">
-<a name="faq-1">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-  What is a serializer?
- </b></font>
- 
-
- 
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-A serializer is the end point of an xml pipeline. It transforms SAX events into binary or
char streams for final client consumption. Every pipeline match containing a generator must
be terminated by a serializer. 
-  </font>
-</p>
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-In the sitemap file, each serializer has a unique name which is mapped to a java class. One
serializer name must be declared as the default serializer. Each serializer may have additional
configuration information specified in child elements.
-  </font>
-</p>
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- For more conceptual information about serializers see <a href="../userdocs/concepts/sitemap.html">the
sitemap</a>. For detailed descriptions about all of the available Cocoon serializers,
see the user's guide document <a href="../userdocs/serializers/serializers.html">Serializers
in Cocoon</a>. You may also wish to consult the Cocoon API documentation.
-  </font>
-</p>
-
-
-<a name="faq-2">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-  What is the easiest way to generate XHTML output?
- </b></font>
- 
-
- 
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-I have an stylesheet which transforms XML to XHTML, but it seems that the 
-serializer converts it to HTML. For example, I have some &lt;br/&gt; elements which
are converted to  &lt;br&gt; elements. What can I do?
-  </font>
-</p>
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Cocoon has serializer configured for XHTML. First, make sure to declare it in
-your sitemap's component section (within map:serializers).
-  </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;map:serializer name="xhtml" mime-type="text/html"
-  logger="sitemap.serializer.xhtml"
-  src="org.apache.cocoon.serialization.XMLSerializer"
-  pool-max="64" pool-min="2" pool-grow="2"&gt;
-  &lt;doctype-public&gt;-//W3C//DTD XHTML 1.0 Strict//EN&lt;/doctype-public&gt;
-  &lt;doctype-system&gt;http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd&lt;/doctype-system&gt;
- &lt;encoding&gt;UTF-8&lt;/encoding&gt;
-&lt;/map:serializer&gt;  
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Then, in any pipeline, simply use the serializer as follows.
-  </font>
-</p>
-  
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;map:serialize type="xhtml" /&gt;
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-
-
-
-<a name="faq-3">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-How can I remove the DTD declaration at the top of my HTML
-pages created from pipelines with the default (HTML) serializer?
- </b></font>
- 
-
- 
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Within the map:components section of sitemap.xmap, adjust the configuration of your HTML
serializer component as follows.
-  </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-&lt;map:serializers default="html"&gt;
-
-  &lt;map:serializer name="html" mime-type="text/html; charset=ISO-8859-1"
-     src="org.apache.cocoon.serialization.HTMLSerializer"&gt;
-    &lt;encoding&gt;ISO-8859-1&lt;/encoding&gt;
-    &lt;omit-xml-declaration&gt;true&lt;/omit-xml-declaration&gt;
-  &lt;/map:serializer&gt;
-   
-  &lt;!-- other serializers --&gt;
-   
-&lt;/map:serializers&gt;
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-  
-<p>
-<table border="0" cellpadding="0" cellspacing="3" width="100%">
-<tr>
-<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29"
width="28" src="images/note.gif"></td><td valign="top"><font color="black"
face="verdana,helvetica,sanserif" size="-1"><i>
-Consider using the XMLSerializer in your pipeline. The XMLSerializer will not write a DocType
Declaration.
-  </i></font></td>
-</tr>
-</table>
-</p>
-  
-
-
-
-<a name="faq-4">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-How can I remove namespaces from my xml files?
- </b></font>
- 
-
- 
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Sometimes adding xsl:exclude-result-prefixes attributes
-to the &lt;xsl:stylesheet&gt; or literal result element is not effective
-in removing all namespace declarations. For example, namespace nodes copied 
-from the source document within &lt;xsl:copy&gt; or &lt;xsl:copy-of&gt; instructions

-(commonly found in catch-all stylesheet templates) will not be excluded.
-  </font>
-</p> 
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-There are two approaches to this problem. 
-  </font>
-</p> 
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-One approach is to extend your serializer component and override the startPrefixMapping and
endPrefixMapping methods to do nothing. This will remove <b>all</b> namespaces
from the serialized output. Since your serializer will no longer be processing namespaces,
this theoretically will improve performance ever so slightly. You could generalize this approach
by using the serializer's configuration method to declare namespaces to be excluded.
-  </font>
-</p>
- 
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Another approach is to use an interim transformation step in your pipeline with a stylesheet
described <a href="faq-xslt.html#faq-5">here</a>.
-  </font>
-</p>
-
-  
-
-
-
-<a name="faq-5">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-  How can I add my FAQ to this document? 
- </b></font>
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-   Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To
Author an FAQ.</a></font>
-</p>
-<a name="faq-6">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-  How can I suggest improvements to existing FAQs?
- </b></font>
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-  Given the rapid pace of change with Cocoon, many individual FAQs quickly become out-of-date
and confusing to new users. If you have the relevant knowledge, please consider updating other
FAQs on this page for technical errors. If you see a few typos, please consider fixing them
too.  Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To
Author an FAQ.</a></font>
-</p>
-</td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
-</tr>
-<tr>
-<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright
&copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
-</tr>
-</table>
-</body>
-</html>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Cocoon Sitemap Serializer FAQs</title>
+<STYLE type="text/css">
+a.menu {
+	color: #FFFFFF;
+    text-align:left;               
+    font-size:12px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:plain;
+    text-decoration:none;
+    padding-left: 14px
+}
+
+A.menu:hover {
+	color: #FFCC00
+}
+
+
+.menutitle {
+	color: #000000;
+    text-align:left;               
+    font-size:10px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:bold;
+    padding-left: 8px
+}
+.menuselected {
+	color: #FFCC00;
+    text-align:left;               
+    font-size:12px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:bold;
+    padding-left: 14px
+}
+</STYLE>
+</head>
+<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4"
alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr>
+<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0"
vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif"
rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td
align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0"
hspace="0" src="images/right.gif" height="60" width="29"></td>
+</tr>
+<tr>
+<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font
color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Cocoon Sitemap Serializer
FAQs</font></td>
+</tr>
+<tr>
+<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2"
align="right">
+<table width="288" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img
border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96"
alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20"
width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0"
hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td
align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img
border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96"
alt="http://www.w3.org/"></a></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr width="100%">
+<td align="left" valign="top" width="120">
+<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
+<tr>
+<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif"
hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="../index.html">Main</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img
width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">FAQs</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="index.html">Index</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img
width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Getting Started</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-install.html">Install</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-configure-environment.html">Configure</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-cvs.html">CVS</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img
width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Using</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-configure-c2.html">Configure C2</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-databases.html">Databases</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-xsp.html">XSP</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-xslt.html">XSLT</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-debugging.html">Debugging</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img
width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Sitemap</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-sitemap.html">Sitemap</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-generators.html">Generators</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-transformers.html">Transformers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span
class="menuselected">Serializers</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-matchers.html">Matchers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-selectors.html">Selectors</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-actions.html">Actions</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a
class="menu" href="faq-aggregators.html">Aggregators</a></td>
+</tr>
+<tr>
+<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif"
hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+</table>
+</td><td>
+<table cellspacing="15" cellpadding="0" border="0">
+<tr>
+<td><font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Questions</font>
+<hr style="color: #0086b2" size="1">
+<blockquote>
+<ul>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-1">
+  What is a serializer?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-2">
+  What is the easiest way to generate XHTML output?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-3">
+How can I remove the DTD declaration at the top of my HTML
+pages created from pipelines with the default (HTML) serializer?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-4">
+How can I remove namespaces from my xml files?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-5">
+  How can I add my FAQ to this document? 
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-6">
+  How can I suggest improvements to existing FAQs?
+ </a></font>
+</li>
+</ul>
+</blockquote>
+<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Answers</font>
+<hr style="color: #0086b2" size="1">
+<a name="faq-1">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+  What is a serializer?
+ </b></font>
+ 
+
+ 
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+A serializer is the end point of an xml pipeline. It transforms SAX events into binary or
char streams for final client consumption. Every pipeline match containing a generator must
be terminated by a serializer. 
+  </font>
+</p>
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+In the sitemap file, each serializer has a unique name which is mapped to a java class. One
serializer name must be declared as the default serializer. Each serializer may have additional
configuration information specified in child elements.
+  </font>
+</p>
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ For more conceptual information about serializers see <a href="../userdocs/concepts/sitemap.html">the
sitemap</a>. For detailed descriptions about all of the available Cocoon serializers,
see the user's guide document <a href="../userdocs/serializers/serializers.html">Serializers
in Cocoon</a>. You may also wish to consult the Cocoon API documentation.
+  </font>
+</p>
+
+
+<a name="faq-2">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+  What is the easiest way to generate XHTML output?
+ </b></font>
+ 
+
+ 
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+I have an stylesheet which transforms XML to XHTML, but it seems that the 
+serializer converts it to HTML. For example, I have some &lt;br/&gt; elements which
are converted to  &lt;br&gt; elements. What can I do?
+  </font>
+</p>
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Cocoon has serializer configured for XHTML. First, make sure to declare it in
+your sitemap's component section (within map:serializers).
+  </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;map:serializer name="xhtml" mime-type="text/html"
+  logger="sitemap.serializer.xhtml"
+  src="org.apache.cocoon.serialization.XMLSerializer"
+  pool-max="64" pool-min="2" pool-grow="2"&gt;
+  &lt;doctype-public&gt;-//W3C//DTD XHTML 1.0 Strict//EN&lt;/doctype-public&gt;
+  &lt;doctype-system&gt;http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd&lt;/doctype-system&gt;
+ &lt;encoding&gt;UTF-8&lt;/encoding&gt;
+&lt;/map:serializer&gt;  
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Then, in any pipeline, simply use the serializer as follows.
+  </font>
+</p>
+  
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;map:serialize type="xhtml" /&gt;
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+
+
+
+<a name="faq-3">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+How can I remove the DTD declaration at the top of my HTML
+pages created from pipelines with the default (HTML) serializer?
+ </b></font>
+ 
+
+ 
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Within the map:components section of sitemap.xmap, adjust the configuration of your HTML
serializer component as follows.
+  </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+&lt;map:serializers default="html"&gt;
+
+  &lt;map:serializer name="html" mime-type="text/html; charset=ISO-8859-1"
+     src="org.apache.cocoon.serialization.HTMLSerializer"&gt;
+    &lt;encoding&gt;ISO-8859-1&lt;/encoding&gt;
+    &lt;omit-xml-declaration&gt;true&lt;/omit-xml-declaration&gt;
+  &lt;/map:serializer&gt;
+   
+  &lt;!-- other serializers --&gt;
+   
+&lt;/map:serializers&gt;
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td
height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+  
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29"
width="28" src="images/note.gif"></td><td valign="top"><font color="black"
face="verdana,helvetica,sanserif" size="-1"><i>
+Consider using the XMLSerializer in your pipeline. The XMLSerializer will not write a DocType
Declaration.
+  </i></font></td>
+</tr>
+</table>
+</p>
+  
+
+
+
+<a name="faq-4">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+How can I remove namespaces from my xml files?
+ </b></font>
+ 
+
+ 
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Sometimes adding xsl:exclude-result-prefixes attributes
+to the &lt;xsl:stylesheet&gt; or literal result element is not effective
+in removing all namespace declarations. For example, namespace nodes copied 
+from the source document within &lt;xsl:copy&gt; or &lt;xsl:copy-of&gt; instructions

+(commonly found in catch-all stylesheet templates) will not be excluded.
+  </font>
+</p> 
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+There are two approaches to this problem. 
+  </font>
+</p> 
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+One approach is to extend your serializer component and override the startPrefixMapping and
endPrefixMapping methods to do nothing. This will remove <b>all</b> namespaces
from the serialized output. Since your serializer will no longer be processing namespaces,
this theoretically will improve performance ever so slightly. You could generalize this approach
by using the serializer's configuration method to declare namespaces to be excluded.
+  </font>
+</p>
+ 
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Another approach is to use an interim transformation step in your pipeline with a stylesheet
described <a href="faq-xslt.html#faq-5">here</a>.
+  </font>
+</p>
+
+  
+
+
+
+<a name="faq-5">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+  How can I add my FAQ to this document? 
+ </b></font>
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+   Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To
Author an FAQ.</a></font>
+</p>
+<a name="faq-6">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+  How can I suggest improvements to existing FAQs?
+ </b></font>
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+  Given the rapid pace of change with Cocoon, many individual FAQs quickly become out-of-date
and confusing to new users. If you have the relevant knowledge, please consider updating other
FAQs on this page for technical errors. If you see a few typos, please consider fixing them
too.  Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To
Author an FAQ.</a></font>
+</p>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
+</tr>
+<tr>
+<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright
&copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
+</tr>
+</table>
+</body>
+</html>



Mime
View raw message