You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by hu...@apache.org on 2002/12/28 10:56:03 UTC

cvs commit: xml-cocoon2/src/documentation/xdocs/userdocs/serializers xhtml-serializer.xml book.xml

huber       2002/12/28 01:56:03

  Modified:    src/documentation/xdocs/userdocs/serializers book.xml
  Added:       src/documentation/xdocs/userdocs/serializers
                        xhtml-serializer.xml
  Log:
  added missing xhtml-serializer
  
  Revision  Changes    Path
  1.7       +0 -2      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.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- book.xml	28 Dec 2002 07:16:27 -0000	1.6
  +++ book.xml	28 Dec 2002 09:56:03 -0000	1.7
  @@ -17,9 +17,7 @@
       <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"/>
  
  
  
  1.1                  xml-cocoon2/src/documentation/xdocs/userdocs/serializers/xhtml-serializer.xml
  
  Index: xhtml-serializer.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
  
  <document>
    <header>
      <title>XHTML 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 XHTML serializer of Cocoon.</abstract>
    </header>
    <body>
    <s1 title="XHTML Serializer">
      <p>
        The XHTML serializer serializes sax events to XHTML.
        The output of the XHTML serializer is XHTML.
      </p>
      <ul>
        <li>Name : xhtml</li>
        <li>Class: org.apache.cocoon.serialization.XMLSerializer</li>
        <li>Cacheable: yes</li>
      </ul>
      <s2 title="Sitemap Configuration">
        <p>
          The XHTML serializer is declared in the sitemap serializers section.
        </p>
        <source><![CDATA[
  <map:serializers ...
  ...
     <map:serializer name="xhtml"
       src="org.apache.cocoon.serialization.XMLSerializer"
       mime-type="text/html" 
       logger="sitemap.serializer.xhtml"
       pool-grow="2" pool-max="64" pool-min="2" 
       >
       <doctype-public>-//W3C//DTD XHTML 1.0 Strict//EN</doctype-public>
       <doctype-system>http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</doctype-system>
       <encoding>UTF-8</encoding>
     </map:serializer>
  ...
        ]]></source>
        <p>
          The declaration of the XHTML 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 XHTML 1.0 Strict//EN</td>
            <td>specifies the XHTML public document type</td>
          </tr>
          <tr><td>doctype-system</td><td>http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</td>
            <td>specifies the XHTML system document type</td>
          </tr>
          <tr><td>mime-type</td><td>text/html</td>
            <td>specifies mime-type of the serialized XHTML document.
            </td>
          </tr>
        </table>
      </s2>
      <s2 title="Pipeline Usage">
        <p>
          Using the XHTML Serializer in a pipeline is just setting the 
          serializer type to xhtml. 
          The following code snippet uses the XHTML Serializer:
        </p>
        <source><![CDATA[
  <map:match pattern="*.html">
  ...
    <map:serialize type="xhtml"/>
  </map:match>
  ...
        ]]></source>
      </s2>
      <s2 title="Further Reading">
        <p>
          As XHTML 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>
  
  
  
  

----------------------------------------------------------------------
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