Kouzelná slova (angl. Magic words) jsou textové řetězce, kterými MediaWiki nahrazuje funkci nebo její návratovou hodnotu. Výsledkem může být aktuální čas, informace k webu nebo třeba jméno stránky. Tato stránka vysvětluje pouze běžná kouzelná slova. Technické podrobnosti najdete na stránce Příručka:Kouzelná slovíčka.
Existují tři základní typy kouzelných slov:
Přepínače chování: Běžně psané jako verzálkové řetězce uzavřené dvojitými podtržítky, např.__FOO__.
Proměnné: Verzálkové řetězce uzavřené dvojitými složenými závorkami, např.{{FOO}}. Používají se podobně jako šablony.
U proměnných a funkcí parseru lze použít prefix subst: stejně jako u šablon. Kouzelná slova závislá na stránce používají či mění data aktuální stránky (implicitně). I když se slovo používá prostřednictvím použité šablony či vloženého systémového hlášení.
Přepínače chování
Přepínač chování řídí rozvržení nebo chování stránky (pokud je podporováno zobrazením) a lze jej často použít k určení požadovaných vynechání a zahrnutí v obsahu. Některé z nich nejsou podporovány vzhledem Minerva.
Vynutí si vložení obsahu na jinou než obvyklou pozici (před prvním titulkem, má vyšší prioritu než __NOTOC__). Toto nebude fungovat ve vzhledech, které prezentují obsah mimo obsah článku, např. vzhled Vector 2022.
__TOC__
Obsah bude umístěn na pozici tohoto kouzelného slova (která má vyšší prioritu než __NOTOC__). Je-li uvedeno v kódu stránky vícekrát, je akceptován pouze jeho první výskyt. Toto nebude fungovat ve vzhledech, které prezentují obsah mimo obsah článku, např. vzhled Vector 2022.
Editování
__NOEDITSECTION__
Skryje odkazy pro úpravy sekce vedle nadpisů. To je zvláště užitečné tam, kde je nadpis vytvořen v rámci šablony: Normální editace sekce wiki by v tomto případě upravovala kód šablony, což obvykle není to, co uživatel zamýšlí. Je-li použit tento přepínač v šabloně, přenese se jeho efekt nejen na tuto šablonu, ale i na všechny stránky, kde je použit a to včetně ostatních šablon použitých na této stránce. Je možné řešení.
__NEWSECTIONLINK__
Přidá odkaz do záhlaví stránky vedle záložky "Editovat", kterým lze založit novou sekci i na stránce, která není diskusní (viz Přidat sekci na konec stránky).
≥ 1.7
__NONEWSECTIONLINK__
Odstraní odkaz vedle záložky "Editovat" u diskusních stránek.
U stránky typu kategorie zobrazí místo náhledů normální odkazy.
≥ 1.7
__HIDDENCAT__
Je-li použit na stránce kategorie, skryje tuto kategorii ve všech seznamech kategorií, kde je použita. I v seznamech nadřazených (uživatelskému nastavení kde je k dispozici volba, která zobrazení takových kategorií může povolit).
≥ 1.13
__EXPECTUNUSEDCATEGORY__
Je-li použit na stránce typu kategorie, skryje tuto kategorii v přehledu Special:UnusedCategories.
≥ 1.33
Jazyková přeměna
__NOCONTENTCONVERT__ __NOCC__
Na wikinách s jazykovými variantami neprovádějte při zobrazení článku žádnou konverzi jazyka obsahu. Například zobrazte pouze čínštinu (zh) namísto variant jako zh_cn, zh_tw, zh_sg nebo zh_hk.
__NOTITLECONVERT__ __NOTC__
U wiki, která používá vícejazyčné varianty stránek zamezí tomu, aby se překládal název stránky (její obsah se bude normálně překládat).
Jiné
__START__
Žádný efekt. Tento přepínač se používal za komentářem, který nebylo možné vložit pomocí transkluze, pro nastavení bodu za kterým následovaly zprávy vložené odjinud. Nepoužívá se od revize r1695 a zcela odstraněn byl od revize r24784.
Explicitně označený konec článku, který měl zabránit tomu, aby MediaWiki z článku odstranila mezery a řádky následující za textovým obsahem. Odstraněno od revize 19213.
Zakáže indexaci stránky internetovými vyhledávači (stránku pak přes ně nebude možné vyhledat). Pracuje s obsahem proměnné $wgExemptFromUserRobotsControl.
Na přesměrovaných stránkách neumožňujte MediaWiki automaticky aktualizovat odkaz, pokud někdo přesune stránku a zkontroluje "Opravit všechna přesměrování směřující na původní název" (což vyžaduje $wgFixDoubleRedirects).
If this switch is not intended to be transcluded with the template's contents, it should be used inside <noinclude>...</noinclude> (or on a template documentation page inside <includeonly>...</includeonly>), similarly to template categories. See Nápověda:Šablony.
If the switch is intended to remove from the report all pages that transclude a given template (for example, a notice that is transcluded on testcases or sandbox subpages), put the switch inside <includeonly>...</includeonly> tags within the template page.
Vypne globální uživatelskou stránku. Umístěním tohoto přepínače na ústřední uživatelské stránce zabrání uživatel zobrazování stránky na jiné wiki. Odkazy na jeho uživatelskou stránku pak u těchto wiki nebudou modré, ale červené (protože budou odkazovat na neexistující lokální uživatelskou stránku).
Některé stránky wiki neodpovídají rozsahu položek Wikidata, jako jsou archivy diskuzí, podstránky šablon atd. Chcete-li zabránit tomu, aby byla stránka wiki uvedena v seznamu Special:UnconnectedPages, použijte toto kouzelné slovo kdekoli na stránce. Stránky, které nesplňují kritéria zájmu pro Wikidata, by neměly obdržet položku Wikidata.
Některé stránky s obsahem wikisource se skládají ze seznamů (jako je seznam edic nebo překladů stejného díla), a proto neměly skeny. Chcete-li zabránit tomu, aby byly tyto stránky uvedeny v Special:PagesWithoutScans, vložte na stránku toto kouzelné slovo.
A magic word and a parser function which when invoked, will disable the Wikibase extension for a specific page, or used with parameters can suppress specific interlanguage links produced by the extension.When active, only interlanguage links present in the wikitext are used.
Proměnné
Proměnné vrací informace o aktuální stránce, wiki nebo datumu/času. Jejich použití je podobné jako u šablon. Proměnné, u kterých je uvedeno, že jsou "[náročné]". Zvyšují nároky na vygenerování stránky. Měly by se tedy používat pokud možno minimálně.
Pokud jméno proměnné koliduje s názvem šablony, použije parser přednostně proměnnou (takže pokud chcete vložit šablonu Template:PAGENAME, nestačí pouze její jméno. Musíte uvést i jmenný prostor, takto {{Template:PAGENAME}}).
Někdy donutí parser k použití šablony předaný parametr. Takže když napíšete {{CURRENTDAYNAME|x}}, nebude do stránky vložena hodnota proměnné, ale šablona Template:CURRENTDAYNAME.
Datum a čas
Následující proměnné vrací aktuální datum a čas v UTC formátu (časová zóna pro Česko).
Protože MediaWiki i webové prohlížeče používají mezipaměť, nezobrazují tyto proměnné aktuální čas, ale čas kdy byla vygenerovaná stránka uložena do mezipaměti (nakešována).
Použití těchto proměnných způsobí, že stránky budou ukládány do mezipaměti po omezenější počet sekund. Toto je nakonfigurováno v MagicWordFactory.
Formát, v jakém proměnná zobrazuje datum a čas, je daný jazykem příslušné wiki stránky. Jazyk obsahu stránky lze u MediaWiki nastavit od verze 1.19.
Následující proměnné dělají totéž co ty předcházející, ovšem s tím rozdílem, že vycházejí z konfigurace serveru, resp. z nastavení $wgLocaltimezone.
{{LOCALYEAR}}
{{LOCALMONTH}}
{{LOCALMONTH1}}
{{LOCALMONTH2}}
{{LOCALMONTHNAME}}
{{LOCALMONTHNAMEGEN}}
{{LOCALMONTHABBREV}}
{{LOCALDAY}}
{{LOCALDAY2}}
{{LOCALDOW}}
{{LOCALDAYNAME}}
{{LOCALTIME}}
{{LOCALHOUR}}
{{LOCALWEEK}}
{{LOCALTIMESTAMP}}
Pro sofistikovanější formátování času, nebo k tomu abyste získali na výstupu aktuální rok a týden, tak abyste byli ve shodě s normou ISO-8601, si můžete nainstalovat Rozšíření:ParserFunctions, které vám umožní používat funkci #time.
Doména, včetně domény třetího stupně (tahle proměnná již delší dobu nezávisí na $wgServerName, jako tomu bylo do verze 1.17).
{{DIRMARK}}
{{DIRECTIONMARK}}
Výstupem je Unicode znak, který oznamuje směr toku písma výchozího jazyka wiki (‎ u wiki, kde jsou texty psané zleva doprava a ‏ u wiki kde jde text zprava doleva). Tato proměnná se hodí především na wiki, kde se na stránce používají oba typy textů. Od MediaWiki verze 1.19 je závislá na zvoleném výchozím jazyce stránky.
Vrátí název stránky překladu (stránky, ze které jsou přeloženy jiné jazyky), pokud je stránka přeložitelná (včetně přeložených stránek), a nic, pokud stránku přeložit nelze.
<translate><!--T:1--> Translated unit. Language: <tvarname=lang>{{TRANSLATIONLANGUAGE}}</tvar>.</translate>
<translate><!--T:2--> Untranslated unit. Language: <tvarname=lang>{{TRANSLATIONLANGUAGE}}</tvar>.</translate>
Přeložená jednotka. Jazyk: cs.
Not translated unit. Language: en.
Musí být použit na přeložené stránce, uvnitř značek <translate>. Vrátí kód jazyka aktuální jednotky překladu. Na stránce překladu, pokud byla jednotka přeložena, vrátí jazyk překladu. V opačném případě vrátí zdrojový jazyk. Kód jazyka, který tato proměnná vrací, lze převést na název jazyka pomocí {{#language:...}}. Mělo by být používáno pouze administrátory překladů.
Vrací informaci o tom pro jakou skupinu přístupových práv (např. "autoconfirmed", "sysop") je příslušná akce (např. "edit", "move") pro danou stránku vyhrazena. Pokud stránka žádná omezení nemá, vrací prázdný řetězec.
Vrací časové razítko (např. "20160418155030") kdy skončí ochrana stránky a bude možné realizovat příslušnou akci (např. "edit", "move"). V případě, že žádný konkrétní interval nastaven není, nebo je stránka zamčena natrvalo, textový vrací řetězec "infinity".
[Náročné] Na stránce, která je chráněna nastavením kaskádového zámku u některé ze stránek, kam byla vložena, vrací tato proměnná seznam odkazů na tyto stránky. Pokud stránka chrání přes transkluzi sama sebe, nevrátí se nic.
Zobrazená revize aktuální stránky (nejnovější revize nebo vybraná starší revize)
{{REVISIONID}}
-
Unikátní ID revize stránky (číslo). Při náhledu nové stránky ještě žádná úprava uložená není (stránka je prázdná), proto se při něm může objevit hlášení o chybě. Může být zakázáno v úsporném módu (všechny WMF wiki) a místo toho vrátí -, když není v náhledu.
≥ 1.5
{{REVISIONDAY}}
18
Číslo dne v měsíci, kdy byla úprava provedena (bez doplnění nulou u jednomístného čísla)
≥ 1.8
{{REVISIONDAY2}}
18
Číslo dne v měsíci, kdy byla úprava provedena (doplněno nulou na dvoucifernou hodnotu)
≥ 1.8
{{REVISIONMONTH}}
12
Číslo měsíce, kdy byla úprava provedena, doplněno nulou na dvojciferné číslo (doplňování nulami se provádí až od MediWiki verze 1.17+. U starších verzí se vracelo číslo bez doplnění nulami).
Naformátujte display title aktuální stránky, což je to, co se obvykle zobrazuje v záhlaví názvu stránky. Pokud není $wgRestrictDisplayTitle nastaveno na false, musí být hodnota ekvivalentní výchozímu názvu: Povoleny jsou pouze změny velkých písmen v určitých částech názvu (ne všechny) a nahrazení mezer podtržítky. Lze jej zakázat nebo povolit pomocí $wgAllowDisplayTitle.
Může trvat druhý argument noerror nebo noreplace k potlačení chybových zpráv, když je na jedné stránce použito více displaytitles nebo k tomu, aby tento displaytitle nedělal nic, pokud displaytitle již bylo uvedeno dříve na stránce.
Pomocí této proměnné můžete nastavit výchozí klíč pro řazení v rámci kategorie. Například pokud použijete na konci stránky John Smith{{DEFAULTSORT: Smith, John}}, bude stránka ve výchozím nastavení zařazena v kategoriích pod "S". Proměnné můžete předat i druhý parametr noerror nebo noreplace, které mají význam pokud je na stránce použita tahle proměnná vícekrát. Také ho můžete použít pokud chcete aby defaultsort nedělal nic nebo když nevíte, zda-li již na stránce defaultsort někde není.
(druhé je číslo verze, od které lze použít noerror a noreplace)
Localization
Variable
Output
Description
Versions
{{USERLANGUAGE}}
cs
User's language. (If $wgParserEnableUserLanguage is enabled, it is disabled by default.) Note: Currently not supported by Parsoid Page View. If using Parsoid Page View or if $wgParserEnableUserLanguage is disabled, the magic word will return the same result as {{PAGELANGUAGE}}.
Tyto proměnné vrací čísla, která obsahují různé oddělovače (čárky, tečky nebo mezery, podle nastavení jazyka). Ale mohou vracet i holá čísla, pokud se použije návěští ":R" (např. {{NUMBEROFPAGES}} → 1 773 843 zatímco {{NUMBEROFPAGES:R}} → 1773843).
U proměnných, kterým se předává přes dvojtečku parametr, jako je např. PAGESINCATEGORY, se používá místo dvojtečky svislítko "|R" (takže {{PAGESINCATEGORY:Help}} a {{PAGESINCATEGORY:Help|R}}, nebo {{PAGESINCATEGORY:Help|subcats}} a {{PAGESINCATEGORY:Help|subcats|R}}).
Platí také pro {{PAGESIZE:NazevStranky}} výše.
Čísla, která se vracejí přes tyto proměnné jsou formátované v závislosti na jazyce v jakém je wiki. Od verze 1.19 závisí na zvoleném jazyce stránky.
[Náročné] Počet stránek v předané kategorii, včetně podkategorií a souborů. (Číslo, které vidíte vedle, ukazuje aktuální stav platný pro Kategorie:Nápověda)
[Náročné] Počet stránek v daném jmenném prostoru (nahradí index příslušným indexem jmenného prostoru). Například {{PAGESINNAMESPACE:14}} vydá počet stránek kategorií. {{PAGESINNS:0}} se liší od {{NUMBEROFARTICLES}} v tom, že první obsahuje přesměrování a stránky rozcestníku (disambiguation). Ve výchozím nastavení je povoleno pomocí $wgAllowSlowParserFunctions.
≥ 1.7
Názvy stránky
Proměnná
Pro aktuální stránku
Popis chování
Verze
{{FULLPAGENAME}}
Help:Magic words/cs
Vrací celý název stránky, včetně jmenného prostoru (a úrovní u podstránek).
≥ 1.6
{{PAGENAME}}
Magic words/cs
Vrací název stránky (včetně úrovní, jde-li o podstránku), ale bez uvedení jmenného prostoru.
{{BASEPAGENAME}}
Magic words
Vrací jméno stránky, která je nadřazena aktuální podstránce, bez uvedení jmenného prostoru. Vrátil by Title/Foo na stránce Help:Title/Foo/Bar.
≥ 1.7
{{ROOTPAGENAME}}
Magic words
Vrací jméno kořenové stránky. Takže na stránce Help:Title/Foo/Bar vrací Title.
≥ 1.22
{{SUBPAGENAME}}
cs
Vrací jméno podstránky. Vrátil by Bar na stránce Help:Title/Foo/Bar.
Pokud žádná podstránka neexistuje, vrátí se hodnota {{PAGENAME}}.
Úplný název stránky přidruženého subjektu (např. článek nebo soubor). Užitečné na diskusních stránkách.
≥ 1.7
{{TALKPAGENAME}}
Help talk:Magic words/cs
Vrací plné jméno diskusní stránky, asociované s příslušnou stránkou.
≥ 1.7
Žádné z nich nejsou ovlivněny změnami v zobrazeném názvu pomocí {{DISPLAYTITLE:xxxx}}. Vrácené hodnoty jsou původním názvem stránky.
Magická slova {{BASEPAGENAME}} a {{SUBPAGENAME}} fungují pouze v jmenných prostorech, které mají povoleny podstránky. Informace o povolení podstránek naleznete na stránce $wgNamespacesWithSubpages.
Od 1.15+ mohou všichni převzít parametr, který umožňuje specifikaci stránky, která má být provozována, namísto pouze aktuální stránky:
{{PAGENAME:Template:Main Page}} → Main Page
Varování:
Pokud nadpis stránky obsahuje "." nebo "..", kouzelné slovo nic nevrací.
{{PAGENAME:one/./three}} → Nic nevrací.
Varování:
Názvy stránek obsahující znaky, jako jsou apostrofy ' nebo hvězdičky *, mohou při práci s těmito magickými slovy, např. {{PAGESINCATEGORY:{{PAGENAME}}}}. tvořit chyby. Viz T16779, T18474, T37628, T37746. Jednoduchým způsobem, jak to vyřešit, je zabalení názvu stránky do {{#titleparts:}} z rozšíření funkce analyzátoru (ParserFunctions).
Všimněte si, že {{PAGENAME:...}}, {{PAGENAMEE:...}} a {{urlencode:...}} mají odlišné implementace.
Podrobnosti najdete na stránce Příručka:Kódování PAGENAMEE.
Jmenné prostory
Proměnná
Výstup
Popis
Verze
{{NAMESPACE}}
Help
Název jmenného prostoru stránky (kromě hlavního prostoru)
Název jmenného prostoru který je spojen s obsahem stránky
≥ 1.7
{{TALKSPACE}}
Help talk
Název diskuzního jmenného prostoru, který je spojen se stránkou
≥ 1.7
Následující kouzelná slova jsou ekvivalenty, jejichž výsledek je ale kódován pro použití v URL pro MediaWiki (mezery jsou nahrazeny podtržítky a některé znaky jsou nahrazeny procentem a číselným kódem):
{{NAMESPACEE}}
{{SUBJECTSPACEE}}
{{ARTICLESPACEE}}
{{TALKSPACEE}}
Od 1.15+ mohou obsahovat parametr s názvem celé stránky a vrátí požadovaný jmenný prostor spojený s touto stránkou namísto aktuální stránky:
{{NAMESPACENUMBER:MediaWiki}} → 0
{{NAMESPACE:MediaWiki}} → (Stránky v hlavním prostoru se vrátí prázdné)
Jako parametr se předává pouze název bez jmenného prostoru:
{{SUBJECTSPACE:Help talk}} → '(Empty)
Escaped characters
MediaWiki interprets certain characters as markup separators in certain contexts, notably:
template invocations
tables
function calls.
To prevent an immediate interpretation (so that the character can be displayed literally or later interpreted as a separator), Template:Character can be used as an escape sequence, but only the following characters (replacements) are supported.
This form can be clearer or at least shorter than using the equivalent <nowiki>character</nowiki>.
Syntax
Výstup
Popis chování
Verze
{{!}}
|
Používá se k zahrnutí znaku pipe jako součásti argumentu šablony nebo obsahu buňky tabulky. Než bylo toto slovo přidáno jako kouzelné slovo, mnoho wiki jej implementovalo vytvořením $1 s obsahem $2.
For historical and technical reasons, this function is not considered an actual escape sequence. Instead of using the vertical bar, the syntax employs an exclamation mark, which visually resembles a vertical bar. See Help:Extension:ParserFunctions#Escaping pipe characters in tables for additional details.
Before this capability was introduced as a magic word, many wikis achieved this effect by creating a template (Template:!) that simply returned | as its content.
Funkce syntaktického analyzátoru (parser) jsou velmi podobné proměnným, ale mají jeden nebo více parametrů (technicky každé kouzelné slovo, které má parametr, je funkcí parseru). Jméno má obvykle jako předponu mřížku (#) pro rozlišení od ostatních šablon.
Tato stránka popisuje pouze funkce parseru, které jsou integrální součástí základní instalace MediaWiki. Mnoho dalších funkcí parseru přidávají rozšíření, jako například Rozšíření:ParserFunctions. Více o nich najde na stránce Nápověda:Rozšíření:ParserFunctions.
[Náročné] Vrací informaci o tom pro jakou skupinu oprávněných (např. "autoconfirmed", "sysop") je příslušná akce (např. "edit", "move") u určité stránky vyhrazena. Pokud stránka nemá žádné omezení, vrací se prázdný řetězec.
[Náročné] Vrací časové razítko (např. "20160418155030") kdy skončí ochrana u stránky a bude možné na ní provést příslušnou akci (např. "edit", "move"). V případě, že žádný konkrétní interval nastaven není, nebo je stránka natrvalo zamčena, se vrací řetězec "infinity".
[Náročné] Pokud je předaná stránka chráněna nastavením kaskádového zámku u některé ze stránek, kam byla vložena, vrátí tato proměnná seznam odkazů na tyto stránky. Pokud stránka chrání přes transkluzi sama sebe, nevrátí se nic.
[Náročné] Měsíc, kdy byla provedena poslední revize předané stránky* (původně se vracelo holé číslo, ale od verze 1.17+ se vrací dvojciferná hodnota doplněná nulou).
* Pokud je daný parametr roven aktuálnímu názvu analyzátoru, funkce parseru poskytne předchozí verze při náhledu a při změnách, které zahrnují i prázdné řetězce při vytváření stránky. Ale i s použitím hodnot, které jsou součástí aktuálních změn v náhledu stránky, včetně procházení starších revizí. V tomto případě se jedná o nenákladnou funkci analyzátoru.
Cesta k názvu, relativní k protokolu, která závisí na konfiguračním nastavení $wgServer pro místní wiki (a tak může, ale nemusí začínat předponou $). To také vyřeší předpony interwiki. Poznámka: Odkazy bez závorek (prosté) relativní k protokolu nejsou automaticky propojeny.
≥ 1.5
{{canonicalurl:nazev stranky}} {{canonicalurl:nazev stranky |retezec_dotazu}} {{canonicalurl:interwiki:jméno vzdálené stránky |retezec_dotazu}}
{{urlencode:retezec}} nebo {{urlencode:retezec|QUERY}} {{urlencode:retezec|WIKI}} {{urlencode:retezec|PATH}}
{{urlencode:x:y/z á é}} nebo {{urlencode:x:y/z á é|QUERY}} → x%3Ay%2Fz+%C3%A1+%C3%A9 {{urlencode:x:y/z á é|WIKI}} → x:y/z_%C3%A1_%C3%A9 {{urlencode:x:y/z á é|PATH}} → x%3Ay%2Fz%20%C3%A1%20%C3%A9
Všimněte si, že výchozí hodnota se změnila z |WIKI na |QUERY od verze 1.17. Může to poškodit šablony, které se spoléhají na tuto funkci.
Kódovaný vstup pro použití v URL. Všimněte si, že neexistuje žádná funkce urldecode, jako v zastaralých funkcích $ext-string
{{ns:}} vrátí aktuální lokalizovaný název pro jmenný prostor s tímto indexem, kanonickým názvem nebo lokálním aliasem.
{{ns:6}}, {{ns:File}} a {{ns:Image}} (staré jméno pro jmenný prostor) tedy vrací "File".
Na wiki, kde je jazykem obsahu francouzština, je {{ns:Fichier}} platný, ale {{ns:Datei}} je nesprávný (lokalizace "File" v němčině).
Hlavní jmenný prostor nemá jméno, tzn. {{ns:0}} vrátí prázdný řetězec.
Pro explicitní odkaz na hlavní jmenný prostor lze použít {{int:Blanknamespace}}, což vede k "(Hlavní)".
{{nse:}} je ekvivalentní kódování pro adresy URL MediaWiki. To samé platí, ale nahrazuje mezery podtržítky, takže je použitelný v externích odkazech.
Nepodporováno: {{formatnum:{{formatnum:987.654.321}}}} → 987 654 321 (např. s italským jazykem)
Příklady nesprávného vstupu (nespolehlivý výstup) s nebo bez |R: {{formatnum:987,654.321|R}} (nejméně porušený) {{formatnum:987.654,321|R}} {{formatnum:987 654,321|R}} {{formatnum:987 654,321|R}}
Vezme neformátované (arabské číslice, žádné oddělovače skupin a . jako oddělovač desetinných míst) a odešle je v lokalizovaném číslicovém skriptu a naformátuje je s desetinným oddělovačem případně s desítkovými skupinami podle výchozího národního prostředí wiki.
Parametr |R lze použít k obrácení chování pro použití v matematických situacích. Je to spolehlivé a mělo by být použito pouze k přeměně čísel, o nichž je známo, že jsou formátovány podle národního prostředí wiki.
Parametr NOSEP ("bez oddělovačů") znamená, že se nezmění žádné oddělovače skupin případně desetinných míst. Formatnum transformuje samotné číslice pouze v jazycích, které nepoužívají Hindu – Arabský číselný systém. NOSEP může také zabránit neočekávaným nestandardním seskupením číslic.
Varování:
Počáteční nuly nejsou odstraněny, pokud máte nainstalováno Rozšíření:ParserFunctions. Můžete místo toho použít {{#expr:00001}}.
Varování:
Neočekávejte žádný spolehlivý výstup, pokud nezadáte čísla v požadovaném přesném formátu. Zejména na neanglických wiki.
Pokud opravdu potřebujete formátovat (podle národního prostředí wiki) číslo v neznámém vstupním formátu, můžete zkusit použít formatnum dvakrát (pokud používáte desetinné řády bude oddělovač pohlcen nebo nebude číslo naformátováno). Uvědomte si, že se jedná spíše o hack, než o běžný postup. Takže výstup nemusí být spolehlivý.
{{#dateformat:25 dec 2009|ymd}}
→ 25 dec 2009 (volba), 25. prosince 2009 (výchozí) {{#formatdate:dec 25,2009|dmy}}
→ dec 25,2009 (volba), 25. prosince 2009 (výchozí) {{#dateformat:2009-12-25|mdy}}
→ prosinec 25, 2009 (volba), 25. prosince 2009 (výchozí) {{#formatdate:2009 dec 25|ISO 8601}}
→ 2009 dec 25 (volba), 2009-12-25 (výchozí) {{#dateformat:25 decEmber|mdy}}
→ 25 decEmber (volba), DecEmber 25 (výchozí) Poznámka: Ve výše uvedených příkladech se "vaše předvolba" vztahuje pouze na preferované datum na aktuální wiki MediaWiki.
Naformátuje nepřipojené datum na základě předvolby uživatele "formát data" (date format) a přidá metadata, která jej označí jako formátované datum. Pro odhlášené uživatele a ty, kteří ve svých preferencích nenastavili formát data, mohou být data nastavena jako výchozí: mdy, dmy, ymd, ISO 8601 (rozlišují se malá a velká písmena). Pokud je uveden pouze měsíc a den, platí pouze mdy a dmy. Pokud není zadán formát nebo je neplatný, použije se výchozí formát. Pokud dané datum není rozpoznáno jako platné datum (konkrétně pokud obsahuje nějaká metadata, jako například z vnořeného použití těchto nebo podobných šablon), je zobrazeno nezměněné a nejsou generována žádná (další) metadata.
Varování:
Ačkoli norma ISO 8601 vyžaduje, aby data byla uváděna v gregoriánském kalendáři, parametr ISO v této funkci bude stále formátovat data, která spadají mimo obvyklý gregoriánský rozsah (např. data před rokem 1583). Také nelze magické slovo správně převádět mezi zápornými roky (používanými u ISO 8601) a roky BC nebo roky BCE (používanými obecně psaným písmem).
{{padleft:xyz|5|_}} → __xyz {{padleft:xyz|5|abc}} → abxyz {{padleft:xyz|2}} → xyz {{padleft:|1|xyz}} → x
(první znak řetězce)
Vloží řetězec zarovnávající odsazení znaků (znak vybraný ve třetím parametru; výchozí "0") zadané délky (druhý parametr) vedle vybraného základního znaku nebo proměnné (první parametr). Poslední číslice nebo znaky v základu nahrazují poslední znaky v zarovnání. Tj. {{padleft:44|3|0}} vytvoří 044. Řetězec výplně může být zkrácen, pokud jeho délka nerozděluje rovnoměrně požadovaný počet znaků.
Ve verzích do 1.12 se používá pouze první znak třetího parametru. U verze 1.15 se již používají všechny znaky.
Chyba (opraveno v r45734): Vícebajtové znaky jsou interpretovány jako dva znaky, které mohou zkreslit šířku. Nelze je také použít jako výplňové znaky.
Zabalí text do značky směrování vhodné pro skript (buď zleva doprava (U+202A) nebo zprava doleva (U+202B)) a znakem formátování směrovosti (U+202C), aby byla zajištěna bezpečnost směrování při použití kombinace skriptů v běžícím textu.
V této tabulce jsou kouzelná slova, které lze využít jako lokalizační nástroje. Výsledek interpretace kouzelných slov často záleží na místním nastavení wiki, na její konfiguraci a zvoleném jazyce: vizte zejména tabulky #Datum a čas, #Formátování a #Různé. Další kouzelná slova přidává rozšíření Extension:Translate.
Použití takových kouzelných slov je poměrně složité a ne moc dobře dokumentované. O jejich použití se můžete více dozvědět na stránkách PLURAL, GRAMMAR, GENDER.
{{#language:ar}} → العربية {{#language:ar|en}} → Arabic
Úplný název jazyka pro daný kód jazyka. Ve výchozím nastavení nativní název (jazykové autonymum). Pokud je zadán kód cílového jazyka, je název přeložen do cílového jazyka. Aby překlad fungoval, musí být nainstalováno Rozšíření:CLDR. If no argument is given, returns the name of the target language (for articles, the content language; for messages, the user language).
The IETF BCP-47 language tag for the given language code.If no argument is given, returns the tag of the target language (for articles, the content language; for messages, the user language).
The directionality for the given language code, either rtl or ltr.If the optional second argument is bcp47, then the first argument is interpreted as a BCP-47 language tag.If no argument is given, returns the directionality of the target language (for articles, the content language; for messages, the user language).
{{PLURAL:0|is|are}} → are {{PLURAL:1*1|is|are}} → is {{PLURAL:21 mod 10|is|are}} → are {{PLURAL:{{#expr:21 mod 10}}|is|are}} → is {{PLURAL:1|is|are}} → is {{PLURAL:2|is|are}} → are {{PLURAL:-1|is|are}} → is {{PLURAL:-2|is|are}} → are {{PLURAL:0.5|is|are}} → are {{PLURAL:1.5|is|are}} → are {{PLURAL:-0.5|is|are}} → are {{PLURAL:-1.5|is|are}} → are (Pro ruský jazyk) {{PLURAL:5|1=Категория|Категории}} → Категории
Vypíše tvar daného čísla odpovídající danému jazyku. Pro češtinu se používá jednotné číslo (druhý parametr), pokud je absolutní hodnota prvního parametru rovna jedné, nominativ plurálu (třetí parametr) pro první parametr v rozmezí 2–4 a genitiv plurálu (čtvrtý parametr) pro ostatní hodnoty. Další dokumentaci najdete na translatewiki.net
Vypíše skloňovaný tvar daného slova popsaný skloňovacím kódem za dvojtečkou. Gramatické transformace se používají pro skloňované jazyky, jako je čeština. Viz také $wgGrammarForms a dokumentaci grammar na translatewiki.net.
≥ 1.7
{{GENDER:username|text for every gender}}
{{GENDER:Username|male text|female text|text for unspecified}} {{GENDER:|male text|female text|text for unspecified}} {{GENDER:.|male text|female text|text for unspecified}}
Poznámka: První příklad je v podstatě no-op Poznámka: Pokud je třetí parametr vynechán a uživatel nedefinoval své pohlaví, je vrácen text, pokud je uživatel muž. Prázdné pole uživatelského jména ({{GENDER:|) znamená aktuálního uživatele, ale lze jej použít pouze ve správách rozhraní (jmenný prostor MediaWiki).
Tečka za uživatelským jménem (.), znamená použití na této wiki přednastaveného pohlaví uživatele.
Zmezinárodňuje (překládá) danou zprávu interface (jmenný prostor MediaWiki) do uživatelského jazyka. msgnw a další kouzelná slova transkluze naleznete v sekci Modifikátory přenosu.
Všimněte si, že to může poškodit/zmást konzistenci mezipaměti ve verzi MediaWiki 1.17 a starších, viz T16404.
Můžete také použít parametry s překlady. Parametry jsou určeny ve zprávách s: $1, $2, $3 atd. Například zde je zpráva pro úpravu sekce (editsectionhint): Úpravy: $1 V tomto příkladu MediaWiki nahrazuje $1.
Modifikátory transkluze
Kód {{NazevStranky|volitelné parametry}} provede transkluzi obsahu stránky NazevStranky ze šablony Template:namespace.
Toto výchozí chování lze pozměnit použitím modifikátorů transkluze.
Použití
Popis chování
Verze
{{:xyz}}
Dvojtečka sama o sobě modifikátorem není, ale odděluje prefix hlavního jmenného prostoru. Protože transkluze je výchozí pro Template namespace (šablonu jmenného prostoru), tak můžete následujícím kódem {{:UTC}} provést do stránky přenos obsahu stránky UTC z hlavního jmenného prostoru. Použitím {{UTC}} by jste provedli přenos (transkluzi) stránky Template:UTC..
{{int:xyz}}
Funguje podobně jako kdyby bylo použito {{MediaWiki:xyz}}. Ovšem s tím rozdílem, že se pokusí provést transkluzi podstránky podle jazykového kódu stránky, případně uživatelského nastavení nebo nastavení wiki. Další rozdíl je v tom, že se takto vložené podstránky nezobrazují v rámci "Šablony použité na této stránce:". Pokud příslušná zpráva MediaWiki:xyz nemá odpovídající jazykovou variantu, zobrazí se jako výsledek řetězec ⧼xyz⧽. Více na stránce Nápověda:Systémové zprávy.
{{msg:xyz}} {{raw:xyz}}
I když existuje magické slovo s názvem "xyz", použijte template:xyz, pokud šablona neexistuje (ekvivalent {{template:xyz}}). Za normálních okolností totiž mají magická slova před šablonami přednost.
{{raw:xyz}}
Je-li nastavena proměnná $wgEnableScaryTranscluding a wiki podporuje při transkluzi interwiki, vloží do stránky místo HTML neinterpretovaný wikitext z jiné wiki.
{{#interwikilink:mos|Soraogo|Link text}} → Link text
Creates an interwiki link. When the interwiki prefix of the link conflicts with a namespace on the local wiki, the usual syntax[[prefix:title]] syntax can't be used, but this parser function can still be used to make an interwiki link.
{{#interlanguagelink:mos|Soraogo}} → An (invisible) interlanguage link from this page to [[mos:Soraogo]]
Creates an interlanguage link. When the language prefix of the link conflicts with a namespace on the local wiki, the usual syntax[[prefix:title]] can't be used, but this parser function can still be used to make an interlanguage link.
Toto je příklad jakým způsobem nahradit tag <ref>, z rozšíření Citace:
{{#tag:ref|Citace na Magic words/cs. |name = "mnohonásobný"}}
→
[1]
Alias pro značky analyzátoru MediaWiki ve stylu XML nebo značky rozšíření. Umožňuje transformaci značky před uložením transformace kódu wiki a Rozšíření:ParserFunctions uvnitř značek. Zabraňuje také analýze značek v podmíněných cestách, které nejsou provedeny (jako v příkazech #if). Obsah mezi značkami je předán jako první parametr a jakékoli atributy pro značky mohou být předány jako následné parametry. Například:
<NazevTaguatribut1="hodnota1"atribut2="hodnota2">Váš obsah je zde</NazevTagu>
…může být přepsáno takto:
{{#tag:NazevTagu|Váš obsah je zde|atribut1=hodnota1|atribut2=hodnota2}}
Varování:
Pokud nechcete předat žádný obsah, musíte napsat {{#tag:NazevTagu||atribut1=hodnota1|atribut2=hodnota2}}. Mezi svislítky ||, před parametrem atribut1 nesmí být žádná mezera ani zalomení řádku.
Varování:
For the <inputbox> tag, do NOT separate the parameters with pipes -- this won't work.You need to supply everything as the first parameter, with individual lines separated by breaks and not pipes, as you do when using the inputbox tag normally with <inputbox></inputbox>.
Varování: