71 lines
No EOL
1.9 KiB
Text
71 lines
No EOL
1.9 KiB
Text
Google RSS Tag Library README
|
|
=============================
|
|
|
|
|
|
Overview
|
|
========
|
|
|
|
This README file describes the Google RSS Tag Library distribution.
|
|
|
|
The Google RSS Tag Library is an extension to, and thus requires, the
|
|
Google Tag Library, which can be found at:
|
|
|
|
<http://google-taglib.sourceforge.net/>
|
|
|
|
|
|
See the "LICENSE.txt" file for licensing details.
|
|
|
|
The Google RSS Tag Library uses the Google Web APIs, but is not associated
|
|
with or sponsored by Google, Inc.
|
|
|
|
|
|
Installation
|
|
============
|
|
|
|
The Google RSS Tag Library requires a JSP (1.1 or higher) container, such
|
|
as Tomcat.
|
|
|
|
To use the Google RSS Tag Library, simply copy the library's JAR file
|
|
(google-rss.jar) to your application's WEB-INF/lib directory. The Tag Library
|
|
Descriptor (google-rss.tld) should be placed in your application's WEB-INF
|
|
directory.
|
|
|
|
You should also modify your web application deployment descriptor (web.xml)
|
|
file to map the Google RSS Tag Library TLD URI to its location:
|
|
|
|
<taglib>
|
|
<taglib-uri>/google-rss-taglib</taglib-uri>
|
|
<taglib-location>/WEB-INF/google-rss.tld</taglib-location>
|
|
</taglib>
|
|
|
|
|
|
TagLib Directive
|
|
================
|
|
|
|
Using the Google RSS Tag Library is easy; you simply need to import it into
|
|
your JSP pages using the taglib directive. For instance, you would include
|
|
the following line at the top of your JSP page:
|
|
|
|
<%@taglib uri="/google-rss-taglib" prefix="rss"%>
|
|
|
|
|
|
SearchResults Tag
|
|
=================
|
|
|
|
The <rss:searchResults/> tag is used to display the search results returned
|
|
by a Google search (performed using the Google Tag Library) in RSS format.
|
|
|
|
For example:
|
|
|
|
<%@ page contentType="text/xml" %>
|
|
<%@ taglib uri="/google-taglib" prefix="google" %>
|
|
<%@ taglib uri="/google-rss-taglib" prefix="rss" %>
|
|
<google:search>my search query</google:search>
|
|
<rss:searchResults>
|
|
|
|
Please refer to the Google Tag Library documentation for detailed information
|
|
on performing searches.
|
|
|
|
|
|
===========================================================================
|
|
$Id$ |