Extension:CodeEditor

Bu uzantı MediaWiki 1.31 ve üstü ile gelir. Böylece tekrar indirmek zorunda değilsiniz. Ancak, verilen diğer talimatları izlemeniz gerekir.

MediaWiki manüel uzantıları

CodeEditor Sürüm durumu: kararlı
Açıklama	Site ve kullanıcı JS, CSS ve Lua sayfaları için gelişmiş düzenleme araç çubuğu ile entegre bir sözdizimi vurgulayan kod düzenleyici sağlar
Yazar(lar)	Brion Vibber Derk-Jan Hartman authors of Ace (ace.c9.io)
Uyumluluk politikası	MediaWiki ile birlikte anlık görüntüler yayımlanır. Master geriye dönük olarak uyumlu değil.
MediaWiki	1.32+
Veritabanı değişiklikleri	Hayır
Lisans	GPL-2.0-or-later AND BSD-3-Clause
İndir	Uzantıyı indir Git [?]: Git master'ı indir depoyu göz at (GitHub) geçmişi işleyin veri deposu katkıda bulunanlar (GitHub) kod incelemesi
Parametreler $wgCodeEditorEnableCore
Kullanılan kancalar EditPage::showEditForm:initial EditPage::showReadOnlyForm:initial GetPreferences
Sağlanan kancalar CodeEditorGetPageLanguage
Translatewiki.net adresinde mevcutsa, CodeEditor uzantısını çevirin
Kullanım ve sürüm matrisini kontrol edin.
Sorunlar	Açık görevler · Hata bildir

CodeEditor uzantısı, WikiEditor gelişmiş düzenleme araç çubuğunu gömülü bir Ace editör widget'ı ile genişleterek, kullanıcı/site JavaScript sayfaları, CSS sayfaları, JSON sayfaları ve Lua sayfaları için Scribunto uzantısı da yüklendiğinde, yani Modül ad alanındaki sayfalar. Kod düzenleyici, normal wiki sayfalarında, yani "vikimetin" içerik modeline sahip viki sayfalarında gösterilmez. (Kaynak düzenleyiciyi kullanırken vikimetin sözdizimi vurgulaması için Extension:CodeMirror sayfasına bakın.)

Aşağıdaki özellikleri sağlar:

• JavaScript, CSS ve Lua için sözdizimi vurgulama
• otomatik girinti
• sekme tuşu, sekme girintileri (1.22'den beri), öncesinde yumuşak girintiler üretir.
• sekme/kaydırma sekmesi ile seçimi girintileme/girintiyi kaldırma
• JavaScript için sözdizimi geçerliliği kontrolü
• Parantez ve köşeli parantezler için çift eşleştirme

Kurulum

Bu uzantının çalışması için WikiEditor uzantısının yüklenmesi gerekir. Scribunto uzantısının yüklenmesi isteğe bağlıdır.

• Dosyaları indirin ve extensions/ klasörünüzdeki CodeEditor adlı dizine yerleştirin.
• $LocalSettings dosyanızın altına aşağıdaki kodu ekleyin:

  wfLoadExtension( 'CodeEditor' );
  $wgDefaultUserOptions['usebetatoolbar'] = 1; // user option provided by WikiEditor extension
  

• Gerektiği gibi yapılandırın.
•  Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

Vagrant installation:

• Vagrant kullanıyorsanız, vagrant roles enable codeeditor --provision ile yükleyin

Yapılandırma

$wgCodeEditorEnableCore

MediaWiki, Kullanıcı ve diğer temel ad alanlarındaki JavaScript ve CSS sayfalarında düzenleyiciyi devre dışı bırakmak için $wgCodeEditorEnableCore = false; ayarlayın (varsayılan "true")

$wgScribuntoUseCodeEditor

Bu uzantıyı Scribunto için devre dışı bırakmak, yani modül ad alanında $wgScribuntoUseCodeEditor = false; ayarlayın (varsayılan "true")

Bu yapılandırma parametresi Scribunto uzantısı tarafından sağlanır ve bu nedenle CodeEditor ve bunun çalışması için yüklenmesi gereken Scribunto uzantısının çağrılmasından sonra eklenmelidir.

JavaScript

ACE düzenleyicisinin yapılandırmasını MediaWiki JS kancası (i.e. mw.hook( 'codeEditor.configure' ).add( ... )) bağlayarak değiştirmek mümkündür. Kancanıza iletilen argüman bir ACE düzenleyici oturumu olacaktır.

WikiEditor entegrasyonu

Gelecek editör çalışmasına hazırlık olarak CodeEditor'ü Extension:WikiEditor takılabilir kısımlarına entegre ediyorum, çünkü onu düz olmayan şeyleri düzenlemek için genişletmek isteyeceğiz vikimetin, araç çubuğu ayarlarında bazı değişikliklere ihtiyaç duyacak ve ne olmayacak. JS/CSS burada yine de sonunda düz metin döndürür, bu da onu daha kolay bir ara proje yapar. --brion 00:26, 14 Haziran 2011 (UTC)

İyi:

• çevreleyen metne alıntı çiftleri dahil olmak üzere özel karakter ekleme çalışması
• bağlantı iletişim kutuları dahil olmak üzere temel biçimlendirme eklemeleri çalışır
• arama/değiştirme iletişim kutusu çalışmaları
  • Ace'nin yerleşik arama/değiştirme kullanıcı arayüzü de klavye komutlarından tetiklenir, yine de bunları devre dışı bırakmanız gerekir! (onCommandKey)

Kötü:

• çok satırlı biçimlendirme doğru şekilde uygulanmıyor (ama bu gerçekten burada geçerli olmalı mı? :)

Yapılacaklar:

• uygulanmayan araç çubuğu düğmelerini kaldırın (biçimlendirme, sözdizimi yardımı?)
• daha doğrudan kullanışlı olan araç çubuğu düğmeleri ekleyin
  • girinti/çıkıntı
  • ortak anahtar kelimeler veya kod bitleri için ekleme yardımcıları
  • MW JS API kaynağı, JS ve CSS spesifikasyonları/belgeleri için yardım kaynağı

Bilinen Sorunlar

• erişilebilirlik: sekme/üst karakter sekmesi geçersiz kılınır. Klavye bağımlısı kullanıcılar için tutarlı bir alternatif var mı?
• erişilebilirlik: orijinal metin alanındaki erişim anahtarının taşınması veya başka bir şekilde kullanılması gerekir
• kaydırma çubuğu çok geniş başlatılıyor; doldurulduktan sonra yeniden boyutlandırma kontrolünü tetiklemeniz gerekir (düzeltilebilir mi?)
• imleç/kaydırma konumu önizlemelerde/değişikliklerde gösterilmiyor

Lisans

Bu uzantı GNU Genel Kamu Lisansı v2.0 veya üstü (GPL-2.0+) lisanslı iken, BSD 3-madde "Yeni" veya "Revize Edilmiş" Lisans (BSD-3-Clause) lisanslı Ace editör yazılımını kullanır.