|
Using Caterpillar
Caterpillar is designed to be ridiculously easy to use, but there are some things you can do with it that may not be immediately obvious.
This document attempts to address those things, and the obvious ones too.
Requirements
Caterpillar requires Java 1.4.2 or higher. If you don't have it you will need to
download it from Sun.
Don't download the version with NetBeans in it unless you actually want NetBeans.
Either the SDK or the JRE version will work.
Installation
Unzip the archive you downloaded and move
the Caterpillar folder to wherever you'd like it to live.
*nix users: edit the run_caterpillar.sh script and chage the INSTALL_DIR variable
near the top to
to reflect where you copied the Caterpillar directory to. Ex.INSTALL_DIR=/home/me/bin/Caterpillar/.
Launching
Mac OS X: double-click the Caterpillar icon.
Windows: double-click the run_caterpillar.bat
*nix: execute the run_caterpillar.sh after first changing the INSTALL_DIR in it
to reflect where you copied the Caterpillar directory to..
Adding a feed
 Adding a feed is pretty simple. Open the "File" menu and choose "Add Feed" (or just hit control+n) and paste in the URL of the feed you wish
to add a subscription to. Then just hit enter or the "Add" button. Caterpillar supports RSS, RDF, and ATOM feeds.
Reading entries
Reading entries is probably the simplest thing in Caterpillar. Just select it by either clicking on a title in the list
or using your arrow keys to move between titles. The content associated with the given title will be displayed in the
bottom of the window.
Reading a specific feed
 Your search field is also a pull-down that contains a list of all the feeds you're subscribed to. Just
choose the one you're interested in from the list.
Colors
 When a new entry comes in it will be green. This indicates that you haven't read it yet. Once you've selected an entry for a second it will
turn white when your selection moves to another entry. A white entry is one that you have read that will eventually be deleted.
Orange entries are ones that will be permanently saved.
Saving entries
Saving entries, like everything else, is pretty simple. If you've got it's title selected
you can just hit enter. Alternately you can double-click
the title. The title should turn Purple. Caterpillar will never
delete an entry once you've indicated you want to save it. If, later on,
you decide you don't
want to keep an entry any more you can do the same thing to un-save it.
Searching
 Caterpiller has a pretty sophisticated search engine called Lucene hiding under the covers. For
the most part you can just pretend it's Google and search as you would there. After searching for something it will be added to the
pull down options for the search field. That way if you search for something and later want to find that same
thing again but forgot what you searched for you can just pull down the list.
If you want to know all the complex operators you can use for
really precise searching you can check out Lucene's Query Parser Syntax page.
In addition to the use of complex operators Caterpillar allows you to search within specific fields by
prefacing your search term with the name of the field. For example if you wanted to find all the entries with
"hapy" in their title you'd type "title:happy" without the quotes. All the searcable fields are listed below:
- title - searches the titles of each entry
- content - searches the content of each entry
- feed - searches by for a feed whose name contains the specified text
Getting the Latest Entries
Caterpillar will update all the feeds you're subscribed to when you launch it and every hour thereafter. If you just can't wait till the next hour select
"Reload Feeds" from the "File" menu.
e-mailing an entry
 From the file menu choose "e-mail entry" and enter your email address and the address you want to send it to.
If you want to send it to more than one person just separate the addresses with commas.
Then click send. That's it.
If there's any problem sending Caterpillar will let you know. Sometimes it takes a minute to look up the servers and send the e-mail to them
so give it a little bit before checking your in box.
Exporting
Caterpillar will let you export all you feeds and their entries to XML. I'll leave it up to you to decide what to do with the XML. To export your
feeds just choose "Export Feeds" from the "File" menu and a file called exportedFeeds.xml will be created in Caterpillar's home directory.
| 
