Help:Magic words/cs

Kouzelná slova (angl. Magic words) jsou textové řetězce, kterými MediaWiki nahrazuje funkci nebo její návratovou hodnotou. 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. Pro technické podrobnosti viz.

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ř.  .
 * Proměnné: verzálkové řetězce uzavřené dvojitými složenými závorkami, např.  . Používají se podobně jako šablony.
 * Funkce parseru: těm se předávají parametry a volají se pomocí   nebo  , např. . Více o nich viz  a.

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če chování ovlivňují výchozí zobrazení stránky nebo její chování (podporuje-li to vzhled), takže si lze s jejich pomocí vynutit změny v interpretaci obsahu stránky. Některé z nich nepodporuje jmenovitě vzhled Minerva.

Proměnné
Proměnné vrací informace o aktuální stránce, wiki, nebo datu. 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    :PAGENAME, nestačí pouze její jméno, musíte uvést i jmenný prostor, takto  ). Někdy donutí parser k použití šablony předaný parametr; takže když napíšete, nebude do stránky vložena hodnota proměnné, ale šablona     :CURRENTDAYNAME.

Datum a čas
Následující proměnné vrací aktuální datum a čas v UTC formátu.

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.

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



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 $ext-parserfunctions které vám umožní používat funkci #time.

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ř.,  &rarr;  kdežto   &rarr; ).

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  a , nebo   a  ). Podobným způsobem lze použít tento parametr i u výše uvedené proměnné pro zjištění velikosti 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, závisí na zvoleném jazyce stránky.

Jména stránek
Žádné z nich nejsou ovlivněny změnami v zobrazeném názvu pomocí ; vrácené hodnoty jsou původní název stránky.

Magická slova  a   fungují pouze v jmenných prostorech, které mají povoleny podstránky. Informace o povolení podstránek naleznete na stránce.

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:



URL stránek kódovaná dle HTML standardu
Ekvivalenty kódované pro použití v URL MediaWiki (tj. Mezery nahrazené podtržítky a některými znaky HTML uniklo pomocí kódování číselných znaků):



Všimněte si, že,   a   mají odlišné implementace. Podrobnosti viz Návod: PAGENAMEE kódování.

Jmenné prostory
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):



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:

Jako parametr se předává pouze název bez jmenného prostoru:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Funkce parseru
Funkce syntaktického analyzátoru (Parser) jsou velmi podobné proměnným, ale mají jeden nebo více parametrů (technicky je každé kouzelné slovo, které má parametr, syntaktickou funkcí), a jméno je někdy předponováno znakem hash pro rozlišení, že je ze š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. Více o nich.

Jmenné prostory
vrátí aktuální lokalizovaný název pro jmenný prostor s tímto indexem, kanonickým názvem nebo lokálním aliasem. ,  a   (staré jméno pro obor názvů souborů) tedy vrací "    ". Na wiki, kde je jazykem obsahu francouzština, je  platný, ale   je nesprávný (lokalizace "File" v němčině) není.

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.

Nezaměňujte lokalizované jmenné prostory s obvyklými jmennými prostory.

Formátování
Viz také:.

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, 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í.

Použití takových kouzelných slov je poměrně složité a ne moc dobře dokumentované. S jejich použitím se můžete více dozvědět na stránkách PLURAL, GRAMMAR, GENDER.

Transkluzní modifikátory
Kód  provede transkluzi obsahu stránky Jméno stránky ze jmenného prostoru Template (Šablona). Toto výchozí chování lze pozměnit použitím transkluzních modifikátorů.

Různé
For parser function #invoke, see en:Wikipedia:Lua.