Příručka k rozšířením MediaWiki

Variables Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	Funkce analyzátoru Category:Parser function extensions/cs
Popis	Zavádí funkce analyzátoru (parseru) pro práci s proměnnými v rozsahu stránky.
Autoři	Rob Adams, Tom Hempel, Xiloynaha, Daniel Werner, MGChecker
Správci	MGChecker
Nejnovější verze	2.5.1 (2019-07-11)
MediaWiki	1.29+Category:Extensions with manual MediaWiki version
PHP	5.5+
Změny v databázi	Ne
Licence	Licence ISC
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs README RELEASE-NOTES
Parametry $wgVariablesAreVolatile $wgVariablesDisabledFunctions
Použité háčky (hooks) ParserClearState Category:ParserClearState extensions/cs ParserFirstCallInit Category:ParserFirstCallInit extensions/cs
Čtvrtletní stahování	102 (Ranked 42nd)
Veřejné wiki používající rozšíření	1,808 (Ranked 201st)
Přeložte rozšíření Variables, používá-li lokalizaci z translatewiki.net
Vagrant role	variables
Problémy	Otevřené úkoly · Nahlásit chybu

Varování:

Toto rozšíření není kompatibilní s plány na paralelní analýzu, jak je zamýšleno použitím Parsoid . Budoucnost tohoto rozšíření je proto nejistá a očekává se, že se během několika let stane nekompatibilním se standardním analyzátorem MediaWiki. Další informace naleznete v části T250963 a Žádná podpora pro sekvenční zpracování značek rozšíření .

Rozšíření Variables umožňuje definovat proměnnou na stránce, použít ji později na stejné stránce nebo zahrnutých šablonách, změnit její hodnotu, případně na hodnotu danou výrazem ve smyslu staré hodnoty atd. .

Podobá se šabloně, je pouze velmi jednoduché a má rozsah pouze na jednu stránku. Takže na stránce můžete použít mnoho proměnných, aniž byste zpomalili wiki s velkým množstvím šablon. Pro dosažení nejlepších výsledků zkombinujte toto rozšíření s rozšířením ParserFunctions .

Přiřazení hodnoty proměnné

Použití hodnoty proměnné

Příklady

Pro použití #expr musí být také nainstalováno ParserFunctions .

Výpočet x = 2*a + b:

• {{#vardefine:x|{{#expr:2*{{#var:a}}+{{#var:b}}}}}}

Přičíst jedna k n:

• {{#vardefine:n|{{#expr:{{#var:n}}+1}}}}

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Variables ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Variables
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'Variables' );
  

• Nakonfigurujte podle potřeby
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Konfigurace

Toto rozšíření poskytuje dva konfigurační parametry:

$egVariablesAreVolatile

Umožňuje zakázat rámec analyzátoru, který je rozšířením označen jako nestálý, tj. zakázat ukládání šablon do mezipaměti.

Výchozí: true;

$egVariablesDisabledFunctions

Umožňuje zakázat určité funkce analyzátoru poskytované tímto rozšířením.

Výchozí: [];

Příklad: [ 'var_final', 'vardefineecho' ];

Kompatibilita

Doporučená verze rozšíření Variables pro poslední vydání MediaWiki je uvedena níže. Starší verze rozšíření mohou fungovat také, ale nejsou testovány pro nová vydání MediaWiki.

Alternativy

Protože toto rozšíření nebude povoleno pro wiki provozované nadací Wikimedia Foundation (WMF), zde jsou některé alternativy:^[1][2][3][4]

• Pokud používáte proměnné jako mezipaměť pro složité operace, můžete převést sekci, kde je potřebujete, na šablonu a místo toho předat požadované informace jako parametry šablony. Toto bude fungovat, dokud nedosáhnete limitu hloubky rozšíření, které lze v případě potřeby zvýšit.
• Pokud používáte proměnné k provádění složitějších operací se šablonami, než je možné s jednoduchým Rozšíření:ParserFunctions , a pokud máte dostatečná oprávnění na serveru, můžete místo toho použít funkci Lua Scribunto. Možná nebudete moci nainstalovat Scribunto na sdílený hosting. Všimněte si, že to nepřidává podporu pro globální proměnné. Extension:VariablesLua však přidává rozhraní Scribunto pro rozšíření Variables.
• Nepoužívejte proměnné, místo toho duplikujte informace, které potřebujete, jako proměnnou. Pokud jsou tyto informace získány složitým voláním šablony, může utrpět výkon. To bude fungovat, dokud nedosáhnete limitu počtu uzlů.
• Pokud potřebujete proměnné pouze pro automatické číslování, můžete se podívat na Extension:NumerAlpha .

Související odkazy

• Rozšíření:PhpTags
• Extension:MyVariables – vytváří nové proměnné ve smyslu MediaWiki
• Extension:Loops – obsahuje funkce, které umožňují používat smyčky
• Rozšíření:Arrays – vytváří pole a poskytuje funkce pole (jako je vyhledávání, rozdělení a řazení) a operace nastavení (jako je intersect, union a diff)
• Extension:HashTables – nové funkce parseru pro práci s hashovacími tabulkami v MediaWiki

Poznámky pod čarou

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: BlueSpice Category:Extensions included in BlueSpice/cs Canasta Category:Extensions included in Canasta/cs Fandom Category:Extensions included in Fandom/cs Miraheze Category:Extensions included in Miraheze/cs Open CSPCategory:Extensions included in Open CSP/cs ProWikiCategory:Extensions included in ProWiki/cs semantic::coreCategory:Extensions included in semantic::core/cs TelepediaCategory:Extensions included in Telepedia/cs wiki.gg Category:Extensions included in wiki.gg/cs WikiForgeCategory:Extensions included in WikiForge/cs Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.