Differences

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

--- user:navody:statistiky:template [2013/08/23 19:00] – [Seznam souborů šablony] gord
+++ user:navody:statistiky:template [Unknown date] (current) – external edit (Unknown date) 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== 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.
-<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 =====
   * **[[http://www.geocaching.com/profile/?u=kiregps|kiReGPS]], [[kiReGPS@gmail.com]]**
@@ Line 75: / Line 77: @@
   * Čá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>.
-  * 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>. //:?: 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 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.
 ==== Hlavní ====
@@ Line 88: / Line 90: @@
 ==== Záložky ====
 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^
-|''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 a 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.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]].|