Extension:CodeMirror

From mediawiki.org
This page is a translated version of the page Extension:CodeMirror and the translation is 100% complete.
MediaWiki manüel uzantıları
OOjs UI icon advanced-invert.svg
CodeMirror
Sürüm durumu: kararlı
Pride and codemirror.png
Uygulama Kullanıcı arayüzü
Açıklama Vikimetin düzenleyicide sözdizimi vurgulama sağlar
Yazar(lar) Pavel Astakhov (pastakhovmesaj)
En son sürüm 4.0.0
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+
PHP 5.3+
Veritabanı değişiklikleri Hayır
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
  • $wgCodeMirrorLineNumberingNamespaces
Translatewiki.net adresinde mevcutsa, CodeMirror uzantısını çevirin

Kullanım ve sürüm matrisini kontrol edin.

Vagrant rolü codemirror
Sorunlar Açık görevler · Hata bildir

CodeMirror uzantısı, MediaWiki'nin vikimetin düzenleyicisinde sözdizimi vurgulama sağlar. Sözdizimi vurgulamayı açıp kapatmaya izin veren düzenleme araç çubuğuna Codemirror-icon.png simgeli bir düğme ekler. 2010 WikiEditor araç çubuğu ve Görsel Düzenleyici araç çubuğunu destekler.

Varsayılan olarak kapalıdır. Açıldığında, standart metin alanını CodeMirror kitaplığı tarafından sağlanan düzenleyiciyle değiştirecektir. Kapatırken, tam tersi bir etki olacaktır.

Bu uzantıda kullanılan renkler, daha yüksek kontrast, erişilebilirlik ve daha iyi okunabilirlik sağlamak için optimize edilmiştir. Renkler, sınırlı görüşe sahip kişilerin yanı sıra parlak gün ışığı koşullarında çalışan kullanıcılar için daha iyi erişim sağlar. (daha fazla bilgi)

Özellikler

Köşeli ayraç eşleştirme

Bu özellik, imleç herhangi bir parantez çifti arasında yer aldığında en içteki parantez çiftini vurgular ve imleç doğrudan bir parantezin yanında olduğunda, özellik ilgili eşleşen parantezleri vurgular. Köşeli ayraç eşleştirme, sözdizimi vurgulama açıldığında, bu düzenleyicileri kullanan herhangi bir ad alanında her iki düzenleyicide de etkin olacaktır.

Satır numaralandırma

Vikimetin düzenleme modunda satır numaraları her iki düzenleyicide de otomatik olarak görüntülenir.

Bu özellik, bazı vikilerdeki çoğu ad alanında ve tüm ad alanlarında şablon ad alanı için etkinleştirilmiştir (yol haritası ve yapılandırmaya bakın).

Renk körü modu

Renkleri ayırt etmekte güçlük çeken kullanıcılar için CodeMirror, renk körü dostu bir mod sunar. Bu özellik, CodeMirror etkinleştirilmiş vikilerde Special:Preferences sayfasına gidilerek etkinleştirilebilir.

New preference colorblind syntax highlighting.png


Renk körü dostu düzen etkinken, aşağıdaki sayfa ögelerinin renkleri değişir:

Başlıklar, semboller, imzalar, bölüm adları, sihirli kelimeler #E4A400
Şablonlar #9C3A00
HTML etiketleri, kaynakça, matematiksel ifadeler #56B4E9
Değişkenler #009E73

Ayrıca, tüm metin ve nesnelerden arka plan vurguları ve renkleri kaldırılır. Kalın ve altını çizme davranışı etkilenmeden kalır.


Tarayıcı desteği

Tüm tarayıcılar MediaWiki tarafından desteklenmektedir.

Kurulum

  • Ya WikiEditor uzantısı veya VisualEditor uzantısı sayfalarında belirtildiği gibi kurun; bu uzantının çalışması için bunlardan en az biri gereklidir.
  • Dosyaları indirin ve extensions/ klasörünüzdeki CodeMirror adlı dizine yerleştirin.
  • $LocalSettings dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'CodeMirror' );
    
  • Gerektiği gibi yapılandırın.
  • Yes 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 codemirror --provision ile yükleyin

Yapılandırma

Renk ve stil özelleştirme için Meta yardım sayfasına bakın. Vikimetin vurgulamak için kendi stillerinizi kullanabilirsiniz. Kullanılmış stiller burada mevcuttur. Kendi stillerinizi common.css içine yerleştirmelisiniz.

Aşağıdaki kodu LocalSettings.php dosyanıza altına ekleyin.

# Varsayılan olarak CodeMirror kullanımına izin verir, ancak yine de kullanıcıların devre dışı bırakmasına izin verir
$wgDefaultUserOptions['usecodemirror'] = 1;

Yerel kurulumunuzda yukarıda bahsedilen yeni özellikleri denemek için aşağıdaki satırları da ekleyin. Bununla birlikte, bu özelliklerin varsayılan özellikler olması gerektiğini lütfen unutmayın. Ayarların artık bir etkisi olmayabilir.

# CodeMirror'da köşeli ayraç eşleştirmeyi etkinleştirin
$wgCodeMirrorEnableBracketMatching = true;

# CodeMirror'da erişilebilir renkleri etkinleştirin
$wgCodeMirrorAccessibilityColors = true;

# CodeMirror'da satır numaralandırmayı etkinleştirin
# [ NS_TEMPLATE ] şablon ad alanı için varsayılandır
# null tüm ad alanı için etkinleştirir
# Her yerde devre dışı bırakmak için []
$wgCodeMirrorLineNumberingNamespaces = null;

Uzantı entegrasyonu

MediaWiki uzantınız yeni bir etiket eklerse ve CodeMirror'ın içindeki içeriği düzgün bir şekilde vurguladığından emin olmak istiyorsanız, uzantınıza CodeMirror desteği ekleyebilirsiniz. İşte iki örnek: Cite uzantısı ve PhpTags uzantısı.

JavaScript entegrasyonu

Bu uzantıda aşağıdaki ön uç kancaları kullanılır:

Kanca Parametreler
Tür Açıklama
ext.CodeMirror.switch boole CodeMirror düzenleyicisinin şimdi gösterilip gösterilmeyeceği
jQuery nesnesi Normal ‎<textarea /> veya .CodeMirror öğesi olan mevcut "editör".

Yapılacaklar

Ayrıca bakınız