home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-cocoon-addon-1.4.9-installer.exe / overview.xml < prev    next >
Encoding:
Extensible Markup Language  |  2004-07-12  |  4.8 KB  |  112 lines
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!--
  3.   Copyright 1999-2004 The Apache Software Foundation
  4.  
  5.   Licensed under the Apache License, Version 2.0 (the "License");
  6.   you may not use this file except in compliance with the License.
  7.   You may obtain a copy of the License at
  8.  
  9.       http://www.apache.org/licenses/LICENSE-2.0
  10.  
  11.   Unless required by applicable law or agreed to in writing, software
  12.   distributed under the License is distributed on an "AS IS" BASIS,
  13.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.   See the License for the specific language governing permissions and
  15.   limitations under the License.
  16. -->
  17. <?xml-stylesheet type="text/css" href="css/document.css"?>
  18. <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "document-v10.dtd">
  19.  
  20. <document> 
  21.   <header> 
  22.      <title>Overview of Apache Cocoon</title>
  23.      <version>0.2</version> 
  24.      <type>Overview document</type> 
  25.      <authors><person name="Tom Klaasen" email="tom.klaasen@pandora.be"/> 
  26.      </authors> 
  27.   </header> 
  28.   <body> 
  29.      <s1 title="What is Apache Cocoon"> 
  30.         <p>Cocoon is an XML publishing framework. It allows you to define XML
  31.           documents and transformations to be applied on it, to eventually generate a
  32.           presentation format of your choice (HTML, PDF, SVG, ...).</p> 
  33.         <p>Cocoon also gives you the possibility to apply logic to your XML files
  34.           (so that the XML pipeline can be dynamic).</p> 
  35.  
  36.     <p>The <link href="userdocs/index.html">User documentation</link>
  37.      and especially <link href="userdocs/concepts/index.html">Concepts</link>
  38.      will help to understand Cocoon.
  39.     </p>
  40.    </s1> 
  41.  
  42.    <anchor id="samples"/>
  43.    <s1 title="Examples and demonstration applications"> 
  44.     <p>
  45.      There are a whole suite of sample applications to demonstrate the power
  46.      of Cocoon. These samples are available from the "welcome" page after
  47.      you have downloaded, built, and installed the distribution.
  48.      Each example portrays a different aspect of the vast capabilities of
  49.      Cocoon ...
  50.      <code>http://localhost:8080/cocoon/</code>
  51.     </p>
  52.  
  53.     <note>With the 2.1 version,
  54.      <code>http://localhost:8080/cocoon/</code> goes directly to the
  55.      documentation, while
  56.      <code>http://localhost:8080/cocoon/samples/</code> is the Samples.
  57.     </note>
  58.  
  59.     <p>
  60.      It will greatly assist your understanding of Cocoon to investigate
  61.      behind-the-scenes, to find out how each sample is processed. Do this
  62.      by looking at the actual XML documents provided in the distribution at
  63.      <code>src/webapp/samples/</code> and by consulting each sitemap to see
  64.      the processing steps that are defined.
  65.     </p>
  66.    </s1> 
  67.  
  68.    <s1 title="Overview of XML document processing"> 
  69.     <p>This section gives a general overview of how an XML document is
  70.      handled by Cocoon. See also the document
  71.      <link href="userdocs/concepts/index.html">Understanding Cocoon</link> for explanation of
  72.      the separation of content, style, logic and management functions.
  73.     </p> 
  74.  
  75.         <s2 title="Pipeline"> 
  76.           <p>Cocoon relies on the pipeline model: an XML document is pushed
  77.              through a pipeline, that exists in several transformation steps of your
  78.              document. Every pipeline begins with a generator, continues with zero or more
  79.              transformers, and ends with a serializer. This can be compared to the
  80.              "servlet-chaining" concept of a servlet engine. We'll explain the components of
  81.              the pipeline now in more detail.</p> 
  82.           <s3 title="Generator"> 
  83.              <p>The Generator is the starting point for the pipeline. It is
  84.                 responsible for delivering SAX events down the pipeline.</p> 
  85.              <p>The simplest Generator is the FileGenerator: it takes a local XML
  86.                 document, parses it, and sends the SAX events down the pipeline. </p> 
  87.              <p>The Generator is constructed to be independent of the concept
  88.                 "file". If you are able to generate SAX events from another source, you can use
  89.                 that without having to go via a temporary file.</p> 
  90.           </s3> 
  91.           <s3 title="Transformer"> 
  92.              <p>A Transformer can be compared to an XSL: it gets an XML document
  93.                 (or SAX events), and generates another XML document (or SAX events).</p> 
  94.              <p>The simplest Transformer is the XalanTransformer: it applies an
  95.                 XSL to the SAX events it receives.</p> 
  96.           </s3> 
  97.           <s3 title="Serializer"> 
  98.              <p>A Serializer is responsible for transforming SAX events to a
  99.                 presentation format. For actors looking at the back of the pipeline, it looks
  100.                 like a static file is delivered. So a browser can receive HTML, and will not be
  101.                 able to tell the difference with a static file on the filesystem of the server.
  102.                 </p> 
  103.              <p>We have Serializers for generating HTML, XML, PDF, VRML, WAP, and
  104.                 of course you can create your own.</p> 
  105.              <p>The simplest Serializer is the XMLSerializer: it receives the SAX
  106.                 events from up the pipeline, and returns a "human-readable" XML file.</p> 
  107.           </s3> 
  108.         </s2> 
  109.      </s1> 
  110.   </body>
  111. </document>
  112.