Template:Ombox/doc/cs

Toto je metašablona Ombox ([O]ther pages [m]essage [box]).

Používá se k vytváření šablon zpráv pro stránky typu Uživatel, Wikipedie, MediaWiki, Šablona, Nápověda, Portál a jakékoli nové budoucí jmenné prostory; tj. pro typy stránek, které nepokrývají Ambox, Tmbox, Imbox nebo Cmbox. Proto by se neměla používat pro rámečky pro články, diskusní stránky, obrázkové stránky nebo stránky kategorií.

Tato šablona funguje téměř přesně jako Ambox a používá stejné parametry.

Úvod
Jak je uvedeno výše, tato šablona by se měla používat pro schránky zpráv, které nejsou články, diskusní stránky, stránky s obrázky nebo stránky kategorií. Některá pole zpráv pro jiné stránky mohou nesprávně používat jednu z těchto čtyř uvedených. Neváhejte převést všechna pole zpráv použitá na "jiných stránkách" na použití této metašablony. Pokud najdete nějaké složité případy, uveďte je na diskusní stránce této šablony a získáte pomoc.

Když se tato šablona použije k vytvoření schránek zpráv na jiných stránkách, tato pole by měla obsahovat vysvětlující texty stejně jako dříve. (Stejné texty jako dříve nebo nové vylepšené texty.) Pokud jsou v rámečcích konkrétnější obrázky nebo znáte lepší obrázek, použijte je místo zde zobrazených výchozích obrázků.

Používání
Jednoduchý příklad použití:

Komplexní příklad:

Jiné typy schránek zpráv
Následující příklady používají různé parametry type, ale nepoužívají žádné parametry obrázku. Proto používají výchozí obrázky pro každý typ.

příklady
Některé příklady používající styl "upozornění".:

Parametry
Seznam všech parametrů:

type
 * Pokud není uveden žádný parametr type, šablona standardně napíše notice. To znamená, že dostane šedý okraj.

image
 * No parameter = Pokud není uveden žádný parametr image, šablona použije výchozí obrázek. Jaký výchozí obrázek použije, závisí na parametru type.
 * An image = Měl by to být obrázek s běžnou wiki notací. Šířka 40 až 50 pixelů je obvykle správná v závislosti na poměru výšky k šířce obrázku. (Ale schránka zpráv si poradí s obrázky libovolné velikosti.) Například:
 * none = Znamená, že není použit žádný obrázek.
 * none = Znamená, že není použit žádný obrázek.

imageright
 * No parameter = Pokud není zadán parametr imageright, pak se na pravé straně nezobrazí žádný obrázek.
 * An image = Měl by to být obrázek s běžnou wiki notací. Šířka 40 až 50 pixelů je obvykle správná v závislosti na poměru výšky k šířce obrázku. (Ale schránka zpráv si poradí s obrázky libovolné velikosti.) Například:
 * Anything = Jakýkoli jiný objekt, který chcete zobrazit na pravé straně.
 * Anything = Jakýkoli jiný objekt, který chcete zobrazit na pravé straně.

style
 * Volitelné hodnoty CSS používané celou tabulkou zpráv. Bez uvozovek, ale s koncovými středníky  . Například:

textstyle
 * Volitelné hodnoty CSS používané textovou buňkou. Například:

text
 * Text těla zprávy.

Small parametry
small
 * yes = Udělá z něj menší pravé plovoucí okno se zprávou. Tím se také zmenší výchozí obrázky. Všimněte si, že jakákoli data přiváděná do parametrů smallimage, smallimageright a smalltext se použijí pouze v případě, že "small=yes". Aby vaše šablona také rozuměla small parametru, můžete použít tento kód:

smallimage
 * No parameter = Pokud není uveden žádný parametr smallimage, pak tato šablona použije parametr image. Pokud je parametr image také prázdný, použije se malý výchozí obrázek.
 * An image = Měl by to být obrázek s běžnou wiki notací. Šířka 30 pixelů je obvykle správná. Například:
 * none = Znamená, že není použit žádný obrázek. Toto přepíše jakýkoli obrázek přiváděný do image, když "small=yes".
 * none = Znamená, že není použit žádný obrázek. Toto přepíše jakýkoli obrázek přiváděný do image, když "small=yes".

smallimageright
 * No parameter = Pokud není uveden žádný parametr smallimageright, pak tato šablona použije parametr imageright. Pokud je parametr imageright také prázdný, pak se na pravé straně nezobrazí žádný obrázek.
 * An image = Měl by to být obrázek s běžnou wiki notací. Šířka 30 pixelů je obvykle správná. Například:
 * Anything = Jakýkoli jiný objekt, který chcete zobrazit na pravé straně.
 * none = Znamená, že není použit žádný obrázek na pravé straně. Toto přepíše jakýkoli obrázek přiváděný do imageright, když "small=yes".
 * none = Znamená, že není použit žádný obrázek na pravé straně. Toto přepíše jakýkoli obrázek přiváděný do imageright, když "small=yes".

smalltext
 * Kratší verze textu zprávy. Pokud není zadán žádný parametr smalltext, pak se tato šablona vrátí k použití parametru text.

Technické detaily
Pokud potřebujete v parametru text použít speciální znaky, musíte je takto escapovat:

&lt;/nowiki>. A nyní pipe a koncové závorky &lt;nowiki>|}}&lt;/nowiki>. }}

. A nyní pipe a koncové závorky |}}. }}

Tato šablona používá pro většinu vzhledů třídy CSS ombox v, takže je plně skinovatelná.

Tato šablona volá ombox/core, která obsahuje většinu kódu pro ombox, zatímco ombox sama o sobě provádí předzpracování parametrů.

Interně tato meta-šablona používá pro kód tabulky označení HTML místo označení wiki. To je obvyklý způsob, jak vytváříme meta-šablony, protože značkování wiki má několik nevýhod. Například je obtížnější používat funkce parseru a speciální znaky v parametrech.

Výchozí obrázky pro tuto meta-šablonu jsou ve formátu png namísto formátu svg. Hlavním důvodem je, že některé starší webové prohlížeče mají potíže s průhledným pozadím, které MediaWiki vykresluje pro obrázky svg. Obrázky png zde mají ručně optimalizovanou průhlednou barvu pozadí, takže vypadají dobře ve všech prohlížečích. Všimněte si, že ikony svg vypadají poněkud špatně pouze ve starých prohlížečích, takže taková ruční optimalizace stojí za potíže pouze u velmi široce používaných ikon.

Další technické podrobnosti najdete na stránce diskuse. Protože tato šablona funguje téměř přesně jako ambox, tmbox, imbox a cmbox, jejich diskusní stránky a související stránky mohou také obsahovat více podrobností.