You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by cr...@apache.org on 2002/12/28 08:06:53 UTC
cvs commit: xml-cocoon2/src/documentation/xdocs/userdocs/serializers book.xml html-serializer.xml serializers.xml svg-serializer.xml svgjpeg-serializer.xml svgpng-serializer.xml svgxml-serializer.xml text-serializer.xml wap-serializer.xml xml-serializer.xml
crossley 2002/12/27 23:06:53
Modified: . Tag: cocoon_2_0_3_branch changes.xml
src/documentation/xdocs/userdocs Tag: cocoon_2_0_3_branch
book.xml
src/documentation/xdocs/userdocs/serializers Tag:
cocoon_2_0_3_branch book.xml html-serializer.xml
serializers.xml svg-serializer.xml
svgjpeg-serializer.xml svgpng-serializer.xml
svgxml-serializer.xml text-serializer.xml
wap-serializer.xml xml-serializer.xml
Added: src/documentation/xdocs/userdocs/readers Tag:
cocoon_2_0_3_branch axisrpc-reader.xml book.xml
byterangeresource-reader.xml database-reader.xml
directoryziparchiver-reader.xml image-reader.xml
jsp-reader.xml readers.xml resource-reader.xml
template-reader.xml
Log:
Sync with new docs from head.
Revision Changes Path
No revision
No revision
1.138.2.81 +9 -1 xml-cocoon2/changes.xml
Index: changes.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/changes.xml,v
retrieving revision 1.138.2.80
retrieving revision 1.138.2.81
diff -u -r1.138.2.80 -r1.138.2.81
--- changes.xml 23 Dec 2002 08:21:59 -0000 1.138.2.80
+++ changes.xml 28 Dec 2002 07:06:51 -0000 1.138.2.81
@@ -40,6 +40,14 @@
</devs>
<release version="@version@" date="@date@">
+ <action dev="BH" type="update">
+ Update XML Serializer, HTML Serializer , and Text Serializer documentation,
+ added XHTML Serializer documentation in the serializer user documentation section.
+ </action>
+ <action dev="BH" type="update">
+ Update SVG Serializer, SVG JPEG, and SVG PNG documentation, added
+ SVG TIFF documentation in the serializer user documentation section.
+ </action>
<action dev="DC" type="update">
Fixed "build test" (was missing tools/lib/excalibur-testcase-1.0.jar).
The Junit tests now work again.
No revision
No revision
1.1.2.1 +1 -0 xml-cocoon2/src/documentation/xdocs/userdocs/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/book.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- book.xml 3 Jan 2002 12:31:04 -0000 1.1
+++ book.xml 28 Dec 2002 07:06:51 -0000 1.1.2.1
@@ -20,6 +20,7 @@
<menu-item label="Matchers" href="matchers/matchers.html"/>
<menu-item label="Selectors" href="selectors/selectors.html"/>
<menu-item label="Actions" href="actions/actions.html"/>
+ <menu-item label="Readers" href="readers/readers.html"/>
<menu-item label="XSP" href="xsp/index.html"/>
</menu>
No revision
No revision
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/axisrpc-reader.xml
Index: axisrpc-reader.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/axisrpc-reader.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/book.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/byterangeresource-reader.xml
Index: byterangeresource-reader.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/byterangeresource-reader.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/database-reader.xml
Index: database-reader.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/database-reader.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/directoryziparchiver-reader.xml
Index: directoryziparchiver-reader.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/directoryziparchiver-reader.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/image-reader.xml
Index: image-reader.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/image-reader.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/jsp-reader.xml
Index: jsp-reader.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/jsp-reader.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/readers.xml
Index: readers.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/readers.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/resource-reader.xml
Index: resource-reader.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/resource-reader.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
1.1.2.1 +0 -0 xml-cocoon2/src/documentation/xdocs/userdocs/readers/template-reader.xml
Index: template-reader.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/readers/template-reader.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
No revision
No revision
1.1.2.3 +4 -0 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/book.xml,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -r1.1.2.2 -r1.1.2.3
--- book.xml 31 Oct 2002 16:22:49 -0000 1.1.2.2
+++ book.xml 28 Dec 2002 07:06:52 -0000 1.1.2.3
@@ -17,6 +17,9 @@
<menu-item label="HTML Serializer" href="html-serializer.html"/>
</menu>
<menu label="Core">
+<!--
+ <menu-item label="XHTML Serializer" href="xhtml-serializer.html"/>
+-->
<menu-item label="XML Serializer" href="xml-serializer.html"/>
<menu-item label="Text Serializer" href="text-serializer.html"/>
<menu-item label="WAP/WML Serializer" href="wap-serializer.html"/>
@@ -24,6 +27,7 @@
<menu-item label="SVG/XML Serializer" href="svgxml-serializer.html"/>
<menu-item label="SVG/JPEG Serializer" href="svgjpeg-serializer.html"/>
<menu-item label="SVG/PNG Serializer" href="svgpng-serializer.html"/>
+ <menu-item label="SVG/TIFF Serializer" href="svgtiff-serializer.html"/>
<menu-item label="VRML Serializer" href="vrml-serializer.html"/>
<menu-item label="Link Serializer" href="link-serializer.html"/>
<menu-item label="Zip archive Serializer" href="ziparchive-serializer.html"/>
1.1.2.1 +232 -20 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/html-serializer.xml
Index: html-serializer.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/html-serializer.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- html-serializer.xml 3 Jan 2002 12:31:05 -0000 1.1
+++ html-serializer.xml 28 Dec 2002 07:06:52 -0000 1.1.2.1
@@ -1,25 +1,237 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
+<!--
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN" "http://www.w3.org/TR/REC-html40/frameset.dtd">
+
+-->
+
<document>
- <header>
- <title>HTML Serializer</title>
- <version>0.9</version>
- <type>Technical document</type>
- <authors>
- <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
- </authors>
- <abstract>This document describes the html serializer of Cocoon.</abstract>
- </header>
- <body>
- <s1 title="HTML Serializer">
- <p>The html serializer serializes xhtml into valid html.</p>
- <p>The html serializer is the default serializer .</p>
- <ul>
- <li>Name : html</li>
- <li>Class: org.apache.cocoon.serialization.HtmlSerializer</li>
- <li>Cacheable: yes.</li>
- </ul>
- </s1>
- </body>
+ <header>
+ <title>HTML Serializer</title>
+ <version>0.9</version>
+ <type>Technical document</type>
+ <authors>
+ <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
+ <person name="Bernhard Huber" email="huber@apache.org"/>
+ </authors>
+ <abstract>This document describes the html serializer of Cocoon.</abstract>
+ </header>
+ <body>
+ <s1 title="HTML Serializer">
+ <p>
+ The HTML serializer serializes xml content to html.
+ It is the default serializer.
+ </p>
+ <ul>
+ <li>Name : html</li>
+ <li>Class: org.apache.cocoon.serialization.HtmlSerializer</li>
+ <li>Cacheable: yes.</li>
+ </ul>
+ <s2 title="Sitemap Configuration">
+ <p>
+ The HTML Serializer is declared in the sitemap serializers section.
+ </p>
+ <source><![CDATA[
+<map:serializers default="html">
+...
+ <map:serializer name="html"
+ src="org.apache.cocoon.serialization.HTMLSerializer"
+ mime-type="text/html"
+ logger="sitemap.serializer.html"
+ pool-grow="4" pool-max="32" pool-min="4">
+ <!-- serializer configurations -->
+...
+ </map:serializer>
+...
+ ]]></source>
+ <p>
+ HTML Serializer can be configured, specifying elements inside of
+ the <map:serializer> body.
+ </p>
+ <s3 title="Configuration Example">
+ <p>
+ The following HTML Serializer snippet is setting
+ doctype, and encoding configuration for the HTML Serializer
+ </p>
+ <source><![CDATA[
+<map:serializer name="html"
+ src="org.apache.cocoon.serialization.HTMLSerializer"
+ mime-type="text/html">
+ <doctype-public>-//W3C//DTD HTML 4.01 Transitional//EN</doctype-public>
+ <encoding>ISO-8859-1</encoding>
+</map:serializer>
+ ]]></source>
+ <p>
+ This configuration will result in HTML output of the form
+ </p>
+ <source><![CDATA[
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title...
+...
+ ]]></source>
+ </s3>
+ <p>
+ The HTML Serializer accepts following configuration parameters.
+ These configurations are not Xalan specific.
+ </p>
+<!--
+# XSLT properties do not need namespace qualification.
+method=xml
+indent=yes
+media-type=text/html
+version=4.0
+
+# Xalan-specific output properties. These can be overridden in the stylesheet
+# assigning a xalan namespace. For example:
+# <xsl:stylesheet version="1.0"
+# xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+# xmlns:xalan="http://xml.apache.org/xslt">
+# <xsl:output method="html" encoding="UTF-8"
+# xalan:content-handler="MyContentHandler"/>
+# ...
+# Note that the colon after the protocol needs to be escaped.
+{http\u003a//xml.apache.org/xslt}indent-amount=0
+{http\u003a//xml.apache.org/xslt}content-handler=org.apache.xalan.serialize.SerializerToHTML
+{http\u003a//xml.apache.org/xslt}entities=HTMLEntities.res
+{http\u003a//xml.apache.org/xslt}use-url-escaping=yes
+-->
+ <table>
+ <tr><th>Name</th><th>Xalan Default Value</th><th>Comment</th></tr>
+ <tr><td>cdata-section-elements</td>
+ <td>none</td>
+ <td><code>cdata-section-elements</code> specifies a whitespace delimited
+ list of the names of elements whose text node children should be output
+ using CDATA sections.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation.</link>
+ </td>
+ </tr>
+ <tr><td>doctype-public</td>
+ <td>none</td>
+ <td><code>doctype-public</code> specifies the public identifier
+ to be used in the document type declaration.
+ </td>
+ </tr>
+ <tr><td>doctype-system</td>
+ <td>none</td>
+ <td>
+ <code>doctype-system</code> specifies the system identifier
+ to be used in the document type declaration.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>encoding</td>
+ <td>none</td>
+ <td><code>encoding</code> specifies the preferred character
+ encoding that the Transformer should use to encode sequences of
+ characters as sequences of bytes. The value of the attribute should be
+ treated case-insensitively. The value must only contain characters in
+ the range #x21 to #x7E (i.e., printable ASCII characters). The value
+ should either be a <code>charset</code> registered with the Internet
+ Assigned Numbers Authority <link href="#IANA">[IANA]</link>,
+ <link href="#RFC2278">[RFC2278]</link> or start with <code>X-</code>.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>indent</td>
+ <td>
+ yes
+ </td>
+ <td>
+ A Flag for toggling indent. This flag toggles only if some elements
+ should trigger a line break.
+ </td>
+ </tr>
+ <tr><td>media-type</td>
+ <td>
+ </td>
+ <td>
+ <code>media-type</code> specifies the media type (MIME
+ content type) of the data that results from outputting the result
+ tree. The <code>charset</code> parameter should not be specified
+ explicitly; instead, when the top-level media type is
+ <code>text</code>, a <code>charset</code> parameter should be added
+ according to the character encoding actually used by the output
+ method.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>method</td>
+ <td>
+ </td>
+ <td>
+ The method attribute identifies the overall method that
+ should be used for outputting the result tree. Other non-namespaced
+ values may be used, such as "xhtml", but, if accepted, the handling
+ of such values is implementation defined. If any of the method values
+ are not accepted and are not namespace qualified,
+ then {@link javax.xml.transform.Transformer#setOutputProperty}
+ or {@link javax.xml.transform.Transformer#setOutputProperties} will
+ throw a {@link java.lang.IllegalArgumentException}.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>omit-xml-declaration</td>
+ <td></td>
+ <td>
+ <code>omit-xml-declaration</code> specifies whether the XSLT
+ processor should output an XML declaration; the value must be
+ <code>yes</code> or <code>no</code>.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>standalone</td>
+ <td></td>
+ <td>
+ <code>standalone</code> specifies whether the Transformer
+ should output a standalone document declaration; the value must be
+ <code>yes</code> or <code>no</code>.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>version</td>
+ <td>
+ </td>
+ <td>
+ <code>version</code> specifies the version of the output
+ method.
+ When the output method is "xml", the version value specifies the
+ version of XML to be used for outputting the result tree. The default
+ value for the xml output method is 1.0. When the output method is
+ "html", the version value indicates the version of the HTML.
+ The default value for the xml output method is 4.0, which specifies
+ that the result should be output as HTML conforming to the HTML 4.0
+ Recommendation [HTML]. If the output method is "text", the version
+ property is ignored.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ </table>
+ <note>
+ Former property <code>buffer-size</code> is deprecated, and is ignored.
+ </note>
+ <p>
+ The HTML Serializer sets the <code>method</code> property
+ to <code>html</code>.
+ </p>
+ </s2>
+ <s2 title="Pipeline Usage">
+ <source><![CDATA[
+...
+<map:match pattern="*.html">
+<map:generate...
+...
+<map:serialize type="html"/>
+...
+ ]]></source>
+ </s2>
+ <s2 title="Further Reading">
+ </s2>
+ </s1>
+ </body>
</document>
+
1.1.2.2 +59 -44 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/serializers.xml
Index: serializers.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/serializers.xml,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -u -r1.1.2.1 -r1.1.2.2
--- serializers.xml 7 Jun 2002 19:58:28 -0000 1.1.2.1
+++ serializers.xml 28 Dec 2002 07:06:52 -0000 1.1.2.2
@@ -2,48 +2,63 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
- <header>
- <title>Serializers</title>
- <version>0.9</version>
- <type>Technical document</type>
- <authors>
- <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
- </authors>
- <abstract>This document describes all of the available serializers of Cocoon.</abstract>
- </header>
- <body>
- <s1 title="Goal">
- <p>This document lists all of the available serializers of Apache Cocoon and
- describes their purpose.</p>
- </s1>
- <s1 title="Overview">
- <p>
-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.
- </p>
- <p>
-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 serialzer. Each serializer may have additional configuration information specified in child elements.
- </p>
- <p>
- For more conceptual information about serializers see <link href="../concepts/sitemap.html">the sitemap</link>.
- </p>
- </s1>
- <s1 title="The Serializers in Apache Cocoon">
- <ul>
- <li><link href="html-serializer.html">HTML Serializer</link> (The default serializer)</li>
- <li><link href="xml-serializer.html">XML Serializer</link></li>
- <li><link href="text-serializer.html">Text Serializer</link></li>
- <li><link href="xls-serializer.html">HSSF (XLS) Serializer</link> (optional)</li>
- <li><link href="pdf-serializer.html">PDF Serializer</link> (optional)</li>
- <li><link href="ps-serializer.html">PS Serializer</link> (optional)</li>
- <li><link href="pcl-serializer.html">PCL Serializer</link> (optional)</li>
- <li><link href="wap-serializer.html">WAP/WML Serializer</link></li>
- <li><link href="svg-serializer.html">SVG Serializer</link></li>
- <li><link href="svgxml-serializer.html">SVG/XML Serializer</link></li>
- <li><link href="svgjpeg-serializer.html">SVG/JPEG Serializer</link></li>
- <li><link href="svgpng-serializer.html">SVG/PNG Serializer</link></li>
- <li><link href="vrml-serializer.html">VRML Serializer</link></li>
- <li><link href="link-serializer.html">Link Serializer</link></li>
- </ul>
- </s1>
- </body>
+ <header>
+ <title>Serializers</title>
+ <version>0.9</version>
+ <type>Technical document</type>
+ <authors>
+ <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
+ <person name="Bernhard Huber" email="huber@apache.org"/>
+ </authors>
+ <abstract>This document describes all of the available serializers of Cocoon.</abstract>
+ </header>
+ <body>
+ <s1 title="Goal">
+ <p>
+ This document lists all of the available serializers of Apache Cocoon and
+ describes their purpose.
+ </p>
+ </s1>
+ <s1 title="Overview">
+ <p>
+ 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.
+ </p>
+ <p>
+ 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 serialzer.
+ Each serializer may have additional configuration information
+ specified in child elements.
+ </p>
+ <p>
+ For more conceptual information about serializers
+ see <link href="../concepts/sitemap.html">the sitemap</link>.
+ </p>
+ </s1>
+ <s1 title="The Serializers in Apache Cocoon">
+ <ul>
+ <li><link href="html-serializer.html">HTML Serializer</link> (The default serializer)</li>
+ <li><link href="xhtml-serializer.html">XHTML Serializer</link></li>
+ <li><link href="xml-serializer.html">XML Serializer</link></li>
+ <li><link href="text-serializer.html">Text Serializer</link></li>
+ <li><link href="xls-serializer.html">HSSF (XLS) Serializer</link> (optional)</li>
+ <li><link href="pdf-serializer.html">PDF Serializer</link> (optional)</li>
+ <li><link href="ps-serializer.html">PS Serializer</link> (optional)</li>
+ <li><link href="pcl-serializer.html">PCL Serializer</link> (optional)</li>
+ <li><link href="wap-serializer.html">WAP/WML Serializer</link></li>
+ <li><link href="svg-serializer.html">SVG Serializer</link></li>
+ <li><link href="svgxml-serializer.html">SVG/XML Serializer</link></li>
+ <li><link href="svgjpeg-serializer.html">SVG/JPEG Serializer</link></li>
+ <li><link href="svgpng-serializer.html">SVG/PNG Serializer</link></li>
+ <li><link href="svgtiff-serializer.html">SVG/TIFF Serializer</link></li>
+ <li><link href="vrml-serializer.html">VRML Serializer</link></li>
+ <li><link href="link-serializer.html">Link Serializer</link></li>
+ </ul>
+ </s1>
+ </body>
</document>
+
1.1.2.1 +147 -93 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/svg-serializer.xml
Index: svg-serializer.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/svg-serializer.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- svg-serializer.xml 3 Jan 2002 12:31:05 -0000 1.1
+++ svg-serializer.xml 28 Dec 2002 07:06:52 -0000 1.1.2.1
@@ -2,54 +2,59 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
- <header>
- <title>The SVG Serializer</title>
- <authors>
- <person name="Ross Burton" email="rossb@apache.org"/>
- </authors>
- </header>
-
- <body>
- <s1 title="SVG Serializer">
- <s2 title="Introduction">
- <p>
- The SVG Serializer is an advanced serializer which accepts
- valid Scalable Vector Graphic documents (currently to the
- 2000-08-02 Candidate Recommendation specification) and
- renders it to an image which is served just like any other
- document in Cocoon.
- </p>
- <p>
- Why would you want to do this? Well, charts can be produced from the
- same data which generates tables, graphical images with text labels
- all following a standard theme can be generated or normal pages can be
- beautified.
- </p>
- <note>
- For examples of this serializer, see the Cocoon welcome
- page in the distribution (<code>[cocoon
- root]/welcome</code>).
- </note>
- <p>
- So how does this serializer work?
- </p>
- <ol>
- <li>Parse and validate SVG document</li>
- <li>Call Batik's <code>Transcoder</code> to encode this image as an image file, and return it to the user.</li>
- </ol>
- </s2>
-
- <s2 title="Usage">
- <p>The best way to explain how this serializer works is to show some examples.</p>
- <s3 title="Basic Example">
- <p>This is a basic example of the serializer.</p>
- <source><![CDATA[
+ <header>
+ <title>The SVG Serializer</title>
+ <authors>
+ <person name="Ross Burton" email="rossb@apache.org"/>
+ </authors>
+ </header>
+
+ <body>
+ <s1 title="SVG Serializer">
+ <s2 title="Introduction">
+ <p>
+ The SVG Serializer is an advanced serializer which accepts
+ valid Scalable Vector Graphic documents (currently to the
+ 2000-08-02 Candidate Recommendation specification) and
+ renders it to an image which is served just like any other
+ document in Cocoon.
+ </p>
+ <p>
+ Why would you want to do this? Well, charts can be produced from the
+ same data which generates tables, graphical images with text labels
+ all following a standard theme can be generated or normal pages can be
+ beautified.
+ </p>
+ <note>
+ For examples of this serializer, see the Cocoon welcome
+ page in the distribution (<code>[cocoon
+ root]/welcome</code>).
+ </note>
+ <p>
+ So how does this serializer work?
+ </p>
+ <ol>
+ <li>Parse and validate SVG document</li>
+ <li>Call Batik's <code>Transcoder</code> to encode this image as an image file, and return it to the user.</li>
+ </ol>
+ <p>
+ The SVG xml document must have a root element <svg>, using xml namespace
+ it is recommended to use the prefix <em>em</em>, and the namespace uri
+ <em>http://www.w3.org/2000/svg</em>.
+ </p>
+ </s2>
+
+ <s2 title="Usage">
+ <p>The best way to explain how this serializer works is to show some examples.</p>
+ <s3 title="Basic Example">
+ <p>This is a basic example of the serializer.</p>
+ <source><![CDATA[
<map:serializers>
<map:serializer>
<map:serializer name="svg2jpeg" mime-type="image/jpeg"
- src="org.apache.cocoon.serialization.SVGSerializer">
+ src="org.apache.cocoon.serialization.SVGSerializer">
<parameter name="transcoder"
- value="org.apache.batik.transcoder.image.JPEGTranscoder"/>
+ value="org.apache.batik.transcoder.image.JPEGTranscoder"/>
</map:serializer>
<map:serializers>
...
@@ -59,27 +64,39 @@
<map:serialize type="svg2jpeg"/>
</map:match>
</map:pipeline>
- ]]></source>
- <p>
- When the resource <code>sample.jpeg</code> is requested, a SAX event
- stream is generated from the file <code>sample.svg</code>, which is
- serialized using the <code>svg2jpeg</code> serializer. This
- serializer is configured to use a specific transcoder. The MIME type
- is specified so that Cocoon can tell the client which type the
- document is. It can be seen that in general the use of this
- serializer is identical to that of the other serializers.
- </p>
- </s3>
-
- <s3 title="Advanced Example">
- <p>This is a more advanced sample of using the SVG Serializer.</p>
- <source><![CDATA[
+ ]]></source>
+ <p>
+ When the resource <code>sample.jpeg</code> is requested, a SAX event
+ stream is generated from the file <code>sample.svg</code>, which is
+ serialized using the <code>svg2jpeg</code> serializer. This
+ serializer is configured to use a specific transcoder. The MIME type
+ is specified so that Cocoon can tell the client which type the
+ document is. It can be seen that in general the use of this
+ serializer is identical to that of the other serializers.
+ </p>
+ <p>
+ The parameter <em>transcoder</em> selects explicitly a batik transcoder.
+ You may want to rely on the default <em>mime-type</em> to
+ transcoder association, omitting the transcoder parameter
+ </p>
+ <table>
+ <tr><th>mime-type</th><th>transcoder-class</th></tr>
+ <tr><td>image/jpeg</td><td>org.apache.batik.transcoder.image.JPEGTranscoder</td></tr>
+ <tr><td>image/jpg</td><td>org.apache.batik.transcoder.image.JPEGTranscoder</td></tr>
+ <tr><td>image/png</td><td>org.apache.batik.transcoder.image.PNGTranscoder</td></tr>
+ <tr><td>image/tiff</td><td>org.apache.batik.transcoder.image.TIFFTranscoder</td></tr>
+ </table>
+ </s3>
+
+ <s3 title="Advanced Example">
+ <p>This is a more advanced sample of using the SVG Serializer.</p>
+ <source><![CDATA[
<map:serializers>
<map:serializer>
<map:serializer name="svg2jpeg" mime-type="image/jpeg"
- src="org.apache.cocoon.serialization.SVGSerializer">
+ src="org.apache.cocoon.serialization.SVGSerializer">
<parameter name="transcoder"
- value="org.apache.batik.transcoder.image.JPEGTranscoder"/>
+ value="org.apache.batik.transcoder.image.JPEGTranscoder"/>
<parameter name="background_color" type="color" value="#00FF00"/>
</map:serializer>
<map:serializers>
@@ -90,36 +107,73 @@
<map:serialize type="svg2jpeg"/>
</map:match>
</map:pipeline>
- ]]></source>
- <p>
- In this example another parameter is given to the serializer,
- <code>background_color</code>. This parameter is passed to the
- transcoder. The <code>type</code> argument specifies the type of
- data to convert the <code>value</code> to. In this example the
- string "#00FF00" is converted to a <code>Color</code> object, which
- is passed to the transcoder as the background colour to
- use.
- </p>
- <p>
- For a list of the parameters available for each transcoder, refer to
- the Batik API docs.
- </p>
- <fixme author="rossb@apache.org">
- Create a document summarising the transcoder hints
- </fixme>
- <p>
- For this to work reliably with any transcoder, some magic must be
- done. First, the parameter name is transformed to upper-case and then "KEY_" is
- prepended. This is to match the internal naming scheme of the hints
- in the Batik <code>Transcoder</code> interfaces. This name is then
- looked up via Reflection to ensure it is a valid parameter on the
- specified transcoder. Then the value is converted to the type
- specified in the <code>type</code> attribute (currently supported
- types are string, float, integer, boolean and color) and passed to
- the transcoder.
- </p>
- </s3>
- </s2>
- </s1>
- </body>
+ ]]></source>
+ <p>
+ In this example another parameter is given to the serializer,
+ <code>background_color</code>. This parameter is passed to the
+ transcoder. The <code>type</code> argument specifies the type of
+ data to convert the <code>value</code> to. In this example the
+ string "#00FF00" is converted to a <code>Color</code> object, which
+ is passed to the transcoder as the background colour to
+ use.
+ </p>
+ <p>
+ For a list of the parameters available for each transcoder, refer to
+ the Batik API docs.
+ </p>
+ <fixme author="rossb@apache.org">
+ Create a document summarising the transcoder hints
+ </fixme>
+ <p>
+ The following table summarizes most useful general SVG ImageTranscoder parameters,
+ all of these parameters are mapped to Batik's SVG ImageTranscoder hints.
+ </p>
+ <table>
+ <tr><td>width</td><td>float</td><td>Specifies the width of the rasterized image explictly.
+ If no height is specified the aspect ratio is kept.</td>
+ </tr>
+ <tr><td>height</td><td>float</td><td>Specifies the width of the rasterized image explictly.
+ If no width is specified the aspect ration is kept.</td>
+ </tr>
+ <tr><td>background_color</td><td>color</td><td>
+ Defines the background color
+ to use for opaque image formats, or the background color that may
+ be used for image formats that support alpha channel.
+ A color value of format <code>RRGGBB</code>,
+ or <code>#RRGGBB</code> sets the background color of the rasterized image, by default
+ the background color is white.</td>
+ </tr>
+ <tr><td>language</td><td>string</td><td>to set the default language to use
+ (may be used by a <switch> SVG element for example), by default language is
+ set to <code>en</code>.</td>
+ </tr>
+ <tr><td>user_stylesheet_ur</td><td>string</td><td>to fix the URI of a user stylesheet</td>
+ </tr>
+ <tr><td>pixel_to_mm</td><td>float</td><td>to specify the pixel to millimeter conversion factor, by default
+ its value is <code>0.264583</code> (96dpi).</td>
+ </tr>
+ </table>
+ <p>
+ For this to work reliably with any transcoder, some magic must be
+ done.
+ </p>
+ <ol>
+ <li>First, the parameter name is transformed to upper-case and then "KEY_" is
+ prepended. This is to match the internal naming scheme of the hints
+ in the Batik <code>Transcoder</code> interfaces.
+ </li>
+ <li>This name is then
+ looked up via Reflection to ensure it is a valid parameter on the
+ specified transcoder.
+ </li>
+ <li>Then the value is converted to the type
+ specified in the <code>type</code> attribute (currently supported
+ types are string, float, integer, boolean and color) and passed to
+ the transcoder.
+ </li>
+ </ol>
+ </s3>
+ </s2>
+ </s1>
+</body>
</document>
1.1.2.1 +82 -19 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/svgjpeg-serializer.xml
Index: svgjpeg-serializer.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/svgjpeg-serializer.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- svgjpeg-serializer.xml 3 Jan 2002 12:31:05 -0000 1.1
+++ svgjpeg-serializer.xml 28 Dec 2002 07:06:52 -0000 1.1.2.1
@@ -2,23 +2,86 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
- <header>
- <title>SVG/JPEG Serializer</title>
- <version>0.9</version>
- <type>Technical document</type>
- <authors>
- <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
- </authors>
- <abstract>This document describes the svg/jpeg serializer of Cocoon.</abstract>
- </header>
- <body>
- <s1 title="SVG/JPEG Serializer">
- <p>????.</p>
- <ul>
- <li>Name : svg2jpeg</li>
- <li>Class: org.apache.cocoon.serialization.SVGSerializer</li>
- <li>Cacheable: ????.</li>
- </ul>
- </s1>
- </body>
+ <header>
+ <title>SVG/JPEG Serializer</title>
+ <version>0.9</version>
+ <type>Technical document</type>
+ <authors>
+ <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
+ <person name="Bernhard Huber" email="huber@apache.org"/>
+ </authors>
+ <abstract>This document describes the svg/jpeg serializer of Cocoon.</abstract>
+ </header>
+ <body>
+ <s1 title="SVG/JPEG Serializer">
+ <p>
+ The SVG/JPEG serializes an xml svg document to a jpeg image.
+ The serialization uses the Batik's JPEGTranscoder internally.
+ </p>
+ <ul>
+ <li>Name : svg2jpeg</li>
+ <li>Class: org.apache.cocoon.serialization.SVGSerializer</li>
+ <li>Cacheable: yes</li>
+ </ul>
+ <s2 title="Sitemap Configuration">
+ <p>
+ A minimal sitemap configuration snippet declaring the svg2jpeg serializer:
+ </p>
+ <source><![CDATA[
+<map:serializers..
+ <map:serializer name="svg2jpeg"
+ src="org.apache.cocoon.serialization.SVGSerializer"
+ mime-type="image/jpeg"
+ logger="sitemap.serializer.svg2jpeg"
+ >
+ </map:serializer>
+]]></source>
+ <p>
+ A sitemap pipeline snippet using the svg2jpeg serializer:
+ </p>
+ <source><![CDATA[
+<map:match pattern="svg/*.jpg">
+ <map:generate src="docs/samples/svg/{1}.svg"/>
+ <map:serialize type="svg2jpeg"/>
+</map:match>
+]]></source>
+ <p>
+ In the declaration section of the svg2jpeg a number of parameters can be specified.
+ The following snippet set the background color explicitly:
+ </p>
+ <source><![CDATA[
+<map:serializers..
+ <map:serializer name="svg2jpeg"
+ src="org.apache.cocoon.serialization.SVGSerializer"
+ mime-type="image/jpeg"
+ logger="sitemap.serializer.svg2jpeg"
+ >
+ <parameter name="background_color" type="color" value="#ff00ff"/>
+ </map:serializer>
+]]></source>
+ </s2>
+ <s2 title="JPEGTranscoder Parameters">
+ <p>
+ General ImageTranscoder parameters are described
+ at the <link href="svg-serializer.html">SVG Serializer</link> user documentation.
+ </p>
+ <p>
+ The following section presents JPEGTranscoder specific parameters configurable for the JPEGTranscoder.
+ </p>
+ <table>
+ <tr><th>Parameter</th><th>Type</th><th>Comment</th></tr>
+ <tr><td>quality</td><td>float</td><td>Specifies the JPEG quality as value between 0.0 and 1.0,
+ 1.0 specifies highest quality. Usually a value of 0.9 is choosen.</td>
+ </tr>
+ </table>
+ </s2>
+ <s2 title="Further Reading">
+ <p>
+ Further details about JPEGTranscoder, ImageTranscoder is available
+ at <link href="http://xml.apache.org/batik">Batik</link>.
+ </p>
+ </s2>
+ </s1>
+ </body>
</document>
+
1.1.2.1 +93 -19 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/svgpng-serializer.xml
Index: svgpng-serializer.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/svgpng-serializer.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- svgpng-serializer.xml 3 Jan 2002 12:31:05 -0000 1.1
+++ svgpng-serializer.xml 28 Dec 2002 07:06:52 -0000 1.1.2.1
@@ -2,23 +2,97 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
- <header>
- <title>SVG/PNG Serializer</title>
- <version>0.9</version>
- <type>Technical document</type>
- <authors>
- <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
- </authors>
- <abstract>This document describes the svg/png serializer of Cocoon.</abstract>
- </header>
- <body>
- <s1 title="SVG/PNG Serializer">
- <p>????.</p>
- <ul>
- <li>Name : svg2png</li>
- <li>Class: org.apache.cocoon.serialization.SVGSerializer</li>
- <li>Cacheable: ????.</li>
- </ul>
- </s1>
- </body>
+ <header>
+ <title>SVG/PNG Serializer</title>
+ <version>0.9</version>
+ <type>Technical document</type>
+ <authors>
+ <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
+ <person name="Bernhard Huber" email="huber@apache.org"/>
+ </authors>
+ <abstract>This document describes the svg/png serializer of Cocoon.</abstract>
+ </header>
+ <body>
+ <s1 title="SVG/PNG Serializer">
+ <p>
+ The SVG/PNG serializes an xml svg document to a png image.
+ The serialization uses the Batik's PNGTranscoder internally.
+ </p>
+ <ul>
+ <li>Name : svg2png</li>
+ <li>Class: org.apache.cocoon.serialization.SVGSerializer</li>
+ <li>Cacheable: yes</li>
+ </ul>
+ <s2 title="Sitemap Configuration">
+ <p>
+ A minimal sitemap configuration snippet declaring the svg2png serializer:
+ </p>
+ <source><![CDATA[
+<map:serializers..
+ <map:serializer name="svg2png"
+ src="org.apache.cocoon.serialization.SVGSerializer"
+ mime-type="image/png"
+ logger="sitemap.serializer.svg2png"
+ >
+ </map:serializer>
+]]></source>
+ <p>
+ A sitemap pipeline snippet using the svg2png serializer:
+ </p>
+ <source><![CDATA[
+<map:match pattern="svg/*.png">
+ <map:generate src="docs/samples/svg/{1}.svg"/>
+ <map:serialize type="svg2png"/>
+</map:match>
+]]></source>
+ <p>
+ In the declaration section of the svg2png a number of parameters can be specified.
+ The following snippet set the background color explicitly:
+ </p>
+ <source><![CDATA[
+<map:serializers..
+ <map:serializer name="svg2png"
+ src="org.apache.cocoon.serialization.SVGSerializer"
+ mime-type="image/png"
+ logger="sitemap.serializer.svg2png"
+ >
+ <parameter name="background_color" type="color" value="#ff00ff"/>
+ </map:serializer>
+]]></source>
+ </s2>
+ <s2 title="PNGTranscoder Parameters">
+ <p>
+ General ImageTranscoder parameters are described
+ at the <link href="svg-serializer.html">SVG Serializer</link> user documentation.
+ </p>
+ <p>
+ The following section presents PNGTranscoder specific parameters configurable
+ for the PNGTranscoder.
+ </p>
+ <table>
+ <tr><th>Parameter</th><th>Type</th><th>Comment</th></tr>
+ <tr><td>force_transparent_white</td><td>boolean</td><td>It controls whether the encoder should
+ force the image's fully transparent pixels to be fully transparent
+ white instead of fully transparent black. This is usefull when the
+ encoded PNG is displayed in a browser which does not support PNG
+ transparency and lets the image display with a white background instead
+ of a black background. <br /> However, note that the modified image
+ will display differently over a white background in a viewer that
+ supports transparency.</td>
+ </tr>
+ <tr><td>gamma</td><td>float</td><td>Controls the gamma correction of the png image;
+ by default its value is approx <code>2.22</code>.
+ </td>
+ </tr>
+ </table>
+ </s2>
+ <s2 title="Further Reading">
+ <p>
+ Further details about PNGTranscoder, ImageTranscoder is available
+ at <link href="http://xml.apache.org/batik">Batik</link>.
+ </p>
+ </s2>
+ </s1>
+ </body>
</document>
+
1.1.2.1 +85 -19 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/svgxml-serializer.xml
Index: svgxml-serializer.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/svgxml-serializer.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- svgxml-serializer.xml 3 Jan 2002 12:31:05 -0000 1.1
+++ svgxml-serializer.xml 28 Dec 2002 07:06:52 -0000 1.1.2.1
@@ -2,23 +2,89 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
- <header>
- <title>SVG/XML Serializer</title>
- <version>0.9</version>
- <type>Technical document</type>
- <authors>
- <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
- </authors>
- <abstract>This document describes the svg/xml serializer of Cocoon.</abstract>
- </header>
- <body>
- <s1 title="SVG/XML Serializer">
- <p>????.</p>
- <ul>
- <li>Name : svgxml</li>
- <li>Class: org.apache.cocoon.serialization.XMLSerializer</li>
- <li>Cacheable: ????.</li>
- </ul>
- </s1>
- </body>
+ <header>
+ <title>SVG/XML Serializer</title>
+ <version>0.9</version>
+ <type>Technical document</type>
+ <authors>
+ <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
+ <person name="Bernhard Huber" email="huber@apache.org"/>
+ </authors>
+ <abstract>This document describes the svg/xml serializer of Cocoon.</abstract>
+ </header>
+ <body>
+ <s1 title="SVG/XML Serializer">
+ <p>
+ The SVG serializer serializes sax events to SVG XML.
+ The output of the SVG serializer is SVG XML; the SVG XML is not
+ rasterized to any image format by this serializer.
+ </p>
+ <ul>
+ <li>Name : svgxml</li>
+ <li>Class: org.apache.cocoon.serialization.XMLSerializer</li>
+ <li>Cacheable: yes</li>
+ </ul>
+ <s2 title="Sitemap Configuration">
+ <p>
+ The SVG XML serializer is declared in the sitemap serializers section.
+ </p>
+ <source><![CDATA[
+<map:serializers ...
+...
+ <map:serializer name="xml"
+ src="org.apache.cocoon.serialization.XMLSerializer"
+ mime-type="text/xml"
+ doctype-public="-//W3C//DTD SVG 1.0//EN"
+ doctype-system="http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd";
+ logger="sitemap.serializer.xml"
+ pool-grow="4" pool-max="32" pool-min="4">
+ <!-- serializer configurations -->
+...
+ </map:serializer>
+...
+ ]]></source>
+ <p>
+ The declaration of the SVG serializer shall use following
+ XML serializer configuration parameters
+ </p>
+ <table>
+ <tr><th>Name</th><th>Value</th><th>Comment</th></tr>
+ <tr><td>doctype-public</td><td>-//W3C//DTD SVG 1.0//EN</td>
+ <td>specifies the SVG XML public document type</td>
+ </tr>
+ <tr><td>doctype-system</td><td>http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd</td>
+ <td>specifies the SVG XML system document type</td>
+ </tr>
+ <tr><td>mime-type</td><td>text/xml</td>
+ <td>Following mime-type may be used, too:
+ <code>image/svg+xml</code>, <code>application/xml</code>.
+ The mime-type <code>text/xml</code> is the most general one.
+ </td>
+ </tr>
+ </table>
+ </s2>
+ <s2 title="Pipeline Usage">
+ <p>
+ Using the SVG XML serializer in a pipeline is just setting the
+ serializer type to svgxml. The following code snippet uses the svxml serializer:
+ </p>
+ <source><![CDATA[
+<map:match pattern="svg">
+...
+ <map:serialize type="svgxml"/>
+</map:match>
+...
+ ]]></source>
+ </s2>
+ <s2 title="Further Reading">
+ <p>
+ As SVG serializer uses the XML serializer internally, you might
+ want to read the complete list of valid XML configuration parameters.
+ It is available at <link href="xml-serializer.html">XML serializer</link>
+ user documentation.
+ </p>
+ </s2>
+ </s1>
+ </body>
</document>
+
1.1.2.1 +68 -19 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/text-serializer.xml
Index: text-serializer.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/text-serializer.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- text-serializer.xml 3 Jan 2002 12:31:05 -0000 1.1
+++ text-serializer.xml 28 Dec 2002 07:06:52 -0000 1.1.2.1
@@ -2,23 +2,72 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
- <header>
- <title>Text Serializer</title>
- <version>0.9</version>
- <type>Technical document</type>
- <authors>
- <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
- </authors>
- <abstract>This document describes the text serializer of Cocoon.</abstract>
- </header>
- <body>
- <s1 title="Text Serializer">
- <p>????.</p>
- <ul>
- <li>Name : text</li>
- <li>Class: org.apache.cocoon.serialization.TextSerializer</li>
- <li>Cacheable: yes.</li>
- </ul>
- </s1>
- </body>
+<header>
+ <title>Text Serializer</title>
+ <version>0.9</version>
+ <type>Technical document</type>
+ <authors>
+ <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
+ <person name="Bernhard Huber" email="huber@apache.org"/>
+ </authors>
+ <abstract>This document describes the text serializer of Cocoon.</abstract>
+</header>
+<body>
+ <s1 title="Text Serializer">
+ <p>
+ The Text serializer serializes xml into plain text..
+ </p>
+ <ul>
+ <li>Name : text</li>
+ <li>Class: org.apache.cocoon.serialization.TextSerializer</li>
+ <li>Cacheable: yes.</li>
+ </ul>
+ <s2 title="Sitemap Configuration">
+ <p>
+ The text Serializer is declared in the sitemap serializers section.
+ </p>
+ <source><![CDATA[
+<map:serializers...
+...
+ <map:serializer name="text"
+ src="org.apache.cocoon.serialization.TextSerializer"
+ mime-type="text/plain"
+ logger="sitemap.serializer.text"
+ />
+...
+ ]]></source>
+ <p>
+ The text Serializer sets the <code>method</code> property
+ to <code>text</code>.
+ </p>
+ </s2>
+ <s2 title="Pipeline Usage">
+ <p>
+ Using the text Serializer in a pipeline is just setting the
+ serializer type to text.
+ The following code snippet uses the text Serializer:
+ </p>
+ <source><![CDATA[
+...
+<map:match pattern="announcement.txt">
+<map:generate...
+...
+<map:serialize type="text"/>
+...
+ ]]></source>
+ <p>
+ The pipeline snippet above serializes the SAX events of the
+ announcment document resource to plain text.
+ </p>
+ </s2>
+ <s2 title="Further Reading">
+ <p>
+ As text Serializer uses the XML serializer internally, you might
+ want to read the complete list of valid XML configuration parameters.
+ It is available at <link href="xml-serializer.html">XML serializer</link>
+ user docuementation.
+ </p>
+ </s2>
+ </s1>
+</body>
</document>
1.1.2.1 +80 -19 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/wap-serializer.xml
Index: wap-serializer.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/wap-serializer.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- wap-serializer.xml 3 Jan 2002 12:31:05 -0000 1.1
+++ wap-serializer.xml 28 Dec 2002 07:06:52 -0000 1.1.2.1
@@ -2,23 +2,84 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
- <header>
- <title>WAP/WML Serializer</title>
- <version>0.9</version>
- <type>Technical document</type>
- <authors>
- <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
- </authors>
- <abstract>This document describes the wap/wml serializer of Cocoon.</abstract>
- </header>
- <body>
- <s1 title="WML/WAP Serializer">
- <p>????.</p>
- <ul>
- <li>Name : wap</li>
- <li>Class: org.apache.cocoon.serialization.XMLSerializer</li>
- <li>Cacheable: yes.</li>
- </ul>
- </s1>
- </body>
+ <header>
+ <title>WML Serializer</title>
+ <version>0.9</version>
+ <type>Technical document</type>
+ <authors>
+ <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
+ <person name="Bernhard Huber" email="huber@apache.org"/>
+ </authors>
+ <abstract>This document describes the WML serializer of Cocoon.</abstract>
+ </header>
+ <body>
+ <s1 title="WML Serializer">
+ <p>
+ The WML serializer serializes sax events to WML.
+ The output of the WML serializer is a WML document.
+ </p>
+ <ul>
+ <li>Name : wml</li>
+ <li>Class: org.apache.cocoon.serialization.XMLSerializer</li>
+ <li>Cacheable: yes</li>
+ </ul>
+ <s2 title="Sitemap Configuration">
+ <p>
+ The WML serializer is declared in the sitemap serializers section.
+ </p>
+ <source><![CDATA[
+<map:serializers ...
+...
+ <map:serializer name="wml"
+ src="org.apache.cocoon.serialization.XMLSerializer"
+ mime-type="text/vnd.wap.wml"
+ logger="sitemap.serializer.wml">
+ <doctype-public>-//WAPFORUM//DTD WML 1.1//EN</doctype-public>
+ <doctype-system>http://www.wapforum.org/DTD/wml_1.1.xml</doctype-system>
+ </map:serializer>
+...
+ ]]></source>
+ <p>
+ The declaration of the WML serializer shall use following
+ XML serializer configuration parameters
+ </p>
+ <table>
+ <tr><th>Name</th><th>Value</th><th>Comment</th></tr>
+ <tr><td>doctype-public</td><td>-//WAPFORUM//DTD WML 1.1//EN</td>
+ <td>specifies the WML public document type</td>
+ </tr>
+ <tr><td>doctype-system</td><td>http://www.wapforum.org/DTD/wml_1.1.xml</td>
+ <td>specifies the WML system document type</td>
+ </tr>
+ <tr><td>mime-type</td><td>text/vnd.wap.wml</td>
+ <td>specifies mime-type of the serialized WML document.
+ </td>
+ </tr>
+ </table>
+ </s2>
+ <s2 title="Pipeline Usage">
+ <p>
+ Using the WML Serializer in a pipeline is just setting the
+ serializer type to wml.
+ The following code snippet uses the WML Serializer:
+ </p>
+ <source><![CDATA[
+<map:match pattern="*.wml">
+...
+ <map:serialize type="wml"/>
+</map:match>
+...
+ ]]></source>
+ </s2>
+ <s2 title="Further Reading">
+ <p>
+ As WML serializer uses the XML serializer internally, you might
+ want to read the complete list of valid XML configuration parameters.
+ It is available at <link href="xml-serializer.html">XML serializer</link>
+ user docuementation.
+ </p>
+ </s2>
+ </s1>
+ </body>
</document>
+
1.1.2.1 +258 -20 xml-cocoon2/src/documentation/xdocs/userdocs/serializers/xml-serializer.xml
Index: xml-serializer.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/serializers/xml-serializer.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- xml-serializer.xml 3 Jan 2002 12:31:05 -0000 1.1
+++ xml-serializer.xml 28 Dec 2002 07:06:52 -0000 1.1.2.1
@@ -2,24 +2,262 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
- <header>
- <title>XML Serializer</title>
- <version>0.9</version>
- <type>Technical document</type>
- <authors>
- <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
- </authors>
- <abstract>This document describes the xml serializer of Cocoon.</abstract>
- </header>
- <body>
- <s1 title="XML Serializer">
- <p>The xml serializer is the simplest possible serializer. It
- generates an xml document from the sax events.</p>
- <ul>
- <li>Name : xml</li>
- <li>Class: org.apache.cocoon.serialization.XMLSerializer</li>
- <li>Cacheable: yes.</li>
- </ul>
- </s1>
- </body>
+ <header>
+ <title>XML Serializer</title>
+ <version>0.9</version>
+ <type>Technical document</type>
+ <authors>
+ <person name="Carsten Ziegeler" email="cziegeler@apache.org"/>
+ <person name="Bernhard Huber" email="huber@apache.org"/>
+ </authors>
+ <abstract>This document describes the xml serializer of Cocoon.</abstract>
+ </header>
+ <body>
+ <s1 title="XML Serializer">
+ <p>
+ The xml serializer is the simplest possible serializer.
+ It generates an xml document from the sax events.
+ This serializer is used for serializing to any XML document
+ format, ie. SVG, WML, VRML, et. al.
+ </p>
+ <ul>
+ <li>Name : xml</li>
+ <li>Class: org.apache.cocoon.serialization.XMLSerializer</li>
+ <li>Cacheable: yes.</li>
+ </ul>
+ <s2 title="Sitemap Configuration">
+ <p>
+ The XML Serializer is declared in the sitemap serializers section.
+ </p>
+ <source><![CDATA[
+<map:serializers ...
+...
+ <map:serializer name="xml"
+ src="org.apache.cocoon.serialization.XMLSerializer"
+ mime-type="text/xml"
+ logger="sitemap.serializer.xml"
+ pool-grow="4" pool-max="32" pool-min="4">
+ <!-- serializer configurations -->
+...
+ </map:serializer>
+...
+ ]]></source>
+ <p>
+ XML Serializer can be configured, specifying elements inside of
+ the <map:serializer> body.
+ </p>
+ <s3 title="Configuration Example">
+ <p>
+ The following XML Serializer snippet is setting
+ encoding configuration for the XML Serializer
+ </p>
+ <source><![CDATA[
+<map:serializer name="xml"
+ src="org.apache.cocoon.serialization.XMLSerializer"
+ mime-type="text/xml">
+ <encoding>ISO-8859-1</encoding>
+</map:serializer>
+ ]]></source>
+ <p>
+ This configuration will result in xml output of the form
+ </p>
+ <source><![CDATA[
+<?xml version="1.0" encoding="ISO-8859-1"?>
+...
+ ]]></source>
+ </s3>
+ <p>
+ The XML Serializer accepts following configuration parameters.
+ These configurations are not Xalan specific.
+ </p>
+<!--
+#
+# Specify defaults when method="xml". These defaults serve as a base for
+# other defaults, such as output_html and output_text.
+#
+
+# XSLT properties do not need namespace qualification.
+method=xml
+version=1.0
+encoding=UTF-8
+indent=no
+omit-xml-declaration=no
+standalone=no
+media-type=text/xml
+
+# Xalan-specific output properties. These can be overridden in the stylesheet
+# assigning a xalan namespace. For example:
+# <xsl:stylesheet version="1.0"
+# xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+# xmlns:xalan="http://xml.apache.org/xslt">
+# <xsl:output method="html" encoding="UTF-8"
+# xalan:content-handler="MyContentHandler"/>
+# ...
+# Note that the colon after the protocol needs to be escaped.
+{http\u003a//xml.apache.org/xslt}indent-amount=0
+{http\u003a//xml.apache.org/xslt}content-handler=org.apache.xalan.serialize.SerializerToXML
+
+-->
+ <table>
+ <tr><th>Name</th><th>Xalan Default Value</th><th>Comment</th></tr>
+ <tr><td>cdata-section-elements</td>
+ <td>none</td>
+ <td><code>cdata-section-elements</code> specifies a whitespace delimited
+ list of the names of elements whose text node children should be output
+ using CDATA sections.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation.</link>
+ </td>
+ </tr>
+ <tr><td>doctype-public</td>
+ <td>none</td>
+ <td><code>doctype-public</code> specifies the public identifier
+ to be used in the document type declaration.
+ </td>
+ </tr>
+ <tr><td>doctype-system</td>
+ <td>none</td>
+ <td>
+ <code>doctype-system</code> specifies the system identifier
+ to be used in the document type declaration.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>encoding</td>
+ <td>none</td>
+ <td><code>encoding</code> specifies the preferred character
+ encoding that the Transformer should use to encode sequences of
+ characters as sequences of bytes. The value of the attribute should be
+ treated case-insensitively. The value must only contain characters in
+ the range #x21 to #x7E (i.e., printable ASCII characters). The value
+ should either be a <code>charset</code> registered with the Internet
+ Assigned Numbers Authority <link href="#IANA">[IANA]</link>,
+ <link href="#RFC2278">[RFC2278]</link> or start with <code>X-</code>.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>indent</td>
+ <td>
+ yes
+ </td>
+ <td>
+ A Flag for toggling indent. This flag toggles only if some elements
+ should trigger a line break.
+ </td>
+ </tr>
+ <tr><td>media-type</td>
+ <td>
+ </td>
+ <td>
+ <code>media-type</code> specifies the media type (MIME
+ content type) of the data that results from outputting the result
+ tree. The <code>charset</code> parameter should not be specified
+ explicitly; instead, when the top-level media type is
+ <code>text</code>, a <code>charset</code> parameter should be added
+ according to the character encoding actually used by the output
+ method.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>method</td>
+ <td>
+ </td>
+ <td>
+ The method attribute identifies the overall method that
+ should be used for outputting the result tree. Other non-namespaced
+ values may be used, such as "xhtml", but, if accepted, the handling
+ of such values is implementation defined. If any of the method values
+ are not accepted and are not namespace qualified,
+ then {@link javax.xml.transform.Transformer#setOutputProperty}
+ or {@link javax.xml.transform.Transformer#setOutputProperties} will
+ throw a {@link java.lang.IllegalArgumentException}.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>omit-xml-declaration</td>
+ <td></td>
+ <td>
+ <code>omit-xml-declaration</code> specifies whether the XSLT
+ processor should output an XML declaration; the value must be
+ <code>yes</code> or <code>no</code>.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>standalone</td>
+ <td></td>
+ <td>
+ <code>standalone</code> specifies whether the Transformer
+ should output a standalone document declaration; the value must be
+ <code>yes</code> or <code>no</code>.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ <tr><td>version</td>
+ <td>
+ </td>
+ <td>
+ <code>version</code> specifies the version of the output
+ method.
+ When the output method is "xml", the version value specifies the
+ version of XML to be used for outputting the result tree. The default
+ value for the xml output method is 1.0. When the output method is
+ "html", the version value indicates the version of the HTML.
+ The default value for the xml output method is 4.0, which specifies
+ that the result should be output as HTML conforming to the HTML 4.0
+ Recommendation [HTML]. If the output method is "text", the version
+ property is ignored.
+ See <link href="http://www.w3.org/TR/xslt#output">section 16 of the XSL Transformations (XSLT) W3C Recommendation</link>
+ </td>
+ </tr>
+ </table>
+ <note>
+ Former property <code>buffer-size</code> is deprecated, and is ignored.
+ </note>
+ <p>
+ The XML Serializer sets the <code>method</code> property
+ to <code>xml</code>.
+ </p>
+ </s2>
+ <s2 title="Pipeline Usage">
+ <p>
+ Using the XML Serializer in a pipeline is just setting the
+ serializer type to xml.
+ The following code snippet uses the XML Serializer:
+ </p>
+ <source><![CDATA[
+...
+<map:match pattern="*.xml">
+<map:generate...
+...
+<map:serialize type="xml"/>
+...
+ ]]></source>
+ </s2>
+ <s2 title="Further Reading">
+ <p>
+ The XML serializer is usable for serializing any SAX events
+ to a plain xml output. The various xml documents
+ requires in most cases a proper configuration of following
+ parameters
+ </p>
+ <ul>
+ <li>doctype-public</li>
+ <li>doctype-system</li>
+ </ul>
+ <p>
+ Moreover the mime-type, and name attribute of the serializer definition
+ shall be set propertly.
+ </p>
+ <p>
+ Read the XML serializer configuration user documentation
+ for
+ <link href="svgxml-serializer.html">SVG/XML</link>,
+ and
+ <link href="wap-serializer.html">WML</link> in order
+ to understand using the XML serialiazer for
+ serializing to some specific XML content type.
+ </p>
+ </s2>
+ </s1>
+ </body>
</document>
+
----------------------------------------------------------------------
In case of troubles, e-mail: webmaster@xml.apache.org
To unsubscribe, e-mail: cocoon-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: cocoon-cvs-help@xml.apache.org