GeoKajet
Geocaching application for Qtopia.
Copyright 2006 Rafal Mantiuk
This is free software licensed under GPL
If you do not know what geocaching is, visit the geocaching web pages at
http://www.geocaching.com.
GeoKajet can:
-
Display cache descriptions from
www.geocaching.com page in a nice, single
column format, appropriate for small screens.
-
Decode encrypted hints.
You can also view cache descriptions in an HTML browser, such as Opera or
NetFront, or using a PDF viewer. But these programs consume more memory on your
PDA and are slower to load. Besides, the original layout of geocaching web pages
or PDF files is not really suitable for small screens. GeoKajet solves this
problem by simplifying HTML and using a lightweight HTML browser to display it.
Manual
To prepare files for GeoKajet
-
Open http://www.geocaching.com in your web
browser, load a page with a cache and choose
'Make this page printer
friendly'
-
Choose from the menu 'Save page as'
(ctrl+s), give a meaningful name to the HTML file, so you can find it later.
You can give the name extension .geoml, so
that the file will be associated with GeoKajet.
Do not use the following characters in
the file name: space,
-,
&,
%.
-
Copy to your PDA both the saved HTML
file and the directory of the same name (minus extension) that was saved
along with the file.
Note: The software was tested only with Firefox and may not function with other
browsers.
To load a cache description in GeoKajet
-
Click on the file with the .gml extension in the document browser.
-
Or, click on
icon from GeoKajet's task bar and choose the file.
Note: The HTML simplification script has been written for the current state of
the geocaching web pages and may not work if their format changes. This can be
fixed by editing XSLT stylesheet (see To customize
... below).
To decode encrypted hints
-
Click on decrypt on the displayed page, next to the encrypted hint
-
Or, click on
icon from GeoKajet's task bar and type in or paste the
text to decrypt.
To customize the look of displayed pages
GeoKajet uses XSLT to transform a complex HTML of the original pages to a much
simpler HTML that can be displayed using Qt HTML browser. If you know something
about XSLT, you can edit the file
'/opt/QtPalmtop/shared/geokajet/simplify.xslt'.
The style sheet requires two parameters:
-
base_name = GeoKajet passes the directory where the HTML page is located.
Useful to fix href entries for images.
-
decode = true | false
To contact the author
If you have suggestions, comments, found bugs or would like to contribute, send
email to rafm@users.sourceforge.net.
Why 'GeoKajet'?
The original name was 'GeoHelper', but I had to change it as I found
it taken by a geocaching application for PalmOS. 'Kajet' (pronounced
cayet) is a rarely used word for a paper notebook in Polish.