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 User, Wikipedia, MediaWiki, Template, Help, Portal 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ámce 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í:

{{ombox | text = Nějaký text.}}

Komplexní příklad:

{{ombox
| type      = style
| image     = [[Image:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = Text těla zprávy.
}}

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

{{ombox
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[Image:Some image.svg|40px]]
| imageright = [[Image:Some image.svg|40px]]
| style = CSS values
| textstyle = CSS values
| text  = Text těla zprávy. 
| small = {{{small|}}} / yes
| smallimage = none / [[Image:Some image.svg|30px]]
| smallimageright = none / [[Image:Some image.svg|30px]]
| smalltext  = Kratší hlavní text zprávy.
}}

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:

image = [[Image:Crystal128-configure.svg|40px]]

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:

imageright = [[Image:Nuvola apps bookcase.svg|40px]]

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:

style = margin-bottom: 0.5em;

textstyle

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

textstyle = text-align: center;

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:

small = {{{small|}}}

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:

smallimage = [[Image:Replacement filing cabinet.svg|30px]]

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:

smallimageright = [[Image:Nuvola apps bookcase.svg|30px]]

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

smalltext

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

TemplateData

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

Ombox/doc

This is the specialized version of the {{mbox}} or “multi namespace message box” meta-template.

Template parameters[Edit template data]

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
Type	type	no description Suggested values speedy delete content style notice move protection Default notice	String	suggested
Image (left)	image	no description Suggested values none Default Depends on the “type” parameter.	Content	suggested
Image (right)	imageright	no description	Content	optional
CSS Style	style	no description	String	optional
Text CSS Style	textstyle	no description	String	optional
Text	text	no description	Content	suggested
Small?	small	no description Suggested values {{{small|}}} left yes 1 Default 0	Boolean	optional
Small Image (left)	smallimage	no description Suggested values none Default {{{image}}}	Content	optional
Small Image (right)	smallimageright	no description Suggested values none Default {{{imageright}}}	Content	optional
Small Text	smalltext	no description Default {{{text}}}	Content	optional

Technické detaily

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

{{ombox
| text  = <div>
Equal sign = a počáteční a koncová složená závorka { } fungují dobře tak, jak jsou. 
Ale tady je pipe {{!}} a dvě koncové závorky <nowiki>}}</nowiki>. 
A nyní pipe a koncové závorky <nowiki>|}}</nowiki>.
</div>
}}

Tato šablona používá pro většinu vzhledů třídy CSS ombox v MediaWiki:Common.css, 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í.