<html>
<head>
<title>Pager Tag Reference</title>
<style type="text/css">
A.nodec { text-decoration: none; }
</style>
</head>
<body bgcolor="#ffffff">
<table bgcolor="#ffcc00" width="100%" border="0"
cellspacing="0" cellpadding="2">
<tr>
<td><table bgcolor="#3366cc" width="100%" border="0"
cellspacing="0" cellpadding="4">
<tr>
<td width="379"><a href="http://jsptags.com/"><img src="images/jsptags.gif"
alt="<jsptags.com>" width="379" height="65" border="0"></a></td>
<td width="100%" align="center"><a href="http://jsptags.com/tags/navigation/pager/" class="nodec"><font color="#ffffff" size="+2"><b>
Pager Tag Library v2.0</b></font></a></td>
</tr>
</table></td>
</tr>
</table>
<h2>Table of Contents</h2>
<p>
<ul>
<li><a href="#overview">Overview</a>
<li><a href="#license">License</a>
<li><a href="#requirements">Requirements</a>
<li><a href="#installation">Installation</a>
<li><a href="#examples">Examples</a>
<li><a href="#reference">Tag Reference</a>
<li><a href="#upgrading">Upgrading</a>
<li><a href="#troubleshooting">Troubleshooting</a>
<li><a href="#history">Release History</a>
</ul>
<p>The latest release of this tag library can be found at
<a href="http://jsptags.com/tags/navigation/pager/">http://jsptags.com/tags/navigation/pager/</a>.</p>
<p>
<hr>
<a name="overview"></a>
<h2>Overview</h2>
<p>The Pager Tag Library is the easy and flexible way to implement paging
of large data sets in JavaServer Pages (JSP). It can emulate all currently
known paging styles with minimal effort. It also includes re-usable index styles
that emulate the search result navigators of popular web sites such as <font
color="#0000cc">G</font><font color="#cccc00">oo</font><font
color="#0000cc">g</font><font color="#00cc00">l</font><font
color="#cc0000">e</font><small><sup>SM</sup></small>, AltaVista®
and Yahoo!. The Pager Tag Library does most of the work for you by
dynamically organizing your data set into pages and generating a browsable
index with virtually any look desired.</p>
<p>
<hr>
<a name="license"></a>
<h2>License</h2>
<p>
<pre>
/*
* Pager Tag Library
*
* Copyright (C) 2002 James Klicman <a href="mailto:james@jsptags.com"><james@jsptags.com></a>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
</pre>
<p>The full license can be found in the file <a href="LICENSE">LICENSE</a>
included with this distribution or on the web at <a href="http://www.gnu.org/copyleft/lesser.txt">http://www.gnu.org/copyleft/lesser.txt</a>.<p>
<hr>
<a name="requirements"></a>
<h2>Requirements</h2>
<p>
<ul>
<li>JavaServer Pages 1.1 compliant Web Server/Servlet Engine
<li>Java 1.1 or later runtime environment
</ul>
<p>
<hr>
<a name="installation"></a>
<h2>Installation</h2>
<p>
<p>The Pager Tag Library is distributed as a ready-to-run Web Application
Archive (WAR). You can deploy the distribution WAR file as-is to your
JavaServer Pages 1.1 compliant server. The WAR file may also be used
as the basis for a new web application. Follow the instructions bellow
to integrate the Pager Tag Library into an existing web application.</p>
<p>The files referenced in the instructions are located in the
distribution WAR file.</p>
<p>
<pre>
WEB-INF/lib/
pager-taglib.jar
WEB-INF/jsp/
pager-taglib.tld
alltheweb.jsp
altavista.jsp
google.jsp
jsptags.jsp
lycos.jsp
simple.jsp
texticon.jsp
yahoo.jsp
images/
jsptags.gif
</pre>
</p>
<ul>
<li><a href="#install_tomcat">Tomcat 3.x/4.x Instructions</a></li>
<li><a href="#install_jrun">JRun 3.0 Instructions</a></li>
<li><a href="#install_generic">Generic Instructions</a></li>
</ul>
<p>
<a name="install_tomcat"></a>
<h4>Tomcat 3.x/4.x Instructions</h4>
<ol>
<li><p>Choose the context in which to install. I'll use the "/examples"
context created in the default Tomcat configuration for the following
instructions.</p>
<li><p>Edit the tomcat/webapps/examples/WEB-INF/web.xml
file and add the following lines inside the body of the
<code><web-app>...</web-app></code> tags.</p>
<code>
<pre>
<taglib>
<taglib-uri>
http://jsptags.com/tags/navigation/pager
</taglib-uri>
<taglib-location>
/WEB-INF/jsp/pager-taglib.tld
</taglib-location>
</taglib>
</pre>
</code>
<li><p>Copy the file pager-taglib.tld to the tomcat/webapps/examples/WEB-INF/jsp directory.</p>
<li><p>Copy pager-taglib.jar to the tomcat/webapps/examples/WEB-INF/lib directory. You may need to create a tomcat/webapps/examples/WEB-INF/lib directory if it does not already exist.</p></li>
<p><i>Please Note:</i> The 3.1 Beta version of Tomcat does not support
tag libraries in jar files. The following steps will install for Tomcat
3.1 Beta.</p>
<ol>
<li><p>Copy pager-taglib.jar to the
tomcat/webapps/examples/WEB-INF/classes directory.</p></li>
<li><p>Change current working directory to the
tomcat/webapps/examples/WEB-INF/classes directory.</p></li>
<li><p>Extract the contents of the pager-taglib.jar file
with the command:<br> <code>jar xvf
pager-taglib.jar</code></p></li>
<li><p>There will be a META-INF directory created during the
extraction, this can be removed.</p></li>
<li><p>The pager-taglib.jar file can now be removed from the
tomcat/webapps/examples/WEB-INF/classes directory.</p></li>
</ol>
<li><p>Copy the files pager-demo.jsp and jsptags.gif to the
tomcat/webapps/examples directory.</p>
<li><p>Copy the file the re-usable index style files alltheweb.jsp,
altavista.jsp, google.jsp, jsptags.jsp, lycos.jsp, simple.jsp,
texticon.jsp and yahoo.jsp to the tomcat/webapps/examples/WEB-INF/jsp
directory.</p>
<li><p>Shutdown and restart tomcat.</p>
<li><p>Check out http://<code><yourserver></code>/examples/pager-demo.jsp</p>
</ol>
<p>
<a name="install_jrun"></a>
<h4>JRun 3.0 Instructions</h4>
<ol>
<li><p>Choose the server and web-app in which to install. The following
instructions will install in JRun's default server and default web-app
which is jrun/servers/default/default-app.</p>
<li><p>Edit the jrun/servers/default/default-app/WEB-INF/web.xml
file and add the following lines inside the body of the
<code><web-app>...</web-app></code> tags.</p>
<code>
<pre>
<taglib>
<taglib-uri>
http://jsptags.com/tags/navigation/pager
</taglib-uri>
<taglib-location>
/WEB-INF/jsp/pager-taglib.tld
</taglib-location>
</taglib>
</pre>
</code>
<li><p>Copy the file pager-taglib.tld to the
jrun/servers/default/default-app/WEB-INF/jsp directory.</p>
<li><p>Copy pager-taglib.jar to the jrun/servers/default/default-app/WEB-INF/lib directory.</p>
<li><p>Copy the files pager-demo.jsp and jsptags.gif to the
jrun/servers/default/default-app directory.</p>
<li><p>Copy the re-usable index style files alltheweb.jsp,
altavista.jsp, google.jsp, jsptags.jsp, lycos.jsp,
simple.jsp, texticon.jsp and yahoo.jsp to the
jrun/servers/default/default-app/WEB-INF/jsp directory.</p>
<li><p>Restart JRun Default Server.</p>
<li><p>Check out http://<code><yourserver></code>/pager-demo.jsp</p>
</ol>
<p>
<a name="install_generic"></a>
<h4>Generic Instructions</h4>
<ol>
<li><p>Choose the web-app in which to install. I'll use web-app/ to
represent a generic web-app directory.</p>