Extension:Scribunto/cs

Rozšíření Scribunto (Latin: "budou psát/nechají je psát (v budoucnu)") umožňuje vkládání skriptovací jazyky na MediaWiki.

V současnosti je jediným podporovaným skriptovacím jazykem Lua. Skripty Scriunto Lua se nacházejí ve jmenném prostoru zvaném Modul. Modules are run on normal wiki pages using the #invoke parser function and each module has a collection of functions, which can be called using wikitext syntax such as:

Licence
Toto rozšíření obsahuje kód licencovaný GNU General Public License v2.0 nebo novější (GPL-2.0+) a také kód licencovaný MIT License (MIT).

Požadavky


Kompatibilita PCRE verze
Doporučuje se PCRE 8.33+. PCRE 8.33 byla vydána v květnu 2013. Verzi PCRE používanou PHP můžete vidět na phpinfo webové stránce nebo z příkazového řádku pomocí následujícího příkazu:


 * Scriunto nebude fungovat s verzemi PCRE nižšími než 8.10.
 * PCRE 8.31 obsahuje chyby se vzorem JIT, který zkoumá, že rozbíjí různé vzory při použití s HHVM.
 * PCRE 8.32 obsahuje chybu, která způsobí odmítnutí určitých neznakových kódových bodů, což způsobí chyby v modulu mw.html.

CentOS 6 a RHEL 6 uvízly na PCRE 7 a je třeba je aktualizovat.

Aktualizace na 8.33 na serveru se starší verzí může být poměrně komplikovaná. Podrobnosti viz.

PHP pcntl (LTS)
Verze Scribunto pro MediaWiki 1.25 až 1.28 vyžadovaly PHP rozšíření pcntl, které je dostupné pouze na platformách Unix/Linux, pokud chcete používat "LuaStandalone" (tj. běžící v samostatném podřízeném procesu). Tento požadavek byl odstraněn v Scribunto pro MediaWiki 1.29.

Zda je podpora pcntl povolena, můžete zkontrolovat zobrazením webové stránky phpinfo nebo z příkazového řádku pomocí následujícího příkazu:



Rozšíření PHP mbstring
PHP potřebuje mít povolené rozšíření mbstring.

Zda je podpora mbstring povolena, můžete zkontrolovat zobrazením webové stránky phpinfo nebo z příkazového řádku pomocí následujícího příkazu:



Binární Lua


Balené binární soubory
Scribunto je dodáváno s binárními distribucemi Lua pro Linux (x86 a x86-64), Mac OS X Lion a Windows (32- a 64-bit).

Scribunto by vám mělo fungovat hned po vybalení, pokud:

P.S. Zkontrolujte svou verzi rozšíření a zjistěte, zda je název složky engine velkými nebo malými písmeny.
 * 1) Váš webový server běží na jedné z výše uvedených platforem.
 * 2) Funkce   PHP není omezena.
 * 3) Váš webový server je nakonfigurován tak, aby umožňoval spouštění binárních souborů ve stromu MediaWiki.
 * Možná bude nutné nastavit oprávnění ke spouštění; například v Linuxu použijte:
 * Pokud na svém serveru používáte SELinux v režimu "Enforcing", možná budete muset nastavit správný kontext pro binární soubory. Příklad pro RHEL/CentOS 7:



Další binární soubory
Další binární distribuce Lua, které mohou být potřeba pro váš webový server, pokud jeho operační systém není ve výše uvedeném seznamu, lze získat od http://luabinaries.sourceforge.net/ nebo z vaší distribuce Linuxu.

Podporovány jsou pouze binární soubory pro Lua 5.1.x.

Jakmile na svůj webový server nainstalujete příslušný binární soubor, nakonfigurujte umístění souboru pomocí:

Všimněte si, že byste neměli přidávat výše uvedený řádek, pokud jste nepotvrdili, že vestavěné binární soubory Scriunto pro vás nefungují.

LuaJIT, ačkoliv je teoreticky kompatibilní, není podporován.

Podpora byla odstraněna kvůli Spectre (bezpečnostní zranitelnost) a obavám o bitrot (T184156).

Instalace


Volitelná instalace


Integrace rozšíření
Pro příjemnější uživatelské rozhraní se zvýrazněním syntaxe a editorem kódu s automatickým odsazením nainstalujte následující rozšíření:

Poté do svého  po všech registracích rozšíření přidejte:

LuaSandbox
Vyvinuli jsme rozšíření PHP napsané v C s názvem LuaSandbox. Lze jej použít jako alternativu k samostatnému binárnímu systému a poskytne lepší výkon. Podrobnosti a pokyny k instalaci viz.

Pokud jste původně nainstalovali rozšíření pro použití samostatného binárního souboru Lua, nezapomeňte aktualizovat  s následujícím konfiguračním nastavením:

Konfigurace
K dispozici jsou následující konfigurační proměnné:
 * $wgScribuntoDefaultEngine
 * Vyberte zdroj. Platné hodnoty jsou klíče v, které jsou ve výchozím nastavení  nebo.


 * $wgScribuntoUseGeSHi
 * Když je nainstalováno, nastavte tuto hodnotu na hodnotu true, abyste jej použili při zobrazování stránek modulu. (MediaWiki 1.30 nebo starší.)


 * $wgScribuntoUseCodeEditor
 * Když je nainstalováno, nastavte tuto proměnnou na , aby se používala při úpravách stránek modulu. (MediaWiki 1.30 nebo starší.)


 * $wgScribuntoEngineConf
 * Asociativní pole pro konfiguraci zdroje. Klíče jsou platné hodnoty pro a hodnoty jsou asociativní pole konfiguračních dat. Každé konfigurační pole musí obsahovat klíč   pojmenující podtřídu , která se má použít.

LuaStandalone
Následující klíče se používají v na. Obecně byste je nastavili jako něco podobného


 * luaPath
 * Zadejte cestu k interpretu Lua.


 * errorFile
 * Zadejte cestu k souboru, do kterého může uživatel webového serveru zapisovat, kam bude protokolován výstup chyb a ladění ze samostatného interpretu.
 * Chybový výstup vytvořený samostatným interpretem není standardně protokolován. Nakonfigurujte protokolování pomocí:


 * memoryLimit
 * Zadejte limit paměti v bajtech pro samostatný interpret v systému Linux (vynucený pomocí ulimit).


 * cpuLimit
 * Zadejte časový limit CPU v sekundách pro samostatný interpret v systému Linux (vynucený pomocí ulimit).


 * allowEnvFuncs
 * Nastavením true umožníte použití setfenv a getfenv v modulech.

LuaSandbox
Následující klíče se používají v na. Obecně byste je nastavili jako něco podobného


 * memoryLimit
 * Zadejte limit paměti v bajtech.


 * cpuLimit
 * Zadejte časový limit CPU v sekundách.


 * profilerPeriod
 * Určete dobu mezi průzkumy v sekcích pro Lua profiler.


 * allowEnvFuncs
 * Nastavením true umožníte použití setfenv a getfenv v modulech.

Použití
Skripty se ukládají do nového jmenného prostoru nazvaného Module. Každý modul má sbírku funkcí, které lze volat pomocí syntaxe wikitextu, jako například:

Lua


Učení Lua
Lua je jednoduchý programovací jazyk určený pro začátečníky. Pro rychlokurz Lua vyzkoušejte Naučte se Lua za 15 minut.

Nejlepší komplexní úvod do Lua je kniha Programování v Lua. První vydání (pro Lua 5.0) je k dispozici online a je většinou relevantní pro Lua 5.1, verzi používanou Scribunto:


 * Programování v Lua (přejděte dolů za reklamy na knihy a vyhledejte text)

Užitečná je také referenční příručka:



Prostředí Lua
V Lua se množina všech globálních proměnných a funkcí nazývá prostředí.

Každé volání na úrovni  probíhá v samostatném prostředí. Proměnné definované v jednom  nebudou dostupné v jiném. Toto omezení bylo nezbytné pro zachování flexibility v implementaci analyzátoru wikitextu.



Ladicí konzole



 * Podívejte se také na: 

Při editaci Lua modulu lze pod editačním formulářem nalézt tzv. "ladicí konzoli". V této konzoli pro ladění lze kód Lua spustit, aniž byste museli ukládat nebo dokonce vytvářet příslušný modul Lua.

Řešení problémů


Upozorňujeme, že na červené zprávy lze kliknout a poskytnou podrobnější informace.

Při použití zdroje LuaStandalone (toto je výchozí nastavení) mohou být generovány chyby ve tvaru "", pokud samostatný interpret Lua nelze spustit nebo narazí na různé runtime chyby. Chcete-li získat další informace, přiřaďte cestu k souboru. Chybový výstup interpretu bude zaprotokolován do zadaného souboru, což by mělo být užitečnější při sledování problému. Informace v protokolu ladění obsahují informace o ladění, proto je jich tolik. Měli byste být schopni ignorovat jakýkoli řádek začínající "TX" nebo "RX".

Pokud nastavujete Scriunto a používáte IIS/Windows, zdá se, že je to vyřešeno zakomentováním a konkrétní řádek.

Při použití zdroje LuaStandalone (toto je výchozí nastavení) stav 2 naznačuje chyby při alokaci paměti, pravděpodobně způsobené nastavením, které alokuje nedostatečný paměťový prostor pro PHP nebo Lua nebo obojí. Přiřazení cesty k souboru  a prozkoumání tohoto výstupu může být cenné při diagnostice chyb při alokaci paměti.

Zvyšte alokaci PHP ve vaší konfiguraci PHP. Přidejte řádek. Tato alokace 200 MB je často dostatečná (od MediaWiki 1.24), ale může být podle potřeby zvýšena. Nastavte alokaci paměti Scriunto v  jako řádek: Nakonec, v závislosti na konfiguraci serveru, může některým instalacím pomoci přidání dalšího řádku

Všimněte si, že všechny 3 limity paměti jsou uvedeny v různých jednotkách.



Chyba Lua: Vnitřní chyba: 2. na architektuře ARM
Pokud používáte procesor s architekturou ARM jako na RaspberryPi, budete čelit chybě  kvůli nesprávně dodanému binárnímu formátu překladače Lua.

Zkontrolujte svůj překladač Lua v: /path/to/webdir/Scribunto/includes/Engines/LuaStandalone/binaries/lua5_1_5_linux_32_generic

Zkontrolujte překladač pomocí: file lua Výsledek by měl vypadat takto: lua: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, for GNU/Linux 3.2.0 Nainstalovaný výchozí interpret Lua zobrazuje: lua: ELF 32-bit LSB pie executable, Intel 80386, version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux.so.2, for GNU/Linux 2.6.9, podívejte se na část "Intel 80386", která rozhodně není správná.

Zkontrolujte v, jakou verzi Lua máte nainstalovanou ve vašem systému. Pokud máte nainstalovaný lua5.1, můžete buď zkopírovat interpret do svého adresáře, nebo nastavit ve svém LocalSettings.php:

V současné době nenastavujte  až /usr/bin/lua5.3, povede to k "interní chybě 1".

Při použití zdroje LuaStandalone (toto je výchozí nastavení) stav 24 naznačuje chyby časového limitu CPU, ačkoli ty by měly místo toho generovat zprávu "The time allocated for running scripts has expired" (čas přidělený pro spouštění skriptů vypršel). Bylo by užitečné zadat úkol v a podílet se na určování, proč signál XCPU není zachycen.

Při použití zdroje LuaStandalone (toto je výchozí nastavení) mohou být generovány chyby ve tvaru "", pokud nelze spustit samostatný interpret Lua. To obvykle vzniká z jedné ze dvou příčin:


 * Oprávnění spustitelného souboru Lua nezahrnují Execute (spustit). Nastavte oprávnění, jak je popsáno v #Instalaci.
 * Server neumožňuje spouštění souborů z místa, kde je spustitelný soubor nainstalován, např. souborový systém je připojen s příznakem . K tomu často dochází u sdílených hostovaných serverů. Nápravy zahrnují úpravu   tak, aby ukazoval na binární soubor Lua 5.1 nainstalovaný ve spustitelném umístění, nebo úpravu či přesvědčování sdíleného hostitele, aby upravil nastavení bránící spuštění.



Chybový stav jako: Závažná výjimka typu MWException
Další podrobnosti o výjimce naleznete v protokolech MediaWiki, PHP nebo webového serveru nebo dočasně nastavte na.



verze 'GLIBC_2.11' nenalezena
Pokud se vám výše uvedené zobrazí chyby jako "version 'GLIBC_2.11' not found" (verze 'GLIBC_2.11' nenalezena), znamená to, že verze standardní knihovny C ve vašem systému je příliš stará pro binární soubory dodávané se Scriuntem. Měli byste aktualizovat svou knihovnu C nebo použít verzi Lua 5.1 zkompilovanou pro knihovnu C, kterou máte nainstalovanou. Chcete-li aktualizovat svou knihovnu C, nejlepší možností je obvykle postupovat podle pokynů vaší distribuce pro aktualizaci balíčků (nebo pro přechod na nové vydání distribuce, pokud je to možné).

Pokud zkopírujete binárky lua z masteru Scriunto (nebo z 77905), mělo by to stačit, pokud nemůžete nebo nechcete aktualizovat svou knihovnu C. Distribuované binární soubory byly nedávno překompilovány proti starší verzi glibc, takže minimum je nyní 2.3 namísto 2.11.



Chyby Lua v souborech Scriunto
Chyby zde zahrnují:
 * pokus o indexování pole 'text' (nulová hodnota)
 * Chyba Lua v mw.html.lua na řádku 253: Zadaná neplatná třída:

Pokud se vám při pokusu o použití modulů importovaných z WMF wiki zobrazují chyby, jako jsou tyto, je pravděpodobně vaše verze Scriunto zastaralá.

Aktualizujte, pokud je to možné. Pro pokročilé uživatele se můžete také pokusit identifikovat potřebné novější vydání a vybrat je do místní instalace.



preg_replace_callback: Kompilace se nezdařila: Neznámý název vlastnosti za \P nebo \p na offsetu 7

 * to obvykle označuje nekompatibilní verzi PCRE. Budete muset aktualizovat na >= 8.10
 * @todo: odkaz na pokyny k upgradu



Chyba Lua
Pokud zkopírujete šablony z Wikipedie a poté se zobrazí velká červená zpráva "Lua error: x" tam, kde by mělo být vyvolání Scriunto (např. šablona, která používá ), pravděpodobně to znamená, že jste neimportovali vše, co jste potřebovali. Ujistěte se, že jste při exportu zaškrtli políčko "Include templates" (zahrnout šablony) na w:Special:Export.

Při importu stránek z jiné wiki je také možné, že šablony nebo moduly v importovaných datech přepíší existující šablony nebo moduly se stejným názvem, což může poškodit stávající stránky, šablony a moduly, které závisí na přepsaných verzích.

<span id="Blank_screen">

Prázdná obrazovka
Ujistěte se, že je vaše verze rozšíření použitelná pro vaši verzi MediaWiki.

<span id="Design_documents">

Návrhové dokumenty

 * Linux.conf.au 2014 - Scribunto presentation.webm na linux.conf.au 2014 pojednávající o motivacích, implementačních problémech a výsledcích nasazení Scriunto a Lua.]]

<span id="Other_pages">

Ostatní stránky

 * - Stránka aktivity Wikimedie popisující plán nasazení na stránky Wikimedie.
 * - Odkaz na jazyk Lua, stejně jako jeho standardní knihovny a běžné moduly Scriunto podporované na stránkách Wikimedie.
 * - Seznam známých změn v Lua 5.2, které mohou způsobit neočekávané fungování kódu napsaného v 5.1.
 * - Kódujte například rozšíření rozšiřující knihovnu Scriunto.
 * - Seznam známých změn v Lua 5.2, které mohou způsobit neočekávané fungování kódu napsaného v 5.1.
 * - Kódujte například rozšíření rozšiřující knihovnu Scriunto.
 * - Kódujte například rozšíření rozšiřující knihovnu Scriunto.

<span id="See_also">

Související odkazy

 * General
 * - funkce pro rozšíření Scriunto.
 * Commons:Lua – mohou existovat specifické poznámky k používání modulů Lua na Wikimedia Commons, včetně nainstalovaných dalších rozšíření Lua (např. pro místní podporu internacionalizace a pro analýzu nebo přehrávání médií). Některé moduly pro všeobecné použití mohou být znovu použity v jiných wiki v různých jazycích (kromě specifických ladění pro zásady, jmenné prostory nebo stránky projektu/údržby s vyhrazenými názvy). Pokud je to možné, moduly, které by mohly být široce znovu použity na wikinách, by měly být testovány a internacionalizovány na Wikimedia Commons.
 * w:Help:Lua – mohou existovat konkrétní poznámky k používání modulů Lua na Wikipedii, včetně nainstalovaných dalších rozšíření Lua (včetně integrace obsahu Wikidata a Wikimedia Commons, generování složitých informačních polí a navigačních polí nebo pro usnadnění obecné správy /údržba obsahu wiki podle platných zásad). Některé další lokalizované edice Wikipedie (nebo jiné projekty, jako je Wikislovník, Wikisource nebo Wikinews) mohou mít také své vlastní potřeby a moduly Lua.
 * d:Help:Lua – mohou existovat konkrétní poznámky k používání modulů Lua na Wikidatech, včetně nainstalovaných dalších rozšíření Lua (např. pro místní podporu internacionalizace a pro databázové dotazy)
 * Extensions
 * - Poskytuje základní infobox funkce pro rozšíření Scriunto.
 * - Poskytuje základní |infobox funkce pro rozšíření Scriunto.
 * - poskytuje rozhraní Scriunto Lua pro rozšíření Variables
 * - poskytuje (součást projektu Wikidata)


 * Gadgets
 * Widgets