GSAK (Geocaching Swiss Army Knife)
 

Contents - Index


Publish logs (Geocaching.com access=>Publish logs


Select this option to automatically publish your logs to Geocaching.com

In order to publish logs you must first populate the grid with log entries to publish. You do this by selecting the "fetch" option from the right mouse click menu.



From Gpsr - Select this option if you have "Geocaching friendly" GPSr connected (For example, Colorado, Oregon, Dakota, eXplorist GC)  that has a standard format Geocache_Visits.txt file

From Filter - The grid will be populated with caches from your current filter of caches.

From File - Select this option to populate the grid from a standard format  Geocache_Visits.txt file. Unlike the "From GPSr" option, you do not have to have a GPSr connected. As long as you can specify the location of the file and the format is valid, then you can load it.

From current cache - use this option to add just the currently selected cache to the grid.

Your grid should then look something like:



Now you can click on the "Edit" button to modify individual log entries as required. Note: You can also delete entries from here as well (click on the "delete" button at the bottom of the dialog, or use the right mouse click option). Any cache that has been "selected" will be deleted. The grid supports the standard methods of record selection. You can select using the mouse - Drag the mouse over rows to select a contiguous block. To select non contiguous rows, hold down the Ctrl key on the keyboard, and then click your mouse on the required rows. From the keyboard,  Ctrl-A to select *all* entries, Hold down the shift key and use the cursor keys to select contiguous rows. As a side note, you can also use Ctrl-C to copy the selected rows to the clipboard. The format copied to the clipboard is compatible with Microsoft Excel, so you can just paste the data into a spread sheet if you wish. 



Also note that you will see an offline view of the selected cache.  This screen shows in a separate non modal dialog. You can re size (including maximize to full screen) and move to suit. Users with dual monitors or large screens should get the most out of this feature. However, even on a small nettop it should be usable. That is, you can position the HTML display so that just some part is shown behind the edit dialog. Now you can easily toggle between the edit dialog and the HTML screen simply via a mouse click to the corresponding dialog. 

Log type - Select the required log type from the drop down list.

Sequence - When logs are published to Geocaching.com, they are sent in sequence order. Change the sequence number to reflect the order you want the log published.

Log date and time - This is the date and time of the log. It should usually be given in local time, but also make sure you enter the correct time zone

Zone - This is the time zone associated with the Log date and time. Note: All log date/times must be *posted* a GMT/Zulu times. However, when doing the initial fetch GSAK will determine your time zone and substitute today's date. You should always post your log date/times according to the corresponding time zone (change if required) GSAK will convert the date/time to GMT when posting the log. 

Field notes - If this entry was the result of populating your grid from a "Geocaching friendly GPSr" or supported file, then you will see the field notes here

Tags - You can select from the drop down list tags which will have the corresponding values converted when the log is published. Click on the preview tab to see what the final log will look like using these tags.

Click on any one of the icons to have the corresponding BBcode inserted at the cursor. BBcodes are converted to the corresponding icon when viewed at Geocaching.com or in the HTML displays of GSAK. Click on the preview tab to see the final result of your log including BBcode conversion.

Click on this button to spell check your log text

Click on this button to insert a saved template. The use of templates enables you to have standard boiler plate text for each log type. You can change the text for that log after inserting a template, or just leave as is. To create a template, click on the "Templates" button at the bottom of the dialog. 

Templates

Click on the "Templates" button at the bottom of the dialog to maintain a list of templates by log type. Templates can save you time by allowing you to insert standard text for each log (click on the "template" button in the edit dialog).



You can include literal text as well as %tags. %tags represent variable information that will be converted when the log is published (you can also see this conversion by selecting the "preview" tab). Most of the %tags should be obvious from the definition shown in the drop down list. However the tags %data and %time do need further explanation

%date[format]

Where "format" represents a series of characters.

'xx'  Characters enclosed in single  quotes are displayed as-is, and do not affect formatting.
Format specifiers may be written in upper case as well as in lower case letters--both produce the same result.

d      Displays the day as a number without a leading zero (1-31).
dd     Displays the day as a number with a leading zero (01-31).
ddd    Displays the day as an abbreviation (Sun-Sat) using the strings given by the ShortDayNames system settings.
dddd   Displays the day as a full name (Sunday-Saturday) using the strings given by the LongDayNames system settings.
ddddd  Displays the date using the format given by the ShortDateFormat system settings.
dddddd Displays the date using the format given by the LongDateFormat system settings.
m      Displays the month as a number without a leading zero (1-12). If the m specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.

mm    Displays the month as a number with a leading zero (01-12). If the mm specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.

mmm    Displays the month as an abbreviation (Jan-Dec) using the strings given by the ShortMonthNames system settings.
mmmm  Displays the month as a full name (January-December) using the strings given by the LongMonthNames system settings.
yy    Displays the year as a two-digit number (00-99).
yyyy  Displays the year as a four-digit number (0000-9999).
/      Displays the date separator character given by the DateSeparator system settings.

Day and Month names (both short and long) will display in the language as per your computer settings.

If your system settings are set to English (American) then if  today's date is 16th May, 20011 :

%date[dddd, dd mmmm yyyy] = Monday, 16 May 2011 

If your system settings are set to German (Germany) then:

%date[dddd, dd mmmm yyyy] = Montag, 16 Mai 2011 


%time[format]

h     Displays the hour without a leading zero (0-23).
hh    Displays the hour with a leading zero (00-23).
n     Displays the minute without a leading zero (0-59).
nn    Displays the minute with a leading zero (00-59).
s     Displays the second without a leading zero (0-59).
ss    Displays the second with a leading zero (00-59).
t     Displays the time using the format given by the ShortTimeFormat system settings.
tt    Displays the time using the format given by the LongTimeFormat system settings.
am/pm Uses the 12-hour clock for the preceding h or hh specifier, and displays 'am' for any hour before noon, and 'pm' for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly.

a/p   Uses the 12-hour clock for the preceding h or hh specifier, and displays 'a' for any hour before noon, and 'p' for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly.

ampm  Uses the 12-hour clock for the preceding h or hh specifier, and displays the contents of the TimeAMString global variable for any hour before noon, and the contents of the TimePMString global variable for any hour after noon.

:      Displays the time separator character given by the TimeSeparator system settings.






Copyright 2004-2011 CWE Computer Services  
Privacy Policy Contact