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:[EMAIL PROTECTED]";>Stefano Mazzocchi</link>.
+Got an idea how to improve the Paginator Transformer? Post it to the <link
href="mailto:[EMAIL PROTECTED]?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:[EMAIL PROTECTED]?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: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
