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]:">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]:">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]
