Modul:Diagram/Dokumentace

Modul Diagram poskytuje dvě funkce: sloupcový diagram a koláčový diagram.

Vykreslení sloupcového diagramu: "sloupcovy"[editovat zdroj]

Parametry[editovat zdroj]

název parametru	co dělá
delimiter	Řetězec, který bude použit k oddělování jednotlivých hodnot. Implicitně je nastavena dvojtečka (:). Obvykle není třeba nastavovat uživatelskou hodnotu, nastavení je však užitečné pro případ, že byste chtěli použít dvojtečku jako součást některého z parametrů.
sirka	Šířka diagramu v pixelech. Je-li uvedena, minimální hodnota je 200. implicitně: 500
vyska	Výška diagramu v pixelech. je-li uvedena, minimální hodnota je 200. implicitně: 350
skupina n	(kde "n" je číslo; použitím parametrů "skupina 1", "skupina 2" atd. vytvoříte tolik skupin, kolik je jich v grafu zapotřebí) Hodnoty, které mají být v diagramu zobrazeny. viz dále.
tooltip n	tooltip, Který bude připojen k příslušnému sloupci. Jestliže sloupec nemá definovaný tooltip a má odkaz, bude tento odkaz použit jako tooltip. Není-li tomu tak, tooltip bude vytvořen pomocí kombinace názvu skupiny a hodnoty, případně doplněné o "jednotky před" a "jednotky za".
odkazy n	Odkazy na články, které mají být propojené s jednotlivými sloupci
na sobe	Zda umístit sloupce jednotlivých skupin nad sebe. Není-li parametr definován, zobrazí se sloupce vedle sebe. Jakákoli neprázdná hodnota znamená "ano". Umístění nad sebe zakážete tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
spojeny tooltip	Použitelné v kombinaci s parametrem "na sobe": Je-li nastavena hodnota true, tooltip bude zobrazovat akumulovanou hodnotu všech bloků až po aktuální.
barvy	Barvy použité pro označení jednotlivých skupin. Musí mít přesně stejný počet hodnot, jako je počet skupin. Barvy mohou být zadány standardními názvy barev použitelnými v html, nebo ve formátu #xxx nebo #xxxxxx.
legenda x	Legenda pro jednotlivé hodnoty na ose x. Lze použít formátování Wiki, jako interní odkazy nebo šablony.
skryt popis skupin	Je-li nastavena hodnota true, popisky ke skupinám pod diagramem nebudou zobrazeny. Jakákoli neprázdná hodnota znamená "ano". Zobrazení přikážete tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
oddelene stupnice	Nastavení parametru způsobí použití oddělených stupnic v ose y pro každou ze skupin. Prázdná hodnota způsobí použití jedné stupnice pro všechny skupiny. Nelze použít v kombinaci s parametrem "na sobe". Pozor: je-li tento parametr nastaven, stupnice budou vykresleny odděleně i v případě, že některé ze stupnic budou zcela identické. Jakákoli neprázdná hodnota znamená "ano". Společnou stupnici nastavíte tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
jednotky pred	Prefix jednotky, který se zobrazí v tooltipu. Např. použití "$" způsobí, že hodnoty se budou v tooltipu zobrazovat jako "$500", a ne pouze "500".
jednotky za	Totéž pro sufix jednotky. Např. použití "Kg" způsobí, že hodnoty se budou v tooltiup zobrazovat jako "88Kg", a ne jako "88". Podtržítko ("_") je nahrazeno mezerou; takto lze vložit mezeru mezi hodnotu a sufix.
nazvy skupin	Názvy jednotlivých skupin.

Vykreslení koláčového diagramu: "kolacovy"[editovat zdroj]

Parametery[editovat zdroj]

název parametru	co dělá
oddelovac	Řetězec, který bude použit k oddělování jednotlivých hodnot. Implicitně je nastavena dvojtečka (:). Obvykle není třeba nastavovat uživatelskou hodnotu, nastavení je však užitečné pro případ, že byste chtěli použít dvojtečku jako součást některého z parametrů.
polomer	číslo. Poloměr koláče v pixelech
sektory	uspořádané čtveřice zobrazovaných dat uzavřené v závorce. Jednotlivé prvky čtveřice oddělujte pomocí oddělovače definovaného v parametru delimiter: `( hodnota1 : název1 : barva1 : odkaz1 ) ( hodnota2 : název2 : barva2 : odkaz2 ) ...` "Hodnota" je číslo. Lze použít celá čísla, desetinné zlomky (oddělené desetinnou tečkou) nebo vědecký zápis: číslo "sedm milionů dvě stě čtyřicet tisíc" lze zapsat jako `7.24e6, 7240000` nebo `7240000.00`. "Název" je řetězec. "Barva" je nepovinný údaj. Lze použít všechny webové barvy, jako `red` nebo `#FF0000`. 26 barev je nadefinováno implicitně; pokud váš diagram obsahuje více než 26 výsečí, musíte definovat barvy pro výseče č. 27 a vyšší. "Odkaz" může být externí nebo interní, včetně odkazů na interní kotvy a odstavce v tomtéž článku. Příklad: `[[Článek\|Text odkazu]]` vytvoří odkaz na článek, `[[#Nadpis odstavce\|Text odkazu]]` vytvoří odkaz na kotvu v tomtéž článku, `[http://example.org Text odkazu]` vytvoří externí odkaz.
sektor n	alternativní zápis pro `sektory`. n je číslo výseče, počítáno od 1. Nelze vynechávat čísla; pokud nadefinujete `sektor 1, sektor 2, sektor 4, sektor 5 ...` a přeskočíte `sektor 3`, budou zobrazeny pouze první dvě výseče. Tento zápis je neslučitelný s použitím parametru `sektory`, tzn. že by neměly být použity oba parametry v jednom volání modulu. Použití parametrů `sektory` and `sektor n` v jednom volání může způsobit nepředvídatelné výsledky. Hodnotou parametru `sektor n` je uspořádaná čtveřice, jak byla popsána výše, ale bez závorek: \| sektor 1 = Hodnota1 : Název1 : Barva1 : Odkaz1 \| sektor 2 = Hodnota2 : Název2 : Barva2 : Odkaz2 \| ... Tento zápis umožňuje použít závorky v názvech, odkazech a definicích barev.
procenta	Je-li použito, je vypočítaná procentuální hodnota každé výseče připojena k legendě. Zadáte-li např. dvě výseče `( 1 : mláďata ) ( 3 : dospělí )` a použijete parametr `procenta`, v legendě se zobrazí „mláďata: 1 (25 %)“ a „dospělí: 3 (75 %)“; bez použití parametru `procenta` se zobrazí pouze „mláďata: 1“ a „“dospělí: 3. Jakákoli neprázdná hodnota znamená "ano". Zobrazení procent zakážete tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
jednotky pred	Prefix jednotky, který se zobrazí v tooltipu. Např. použití "$" způsobí, že hodnoty se budou v tooltipu zobrazovat jako "$500", a ne pouze "500".
jednotky za	Totéž pro sufix jednotky. Např. použití "Kg" způsobí, že hodnoty se budou v tooltiup zobrazovat jako "88Kg", a ne jako "88". Podtržítko ("_") je nahrazeno mezerou; takto lze vložit mezeru mezi hodnotu a sufix.
skryt popis skupin	Nastavení tohoto parametru zabrání zobrazení legendy ke skupinám pod diagramem. Jakákoli neprázdná hodnota znamená "ano". Zobrazení přikážete tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
zahlavi	Zobrazí se jako nadpis nad diagramem a legendou.
float	obtékání diagramu. Lze použít hodnoty `right`, `left` nebo `none`. Hodnota `right` umístí diagram vpravo, text bude obtékat zleva. Hodnota `left` umístí diagram vlevo, text bude obtékat zprava. Hodnota `none` nebo vynechání parametru způsobí, že diagram se zobrazí vlevo, ale text bude pokračovat až za diagramem a legendou.

Příklady[editovat zdroj]

{{#invoke:Diagram|kolacovy
| polomer = 150
| sektory = 
    ( 1000000 : jablka ) 
    ( 2000000 : banány  : gold) 
    ( 1440000 : meruňky ) 
    ( 6.4e5 : hrušky : : [[Hruška|hrušky]] )
    ( 750000 : ananasy )
| jednotky za = _t
| procenta = zobraz
}}

Všimněte si, že je možné ponechat barvu nedefinovanou (bude použita implicitní hodnota), ale chceme-li přidat odkaz na "hrušku", musíme naznačit chybějící část parametru tím, že přidáme navíc jeden oddělovač.

Všiměte si také, že hodnoty je možné zadávat v prostém formátu nebo ve vědeckém zápisu (jako 6.4e5); v legendě se čísla vždy zobrazí ve formátu podle jazyka nastaveného v příslušné wiki.

jablka: 1 000 000 t (17.2 %)
banány: 2 000 000 t (34.3 %)
meruňky: 1 440 000 t (24.7 %)
hrušky: 640 000 t (11.0 %)
ananasy: 750 000 t (12.9 %)

Příklad alternativní syntaxe pomocí "sektor 1", "sektor 2" atd.

{{#invoke:Diagram|kolacovy
| polomer = 200
| jednotky za = _ks
| sektor 1 = 1 : 1
| sektor 2 = 7 : 7
| sektor 3 = 8 : 8
| sektor 4 = 9 : 9
| sektor 5 = 10 : 10
| sektor 6 = 11 : 11
| sektor 7  = 12 : 12
| sektor 8  = 13 : 13
| sektor 9  = 14 : 14
| sektor 10 = 15 : 15
| sektor 11 = 16 : 16
| sektor 12 = 17 : 17
| sektor 13 = 18 : 18
| sektor 14 = 19 : 19
| sektor 15 = 20 : 20
| sektor 16 = 21 : 21
| sektor 17 = 22 : 22
| sektor 18 = 23 : 23
| sektor 19 = 24 : 24
| sektor 20 = 25 : 25
| sektor 21 = 26 : 26
| sektor 22 = 27 : 27
| sektor 23 = 28 : 28
| sektor 24 = 29 : 29
| sektor 25 = 30 : 30
| sektor 26 = 31 : 31
| procenta = true
}}

1: 1 ks (0.2 %)
7: 7 ks (1.5 %)
8: 8 ks (1.7 %)
9: 9 ks (1.9 %)
10: 10 ks (2.1 %)
11: 11 ks (2.3 %)
12: 12 ks (2.5 %)
13: 13 ks (2.7 %)
14: 14 ks (2.9 %)
15: 15 ks (3.2 %)
16: 16 ks (3.4 %)
17: 17 ks (3.6 %)
18: 18 ks (3.8 %)
19: 19 ks (4.0 %)
20: 20 ks (4.2 %)
21: 21 ks (4.4 %)
22: 22 ks (4.6 %)
23: 23 ks (4.8 %)
24: 24 ks (5.0 %)
25: 25 ks (5.3 %)
26: 26 ks (5.5 %)
27: 27 ks (5.7 %)
28: 28 ks (5.9 %)
29: 29 ks (6.1 %)
30: 30 ks (6.3 %)
31: 31 ks (6.5 %)

Odkazy[editovat zdroj]

V tomto článku byl použit překlad textu z článku Module:Chart/doc na anglické Wikipedii.

Modul:Diagram/Dokumentace

Vykreslení sloupcového diagramu: "sloupcovy"[editovat zdroj]

Parametry[editovat zdroj]

Příklady[editovat zdroj]

Základní[editovat zdroj]

Na sobě[editovat zdroj]

Oddělené stupnice[editovat zdroj]

Vykreslení koláčového diagramu: "kolacovy"[editovat zdroj]

Parametery[editovat zdroj]

Příklady[editovat zdroj]

Odkazy[editovat zdroj]