Rozšíření funkcí parseru

"Funkce analyzátoeu (parseru) " je konstrukt podobný šabloně, který vrací hodnotu na základě alespoň jednoho nepojmenovaného parametru odděleného od názvu funkce dvojtečkou [:]. Mohou existovat i další parametry; stejně jako u běžných šablon, i těmto dodatečným parametrům předchází "svislítko" [|]. V případě znaku hash na začátku názvu funkce (který zabraňuje kolizi s jmennými prostory a prefixy interwiki) může, ale nemusí být tento znak považován za součást názvu. Pokud je považován za součást názvu, syntaxe má tvar

{{functionname: argument 1 | argument 2 | argument 3...}}

<nowiki>. Pokud není zadána koncová dvojtečka, pak functionname není parserem rozpoznán.}}

Argumenty nemohou přímo obsahovat "|" nebo "}}", s výjimkou případů, kdy jsou součástí kódu volání šablony, volání funkce parseru, proměnné, odkazu nebo obrázku, ale mohou je obsahovat libovolně pomocí šablony, např. m:Template:!, nebo funkce parseru.

Kód může určit, zda se v názvu funkce rozlišují velká a malá písmena.

Oddělení argumentů od sebe navzájem je pomocí "|" a od názvu funkce je pomocí prvního středníku ":". Rozbalení každé z těchto částí je standardní, jako v Special:ExpandTemplates (což je mimochodem dobré místo pro experimentování, pokud se tyto věci učíte) a je mimo kontrolu samotné funkce parseru.

Všechno ostatní se však může u jednotlivých parserových funkcí lišit, včetně:

• zda je argument pouze hodnotou, nebo má tvar parname = parvalue nebo cokoli jiného
• pokud je to relevantní, zda se v názvech parametrů rozlišují velká a malá písmena

Vzhledem k výše uvedenému je výhodné vytvořit rozšíření tak, aby syntaxe použitá v argumentu neobsahovala znak svislé čáry "|" ani dvojité závorky (konkrétněji dvojité uzavírací závorky "}}"). A to i přes skutečnost, že by se svislá čára jinak jevila jako vhodný symbol např. pro volbu nebo sjednocení (viz např. [1]). Povolení takových kódů je neškodné, pokud je povolen i alternativní kód, např. "\" pro "|".

• Nápověda:Kouzelná slova
• Kategorie:Rozšíření funkcí parseru
• Writing parser functions (software development)
• Parser functions for Wikibase (the extensions that enables Wikidata): d:Wikidata:How to use data on Wikimedia projects

• Outdated pages/cs
• Customization techniques/cs
• Parser function extensions/cs
• Extension examples/cs