Template:Ombox/doc/cs
Toto je dokumentace podstránky Template:Ombox/doc. Obsahuje informace o použití, kategorie a další obsah, který není součástí původní stránky Template. |
This page is outdated. |
Uses Lua: |
This template uses TemplateStyles: |
This template is used on approximately 3,200 pages. To avoid large-scale disruption and unnecessary server load, any changes to this template should first be tested in its /sandbox or /testcases subpages or in your own user subpage. The tested changes can then be added to this page in one single edit. Please consider discussing any changes on the talk page before implementing them. |
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
editJak 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í
editJednoduchý příklad použití:
{{ombox | text = Nějaký 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. }}
Text těla zprávy. |
Jiné typy schránek zpráv
editNá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.
type=speedy – Rychlé odstranění šablon. |
type=delete – Šablony pro odstranění. |
type=content – Závažná varování a problémy, jako {{High-risk }}. |
type=style – Drobná varování a problémy. {{Intricate }} by možná měl používat tento typ. |
type=notice – Oznámení a zprávy jakéhokoli druhu, trvalé i dočasné. Například {{Guideline }} a {{Wikipedia how to }}. |
type=move – Slučujte, rozdělujte, přejmenovávejte a překládejte zprávy a návrhy. |
type=protection – Šablony ochrany při zobrazení na "jiných stránkách". |
příklady
editNěkteré příklady používající styl "upozornění".:
Žádný typ a žádný obrázek (výchozí) |
Žádný typ a image=none – Není použit žádný obrázek a text využívá celou oblast pole zprávy. |
image = [[Image:Gnome globe current event.svg|42px]] imageright = [[Image:Nuvola apps bookcase.svg|40px]] |
Tato stránka dokumentuje anglickou Wikipedii guideline. Je to obecně uznávaný standard, který by redaktoři měli dodržovat, i když by se s ním mělo zacházet pomocí selského rozumu a příležitostné výjimky. Při úpravách této stránky se prosím ujistěte, že vaše revize odráží souhlas. V případě pochybností diskutujte na diskusní stránce. |
Tato stránka v kostce: Tato šablona se používá k vytváření zpráv pro všechny stránky, které nejsou články, diskusními stránkami, obrázkovými stránkami nebo stránkami kategorií. |
Parametry
editSeznam 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
editsmall = yes |
type = style small = yes |
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|}}}
small = yes image = [[Image:Replacement filing cabinet.svg|50px]] smallimage = [[Image:Replacement filing cabinet.svg|32px]] |
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".
small = yes imageright = [[Image:Nuvola apps bookcase.svg|50px]] smallimageright = none |
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
editTato 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.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Type | type | no description
| String | suggested |
Image (left) | image | no description
| 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
| Boolean | optional |
Small Image (left) | smallimage | no description
| Content | optional |
Small Image (right) | smallimageright | no description
| Content | optional |
Small Text | smalltext | no description
| Content | optional |
Technické detaily
editPokud 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> }}
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 }}. A nyní pipe a koncové závorky |}}. |
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í.