Šablona:Infobox/doc

__EXPECTED_UNCONNECTED_PAGE__

Infobox může být použit jako kostra k vytvoření vertikální šablony obsahující různé položky s hodnotami.

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:Vytvoření infoboxu pro obecné informace o tvorbě infoboxů.

Použití

Šablona se používá podobně jako {{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 {{subst:PAGENAME}}. Pokud je tento parametr vynechán, odkazy nebudou zobrazeny.

Titulek

(zbytek infoboxu bude zde)

(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ř. [[Soubor:Příklad.jpg|200px|alt=Ukázkový alternativní text]]. Obrázek je ve výchozím nastavení vycentrován.

popisek1, popisek2

Text, umístěný pod obrázky, nejlépe jejich popis.

nadpis_n

Text, jenž má být použít jako nadpis v řádku n.

popis_n

Text, jenž má být použit jako popis v řádku n.

data_n

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 font-size:large;, protože je většinou používán pro nadpisy. Pokud chcete použít normální velikost písma, použijte font-size:medium;.

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 buňky řádku_n

Aplikuje se na buňky nadpisy v řádku n nebo na buňky s popisy a daty v řádku n.

styl řádku_n

Aplikuje se na buňky s popisy a daty v řádku n.

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_n

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:

|třída těla = vcard

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

|třída1 = fn
|třída2 = org
|třída3 = tel

…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:

<syntaxhighlight lang="wikitext"> |popis5 = Populace |data5 = </syntaxhighlight>

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'":

<syntaxhighlight lang="wikitext"> |popis6 = Hmotnost |data6 = </syntaxhighlight>

Pro více informací o konstrukcích #if se podívejte 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:

<syntaxhighlight lang="wikitext"> </syntaxhighlight>

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

Další parametry

název kurzívou

S použitím specifického parametru je možné pomocí infoboxu automaticky zapisovat názvy článků kurzívou (vizte zápis parametru níže). Je však nutné upozornit na to, že je použití v článcích ošetřeno doporučením a radami, více informací se nachází v dokumentaci šablony.

<syntaxhighlight lang="wikitext"> </syntaxhighlight>

automatické nadpisy

Pokud požadujeme, aby se nadpis zobrazil při vyplnění kterékoliv z následujících položek pod ním (tj. alespoň jednoho parametru data# před příštím parametrem nadpis#, existuje-li), můžeme využít specifického parametru |automatické nadpisy=. Není tedy nutné nadpis obalovat podmínkou s výpisem jednotlivých položek, stačí na začátek infoboxu vložit daný parametr a následně podmínku u nadpisu vynechat.

<syntaxhighlight lang="wikitext"> </syntaxhighlight>

Pozor, v případě, že plánujete zobrazovat položku v infoboxu nezávisle na nadpisu, avšak nadpis se nad ní nachází, je nutné vložit další nadpis s hodnotou _BLANK_, jinak se bude původní nadpis zobrazovat i u této položky.

<syntaxhighlight lang="wikitext"> </syntaxhighlight>

bez kategorie

Parametr je při výchozím nastavení nevyplněn. V případě jeho vyplnění („ano“) není článek řazen do údržbových kategorií chybné navržení a embedded infobox, pokud je infobox špatně navržen.

dceřiný

Pokud je parametr v infoboxu povolen („ano“, výchoze povolen není), je následně možné infobox vložit do jiného infoboxu (vkládá se do parametru dat). Na příkladu můžete vidět, že první infobox vytváří uvnitř hlavního infoboxu standardní strukturu, nicméně druhý s vyplněným dceřiným parametrem se hlavnímu infoboxu přizpůsobí.

data 1. položky

data 2. položky

<syntaxhighlight lang="wikitext">

data 1. položky

data 2. položky

</syntaxhighlight>

Příklady

Data definovaná samostatně

Všechny tři definovány (data)

Popis a data definována (data)

<syntaxhighlight lang="wikitext">

Data definovaná samostatně

Všechny tři definovány (data)

Popis a data definována (data)

</syntaxhighlight>

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.

V následujícím příkladu byly nastaveny parametry bodystyle = width:20em; a labelstyle = width:33%;

Data 1

Data 2

Data 3

Data 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

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

<syntaxhighlight lang="wikitext"> </syntaxhighlight>

Související šablony

• Soubox – kostra vertikálních navigačních šablon neobsahujících měnitelné položky
• Navbox – kostra horizontálních navigačních šablon vkládaných na konec článku

Data šablony

Tato sekce obsahuje strukturovaný popis parametrů této šablony využívající rozšíření TemplateData, který umožňuje snadnější používání této šablony v prostředí Vizuálního editoru.

Infobox

Bez popisu.

Parametry šablony

Tato šablona upřednostňuje parametry formátované v bloku.

Parametr		Popis	Typ	Stav
Nebyly uvedeny žádné parametry