Šablona:Navbox/dokumentace

Tato šablona slouží k vytvoření horizontálních navigačních šablon.

Použití

Zatím jsou použity anglické názvy parametrů a některých jejich možných hodnot. Jejich významy jsou vysvětleny v této dokumentaci.

{{Navbox
|jméno = {{subst:PAGEjméno}}
|název = 
|obrázek = 
|obrázekvlevo =

|primární barva = 
|sekundární barva =

|nad = 

|skupina1 = 
|seznam1 = 

|skupina2 = 
|seznam2 = 
 …
|skupina20 = 
|seznam20 = 

|pod = 
}}

Seznam parametrů

Všechny parametry této šablony obsahují jen malá písmena. Povinné parametry jsou jméno (název) a název (nadpis). Pokud jsou vynechány další parametry, vytvoří se jednořádková navigační šablona.

Všimněte si, že parametry skupina1 (skupina1) a další jsou nepovinné. Stejně tak nepovinné jsou parametry nad (nad) a pod (pod).

Základní a nejpoužívanější parametry jsou následující (úplný seznam je níže):

jméno - název navigační šablony.

název - nadpis, text v záhlaví navigační šablony. Například: [[Dědičné metabolické poruchy]].

obrázek - Obrázek na pravé straně navigační šablony, například [[Soubor:XX.jpg|90px|Popisek obrázku]]. Nezapomeňte na výstižný popisek obrázku.

obrázekvlevo - Obrázek na levé straně navigační šablony.

primární barva - Barva pozadí pro všechno kromě seznamů

sekundární barva - Barva pozadí pro seznamy

nad - Text, který se objeví nad částí se skupinami a výčty, například seznam nějakých obecných wikilinků.

seznamn - Výčet s číslem n. Obvykle obsahuje seznam pojmů oddělených puntíkem (•).

například [[Dědičné metabolické poruchy]] (DMP) • [[Dědičné metabolické poruchy malých molekul|DMP malých molekul]] • [[Dědičné metabolické poruchy komplexních molekul|DMP komplexních molekul]] • [[Vyšetřovací metody u DMP]] • [[Novorozenecký screening]] • [[Skrínink dědičných chorob]]

skupinan - Text na levé straně před výčtem s číslem n. Pokud je vynechán, výčet začíná zcela vlevo.

pod - Text, který se objeví pod částí se skupinami a výčty.

Další detaily a omezení jsou vysvětleny v oddílu Popis parametrů. Další možná rozložení naleznete v oddílu Rozložení.

Popis parametrů

V tomto oddíle naleznete úplný seznam parametrů šablony {{Navbox}}. Ve většině případů je nutné vyplnit pouze parametry jméno, název a seznam1.

Běžné nastavení

jméno (název)

border (rámeček)

Pokud je tento parametr nastaven na hodnotu none (nic), navigační šablona může být použita uvnitř nějakého jiného kontejneru (například obecné tabulky).

Pokud je tento parametr nastaven na jakoukoli jinou hodnotu, výsledkem bude výchozí chování, tedy navigační šablona bude mít okraj s mezerou.

Jednotlivé části

název (název)

Nadpis je text, který se objeví v záhlaví celé šablony. Obvykle je dostatečným popisem obsahu šablony. Nadpis je obyčejně jednořádkový.

Po technické stránce není tento parametr povinný, ale bez něj nemá navigační šablona smysl.

seznam_n (výčet_n)

Popis se týká řady parametrů, jejichž název se liší jen číslem, t. j. seznam1, seznam2, atd…; n může být nejvýše 20.

Hodnoty těchto parametrů jsou samotným tělem šablony, obvykle tedy výčtem nějakých položek, většinou odkazů. Je nutno uvést alespoň jeden parametr seznam, aby šablona měla nějaký obsah. Každý další seznam je dalším řádkem tabulky. Ke každému seznam_n může existovat parametr skupina_n, viz níže.

skupina_n (skupina_n)

Popis se týká řady parametrů, jejichž název se liší jen číslem, t. j. skupina1, skupina2, atd…; n může být nejvýše 20.

Pokud je některý z těchto parametrů vyplněn, zobrazí nalevo od výčtu buňka, která popisuje daný výčet. Pokud je pro daný výčet tento parametr vynechán, zobrazí se výčet přes celou šířku navigační šablony.

obrázek (obrázek)

Hodnota parametru je odkaz na obrázek, který se zobrazí napravo od výčtů. Aby se obrázek správně zobrazil, musí být definován parametr seznam1.

Parametr může obsahovat běžný wikikód, například

obrázek = [[obrázek:Example.jpg|100px|Popis obrázku]]

Nezapomínejte na popis obrázku, je důležitou součástí obrázku.

obrázekvlevo (levý obrázek)

Hodnota parametru je odkaz na obrázek, který se zobrazí nalevo od výčtů a skupin. Aby se obrázek správně zobrazil, musí být definován parametr seznam1.

Parametr může obsahovat běžný wikikód, například

obrázekvlevo = [[obrázek:Example.jpg|100px|Popis obrázku]]

Nezapomínejte na popis obrázku, je důležitou součástí obrázku.

primární barva (primární barva)

HEX kód nebo rezervovaný název barvy pro zabarvení pozadí hlavičky, patičky a levého sloupce navboxu.

sekundární barva (sekundární barva)

HEX kód nebo rezervovaný název barvy pro zabarvení pozadí pravého sloupce navboxu.

nad (nad)

Pomocí tohoto parametru se dá vytvořit úvodní položka navigační šablony nad všemi skupinami, výčty a obrázky. Může se hodit pro podnapis nebo uvození obsahu samotné šablony. Její text se zobrazí přes celou šířku navigační šablony.

pod (pod)

Pomocí tohoto parametru se dá vytvořit koncová položka (zápatí) navigační šablony pod všemi skupinami, výčty a obrázky. Může se hodit pro vysvětlivky nebo poznámky k obsahu samotné šablony. Její text se zobrazí přes celou šířku navigační šablony.

Pokročilé parametry

evenodd [swap, even, odd] (sudý lichý [prohoď, sudý, lichý])

Pokud je hodnota tohoto parametru swap (prohoď), prohodí se styly sudých a lichých výčtů. Obvykle sudé jsou trochu tmavší, tato hodnota je udělá světlejšími.

Pokud je hodnota tohoto parametru even (sudý) nebo odd (lichý), všechny výčty budou mít pozadí jako sudé, resp. jako sudé výčty.

Rozložení

V tomto oddíle jsou příklady základních možností, která má uživatel této šablony při výběru jejích prvků.

Navbox s parametry obrázek, nad a pod:

Navbox s parametry obrázek, nad a pod:

Navbox s parametry obrázek, obrázekvlevo, seznam a bez skupina, nad, pod:

Příklady

Bez obrázku

{{Navbox
|jméno  = Navbox/dokumentace
|název = [[Dědičné metabolické poruchy]]
|skupina1 = '''[[Dědičné poruchy metabolizmu aminokyselin|DMP AMK]]''', '''[[Organické acidurie]]''', '''[[Dědičné poruchy metabolizmu cyklu močoviny|DMP cyklu močoviny]]'''
|seznam1 = [[Fenylketonurie]] • [[Tyrosinémie]] • [[Alkaptonurie]] • [[Leucinóza]] • [[Isovalerová acidurie]] • [[Cystinóza]] • [[Glutarová acidurie]] • [[Deficit prolidázy]] • [[Hyperornitinémie]] • [[Neketotická hyperglycinémie]] • [[Deficit ornitin transkarbamylázy]]
|skupina2 = '''[[Dědičné metabolické poruchy metabolismu propionátu, biotinu, kobalaminu|DMP propionátu, biotinu, kobalaminu]]'''
|seznam2 = [[Propionová acidémie]] • [[Methylmalonová acidémie]] • [[Deficit biotinidázy]]
}}

S nastavenými barvami

{{Navbox
|jméno = Navbox/dokumentace
|název = [[Dědičné metabolické poruchy]]
|primární barva = #e494fc
|sekundární barva = #eec2fc
|skupina1 = '''[[Dědičné poruchy metabolizmu aminokyselin|DMP AMK]]''', '''[[Organické acidurie]]''', '''[[Dědičné poruchy metabolizmu cyklu močoviny|DMP cyklu močoviny]]'''
|seznam1 = [[Fenylketonurie]] • [[Tyrosinémie]] • [[Alkaptonurie]] • [[Leucinóza]] • [[Isovalerová acidurie]] • [[Cystinóza]] • [[Glutarová acidurie]] • [[Deficit prolidázy]] • [[Hyperornitinémie]] • [[Neketotická hyperglycinémie]] • [[Deficit ornitin transkarbamylázy]]
|seznam2 = '''[[Dědičné metabolické poruchy metabolismu propionátu, biotinu, kobalaminu|DMP propionátu, biotinu, kobalaminu]]'''
|skupina2 = [[Propionová acidémie]] • [[Methylmalonová acidémie]] • [[Deficit biotinidázy]] 
}}

S obrázkem, bez skupin

{{Navbox
|jméno  = Navbox/dokumentace
|název = [[Dědičné poruchy metabolizmu lysozomů]]
|obrázek = [[Soubor:Morbus Fabry kidney biopsy 02.jpg|60px|Fabryho choroba postihující gangliové buňky]]
|seznam1 = [[Mukolipidóza]] II • [[Mukopolysacharidóza]] III • [[Gaucherova choroba]] • [[Fabryho choroba]] • [[Niemann-Pickova choroba]] • 
[[Krabbeho choroba]] • [[Metachromatická leukodystrofie]] • [[Danonova choroba]] • [[Cystinóza]]
}}

S dvěma obrázky, bez skupin, s dvěma výčty

{{Navbox
|jméno  = Navbox/dokumentace
|název = [[Dědičné poruchy metabolizmu]]
|obrázek = [[Soubor:Morbus Fabry kidney biopsy 02.jpg|60px|Fabryho choroba postihující gangliové buňky]]
|obrázekvlevo = [[Soubor:Morbus Fabry kidney biopsy 02.jpg|60px|Biopsie ledvin - Fabryho choroba]]
|seznam1 = [[Mukolipidóza]] II • [[Mukopolysacharidóza]] III • [[Gaucherova choroba]] • [[Fabryho choroba]] • [[Niemann-Pickova choroba]] • 
[[Krabbeho choroba]] • [[Metachromatická leukodystrofie]] • [[Danonova choroba]] • [[Cystinóza]]
|seznam2 = [[Deficit fruktoaldolázy]] • [[Deficit fruktóza-1,6-bisfofatázy]] • [[Esenciální fruktosurie]] • [[Deficit galaktóza-1-fosfát uridyltransferázy]] • [[Deficit galaktokinázy]] • [[Glykogenózy]]
}}

S obrázkem, skupinami, nad a pod

{{Navbox
|jméno  = Navbox/dokumentace
|název = [[Dědičné poruchy metabolizmu]]
|nad = [[Dědičné poruchy]]
|obrázek = [[Soubor:Morbus Fabry kidney biopsy 02.jpg|60px|Fabryho choroba postihující gangliové buňky]]
|skupina1 = [[Dědičné poruchy metabolizmu lysozomů]]
|seznam1 = [[Mukolipidóza]] II • [[Mukopolysacharidóza]] III • [[Gaucherova choroba]] • [[Fabryho choroba]] • [[Niemann-Pickova choroba]] • [[Krabbeho choroba]] • [[Metachromatická leukodystrofie]] • [[Danonova choroba]] • [[Cystinóza]]
|skupina2 = '''[[Mitochondriální onemocnění|Dědičné metabolické poruchy mitochondrií]]'''
|seznam2 = [[Leighův syndrom]] • [[Chronická progresivní externí oftalmoplegie]] • [[Syndrom Kearns-Sayre]] • [[Leberova hereditární optická neuropatie]] • [[Maternálně dědičný diabetes a hluchota]] • [[Deficit pyruvát dehydrogenázy]] • [[Deficit pyruvát karboxylázy]] • [[Deficit fosfoenolkarboxykinázy]] • [[Deficit VLCAD]] • [[Deficit MCAD]] • [[Deficit SCAD]] • [[Deficit LCHAD]]
|pod = [[Portál:Patobiochemie]]
}}

Vnořené navboxy

Navigační šablona může obsahovat vnořené navboxy. U vnořeného navboxu je potřeba definovat první nepojmenovaný parametr jako „potomek“ (potomek). Jednoduchý kód pak může vypadat následovně:

{{Navbox
|jméno = {{subst:PAGEjméno}}
|název = Nadpis
...parametry vnějšího navboxu...
|seznam1 = {{Navbox|potomek
   ...parametry vnořeného navboxu...
 }}
...zde pokračují parametry vnějšího navboxu
}}

Příklad vnořeného navboxu

V tomto oddíle naleznete příklady s vnořenými navboxy. Všimněte si, že parametr evenodd (sudý lichý) je použit pro prohození pruhů v některých vnořených navboxech.

{{Navbox
|jméno = Navbox/dokumentace
|obrázek = 
|název = Příklad s několika vnořenými navboxy
|nad = nad
|pod = pod

|skupina1 = skupina1
|seznam1 = seznam1
|skupina2 = skupina2
|seznam2 = 
 {{Navbox|potomek
  |evenodd = swap
  |skupina1 = skupina1 vnořeného
  |seznam1 = seznam1 vnořeného
  |skupina2 = skupina2 vnořeného
  |seznam2 = seznam2 vnořeného
  |skupina3 = skupina3 vnořeného
  |seznam3 = seznam3 vnořeného
 }}

|skupina3 = skupina3
|seznam3 = seznam3

|skupina4 = skupina4
|seznam4 = 
 {{Navbox|potomek
  |evenodd = swap
  |skupina1 = skupina1 druhého vnořeného
  |seznam1 = seznam1 druhého vnořeného
  |skupina2 = skupina2 druhého vnořeného
  |seznam2 = seznam2 druhého vnořeného
  |skupina3 = skupina3 druhého vnořeného
  |seznam3 = seznam3 druhého vnořeného
 }}
}}

Zdroj a technické detaily

• Tato šablona byla včetně většiny dokumentace převzata z české Wikipedie 9.8.2014, originál vizte zde.
• Třídy CSS definující vzhled navboxu si můžete prohlédnout na MediaWiki:common.css