You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by sh...@apache.org on 2002/07/03 22:28:04 UTC
cvs commit: xml-cocoon2/src/documentation/xdocs/howto howto-paginator-transformer.xml
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