Differences

This shows you the differences between two versions of the page.

--- user:skript:poigarmin [2010/11/01 10:06] – medwyn_cz
+++ user:skript:poigarmin [Unknown date] (current) – external edit (Unknown date) 127.0.0.1
@@ Line 3: / Line 3: @@
 Pomocí [[http://www8.garmin.com/products/poiloader/|POI Loaderu]] je možné nahrát soubory do navigace jako //Vlastní body zájmu// - neboli //POI//.
-Skript je určen především pro nejnovější Garmin GPS zařízení - Colorado, Oregon a Dakotu. S jistými úpravami nastavení by mohl fungovat i se staršími modely řady eTrex. Skript je však velice dobře použitelný i pro program [[http://www.google.com/search?q=garmin+xt|Garmin XT]], tedy SW od firmy Garmin pro mobilní zařízení (Symbian, Windows Mobile)
+Skript je určen především pro nejnovější Garmin GPS zařízení - Colorado, Oregon, Dakotu, GPSMap 62, ale je bez problémů použitelný takřka s jakoukoliv navigací Garmin. Skript je vhodný i pro užití s programem [[http://www.google.com/search?q=garmin+xt|Garmin XT]], tedy SW od firmy Garmin pro mobilní zařízení (Symbian, Windows Mobile).
-S tímto skriptem používejte vždy [[:download|nejnovější verzi]] programu Geoget. Pokud si nevíte rady s [[user:navody:instalace|instalací Geogetu]], instalací [[user:skript|skriptu]], [[user:navody:trideni_dat|filtrováním]] keší či [[user:menu:soubor#Export|exportem]], udělejte si pohodlí a přečtěte si [[:user|nápovědu]].
+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).
-Diskuze k tomuto skriptu je k dispozici [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=10129&pid=120937|zde]].
+Díky tomu je skript zcela univerzální a je možno jej užít pro generování GPX i pro starší GPS, například pro Garmin řady eTrex, pro které ale existuje i [[poietrex|skript specializovaný]]).
-<box round 95% #DEE7EC>
+Výchozí nastavení skriptu je šito na míru novým přístrojům - Colorado, Oregon, Dakota, GPSMap 62. Pokud jej chcete použít se starším zařízením - řady eTrex nebo GPSMap - můžete si změnou jedné položky v konfiguraci kompletně změnit generovaný výstup. Stačí nastavit hodnotu ''TEMPLATE_FOLDER'' na ''templates\etrex''. Více informací o významu jednotlivých položek najdete níže v dokumentaci.
-:?: Podobnou problematikou se zabývá i [[geopoi|ProKešTomovo makro GeoPOI]]. Je možné, že hledáte právě to.
-</box>
+S tímto skriptem používejte vždy [[:download|nejnovější verzi]] programu Geoget. Pokud si nevíte rady s [[user:navody:instalace|instalací Geogetu]], instalací [[user:skript|skriptu]], [[user:navody:trideni_dat|filtrováním]] keší či [[user:menu:seznam#export_ctrl_e|exportem]], udělejte si pohodlí a přečtěte si [[:user|nápovědu]].
+<WRAP center round info 80%>
+Podobnou problematikou se zabývá i [[geopoi|ProKešTomovo makro GeoPOI]]. Zkuste na něj mrknout, třeba se Vám zalíbí.
+</WRAP>
 ===== Autor =====
@@ Line 17: / Line 21: @@
 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 [[mailto:medwyn@seznam.cz|email]] a domluvíme se na jiném způsobu, třeba převodu na účet.//
+===== Automatická instalace =====
+~~GEOGET_INSTALL~~
+===== Diskuze =====
+  * Diskuze o tomto skriptu se nachází na stránkách  [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=10129&pid=120937|Geocaching.cz]].
 ===== Srovnání POI a GPX metody nahrávání keší do navigace =====
-<box round 95% #DEE7EC>
+<WRAP center round info 80%>
+Tento export je jednou ze dvou metod, pomocí kterých lze nahrát keše do navigací Garmin. Každá z metod má své plusy i mínusy. Není však žádný problém je používat obě najednou.
-:!: Tento export je jednou ze dvou metod, pomocí kterých lze nahrát keše do navigací Garmin. Každá z metod má své plusy i mínusy. Není však žádný problém je používat obě najednou.
 Proto je tento skript vhodné kombinovat se skriptem pro export do GPX - [[gpxgarmin|Garmin GPX]]. Skripty jsou optimalizovány k vzájemné spolupráci.
+</WRAP>
-</box>
 === Srovnávací tabulka ===
 ^ Vlastnost                                                                ^ GPX                          ^ POI    ^
-| Počet bodů, které GPS pojme, je shora omezen                             | ano (2000, resp 5000)        | ne (pouze velikost souboru a volné místo v paměti) |
+| Počet keší, které GPS pojme, je shora omezen                             | ano (2000, resp 5000)        | ne (pouze velikost souboru a volné místo v paměti) |
 | Zobrazení listingu (včetně logů, nápovědy, waypointů apod.)              | ano                          | ano    |
-| Listing je zobrazen vždy celý                                            | ne (pouze cca 7000 znaků)    | ano    |
+| Listing je zobrazen vždy celý                                            | ne (pouze cca 16000 znaků)    | ano    |
-| Body jsou v navigaci zobrazeny v nabídce "Geocaching" (jednodušší ovládání)                   | ano                          | ne     |
+| Keše jsou v navigaci zobrazeny v nabídce "Geocaching" (jednodušší ovládání)                   | ano                          | ne     |
-| Body je možno dělit do kategorií dle stavu keše včetně změny ikony       | ne                           | ano    |
+| Keše je možno dělit do kategorií dle stavu keše včetně změny ikony       | ne                           | ano    |
-| K bodům je možno v navigaci přiřadit poznámku                            | ano                          | ne     |
+| Ke keším je možno v navigaci přiřadit poznámku                            | ano                          | ne     |
-| Body je možno označit za nalezené a následně vygenerovat fieldnotes pro web Geocaching.com  | ano         | ne     |
+| Keše je možno označit za nalezené a následně vygenerovat fieldnotes pro web Geocaching.com  | ano         | ne     |
 ===== Funkce =====
+==== Šablony definující výstup ====
+Výstup skriptu (s výchozími šablonami) je velice podobný mému exportnímu skriptu do GPX pro [[gpxgarmin|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 **POI Garmin - editor šablon** v menu pluginy přímo v GeoGetu.
-Výstup skriptu je velice podobný mému exportnímu skriptu do GPX pro [[gpxgarmin|Garmin GPS]].
+Š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í:
+<box 96% right #f8f8f8 #f8f8f8 #f8f8f8 #f8f8f8>
+| %CONTAINSHIGHLIGHTWORD% | true, pokud listing obsahuje nějaká definovaná klíčová slova |
+| %LOGSTATHASISSUES% | true, pokud jsou na keši od posledního Found it logu podezřelé logy |
+| %WAYPOINTS% | výpis seznamu waypointů na keši |
+| %LOGS% | výpis logů na keši |
+| %LOGSTAT% | seznam podezřelých logů na keši od posledního Found it logu |
+| %GARMIN_LISTING% | celý listing zpracovaný POI Garmin makrem (očištění HTML, zvýraznění slov, odstranění seznamu waypointů) |
+| %GARMIN_LONGLISTING% | LongDescription část listingu zpracovaná POI Garmin makrem (očištění HTML, zvýraznění slov, odstranění seznamu waypointů) |
+| %GARMIN_SHORTLISTING% | ShortDescription část listingu zpracovaná POI Garmin makrem (očištění HTML, zvýraznění slov) |
+| %WMVISITINSTRUCTIONS% | podmínky logu na waymarku. Pokud šablona obsahuje tento vzor, podmínky logu budou automaticky odstraněny z konce listingu (%LONGLISTING%), aby bylo zabráněno duplikacím ve výstupu |
+</box>
-Zde příkládám seznam voleb, které je možno nastavit v konfiguračním souboru tohoto makra. 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.**
+==== Konfigurace ====
+ Zde příkládám seznam voleb, které je možno nastavit v konfiguračním souboru tohoto makra. 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.**
-== Seznam funkcí ==
+=== Seznam nastavení ===
    * **EXPORT_FOLDER** - Složka, do které se uloží výsledné exportované soubory. Pokud ji nedefinujete, skript se pokaždé na cestu zeptá. V konfiguraci lze použít relativní (vůči [[:user:slozky#datovy_adresar|datovému adresáři GeoGetu]]) nebo absolutní cestu.
    * **EMPTY_FOLDER** - Vymazat před započetím exportu všechny soubory z cílového adresáře?
    * **EXPORT_GEOCACHES** - Exportovat kešky? (Hlavní body)
    * **EXPORT_WAYPOINTS** - Exportovat waypointy? (Vedlejší body)
-   * **EXPORT_LISTING** - Exportovat listing?
-   * **EXPORT_WP_INFO** - Přidat na konec listingu informace o waypointech keše?
-   * **EXPORT_LOGS** - Exportovat do listingu logy?
    * **EXPORT_LOGS_MAXCOUNT** - Maximální počet logů k exportu
-   * **EXPORT_TAGS** - Seznam tagů, které budou ve výstupu obsaženy - zobrazeny jako text
+   * **PROXIMITY_CATEGORIES** - Seznam kategorií bodů (oddělovač '|'), na které bude upozorňováno při přiblížení na vzdálenost PROXIMITY_DISTANCE metrů.
    * **SHOW_ERRORS** - Zobrazovat chyby? Vypnutí této funkce je vhodné pro použití při zpracování makrem [[Combine]].
    * **CLEANUP_HTML** - Vymazat z logu a listingu pro Garmin GPX zbytečné HTML tagy
+   * **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ů vkládaný Groundspeakem do PQ
+   * **TEXT_HIGHLIGHT** - Seznam klíčových slov, která budou v listingu zvýrazněna
    * **EXPORT_ONLY_FINAL_WAYPOINTS_WHEN_FOUND** - U nalezených keší exportovat pouze finální waypointy (aby se nepletly různé stage a questions to answer na mapě)
-   * **TEXT_COLOR_DISABLED**, **TEXT_COLOR_FOUND**, **TEXT_COLOR_OWNED** - Barva textu v popisu keše
+   * **ICON_FOLDER** - Složka s ikonami. Lze použít relativní (vůči složce se skriptem) nebo absolutní cestu.
-   * **ICON_FILEPATH** - Složka s ikonami. Lze použít relativní (vůči složce se skriptem) nebo absolutní cestu.
+   * **TEMPLATE_FOLDER** - Složka se šablonami. 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.
-== Screenshoty ==
+===== Screenshoty =====
 |{{:user:skript:poigarmin:01_where_to.png|Kam vést?}}|{{:user:skript:poigarmin:02_poi_list.png|Seznam kategorií}}|{{:user:skript:poigarmin:03_categories.png|Seznam podkategorií}}|
 |  **Kam vést?**  |  **Seznam kategorií**  |  **Seznam podkategorií**  |
@@ Line 80: / Line 106: @@
 |  **Informace v listingu waymarku**  |  **Zobrazení listingu waymarku**  |
-===== Makro =====
+===== Obsah balíčku =====
+  * **icons** - Složka s ikonami. Obsahuje různé sady ikon
+     * **colorado_dakota_oregon_gpsmap62_original** - ikony shodné s ikonami, které pro keše používá Garmin ve svých jednotkách
+     * **colorado_dakota_oregon_gpsmap62_HuntBehind** - upravené ikony od [[http://www.geocaching.com/profile/?u=HuntBehind|HuntBehinda]]
+     * **etrex_mini_Geby** - ikonky od [[http://www.geocaching.com/profile/?u=HaLuMa|Gebyho]], které jsou součástí skriptu [[poietrex|POI Etrex]]).
-  * **poigarmin.default.pas** - Soubor s výchozím nastevením.
+  * **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.
-  * **poigarmin.ggp.pas** - Vlastní skript.
+     * **colorado_dakota_oregon_gpsmap62** - Šablony uzpůsobené pro vyjmenované nové navigace od firmy Garmin
-  * **icons** - Složka s ikonami. Obsahuje 2 sady ikon (**Original** - ikony shodné s ikonami, které pro keše používá Garmin ve svých jednotkách; **HuntBehind** - upravené ikony od [[http://www.geocaching.com/profile/?u=HuntBehind|HuntBehinda]]).
+     * **etrex** - Šablony uzpůsobené pro navigace řady Garmin Etrex. Výstup je téměř shodný se skriptem [[poietrex|POI Etrex]].
-  * makro dále využívá funkce v knihovnách **category.pas** a **RelToAbsPath.lib.pas**.
+  * **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.
 ===== Instalace =====
-   - Rozbalte soubory z archívu **poigarmin** do [[:user:slozky#datovy_adresar|datového adresáře]] GeoGetu.
+   - Nainstalujte instalační balíček (můžete využít tlačítka pro automatickou instalaci v hlavičce této stránky)
-   - Měla by vzniknout struktura **[[:user:slozky#datovy_adresar|Datový adresář]]\script\poigarmin\*.pas**
+   - V nabídce **[[:user:menu:pluginy|Pluginy]] -> [[user:menu:pluginy:spravce_pluginu|Správce pluginů]] -> Konfigurace pluginů -> poigarmin** nastavte export podle svých preferencí. Můžete si vybrat složku s ikonami a šablonami, která Vám vyhovuje.
-   - Ve složce **[[:user:slozky#datovy_adresar|Datový adresář]]\script\lib\** musí být soubory **category.pas** a **RelToAbsPath.lib.pas**.
+   - Pomocí editoru šablon **[[:user:menu:pluginy|Pluginy]]** -> (Nezařazené pluginy) -> **POI Garmin - editor šablon** si můžete dále upravit výstup, který export generuje.
-   - Spusťte GeoGet.
-   - V nabídce **[[:user:menu:pluginy|Pluginy]] -> [[user:menu:pluginy:spravce_pluginu|Správce pluginů]] -> Konfigurace pluginů -> poigarmin** nastavte export podle svých preferencí.
-   -
 ===== Použití =====
-   - Nyní již můžete vyhledat požadované cache a pomocí položky v menu [[:user:menu:pluginy|Pluginy]] vyexportovat složku se soubory GPX.
+   - Vyhledejte v okně GeoGetu požadovaná data a pomocí položky v menu [[:user:menu:pluginy|Pluginy]] -> (Nezařazené pluginy) -> **POI Garmin - GPX pro POI Loader** vyexportujte složku se soubory GPX. Výstupní složku volte raději prázdnou.
    - Hotovou složku nechte pomocí programu [[http://www8.garmin.com/products/poiloader/|POI Loader]] nahrát do navigace.
-<box round 95% #DEE7EC>
+<WRAP center round tip 80%>
-:?: Máte zájem nahrávání keší do navigace automatizovat? Podívejte se na plugin [[Combine]].
+Máte zájem nahrávání keší do navigace automatizovat? Podívejte se na plugin [[Combine]].
-</box>
+</WRAP>
+===== Možné náměty do budoucna =====
+   * Možnost uživatelského nastavení kategorizace bodů do skupin pomocí knihovny VarSubst - ověření, zda je to možné a případně implementace.
+   * Ještě těsnější spolupráce se skriptem GPX Garmin - sloučení společných částí kódu, tvorba integrovaného balíku exportu pro Garmin
 ===== Stažení =====
-<box round 95% #DEE7EC>
+<WRAP download>
-:!: Stáhnout aktuální verzi: ~~DOWNLOAD poigarmin-*.zip highest~~
+Stáhnout aktuální verzi: ~~DOWNLOAD poigarmin-*.gip highest~~
-</box>
+</WRAP>
 ==== Seznam dostupných verzí ====
-{{filelist>poigarmin:*.[gz]ip&style=table&tableheader=1&tableshowdate=1&sort=mtime}}
+{{filelist>poigarmin:*.gip&style=table&tableheader=1&tableshowdate=1&sort=mtime}}
-==== Changelog ====
+==== Seznam změn ====
+=== 0.6 (4. 1. 2011) ===
+   * 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í
+   * Upraven způsob zapisování výsledných dat do souboru. Zpracování exportu je nyní rychlejší.
+   * Přidána možnost definovat si klíčová slova, na jejichž výskyt bude poté prohledáván listing. Každé nalezené slovo bude barevně zvýrazněno a na tuto skutečnost je upozorněno na začátku listingu.
+   * Přidána možnost upozorňovat na přítomnost bodu, který patří do nějaké kategorie. Kategorie jsou shodné, jako výstupní adresářová struktura. Například "GC\Final Location" nebo "GC - Disabled\Traditional Cache". Je nutné dodržet velikost písmen!
+   * Přidána možnost odstraňovat přebytečný seznam waypointů, který Groundspeak vkládá na konec listingu v PQ
+   * 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)
+   * Opravena chyba s interpretací českých znaků, pokud je jako cílová exportní složka zvolena složka obsahující v názvu česká diakritická znaménka
+   * Použita verze 0.1.3 knihovny Category
+   * Vylepšena funkce na odstraňování zbytečných HTML tagů v listingu
+   * Překlad do angličtiny. Added english language version.
+<hidden onHidden=":!: **Zobrazit změny ve starších verzích**" onVisible="Skrýt změny ve starších verzích">
 === 0.5b (31. 7. 2010) ===
    * Opravena chyba zavlečená implementací varování při přiblížení k finálce. POI Loader špatně interpretoval GPX soubor a ten se v navigaci zobrazoval jako text (včetně tagů) a ne jako HTML
-<hidden onHidden=":!: **Zobrazit změny ve starších verzích**" onVisible="Skrýt změny ve starších verzích">
 === 0.5 (29. 7. 2010) ===
    * Přidána možnost nechat se upozorňovat navigací při přiblížení na X metrů k vypočtenému finálovému bodu
@@ Line 165: / Line 210: @@
    * Úvodní testovací verze
 </hidden>
-{{tag>colorado dakota export garmin ggp gps gpx oregon poi skript waymarking}}
+{{tag>author_medwyn colorado dakota export etrex garmin ggp gps gpx oregon poi skript waymarking uses_varsubst uses_reltoabspath uses_category}}