Manual:Extending wiki markup/cs
MediaWiki poskytuje standardní textové značení, které lze snadno přizpůsobit. Rozšíření mohou přizpůsobit označení wiki pomocí:
- Přidávání standardních typů tokenů: Standardním přístupem k přizpůsobenému označení MediaWiki je přidání nového označení, které vypadá jako vestavěné XML tagy (
<tag>
), template ({{...}}
) nebo odkaz ([[...]]
). - Přidávání vlastních typů tokenů: Některá rozšíření definují nové typy tokenů.
- Provádění zásadních změn v analyzátoru: Několik rozšíření se pokouší zásadně změnit strategii analýzy tak, aby bylo možné použít jiné značkovací jazyky místo standardního značkování wiki.
Přidání ke standardním typům tokenů
Nejjednodušší způsob, jak rozšířit značkování wiki, je přidáním do standardního typu tokenu pomocí jedné z těchto funkcí.
Proměnné
Proměnná volá funkci PHP, která vypíše řetězec Wikitext , který nahradí proměnnou na stránce. Proměnné se obvykle používají k vkládání systémových informací do značek wiki, jako je aktuální čas nebo aktuální stránka.
Příklad syntaxe:
{{VARIABLENAME}}
Chcete-li definovat proměnnou, podívejte se na stránku Manual:Variables . Seznam rozšíření, která definují vlastní proměnné, najdete na stránce Kategorie:Variabilní rozšíření .
Funkce parseru
Stejně jako proměnné i funkce analyzátoru volá funkci PHP a vydává řetězec wikitext, který na stránce nahrazuje funkci analyzátoru. Na rozdíl od proměnných může funkce analyzátoru předávat parametry funkci PHP. Funkce analyzátoru se používají ke zpracování generování wikitextu, který zahrnuje logiku, která je příliš složitá nebo matoucí pro psaní pomocí šablon.
Příklad syntaxe:
{{#functionname: param1 | param2}}
Chcete-li definovat funkci analyzátoru, podívejte se na stránku Příručka:Parsovací funkce . Seznam rozšíření, která definují vlastní funkce analyzátoru, naleznete na stránce Kategorie:Rozšíření funkcí parseru .
Značky analyzátoru
Na rozdíl od proměnných a funkcí analyzátoru, které vydávají wikitext, tagy analyzátoru vydávají HTML.
Značka analyzátoru je značka XML, která volá funkci PHP, analyzuje obsah značky a vydává HTML, které značku a její obsah na stránce nahradí.
Značky analyzátoru mohou také předávat argumenty funkci PHP.
Například <syntaxhighlight>
je značka analyzátoru definovaná pomocí Extension:SyntaxHighlight .
Příklad syntaxe:
<tagname param1name="param1value" param2name="param2value"> some text </tagname>
Chcete-li definovat značku analyzátoru, podívejte se na stránku Příručka:Rozšíření značek (tagů) . Seznam rozšíření, která definují vlastní značky analyzátoru, najdete na stránce Kategorie:Rozšíření značek .
Přepínače chování
Přepínač chování volá funkci PHP, ale na rozdíl od jiných metod rozšiřování značek wiki přepínače chování obvykle nevydávají žádný obsah.
Místo toho změní chování stránky nebo nastaví vlastnost stránky.
Například přidání __NOTOC__
na stránku skryje obsah.
Příklad syntaxe:
__SWITCHNAME__
Chcete-li definovat přepínač chování, podívejte se na stránku Příručka:Kouzelná slovíčka . Seznam rozšíření, která definují vlastní přepínače chování, naleznete na stránce Nápověda:Kouzelná slova .
Označení odkazu
Přizpůsobení značek odkazů mění způsob, jakým MediaWiki interpretuje interní odkazy.
Příklad syntaxe:
[[ ... ]]
Seznam rozšíření, která definují vlastní označení odkazů, naleznete na stránce Kategorie:Rozšíření značek odkazů .
Přidávání nových typů tokenů
Chcete-li přidat nové typy tokenů nebo změnit celou strategii značkování, musí implementátoři přidat funkce do jednoho nebo více různých analyzátorů a výstupů stránky háčků:
- Kategorie:Rozšíření ParserBeforeStrip spoléhá na háček ParserBeforeStrip . (odstraněno od 1.36)
- Kategorie:Rozšíření ParserBeforeInternalParse spoléhá na háček ParserBeforeInternalParse .
- Kategorie:Rozšíření OutputPageBeforeHTML spoléhá na háček OutputPageBeforeHTML .
- Kategorie:Rozšíření ParserAfterTidy spoléhá na háček ParserAfterTidy .
Viz také Kategorie:Rozšíření pomocí použití zaháčkování .
Související odkazy
- Příručka:Rozšíření - poskytuje obecné pokyny pro hledání, instalaci a zápis rozšíření.