Jedná se o skript, který exportuje z Geogetu GPX soubory podobné PQ. Soubory jsou však speciálně upraveny pro použití s nejnovějšími GPSkami od firmy Garmin (Colorado, Oregon, Dakota, GPSMap 62).

Skript používá ke své práci knihovnu VarSubst, která je univerzálním nástrojem pro generování uživatelsky konfigurovatetlného výstupu. Kromě funkcí integrovaných v knihovně poskytuje uživateli i další funkce (viz oddíl níže).

Pokud si nevíte rady s instalací Geogetu, instalací makra, filtrováním keší či exportem, udělejte si pohodlí a přečtěte si nápovědu.

Pokud se Vám doplněk líbí, kliknutím na tlačítko Donate můžete přispět na jeho vývoj.

Nekamarádíte se s PayPalem? Napište mi email a domluvíme se na jiném způsobu, třeba převodu na účet.

• Diskuze o tomto skriptu se nachází na stránkách Geocaching.cz.

Co si budeme povídat, Garmin dělá bezvadné GPSky. Čeští geocacheři jsou ale zřejmě náročnější než jejich anglicky mluvící kolegové a tak jim občas diktát z Kansasu nevyhovuje. Rádi by si zobrazení keší v Garminu trošku přiohli a zlepšili. A přesně proto jsem naprogramoval tento exportní skript, který jim v tom ohýbání trošku pomůže.

Výstup skriptu (s výchozími šablonami) je velice podobný mému exportnímu skriptu do POI pro Garmin GPS. Díky šablonám je však možno si výstup zcela přizpůsobit k obrazu svému. K tomu slouží editor šablon, který je k dispozici pod položkou GPX Garmin - editor šablon v menu pluginy přímo v GeoGetu.

Šablona je textový soubor s “příkazy” pro knihovnu VarSubst, která se stará o tvorbu výstupu. Šablony můžete libovolně upravovat a výstup si tak konfigurovat. Dokumentaci k obsahu šablon, možným příkazům a nastavením najdete na stránce knihovny VarSubst.

Kromě standardních knihovních proměnných poskytuje export ještě tyto proměnné k nahrazení:

Zde příkládám seznam voleb, které je možno nastavit v konfiguračním souboru tohoto skriptu. Seznam můžete brát jako nápovědu či jako přehled schopností exportu. Každou z těchto funkcí lze volitelně zapnout či vypnout.

• EXPORT_WAYPOINTS - Možnost zapnout či vypnout exportování dodatečných waypointů (Additional waypoints).
• CHANGE_WAYPOINT_SYMBOLS - Možnost volitelně měnit kategorie exportovaných waypointů (Garmin jim přiřadí ikonky (aspoň barevně) podobné těm z GC.com)
• EXPORT_LOGS_MAXCOUNT - Umožňuje definovat maximální počet logů, které budou k jednotlivé kešce exportovány. Velmi vhodné pro ušetření velikosti výsledného souboru. (protože mají naše GPSky nesmyslně stanovené limity)
• EXPORT_ONLY_FINAL_WAYPOINTS_WHEN_FOUND - Pokud je keš nalezená, exportuje pouze případné finální waypointy. Ušetříme tak místo pro waypointy u nenalezených keší.
• EXPORT_FINAL_AS_STARTING, FINAL_CATEGORY, EXPORT_STARTING_AS_REFERENCE, START_COORDINATES_PREFIX - Pokud keš obsahuje finální waypoint, je keš exportována místo výchozích souřadnic na místo finálního waypointu. Kategorie keše je změněna na hodnotu FINAL_CATEGORY (například 'Final cache') a v GPS se pak zobrazuje s ikonkou zavřené truhličky (pro Oregon 600 viz poznámku níže). Originální výchozí souřadnice jsou pak volitelně exportovány jako Reference point s volitelným prefixem. (Opět je toto řešení vedené snahou co nejvíce se vyhnout navigaci na Waypoint a následnému složitému čtení listingu/logů/hintu/záznamu pokusu apod.)
  Nevýhody tohoto řešení jsou nejméně 3:
  1. dle takto upravené kategorie nelze v GPS finálové keše filtrovat
  2. pokud má keš více finálových bodů (např není jasné, které vypočtené souřadnice jsou ty správné), je keš přesunuta na jedny finálové souřadnice a ostatní jsou ignorovány. Nelze zajistit, aby keš byla přesunuta na jedny konkrétní souřadnice, třeba pomocí definovaného prefixu.
  3. Varování V navigaci Garmin Oregon 600 (a pravděpodobně dalších) je nutné nastavit hodnotu FINAL_CATEGORY na prázdný řetězec (FINAL_CATEGORY = ''), jinak se keška na mapě ani v seznamu nemusí vůbec zobrazit. Zatím není jasné, jak v těchto navigacích změnit ikonu vyluštěné kešky. Všechno je jinak: hodnota final category MUSÍ být “Geocache Course”. Pak se truhlička vrátí zpět. Pokud byste chtěli mít onu ikonu jinou, vězte, že soubor s ikonou je třeba pojmenovat pouze “Geocache”! Viz zde. A POZOR NA NASTAVENÍ FILTRU!
• CLEANUP_HTML - Pročištění listingu a logů o tagy, které nedokáže Garmin GPS zpracovat. Ušetří se tak spousta drahocenného místa. Tagy, které skript odstraňuje: span, table, td, tr, th, div, font, a, i, img, marquee, center, blockquote, li, ul, ol. Pokud víte o nějakém dalším zbytečném tagu, navrhněte ho!
• REPLACE_IMAGES - Všechny obrázky v listingu nahradí za upozornění, že zde byl obrázek (a pokud je uveden, zobrazí alternativní text)
• CLEANUP_GROUNDSPEAK_WAYPOINTLIST - Z konce listingu odstraní nepoužitelný seznam waypointů, který Groundspeak přidává na konec listingu v PQ.
• TEXT_HIGHLIGHT - Seznam slov (oddělených znakem |, např. 'bonus|spoiler', nezáleží na velikosti písmen), která mají být ve výsledném exportu barevně zvýrazněna. Skutečnost, že listing obsahuje zvýrazněné slovo, je vypisována na začátek popisu keše.
• CHECK_LISTING_LENGTH - Kontrolovat, zda nejsou listingy pro zobrazení v GPS příliš dlouhé a nebude docházet k jejich ořezu.
• SHOW_EXPORT_WARNINGS, MAX_CACHES, MAX_WPTS, MAX_SIZE - Skript kontroluje, zda nebyly překročeny maximální povolené hodnoty počtu keší, waypointů či velikosti výsledného souboru. Výchozí hodnoty by *měly* podle různých fór a diskuzí a podle mých zkušeností být správné pro Garmin Oregon řady X50 (450, 550 …). V případě překročení upozorní skript na konci exportu zprávou.
• TEMPLATE_FOLDER - Složka se šablonami, které definují výstup. Lze použít relativní (vůči složce se skriptem) nebo absolutní cestu.
• TEMPLATE_POINT_NAME, TEMPLATE_POINT_DESCRIPTION, TEMPLATE_WAYPOINT_NAME, TEMPLATE_WAYPOINT_DESCRIPTION - Cesta k šablonám, které definují výstup (jméno bodu, popis bodu, jméno waypointu, popis waypointu). Lze použít relativní (vůči složce se šablonami) nebo absolutní cestu.

• templates_bundled - Složka s výchozími šablonami, která je automaticky přepisována při instalaci novější verze exportu. Není doporučeno v ní cokoliv upravovat, protože úpravy budou aktualizací přepsány. Obsahuje více jazykových mutací šablon.

• templates - Složka se šablonami (vytvářená instalačním skriptem dle zvoleného jazyka v GeoGetu). V této složce můžete šablony bez obav upravovat. Úpravy budou zachovány i po instalaci novější verze exportu. Při instalaci skriptu je složka automaticky vytvářena instalátorem a jsou do ní nakopírovány (NE přepisovány!) šablony patřičné jazykové mutace ze složky templates_bundled.

• locale - Složka s lokalizací skriptu.

• truncated exports - Složka obsahuje GGT seznamy (Seznam keší pro GeoGet) keší, u kterých byl při exportu zjištěn příliš dlouhý listing a je nebezpečí, že nebude v navigaci zobrazen celý. Soubory ve složce jsou pojmenovány dle jména vytvářeného GPX souboru a času vytvoření.

1. Nainstalujte instalační balíček (můžete využít tlačítka pro automatickou instalaci v hlavičce této stránky)
2. V nabídce Pluginy → Správce pluginů → Konfigurace pluginů → gpxgarmin nastavte export podle svých preferencí.
3. Pomocí editoru šablon Pluginy → (Nezařazené pluginy) → GPX Garmin - editor šablon si můžete dále upravit výstup, který export generuje. Nezapomeňte si změny v šablonách uložit!

1. Vyhledejte požadované keše
2. Pomocí nabídky Soubor –> Export –> Export… nebo klávesové zkratky Ctrl+E otevřete exportní nabídku
3. Vyberte položku GPX Garmin - pro nové Garmin GPS a vyexportujte soubor .gpx
4. Hotový soubor uložte do složky \Garmin\GPX\ v Garmin přístroji či na paměťové kartě

• Ještě těsnější spolupráce se skriptem POI Garmin - sloučení společných částí kódu, možnost exportovat waypointy jako POI a podobně.

• Pro formátování výstupu je nyní použita knihovna VarSubst. Každý uživatel makra si tak může konfigurovat formát výstupu přesně dle svých preferencí
• Pro určení cest k šablonám je využito funkcí knihovny RelToAbsPath.
• Přidána možnost nechat si v listingu vyznačovat místa, na kterých je obrázek (pokud obsahuje alternativní text, je zobrazen)
• Množství změn v konfiguraci výstupu.
• Dělení listingu - lepší využívání vlastností Garminu. Nyní dokážeme zobrazit až 16kB dlouhý listing (dříve pouze 8kB). Hodně tak klesne počet keší, jejichž listing je useknutý před koncem
• Vylepšena funkce na odstraňování zbytečných HTML tagů v listingu
• Možnost volitelně měnit kategorie exportovaných waypointů (Garmin jim přiřadí ikonky (aspoň barevně) podobné těm z GC.com)
• Výchozí hodnoty nastavení makra jsou nyní pro Oregon 550 (aktualizoval jsem HW )
• Lokalizace je nyní k dispozici v češtině a angličtině. Added english language version.