Extension:Scribunto/tr

Scribunto (Latince: "yazacakları izin verecekler (gelecekte)") uzantısı, MediaWiki'de betik dilleri yerleştirmesine izin verir.

Şu anda desteklenen tek betik dili Lua'dır. Scribunto Lua betikleri Modül adı verilen bir ad alanına gider.

Lisans
Bu uzantı, kod lisanslı GNU Genel Kamu Lisansı v2.0 veya daha yenisini (GPL-2.0+) ve kod lisanslı MIT Lisansını (MIT) içerir.

PCRE sürüm uyumluluğu
PCRE 8.33+ önerilir. PHP tarafından kullanılan PCRE sürümünü bir phpinfo web sayfasını görüntüleyerek veya komut satırından aşağıdaki komutla görebilirsiniz:


 * Scribunto, PCRE'nin 8.10'dan düşük sürümleriyle çalışmaz.
 * PCRE 8.31, HHVM ile kullanıldığında çeşitli paternleri kırma çalışmasını JIT örüntülü hatalara sahiptir.
 * PCRE 8.32, mw.html modülünde hatalara neden olacak belirli karakter olmayan kod noktalarının reddedilmesine neden olacak hata içerir.

CentOS 6 ve RHEL 6 PCRE 7'ye yapışmış durumda ve yükseltilmeleri gerekiyor.

Daha eski bir sürüme sahip bir sunucuda 8.33'e güncellemek nispeten karmaşık olabilir. Ayrıntılar için Updating to PCRE 8.33 or Higher sayfasına bakın.

PHP pcntl (LTS)
MediaWiki 1.25 - 1.28 için Scribunto sürümleri, "LuaStandalone" kullanmak istiyorsanız (yani ayrı bir alt süreçte çalışıyorsa) yalnızca Unix/Linux platformlarında bulunan PHP'nin pcntl uzantısını gerektirir. Bu gereksinim MediaWiki 1.29 için Scribunto'da kaldırılmıştır.

Bir phpinfo web sayfasını görüntüleyerek veya aşağıdaki komutla komut satırından pcntl desteğinin etkin olup olmadığını kontrol edebilirsiniz:

PHP mbstring uzantısı
PHP'nin mbstring uzantısının etkinleştirilmiş olması gerekir.

mbstring desteğinin etkinleştirilip etkinleştirilmediğini phpinfo web sayfasını görüntüleyerek veya aşağıdaki komutla komut satırından kontrol edebilirsiniz:

Paketlenmiş ikili dosyalar
Scribunto, Linux (x86 ve x86-64), Mac OS X Lion ve Windows (32- ve 64-bit) için Lua ikili dağıtımlarıyla birlikte gelir.

Scribunto, aşağıdaki durumlarda kutunun dışında sizin için çalışmalıdır:


 * 1) Web sunucunuz yukarıdaki platformlardan birinde çalışıyor.
 * 2) PHP'nin   işlevi kısıtlı değildir.
 * 3) Web sunucunuz, MediaWiki ağacında ikili dosyaların yürütülmesine izin verecek şekilde yapılandırılmıştır.
 * Yürütme izinlerinin ayarlanması gerekebilir; örneğin, Linux kullanımında:
 * If you are using SELinux in "Enforcing" mode on your server, you might need to set a proper context for the binaries. Example for RHEL/CentOS 7:

Ek ikili dosyalar
İşletim sistemi yukarıdaki listede yoksa web sunucunuz için gerekli olabilecek ek Lua ikili dağıtımları http://luabinaries.sourceforge.net/ adresinden veya Linux dağıtımınızdan edinilebilir.

Yalnızca Lua 5.1.x için ikili dosyalar desteklenir.

Web sunucunuza uygun ikili dosyayı yükledikten sonra, dosyanın konumunu şu şekilde yapılandırın:

Scribunto'nun yerleşik ikili dosyalarının sizin için çalışmadığını onaylamadığınız sürece yukarıdaki satırı eklememeniz gerektiğini unutmayın.

LuaJIT, teorik olarak uyumlu olmasına rağmen desteklenmez.

Destek, Spectre ve bitrot endişeleri (T184156) nedeniyle kaldırıldı.

Uzantıları entegre etme
Sözdizimi vurgulamalı ve otomatik girintili kod düzenleyicili daha hoş bir kullanıcı arayüzü için aşağıdaki uzantıları yükleyin:

Ardından, tüm uzantı kayıtlarından sonra  dosyanıza şunu ekleyin:

LuaSandbox
C ile yazılmış LuaSandbox adında bir PHP uzantısı geliştirdik. Bağımsız ikililere alternatif olarak kullanılabilir ve gelişmiş performans sağlayacaktır. Ayrıntılar ve kurulum talimatları için sayfasına bakın.

Uzantıyı başlangıçta Lua bağımsız ikili dosyasını kullanmak için yüklediyseniz, aşağıdaki yapılandırma ayarıyla  ile güncellediğinizden emin olun:

Yapılandırma
Aşağıdaki yapılandırma değişkenleri mevcuttur:
 * $wgScribuntoDefaultEngine
 * Motoru seçin. Geçerli değerler, varsayılan olarak  veya   olan   içindeki anahtarlardır.


 * $wgScribuntoUseGeSHi
 * yüklendiğinde, Modül sayfalarını görüntülerken bunu kullanmak için bunu true olarak ayarlayın. (MediaWiki 1.30 veya öncesi.)


 * $wgScribuntoUseCodeEditor
 * yüklendiğinde, Modül sayfalarını düzenlerken kullanmak için bunu  olarak ayarlayın. (MediaWiki 1.30 veya öncesi.)


 * $wgScribuntoEngineConf
 * Motor yapılandırması için ilişkilendirilebilir bir dizi. Anahtarlar,  için geçerli değerlerdir ve değerler, yapılandırma verilerinin ilişkilendirilebilir dizileridir. Her yapılandırma dizisi, kullanılacak   alt sınıfını adlandıran bir   anahtarı içermelidir.

LuaStandalone
Aşağıdaki anahtarlar  için   için kullanılır. Genellikle bunları böyle bir şey olarak


 * luaPath
 * Bir Lua yorumlayıcısının yolunu belirtin.


 * errorFile
 * Tek başına yorumlayıcıdan gelen hata ve hata ayıklama çıkışının günlüğe kaydedileceği web sunucusu kullanıcısı tarafından yazılabilir bir dosyanın yolunu belirtin.
 * Bağımsız yorumlayıcı tarafından üretilen hata çıkışı varsayılan olarak günlüğe kaydedilmez. Günlüğü aşağıdakilerle yapılandırın:


 * memoryLimit
 * Linux'ta bağımsız yorumlayıcı için (ulimit kullanılarak zorlanmış) bayt cinsinden bellek sınırını belirtin.


 * cpuLimit
 * Linux'ta bağımsız yorumlayıcı için (ulimit kullanılarak zorlanır) CPU zaman sınırını saniye cinsinden belirtin.


 * allowEnvFuncs
 * Modüllerde setfenv ve getfenv kullanımına izin vermek için true olarak ayarlayın.

LuaSandbox
Aşağıdaki anahtarlar  için   için kullanılır. Genellikle bunları böyle bir şey olarak


 * memoryLimit
 * Bellek sınırını bayt cinsinden belirtin.


 * cpuLimit
 * CPU zaman sınırını saniye cinsinden belirtin.


 * profilerPeriod
 * Lua profil oluşturucusu için bölümlerde anketler arasındaki süreyi belirtin.


 * allowEnvFuncs
 * Modüllerde setfenv ve getfenv kullanımına izin vermek için true olarak ayarlayın.

Kullanım
Betikler, Modül adlı yeni bir ad alanına gider. Her modül, vikimetin sözdizimi kullanılarak çağrılabilen bir dizi işlevine sahiptir:

Lua öğrenme
Lua yeni başlayanlar tarafından erişilebilir olması amaçlanan basit bir programlama dilidir. Lua hakkında hızlı bir kurs için 15 Dakikada Lua Öğren'i deneyin.

Lua'ya en kapsamlı giriş, 2'Lua'da Programlama'' kitabıdır. İlk baskı (Lua 5.0 için) çevrimiçi olarak mevcuttur ve çoğunlukla Scribunto tarafından kullanılan Lua 5.1 ile ilgilidir:


 * Lua'da programlama (metni bulmak için kitap reklamlarını aşağı kaydırın)

Kaynak el kitabı da yararlıdır:

Lua ortamı
Lua'da, tüm küresel değişkenlerin ve işlevlerin kümesine ortam denir.

Her  çağrı ayrı bir ortamda çalışır. Bir  içinde tanımlanan değişkenler diğerinden kullanılamaz. Bu kısıtlama, vikimetin ayrıştırıcısı uygulamasında esnekliği korumak için gerekliydi.

Hata ayıklama konsolu



 * Ayrıca bakınız: 

Bir Lua modülünü düzenlerken düzenleme formunun altında "hata ayıklama konsolu" bulunur. Bu hata ayıklama konsolunda Lua kodu, söz konusu Lua modülünü kaydetmek veya hatta oluşturmak zorunda kalmadan yürütülebilir.

Sorun giderme


Kırmızı iletilerin tıklanabilir olduğunu ve daha ayrıntılı bilgi sağlayacağını unutmayın.

LuaStandalone motorunu kullanırken (bu varsayılan değerdir), bağımsız Lua yorumlayıcısı çalıştırılamazsa veya çeşitli çalışma zamanı hatalarıyla karşılaşırsa, "" satırındaki hatalar üretilebilir. Daha fazla bilgi edinmek için  ile bir dosya yolu atayın. Tercümanın hata çıkışı, belirtilen dosyaya kaydedilir ve bu da sorunun izlenmesinde daha yararlı olur. Hata ayıklama günlüğündeki bilgiler hata ayıklama bilgilerini içerir, bu yüzden bu kadar çok şey vardır. "TX" veya "RX" ile başlayan satırları yoksayabilirsiniz.

Scribunto'yu kuruyorsanız ve IIS/Windows kullanıyorsanız, bu durum belirli bir satır yorumlanarak çözülmüş görünüyor.

LuaStandalone motorunu kullanırken (bu varsayılan değerdir), durum 2, muhtemelen PHP veya Lua veya her ikisi için yetersiz bellek alanı ayıran ayarlardan kaynaklanan bellek ayırma hataları önerir. değerine bir dosya yolu atamak ve bu çıkışı incelemek bellek ayırma hatalarının teşhisinde değerli olabilir.

PHP yapılandırmanızda PHP ayırmayı artırın;  satırını ekleyin. 200MB'lık bu ayırma genellikle yeterlidir (MediaWiki 1.24'ten itibaren), ancak gerektiği gibi artırılabilir. Scribunto'nun  dosyasındaki bellek ayırmasını satır olarak ayarlayın: Son olarak, sunucu yapılandırmasına bağlı olarak, başka bir LocalSettings.php satırı ekleyerek bazı kurulumlara yardımcı olabilirsiniz

3 bellek sınırının da farklı birimlerde verildiğini unutmayın.

Lua error: Internal error: 2. on ARM architecture
If you're using an ARM architecture processor like on a RaspberryPi you'll face the error  due to wrong delivered binary format of the Lua interpreter.

Check your Lua interpreter in: /path/to/webdir/Scribunto/includes/engines/LuaStandalone/binaries/lua5_1_5_linux_32_generic

Check the interpreter by using: file lua The result should look like : 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 The installed default Lua interpreter shows: 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, look at the "Intel 80386" part what definitely is not correct.

Check in  what version of Lua is installed on your system. If you have lua5.1 installed, you can either copy the interpreter to your  directory or set in your LocalSettings.php:

At present don't set  to /usr/bin/lua5.3, it'll lead to the "Internal error 1".

LuaStandalone motoru kullanılırken (bu varsayılan değerdir), durum 24 CPU zaman sınırı hataları önerir, ancak bunun yerine "Betikleri çalıştırmak için ayrılan süre doldu" mesajı oluşturmalıdır. Phabricator içine bir görev vermek ve XCPU sinyalinin neden yakalanmadığını belirlemeye katılmak yararlı olacaktır.

LuaStandalone motorunu kullanırken (bu varsayılan değerdir), bağımsız Lua yorumlayıcısı yürütülemezse, "" satırı boyunca hatalar üretilebilir. Bu genellikle iki nedenden birinden kaynaklanır:

Bu genellikle paylaşılan barındırılan sunucularda görülür. Çözümler arasında,  yürütülebilir bir konuma kurulmuş bir Lua 5.1 ikili dosyasını gösterecek şekilde ayarlamak veya paylaşılan ana bilgisayarı yürütmeyi önleyen ayarı ayarlamak için ayarlamak veya ikna etmek yer alır.
 * Lua yürütülebilir dosyasının izinleri Yürüt öğesini içermez. İzinleri #Kurulum altında açıklandığı şekilde ayarlayın.
 * Sunucu, yürütülebilir dosyanın yüklü olduğu yerden dosyaların yürütülmesine izin vermez, örn. dosya sistemi 'noexec' işaretiyle bağlanır.

Aşağıdaki hata koşulu: MWException türünün önemli istisnası
İstisna hakkında daha fazla ayrıntı için MediaWiki, PHP veya web sunucusu günlüklerine bakın veya geçici olarak değerini true olarak ayarlayın.

`GLIBC_2.11' sürümü bulunamadı
Yukarıdaki "`GLIBC_2.11' sürümü bulunamadı" gibi hatalar veriyorsa, sisteminizdeki standart C kütüphanesinin sürümü Scribunto ile sağlanan ikili dosyalar için çok eski olduğu anlamına gelir. C kitaplığınızı yükseltmeniz veya yüklediğiniz C kitaplığı için derlenmiş Lua 5.1 sürümünü kullanmanız gerekir. C kitaplığınızı yükseltmek için en iyi seçeneğiniz genellikle dağıtımınızın paketleri yükseltme (veya varsa dağıtımın yeni bir sürümüne yükseltme) yönergelerini izlemektir.

Lua ikili dosyalarını Scribunto master'dan (veya 77905 üzerinden) kopyalarsanız, C kütüphanenizi yükseltmek istemiyorsanız bu yeterli olacaktır. Dağıtılmış ikili dosyalar son zamanlarda glibc'nin eski bir sürümüne karşı derlendi, bu nedenle minimum 2.11 yerine 2.3'tür.

Lua errors in Scribunto files
Errors here include:
 *  attempt to index field 'text' (a nil value) 
 *  Lua error in mw.html.lua at line 253: Invalid class given: 

If you are getting errors such these when attempting to use modules imported from WMF wikis, most likely your version of Scribunto is out of date.

Upgrade if possible; for advanced users, you might also try to identify the needed newer commits and cherry-pick them into your local installation.

preg_replace_callback: Compilation failed: unknown property name after \P or \p at offset 7

 * this usually indicates an incompatible version of PCRE; you'll need to update to >= 8.10
 * @todo: link to instructions on how to upgrade

Lua error
If you copy templates from Wikipedia and then get big red "Lua error: x" messages where the Scribunto invocation (e.g. the template that uses ) should be, that probably means that you didn't import everything you needed. Make sure that you tick the "Include templates" box at w:Special:Export when you export.

When importing pages from another wiki, it is also possible for templates or modules in the imported data to overwrite existing templates or modules with the same title, which may break existing pages, templates, and modules that depend on the overwritten versions.

Blank screen
Make sure your extension version is applicable to your MediaWiki version.

Design documents

 * Linux.conf.au 2014 - Scribunto presentation.webm's presentation at linux.conf.au 2014 discussing the motivations, implementation challenges and results of deploying Scribunto and Lua. ]]

Diğer sayfalar

 * - Wikimedia activity page describing deployment plan to Wikimedia sites.
 * - The reference about the Lua language, as well as its standard libraries and common Scribunto modules supported on Wikimedia sites.
 * - A list of known changes in Lua 5.2 that may cause code written in 5.1 to function unexpectedly.
 * - Code for example extensions extending the Scribunto library.
 * - A list of known changes in Lua 5.2 that may cause code written in 5.1 to function unexpectedly.
 * - Code for example extensions extending the Scribunto library.
 * - Code for example extensions extending the Scribunto library.

Ayrıca bakınız

 * General
 * - functionality for the Scribunto extension.
 * Commons:Lua - there may be specific notes for using Lua modules on Wikimedia Commons, including additional Lua extensions installed (e.g. for local support of internationalization and for parsing or playing medias). Some general purpose modules may be reused in other wikis in various languages (except specific tunings for policies, namespaces or project/maintenance pages with dedicated names). If possible, modules that could be widely reused across wikis should be tested and internationalized on Wikimedia Commons.
 * w:Help:Lua - there may be specific notes for using Lua modules on Wikipedia, including additional Lua extensions installed (including for integrating Wikidata and Wikimedia Commons contents, generating complex infoboxes and navigation boxes, or to facilitate the general administration/maintenance of the wiki contents under applicable policies). Some other localized Wikipedia editions (or other projects such Wiktionnary, Wikisource or Wikinews) may also have their own needs and Lua modules.
 * d:Help:Lua - there may be specific notes for using Lua modules on Wikidata, including additional Lua extensions installed (e.g. for local support of internationalization and for database queries)
 * Extensions
 * - Provides basic infobox functionality for the Scribunto extension.
 * - provides native support for the Scribunto extension for usage with
 * - provides a Scribunto Lua interface for the Variables extension
 * - provides (part of Wikidata project)