Git cleanup.

This commit is contained in:
Erik C. Thauvin 2017-06-07 14:45:06 -07:00
parent 3937236341
commit 324f5b1005
142 changed files with 0 additions and 204 deletions

96
htdocs/about.html Normal file
View file

@ -0,0 +1,96 @@
<html>
<head>
<link rel="stylesheet" href="includes/google.css">
<title>Google Tag Library - About</title>
<style type="text/css">
body,td,font,p,a{font-family:arial,sans-serif}
</style>
</head>
<body class="siteowners" bgcolor="#ffffff" text="#000000" link="#0000CC" vlink="#800080" alink="#ff0000" topmargin="2">
<table width="95%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td width="1%"><a href="index.html"><img src="images/google_sm.gif" border="0" width="143" height="37" alt="Return to the Google Tag Library homepage." vspace="5"></a>
</td>
<td valign="middle" bgcolor="#eeeeee"><h1 style="margin-top:10px">
<table width="100%">
<tr>
<td><b>&nbsp;Google Tag Library</b> </td>
</tr>
</table>
</h1></td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="95%">
<tr>
<td width="143" valign="top">
<small><br>
&nbsp;&nbsp;<a href="index.html">Overview</a> <br>
&nbsp;&nbsp;<a href="http://sourceforge.net/project/showfiles.php?group_id=90444">Download</a> <br>
&nbsp;&nbsp;<a href="docs.html">Documentation</a> <br>
&nbsp;&nbsp;<a href="howto.html">HowTo</a> <br>
&nbsp;&nbsp;<a href="javadoc/index.html">Javadoc</a> <br>
&nbsp;&nbsp;<a href="tlddoc/index.html">TLD</a><br>
&nbsp;&nbsp;<a href="uml.html">UML</a></br>
<img src="images/yellowarrow.gif" alt="arrow" width="4" height="8"><b>&nbsp;<font color="#cc9900">About</font></b>
</small>
<img width="145" height="0" alt="">
<p>
<table cellpadding="1" width="120">
<tr>
<td style="background-color: #efefef"><small>
<div class="sidesearch">
<form action="http://www.thauvin.net/gtlib-search/search.jsp" method="post">
<div align="center">
<font size="-2">
<i>Find on this site:</i><br>
<input type="text" name="q" size="10"><br><input type="submit" value="Search" name="submit">
<br>
</font>
</div>
</form>
</div>
</small>
</td>
</tr>
</table>
<p>
&nbsp;<a href="http://sourceforge.net/projects/google-taglib"><img src="http://sourceforge.net/sflogo.php?group_id=9044&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo"/></a>
</p>
</td>
<td style="background-color: #cccccc" width="1" valign="top"><img alt="" width="1" height="1"></td>
<td style="background-color: #ffffff" width="10" valign="top"><img alt="" width="1" height="1"></td>
<td valign="top">
<p>
<b>About</b>
</p>
<p>
<font size="-1">The following people are currently working on the Google Tag
Library development:</font>
</p>
<font size="-1">
<ul>
<li>
<a href="http://www.thauvin.net/erik/">Erik C. Thauvin</a>
</li>
<li>
<a href="http://www.postneo.com/">Matt Croydon</a>
</li>
<li>
<a href="http://www.dynamicobjects.com/d2r/">Diego Doval</a>
</li>
<li>
<a href="http://www.jroller.com/page/arjunram/">Arjun Ram</a>
</li>
</ul>
</font>
<p>
<font size="-1">The Google Tag Library is an <a href="license.html">open source
project</a>, and </font><font size="-1">is not associated with or sponsored by
Google, Inc.</font>
<p>
<font size="-1">If you comments, find errors, or just have questions, please
visit the <a href="http://sourceforge.net/projects/google-taglib/">project's support area</a>.</font></td>
</tr>
</table>
</body>
</html>

859
htdocs/docs.html Normal file
View file

@ -0,0 +1,859 @@
<html>
<head>
<link rel="stylesheet" href="includes/google.css">
<title>Google Tag Library - Documentation</title>
<style type="text/css">
body,td,font,.p,a{font-family:arial,sans-serif}
.indent {margin-left: 1em; margin-right: 1em;}
code {font-size:10pt}
</style>
</head>
<body class="siteowners" bgcolor="#ffffff" text="#000000" link="#0000CC" vlink="#800080" alink="#ff0000" topmargin="2">
<table width="95%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td width="1%"><a href="index.html"><img src="images/google_sm.gif" border="0" width="143" height="37" alt="Return to the Google Tag Library homepage." vspace="5"></a></td>
<td valign="middle" bgcolor="#eeeeee"><h1 style="margin-top:10px">
<table width="100%">
<tr>
<td>
<p>
<b>&nbsp;Google Tag Library </b>
</p>
</td>
</tr>
</table>
</h1></td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="95%">
<tr>
<td width="143" valign="top">
<small><br>
&nbsp;&nbsp;<a href="index.html">Overview</a> <br>
&nbsp;&nbsp;<a href="http://sourceforge.net/project/showfiles.php?group_id=90444">Download</a> <br>
<img src="images/yellowarrow.gif" alt="arrow" width="4" height="8"><b>&nbsp;<font color="#CC9900">Documentation</font></b><br>
&nbsp;&nbsp;<a href="howto.html">HowTo</a> <br>
&nbsp;&nbsp;<a href="javadoc/index.html">Javadoc</a> <br>
&nbsp;&nbsp;<a href="tlddoc/index.html">TLD</a><br>
&nbsp;&nbsp;<a href="uml.html">UML</a></br>
&nbsp;&nbsp;<a href="about.html">About</a> </small>
<img width="145" height="0" alt="">
<p>
<table cellpadding="1" width="120">
<tr>
<td style="background-color: #efefef"><small>
<div class="sidesearch">
<form action="http://www.thauvin.net/gtlib-search/search.jsp" method="post">
<div align="center">
<font size="-2">
<i>Find on this site:</i><br>
<input type="text" name="q" size="10"><br><input type="submit" value="Search" name="submit">
<br>
</font>
</div>
</form>
</div>
</small>
</td>
</tr>
</table>
<p>
&nbsp;<a href="http://sourceforge.net/projects/google-taglib"><img src="http://sourceforge.net/sflogo.php?group_id=9044&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo"/></a>
</p>
</td>
<td style="background-color: #cccccc" width="1" valign="top"><img alt="" width="1" height="1"></td>
<td style="background-color: #ffffff" width="10" valign="top"><img alt="" width="1" height="1"></td>
<a name="top"></a>
<td valign="top">
<p>
<b><font face="arial, sans-serif">Google Tag Library Documentation </font></b>
</p>
<table cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4"><font face="arial, sans-serif"><b>Contents</b></font></td>
</tr>
</table>
<p>
<font size="-1"><b>&nbsp; &nbsp; 1. <a href="#ov">Overview</a></b></font>
<blockquote>
<font size="-1">1.1 <a href="#1_1">Installation</a><br>
1.2 <a href="#1_2">Google API Library</a><br>
1.3 <a href="#1_3">TagLib Directive </a><br>
1.4 <a href="#1_4">HTTP Proxy</a></font>
</blockquote>
<p>
<font size="-1"><b>&nbsp; &nbsp; 2. <a href="#search">Search Tags </a></b></font>
<font size="-1">&nbsp;</font>
<blockquote>
<font size="-1">2.1 <a href="#2_1">Search Tag</a><br>
2.2 <a href="#2_2">SearchResult Tag </a><br>
2.3 <a href="#2_3">Element Tag</a><br>
2.4 <a href="#2_4">Next &amp; Previous Tags</a><br>
2.5 <a href="#2_5">StartIndex &amp; EndIndex Tags</a><br>
2.6 <a href="#2_6">EstimatedTotal Tag</a><br>
2.7 <a href="#2_7">SearchComments Tag</a><br>
2.8 <a href="#2_8">SearchQuery Tag</a><br>
2.9 <a href="#2_9">SearchTime Tag</a><br>
2.10 <a href="#2_10">SearchTips Tag</a><br>
</font>
</blockquote>
<p>
<font size="-1"><b>&nbsp; &nbsp; 3. <a href="#cached">CachedPage &amp; Spelling
Tags</a></b></font> <font size="-1">&nbsp;</font>
<blockquote>
<font size="-1">3.1 <a href="#3_1">CachedPage Tag </a><br>
3.2 <a href="#3_2">Spelling Tag </a></font>
</blockquote>
<a name="ov"></a>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td style="background-color: #fff9e4"><b>1. Overview</b><font size="-1">&nbsp; &nbsp;
&nbsp; &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">This document explains in detail the semantics of the JSP tags
provided by the Google Tag Library. In this document, you will learn:</font>
<ul>
<li>
<font size="-1">How to install the Google Tag Library.</font>
</li>
<li>
<font size="-1">How to use the various Search, CachedPage and Spelling tags. </font>
</li>
<li>
<font size="-1">How to customize searches and interpret the search results data.</font>
</li>
</ul>
<p>
<font size="-1">You may also find the following helpful:</font>
<ul>
<li>
<font size="-1">The Google Tag Library <a href="howto.html">HowTo</a>.</font>
</li>
<li>
<font size="-1">The Google Tag Library <a href="javadoc/">Javadoc</a> documention.</font>
</li>
</ul>
<p>
<font size="-1">If you have comments, find errors, or just have questions,
please visit the <a href="http://sourceforge.net/projects/google-taglib/">project's support area</a>.</font>
<p>
<blockquote>
<a name="1_1"></a>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>1.1 Installation </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The Google Tag Library requires a JSP (1.1 or higher) container,
such as <a href="http://jakarta.apache.org/tomcat/">Tomcat</a>.</font>
<p>
<font size="-1">To use the Google Tag Library, simply copy the library's JAR
file (<code>google.jar</code>) to your application's <code>WEB-INF/lib</code>
directory. The Tag Library Descriptor (<code>google.tld</code>) should be placed
in your application's <code>WEB-INF</code> directory.</font>
<p>
<font size="-1">You should also modify your web application deployment
descriptor (<code>web.xml</code>) file to map the Google Tag Library TLD URI to
its location:</font>
<blockquote>
<pre>&lt;taglib&gt;<br> &lt;taglib-uri&gt;/google-taglib&lt;/taglib-uri&gt;<br> &lt;taglib-location&gt;/WEB-INF/google.tld&lt;/taglib-location&gt;<br>&lt;/taglib&gt;</pre>
</blockquote>
<p>
<a name="1_2"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>1.2 Google API Library </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The Google Web APIs Java library is required in order to use
the Google Tag Library. The library is included in the <a href="http://www.google.com/apis/download.html">Google Web APIs developer's kit</a>.
The library's JAR file (<code>googleapi.jar</code>) should be placed into your
application's <code>WEB-INF/lib</code> directory.</font>
<p>
<font size="-1">You must also <a href="https://www.google.com/accounts/NewAccount">register with Google</a> (free) in order to obtain a
license key. The license key is required to access Google's Web Services.</font>
<p>
<font size="-1">The license key can be specified as a context parameter in your
web application deployment descriptor (<code>web.xml</code>) as follows:</font>
<blockquote>
<pre>&lt;context-param&gt;<br> &lt;param-name&gt;google_key&lt;/param-name&gt;<br> &lt;param-value&gt;000000000000000000000000&lt;/param-value&gt;<br>&lt;/context-param&gt;</pre>
</blockquote>
<p>
<font size="-1">The license key can also be specified using the <code>key</code>
search form parameter, <code>key</code> tag attribute or the <code>google_key</code>
application scope attribute.</font>
<p>
<a name="1_3"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><font face="arial, sans-serif"><b>1.3
TagLib Directive </b></font></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">Using the Google 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:</font>
<blockquote>
<pre>&lt;%@taglib uri=&quot;/google-taglib&quot; prefix=&quot;google&quot;%&gt;</pre>
</blockquote>
<p>
<a name="1_4"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>1.4 HTTP Proxy</b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">An HTTP Proxy server can be specified using context parameters in your
web application deployment descriptor (<code>web.xml</code>) as follows:</font>
<blockquote>
<pre>&lt;context-param&gt;<br> &lt;param-name&gt;google_proxy_host&lt;/param-name&gt;<br> &lt;param-value&gt;proxy.example.com&lt;/param-value&gt;<br>&lt;/context-param&gt;</pre>
<pre>&lt;context-param&gt;<br> &lt;param-name&gt;google_proxy_port&lt;/param-name&gt;<br> &lt;param-value&gt;3128&lt;/param-value&gt;<br>&lt;/context-param&gt;</pre>
</blockquote>
<p>
<font size="-1">Similarly, the HTTP Proxy user name and password (if any) may be specified using:</font>
<blockquote>
<pre>&lt;context-param&gt;<br> &lt;param-name&gt;google_proxy_username&lt;/param-name&gt;<br> &lt;param-value&gt;john&lt;/param-value&gt;<br>&lt;/context-param&gt;</pre>
<pre>&lt;context-param&gt;<br> &lt;param-name&gt;google_proxy_password&lt;/param-name&gt;<br> &lt;param-value&gt;opensesame&lt;/param-value&gt;<br>&lt;/context-param&gt;</pre>
</blockquote>
<p>
<font size="-1">Please note that the Google Web APIs automatically check the standard <code>http.proxyHost</code>
and <code>http.proxyPort</code> Java system properties.</font>
</blockquote>
<p>
<a name="search" id="search"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4"><font face="arial, sans-serif"><b>2. Search
Tags </b></font></td>
</tr>
</table>
<blockquote>
<a name="2_1"></a>
<p>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.1 Search Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:search/&gt;</code> tag is used to perform
searches on Google's index of over 2 billion web pages.</font>
<p>
<font size="-1"><strong>Tag Syntax</strong></font>
<p>
<font size="-1">The search query can be specified directly in the tag <em>body </em>,
e.g.:</font>
<blockquote>
<pre>&lt;google:search&gt;my search query&lt;/google:search&gt;</pre>
</blockquote>
<p>
<font size="-1">or via the <em>q</em> request parameter:</font>
</p>
<blockquote>
<pre>(search page) <br>&lt;form action="search.jsp" &gt;<br> &lt;input type= text" name="q"&gt;<br> ...<br>&lt;/form&gt;<br> <br>(result page)<br>&lt;google:search/&gt;</pre>
</blockquote>
<p>
<font size="-1">Similarly the <code>&lt;google:search/&gt;</code> tag options
can be specified as attributes, e.g.:</font>
<blockquote>
<pre>&lt;google:search start ="10" maxResults ="5" / &gt;</pre>
</blockquote>
<p>
<font size="-1">or via request parameters:</font>
</p>
<blockquote>
<pre>(search page)<br>&lt;form action="search.jsp" &gt; <br> &lt;input type="hidden" name="start" value="10"&gt; <br> &lt;input type="hidden" name="maxResults" value="5"&gt;<br> ...<br>&lt;/form&gt;<br> <br>(result page)<br>&lt;google:search/&gt;</pre>
</blockquote>
<p>
<strong><font size="-1">Tag Attributes / Request Parameters</font></strong>
<p>
<table border="1" cellpadding="3" cellspacing="0">
<tr>
<td style="background-color: #fff9e4" valign="top" width="20%">
<div align="center">
<font size="-1"><b>Name</b></font>
</div>
</td>
<td style="background-color: #fff9e4" valign="top" width="80%">
<div align="center">
<font size="-1"><b>Description</b></font>
</div>
</td>
<td style="background-color: #fff9e4" valign="top">
<div align="center">
<font size="-1"><b>Default<br>
Value</b></font>
</div>
</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>key</b></font>
</div>
</td>
<td><font size="-1">Provided by Google, this is required for you to access the
Google service. Google uses the key for authentication and logging.</font></td>
<td>&nbsp;</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>q</b></font>
</div>
</td>
<td><font size="-1">The search query string.<br>
<b>Note: </b>There is no q attribute. The query is specified directly within the
body of the tag.</font></td>
<td>&nbsp;</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>start</b></font>
</div>
</td>
<td><font size="-1">Zero-based index of the first desired result.</font></td>
<td>
<div align="center">
<font size="-1">0</font>
</div>
</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>maxResults</b></font>
</div>
</td>
<td><font size="-1">Number of results desired per query. The maximum value per
query is 10.<br>
<b>Note:</b> If you do a query that doesn't have many matches, the actual number
of results you get may be smaller than what you request.</font></td>
<td>
<div align="center">
<font size="-1">10</font>
</div>
</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>filter</b></font>
</div>
</td>
<td><font size="-1">Activates or deactivates automatic results filtering, which
hides very similar results and results that all come from the same web host.
Filtering tends to improve the end user experience on Google, but for your
application you may prefer to turn it off.</font></td>
<td>
<div align="center">
<font size="-1">true</font>
</div>
</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>restrict</b></font>
</div>
</td>
<td><font size="-1">Restricts the search to a subset of the Google web index,
such as a country like &quot;Ukraine&quot; or a topic like &quot;Linux.&quot;</font></td>
<td>&nbsp;</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>safeSearch</b></font>
</div>
</td>
<td><font size="-1">A Boolean value which enables filtering of adult content in
the search results.</font></td>
<td>
<div align="center">
<font size="-1">false</font>
</div>
</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>lr</b></font>
</div>
</td>
<td><font size="-1"><i>Language Restrict</i> - Restricts the search to documents
within one or more languages.</font></td>
<td>
<div align="center">
<font size="-1">latin1</font>
</div>
</td>
</tr>
<tr>
<td colspan="3"><font size="-1" color="gray">The parameters listed below are not
part of the Google Web APIs.</font></td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>cache</b></font>
</div>
</td>
<td><font size="-1">By default the search results are cached between search requests. To ensure that a new query has been specified set this parameter to <em>false</em>.</font></td>
<td>
<div align="center">
<font size="-1">true</font>
</div>
</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><a name="2_1_site"><b>site</b></a></font>
</div>
</td>
<td><font size="-1">Restricts the search to documents within the specified
site.</font></td>
<td>&nbsp;</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><a name="2_1_filetype"><b>type</b></a></font>
</div>
</td>
<td><font size="-1">Specifies the <a href="http://www.google.com/help/faq_filetypes.html">file type</a> to be searched. (e.g.: pdf)</font></td>
<td>&nbsp;</td>
</tr>
</table>
<p>
<font size="-1">For detailed information on the above Google search options,
please refer to the <a href="http://www.google.com/apis/reference.html">Google
Web APIs</a> documentation.</font>
<p>
<a name="2_2"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td width="80%" height="23" style="background-color: #fff9e4"><b>2.2
SearchResult Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:searchResult/&gt;</code> tag is used to
loop through the results returned by of a Google search. </font>
<p>
<font size="-1"><strong>Tag Syntax</strong></font> <font size="-1">
<p>
The search results can be displayed using an HTML ordered list: </font>
<blockquote>
<pre>&lt;ol&gt;<br>&lt;google:searchResult&gt;<br> &lt;li&gt;&lt;google:element name="title-url"/&gt;&lt;/li&gt;<br>&lt;/google:searchResult&gt;<br>&lt;/ol&gt;</pre>
</blockquote>
<p>
<font size="-1">The <code><a href="#2_3">&lt;google:element/&gt;</a></code> tag
is used to display the details of the current result set item.</font>
<p>
<a name="2_3"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.3 Element Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:element/&gt;</code> tag is used to display
the properties of the current result set item. It can only be used inside the <a href="#2_2">
<code>&lt;google:searchResult/&gt;</code></a> tag.</font>
<p>
<font size="-1"><strong>Tag Syntax</strong></font> <font size="-1">
<p>
The URL property of the search results can be displayed as follows: </font>
<blockquote>
<pre>&lt;google:searchResult&gt;<br> &lt;google:element name="url"/&gt;&lt;br&gt;<br>&lt;/google:searchResult&gt;</pre>
</blockquote>
<p>
<font size="-1">The <em>name </em> attribute is used to specify the desired
property of the current result set item.</font>
</p>
<p>
<strong><font size="-1">Name Attributes Values</font></strong>
</p>
<table border="1" cellpadding="3" cellspacing="0">
<tr>
<td style="background-color: #fff9e4" valign="top" width="20%">
<div align="center">
<font size="-1"><b>Name</b></font>
</div>
</td>
<td style="background-color: #fff9e4" valign="top" width="80%">
<div align="center">
<font size="-1"><b>Description</b></font>
</div>
</td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>summary</b></font>
</div>
</td>
<td><font size="-1">The search result has a listing in the ODP directory, the
ODP summary appears here as a text string.</font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>URL</b></font>
</div>
</td>
<td><font size="-1">The URL of the search result, returned as text, with an
absolute URL path.</font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>snippet</b></font>
</div>
</td>
<td><font size="-1">A snippet which shows the query in context on the URL where
it appears.</font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>title</b></font>
</div>
</td>
<td><font size="-1">The title of the search result, returned as HTML.</font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>cachedSize</b></font>
</div>
</td>
<td><font size="-1">Indicates that a cached version of the URL is available;
size is indicated in kilobytes.</font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>relatedInformationPresent</b></font>
</div>
</td>
<td><font size="-1">Boolean indicating that the "related:" query term is
supported for this URL. </font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>hostName</b></font>
</div>
</td>
<td><font size="-1">When filtering occurs, a maximum of two results from any
given host is returned. When this occurs, the second result element that comes
from that host contains the host name in this parameter.</font></td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>directoryTitle</b></font>
</div>
</td>
<td><font size="-1">The title that appears in the ODP directory, if any.</font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>directoryCategoryName</b></font>
</div>
</td>
<td><font size="-1">The ODP directory name for the current ODP category.</font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>directoryCategoryEncoding</b></font>
</div>
</td>
<td><font size="-1">Specifies the encoding scheme of the directory information.</font></td>
</tr>
<tr>
<td colspan="2"><font size="-1" color="gray">The properties listed below are not
part of the Google Web APIs.</font></td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>relatedQuery</b></font>
</div>
</td>
<td><font size="-1">The related query, suitable for use with <em>q</em>
request parameter of the <code><a href="#2_1">&lt;google:search/&gt;</a></code>
tag.<br>For example: <code>related:www.example.com/search?q=vacation%20hawaii</code></font></td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>cachedQuery</b></font>
</div>
</td>
<td><font size="-1">The cached query, suitable for use with the <em>q</em>
request parameter of the <code><a href="#3_1">&lt;google:cachedPage/&gt;</a></code>
tag.<br>For example: <code>www.example.com/search?q=vacation%20hawaii</code></font> </td>
</tr>
<tr>
<td>
<div align="center">
<font size="-1"><b>staticQuery</b></font>
</div>
</td>
<td><font size="-1">The static query, suitable for display.<br>For example: <code>www.example.com/search?q=vacation hawaii</code></font></td>
</tr>
</table>
<p>
<font size="-1">For detailed information on the above Google search elements
options, please refer to the <a href="http://www.google.com/apis/reference.html">Google
Web APIs</a> documentation.</font>
<p>
<strong><font size="-1"><a name="autolink"></a>Automatic Link Creation</font></strong>
<p>
<font size="-1">The name of two properties can be combined to automatically
generate properly formatted HTML links. For example, to automatically create a
link whose location is the URL of the current element and whose text is the
current element's title use the following syntax:</font>
<blockquote>
<pre>&lt;google:element name="title-url"/&gt;</pre>
</blockquote>
<p>
<font size="-1">which will automatically generate a property formatted HTML link:</font>
<blockquote>
<pre>&lt;a href="[url]"&gt;[title]&lt;/a&gt;</pre>
</blockquote>
<p>
<font size="-1">Additionally, the link's target and style options can be specify
using the <em>target</em>, <em>style</em> and <em>css</em> attributes of the <code>&lt;google:element/&gt;</code>
tag: </font>
<blockquote>
<pre>&lt;google:element name="title-url" target="_blank" style="text-decoration:none" css=&quot;c&quot;/&gt;</pre>
</blockquote>
<p>
<font size="-1">which will generate:</font>
<blockquote>
<pre>&lt;a href="[url]" target="_blank" class=&quot;c&quot; style="text-decoration:none"&gt;[title]&lt;/a&gt;</pre>
</blockquote>
<p>
<a name="2_4"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.4 Next &amp; Previous
Tags </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:next/&gt;</code> tag is used to
used to display a link to more search results.<br>
The <code>&lt;google:previous/&gt;</code> tag is used to used to display a link
to previous search results.</font>
<p>
<font size="-1"><strong>Tag Syntax</strong></font>
<p>
<font size="-1">The next set of results can be displayed using:</font>
<blockquote>
<pre>Click &lt;google:next&gt;here&lt;/google:next&gt; to view more results.
</pre>
</blockquote>
<p>
<font size="-1">Additionally, the link's target and style options can be specify
using the <a href="#autolink">target, style and css</a> attributes</font>.
<p>
<a name="2_5"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.5 StartIndex &amp;
EndIndex Tags </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:startIndex/&gt;</code> tag is
used to display the index (1-based) of the first search result in the current
result set.<br>
The <code>&lt;google:endIndex/&gt;</code> tag is used to used to
display the index (1-based) of the last search result in the current result set.</font>
<p>
<a name="2_6"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.6 EstimatedTotal Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:estimatedTotal/&gt;</code> tag is used to
display the estimated total number of results that exist for the current query.</font>
<p>
<a name="2_7"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.7 SearchComments Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:searchComments/&gt;</code>
tag is used to display the comments (if any) included with the current result set.</font>
<p>
<a name="2_8" id="2_8"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.8 SearchQuery Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:searchQuery/&gt;</code> tag is used to display
the text of the current query.
</font>
<p>
<font size="-1">The specified search keywords (or phrase) are returned by default.
To display the full query (including preset <a href="#2_1_site">site</a> and
<a href="#2_1_filetype">file type</a> options), set the <code>type</code> attribute
to <code>full</a>.</font>
<p>
<a name="2_9" id="2_9"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.9 SearchTime Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:searchTime/&gt;</code>
tag is used to display the total server time used to return the search results,
measured in seconds.</font>
<p>
<a name="2_10" id="2_10"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>2.10 SearchTips Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:searchTips/&gt;</code>
tag is used to display the tips (if any) included with the current result
set.</font>
</blockquote>
<p>
<a name="cached" id="cached"></a>
<table cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4"><b>3. CachedPage &amp; Spelling Tags </b></td>
</tr>
</table>
<blockquote>
<a name="3_1"></a>
<p>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>3.1 CachedPage Tag </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The <code>&lt;google:cachedPage/&gt;</code> tag is used to
display Google's cached web pages.</font>
<p>
<font size="-1"><b>Tag Syntax</b></font>
<p>
<font size="-1">The URL can be specified directly in the tag <em>body</em>, e.g.:</font>
<blockquote>
<pre>&lt;google:cachedPage&gt;http://www.google.com&lt;/google:cachedPage&gt;</pre>
</blockquote>
<p>
<font size="-1">or via the <em>q </em> request parameter:</font>
<blockquote>
<pre>(search page)<br>&lt;form action="cache.jsp"&gt; <br> &lt;input type="text" name="q"&gt; <br> ...<br>&lt;/form&gt;<br> <br>(result page)<br>&lt;google:cachedPage/&gt;</pre>
</blockquote>
<p>
<font size="-1">Upon submission the cached page will be displayed.</font>
<p>
<a name="3_2"></a>
<p>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>3.2 Spelling </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">The &lt;google:spelling/&gt; tag is used to display Google's
spelling suggestions.</font>
<p>
<font size="-1"><b>Tag Syntax</b></font>
<p>
<font size="-1">The text can be specified directly in the tag <em>body</em>, e.g.:</font>
<blockquote>
<pre>&lt;google:spelling&gt;long knifes&lt;/google:spelling&gt;</pre>
</blockquote>
<p>
<font size="-1">or via the <em>q </em> request parameter:</font>
<blockquote>
<pre>(search page)<br>&lt;form action="spelling.jsp"&gt; <br> &lt;input type="text" name="q"&gt; <br> ...<br>&lt;/form&gt;<br> <br>(result page)<br>&lt;google:spelling/&gt;</pre>
</blockquote>
<p>
<font size="-1">Upon submission the spelling suggestion (&quot;long knives&quot;)
will be displayed.</font>
</blockquote>
</td>
</tr>
</table>
</body>
</html>

444
htdocs/howto.html Normal file
View file

@ -0,0 +1,444 @@
<html>
<head>
<link rel="stylesheet" href="includes/google.css">
<title>Google Tag Library - HowTo</title>
<style type="text/css">
body,td,font,.p,a{font-family:arial,sans-serif}
.indent { margin-left: 1em; margin-right: 1em;}
</style>
</head>
<body class="siteowners" bgcolor="#ffffff" text="#000000" link="#0000CC" vlink="#800080" alink="#ff0000" topmargin="2">
<table width="95%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td width="1%"><a href="index.html"><img src="images/google_sm.gif" border="0" width="143" height="37" alt="Return to the Google Tag Library homepage." vspace="5"></a></td>
<td valign="middle" bgcolor="#eeeeee"><h1 style="margin-top:10px">
<table width="100%">
<tr>
<td>
<p>
<b>&nbsp;Google Tag Library </b>
</p>
</td>
</tr>
</table>
</h1></td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="95%">
<tr>
<td width="143" valign="top">
<small><br>
&nbsp;&nbsp;<a href="index.html">Overview</a> <br>
&nbsp;&nbsp;<a href="http://sourceforge.net/project/showfiles.php?group_id=90444">Download</a> <br>
&nbsp;&nbsp;<a href="docs.html">Documentation</a> <br>
<img src="images/yellowarrow.gif" alt="arrow" width="4" height="8"><b>&nbsp;<font color="#CC9900">HowTo</font></b><br>
&nbsp;&nbsp;<a href="javadoc/index.html">Javadoc</a><br>
&nbsp;&nbsp;<a href="tlddoc/index.html">TLD</a><br>
&nbsp;&nbsp;<a href="uml.html">UML</a></br>
&nbsp;&nbsp;<a href="about.html">About</a> </small>
<img alt="" width="143" height="0">
<p>
<table cellpadding="1" width="120">
<tr>
<td style="background-color: #efefef"><small>
<div class="sidesearch">
<form action="http://www.thauvin.net/gtlib-search/search.jsp" method="post">
<div align="center">
<font size="-2">
<i>Find on this site:</i><br>
<input type="text" name="q" size="10"><br><input type="submit" value="Search" name="submit">
<br>
</font>
</div>
</form>
</div>
</small>
</td>
</tr>
</table>
<p>
&nbsp;<a href="http://sourceforge.net/projects/google-taglib"><img src="http://sourceforge.net/sflogo.php?group_id=9044&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo"/></a>
</p>
</td>
<td style="background-color: #cccccc" width="1" valign="top"><img alt="" width="1" height="1"></td>
<td style="background-color: #ffffff" width="10" valign="top"><img alt="" width="1" height="1"></td>
<a name="top"></a>
<td valign="top">
<p>
<b><font face="arial, sans-serif">&nbsp;Google Tag Library HowTo</font></b>
</p>
<table cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4"><font face="arial, sans-serif"><b>Contents</b></font></td>
</tr>
</table>
<p>
<font size="-1"><b>&nbsp; &nbsp; 1. <a href="#search">Search &amp; Display the
Results of a Google Search</a></b> </font>
<blockquote>
<font size="-1">1.1 <a href="#1_1">Create a Search Form </a> <br>
1.2 <a href="#1_2">Create a Result Page</a> <br>
1.3 <a href="#1_3">Display the Results </a> </font>
</blockquote>
<font size="-1">
<p>
<b>&nbsp; &nbsp; 2. <a href="#cached">Display a Page Cached by Google</a></b> </font>
<blockquote>
<font size="-1">2.1 <a href="#2_1">Create a Search From </a> <br>
2.2 <a href="#2_2">Create a Result Page</a> <br>
2.3 <a href="#2_3">Display the Cached Page</a></font>
</blockquote>
<font size="-1">
<p>
</p>
<b>&nbsp; &nbsp; 3. <a href="#spelling">Display a Google Spelling Suggestion </a></b></font>
<blockquote>
<font size="-1">3.1 <a href="#3_1">Create a Search Form</a> <br>
3.2 <a href="#3_2">Create a Result Page </a> <br>
3.3 <a href="#3_3">Display the Spelling Suggestion </a> <br>
</font>
</blockquote>
<a name="search" id="search"></a>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td style="background-color: #fff9e4" width="80%"><b>1. Search &amp; Display the
Results of a Google Search </b></td>
</tr>
</table>
<p>
<blockquote>
<a name="1_1"></a>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr colspan="2">
<td style="background-color: #fff9e4" width="80%"><b>1.1 Create a Search From </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">Create the following HTML form on your search page:</font>
<p>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="#0000FF">&lt;form </font><font color="#FF0000">action=</font>&quot;results.jsp&quot;
<font color="#0000FF">&gt;</font> <br>
&nbsp;&nbsp;<font color="#0000FF">&lt;input </font><font color="#FF0000">type=</font>&quot;text&quot;
<font color="#FF0000">name=</font>&quot;q&quot;<font color="#0000FF">&gt;</font> <br>
&nbsp;&nbsp;<font color="#0000FF">&lt;input </font><font color="#FF0000">type=</font>&quot;submit&quot;
<font color="#0000FF">&gt;</font></code><code><br>
<font color="#0000FF">&lt;/form&gt;</font></code></td>
<td><img src="images/arrow.jpg" alt="arrow" width="35" height="28"></td>
<td><img src="images/search.jpg" alt="search" width="268" height="24"></td>
</tr>
</table>
<p>
<font size="-1">The <em>q</em> parameter is required and used to store the
search query string. <br>
The form <em>action</em> points to the <em>results.jsp</em> page, which is
created in step <a href="#1_2">1.2</a>.</font>
<p>
<font size="-1" color="gray">The Google Web APIs authentication key can be
specified as an hidden form input parameter: <br>
</font>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="gray">&lt;input type=&quot;hidden&quot; name=&quot;key&quot;
value=&quot;000000000000000000000000&quot;&gt;</font></code></td>
</tr>
</table>
<p>
<p>
<a name="1_2"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr colspan="2">
<td style="background-color: #fff9e4" width="80%"><b>1.2 Create a Results Page </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">Create a page called <em>results.jsp</em> containing:</font>
<p>
<table cellspacing="5">
<tr>
<td width="5">&nbsp;</td>
<td nowarp><code><font color="#009900">&lt;%@taglib uri=</font>&quot;/google-taglib&quot;
<font color="#009900">prefix=</font>&quot;google&quot;<font color="#009900">%&gt;</font>
<br>
<font color="#CC6600">&lt;google:search/&gt;</font></code></td>
</tr>
</table>
<p>
<font size="-1">The <em>taglib</em> directive is used to specify the Google Tag
library reference and prefix. <br>
The <em>&lt;<a href="docs.html#2_1">google:search</a>/&gt;</em> tag is used to perform the query.</font>
<p>
<font size="-1" color="gray">The Google Web APIs authentication key can be
specified as a tag attribute: <br>
</font>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="gray">&lt;google:search key=&quot;000000000000000000000000&quot;/&gt;</font></code></td>
</tr>
</table>
<p>
<a name="1_3"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr colspan="2">
<td style="background-color: #fff9e4" width="80%"><font face="arial, sans-serif">
<b>1.3 Display the Search Results </b></font></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="#0000FF">&lt;ol&gt;</font> <br>
<font color="#CC6600">&lt;google:searchResult&gt;</font> <br>
&nbsp;&nbsp;<font color="#0000FF">&lt;li&gt;</font><font color="#CC6600">&lt;google:element
name</font>=&quot;title-url&quot;<font color="#CC6600">/&gt;</font><font color="#0000FF">&lt;/li&gt;</font>
<br>
<font color="#CC6600">&lt;/google:searchResult&gt;</font> <br>
<font color="#0000FF">&lt;/ol&gt;</font></code></td>
<td><img src="images/arrow.jpg" alt="arrow" width="35" height="28"></td>
<td><img src="images/searchresults.jpg" alt="searchresults" width="196" height="72"></td>
</tr>
</table>
<p>
<font size="-1">The <em>&lt;<a href="docs.html#2_2">google:searchResult</a>/&gt;</em> tag is used to loop
through the results. <br>
The <em>&lt;<a href="docs.html#2_3">google:element</a>/&gt;</em> tag is used to display the attributes of
the current result set element.</font>
</blockquote>
<a name="cached" id="cached"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4"><font face="arial, sans-serif"><b>2.
Display a Page Cached by Google </b></font></td>
</tr>
</table>
<blockquote>
<a name="2_1"></a>
<p>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr colspan="2">
<td style="background-color: #fff9e4" width="80%"><b>2.1 Create a Search From</b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1">Create the following HTML form on your search page:</font>
<p>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="#0000FF">&lt;form </font><font color="#FF0000">action=</font>&quot;results.jsp&quot;
<font color="#0000FF">&gt;</font> <br>
&nbsp;&nbsp;<font color="#0000FF">&lt;input </font><font color="#FF0000">type=</font>&quot;text&quot;
<font color="#FF0000">name=</font>&quot;q&quot;<font color="#0000FF">&gt;</font> <br>
&nbsp;&nbsp;<font color="#0000FF">&lt;input </font><font color="#FF0000">type=</font>&quot;submit&quot;
<font color="#0000FF">&gt;</font></code><code><br>
<font color="#0000FF">&lt;/form&gt;</font></code></td>
<td><img src="images/arrow.jpg" alt="arrow" width="35" height="28"></td>
<td><img src="images/cached.jpg" alt="search" width="268" height="26"></td>
</tr>
</table>
<p>
<font size="-1">The <em>q</em> parameter is required and used to store the
search query string. <br>
The form <em>action</em> points to the <em>results.jsp</em> page, which is
created in step <a href="#2_2">2.2</a>.</font>
<p>
<font size="-1" color="gray">The Google Web APIs authentication key can be
specified as an hidden form input parameter: <br>
</font>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="gray">&lt;input type=&quot;hidden&quot; name=&quot;key&quot;
value=&quot;000000000000000000000000&quot;&gt;</font></code></td>
</tr>
</table>
<p>
<font size="-1"></font>
<p>
<a name="2_2"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr colspan="2">
<td width="80%" height="23" style="background-color: #fff9e4"><b>2.2 Create a
Result Page </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<p>
<font size="-1">Create a page called <em>results.jsp</em> containing:</font>
<p>
<table cellspacing="5">
<tr>
<td width="5">&nbsp;</td>
<td nowarp><code><font color="#009900">&lt;%@taglib uri=</font>&quot;/google-taglib&quot;
<font color="#009900">prefix=</font>&quot;google&quot;<font color="#009900">%&gt;</font></code></td>
</tr>
</table>
<p>
<font size="-1">The <em>taglib</em> directive is used to specify the Google Tag
library reference and prefix.</font>
<p>
<a name="2_3"></a>
<table bgcolor="#fff9e4" cellpadding="2" width="100%" border="0">
<tr colspan="2">
<td style="background-color: #fff9e4" width="80%"><b>2.3 Display the Cached Page </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="#CC6600">&lt;google:cachedPage/&gt;</font></code></td>
<td><img src="images/arrow.jpg" alt="arrow" width="35" height="28"></td>
<td><img src="images/cachedresults.jpg" alt="searchresults" width="160" height="147"></td>
</tr>
</table>
<p>
<font size="-1">The <em>&lt;<a href="docs.html#3_1">google:cachedPage</a>&gt;</em> tag is used to display
the content of the cached page.</font>
<p>
<font size="-1" color="gray">The Google Web APIs authentication key can be
specified as a tag attribute: <br>
</font>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="gray">&lt;google:cachedPage key=&quot;000000000000000000000000&quot;/&gt;</font></code></td>
</tr>
</table>
<p>
</blockquote>
<p>
<a name="spelling" id="spelling"></a>
<table cellpadding="2" width="100%" border="0">
<tr>
<td style="background-color: #fff9e4"><b>3. Display a Google Spelling Suggestion </b></td>
</tr>
</table>
<blockquote>
<a name="3_1"></a>
<p>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr colspan="2">
<td style="background-color: #fff9e4" width="80%"><b>3.1 Create a Search Form</b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1"></font>
<p>
<font size="-1">Create the following HTML form on your search page:</font>
<p>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="#0000FF">&lt;form </font><font color="#FF0000">action=</font>&quot;results.jsp&quot;
<font color="#0000FF">&gt;</font> <br>
&nbsp;&nbsp;<font color="#0000FF">&lt;input </font><font color="#FF0000">type=</font>&quot;text&quot;
<font color="#FF0000">name=</font>&quot;q&quot;<font color="#0000FF">&gt;</font> <br>
&nbsp;&nbsp;<font color="#0000FF">&lt;input </font><font color="#FF0000">type=</font>&quot;submit&quot;
<font color="#0000FF">&gt;</font></code><code><br>
<font color="#0000FF">&lt;/form&gt;</font></code></td>
<td><img src="images/arrow.jpg" alt="arrow" width="35" height="28"></td>
<td><img src="images/spelling.jpg" alt="search" width="269" height="26"></td>
</tr>
</table>
<p>
<font size="-1">The <em>q</em> parameter is required and used to store the
search query string. <br>
The form <em>action</em> points to the <em>results.jsp</em> page, which is
created in step <a href="#3_2">3.2</a>.</font> <font size="-1"></font>
<p>
<font size="-1" color="gray">The Google Web APIs authentication key can be
specified as an hidden form input parameter: <br>
</font>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="gray">&lt;input type=&quot;hidden&quot; name=&quot;key&quot;
value=&quot;000000000000000000000000&quot;&gt;</font></code></td>
</tr>
</table>
<p>
<a name="3_2"></a>
<p>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr colspan="2">
<td style="background-color: #fff9e4" width="80%"><b>3.2 Create a Result Page </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1"></font>
<p>
<font size="-1">Create a page called <em>results.jsp</em> containing:</font>
<p>
<table cellspacing="5">
<tr>
<td width="5">&nbsp;</td>
<td nowarp><code><font color="#009900">&lt;%@taglib uri=</font>&quot;/google-taglib&quot;
<font color="#009900">prefix=</font>&quot;google&quot;<font color="#009900">%&gt;</font></code></td>
</tr>
</table>
<p>
<font size="-1">The <em>taglib</em> directive is used to specify the Google Tag
library reference and prefix.</font>
<p>
<a name="3_3"></a>
<p>
<table bgcolor="#fff9e4" width="100%" border="0" cellspacing="0" cellpadding="2">
<tr colspan="2">
<td style="background-color: #fff9e4" width="80%"><b>3.3 Display the Spelling
Suggestion </b></td>
<td style="background-color: #fff9e4" width="20%" nowrap><font size="-1"><a href="#top">Back
to top</a> &nbsp; &nbsp; </font></td>
</tr>
</table>
<p>
<font size="-1"></font>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="#CC6600">&lt;google:spelling/&gt;</font></code></td>
<td><img src="images/arrow.jpg" alt="arrow" width="35" height="28"></td>
<td nowrap>long knives</td>
</tr>
</table>
<p>
<font size="-1">The <em>&lt;<a href="docs.html#3_2">google:spelling</a>&gt;</em> tag is used to display the
suggested spelling for the given query.</font>
<p>
<font size="-1" color="gray">The Google Web APIs authentication key can be
specified as a tag attribute: <br>
</font>
<table cellpadding="5">
<tr>
<td width="5">&nbsp;</td>
<td nowrap><code><font color="gray">&lt;google:spelling key=&quot;000000000000000000000000&quot;/&gt;</font></code></td>
</tr>
</table>
<p>
</blockquote>
</td>
</tr>
</table>
</body>
</html>

BIN
htdocs/images/arrow.gif Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 B

BIN
htdocs/images/arrow.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 751 B

BIN
htdocs/images/cached.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.6 KiB

BIN
htdocs/images/duktumbl.gif Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

BIN
htdocs/images/duktumbl.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

BIN
htdocs/images/google_sm.gif Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
htdocs/images/google_sm.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

BIN
htdocs/images/jars25.gif Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.1 KiB

BIN
htdocs/images/search.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.3 KiB

BIN
htdocs/images/spelling.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.2 KiB

BIN
htdocs/images/uml.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 173 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 100 B

View file

@ -0,0 +1,42 @@
body, td { background-color: white; }
h1 td, h1, h2, h3, h4, h5, h6, div.topnav,
div.sidenav, div.sidesearch, div.sidequote, div.bottomnav, div.footer, small,
td#sidebartitle { font-family: arial,sans-serif; }
/* rules for the bottom navigation on the results page */
div.bottomnav { margin-top: 1ex; }
div.bottomnav a, span.bottomnav { font-size: 10pt; }
div.bottomnav a, span.big { font-size: 12pt; color: #0000cc; }
/* standard link colors */
a:link { color: #0000cc; }
a:visited { color: #551a8b; }
a:active { color: #ff0000; }
/* top part of the page */
div.topnav { margin-bottom: 0.1ex; }
h1 td { font-size: .95em; font-weight: bolder; }
h1 td { background-color: #669900; color: white; border: none; padding: 2pt; }
div.side { margin-right: 3ex; padding: 2pt; }
div.sidenav { }
div.sidesearch { margin-top: 1em; font-size: 0.75em; }
div.sidequote { text-align: center; margin-top: 1.5in; border-color: red; border-style: solid; border-top-width: 1px; border-bottom-width: 1px; border-left-width: 0px; border-right-width: 0px; }
div.footer { text-align: center; color: #6f6f6f; padding: 3pt; }
/* sidebar on the right */
table.sidebarborder { margin: 3pt; margin-top: 1pt; }
td#sidebarcontent { background-color: #ffffff; }
/* color schemes for different sections of the site */
body.corporate h1 td, body.corporate table.sidebarborder td { background-color: #339966; }
body.corporate td#sidebartitle { background-color: #d8f1e4; }
body.siteowners h1 td, body.siteowners table.sidebarborder td { background-color: #ddad08; }
body.siteowners td#sidebartitle { background-color: #f1e4d8; }
body.search h1 td, body.search table.sidebarborder td { background-color: #336699; }
body.search td#sidebartitle { background-color: #d8e4f1; }
body.zealots h1 td, body.zealots table.sidebarborder td { background-color: #aa1002; }
body.zealots td#sidebartitle { background-color: #f1e4d8; }

224
htdocs/index.html Normal file
View file

@ -0,0 +1,224 @@
<html>
<head>
<link rel="stylesheet" href="includes/google.css">
<title>Google Tag Library</title>
<style type="text/css">
body,td,font,p,a{font-family:arial,sans-serif}
</style>
</head>
<body class="siteowners" bgcolor="#ffffff" text="#000000" link="#0000CC" vlink="#800080" alink="#ff0000" topmargin="2">
<table width="95%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td width="1%"><a href="index.html"><img src="images/google_sm.gif" border="0" width="143" height="37" alt="Return to the Google Tag Library homepage." vspace="5"></a></td>
<td valign="middle" bgcolor="#eeeeee"><h1 style="margin-top:10px">
<table width="100%">
<tr>
<td><b>&nbsp;Google Tag Library</b></td>
</tr>
</table>
</h1></td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="95%">
<tr>
<td width="143" valign="top">
<small><br>
<img src="images/yellowarrow.gif" alt="arrow" width="4" height="8"><b>&nbsp;<font color="#CC9900">Overview</font></b>
<br>
&nbsp;&nbsp;<a href="http://sourceforge.net/project/showfiles.php?group_id=90444">Download</a> <br>
&nbsp;&nbsp;<a href="docs.html">Documentation</a> <br>
&nbsp;&nbsp;<a href="howto.html">HowTo</a> <br>
&nbsp;&nbsp;<a href="javadoc/index.html">Javadoc</a><br>
&nbsp;&nbsp;<a href="tlddoc/index.html">TLD</a><br>
&nbsp;&nbsp;<a href="uml.html">UML</a></br>
&nbsp;&nbsp;<a href="about.html">About</a> </small>
<img alt="" width="143" height="0">
<p>
<table cellpadding="1" width="120">
<tr>
<td style="background-color: #efefef"><small>
<div class="sidesearch">
<form action="http://www.thauvin.net/gtlib-search/search.jsp" method="post">
<div align="center">
<font size="-2">
<i>Find on this site:</i><br>
<input type="text" name="q" size="10"><br><input type="submit" value="Search" name="submit">
<br>
</font>
</div>
</form>
</div>
</small>
</td>
</tr>
</table>
<p>
&nbsp;<a href="http://www.jars.com" target="_blank"><img src="images/jars25.gif" alt="Rated Jars Top 25%" border="0"></a>
<p>
&nbsp;<a href="http://sourceforge.net/projects/google-taglib"><img src="http://sourceforge.net/sflogo.php?group_id=9044&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo"/></a>
</p>
</td>
<td style="background-color: #cccccc" width="1" valign="top"><img alt="" width="1" height="1"></td>
<td style="background-color: #ffffff" width="10" valign="top"><img alt="" width="10" height="1"></td>
<td valign="top">
<table border="0" cellpadding="0">
<tr>
<td valign="top" width="65%">
<p>
<strong>Easily Include Google Searches in Your Web Applications </strong>
</p>
<p>
<font size="-1">With the Google JSP Tag Library, developers and designers can
easily incorporate Google queries, search results, cached pages and spelling
suggestions into any web site or application.</font>
</p>
<p>
<font size="-1">To start using the Google Tag Library:</font>
</p>
<table border="0" cellpadding="5" cellspacing="0">
<tr>
<td style="background-color: #FFEBAE"><font size="5"><b>1</b></font></td>
<td><font size="-1"><b>Download&nbsp;the&nbsp;Google Tag Library </b> <br>
The <a href="http://sourceforge.net/project/showfiles.php?group_id=90444">download</a> includes the tag library and associated TLD.</font></td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td style="background-color: #FFEBAE"><font face="arial,sans-serif" size="5"><b>2</b></font></td>
<td><font size="-1"><strong>Download the Google Web APIs</strong> <br>
To use the Google Web APIs service, you also must <a href="http://api.google.com/">obtain
a license key</a>.</font></td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td style="background-color: #FFEBAE"><font size="5"><b>3</b></font></td>
<td><font size="-1"><b>Incorporate the tags in your web pages</b> <br>
Check out the <a href="howto.html">HowTo</a> or read the <a href="docs.html">Documentation</a>
for more information.</font></td>
</tr>
</table>
</td>
<td valign="top">
<div align="center">
<table border="0" align="center" cellpadding="0" cellspacing="0">
<tr>
<td>
<div align="center">
<img src="images/duktumbl.gif" width="130" height="80" alt="Tumbling Duke" hspace="5">
</div>
</td>
</tr>
<tr>
<td>
<div align="center">
<p>
<font color="cc9900" size="-1">Duke does the Google dance.</font>
</p>
</div>
</td>
</tr>
</table>
<p>
<table class="sidebarborder" border="0" cellspacing="0" hspace="5" vspace="5" width="245" align="center">
<tr>
<td bgcolor="#cccccc">
<table class="sidebar" bgcolor="#ffffff" cellpadding="4" cellspacing="0" border="0" width="100%">
<tr valign="top">
<td colspan="2" style="background-color: #ffffff">
<div align="center">
<font size="-1"><strong>Requirements</strong></font>
</div>
</td>
</tr>
<tr valign="top">
<td id="sidebarcontent"><img src="images/arrow.gif" alt="arrow" width="6" height="14"></td>
<td id="sidebarcontent"><font size="-1">A JSP container, such as <a href="http://jakarta.apache.org/tomcat/">Tomcat</a>.</font></td>
</tr>
<tr valign="top">
<td id="sidebarcontent"><img src="images/arrow.gif" width="6" height="14" alt="arrow"></td>
<td id="sidebarcontent"><font size="-1">The <a href="http://api.google.com/">Google Web APIs</a> Java library. </font></td>
</tr>
<tr valign="top">
<td colspan="2" id="sidebarcontent">
<div align="center">
<font size="-1"><i>See the <a href="docs.html#1_1">Installation Notes</a> for
details.</i></font>
</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<p>
<table class="sidebarborder" border="0" cellspacing="0" hspace="5" vspace="5" width="245" align="center">
<tr>
<td bgcolor="#cccccc">
<table class="sidebar" bgcolor="#ffffff" cellpadding="4" cellspacing="0" border="0" width="100%">
<tr>
<td colspan="2" valign="top" style="background-color: #ffffff">
<div align="center">
<b><font size="-1">Some Usage Ideas</font></b>
</div>
</td>
</tr>
<tr>
<td valign="top" id="sidebarcontent"><img src="images/arrow.gif" alt="arrow" width="6" height="14"></td>
<td valign="top" id="sidebarcontent"><font size="-1">Provide a way to search
your web site or mailing list using Google.</font></td>
</tr>
<tr>
<td valign="top" id="sidebarcontent"><img src="images/arrow.gif" alt="arrow" width="6" height="14"></td>
<td valign="top" id="sidebarcontent"><font size="-1">Incorporate targeted Google
search results directly into your home page.</font></td>
</tr>
<tr>
<td valign="top" id="sidebarcontent"><img src="images/arrow.gif" alt="arrow" width="6" height="14"></td>
<td valign="top" id="sidebarcontent"><font size="-1">Add Google's spell-checking
to your weblog.</font></td>
</tr>
</table>
</td>
</tr>
</table>
<p>
<table class="sidebarborder" border="0" cellspacing="0" hspace="5" vspace="5" width="245" align="center">
<tr>
<td bgcolor="#cccccc">
<table class="sidebar" bgcolor="#ffffff" cellpadding="4" cellspacing="0" border="0" width="100%">
<tr>
<td valign="top" style="background-color: #ffffff">
<div align="center">
<b><font size="-1">Disclaimer</font></b>
</div>
</td>
</tr>
<tr>
<td valign="top" id="sidebarcontent">
<p>
<font size="-1">The Google Tag Library is open source. Please see its <a href="license.html">license</a>.</font>
</p>
<p>
<font size="-1">The library uses the Google Web APIs, but is not associated with
or sponsored by Google, Inc. </font>
</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
</body>
</html>

104
htdocs/license.html Normal file
View file

@ -0,0 +1,104 @@
<html>
<head>
<link rel="stylesheet" href="includes/google.css">
<title>Google Tag Library - License</title>
<style type="text/css">
body,td,font,p,a{font-family:arial,sans-serif}
</style>
</head>
<body class="siteowners" bgcolor="#ffffff" text="#000000" link="#0000CC" vlink="#800080" alink="#ff0000" topmargin="2">
<table width="95%" border="0" cellspacing="0" cellpadding="2">
<tr>
<td width="1%"><a href="index.html"><img src="images/google_sm.gif" border="0" width="143" height="37" alt="Return to the Google Tag Library homepage." vspace="5"></a></td>
<td valign="middle" bgcolor="#eeeeee"><h1 style="margin-top:10px">
<table width="100%">
<tr>
<td><b>&nbsp;Google Tag Library</b></td>
</tr>
</table>
</h1></td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="95%">
<tr>
<td width="143" valign="top">
<small><br>
&nbsp;&nbsp;<a href="index.html">Overview</a> <br>
&nbsp;&nbsp;<a href="http://sourceforge.net/project/showfiles.php?group_id=90444">Download</a> <br>
&nbsp;&nbsp;<a href="docs.html">Documentation</a> <br>
&nbsp;&nbsp;<a href="howto.html">HowTo</a> <br>
&nbsp;&nbsp;<a href="javadoc/index.html">Javadoc</a> <br>
&nbsp;&nbsp;<a href="tlddoc/index.html">TLD</a><br>
&nbsp;&nbsp;<a href="uml.html">UML</a></br>
<img src="images/yellowarrow.gif" alt="arrow" width="4" height="8"><b>&nbsp;<font color="#cc9900">About</font></b>
</small>
<img width="145" height="0" alt="">
<p>
<table cellpadding="1" width="120">
<tr>
<td style="background-color: #efefef"><small>
<div class="sidesearch">
<form action="http://www.thauvin.net/gtlib-search/search.jsp" method="post">
<div align="center">
<font size="-2">
<i>Find on this site:</i><br>
<input type="text" name="q" size="10"><br><input type="submit" value="Search" name="submit">
<br>
</font>
</div>
</form>
</div>
</small>
</td>
</tr>
</table>
<p>
&nbsp;<a href="http://sourceforge.net/projects/google-taglib"><img src="http://sourceforge.net/sflogo.php?group_id=9044&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo"/></a>
</p>
</td>
<td style="background-color: #cccccc" width="1" valign="top"><img alt="" width="1" height="1"></td>
<td style="background-color: #ffffff" width="10" valign="top"><img alt="" width="1" height="1"></td>
<td valign="top">
<p>
<b>Google Tag Libary License </b>
</p>
<p>
<font size="-1">Copyright (c) 2002-2003, Erik C. Thauvin.<br>
All rights reserved.</font>
</p>
<font size="-1">
<p>
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
</p>
<p>
Redistributions of source code must retain the above copyright notice, this list
of conditions and the following disclaimer.
</p>
<p>
Redistributions in binary form must reproduce the above copyright notice, this
list of conditions and the following disclaimer in the documentation and/or
other materials provided with the distribution.
</p>
<p>
Neither the name of the author nor the names of its contributors may be used to
endorse or promote products derived from this software without specific prior
written permission.
</p>
<p>
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS &quot;AS IS&quot;
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</p>
</font></td>
</tr>
</table>
</body>
</html>

12
htdocs/uml.html Normal file
View file

@ -0,0 +1,12 @@
<html>
<head>
<link rel="stylesheet" href="includes/google.css">
<title>Google Tag Library: UML</title>
</head>
<body topmargin="2">
<img src="images/uml.jpg" border="0" alt="UML" usemap="#Map">
<map name="Map">
<area shape="rect" coords="67,6,164,16" href="http://www.sparxsystems.com.au/" alt="Enterprise Architect">
</map>
</body>
</html>