Belge Değişkenleriyle YapılandırmakKatePart değişkenleri, Emacs ve Vi kip satırlarına benzer biçimde KatePart’in belge değişkenlerini uygulamasıdır. Katepart’ta satırlar aşağıdaki biçime sahiptir: kate: DEĞİŞKEN-ADI DEĞER; [ DEĞİŞKEN-ADI DEĞER; … ]. Satırlar dosya yorum içeren bir biçimdeyse elbette yorumda yer almalıdır. Değişken adları tek sözcüklerden oluşur (boşluk yoktur) ve sonraki noktalı virgülden sonraki her şey değerdir. Noktalı virgül gereklidir.
İşte bir C++, Java™ veya JavaScript dosyası için girintileme ayarlarını zorlayan örnek bir değişken satırı:
// kate: replace-tabs on; indent-width 4; indent-mode cstyle;
Not
Değişken satırları için yalnızca ilk ve son on satır aranır.
Ek olarak, belge değişkenleri herhangi bir dizindeki .kateconfig adlı bir dosyaya yerleştirilebilir ve yapılandırılan ayarlar, dizindeki ve alt dizinlerindeki her dosyaya kip satırları girilmiş gibi uygulanacaktır. Belge değişkenleri, .kateconfig dosyasındaki kip satırları ile aynı sözdizimini kullanır; ancak genişletilmiş seçeneklerle.
KatePart’de hemen hemen tüm yapılandırmaları destekleyecek değişkenler vardır ve ayrıca eklentiler değişkenleri kullanabilir, bu durumda eklentinin belgelerinde belgelenmesi gerekir.
KatePart’de, editorconfig kurulu olduğu zaman .editorconfig dosyalarından yapılandırmaları okuma desteği vardır. KatePart, bir dosya açtığınızda kendiliğinden bir .editorconfig dosyası arar. Yine de .kateconfig dosyalarına öncelik tanır.
Yapılandırma okurken, katepart aşağıdaki yerlere bakar (sırasıyla):
Global yapılandırma.
İsteğe bağlı oturum verisi.
"Dosya Türü" yapılandırması.
.kateconfigdosyasındaki belge değişkenleri.Belgenin içindeki belge değişkenleri.
Komut satırından veya uygulama menüsünden ayarlanan ayarlar.
Gördüğünüz üzere, belge değişkenleri yalnzca çalışma zamanında yapılan değişikliklerle geçersiz kılınabilirler. Bir belge kaydedildiğinde, belge değişkenleri yeniden okunur ve komut satırından veya menü ögelerinden yapılan değişikliklerin üzerine yazılır.
Aşağıda listelenmeyen herhangi bir değişken belgede depolanır ve bunları kendi amaçları doğrultusunda kullanabilen eklentiler gibi diğer nesneler tarafından sorgulanabilirler. Örneğin, değişken girinti kipi, yapılandırması için belge değişkenlerini kullanır.
Burada listelenen değişkenler, KatePart 5.38 sürümünü belgelemektedir. Gelecekte daha fazla değişken eklenebilir. Değişkenler için aşağıdaki geçerli ifadelerle birlikte 3 olası değer türü vardır:
BOOL — on|off|true|false|1|0
INTEGER — herhangi bir tamsayı
STRING — başka herhangi bir şey
auto-brackets [BOOL]
Ayraçların kendiliğinden eklenmesini etkinleştirin.
auto-center-lines [INT]
Kendiliğinden hizalama satırlarının sayısını ayarlayın.
background-color [STRING]
Belge arka plan rengini ayarlayın. Değer, geçerli bir renge dönüştürülebilir olmalıdır; örneğin,
#ff0000.backspace-indents [BOOL]
Geri Sil düğmesine basıldığında girintinin geri alınmasını etkinleştirin veya devre dışı bırakın.
block-selection [BOOL]
Blok seçimini açın veya kapatın.
bom | byte-order-mark | byte-order-marker [BOOL]
Dosyaları Unicode (utf8, utf16, utf32) biçiminde kaydederken, bayt sırası imini etkinleştirin veya devre dışı bırakın.
Kate 3.4 (KDE 4.4) sürümünden beri
bracket-highlight-color [STRING]
Ayraç vurgusunun rengini ayarlayın. Değer, geçerli bir renk için değerlendirilebilecek bir şey olmalıdır; örneğin;
#ff0000.current-line-color [STRING]
Geçerli satırın rengini ayarlayın. Değer, geçerli bir renk için değerlendirilebilecek bir şey olmalıdır; örneğin,
#ff0000.default-dictionary [STRING]
Yazım denetimi için kullanılan öntanımlı sözlüğü ayarlar.
Kate 3.4 (KDE 4.4) sürümünden beri
dynamic-word-wrap [BOOL]
Devingen sözcük kaydırmayı açar veya kapatır.
eol | end-of-line [STRING]
Satır sonu kipini ayarlayın. Geçerli ayarlar
unix,macvedosolarak üçe ayrılır.folding-markers [BOOL]
Katlama imleyicilerinin görüntülenmesini açar veya kapatır.
folding-preview [BOOL]
Düzenleyici kenarlığında katlama önizlemesini etkinleştirin.
font-size [INT]
Belgenin yazıtipi boyutunu punto türünden ayarlayın.
font [STRING]
Belgenin yazıtipini ayarlayın. Değer, geçerli bir yazıtipi adı olmalıdır; örneğin,
courier.hl | syntax [STRING]
Sözdizimi vurgulamasını ayarlayın. Geçerli diziler, menüde kullanılabilir olan tüm adlardır. Örneğin, C++ için yalnızca
C++yazın.icon-bar-color [STRING]
Simge çubuğunun rengini ayarlayın. Değer, geçerli bir renk olmalıdır; örneğin,
#ff0000.icon-border [BOOL]
Simge kenarlığının görüntülenmesini açın veya kapatın.
indent-mode [STRING]
Kendiliğinden girintileme kipini ayarlayın. Şu seçenekler desteklenir:
none,normal,cstyle,haskell,lilypond,lisp,python,rubyvexml. Ayrıntılar için “Kendiliğinden Girintilemeyi Kullanmak” bölümüne bakın.indent-pasted-text [BOOL]
Panodan yapıştırılan metnin girintileme ayarlamasını etkinleştirin/devre dışı bırakın.
Kate 3.11 (KDE 4.11) sürümünden beri
indent-width [INT]
Girintileme genişliğini ayarlayın.
keep-extra-spaces [BOOL]
Girintileme genişliği hesaplanırken, fazladan boşlukların tutulup tutulmayacağını ayarlayın.
line-numbers [BOOL]
Satır numaralarının görüntülenmesini açın veya kapatın.
newline-at-eof [BOOL]
Belgeyi kaydederken, dosyanın sonuna (EOF) boş bir satır ekleyin.
Kate 3.9 (KDE 4.9) sürümünden beri
overwrite-mode [BOOL]
Üzerine yazma kipini açın veya kapatın.
persistent-selection [BOOL]
Kalıcı seçimi açın veya kapatın.
replace-tabs-save [BOOL]
Kaydetme sırasında sekmeden boşluğa dönüşümü açın veya kapatın.
replace-tabs [BOOL]
Devingen sekmeden boşluğa dönüşümü açın veya kapatın.
remove-trailing-spaces [STRING]
Belgeyi kaydederken satır sonlarındaki boşlukları kaldırır. Geçerli seçenekler:
none,-veya0: Asla satır sonu boşluklarını kaldırmayın.modified,mod,+veya1: Yalnızca değiştirilen satırlardaki sondaki boşlukları kaldırın. Değiştirilen çizgiler, satır değişiklik sistemi tarafından işaretlenir.all,*veya2: Tüm belgedeki satır sonu boşluklarını kaldırın.
scrollbar-minimap [BOOL]
Sarma çubuğu mini haritasını gösterin.
scrollbar-preview [BOOL]
Sarma çubuğu önizlemesini gösterin.
scheme [STRING]
Renk şemasını ayarlayın. Herhangi bir etki yaratabilmesi için dizinin, yapılandırmanızda bulunan renk şemasının adı olması gerekir.
selection-color [STRING]
Seçim rengini ayarlayın. Değer, geçerli bir renkle değerlendirilebilecek bir şey olmalıdır; örneğin,
# ff0000.show-tabs [BOOL]
Görsel sekme karakterini açın veya kapatın.
smart-home [BOOL]
Akıllı ana klasör dolaşımını açın veya kapatın.
tab-indents [BOOL]
Sekme düğmesi girintilemesini açın veya kapatın.
tab-width [INT]
Sekme karakterinin genişliğini ayarlayın.
undo-steps [INT]
Anımsanacak geri alma eylemi sayısını ayarlayın.
Not: KDE4 üzerindeki Kate 3 sürümünden beri kullanılmıyor. Bu değer yok sayılır. Geri alma eyleminin en yüksek sayısı sınırsızdır.
word-wrap-column [INT]
Durağan sözcük kaydırma genişliğini ayarlayın.
word-wrap-marker-color [STRING]
Sözcük kaydırma imleyicisinin rengini ayarlayın. Değer, geçerli bir renkle değerlendirilebilecek bir şey olmalıdır; örneğin,
#ff0000.word-wrap [BOOL]
Durağan sözcük kaydırmayı açın veya kapatın.
KatePart, her zaman yerel dosyalar için bir .kateconfig dosyası arar (uzak dosyalarda aramaz). Ek olarak, aşağıdaki biçimde özel karakter araması için seçenekler ayarlamak da olanaklıdır (dosya uzantıları):
kate: tab-width 4; indent-width 4; replace-tabs on; kate-wildcard(*.xml): indent-width 2; kate-wildcard(Makefile): replace-tabs off;
Bu örnekte, tüm dosyalar 4 boşluktan oluşan sekme genişliği kullanır, girinti genişliği 4 boşluktur ve sekmeler genişletilerek boşluklarla değiştirilir. Ancak tüm *.xml dosyaları için girinti genişliği 2 boşluktur. Makefile dosyaları sekmeler kullanır; örneğin, sekmeler boşluklarla değiştirilmez.
Joker karakterleri noktalı virgülle ayrılır; ayrıca birden fazla dosya uzantısını aşağıdaki gibi de belirtebilirsiniz:
kate-wildcard(*.json;*.xml): indent-width 2;
Ayrıca, belirli dosyaları eşleştirmek için MIME türünü de kullanabilirsiniz; örneğin, tüm C++ kaynak dosyalarını 4 boşlukla girintilemek için şunu yazabilirsiniz:
kate-mimetype(text/x-c++src): indent-width 4;
Not
.kateconfig dosyalarındaki desteğin yanı sıra, joker karakterlerine ve MIME türüne bağlı belge değişkenleri de dosyaların kendisinde yorumlar olarak desteklenir.