set-tab-width {TAMSAYI genişlik}

Sekme genişliğini ayarlar.

set-indent-width {TAMSAYI genişlik}

Girintileme genişliğini ayarlar. Yalnızca boşluklarla girintileme yapıyorsanız kullanılır.

set-word-wrap-column {TAMSAYI genişlik}

Sert kaydırma için satır genişliğini ayarlar. Bu, metninizde kendiliğinden kaydırma kullanıyorsanız kullanılır.

set-icon-border {BOOLE etkinleştir}

Simge kenarlığının görünürlüğünü ayarlar.

set-folding-markers {BOOLE etkinleştir}

Katlama imleyicileri yüzeyinin görünürlüğünü ayarlar.

set-line-numbers {BOOLE etkinleştir}

Satır numaraları yüzeyinin görünürlüğünü ayarlar.

set-replace-tabs {BOOLE etkinleştir}

Etkinleştirilirse sekmeler siz yazdıkça boşluklarla değiştirilir.

set-remove-trailing-space {BOOLE etkinleştir}

Etkinleştirilirse sondaki boşluklar imleç satırı terk ettiğinde kaldırılır.

set-show-tabs {BOOLE etkinleştir}

Etkinleştirilirse SEKME karakterleri ve sondaki boşluklar küçük bir noktayla görselleştirilir.

set-show-indent {BOOLE etkinleştir}

Etkinleştirilirse girintileme dikey noktalı bir satırla görselleştirilir.

set-indent-spaces {BOOLE etkinleştir}

Etkinleştirilirse düzenleyici her bir girintileme düzeyi için SEKME karakteri yerine indent-width kadar boşlukla girintileme yapar.

set-mixed-indent {BOOLE etkinleştir}

Etkinleştirilirse KatePart, girintileme için SEKME ve boşlukların bir karışımını kullanır. Her girinti düzeyi indent-width genişliğinde olacak ve daha fazla girinti düzeyi olabildiğince çok sayıda SEKME karakteri kullanacak şekilde eniyilenecektir.

Yürütüldüğünde, bu komut ek olarak boşluk girintisini etkinleştirir ve girinti genişliği belirtilmemişse yürütme sırasında belgenin tab-width değerinin yarısına ayarlanır.

set-word-wrap {BOOLE etkinleştir}

enable değerine göre devingen sözcük kaydırmayı etkinleştirir.

set-replace-tabs-save {BOOLE etkinleştir}

Etkinleştirildiğinde, belge kaydedildiğinde sekmelerin yerini boşluklar alacaktır.

set-replace-tabs-save {BOOLE etkinleştir}

Etkinleştirildiğinde, belge kaydedildiğinde her satırın sondaki boşluk kaldırılacaktır.

set-indent-mode {DİZİ ad}

Kendiliğinden girintileme kipini ad olarak ayarlar. ad bilinmiyorsa kip 'none' olarak ayarlanır. Geçerli kipler: 'none', 'normal', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' ve 'xml'.

set-auto-ident {BOOLE betik}

Kendiliğinden girintilemeyi etkinleştirin veya devre dışı bırakın.

set-highlight {DİZİ vurgu}

Belgenin sözdizim vurgulama sistemini ayarlar. Argüman, Araçlar → Vurgulama menüsünde görüldüğü gibi geçerli bir vurgu adı olmalıdır. Bu komut, argümanı için bir kendiliğinden tamamlama listesi sağlar.

reload-scripts

Girintileyiciler ve komut satırı betikleri de içerilmek üzere, Kate'in kullandığı tüm JavaScript betiklerini yeniden yükleyin.

set-mode {DİZİ kip}

Geçerli belge için dosya türü şemasını seçin.

nn[oremap] {DİZGİ özgün} {DİZİ eşlemlenen}

Özgün düğme sıralamasını eşlemlenen sıralamasına eşlemler.

indent

Seçili satırları veya geçerli satırı girintiler.

unindent

Seçili satırların veya geçerli satırın girintisini kaldırır.

cleanindent

Seçili satırların veya geçerli satırın girintisini belgedeki girintileme ayarlarına göre temizler.

comment

Seçimi veya seçili satırları veya geçerli satırı, belgenin sözdizim vurgulama tanımıyla tanımlandığı şekilde metin biçimine göre bir yorum haline getirmek için yorum imleyicileri ekler.

uncomment

Belgenin sözdizim vurgulama tanımıyla tanımlanan metin biçimine göre seçimden veya seçili satırlardan veya geçerli satırdan yorum imleyicilerini kaldırır.

kill-line

Geçerli satırı siler.

replace { DİZİ dizgi} {DİZİ değişim}

dizgi ile eşleşen metni değişim ile değiştirir. dizgi'de boşlukları içermek isterseniz hem dizgi hem değişim değişkenlerini tek veya çift tırnak içine almalısınız. Argümanlar tırnak içinde değilse ilk sözcük dizgi ve geri kalanı değişim olarak kullanılır. Eğer değişim boşsa her bir dizgi oluşu kaldırılır.

Aramayı yapılandırmak için iki nokta üst üste ve ardından her biri bir yapılandırmayı temsil eden bir veya daha fazla harf ekleyerek replace:seçenekler dizgi değişim formunu vererek bayrakları ayarlayabilirsiniz. Kullanılabilir seçenekler şunlardır:

b

Geriye doğru arayın.

c

İmleç konumundan itibaren arayın.

e

Yalnızca seçimde arayın.

r

Düzenli ifade araması yapın. Ayarlıysa N değiştirme dizisindeki yakalamaları temsil etmek üzere bir numara olması için \N kullanabilirsiniz.

s

BÜYÜK/küçük harf duyarlı arama yapın.

p

Sonraki oluşu değiştirmek için izin isteyin.

w

Yalnızca tam sözcüklerle eşleştirin.

date {DİZİ biçim}

Tanımlı biçim veya yoksa “yyyy-MM-dd hh:mm:ss” biçimi ile bir tarih/zaman dizisi ekler. biçim yorumlanırken aşağıdaki çeviriler kullanılır:

d	Başında sıfır olmadan sayı olarak gün (1-31).
dd	Başında sıfır olacak şekilde gün (01-31).
ddd	Kısa yerelleştirilmiş gün adı (örneğin, 'Pzt'..'Paz').
dddd	Uzun yerelleştirilmiş gün adı (örneğin, 'Pazartesi'..'Pazar').
M	Başında sıfır olmadan sayı olarak ay (1-12).
MM	Başında sıfır olacak şekilde ay (01-12).
MMMM	Uzun yerelleştirilmiş ay adı (örneğin, 'Ocak'..'Şubat').
MMM	Kısa yerelleştirilmiş ay adı (örneğin, 'Oca'..'Şub').
yy	İki basamaklı sayı olarak yıl (00-99).
yyyy	Dört basamaklı sayı olarak yıl (1752-8000).
h	Başında sıfır olmadan saat (0..23 veya ÖÖ/ÖS görüntüleniyorsa 1..12).
hh	Başında sıfır olarak saat (00..23 veya ÖÖ/ÖS görüntüleniyorsa 01..02).
m	Başında sıfır olmadan dakika (0..59).
mm	Başında sıfır olarak dakika (00..59).
s	Başında sıfır olmadan saniye (0..59).
ss	Önünde sıfır olarak saniye (00..59).
z	Başında sıfır olmadan milisaniye (0..999).
zzz	Başında sıfır olarak milisaniye (000..999).
AP	ÖÖ/ÖS görüntüsünü kullanın. AP, "ÖÖ" veya "ÖS" ile değiştirilir.
ap	ÖÖ/ÖS görüntüsünü kullanın. AP, "AM" veya "PM" olarak değiştirilir.

char {DİZİ tanımlayıcı}

Bu komut, sayısal tanımlayıcılarına göre; ondalık, sekizlik veya onaltılık biçimde gerçek karakterleri eklemenizi sağlar. Bunu kullanmak için Düzenleme Komutu iletişim kutusunu başlatın ve giriş kutusuna char: [number] yazın, ardından Tamam'a basın.

Örnek 5.1. char örnekleri

Girdi: char:234

Çıktı: ê

Girdi: char:0x1234

Çıktı: ሴ

s///[ig] %s///[ig]

Bu komut, geçerli satırda veya tüm dosyada sed benzeri arama/değiştirme işlemi yapar (%s///).

Kısacası metinde, birinci ve ikinci eğik çizgi arasındaki normal ifade olan arama dizgisi ile eşleşen metin aranır ve bir eşleşme bulunduğunda metnin eşleşen kısmı, ikinci ve son eğik çizgi arasındaki ifadeyle değiştirilir. Arama dizgisindeki parantezler geriye başvurular oluşturur; yani komut, parantez içinde eşleşen dizinin hangi bölümünün anımsanacağını bilir; bu diziler, ilk parantez kümesi için \1, ikinci parantez kümesi için \2 olarak anılan değiştirme dizgisinde yeniden kullanılabilir.

Bir gerçek karakter aramak için ( veya ) onu bir ters eğik çizgi karakteriyle kaçırmalısınız: \(\)

İfadenin sonuna i koyarsanız eşleştirme BÜYÜK/küçük harfe duyarlı olmayacaktır. Eğer sona bir g koyarsanız dizginin tüm oluşları değiştirilecektir, aksi takdirde yalnızca ilk oluş değiştirilir.

Örnek 5.2. Geçerli satırda metin değiştirmek

Dost canlısı derleyiciniz, kaynak dosyanızda 3902. satırda bahsedilen sınıfım sınıfının tanımlanmadığını söyleyerek durdu.

"Tüh!", tabii ki Sınıfım olması gerek diye düşündünüz. 3902. satıra gittiniz ve metinde sözcüğü bulmak yerine Düzenleme Komutu iletişim kutusunu açarak s/sınıfım/Sınıfım/i yazdınız ve Tamam düğmesine bastınız; artık dosyayı kaydedip hatasız şekilde derleyebilirsiniz.

Örnek 5.3. Tüm dosyada metin değiştirmek

Birkaç kez “Bayan Gökçen”'den söz ettiğiniz bir dosyanız olduğunu ve birisinin gelip size “Bay Gökmen” ile yeni evlendiğini söylediğini hayal edin. Elbette, “Bayan Gökçen” ifadesinin her bir örneğini “Bayan Gökmen” ile değiştirmek istersiniz.

Komut satırına girin ve %s/Gökçen/Gökmen/ komutunu çalıştırın, işiniz bitti.

Örnek 5.4. Daha Gelişmiş Bir Örnek

Bu örnekte geriye başvuruların yanı sıra karakter sınıfının kullanımı kullanılmaktadır (bunun ne olduğunu bilmiyorsanız lütfen aşağıda belirtilen ilgili belgelere bakın).

Aşağıdaki gibi bir satırınız olduğunu düşünün:

void MyClass::DoStringOps( String      &foo, String &bar, String *p, int  &a, int &b )

Bunun pek güzel bir kod olmadığını anladınız ve argüman adının önünde & ile karakterize edilen tüm “address of” argümanları için const anahtar sözcüğünü kullanmaya karar verdiniz. Ayrıca, her sözcük arasında yalnızca 1 boşluk karakteri olacak şekilde beyaz alanı basitleştirmek istediniz.

Düzenleme Komut iletişim kutusunu açın ve s/\s+(\w+)\s+(&)/ const \1 \2/g yazarak Tamam düğmesine tıklayın. İfadenin sonundaki g geriye başvuruların kaydedilmesi için düzenli ifadenin her eşleşmede yeniden derlenmesini sağlar.

Çıktı: void MyClass::DoStringOps( const String &foo, const String &bar, String *p, const int &a, const int &b )

Görev tamamlandı! Şimdi ne yaptık? İlk olarak, biraz boşluk (\s+), sonrasında bir veya daha çok abecesel karakterler (\w+), sonrasında biraz daha boşluk (\s+), sonrasında bir ve işareti aradık; bu süreçte abecesel parçayı ve ve işaretini değiştirme işleminde yeniden kullanım için sakladık. Sonrasında, satırımızın eşleşen kısmını bir boşluk ve sonrasında “const” ile bir boşluk daha ve abecesel parça ile izledik (\1); bunlardan sonra yine bir boşluk ve kaydettiğimiz ve işaretini koyduk (\2)

Bazı durumlarda bu abecesel parça bir “String”, bazı durumlarda ise “int” idi, böylece \w karakter sınıfını ve + niceleyicisi bize çok yararlı oldu.

sort

Seçili metni veya tüm belgeyi sıralar.

natsort

Seçili satırları veya tüm belgeyi doğal olarak sıralayın.

Örnek 5.5. sort ve natsort

sort(a10, a1, a2), a1, a10, a2 sonucunu verir

natsort(a10, a1, a2), a1, a2, a10 sonucunu verir

moveLinesDown

Seçili satırları aşağı taşıyın.

moveLinesUp

Seçili satırları yukarı taşıyın.

uniq

Seçili metinden veya tüm belgeden yinelenen satırları kaldırın.

rtrim

Seçili metnin veya tüm belgenin sonundaki gereksiz boşluğu kaldırın.

ltrim

Seçili metnin ya da tüm belgenin başındaki boşlukları kaldırın.

join [DİZİ ayırıcı]

Seçili satırları veya tüm belgeyi birbirine katın. İsteğe bağlı olarak bir ayırıcı tanımlayan bir parametre alır; örneğin join ', '

rmblank

Seçili metinden veya tüm belgeden boş boşlukları kaldırın.

alignon

Bu komut, seçilen bloktaki veya belgenin tamamındaki satırları, argüman olarak verilen normal bir ifadeyle verilen sütunda hizalar.

Boş bir dizgi verirseniz öntanımlı olarak ilk boş olmayan karaktere hizalanır.

Dizginin bir yakalaması varsa yakalanan eşleşmeye girintili olacaktır.

Örnekler:

alignon -, tümünü aynı sütunda hizalamak için her bir satırın önündeki '-' öncesinde boşluklar ekler.

alignon :\\s+(.), tümünü aynı sütunda hizalamak için bir noktalı virgülden sonra oluşan ilk boş olmayan karakterin öncesine boşluklar ekler.

unwrap

Seçili metnin veya tüm belgenin kaydırmasını geri alın.

each {DİZİ betik}

Argüman olarak bir JavaScript işlevi verildiğinde, seçili satırların listesi için bunu çağırın ve bunları, o geri çağırmanın dönüş değeriyle değiştirin.

Örnek 5.6. Seçili satırları birbirine kat

each 'function(lines){return lines.join(", ")}'

Veya kısaca:

each 'lines.join(", ")'

filter {DİZİ betik}

Argüman olarak bir JavaScript işlevi verildiğinde, seçili satırların listesi için bunu çağırın ve geri çağırmanın false döndürdüğü satırları kaldırın.

Örnek 5.7. Boş satırları kaldır

filter 'function(1){return 1.length > 0;}'

Veya kısaca:

filter 'line.length > 0'

map {DİZİ betik}

Argüman olarak bir JavaScript işlevi verildiğinde, seçili satırların listesi için bunu çağırın ve satırı geri çağırmanın değeriyle değiştirin.

Örnek 5.8. Boş satırları kaldır

map 'function(line){return line.replace(/^s+/,"");}'

Veya kısaca:

map 'line.replace(/^s+/,"")'

duplicateLinesUp

Seçili satırları geçerli seçim üzerine çoğaltın.

duplicateLinesDown

Seçili satırları geçerli seçimin altına çoğaltın.

goto {TAMSAYI satır}

Bu komut, belirtilen satıra gider.

grep {DİZİ dizgi}

Belgeyi, dizgi düzenli ifadesi için arayın. Daha fazla bilgi için Ek A, Düzenli İfadeler bölümüne bakın.

find {DİZİ dizgi}

Bu komut, yapılandırmaya göre dizgi'nin ilk oluşuna gider. İzleyen oluşlar, Düzen → Sonrakini Bul ile bulunabilir (öntanımlı kısayol: F3).

Bul komutu, iki nokta üst üste ve ardından bir veya daha fazla seçeneğin eklenmesiyle yapılandırılabilir; komutun biçimi find:seçenekler dizgi biçimindedir. Aşağıdaki seçenekler desteklenir:

b

Geriye doğru arayın.

c

İmleç konumundan itibaren arayın.

e

Yalnızca seçimde arayın.

r

Düzenli ifade araması yapın. Ayarlıysa N değiştirme dizisindeki yakalamaları temsil etmek üzere bir numara olması için \N kullanabilirsiniz.

s

BÜYÜK/küçük harf duyarlı arama yapın.

w

Yalnızca tam sözcüklerle eşleştirin.

ifind {DİZİ dizgi}

Bu komut, “yazdıkça” aramayı sağlar. Aramanın davranışını bir sütun ve seçenekleri ekleyerek yapılandırabilirsiniz; şöyledir: ifind:seçenekler dizgi. İzin verilen seçenekler:

b

Geriye doğru arayın.

r

Düzenli ifade araması yapın.

s

BÜYÜK/küçük harf duyarlı arama yapın.

c

İmleç konumundan itibaren arayın.

w

Geçerli belgeyi kaydedin.

wa

Tüm geçerli açık belgeleri kaydedin.

q

Geçerli belgeyi kapatın.

qa

Tüm açık belgeleri kapatın.

wq

Geçerli belgeyi kaydedin ve kapatın.

wqa

Tüm geçerli açık belgeleri kaydedin ve kapatın.

x

Geçerli belgeyi yalnızca değiştiyse kaydedin ve kapatın.

x

Geçerli açık olan tüm belgeleri yalnızca değiştiyse kaydedin ve kapatın.

bp

Belgeler listesindeki önceki belgeye gidin.

bn

Belgeler listesindeki sonraki belgeye gidin.

new

Yatay bölünmüş görünümde yeni bir belge açın.

vnew

Dikey bölünmüş görünümde yeni bir belge açın.

e

Geçerli belge diskte değiştiyse yeniden yükleyin.

enew

Yeni bir belge düzenleyin.

print

Geçerli belgeyi yazdırmak için Yazdır iletişim kutusunu açın.

KatePart Vurgu Tanımı dosyalarının ana bölümleri

Vurgulama dosyası, XML sürümünü ayarlayan bir üstbilgi içerir:

<?xml version="1.0" encoding="UTF-8"?>

Tanım dosyasının kökü öge dilidir. Kullanılabilir öznitelikler şunlardır:

Zorunlu öznitelikler:

name, dilin adını ayarlar. Sonrasında menülerde ve iletişim kutularında görünür.

section, kategoriyi belirtir.

extensions, dosya uzantılarını tanımlar, "*.cpp;*.h" gibi

version, tanım dosyasının geçerli revizyonunu bir tamsayı türünden belirtir. Vurgu tanımı dosyasını değiştirdiğinizde bu sayıyı artırdığınızdan emin olun.

kateversion, en son desteklenen KatePart sürümünü belirtir.

İsteğe bağlı öznitelikler:

mimetype, dosyaların MIME türlerini ilişkilendirir.

casesensitive, anahtar sözcüklerin BÜYÜK/küçük harf duyarlı olup olmadığını tanımlar.

priority, başka bir vurgu tanım dosyası aynı uzantıları kullanıyorsa gereklidir. Daha yüksek öncelik kazanır.

author, yazarın adını ve e-posta adresini içerir.

license, lisansı içerir. Yeni sözdizim vurgulama dosyaları için genelde MIT lisansıdır.

style, sağlanan dili içerir ve required-syntax-style özniteliği için olan girintileyiciler tarafından kullanılır.

indenter, öntanımlı olarak hangi girintileyicinin kullanılacağını tanımlar. Kullanılabilir girintileyiciler: ada, normal, cstyle, cmake, haskell, latex, lilypond, lisp, lua, pascal, python, replicode, ruby ve xml.

hidden, adın KatePart menülerinde görünüp görünmeyeceğini tanımlar.

Böylece, bir sonraki satır böyle görünebilir:

<language name="C++" version="1" kateversion="2.4" section="Sources" extensions="*.cpp;*.h" />

Sonrasında highlighting ögesi gelir. Bu öge, isteğe bağlı list ögesini ve zorunlu contexts ve itemDatas ögelerini içerir.

list ögeleri bir anahtar sözcükler listesi içerir. Bu durumda, anahtar sözcükler class ve const olur. İstediğiniz kadar liste ekleyebilirsiniz.

KDE Frameworks 5.53 sürümünden bu yana, bir liste, başka bir listeden ve/veya dilden/dosyadan include ögesini kullanarak anahtar sözcükler içerebilirler. IncludeRules kuralında olduğu gibi, ##, liste adını ve dil tanımını ayırmak için kullanılır. Bu, başka bir dilin/dosyanın anahtar sözcüklerini içermeniz gerekiyorsa yinelenen anahtar sözcük listelerini önlemek için yararlıdır. Örneğin, othername listesi, ISO C++ diline ait olan str anahtar sözcüğünü ve types listesinin tüm anahtar sözcüklerini içerir.

contexts ögesi tüm bağlamları içerir. İlk bağlam, öntanımlı olarak, vurgulamanın başlangıcıdır. Normal Text adlı bağlamda iki adet kural vardır: somename adındaki bir kuralla eşleşen anahtar sözcükler ve bir tırnağı algılayıp bağlamı string yapan başka bir tanesi. Kurallar hakkında daha fazla bilgi almak için sonraki fasılı okuyun.

Üçüncü kısımsa itemDatas ögesidir. Bağlamlar ve kurallar tarafından gereksinim duyulan tüm renk ve yazıtipi biçemlerini içerir. Bu örnekte, itemData Normal Text, String ve Keyword kullanılmıştır.

<highlighting>
    <list name="somename">
      <item>class</item>
      <item>const</item>
    </list>
    <list name="othername">
      <item>str</item>
      <include>types##ISO C++</include>
    </list>
    <contexts>
      <context attribute="Normal Text" lineEndContext="#pop" name="Normal Text" >
        <keyword attribute="Keyword" context="#stay" String="somename" />
        <keyword attribute="Keyword" context="#stay" String="othername" />
        <DetectChar attribute="String" context="string" char="&quot;" />
      </context>
      <context attribute="String" lineEndContext="#stay" name="string" >
        <DetectChar attribute="String" context="#pop" char="&quot;" />
      </context>
    </contexts>
    <itemDatas>
      <itemData name="Normal Text" defStyleNum="dsNormal" />
      <itemData name="Keyword" defStyleNum="dsKeyword" />
      <itemData name="String" defStyleNum="dsString" />
    </itemDatas>
  </highlighting>

Bir vurgu tanımının son kısmı ise isteğe bağlı olan general bölümüdür. Anahtar sözcükler, kod katlama, yorumlar, girintileme, boş satırlar ve yazım denetim üzerine bilgiler içerir.

comment bölümü, tek bir satırlık bir yorumun hangi diziye konulduğunu tanımlar. Ayrıca, ek end özniteliği ile multiLine kullanarak çok satırlı bir yorum da tanımlayabilirsiniz. Bu, kullanıcı comment/uncomment ile ilişkili kısayola bastığı zaman kullanılır.

keywords bölümü, anahtar sözcük listelerinin BÜYÜK/küçük harf duyarlı olup olmadığını tanımlar. Diğer öznitelikler daha sonra açıklanacaktır.

folding, emptyLines ve spellchecking bölümleri genelde gerekli değildir ve daha sonra açıklanacaklardır.

<general>
    <comments>
      <comment name="singleLine" start="#"/>
      <comment name="multiLine" start="###" end="###" region="CommentFolding"/>
    </comments>
    <keywords casesensitive="1"/>
    <folding indentationsensitive="0"/>
    <emptyLines>
      <emptyLine regexpr="\s+"/>
      <emptyLine regexpr="\s*#.*"/>
    </emptyLines>
    <spellchecking>
      <encoding char="á" string="\'a"/>
      <encoding char="à" string="\`a"/>
    </spellchecking>
  </general>
</language>

context ögesi, contexts grubuna aittir. Bağlamın kendisi, vurgu sistemi bir satırın sonuna ulaştığında ne olması gerektiği gibi bağlama özgü kuralları tanımlar. Kullanılabilir özellikler şunlardır:

name, bağlam adını belirtir. Kurallar, kuralın eşleşmesi durumunda geçiş yapılacak bağlamı belirtmek için bu adı kullanır.

attribute, hiçbir kural eşleşmediğinde veya bir kural özniteliği belirtilmediğinde bir karakter için kullanılacak biçemi tanımlar. Sonraki durumda, kuralın context'inde belirtilen attribute kullanılır.

lineEndContext, vurgu sistemi satırın sonuna geldiğinde geçiş yapılacak bağlamı tanımlar. Bu, ya başka bir bağlam adı, bağlamı değiştirmemek (bir şey yapmamak) için #stay veya bağlamdan çıkış yapmak için #pop olabilir. Örneğin, üç kez #pop#pop#pop yapmak veya hatta iki kez #pop#pop!OtherContext ve OtherContext adlı başka bağlama geçiş yapmak da olabilir. Ayrıca başka bir dil tanımına ait olan başka bir bağlama geçiş yapmak da olanaklıdır. Bu, IncludeRules kuralları ile aynı tarzdadır; örneğin, SomeContext##JavaScript. Bağlam anahtarları ek olarak “Vurgu Algılama Kuralları” içinde açıklanırlar. Öntanımlı: #stay.

lineEmptyContext, boş bir satıra rastlandığındaki bağlamı tanımlar. Bağlam anahtarlarının terminolojisi daha önce lineEndContext'te açıklananla aynıdır. Öntanımlı: #stay.

fallthroughContext, hiçbir kural eşleşmediğinde geçiş yapılacak sonraki bağlamı belirtir. Bağlam anahtarlarının terminolojisi daha önce lineEndContext'te açıklananla aynıdır. Öntanımlı: #stay.

fallthrough, hiçbir kural eşleşmediğinde sistemin fallthroughContext içinde belirtilen geçiş yapacağı bağlamı belirtir. KDE Frameworks 5.62 sürümünden bu yana bu özniteliğin fallthroughContext namına kullanımdan kaldırıldığını aklınızdan çıkarmayın. Özellikle, fallthroughContext özniteliği varsa örtük olarak fallthrough değerinin true olacağı anlaşılır. Öntanımlı: false.

noIndentationBasedFolding, bu bağlamdaki girintileme tabanlı katlamayı devre dışı bırakır. Girintileme tabanlı katlama etkinleştirilmemişse bu öznitelik bir işe yaramaz. Bu, general grubunun folding ögesinde tanımlanmıştır. Öntanımlı: false.

itemData ögesi, itemDatas grubundadır. Yazıtipi biçemini ve renklerini tanımlar. Böylece, kendi biçemlerinizi ve renklerinizi tanımlamanız olanaklıdır. Ancak biz yine de öntanımlı biçemlere sadık kalmanızı öneririz; böyle yaparsanız kullanıcı farklı dillerde de aynı renkleri görür. Bazen başka bir şansınız olmaz ve yazıtipi/renk özniteliklerini değiştirmeniz gerekebilir. name ve defStyleNum öznitelikleri zorunludur, diğerleri isteğe bağlıdır. Kullanılabilir öznitelikler şunlardır:

name, itemData’nın adını ayarlar. Bağlamlar ve kurallar, attribute özniteliğinde bir itemData’ya başvurmak için bu adı kullanırlar.

defStyleNum, hangi öntanımlı biçemin kullanılacağını tanımlar. Kullanılabilir öntanımlı biçemler ilerde daha ayrıntılı açıklanır.

color, bir renk tanımlar. Geçerli biçimler '#rrggbb' veya '#rgb' dir.

selColor, seçim rengini tanımlar.

italic true ise metin yatık olur.

bold true ise metin kalın olur.

underline true ise metnin altı çizili olur.

strikeOut true ise metnin üzeri çizili olur.

spellChecking true ise metnin yazımı denetlenir.

general grubundaki keywords ögesi, anahtar sözcük özelliklerini tanımlar. Kullanılabilir öznitelikler şunlardır:

casesensitive, true veya false olabilir. true ise tüm anahtar sözcükler BÜYÜK/küçük harf duyarlı olarak eşlenirler.

weakDeliminator, sözcük sınırlandırıcısı olarak davranmayan bir karakterler listesidir. Örneğin, '.' noktası bir sözcük sınırlandırıcısıdır. list içindeki bir anahtar sözcüğün bir nokta içerdiğini varsayalım; bu, noktayı eğer yalnızca bir zayıf sınırlandırıcı olarak tanımlarsanız eşleştirir.

additionalDeliminator, ek sınırlandırıcılar tanımlar.

wordWrapDeliminator, ardından bir satır kaydırma oluşabilecek karakterleri tanımlar.

Öntanımlı sınırlandırıcılar ve sözcük kaydırma sınırlandırıcıları şunlardır: .():!+,-<=>%&*/;?[]^{|}~\, boşluk (' ') ve sekmelendirici ('\t').

comments grubundaki comment ögesi; Araçlar → Yorum, Araçlar → Yorumu Kapat ve Araçlar → Yorumu Aç/Kapat seçenekleri için kullanılan yorum özelliklerini tanımlar. Kullanılabilir öznitelikler şunlardır:

name, ya singleLine ya da multiLine olabilir. multiLine seçerseniz end ve region öznitelikleri zorunludur. singleLine seçerseniz isteğe bağlı olan position özniteliğini ekleyebilirsiniz.

start, bir yorum başlatmak için kullanılan diziyi tanımlar. C++ için bu, çoklu satır yorumlarda "/*" olur. Bu öznitelik, multiLine ve singleLine türleri için zorunludur.

end, bir yorum kapatmak için kullanılan diziyi tanımlar. C++ için bu, çoklu satır yorumlarda "*/" olur. Bu öznitelik, yalnızca multiLine türü yorumlar için kullanılabilir ve onun için zorunludur.

region, katlanabilir çoklu satır yorumun adı olmalıdır. Kurallarınızda beginRegion="Comment" ... endRegion="Comment" olduğunu varsayalım; o zaman region="Comment" kullanmalısınız. Böylece, çoklu satır yorumun tüm metnini seçmeseniz bile yorumu kapatmak çalışır. Yalnızca, imleç çoklu satır yorumun içerisinde olmalıdır. Bu öznitelik, yalnızca multiLine türü için kullanılabilirdir.

position, tek satırlık yorumun nereye eklendiğini tanımlar. Öntanımlı olarak, tek satırlık yorum satırın başında 0. sütuna koyulur; ancak position="afterwhitespace" kullanırsanız yorum, ilk boş olmayan karakterden sonra sağa doğru boşluk bırakılarak eklenir. Bu; örneğin, Python veya YAML gibi girintilemenin önemli olduğu diller için kullanışlıdır. Bu öznitelik isteğe bağlıdır ve tek olası değeri afterwhitespace'dir. Bu, yalnızca singleLine türü için kullanılabilirdir.

general grubundaki folding ögesi, kod katlama özelliklerini tanımlar. Kullanılabilir öznitelikler şunlardır:

indentationsensitive true ise kod katlama imleyicileri girintileme tabanlı olarak eklenir. Örnek olarak yine Python verilebilir. Genelde öntanımlı olarak false olduğundan pek ayarlamanıza gerek olmaz.

emptyLines grubundaki emptyLine ögesi, hangi satırlara boş satır gibi davranılması gerektiğini tanımlar. Bu, context ögelerindeki lineEmptyContext özniteliğinin davranışının değiştirilmesine olanak tanır. Kullanılabilir öznitelikler şunlardır:

regexpr, boş bir satır olarak davranılacak bir düzenli ifade tanımlar. Öntanımlı olarak, boş satırlar hiçbir karakter içermezler, dolayısıyla, bu ek boş satırlar ekler; örneğin, boşluklar içeren satırların da boş satırlar olarak kabul edilmesini istiyorsanız yararlıdır. Çoğu sözdizim tanımında bu özniteliği ayarlamanız gerekmez.

spellchecking grubundaki encoding ögesi, yazım denetimi için bir karakter kodlaması tanımlar. Kullanılabilir öznitelikler şunlardır:

char, bir kodlanmış karakterdir.

string, yazım denetimindeki char karakteri olarak kodlanacak karakterler dizisidir. Örneğin, LaTeX için \"{A} dizisi Ä karakterini temsil eder.

Genel öntanımlı biçemler:

Özel bir vurgulama gerekmediğinde dsNormal.

dsKeyword, yerleşik dil anahtar sözcükleri.

dsFunction, işlev çağrıları ve tanımları.

dsVariable, kullanılabiliyorsa değişken adları (örneğin., PHP/Perl için $someVar).

dsControlFlow; if, else, switch, break, return, yield, vb. denetim akışı anahtar sözcükleri.

dsOperator, + - * / :: < > gibi işleçler.

dsBuiltIn, yerleşik işlevler, sınıflar ve nesneler.

dsExtension, ortak uzantılar; örneğin, C++ ve Python içindeki Qt™ sınıfları ve işlevler/makrolar.

dsPreprocessor, önişlemci ifadeleri veya makro tanımları.

dsAttribute, @override ve __declspec(...) gibi açıklamalar.

Dizi ile ilgili öntanımlı biçemler:

dsChar, 'x' gibi tekli karakterler.

dsSpecialChar, kaçışlar, yer değiştirmeler, veya düzenli ifade işleçleri gibi özel anlama sahip diziler.

dsString, "merhaba dünya" gibi diziler.

dsVerbatimString, Perl, CoffeeScript ve kabuklardaki ’raw \backlash’ ve Python’daki r’\raw’ gibi gerçek veya ham diziler.

dsSpecialString, SQL, regex’ler, HERE belgeleri, L^AT_EX matematik kipi, ...

dsImport; modüllerin import, include, require ifadeleri.

Sayı ile ilgili öntanımlı biçemler:

dsDataType; int, void, u64 gibi yerleşik veri türleri.

dsDecVal, ondalık değerler.

dsBaseN, 10 dışında tabana sahip değerler.

dsFloat, kayan noktalı değerler.

dsConstant, Pİ gibi yerleşik ve kullanıcı tanımlı sabitler.

Yorum ve belgelendirmeyle ilgili öntanımlı biçemler:

dsComment, yorumlar.

dsDocumentation, /** Belgelendirme yorumları */ veya """docstrings""".

dsAnnotation, @param, @brief gibi belgelendirme komutları.

dsCommentVar, yukarıdaki komutlarda kullanılan değişken adları; @param foobar’daki "foobar" gibi.

dsRegionMarker; yorumlardaki //BEGIN, //END gibi bölge imleyicileri.

Diğer öntanımlı biçemler:

dsInformation, doxygen içindeki @note gibi notlar ve ipuçları.

dsWarning, doxygen’deki @warning gibi uyarılar.

dsAlert; TODO, FIXME, XXXX gibi özel sözcükler.

dsError, hata vurgulaması ve yanlış sözdizim.

dsOthers, başka hiçbir şey uymadığında kullanılır.

DetectChar

Tek bir belirli karakteri algılar. Genellikle kapatma tırnaklarını bulmak için kullanılır.

<DetectChar char="(karakter)" (ortak öznitelikler) (devingen) />

char özniteliği, eşleştirilecek karakteri tanımlar.

Detect2Chars

Tanımlı bir sırada iki belirli karakteri algılar.

<2KarakterAlgıla char="(karakter)" char1="(karakter)" (ortak öznitelikler) />

char özniteliği, eşleştirilecek ilk karakteri, char1 ise ikincisini tanımlar.

Bu kural tarihsel nedenlerden dolayı buradadır; okunabilirlik açısından StringDetect kullanılması tercih nedenidir.

AnyChar

Belirli bir karakter kümesinden tek bir karakteri algılar.

<AnyChar String="(dizi)" (ortak öznitelikler) />

String özniteliği, karakterlerin kümesini tanımlar.

StringDetect

Kesin bir diziyi algılar.

<StringDetect String="(dizi)" [insensitive="true|false"] (ortak öznitelikler) (devingen) />

String özniteliği, eşleştirilecek diziyi tanımlar. insensitive özniteliği öntanımlı olarak false'tur ve dizi karşılaştırma işlevine geçirilir. Değer true ise duyarsız karşılaştırma kullanılır.

WordDetect

Tam bir diziyi algılar; ancak sözcük başlangıcında ve sonunda '.' veya boşluk gibi sözcük sınırlarına gereksinim duyar. Bir düzenli ifade kapsamında \b<string>\b gibi düşünün; ancak RegExpr kuralından daha hızlıdır.

<SözcükAlgıla String="(dizi)" [insensitive="true|false"] (ortak öznitelikler) (yerel sınırlandırıcılar) />

String özniteliği, eşleştirilecek diziyi tanımlar. insensitive özniteliği öntanımlı olarak false'tur ve dizi karşılaştırma işlevine geçirilir. Değer true ise duyarsız karşılaştırma kullanılır.

Kate 3.5 (KDE 4.5) sürümünden bu yana

RegExpr

Bir düzenli ifade ile eşleşir.

<RegExpr String="(dizi)" [insensitive="true|false"] [minimal="true|false"] (ortak öznitelikler) (devingen) />

String özniteliği, düzenli ifadeyi tanımlar.

insensitive öntanımlı olarak false'tur ve düzenli ifade işletkesine geçirilir.

minimal öntanımlı olarak false'tur ve düzenli ifade işletkesine geçirilir.

Kurallar her zaman geçerli dizinin başlangıcına göre eşleştirildiğinden, düzeltme işaretiyle (^) başlayan düzenli ifade, kuralın yalnızca satırın başlangıcına göre eşleştirilmesi gerektiğini belirtir.

Bunlar hakkında daha fazla bilgi için Düzenli İfadeler bağlantısına bakın.

keyword

Belirli bir listeden bir anahtar sözcüğü algılar.

<anahtar sözcük String="(liste ado)" (ortak öznitelikler) (yerel sınırlandırıcılar) />

String özniteliği, adıyla anahtar sözcük listesini tanımlar. Bu ada sahip bir liste var olmalıdır.

Vurgulama sistemi, anahtar sözcük kurallarını oldukça eniyilenmiş bir biçimde işler. Bu, eşleştirilecek tüm anahtar sözcüklerin, örtük biçimde (öntanımlı sınırlandırıcılar) veya keywords etiketinin additionalDeliminator özelliğiyle açıkça belirtilmiş bir biçimde tanımlı sınırlandırıcılarla eşleştirilmiş olmasını bir gereklilik kılar.

Eşleştirilecek bir anahtar sözcükte sınırlandırıcı bir karakter varsa bu ilgili karakter keywords etiketinin weakDeliminator özelliğine eklenmelidir. Sonrasında bu karakter tüm keyword kurallarında sınırlandırıcı kimliğini kaybeder. Aynı zamanda, keyword'ün weakDeliminator özniteliği de kullanılabilir; böylece bu değişiklik yalnızca bu kural için geçerli olur.

Int

Bir tamsayıyı algılar (şu düzenli ifade gibi: \b[0-9]+).

<Int (ortak öznitelikler) (yerel sınırlandırıcılar) />

Bu kuralın belirli bir özniteliği yoktur.

Float

Bir kayan noktalı sayıyı algılar (şu düzenli ifade gibi: (\b[0-9]+\.[0-9]*|\.[0-9]+)([eE][-+]?[0-9]+)?).

<Float (ortak öznitelikler) (yerel sınırlandırıcılar) />

Bu kuralın belirli bir özniteliği yoktur.

HlCOct

Bir sekizlik noktalı sayı temsilini algılar (şu düzenli ifade gibi: \b0[0-7]+).

<HlCOct (ortak öznitelikler) (yerel sınırlandırıcılar) />

Bu kuralın belirli bir özniteliği yoktur.

HlCHex

Bir onaltılık sayı temsilini algılar (şu düzenli ifade gibi: \b0[xX][0-9a-fA-F]+).

<HlCHex (ortak öznitelikler) (yerel sınırlandırıcılar) />

Bu kuralın belirli bir özniteliği yoktur.

HlCStringChar

Kaçırılan bir karakteri algılar.

<HlCStringChar (ortak öznitelikler) />

Bu kuralın belirli bir özniteliği yoktur.

Program kodunda sıkça kullanılan karakterlerin gerçek temsilleriyle eşleşir; örneğin, \n (yenisatır) veya \t (SEKME).

Eğer bir ters eğik çizgi (\) sonrasında geliyorlarsa aşağıdaki karakterler eşleşir: abefnrtv"'?\. Ek olarak, kaçırılan onaltılık (örneğin, \xff) ve sekizlik (örneğin, \033) karakterler de eşleşir.

HlCChar

Bir C karakterini algılar.

<HlCChar (ortak öznitelikler) />

Bu kuralın belirli bir özniteliği yoktur.

Bir kesme işareti çifti içine alınmış C karakterleriyle eşleşir (Örnek: 'c'). Kesme işaretleri normal bir karakter veya kaçırılmış bir karakter olabilir. Eşleştirilen kaçırılmış karakter dizileri hakkında daha fazla bilgi için HlCStringChar bölümüne bakın.

RangeDetect

Tanımlı bir başlangıç ve bitiş karakterleri olan bir diziyi algılar.

<RangeDetect char="(karakter)"  char1="(karakter)" (ortak öznitelikler) />

char, erimi başlatan karakteri, char1 ise bitiren karakteri tanımlar.

Örneğin küçük alıntılanmış dizileri ve benzerlerini algılamak için kullanışlıdır; ancak vurgulama işletkesi her kerede bir satır üzerinde çalıştığından, bunun bir satır sonu boyunca uzanan dizileri bulmayacağını unutmayın.

LineContinue

Satırın sonundaki belirli bir karakterle eşleşir.

<LineContinue (ortak öznitelik) [char="\"] />

char isteğe bağlı eşleştirilecek karakterdir, öntanımlısı ise ters eğik çizgidir ('\'). KDE sürümünden bu yana eklidir.

Bu kural, satırın sonunda bağlamı değiştirmek için kullanışlıdır. Bu, örneğin C/C++'da makroları veya dizileri sürdürmek için gereklidir.

IncludeRules

Başka bir bağlamdan, dilden veya dosyadan kuralları içerir.

<IncludeRules context="contextlink" [includeAttrib="true|false"] />

context özniteliği, hangi bağlamın içerileceğini tanımlar.

Basit bir diziyse tanımlı tüm kuralları geçerli bağlama içerir; örneğin:

<IncludeRules context="anotherContext" />

Dizi bir ## içeriyorsa vurgu sistemi, verilen adda başka bir dilden bir bağlam arar; örneğin,

<IncludeRules context="String##C++" />

, C++ vurgulama tanımından String bağlamını içerir.

includeAttrib özniteliği true ise hedef özniteliği kaynağın olanına değiştirin. Bu; örneğin dahil edilen bağlamla eşleşen metnin ana bilgisayar bağlamından farklı bir vurgu olması durumunda yorum yapma işleminin gerçekleştirilmesi için gereklidir.

DetectSpaces

Boşlukları algılar.

<DetectSpaces (ortak öznitelikler) />

Bu kuralın belirli bir özniteliği yoktur.

İleride birkaç boşluk olabileceğini biliyorsanız; örneğin, girintili çizgilerin başında bu kuralı kullanın. Bu kural, birden fazla kuralı sınamak ve eşleşme olmaması nedeniyle birer birer atlamak yerine, tüm boşlukları tek kerede atlayacaktır.

DetectIdentifier

Tanımlayıcı dizilerini algılar (şu düzenli ifade gibi: [a-zA-Z_][a-zA-Z0-9_]*).

<DetectIdentifier (ortak öznitelikler) />

Bu kuralın belirli bir özniteliği yoktur.

Birden çok kuralla sınamak ve eşleşme olmaması nedeniyle birer birer atlamak yerine, bir dizi sözcük karakterini aynı anda atlamak için bu kuralı kullanın.