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.

Gereksinimler


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:



Lua ikili dosyaları


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ı.

Kurulum


İsteğe bağlı kurulum


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


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ş, 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  satırı ekleyerek bazı kurulumlara yardımcı olabilirsiniz

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



Lua hatası: Dahili hata: 2. ARM mimarisinde
RaspberryPi'deki gibi bir ARM mimarisi işlemcisi kullanıyorsanız, Lua yorumlayıcısının yanlış teslim edilen ikili biçimi nedeniyle  hatasıyla karşılaşacaksınız.

Lua tercümanınızı şurada kontrol edin: /path/to/webdir/Scribunto/includes/engines/LuaStandalone/binaries/lua5_1_5_linux_32_generic

Aşağıdakileri kullanarak tercümanı kontrol edin: file lua Sonuç şöyle görünmelidir: 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 Yüklü varsayılan Lua yorumlayıcısı şunları gösterir: 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, kesinlikle doğru olmayan "Intel 80386" bölümüne bakın.

Sisteminizde hangi Lua sürümünün yüklü olduğunu  ile kontrol edin. lua5.1 kuruluysa, yorumlayıcıyı  dizininize kopyalayabilir veya LocalSettings.php dosyanızda ayarlayabilirsiniz:

Şu anda  ile /usr/bin/lua5.3 ayarlamayın, bu "Dahili hata 1" olarak yol açacaktır.

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. 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:


 * 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  işaretiyle bağlanı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.



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   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.



Scribunto dosyalarındaki Lua hataları
Buradaki hatalar şunları içerir:
 * 'text' alanını indekslemeye çalıştı (sıfır bir değer)
 * 253 satırında mw.html.lua içinde Lua hatası: Verilen geçersiz sınıf:

WMF vikilerinden içe aktarılan modülleri kullanmaya çalışırken bu tür hatalar alıyorsanız, büyük olasılıkla Scribunto sürümünüz güncel değildir.

Mümkünse yükseltin; ileri düzey kullanıcılar için, gerekli yeni işlemler belirlemeyi deneyebilir ve bunları yerel kurulumunuza özenle seçebilirsiniz.



preg_replace_callback: Derleme başarısız: \P veya \p ofset 7'den sonra bilinmeyen özellik adı

 * bu genellikle PCRE'nin uyumsuz bir sürümünü gösterir; >= 8.10 olarak güncellemeniz gerekecek
 * @todo: nasıl yükseltileceğine ilişkin talimatlara bağlantı



Lua hatası
Şablonları Vikipedi'den kopyalarsanız ve ardından Scribunto çağrısının (örneğin  kullanan şablon) olması gereken yerde büyük kırmızı "Lua hatası: x" mesajları alırsanız, bu muhtemelen ihtiyacınız olan her şeyi içe aktarmadığınız anlamına gelir. Dışa aktarırken tr:Özel:DışaAktar sayfasında "Şablonları dahil et" kutusunu işaretlediğinizden emin olun.

Başka bir vikiden sayfalar içe aktarılırken, içe aktarılan verilerdeki şablonların veya modüllerin aynı başlığa sahip mevcut şablonların veya modüllerin üzerine yazması da mümkündür; bu, üzerine yazılan sürümlere bağlı olan mevcut sayfaları, şablonları ve modülleri bozabilir.

<span id="Blank_screen">

Boş ekran
Uzantı sürümünüzün MediaWiki sürümünüze uygun olduğundan emin olun.

<span id="Design_documents">

Tasarım belgeleri

 * Linux.conf.au 2014 - Scribunto presentation.webm kullanıcının linux.conf.au 2014'te Scribunto ve Lua'yı dağıtmanın motivasyonlarını, uygulama zorluklarını ve sonuçlarını tartışan sunumu.]]

<span id="Other_pages">

Diğer sayfalar

 * - Wikimedia sitelerine dağıtım planını açıklayan Wikimedia etkinlik sayfası.
 * - Lua dili ile ilgili referansın yanı sıra standart kitaplıkları ve Wikimedia sitelerinde desteklenen ortak Scribunto modülleri.
 * - Lua 5.2'de 5.1'de yazılan kodun beklenmedik şekilde çalışmasına neden olabilecek bilinen değişikliklerin listesi.
 * - Örneğin, Scribunto kitaplığını genişleten uzantılar için kod.
 * - Lua 5.2'de 5.1'de yazılan kodun beklenmedik şekilde çalışmasına neden olabilecek bilinen değişikliklerin listesi.
 * - Örneğin, Scribunto kitaplığını genişleten uzantılar için kod.
 * - Örneğin, Scribunto kitaplığını genişleten uzantılar için kod.

<span id="See_also">

Ayrıca bakınız

 * General
 * - Scribunto uzantısı için işlevsellik.
 * Commons:Lua - Yüklü ek Lua uzantıları dahil olmak üzere Wikimedia Commons'ta Lua modüllerini kullanmak için özel notlar olabilir (örneğin, uluslararasılaştırmanın yerel desteği ve medyaların ayrıştırılması veya oynatılması için). Bazı genel amaçlı modüller, diğer vikilerde çeşitli dillerde yeniden kullanılabilir (politikalar, ad alanları veya özel adlara sahip proje/bakım sayfaları için özel ayarlamalar hariç). Mümkünse, vikilerde yaygın olarak yeniden kullanılabilen modüller Wikimedia Commons'ta test edilmeli ve uluslararasılaştırılmalıdır.
 * w:Help:Lua - yüklü ek Lua uzantıları dahil olmak üzere Vikipedi'de Lua modüllerini kullanmak için özel notlar olabilir (Vikiveri ve Wikimedia Commons içeriklerini entegre etmek, karmaşık bilgi kutuları ve gezinme kutuları oluşturmak veya geçerli politikalar kapsamında viki içeriğinin genel yönetimini/bakımını kolaylaştırmak dahil). Diğer bazı yerelleştirilmiş Vikipedi sürümleri (veya Vikisözlük, Vikikaynak veya Vikihaber gibi diğer projeler) de kendi ihtiyaçlarına ve Lua modüllerine sahip olabilir.
 * d:Help:Lua - yüklü ek Lua uzantıları da dahil olmak üzere, Vikiveri'de Lua modüllerini kullanmak için özel notlar olabilir (örneğin, uluslararasılaştırmanın yerel desteği ve veritabanı sorguları için)
 * Extensions
 * - Scribunto uzantısı için temel bilgi kutusu işlevselliği sağlar.
 * - ile kullanım için Scribunto uzantısı için yerel destek sağlar
 * - Variables uzantısı için bir Scribunto Lua arabirimi sağlar
 * - sağlar (Vikiveri projesinin bir parçası)