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í

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.
HIDEYEARLYBez parametrů. Ukryje roční přírůstky v grafu FindsSummary.
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
COMMENTNEXTPřidá komentář na konec následující tabulky nebo grafu
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.
SPLITdefinuje počet bloků statistik, které budou zařazeny vedle sebe (viz také WIDTHNEXT).
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.
INCLUDEHTML kódová_stránka URL

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.
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.
FindsByTypeTableZobrazí tabulku s histogramem podle počtu nálezů jednotlivých typů keší.
FindsByTypeTable Nadpis
FindsByTypePieZobrazí koláčový graf s počtem nálezů jednotlivých typů keší.
FindsByTypePie 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ě.

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.)

HIDEYEARSdefinuje roky, které se nebudou zobrazovat v tabulce podle měsíců
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)
MyOwnCustomizedList
MyOwnCustomizedLis 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

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
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.
MyFindsByFindersTable
MyFindsByFindersTable Nadpis
Zobrazí tabulku kačerů, kteří nalezli vlastní keše autora (nebo autorů definovaných příkazy CACHER, MYCACHESOWNER).
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.

MyFindsByLogTypeTable
MyFindsByLogTypeTable Nadpis
Zobrazí tabulku s histogramem podle počtu typů logů vlastních keší.
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.