cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From shan...@apache.org
Subject cvs commit: xml-cocoon2/src/documentation/xdocs/howto howto-paginator-transformer.xml
Date Wed, 03 Jul 2002 20:28:04 GMT
shannon     2002/07/03 13:28:04

  Modified:    src/documentation/xdocs/howto
                        howto-paginator-transformer.xml
  Log:
  Revisions based on improvements
  to code and revised structure
  of samples in CVS.
  
  Revision  Changes    Path
  1.2       +45 -23    xml-cocoon2/src/documentation/xdocs/howto/howto-paginator-transformer.xml
  
  Index: howto-paginator-transformer.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/howto/howto-paginator-transformer.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- howto-paginator-transformer.xml	27 Jun 2002 15:52:50 -0000	1.1
  +++ howto-paginator-transformer.xml	3 Jul 2002 20:28:04 -0000	1.2
  @@ -37,15 +37,31 @@
     <p>
   During the build process, the necessary configuration details for the PaginatorTransformer
component are automatically copied to cocoon.xconf of cocoon.war. This means that you don't
need to manually configure cocoon.xconf. However, if you are adding the paginator samples
to Cocoon webapp that was <strong>not</strong> generated by the above build command,
add the following snippet to your cocoon.xconf file, located in the WEB-INF directory of your
deployed webapp.
     </p>
  +  <p>
  +Version 2.0.3:
  +  </p>
       <source><![CDATA[
     <component 
        class="org.apache.cocoon.transformation.pagination.Paginator"
        role="org.apache.cocoon.transformation.pagination.Paginator"
      />]]></source>
     <p>
  -Sample files related to this How-To are also copied during the build process to Cocoon
webapp at webapp/samples/mount/paignator.
  +Version 2.1:
     </p>
  +    <source><![CDATA[
  +  <paginator 
  +     class="org.apache.cocoon.transformation.pagination.Paginator" 
  +     role="org.apache.cocoon.transformation.pagination.Paginator"
  +     logger="core.paginator"/>
  +   />]]></source>
  +  <p>
  +Sample files, not directly related to this How-To, are also copied during the build process
to Cocoon webapp at webapp/samples/paginator. You can access them in your web browser using
the following URI: 
  + </p>
  +  <source>
  +http://localhost:8080/cocoon/samples/paginator/
  +  </source>
   	</s1>
  +	
   	<s1 title="Steps">
     <p>
   Let's start with a simple example.
  @@ -67,9 +83,6 @@
       <image />
   </images>
       ]]></source>
  -			<fixme author="DS">
  -Perhaps we need a DTD for the pagesheet to help readers visualize the pagesheet.
  -			</fixme>
     <p>
   First, you need to write a <strong>pagesheet.</strong> Just as a stylesheet
contains instructions for an xslt processor, a pagesheet contains instructions for the paginator
filter. Here is the pagesheet dtd.
     </p>
  @@ -87,13 +100,19 @@
   
   <!ELEMENT rules (link?, count?)*>
   
  -<!ELEMENT count EMPTY >
  -<!ATTLIST count 
  +<!ELEMENT link EMPTY >
  +<!ATTLIST link 
  +   type ( unit | range ) #REQUIRED 
  +   num CDATA #REQUIRED 
  + >
  + 
  + <!ELEMENT count EMPTY >
  + <!ATTLIST count 
      type ( element | char ) #REQUIRED 
      num CDATA #REQUIRED 
      name CDATA #IMPLIED 
      namespace CDATA #IMPLIED 
  - >    
  + >
       ]]></source>
   
     <p>
  @@ -124,7 +143,7 @@
       ]]></source>
       
   	  <p>
  -Accessing the URI for page one, page(1) ( e.g. http://localhost:8080/cocoon/mount/paginator/page(1)
) yields:
  +Accessing the URI for page one, page(1) yields:
   	  </p>
   	  
       <source><![CDATA[
  @@ -136,8 +155,8 @@
     <page:page 
        current="1" 
        total="3" 
  -     current-uri="/cocoon/mount/paginator/page(1)" 
  -     clean-uri="/cocoon/mount/paginator/page" /> 
  +     current-uri="/cocoon/samples/paginator/page(1)" 
  +     clean-uri="/cocoon/samples/paginator/page" /> 
   </images>
   
   
  @@ -193,7 +212,7 @@
       ]]></source>
       
     <p>
  -Processing the same page(1) request yields the following (pretty-printed for this document):
  +processing the same page(1) request yields the following (pretty-printed for this document):
     </p>
     
       <source><![CDATA[
  @@ -205,11 +224,11 @@
     <page:page 
       current="1" 
       total="3" 
  -    current-uri="/cocoon/mount/paginator/page(1)" 
  -    clean-uri="/cocoon/mount/paginator/page">
  +    current-uri="/cocoon/samples/paginator/page(1)" 
  +    clean-uri="/cocoon/samples/paginator/page">
     <page:link 
        type="next" 
  -     uri="/cocoon/mount/paginator/page(2)" 
  +     uri="/cocoon/samples/paginator/page(2)" 
        page="2" /> 
     </page:page>
   </images>
  @@ -239,7 +258,7 @@
   Note that the URI is re-encoded using the same parentheses pattern, page(2).
     </p>
     <p>
  -Now, without changing anything, requesting page(2) yields the following.
  +Now, without changing anything, requesting page(2) yields the following (pretty-printed
for this document):
     </p>
     
       <source><![CDATA[
  @@ -251,10 +270,10 @@
     <page:page 
         current="2" 
         total="3" 
  -      current-uri="/cocoon/mount/paginator/page(2)" 
  -      clean-uri="/cocoon/mount/paginator/page">
  -    <page:link type="prev" uri="/cocoon/mount/paginator/page(1)" page="1" /> 
  -    <page:link type="next" uri="/cocoon/mount/paginator/page(3)" page="3" /> 
  +      current-uri="/cocoon/samples/paginator/page(2)" 
  +      clean-uri="/cocoon/samples/paginator/page">
  +    <page:link type="prev" uri="/cocoon/samples/paginator/page(1)" page="1" /> 
  +    <page:link type="next" uri="/cocoon/samples/paginator/page(3)" page="3" /> 
     </page:page>
   </images>
       ]]></source>
  @@ -270,11 +289,11 @@
     <page:page 
        current="3" 
        total="3" 
  -     current-uri="/cocoon/mount/paginator/page(3)" 
  -     clean-uri="/cocoon/mount/paginator/page">
  +     current-uri="/cocoon/samples/paginator/page(3)" 
  +     clean-uri="/cocoon/samples/paginator/page">
     <page:link 
        type="prev" 
  -     uri="/cocoon/mount/paginator/page(2)" 
  +     uri="/cocoon/samples/paginator/page(2)" 
        page="2" /> 
     </page:page>
   </images>]]></source>
  @@ -530,7 +549,7 @@
     </s1>
     <s1 title="Comments">
   <p>
  -Care to comment on this How-To? Got ideas on how to improve the Paginator Transformer?
Help keep this How-To and the Paginator Transformer relevant by passing along any useful feedback
to the author, <link href="mailto:stefano@apache.org">Stefano Mazzocchi</link>.
  +Got an idea how to improve the Paginator Transformer? Post it to the <link href="mailto:cocoon-dev@xml.apache.org?subject=Paginator:">cocoon-dev</link>
mailing list. Care to comment on this How-To? Help keep this document relevant by passing
along any constructive feedback to the <link href="mailto:cocoon-docs@xml.apache.org?subject=Paginator:">cocoon-docs</link>
mailing list.
     </p>
     </s1>
     <s1 title="Revisions">
  @@ -539,6 +558,9 @@
     </p>
     <p>
   06-26-02: Edited and structured by Diana Shannon. Scratchpad samples also added.
  +  </p>
  +  <p>
  +06-27-02: Scratchpad samples revised by Stefano Mazzocchi.
     </p>
     </s1>
     </body>
  
  
  

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


Mime
View raw message