Nápověda:Kouzelná slovíčka
![]() |
Poznámka: Editací této stránky souhlasíte s uvolněním svého příspěvku pod licencí CC0. Více informací se dočtete na stránce Public Domain Help Pages.
|
![]() |
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. - Funkce parseru: Těm se předávají parametry a volají se pomocí
{{foo:...}}
nebo{{#foo:...}}
, např.{{#invoke:...}}
. Více o nich viz Nápověda:Rozšíření:ParserFunctions a Extension:Scribunto .
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.
Přepínač | Popis chování | Verze | ||
---|---|---|---|---|
Obsah | ||||
__NOTOC__
|
Skryje obsah (TOC). | |||
__FORCETOC__
|
Vynutí si vložení obsahu na jiné než obvyklé pozici (před prvním titulkem, má vyšší prioritu než __NOTOC__ ).
|
|||
__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.
|
|||
Editace | ||||
__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. Jak potlačit tento efekt najdete zde. | |||
__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). |
| ||
__NONEWSECTIONLINK__
|
Odstraní odkaz vedle záložky "Editovat" u diskuzních stránek. |
| ||
Kategorie | ||||
__NOGALLERY__
|
U stránky typu kategorie zobrazí místo náhledů normální odkazy. |
| ||
__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). |
| ||
__EXPECTUNUSEDCATEGORY__
|
Je-li použit na stránce typu kategorie, skryje tuto kategorii v přehledu nepoužitých kategorií. |
| ||
Jazyková konverze | ||||
__NOCONTENTCONVERT__ __NOCC__
|
U wiki, která používá vícejazyčné varianty zpráv zamezí tomu, aby se na stránce, kde je uveden tento řetězec, zprávy překládaly. Zobrazovat se pak bude pouze výchozí varianta zprávy. | |||
__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. |
| ||
__END__
|
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. |
| ||
__INDEX__
|
Povolí indexování stránky internetovými vyhledávači (přebije nastavení proměnné $wgArticleRobotPolicies, ale ne obsah souboru robots.txt). Pracuje s obsahem proměnné $wgExemptFromUserRobotsControl. |
| ||
__NOINDEX__
|
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. |
| ||
__STATICREDIRECT__
|
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 ). |
| ||
Přepínače přidávané přes rozšíření | ||||
Rozšíření | Přepínač | Popis | Verze | |
GlobalUserPage | __NOGLOBAL__
|
Vypne globání 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). |
| |
Disambiguator | __DISAMBIG__
|
Stránka, do které je vložen, se identifikuje jako rozcestník. |
| |
Wikibase | __EXPECTED_UNCONNECTED_PAGE__
|
Některé stránky wiki si nezaslouží položku 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. |
|
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í kešování, 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.
Proměnná | Výstup | Popis | Verze | |
---|---|---|---|---|
Rok | ||||
{{CURRENTYEAR}}
|
2022 | Rok | ||
Měsíc | ||||
{{CURRENTMONTH}}
|
05 | Číslo měsíce (doplněno nulami) | ||
{{CURRENTMONTH1}}
|
5 | Číslo měsíce (nedoplněné) | ||
{{CURRENTMONTHNAME}}
|
květen | Jméno měsíce | ||
{{CURRENTMONTHNAMEGEN}}
|
května | Jméno měsíce (v genitivu) | ||
{{CURRENTMONTHABBREV}}
|
5. | Pořadové číslo měsíce |
| |
Den | ||||
{{CURRENTDAY}}
|
22 | Den v měsíci | ||
{{CURRENTDAY2}}
|
22 | Den v měsíci doplněný nulami |
| |
{{CURRENTDOW}}
|
0 | Den v týdnu číslem, 0 (neděle) až 6 (sobota) | ||
{{CURRENTDAYNAME}}
|
neděle | Den v týdnu (názvem) | ||
Čas | ||||
{{CURRENTTIME}}
|
20:15 | Čas (ve 24-hodinovém formátu HH:mm) | ||
{{CURRENTHOUR}}
|
20 | Hodina (24-hodinový formát, jednociferné číslo je doplněno nulou) | ||
Ostatní | ||||
{{CURRENTWEEK}}
|
20 | Pořadové číslo týdne | ||
{{CURRENTTIMESTAMP}}
|
20220522201538 | Časové razítko RRRRMMDDHHmmss |
|
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}}
{{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 Extension:ParserFunctions , které vám umožní používat funkci #time .
Technická metadata
Proměnná | Výstup | Popis | Verze | ||
---|---|---|---|---|---|
Web | |||||
{{SITENAME}}
|
MediaWiki | Jméno wiki ($wgSitename). | |||
{{SERVER}}
|
//www.mediawiki.org | URL domény ($wgServer). | |||
{{SERVERNAME}}
|
www.mediawiki.org | 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}}
|
|
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.
|
| ||
{{SCRIPTPATH}}
|
/w | Relativní cesta ke skriptům ($wgScriptPath). | |||
{{STYLEPATH}}
|
/w/skins | Relativní cesta k tématům ($wgStylePath). |
| ||
{{CURRENTVERSION}}
|
1.39.0-wmf.12 (036b6a4) | Aktuální verze MediaWiki. |
| ||
{{CONTENTLANGUAGE}}
|
en en |
Vrací výchozí jazyk wiki ($wgLanguageCode). |
| ||
Stránka | |||||
{{PAGEID}}
|
469030 | Vrací numerický identifikátor stránky. |
| ||
{{PAGELANGUAGE}} {{#language:{{PAGELANGUAGE}}}}
|
cs čeština |
Vrací jazykový kód aktuální stránky, který lze převést na jméno jazyka přes {{#language:...}} .
|
| ||
|
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ů.
|
| ||
{{PROTECTIONLEVEL:akce}}
|
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. |
| |||
{{PROTECTIONEXPIRY:akce}}
|
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". |
| |||
{{CASCADINGSOURCES}}
|
[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. |
| |||
Poslední revize aktuální stránky | |||||
{{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 deaktivován v šetřič režimu (miser). |
| ||
{{REVISIONDAY}}
|
16 | Číslo dne v měsíci, kdy byla úprava provedena (bez doplnění nulou u jednomístného čísla) |
| ||
{{REVISIONDAY2}}
|
16 | Číslo dne v měsíci, kdy byla úprava provedena (doplněno nulou na dvoucifernou hodnotu) |
| ||
{{REVISIONMONTH}}
|
05 | Čí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). |
| ||
{{REVISIONMONTH1}}
|
5 | Měsíc (číslo), kdy došlo k editaci. |
| ||
{{REVISIONYEAR}}
|
2022 | Rok kdy byla provedena editace. |
| ||
{{REVISIONTIMESTAMP}}
|
20220516093857 | Časové razítko okamžiku uložení úpravy. |
| ||
{{REVISIONUSER}}
|
Baris6161TURK | Uživatelské jméno autora poslední úpravy stránky. |
| ||
{{REVISIONSIZE}}
|
81748 | Velikost aktuální úpravy stránky (v bajtech wiki kódu). |
| ||
Proměnné mající vliv na zobrazení obsahu stránky | |||||
{{DISPLAYTITLE:název}} {{DISPLAYTITLE:název|noerror}} {{DISPLAYTITLE:název|noreplace}}
|
Nastavuje titulek záhlaví aktuální stránky. Měl by víceméně odpovídat výchozímu názvu stránky. Povoleny jsou mezery namísto podržítek a kapitálky místo malých písmen na některých pozicích (toto výchozí chování lze změnit přes $wgRestrictDisplayTitle). Magické slůvko může být přes $wgAllowDisplayTitle zapnuto nebo vypnuto. Do MediaWiki verze 1.10+ bylo ve výchozím stavu vypnuto, ale u těch pozdějších je ve výchozím stavu zapnuto.
Akceptuje také další parametr. Řetězec noerror potlačí chybové hlášení, které se může na stránce objevit, pokud je tohle magické slovo na ní použito vícekrát. V takovém případě se zobrazí poslední nastavená hodnota. Nebo noreplace pokud se má akceptovat |
(druhé je číslo verze, od které lze použít noerror a noreplace) | |||
{{DEFAULTSORT:klíč řazení}} {{DEFAULTSORTKEY:klíčřazení}} {{DEFAULTCATEGORYSORT:klíčřazení}} {{DEFAULTSORT:klíčřazení|noerror}} {{DEFAULTSORT:klíčřazení|noreplace}}
|
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) |
Statistiky
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 285 033 zatímco {{NUMBEROFPAGES:R}}
→ 1285033).
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}}
). Podobným způsobem lze použít tento parametr i u výše uvedené proměnné pro zjištění velikosti stránky {{PAGESIZE:jméno stránky}}
.
Čí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.
Proměnná | Výstup | Popis | Verze | |
---|---|---|---|---|
{{NUMBEROFPAGES}}
|
1 285 033 | Celkový počet stránek wiki. |
| |
{{NUMBEROFARTICLES}}
|
51 683 | Počet stránek v jmenných prostorech obsahu , které se kvalifikují jako články. Další podrobnosti najdete na stránce Návod:$wgArticleCountMethod . | ||
{{NUMBEROFFILES}}
|
2 829 | Celkový počet souborů nahraných do wiki. |
| |
{{NUMBEROFEDITS}}
|
5 118 236 | Celkový počet editací. |
| |
{{NUMBEROFVIEWS}}
|
Celkový počet zobrazení stránek. Nešlo to moc dohromady s kešováním. Odstraněno v revizi Gerrit change 150699. |
| ||
{{NUMBEROFUSERS}}
|
17 622 196 | Celkový počet registrovaných uživatelů. |
| |
{{NUMBEROFADMINS}}
|
151 | Počet uživatelů ve skupině sysop. |
| |
{{NUMBEROFACTIVEUSERS}}
|
1 098 | Celkový počet aktivních uživatelů, vyspecifikovaných podle kritérií na stránce Special:Statistics. |
| |
{{PAGESINCATEGORY:categoryname}} {{PAGESINCAT:categoryname}}
|
131 131 |
[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 Category:Help) |
| |
{{PAGESINCATEGORY:kategorie|all}} {{PAGESINCATEGORY:kategorie|pages}} {{PAGESINCATEGORY:kategorie|subcats}} {{PAGESINCATEGORY:kategorie|files}}
|
131 128 3 0 |
[Náročné] S využitím parametrů lze vypsat počet
v předané kategorii.(Čísla, která vedle vidíte ukazují aktuálně platný stav pro kategorii Category:Help) |
| |
{{NUMBERINGROUP:jménoskupiny}} {{NUMINGROUP:jménoskupiny}}
|
26 26 |
Počet uživatelů vybrané skupiny . ({{NUMBERINGROUP:bureaucrat}} použito na ukázku) |
| |
{{PAGESINNS:index}} {{PAGESINNAMESPACE:index}}
|
Ve výchozím stavu není zapnuto | [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 .
|
|
Jména stránek
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). |
| |
{{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 .
|
| |
{{ROOTPAGENAME}}
|
Magic words | Vrací jméno kořenové stránky. Takže na stránce Help:Title/Foo/Bar vrací Title .
|
| |
{{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 K sofistikovanějšímu zpracování názvu stránky použijte funkci |
| |
{{SUBJECTPAGENAME}} {{ARTICLEPAGENAME}}
|
Help:Magic words/cs Help:Magic words/cs |
Úplný název stránky přidruženého subjektu (např. článek nebo soubor). Užitečné na diskusních stránkách. |
| |
{{TALKPAGENAME}}
|
Help talk:Magic words/cs | Vrací plné jméno diskusní stránky, asociované s příslušnou stránkou. |
|
Žádné z nich nejsou ovlivněny změnami v zobrazeném názvu pomocí {{DISPLAYTITLE:xxxx}}
. Vrácené hodnoty jsou původní název 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
URL stránek kódovaná dle HTML standardu
Ekvivalenty kódované pro použití URL v MediaWiki (tj. mezery nahrazené podtržítky a některými znaky HTML uniklo pomocí kódování číselných znaků):
{{FULLPAGENAMEE}}
{{PAGENAMEE}}
{{BASEPAGENAMEE}}
{{SUBPAGENAMEE}}
{{SUBJECTPAGENAMEE}}
{{ARTICLEPAGENAMEE}}
{{TALKPAGENAMEE}}
{{ROOTPAGENAMEE}}
Všimněte si, že {{PAGENAME:...}}
, {{PAGENAMEE:...}}
a {{urlencode:...}}
mají odlišné implementace.
Podrobnosti najdete na stránce Manual:PAGENAMEE encoding .
Jmenné prostory
Proměnná | Výstup | Popis | Verze | |
---|---|---|---|---|
{{NAMESPACE}}
|
Help | Název jmenného prostoru stránky | ||
{{NAMESPACENUMBER}}
|
12 | ID jmenného prostoru stránky |
| |
{{SUBJECTSPACE}} {{ARTICLESPACE}}
|
Help Help |
Název jmenného prostoru který je spojen s obsahem stránky |
| |
{{TALKSPACE}}
|
Help talk | Název diskuzního jmenného prostoru, který je spojen se stránkou |
|
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}}
→ (Pages in main space will return empty){{NAMESPACE:Template:Main Page}}
→ Template{{SUBJECTSPACE:Template:Main Page}}
→ Template{{ARTICLESPACE:Template:Main Page}}
→ Template{{TALKSPACE:Template:Main Page}}
→ Template talk
Jako parametr se předává pouze název bez jmenného prostoru:
{{SUBJECTSPACE:Help talk}}
→ (Empty)
Jiné
Proměnná | 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 Template:! s obsahem | .
Další vysvětlení na stránce Nápověda:Rozšíření:Funkce parseru#Únikové znaky svislítka v tabulkách. |
|
Funkce parseru
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 Extension:ParserFunctions . Více o nich najde na stránce Nápověda:Rozšíření:ParserFunctions .
Informace o jiných stránkách
Funkce parseru | Výstup (na stránce MediaWiki) |
Popis | Verze | |
---|---|---|---|---|
{{PAGEID: jméno stránky }}
|
1 | [Náročné] Vrací číselný identifikátor předané stránky*. |
| |
{{PAGESIZE:jméno stránky}} {{PAGESIZE: jméno stránky |R}}
|
95 221 95221 |
[Náročné] Vrací velikost stránky v bajtech. Pokud chcete získat holé číslo, použijte "|R ".
|
| |
{{PROTECTIONLEVEL:akce | jméno stránky}}
|
sysop | [Náročné] Vrací informaci o tom pro jakou skupinu oprávě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. |
| |
{{PROTECTIONEXPIRY: action | page name}}
|
infinity | [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". |
| |
{{CASCADINGSOURCES: page name}}
|
[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. |
| ||
{{REVISIONID: jméno stránky }}
|
3878227 | [Náročné] Unikátní ID poslední revize předané stránky*. |
| |
{{REVISIONDAY: jméno stránky }}
|
26 | [Náročné] Den, kdy byla provedena poslední revize předané stránky* (číslo). |
| |
{{REVISIONDAY2: jméno stránky }}
|
26 | [Náročné] Den, kdy byla provedena poslední revize předané stránky* (jako číslo doplněné nulou na dvojcifernou hodnotu). |
| |
{{REVISIONMONTH: jméno stránky }}
|
05 | [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). |
| |
{{REVISIONMONTH1: jméno stránky }}
|
5 | [Náročné] Měsíc poslední revize předané stránky* (číslo) |
| |
{{REVISIONYEAR: jméno stránky }}
|
2020 | [Náročné] Rok poslední revize předané stránky*. |
| |
{{REVISIONTIMESTAMP: jméno stránky }}
|
20200526133817 | [Náročné] Časové razítko poslední úpravy předané stránky*. |
| |
{{REVISIONUSER: jméno stránky }}
|
Shirayuki | [Náročné] Jméno uživatele, který udělal poslední revizi u předané stránky*. |
| |
* 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 z aktuální verze pro zobrazení stránky. Včetně prohlížení starých revizí. V tomto případě se jedná o nenákladnou funkci analyzátoru. |
URL data
Funkce parseru | Vstup → Výstup | Popis | Verze | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{{localurl:jméno stránky}} {{localurl:jméno stránky
|
{{localurl:MediaWiki}} → /wiki/MediaWiki {{localurl:MediaWiki|printable=yes}} → /w/index.php?title=MediaWiki&printable=yes |
Relativní cesta k titulku. | |||||||||||||||
{{fullurl:jméno stránky}} {{fullurl:jméno stránky {{fullurl:interwiki:jméno vzdálené stránky
|
{{fullurl:Category:Top level}} → //www.mediawiki.org/wiki/Category:Top_level
|
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. |
| ||||||||||||||
{{canonicalurl:jméno stránky}} {{canonicalurl:jméno stránky {{canonicalurl:interwiki:jméno vzdálené stránky
|
{{canonicalurl:Category:Top level}} → https://www.mediawiki.org/wiki/Category:Top_level
|
Absolutní cesta k titulu pomocí kanonické adresy URL. Tím se také vyřeší předpony interwiki. |
| ||||||||||||||
{{filepath:jméno souboru}} {{filepath:jméno souboru|nowiki}} {{filepath:jméno souboru|velikost_náhledu}}
|
{{filepath:Wiki.png}} → //upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png
|
Relativní cesta k protokolu k plné velikosti nebo miniatuře (1.18+) mediálního souboru. |
| ||||||||||||||
{{urlencode:řetězec}} nebo {{urlencode:řetězec|QUERY}} {{urlencode:řetězec|WIKI}} {{urlencode:řetězec|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 |
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
|
| ||||||||||||||
{{anchorencode:řetězec}}
|
{{anchorencode:x y z á é}} → x_y_z_á_é |
Vstup kódovaný pro použití v kotvách sekce URL (za symbolem mřížky "#" v adrese URL). |
|
Jmenné prostory
{{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ě).
{{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.
Obsahové jmenné prostory | Diskusní jmenné prostory | |||
---|---|---|---|---|
Použití | Výstup | Použití | Výstup | |
{{ns:-2}} / {{ns:Media}}
|
Media | {{ns:-1}} / {{ns:Special}}
|
Special (no talk page) | |
{{ns:0}} / {{ns:}}
|
{{ns:1}} / {{ns:Talk}}
|
Talk | ||
{{ns:2}} / {{ns:User}}
|
User | {{ns:3}} / {{ns:User talk}}
|
User talk | |
{{ns:4}} / {{ns:Project}}
|
Project Varies between wikis |
{{ns:5}} / {{ns:Project talk}}
|
Project talk | |
{{ns:6}} / {{ns:File}} or {{ns:Image}}
|
File | {{ns:7}} / {{ns:File talk}} or {{ns:Image talk}}
|
File talk | |
{{ns:8}} / {{ns:MediaWiki}}
|
MediaWiki | {{ns:9}} / {{ns:MediaWiki talk}}
|
MediaWiki talk | |
{{ns:10}} / {{ns:Template}}
|
Template | {{ns:11}} / {{ns:Template talk}}
|
Template talk | |
{{ns:12}} / {{ns:Help}}
|
Help | {{ns:13}} / {{ns:Help talk}}
|
Help talk | |
{{ns:14}} / {{ns:Category}}
|
Category | {{ns:15}} / {{ns:Category talk}}
|
Category talk |
Nezaměňujte lokalizované jmenné prostory s obvyklými jmennými prostory.
Formátování
Použití | Vstup → Výstup | Popis chování | Verze | ||
---|---|---|---|---|---|
|
Nepodporováno: Příklady nesprávného vstupu (nespolehlivý výstup) s nebo bez |
Vezme neformátované (arabské číslice, žádné oddělovače skupin a . jako oddělovač desetinných míst) a odešle jej v lokalizovaném číslicovém skriptu a naformátuje jej s desetinným oddělovačem případně s desítkovými skupinami podle výchozího národního prostředí wiki.Parametr 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 |
| ||
|
|
Naformátuje nepřipojené datum na základě předvolby uživatele "formát data" (date format) a přidá metadata, která je 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. |
| ||
|
{{lc:DATA CENTER}} → data center
|
Vstup z malých písmen. |
| ||
|
{{lcfirst:DATA center}} → dATA center
|
Vstup s malým prvním písmenem. |
| ||
|
{{uc:text transform}} → TEXT TRANSFORM
|
Vstup velkými písmeny. |
| ||
|
{{ucfirst:text tRAnSFORM}} → Text tRAnSFORM
|
Vstup s velkým prvním písmenem. |
| ||
|
{{padleft:xyz|5}} → 00xyz
|
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. Výplňový řetězec může být zkrácen, pokud jeho délka rovnoměrně nerozdělí 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. |
| ||
|
{{padright:xyz|5}} → xyz00
|
Stejné jako v případě padleft , ale přidá výplňové znaky na pravou stranu.
|
|
Více najdete na stránce: Extension:StringFunctions .
Lokalizace
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: viz kupř. tabulky #Datum a čas, #Formátování nebo #Různé. Další kouzelná slova přidává rozšíření Rozšíření: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.
Použití | Vstup → Výstup | Popis chování | Verze | |
---|---|---|---|---|
{{plural:2|is|are}}
|
{{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=Категория|Категории}} → Категории
|
Výstup singulárního tvaru (druhý parametr). Pokud absolutní hodnota prvního parametru je rovna jedné. Jinak množný tvar uvedený jako třetí parametr. Jeho fungování je jazykově závislé.
Některé jazykové kódy (ab, av, ba, bxr, ce, crh_cyrl, cv, inh, koi, krc, kv, lbe, lez, mhr, mrj, myv, ru, tt_cyrl, tyv, udm, xal) použvají 3 množná čísla (aktualizace 01.2014)
|
||
{{grammar:N|noun}}
|
Vytiskne jazykově správně skloňovanou formu daného slova popsanou inflexním kódem za dvojtečkou. Gramatické transformace se používají pro skloňované jazyky, jako je čeština. Viz také $wgGrammarForms. |
| ||
{{gender:username|text for every gender}}
|
(Závisí na pohlaví pojmenovaného uživatele) | Přepínač pohlaví je nastaven na stránce Special:Preferences. Poznámka: První příklad je v podstatě no-op |
| |
{{int:název zprávy}}
|
{{int:edit}} → Edit (Závisí na uživatelském jazyce. Zkus: fr • ja) |
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 v verzi MediaWiki 1.17 a starších, viz T16404. |
||
{{int:editsectionhint|MediaWiki}}
|
{{int:editsectionhint|MediaWiki}} → Edit section: MediaWiki
|
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 {{Jméno stránky|volitelné parametry}}
provede transkluzi obsahu stránky Jméno stránky 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í {{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. |
| |
{{msgnw:xyz}}
|
Výsledkem transkluze bude neiterpretovaný wiki kód (víceméně, pro bližší podrobnosti se podívejte na stránku Nápověda:Šablony ) | ||
{{subst:xyz}}
|
Ve wikitextu je značka nahrazena obsahem (pouze jednoúrovňové hodnocení). Více na stránce Nápověda:Šablony . | ||
{{safesubst:xyz}}
|
Podívejte se na Nápověda:Šablony . |
Různé
Použití | Vstup → Výstup | Popis | Verze | ||
---|---|---|---|---|---|
{{#language:kód jazyka}} {{#language:kód jazyka|kód cílového jazyka}}
|
{{#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 Extension:CLDR . |
| ||
{{#special:jméno speciální stránky}}
|
{{#special:userlogin}} → Special:UserLogin
|
Lokalizovaný název pro danou kanonickou stránku Special: page (speciální: stránka). |
| ||
{{#speciale:jméno speciální stránky}}
|
{{#speciale:userlogin}} → Special:UserLogin
|
Lokalizovaný a URL kódovaný název dané kanonické stránky Special: page. |
| ||
{{#tag:jménotagu
|
Toto je příklad jakým způsobem nahradit tag <ref> , z rozšíření Citace:
|
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 Extension: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:
…může být přepsáno takto:
|
|
Pro vysvětlení funkce parseru #invoke se podívejte na w:Wikipedia:Lua#Running a module.