Help:Magic words/cs

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.

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

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, 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 $tpl-currentdayname-code, nebude do stránky vložena hodnota proměnné, ale šablona $tpl-currentdayname-result.



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.

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, které vám umožní používat funkci .



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ř. $nop-code &rarr; $nop-result zatímco $nop-r-code &rarr; $nop-r-result).

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 $pic a $pic-r, nebo $pic-subcats a $pic-subcats-r). Platí také pro 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 závisí na zvoleném jazyce stránky.



Názvy stránky
Žádné z nich nejsou ovlivněny změnami v zobrazeném názvu pomocí. Vrácené hodnoty jsou původním názvem 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ódování pro použití URL v MediaWiki (tj. mezery nahrazené podtržítky a některými znaky HTML kódování bylo ukončeno pomocí číselného kódování znaků):



Všimněte si, že,   a   mají odlišné implementace. Podrobnosti najdete na stránce.

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)

Jiné


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. Více o nich najde na stránce.



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 jmenný prostor) tedy vrací "    ". Na wiki, kde je jazykem obsahu francouzština, je  platný, ale   je nesprávný (lokalizace "File" v němčině).

The main namespace has no name, i.e.  returns an empty string. For explicitly referring to the main namespace,  can be used, resulting in "".

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í
Více najdete na stránce:.

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

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.



Modifikátory transkluze
Kód provede transkluzi obsahu stránky NazevStranky ze šablony Template:namespace. Toto výchozí chování lze pozměnit použitím modifikátorů transkluze.

Různé
Pro vysvětlení funkce parseru #invoke se podívejte na w:Wikipedia:Lua.