GeoGet

Complete geocaching solutions

User Tools

Site Tools


user:navody:statistiky:template

Differences

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

Link to this comparison view

user:navody:statistiky:template [2013/08/22 09:49] – [Obsah šablony] kiregpsuser:navody:statistiky:template [Unknown date] (current) – external edit (Unknown date) 127.0.0.1
Line 1: Line 1:
 ====== Template.extended - šablona pro GgStat ====== ====== Template.extended - šablona pro GgStat ======
 Vzorová šablona pro [[user:skript:ggstat|GgStat]], která využívá řadu doplňků a triků pro rozšíření obsahu i funkčnosti statistiky. Část použitých technik je popsána na stránce [[user:navody:statistiky-triky|triky a vychytávky]]. Aplikování dílčích návodů na vlastní šablonu a sladění všech nastavení je ale dost pracné, proto jsem se rozhodl raději zveřejnit celou vzorovou šablonu. Je odvozena od šablony, kterou používám ve svém [[http://www.geocaching.com/profile/?u=kiregps|profilu]]. Lehce jsem ji očistil od osobního balastu a vyřadil části, tvořené mým zatím nezveřejněným pluginem. Kvůli přehlednosti a snazším úpravám je šablona rozdělena na více souborů. Začátečníci mohou použít šablonu //jak je//, pokročilí ji mohou vzít jen jako základ vlastního díla. Vzorová šablona pro [[user:skript:ggstat|GgStat]], která využívá řadu doplňků a triků pro rozšíření obsahu i funkčnosti statistiky. Část použitých technik je popsána na stránce [[user:navody:statistiky-triky|triky a vychytávky]]. Aplikování dílčích návodů na vlastní šablonu a sladění všech nastavení je ale dost pracné, proto jsem se rozhodl raději zveřejnit celou vzorovou šablonu. Je odvozena od šablony, kterou používám ve svém [[http://www.geocaching.com/profile/?u=kiregps|profilu]]. Lehce jsem ji očistil od osobního balastu a vyřadil části, tvořené mým zatím nezveřejněným pluginem. Kvůli přehlednosti a snazším úpravám je šablona rozdělena na více souborů. Začátečníci mohou použít šablonu //jak je//, pokročilí ji mohou vzít jen jako základ vlastního díla.
-<WRAP important>Zatím rozpracováno. Po dokončení bude založeno vlákno na GC.CZ</WRAP>+<WRAP important> 
 +**Vzhledem k vývoji situace kolem GgStatu zůstane tahle šablona jako slepá ulička vývoje. Myšlenky zde obsažené jsou zapracovány do [[user:skript:stator|Statoru]], nového generátoru statistik...** 
 +</WRAP>
 ===== Autor ===== ===== Autor =====
   * **[[http://www.geocaching.com/profile/?u=kiregps|kiReGPS]], [[kiReGPS@gmail.com]]**   * **[[http://www.geocaching.com/profile/?u=kiregps|kiReGPS]], [[kiReGPS@gmail.com]]**
Line 8: Line 10:
   * Diskuze o **Template.extended** se nachází na stránkách FIXME [[http://www.geocaching.cz/forum/viewthread.php?forum_id=...|Geocaching.cz]].   * Diskuze o **Template.extended** se nachází na stránkách FIXME [[http://www.geocaching.cz/forum/viewthread.php?forum_id=...|Geocaching.cz]].
 ===== Vlastnosti ===== ===== Vlastnosti =====
 +  * Vše (jednotlivé části šablony a podpůrné pluginy) se **nainstaluje jedním balíčkem**.
   * Statistiky jsou rozděleny na **záložky**, v rámci záložek na **sekce**. Sekce je základním stavebním kamenem Template.extended. Konfigurace obsahu statistiky spočívá ve výběru **předdefinovaných sekcí** a jejich zařazení do seznamů na záložkách. Sekce mohou obsahovat i //podsekce//, což jsou standardní záhlaví GgStatu.   * Statistiky jsou rozděleny na **záložky**, v rámci záložek na **sekce**. Sekce je základním stavebním kamenem Template.extended. Konfigurace obsahu statistiky spočívá ve výběru **předdefinovaných sekcí** a jejich zařazení do seznamů na záložkách. Sekce mohou obsahovat i //podsekce//, což jsou standardní záhlaví GgStatu.
   * Sekce se dají pro lepší přehlednost **sbalit a rozbalit**. Ve výchozím stavu jsou rozbaleny jen vybrané sekce. Hlavička sekce je rozlišena ikonou podle obsahu.   * Sekce se dají pro lepší přehlednost **sbalit a rozbalit**. Ve výchozím stavu jsou rozbaleny jen vybrané sekce. Hlavička sekce je rozlišena ikonou podle obsahu.
Line 13: Line 16:
   * Celá šablona je pouze **česky**. {{http://www.geocaching.com/images/icons/flags/png/cz.png}}   * Celá šablona je pouze **česky**. {{http://www.geocaching.com/images/icons/flags/png/cz.png}}
   * Obsah statistik je rozšířen řadou **doplňků**, často pomocí [[user:skript:ggsexpr|GgsExpr]]. Jedna záložka je věnovaná odznakům, generovaným skriptem [[user:skript:badgegenii|BadgeGen II]], jedna obsahuje [[user:skript:geopuzzle|GeoPuzzle]], na záložce vlastních keší můžete použít výstup z pluginu [[user:skript:myownstat|MyOwnStat]].   * Obsah statistik je rozšířen řadou **doplňků**, často pomocí [[user:skript:ggsexpr|GgsExpr]]. Jedna záložka je věnovaná odznakům, generovaným skriptem [[user:skript:badgegenii|BadgeGen II]], jedna obsahuje [[user:skript:geopuzzle|GeoPuzzle]], na záložce vlastních keší můžete použít výstup z pluginu [[user:skript:myownstat|MyOwnStat]].
-  * Vše (jednotlivé části šablony a podpůrné pluginy) se **nainstaluje jedním balíčkem**. 
   * Pro generování speciálních seznamů keší, grafů a zajímavých čísel jsou často použity [[user:navody:tagy|tagy]]. Kromě standardních i [[template#tagy|několik speciálních]].   * Pro generování speciálních seznamů keší, grafů a zajímavých čísel jsou často použity [[user:navody:tagy|tagy]]. Kromě standardních i [[template#tagy|několik speciálních]].
   * Doplňky vytvářejí řadu [[template#Seznam proměnných|proměnných]], které lze použít do popisných textů.   * Doplňky vytvářejí řadu [[template#Seznam proměnných|proměnných]], které lze použít do popisných textů.
Line 29: Line 31:
 ===== Nastavení ===== ===== Nastavení =====
 ==== Obsah šablony ==== ==== Obsah šablony ====
-FIXME Zde jen velmi stručně, detailní tabulku s popisem všech souborů zařadit "do přílohy". Pokud bude sekcí a záložek připraveno víc, než použito, okomentovat. Možná udělat i S|M|L|XL varianty záložek (případně začátečník|FTF lovec|drsnokačer)...?!? Varianty asi jako podadresáře Tabs, kde budou soubory Tab*.cfg stejných jmen a jen se nakopírují.+FIXME Zde jen velmi stručně, detailní tabulku s popisem všech souborů zařadit "do přílohy". Pokud bude sekcí a záložek připraveno víc, než použito, okomentovat. Možná udělat i S|M|L|XL varianty záložek (případně začátečník|FTF lovec|drsnokačer)...?!? <wrap tip>Varianty asi jako podadresáře Tabs, kde budou soubory Tab*.cfg stejných jmen a jen se nakopírují.</wrap>
 ==== Texty do záložek ==== ==== Texty do záložek ====
 ==== Mapy ==== ==== Mapy ====
Line 75: Line 77:
   * Části, které je **nutné upravit**, mají v seznamu značku <wrap important> Nutno upravit</wrap>   * Části, které je **nutné upravit**, mají v seznamu značku <wrap important> Nutno upravit</wrap>
   * Části, které je úprava jen **doporučená** nebo **možná**, mají v seznamech značku <wrap info> Doporučeno upravit</wrap> nebo <wrap info> Možno upravit</wrap>   * Části, které je úprava jen **doporučená** nebo **možná**, mají v seznamech značku <wrap info> Doporučeno upravit</wrap> nebo <wrap info> Možno upravit</wrap>
-  * Do budoucna se uvažuje o nástrojích, které budou šablonu Template.extended konfigurovat klikací způsobem. Části, kde se předpokládá, že budou vznikat jako výsledek konfigurace nástrojem, mají v seznamu značku <wrap tip> Upraví se nástrojem</wrap>.+  * Do budoucna se uvažuje o nástrojích, které budou šablonu Template.extended konfigurovat klikací způsobem. Části, kde se předpokládá, že budou vznikat jako výsledek konfigurace nástrojem, mají v seznamu značku <wrap tip> Upraví se nástrojem</wrap>//FIXME Otazka (Gord): To má znamenat, že plugin soubor vytvoří nebo změní nebo že spustí editor k jeho ruční úpravě uživatelem? Prosím upravit formulaci, aby to bylo zřejmé,//
   * Do ostatních souborů není potřebné nijak zasahovat. Pokud nevíte přesně co děláte, tak to ostatně ani nedoporučuji.   * Do ostatních souborů není potřebné nijak zasahovat. Pokud nevíte přesně co děláte, tak to ostatně ani nedoporučuji.
 ==== Hlavní ==== ==== Hlavní ====
Line 88: Line 90:
 ==== Záložky ==== ==== Záložky ====
 Všechny soubory, definující vlastní obsah záložek jsou umístěny v podadresáři ''Tabs''. Všechny soubory, definující vlastní obsah záložek jsou umístěny v podadresáři ''Tabs''.
 +
 +== Konvence pojmenování souborů ==
 +^Soubor^Popis^
 +|''Tab.<jméno_záložky>.cfg''|Hlavní soubor záložky, do něj se vkládají další dva soubory.|
 +|''Tab.<jméno_záložky>.Text.cfg''|Úvodní text na záložce. Úvodní text je <wrap info> Doporučeno upravit</wrap>, případně nechat prázdný.|
 +|''Tab.<jméno_záložky>.Sections.cfg''|Soubor obsahuje seznam sekcí, které jsou v záložce zobrazeny. <wrap tip> Soubor je automaticky generován pluginem podle toho, které sekce si uživatel v pluginu vybere.</wrap> U každé sekce je v pluginu možné určit, zda ve výchozím stavu bude sekce rozbalena a bude vidět její obsah nebo bude sbalena jen do nadpisu s možností jejího rozbalení.((Stav sekcí se přepíná vložením ''SectionSetOpened.cfg'' nebo ''SectionSetClosed.cfg'' do seznamu sekcí.))|
 +
 +:!: Protože každá záložka je definovaná právě těmito třemi soubory, je v následujícím popisu uveden jen hlavní soubor záložky. Jména zbylých dvou si čtenář jistě sám odvodí. V je pak uved seznam sekcí, které jsou v záložce (jejich seztnam je tedy v souboru ''Tab.<jméno záložky>.Sections.cfg'').
 + 
 +====  ====
 +
 ^Soubor^Popis^ ^Soubor^Popis^
-|''Tabs\Tab.Main.cfg''|Hlavní definiční soubor záložky **Přehled**, v něm jsou vloženy obě následující podšablony s úvodním textem a seznamem sekcí. Záložka se zobrazí jako výchozí při otevření profilu.| +|''Tabs\Tab.Main*.cfg''|Obsah záložky **Přehled**. Záložka se zobrazí jako výchozí při otevření profilu obsahuje sekce __Zajímavá čísla__, __Nejlepší dny__ a __Nálezy podle měsíce__((ve výchozím nastavení se zde zobrazují všechny roky, je možné je omezit příkazem ''HIDEYEARS'' v hlavním souboru ''Template.extended.cz'')).|
-|''Tabs\Tab.Main.Text.cfg''|Úvodní text na záložce **Přehled**. Úvodní text je <wrap info> Doporučeno upravit</wrap>, případně nechat prázdný.| +
-|''Tabs\Tab.Main.Sections.cfg''|Seznam sekcí záložky **Přehled** - obsahuje sekce __Zajímavá čísla__, __Nejlepší dny__ a __Nálezy podle měsíce__((ve výchozím nastavení se zde zobrazují všechny roky, je možné je omezit příkazem ''HIDEYEARS'' v hlavním souboru ''Template.extended.cz'')). V seznamu sekcí je možné určit, zda budou následující sekce ve výchozím stavu rozbalené nebo zabalené.((Stav sekcí se přepíná vložením ''SectionSetOpened.cfg'' nebo ''SectionSetClosed.cfg'' do seznamu sekcí.)) <wrap tip> Upraví se nástrojem</wrap>|+
 |''Tabs\Tab.Maps*.cfg''|Obsah záložky **Mapy** (včetně souborů ''*.Text.cfg'' <wrap info> Doporučeno upravit</wrap> a ''*.Sections.cfg'' <wrap tip> Upraví se nástrojem</wrap> - viz záložku Main). Pokud lovíte jen po Evropě, nebude potřeba nic měnit. Světoběžníci si mohou zapnout odlovené světadíly nebo přidat nějakou speciální zemi.| |''Tabs\Tab.Maps*.cfg''|Obsah záložky **Mapy** (včetně souborů ''*.Text.cfg'' <wrap info> Doporučeno upravit</wrap> a ''*.Sections.cfg'' <wrap tip> Upraví se nástrojem</wrap> - viz záložku Main). Pokud lovíte jen po Evropě, nebude potřeba nic měnit. Světoběžníci si mohou zapnout odlovené světadíly nebo přidat nějakou speciální zemi.|
 |''Tabs\Tab.Stat*.cfg''|Obsah záložky **Statistiky** (včetně souborů ''*.Text.cfg'' <wrap info> Doporučeno upravit</wrap> a ''*.Sections.cfg'' <wrap tip> Upraví se nástrojem</wrap> - viz záložku Main). Histogramy, koláče, grafy, tabulky křížové i seznamy. Je zde toho celkem dost. Jediným problémem by mohla být poslední sekce __Nálezy podle času__. Vyžaduje mít u logů i čas odlovu. Kdo nemá, může celou sekci [[template#Odstranění sekce|vypustit]].| |''Tabs\Tab.Stat*.cfg''|Obsah záložky **Statistiky** (včetně souborů ''*.Text.cfg'' <wrap info> Doporučeno upravit</wrap> a ''*.Sections.cfg'' <wrap tip> Upraví se nástrojem</wrap> - viz záložku Main). Histogramy, koláče, grafy, tabulky křížové i seznamy. Je zde toho celkem dost. Jediným problémem by mohla být poslední sekce __Nálezy podle času__. Vyžaduje mít u logů i čas odlovu. Kdo nemá, může celou sekci [[template#Odstranění sekce|vypustit]].|
Line 103: Line 114:
 Sekce je základním stavebním kamenem Template.extended. Každý soubor definuje celou jednu sekci. Všechny soubory sekcí jsou umístěny v podadresáři ''Sections''. Sekce je základním stavebním kamenem Template.extended. Každý soubor definuje celou jednu sekci. Všechny soubory sekcí jsou umístěny v podadresáři ''Sections''.
 ^Soubor^Popis^ ^Soubor^Popis^
-|''Sections\Section.Main01.SomeNumbers.cfg''| | +|''Sections\Section.SomeNumbers.cfg''| | 
-|''Sections\Section.Main02.BestDays.cfg''| | +|''Sections\Section.BestDays.cfg''| | 
-|''Sections\Section.Main03.FindsByMonths.cfg''| |+|''Sections\Section.FindsByMonths.cfg''| | 
 +|''Sections\Section.MapEurope.cfg''| | 
 +|''Sections\Section.MapEuropeLarge.cfg''| | 
 +|''Sections\Section.MapWorld.cfg''| | 
 +|''Sections\Section.MapWorldContinents.cfg''| | 
 +|''Sections\Section.MapCzech.cfg''| | 
 +|''Sections\Section.MapSlovakia.cfg''| | 
 +|''Sections\Section.MapGermany.cfg''| | 
 +|''Sections\Section.MapAustria.cfg''| | 
 +|''Sections\Section.MapFrance.cfg''| |
  
 ==== Výpočty a generování obsahu ==== ==== Výpočty a generování obsahu ====
user/navody/statistiky/template.1377157793.txt.gz · Last modified: 2013/08/22 00:00 (external edit)