Editace stránky Šablona:Infobox/doc

{{Podstránka s dokumentací}}
<!--
    KATEGORIE a INTERWIKI prosím přidejte až na spodek této stránky
-->

Tato šablona je meta šablona, tedy šablona, která se používá pro vytváření jiných šablon a není určena k přímému vkládání do článků. Podívejte se na [[Nápověda:Infobox]] pro obecné informace o tvorbě infoboxů.

== Použití ==
Šablona se používá podobně jako {{Šablona|navbox}}, jen s menšími rozdíly. Každý řádek tabulky může být buď nadpis nebo pár popis/data anebo jen buňka s daty. Toto jsou vzájemné stavy, takže když definujete nadpis a zároveň pár popis/data, bude pár popis/data potlačen.

== Parametry ==
=== Odkazy zobrazit/diskuse/editovat ===
; název
: Název šablony, na kterou mají odkazy "zobrazit/diskuse/editovat" odkazovat. Můžete použít <tt><nowiki>{{subst:PAGENAME}}</nowiki></tt>. Pokud je tento parametr vynechán, odkazy nebudou zobrazeny.

=== Titulek ===
{{Infobox
|titulek    = Text jako nadpis nad infoboxem
|podzáhlaví = Podzáhlaví infoboxu
|data1      = (zbytek infoboxu bude zde)
}}
{{Infobox
|záhlaví     = Záhlaví infoboxu
|podzáhlaví  = Podzáhlaví infoboxu
|podzáhlaví2 = 2. podzáhlaví infoboxu
|data1       = (zbytek infoboxu bude zde)
}}

Existují dva způsoby, jak umístit titulek do infoboxu. Jeden umístí titulek nahoru do infoboxu, druhý nad infobox. Pokud chcete, můžete použít oba dva zároveň nebo jen jeden z nich nebo žádný (nedoporučujeme).

; titulek
: Text, který má být jako nadpis nad šablonou.
; záhlaví
: Text, který má být nahoře v infoboxu.

=== Volitelný obsah ===
; podzáhlaví, podzáhlaví2
: Přídavná pole, umístěná pod záhlavím, nad zbytkem infoboxu.
; obrázek, obrázek2
: Obrázky, které mají být nahoře v infoboxu, pod záhlavím (resp. podzáhlavím). Používejte úplnou syntaxi, např. <tt><nowiki>[[Soubor:Příklad.jpg|200px|alt=Ukázkový alternativní text]]</nowiki></tt>. Obrázek je ve výchozím nastavení vycentrován.
; popisek1, popisek2
: Text, umístěný pod obrázky, nejlépe jejich popis.
; nadpis<sub>n</sub>
: Text, jenž má být použít jako nadpis v řádku ''n''.
; popis<sub>n</sub>
: Text, jenž má být použit jako popis v řádku ''n''.
; data<sub>n</sub>
: Text, jenž má být použit jako data v řádku ''n''.
; zápatí
: Text, jenž má být umístěn v zápatí infoboxu. Zápatí je určeno pro poznámky, související články, apod.

=== Volitelné stylování ===
; styl těla
: Aplikuje se na infobox jako celek.
; styl titulku
: Aplikuje se pouze na titulek. Přidání barvy pozadí je většinou nevhodné, neboť je text vně infoboxu.
; styl záhlaví
: Aplikuje se pouze na záhlaví. Výchozí styl je <tt>font-size:large;</tt>, protože je většinou používán pro nadpisy. Pokud chcete použít normální velikost písma, použijte <tt>font-size:medium;</tt>.
; styl obrázku
: Aplikuje se na buňku, v níž je obrázek umístěn, včetně popisku obrázku.
; styl popisku
: Aplikuje se na popisek obrázku.
; styl nadpisů
: Aplikuje se na všechny buňky s nadpisy.
; styl popisů
: Aplikuje se na všechny buňky s popisy.
; styl dat
: Aplikuje se na všechny buňky s daty.
; styl zápatí
: Aplikuje se pouze na zápatí.

=== Mikroformáty ===
; třída těla
: Tento parametr je vložen do atributu "class" infoboxu jako celku.
; třída titulku
: Tento parametr je vložen do atributu "class" titulku infoboxu.
; třída záhlaví
: Tento parametr je vložen do atributu "class" záhlaví infoboxu.
; třída obrázku
: Tento parametr je vložen do atributu "class" obrázku.
; třída<sub>n</sub>
: Tento parametr je vložen do atributu "class" daného řádku. Pokud řádek nemá buňku s daty, tento parametr se nijak neprojeví.
; třída zápatí
: Tento parametr je vložen do atributu "class" zápatí infoboxu.

Tato šablona podporuje přidání mikroformátových informací. Toho může být docíleno přidělením parametrů "třída", označujících druh obsažených informací, různým datovým buňkám. K označení infoboxu obsahujícího informace typu hCard, přidejte následující parametr:

<pre>
|třída těla = vcard
</pre>

A pro každý řádek s datovou buňkou, která je součástí vcard použijte odpovídající parametr "třída":

<pre>
|třída1 = fn
|třída2 = org
|třída3 = tel
</pre>

…a tak dále. Záhlaví a titulku mohou být také přiděleny třídy, neboť tyto jsou většinou použity pro uvedení názvu předmětu infoboxu.

=== Vytváření volitelných polí ===
Řádek s definovaným popisem, ale bez dat nebude zobrazen. Toto umožňuje snadné vytváření volitelných řádků v infoboxu. Pro vytvoření volitelného řádku použijte parametr, jenž má výchozí hodnotou prázdný řetězec, například:

<pre>
|popis5 = Populace
|data5  = {{{populace|}}}
</pre>

Takto, pokud článek v infoboxu nedefinuje parametr "populace", nebude řádek zobrazen.

Při složitějších polích s předformátovaným obsahem, který by se zobrazil, i kdyby nebyl parametr nastaven, můžete celou datovou buňku "zabalit" do konstrukce "#if:", aby se buňka nezobrazila, pokud nebude parametr použit. Například konstrukce "#if:" v následujícím příkladu se čte jako "pokud byl parametr hmotnost nastaven, zobraz jeho obsah následovaný textem 'kg'":

<pre>
|popis6 = Hmotnost
|data6  = {{#if:{{{hmotnost|}}}|{{{hmotnost}}} kg}}
</pre>

Pro více informací o konstrukcích #if se podívejte [[mw:Help:Extension:ParserFunctions##if:|sem]].

Podobným způsobem můžete vytvořit i volitelné nadpisy. Pokud chcete nadpis zobrazit, pouze pokud jsou jedna či více datových buněk pod něj spadajících definovány, můžete použít následující příklad jako ukázku, jak na to:

<pre>
{{Infobox
|název   = {{subst:PAGENAME}}
|titulek = Ukázka volitelného nadpisu
|nadpis1 = {{#if:{{{položka1|}}}{{{položka2|}}}{{{položka3|}}}|Volitelný nadpis}}
|popis2  = Položka jedna
|data2   = {{{položka1|}}}
|popis3  = Položka dvě
|data3   = {{{položka2|}}}
|popis4  = Položka tři
|data4   = {{{položka3|}}}
}}
</pre>

nadpis1 se zobrazí, pouze pokud je definován alespoň jeden z parametrů položka1, položka2 nebo položka3. Pokud není ani jeden z parametrů definován, nadpis nebude zobrazen.

Trik je v tom, že "#if:" vrací hodnotu nepravda (''false''), pouze pokud v podmínkové části není vůbec nic. To znamená, že podmínka if selže jen tehdy, není-li definován ani jeden z uvedených tří parametrů.

== Příklady ==
{{Infobox
|název        = Infobox/doc
|styl těla    = 
|titulek      = Testovací Infobox
|styl titulku = background:#FFFF00;

|obrázek      = [[Soubor:Příklad.jpg|200px|alt=Ukázkový alternativní text]]
|styl obrázku = 
|popisek      = Popisek pro příklad.jpg
|styl popisku = 
|styl nadpisů = background:#ccf;
|styl popisů  = background:#ddf;
|styl dat     = 

|nadpis1 = Nadpis definovaný samostatně
|popis1  = 
|data1   = 
|nadpis2 = 
|popis2  = Popis definovaný samostatně
|data2   = 
|nadpis3 =
|popis3  = 
|data3   = Data definovaná samostatně
|nadpis4 = Všechny tři definovány (nadpis)
|popis4  = Všechny tři definovány (popis)
|data4   = Všechny tři definovány (data)
|nadpis5 =
|popis5  = Popis a data definována (popis)
|data5   = Popis a data definována (data)

|styl zápatí = background:#ddf;
|zápatí      = Text v zápatí
}}

<pre style="overflow:auto">
{{Infobox
|název        = Infobox/doc
|styl těla    = 
|titulek      = Testovací Infobox
|styl titulku = 

|obrázek      = [[Soubor:Příklad.jpg|200px|alt=Ukázkový alternativní text]]
|styl obrázku = 
|popisek      = Popisek pro příklad.jpg
|styl popisku = 
|styl nadpisů = background:#ccf;
|styl popisů  = background:#ddf;
|styl dat     = 

|nadpis1 = Nadpis definovaný samostatně
|popis1  = 
|data1   = 
|nadpis2 = 
|popis2  = Popis definovaný samostatně
|data2   = 
|nadpis3 =
|popis3  = 
|data3   = Data definovaná samostatně
|nadpis4 = Všechny tři definovány (nadpis)
|popis4  = Všechny tři definovány (popis)
|data4   = Všechny tři definovány (data)
|nadpis5 =
|popis5  = Popis a data definována (popis)
|data5   = Popis a data definována (data)

|styl zápatí = background:#ddf;
|zápatí      = Text v zápatí
}}
</pre>

Všimněte si, že když je popis definován bez dat, řádek se v infoboxu nezobrazí a když jsou ve stejném řádku definovány nadpis, popis i data, zobrazí se jen nadpis.

{{clear}}
V následujícím příkladu byly nastaveny parametry {{nowrap|1=<tt>bodystyle = width:20em;</tt>}} a {{nowrap|1=<tt>labelstyle = width:33%;</tt>}}

{{Infobox
|styl těla    = width:20em;
|název        = Infobox/doc
|titulek      = Testovací Infobox
|styl titulku = 
|styl nadpisů = 
|styl popisů  = width:33%
|styl dat     = 

|nadpis1 = 
|popis1  = Popis 1
|data1   = Data 1
|nadpis2 = 
|popis2  = Popis 2
|data2   = Data 2
|nadpis3 = 
|popis3  = Popis 3
|data3   = Data 3
|nadpis4 = Nadpis 4
|popis4  = 
|data4   = 
|nadpis5 = 
|popis5  = Popis 5
|data5   = Data 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

|styl zápatí = 
|zápatí      = Text v zápatí
}}

{{clear}}

== Úplná prázdná syntaxe ==
''Poznámka: Šablona může pojmout až 85 řádků; zde je jich uvedeno pouze 20, neboť větší infoboxy jsou poměrně vzácné. Číslování si můžete rozšířit dle libosti. Mikroformátový parametr "class" (třída) je také vynechán, protože není moc používán.''

<pre style="overflow: auto;">
{{Infobox
|název        = {{subst:PAGENAME}}
|styl těla    = 
|titulek      = 
|styl titulku = 
|záhlaví      = 
|styl záhlaví = 

|styl obrázku = 
|styl popisku = 

|obrázek      = 
|popisek      = 
|obrázek2     =
|popisek2     = 

|styl nadpisů = 
|styl popisů  = 
|styl dat     = 

|nadpis1  = 
|popis1   = 
|data1    = 
|nadpis2  = 
|popis2   = 
|data2    = 
|nadpis3  = 
|popis3   = 
|data3    = 
|nadpis4  = 
|popis4   = 
|data4    = 
|nadpis5  = 
|popis5   = 
|data5    = 
|nadpis6  = 
|popis6   = 
|data6    = 
|nadpis7  = 
|popis7   = 
|data7    = 
|nadpis8  = 
|popis8   = 
|data8    = 
|nadpis9  = 
|popis9   = 
|data9    = 
|nadpis10 = 
|popis10  = 
|data10   = 
|nadpis11 = 
|popis11  = 
|data11   = 
|nadpis12 = 
|popis12  = 
|data12   = 
|nadpis13 = 
|popis13  = 
|data13   = 
|nadpis14 = 
|popis14  = 
|data14   = 
|nadpis15 = 
|popis15  = 
|data15   = 
|nadpis16 = 
|popis16  = 
|data16   = 
|nadpis17 = 
|popis17  = 
|data17   = 
|nadpis18 = 
|popis18  = 
|data18   = 
|nadpis19 = 
|popis19  = 
|data19   = 
|nadpis20 = 
|popis20  = 
|data20   = 

|styl zápatí =
|zápatí      = 
}}
</pre>
<includeonly>
<!-- KATEGORIE a INTERWIKI zde, děkujeme -->

[[Kategorie:Šablony:Infoboxy| ]]

</includeonly>