GgStat Documentation  >  Template  > Main

Prezentační část

Tato část je v podstatě jakýmsi předpisem toho, co má statistika obsahovat. Jedná se de facto o volání jednotlivých funkcí, které generují příslušné výstupy. Navíc, jako bonus, může tato část ještě obsahovat některé prvky použité v inicializační časti souboru.

Při volání funkcí je v příkladu použito Nadpis, což je obecný text, který bude zobrazen v nadpisovém stylu nad příslušným blokem statistiky. Pokud tento text bude mít hodnotu none, nadpis bude vynechán.

Obecná nastavení

APPEND_NUMBERSPřidá řádek definovaný pomocí DEFINENUMBERS na konec tabulky zajímavých čísel
BORDERdefinuje šířku rámečku pro všechny následují bloky statistik.
COLORSLze použít v inicializační i prezentační části, každá tabulka tedy může mít jinou barvu. Všechny barvy musejí být na jediném řádku v hexadecimálním tvaru RRGGBB (červená=ff0000, zelená=00ff00 a modrá=0000ff) a jsou v následujícím pořadí (v závorce je uvedena výjimka v použití příslušné barvy pro zobrazení tabulky Obtížnost/Terén, v níž jsou barvy používané trochu odlišně):
  1. barva pozadí včetně pozadí grafů (barva textu v hodnot počtu nálezů)
  2. barva textu
  3. pozadi nadpisů bloků jednotlivých statistik
  4. barva textu nadpisu
  5. pozadí záhlaví jednotlivé tabulky se statistkou
  6. barva textu záhlaví tabulky
  7. pozadí textu tabulky (+ pozadí 2. záhlaví, tj. řádku a sloupce s hodnotou obtížnosti nebo terénu a řádku a sloupce s celkovým počtem nálezů každé obtížnosti nebo terénu)
  8. barva textu tabulky (text 2. záhlaví, tj. řádku a sloupce s hodnotou obtížnosti nebo terénu a řádku a sloupce s celkovým počtem nálezů každé obtížnosti nebo terénu s výjimkou maximálního počtu)
  9. pozadí hodnot v tabulce (barva pozadí v políčkách, kde není žádný nález)
  10. barva písma pro výpis hodnot
  11. barva pro výpis maximální hodnoty (barva textu v políčku s maximální hodnotou počtu nálezů)
  12. barva pro výpis průměrné hodnoty
  13. barva pro výpis minimální hodnoty
  14. barva procent odlovených pro mapy krajů a okresů (barva pozadí hodnot počtu nálezů)
COLORSCALEhodnota yes, ano, no nebo ne povoluje nebo potlačuje škálování barvy pro znázornění různé hodnoty v tabulkách.
COMMENTNEXTPřidá komentář na konec následující tabulky nebo grafu
DEFINE_DATASETDefinuje datovou řadu a její barvu pro graf FindsSummary, jméno odpovídá hodnotě z tabulek podle typu, velikosti, obtížnosti, terénu a země.
DEFINE_DATASET Traditional Cache 97B883
DEFINE_DATASET Multi-cache FFDE19
DEFINE_DATASET Unknown Cache 243C97
DEFINENUMBERSUmožňuje definovat vlastní položku v zajímavých číslech, nejdříve je třeba definovat text pomocí příkazu LANG_..., předpokládá se hlavně použití v pluginech

LANG_NUMBERS_MyOwnHeader Moje statistiky
LANG_NUMBERS_MyData Jsem největší hledač na světě
DEFINENUMBERS NumbersMyOwn MyOwnHeader MyData
APPEND_NUMBERS NumbersMyOwn

ELEVATIONRANGErozsah histogramu výšek v metrech, parametry jsou minimum a maximum
ELEVATIONRANGE -100 599
HIDEYEARLYBez parametrů. Ukryje roční přírůstky v grafu FindsSummary.
MAXTABLELINESNEXTdefinuje maximální počet řádek následující tabulky. Toho lze využít například pro omezení počtu zobrazovaných okresů nebo počtu zobrazovaných nálezců vlastních keší. Pokud je ppříkaz použit pro tabulku autorů, má vyšší prioritu než příkaz AUTHORS.
RANGETABLELINESNEXTdefinuje rozsah řádků tabulky zařazených Účelem je například umožnit rozdělení tabulky do více sloupců. Příklad:
SPLIT 2
RANGETABLELINESNEXT 1 10
MyFindsByFindersTable none
RANGETABLELINESNEXT 11 20
MyFindsByFindersTable none
ReadCanton
ReadCanton Tag Země

Načte z databáze okresy (canton) dané země z tagu. Pokud název tagu obsahuje mezery, musí se nahradit znakem ~.
ReadCounty
ReadCounty Tag Země

Načte z databáze kraje (state, county) dané země z tagu. Pokud název tagu obsahuje mezery, musí se nahradit znakem ~.
ReadState
ReadState Země

Načte z databáze kraje (state, county) dané země z pole State v GG.
SETVAR
SETVAR AUTORU 1000

umožňuje definovat vlastní proměnné, funkce je určena hlavně pro pluginy
SPLITdefinuje počet bloků statistik, které budou zařazeny vedle sebe (viz také WIDTHNEXT).
TABMENUodděluje obsah stránky pro jednotlivé položky menu. Vše před prvním výskytem tohoto příkazu bude společné pro všechny položky menu nad menu. Vše za posledním přikazem bu společné pro všechny položky menu na konci stránky.
WIDTHmění šířku statistik. Od toho okamžiku jsou všechny bloky generované s novou šířkou.
WIDTHNEXTdefinuje šířku jen následujícího bloku statistik.

Vložený text

HTMLvloží jeden řádek HTML kódu a zároveň přerušuje případný neukončený SPLIT.
HTMLNOSPLITvloží jeden řádek HTML kódu - nemá vliv na SPLIT.
INCLUDEvloží soubor do statistik
INCLUDEHTMLvloží HTML stránku, první parametr je kódování, druhý parametr je URL stránky.
INCLUDE_TEMPLATEvnoří soubor template

Grafy a tabulky

DateMonthFound
DateMonthFound Měsíc Den Nadpis

Zobrazí tabulku s počtem nalezených keší v závislosti na dni a měsíci.
DifficultyTerrain
DifficultyTerrain Nadpis

Zobrazí tabulku s počtem nalezených keše v závislosti na obtížnosti a terénu.
FindsByAuthorsTable
FindsByAuthorsTable Nadpis

Zobrazí tabulku s histogramem podle počtu nálezů keší jednotlivých autorů.
FindsByCantonPie
FindsByCantonPie [Flags:P] Nadpis

Zobrazí koláčový graf s počtem nálezů v jednotlivých okresech ČR. Zpracování má smysl pouze pokud v databázi existuje Tag CZ okres obsahující jméno okresu - zařídí plugin czdivide. Použití parametru Flags:P změní zpracování z počtu nálezů na procentuální zastoupení nalezených kešek z počtu nalezitelných keší v okrese. Procenta se počítají z maximálního počtu nalezitelných keší v krajích.
FindsByCantonTable
FindsByCantonTable [Flags:P] Nadpis

Zobrazí tabulku s počtem nálezů v jednotlivých okresech ČR. Zpracování má smysl pouze pokud v databázi existuje Tag CZ okres obsahující jméno okresu - zařídí plugin czdivide. Použití parametru Flags:P doplní tabulku o maximální počet nalezitelných keší v okrese a procentuální zastoupení nalezených.
FindsByContainerPie
FindsByContainerPie Nadpis

Zobrazí koláčový graf počtu nálezů podle velikosti keše.
FindsByContainerTable
FindsByContainerTable Nadpis

Zobrazí tabulku počtu nálezů podle velikosti keše, řazeno podle počtu nálezů.
FindsByContainerTableSorted
FindsByContainerTableSorted Nadpis

Zobrazí tabulku počtu nálezů podle velikosti keše, řazeno podle velikosti keše.
FindsByCountyPie
FindsByCountyPie [Flags:P] Nadpis

Zobrazí koláčový graf s počtem nálezů v jednotlivých krajích ČR. Zpracování má smysl pouze pokud v databázi existuje Tag CZ kraj obsahující jméno kraje - zařídí plugin czdivide. Použití parametru Flags:P změní zpracování z počtu nálezů na procentuální zastoupení nalezených kešek z počtu nalezitelných keší v kraji. Procenta se počítají z maximálního počtu nalezitelných keší v krajích.
FindsByCountyTable
FindsByCountyTable [Flags:P] Nadpis

Zobrazí tabulku s počtem nálezů v jednotlivých krajích ČR. Zpracování má smysl pouze pokud v databázi existuje Tag CZ kraj obsahující jméno kraje - zařídí plugin czdivide. Použití parametru Flags:P doplní tabulku o maximální počet nalezitelných keší v kraji a procentuální zastoupení nalezených.
FindsByDifficultyPie
FindsByDifficultyPie Nadpis

Zobrazí koláčový graf počtu kešek podle obtížnosti.
FindsByDifficultyTable
FindsByDifficultyTable Nadpis

Zobrazí tabulku nalezených kešek podle obtížnosti, řazeno podle počtu nálezů.
FindsByDifficultyTableSorted
FindsByDifficultyTableSorted Nadpis

Zobrazí tabulku nalezených kešek podle obtížnosti, řazeno podle obtížnosti.
FindsByDirections
FindsByDirections Nadpis

Zobrazí graf s vyznačením počtu nálezů v jednotlivých směrech od domovských souřadnic.
FindsByDistance
FindsByDistance Nadpis

Zobrazí tabulku počtu keší nalezených v různých intervalech vzdálenosti od zadaných domovských souřadnic.
FindsByDistanceHistogram
FindsByDistanceHistogram Nadpis

Zobrazí histogram počtu keší nalezených v různých intervalech vzdálenosti od zadaných domovských souřadnic.
FindsByElevation
FindsByElevation Nadpis

Zobrazí graf nalezených keší (na vodorovné ose je číslo keše při seřazení podle jejich nadmořské výšky) v závislosti na jejich nadmořské výšce (na svislé ose). Zpracování má podmínku: v databázi existuje Tag Elevation obsahující nadmořskou výšku keší. - zařídí plugin Elevation.
FindsByElevationHistogram
FindsByElevation Nadpis

Histogram počtu keší v různých nadmořských výškách. Zpracování má smysl pouze pokud v databázi existuje Tag Elevation obsahující nadmořskou výšku keší - zařídí plugin Elevation.
FindsByElevationHistogram2
FindsByElevation2 Nadpis

Jiná verze histogramu počtu keší v různých nadmořských výškách. Zpracování má smysl pouze pokud v databázi existuje Tag Elevation obsahující nadmořskou výšku keší - zařídí plugin Elevation.
FindsByElevationTable
FindsByElevationTable Nadpis

Zobrazí tabulku výšek nalezených keší. Zpracování má podmínku: v databázi existuje Tag Elevation obsahující nadmořskou výšku keší. - zařídí plugin Elevation.
FindsByHoursZobrazí histogram s počtem nálezů v jednotlivých denních hodinách.
FindsByHours Nadpis
FindsByMonthZobrazí histogram počtů nálezů v jednotlivých měsících všech roků hledání.
FindsByMonth Nadpis
FindsByTerrainPie
FindsByTerrainPie Nadpis

Zobrazí koláčový graf počtu kešek podle terénu.
FindsByTerrainTable
FindsByTerrainTable Nadpis

Zobrazí tabulku nalezených kešek podle terénu, řazeno podle počtu nálezů.
FindsByTerrainTableSorted
FindsByTerrainTableSorted Nadpis

Zobrazí tabulku nalezených kešek podle terénu, řazeno podle terénu.
FindsByTypePieZobrazí koláčový graf s počtem nálezů jednotlivých typů keší.
FindsByTypePie Nadpis
FindsByTypeTableZobrazí tabulku s histogramem podle počtu nálezů jednotlivých typů keší.
FindsByTypeTable Nadpis
FindsByWeekdayPie Zobrazí koláčový graf počtu nálezů v jednotlivých dnech v týdnu.
FindsByWeekdayPie Nadpis
FindsByWeekdayTable Zobrazí tabulku s histogramem podle počtu nálezů v jednotlivých dnech v týdnu, řazení podle dnů v týdnu.
FindsByWeekdayTable Nadpis
FindsByWeekdayTableSorted Zobrazí tabulku s histogramem podle počtu nálezů v jednotlivých dnech v týdnu, řazení podle běžného pořadí dnů v týdnu.
FindsByWeekdayTableSorted Nadpis
FindsSummary Zobrazí sumární graf počtu nálezů.
FindsSummary Nadpis
Headervypíše text jako by byl nadpis (barva, velikost, oramování) dalšího bloku statistiky
HourWeekdayFound
HourWeekdayFound Den Hodina Nadpis

Zobrazí tabulku s počtem nalezených keší v závislosti na dnu v týdnu a hodině.
YearMonthPlaced
YearMonthPlaced Rok Měsíc Tabulka založení keše rok / měsíc

Zobrazí tabulku s počtem nalezených keší v závislosti na roce a měsíci založení.

Seznamy

(Pokud je příkaz zároveň odkazem na ukázkový příklad, je to odkaz jen na jeden z možných příkladů. V příkladech se může příkaz vyskytnout i jinde.)

FindsCustomizedMilestones
FindsCustomizedMilestones Nadpis

Zobrazí seznam kešek zařazených do mílníků stejně jako FindsMilestones, ale umožňuje definovat spoužité sloupce (viz MILESTONETABLE).
FindsMilestones
FindsMilestones Nadpis

Zobrazí seznam kešek zařazených do mílníků.
MILESTONETABLE definuje sloupce tabulky mílníků (významných kešek). Povolené hodnoty pro definici sloupců jsou: Milestone, Published, Terrain, Difficulty, Code, Name, Icon, Size, Distance, Direction, Date, Interval, Tag* (viz DEFINETAG)
MyFindsByLogTypeTable
MyFindsByLogTypeTable Nadpis

Zobrazí tabulku s histogramem podle počtu typů logů vlastních keší.
MyOwnCustomizedList
MyOwnCustomizedList Nadpis

Zobrazuje modifikovatelnou tabulku keší vytvořených (vlastněných) uživatelem (viz spouštěcí parametr -c, CACHER, MYCACHESOWNER, DEFINETAG, MYOWNTABLE, LAN_MY_CACHE_*).
MyOwnList
MyOwnList Nadpis

Zobrazuje tabulku keší vytvořených (vlastněných) uživatelem (viz spouštěcí parametr -c, CACHER, MYCACHESOWNER).
MYOWNTABLE definuje sloupce tabulky vlastních keší generované příkazem MyOwnCustomizedList. Použitelné hodnoty pro definici sloupců jsou Number, Published, Terrain, Difficulty, Code, Icon, Size, Name, Distance, Direction, LastVisit, MaxLog, MinLog, AvgLog, Found, DNF, Age, Active, VisitsDay, Tag* (viz DEFINETAG). Jména sloupců jsou stejná jako v překladu LANG_MY_CACHE_....
MyFindsByFindersTable
MyFindsByFindersTable Nadpis

Zobrazí tabulku s histogramem podle počtu nálezců vlastních keší.
MySomeNumbers
MySomeNumbers Nadpis

Zobrazí tabulku s výpisem zajímavých čísel získaných z analýzy vlastních keší. Nadpis definuje text nadpisu bloku statistiky.
NUMBERSTABLEslouží k definování řádků tabulky sumárních statistik (viz příkazy SomeNumbers, DEFINENUMBERS,LANG_NUMBERS_*). Seznam platných řádků je Elevation, Logs, Age, Direction, General, Distance, Numbers*
SomeNumbers
SomeNumbers Nadpis

Zobrazí tabulku s výpisem zajímavých čísel získaných z analýzy nalezených keší. Nadpis definuje text nadpisu bloku statistiky.
MyxTFList
MyxTFList Nadpis

Zobrazí tabulku keší s Tagem FTF. Do tabulky vypisuje hodnotu tohoto Tagu (předpokládá se FTF, SFT, TFT). Má smysl jenom pokud ručně vyplňujete tag FTF.
TagCustomizedList
TagCustomizedList Tag Nadpis

Zobrazuje modifikovatelnou tabulku keší, které mají definovaný Tag (viz DEFINETAG, TAGTABLE, LAN_TAG_*).
TAGTABLEslouží k definování sloupců tabulky vytvořené podle hodnoty tagu (viz příkazy TagCustomizedList, DEFINETAG, LANG_TAG_*). Seznam platných sloupců je Index, ID, Published, Date, Interval, Terrain, Difficulty, Code, Icon, Size, Name, Distance, Direction, Tag*
SORTTAGTABLE
SORTTAGTABLE [+/-]Směr [Formát]

Příkaz slouží ke změně řazení tabulky vytvořené příkazem TagCustomizedList. Tabulka je implicitně řazena podle tagu, který je vyhodnocován jako text a řazen alfabeticky.
[+/-]Typdefinuje typ dat uložených v tagu a nepovinně i směr řazení. + znamená rostoucí a - klesající řazení. Pokud není směr řazení uveden, je rostoucí. Povolené hodnoty pro Typ jsou
ASCII abecední řazení (implicitní hodnota, v tom případě není příkazu zapotřebí),
NUM číselné řazení
DATE řazení podle data
Formátdefinuje formát zápisu data v tagu. Předpokládá se pouze použití čísel s oddělovači mezi dnem, měsícem a rokem. Oddělovačem může být tečka, lomítko, pomlčka (resp. mínus). D znamená den v měsíci, M číslo měsíce a Y rok. Příklady:
   D.M.Y
   Y-M-D
   D/M/Y
a podobně.
SORTTAGINDEX
SORTTAGINDEX Sloupec

Příkaz slouží ke změně řazení řádků tabulky vytvořené příkazem TagCustomizedList. Umožní definovat číselně sloupec, podle kterého se řádky řadí. Sloupec nabývá hodnot od 0 do N (N=počet sloupců tabulky). Hodnota sloupce 0 znamená, že řádky tabulky budou řazeny abecedně podle hodnoty TAGu. Hodnoty sloupce 1 až N jsou pořadím sloupce, podle kterého budou řádky tabulky řazeny. Mají-li být hodnoty řazeny jinak než abecedně, je nutné použít pžikaz SORTAGTABLE.

Mapy

FindsByCantonMap
ReadCanton SK~okres Slovakia
FindsByCantonMap Flags:N Nálezy podle okresu na Slovensku

Zobrazí mapu okresů v zemi načtené pomoci ReadCanton
FindsByCountyMap
ReadState Germany
FindsByCountyMap Nadpis

Zobrazí mapu krajů v zemi načtené pomoci ReadCounty
FindsByCountry
FindsByCountry kontinent Nadpis

Zobrazí tabulku států v daném kontinentu s počtem nálezů v jednotlivých státech. První parametr definuje kontinent - možné hodnoty jsou:
  • africa
  • asia
  • europe
  • middle_east
  • south_america
  • world
FindsByKrajCZ
FindsByKrajCZ [Flags:BNP] Nadpis

Zobrazí tabulku a malou mapku krajů České republiky s počty nalezených kešek v jednotlivých krajích. Zpracování má smysl pouze pokud v databázi existuje Tag CZ kraj obsahující jméno kraje - zařídí plugin czdivide. Nepovinný parametr Flags rozšiřuje tabulku a přes mapu překrývá čísla:

B - základní (basic), jako bez parametru Flags
N - na mapku do jednotlivých krajů umístí počty nelezených kešek
P - na mapku do jednotlivých krajů umístí procentuální zastoupení nalezených kešek na počtu nalezitelných keší v kraji. Tabulka vedle mapky zároveň bude rozšířena o maximální počet nalezitelných keší v krají a procentuální hodnotu nalezených. Má smysl pouze pokud GG2 obsahuje všechny keše v ČR.

FindsByKrajCZMap
FindsByKrajCZMap [Flags:BNP] Nadpis

Zobrazí velkou mapku krajů České republiky s počty nalezených kešek v jednotlivých krajích. Velikost mapy je ovlivněna velikostí sloupce. Zpracování má smysl pouze pokud v databázi existuje Tag CZ kraj obsahující jméno kraje - zařídí plugin czdivide. Nepovinný parametr Flags přes mapu překrývá čísla:

B - základní (basic), jako bez parametru Flags, kraje jen vybarveny, bez čísel
N - do jednotlivých krajů umístí počty nelezených kešek
P - do jednotlivých krajů umístí procentuální zastoupení nalezených kešek na počtu nalezitelných keší v kraji. Procenta se počítají z maximálního počtu nalezitelných keší v krajích, má smysl pouze pokud GG2 obsahuje všechny keše v ČR.

FindsByOkresCZMap
FindsByOkresCZMap [Flags:BNP] Nadpis

Zobrazí velkou mapku okresů České republiky s počty nalezených kešek v jednotlivých okresech. Velikost mapy je ovlivněna velikostí sloupce. Zpracování má smysl pouze pokud v databázi existuje Tag CZ okres obsahující jméno okresu - zařídí plugin czdivide. Nepovinný parametr Flags přes mapu překrývá čísla:

B - základní (basic), jako bez parametru Flags, okresy jen vybarveny, bez čísel
N - do jednotlivých okresů umístí počty nelezených kešek
P - do jednotlivých okresů umístí procentuální zastoupení nalezených kešek na počtu nalezitelných keší v okresu. Procenta se počítají z maximálního počtu nalezitelných keší v okresech, má smysl pouze pokud GG2 obsahuje všechny keše v ČR.