set-tab-width {INTEGER larĝo}

Agordas la tab-larĝon al la nombro kun.

set-indent-width {INTEGER larĝo}

Agordas la indentlarĝon al la nombro larĝo. Uzata nur se vi indentigas per spacoj.

set-word-wrap-column {INTEGER larĝo}

Agordas la linilarĝon por malmola volvado al larĝo. Ĉi tio estas uzata se vi envolvas vian tekston aŭtomate.

set-icon-border {BOOLEAN aktivigo}

Agordas la videblecon de la piktogramo.

set-folding-markers {BOOLEAN aktivigi}

Agordas la videblecon de la faldebla markilo-fenestro.

set-line-numbers {BOOLEAN ebligi}

Agordas la videblecon de la lininumera panelo.

set-replace-tabs {BOOLEAN aktivigo}

Se enŝaltite, taboj estas anstataŭigitaj per spacoj dum vi tajpas.

set-remove-trailing-space {BOOLEAN aktivigo}

Se ĝi estas ebligita, la malantaŭa blankspaco estas forigita kiam ajn la kursoro forlasas linion.

set-show-tabs {BOOLEAN aktivigi}

Se ĝi estas ebligita, TAB-signoj kaj malantaŭa blankspaco estos bildigitaj per malgranda punkto.

set-show-indent {BOOLEAN aktivigo}

Se ebligita, indentaĵo estos bildigita per vertikala punktlinio.

set-indent-spaces {BOOLEAN aktivigo}

Se ĝi estas ebligita, la redaktilo deŝovos per indent-width spacoj por ĉiu indentnivelo, prefere ol per unu TAB-signo.

set-mixed-indent {BOOLEAN aktivigo}

Se ebligita, KatePart uzos miksaĵon de TAB kaj spacoj por indentaĵo. Ĉiu indentnivelo estos larĝa indent-width, kaj pli da indentniveloj estos optimumigitaj por uzi tiom da TAB-signoj kiel eble.

Kiam efektivigata, ĉi tiu komando aldone ebligos spacetan deŝovon, kaj se la indentlarĝo estas nespecifita, ĝi estos agordita al duono de la tab-larĝo por la dokumento en la momento de la efektivigo.

set-word-wrap {BOOLEAN aktivigo}

Ebligas dinamikan vortŝanĝon laŭ ebligi.

set-replace-tabs-save {BOOLEAN aktivigi }

Kiam estas ebligita, taboj estos anstataŭigitaj per blankspaco kiam la dokumento estas konservita.

set-remove-trailing-space-save {BOOLEAN aktivigi}

Kiam ĝi estas ebligita, posta spaco estos forigita de ĉiu linio kiam la dokumento estas konservita.

set-indent-mode {STRING nomo}

Agordas la aŭtomatan indentan reĝimon al nomo. Se nomo ne estas konata, la reĝimo estas agordita al 'neniu'. Validaj reĝimoj estas 'neniu', 'normala', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' kaj 'xml'.

set-auto-ident {BOOLEAN skripto}

Ebligi aŭ malŝalti aŭtomatan deŝovon.

set-highlight {STRING elstarigi}

Agordas la sintaksan reliefigsistemon por la dokumento. La argumento devas esti valida elstara nomo, kiel vidite en la menuo Iloj → Elstarigado. Ĉi tiu komando provizas aŭtomatan liston por sia argumento.

reload-scripts

Reŝargi ĉiujn JavaScript skriptoj uzataj de Kate, inkluzive de endentiloj kaj komandliniaj skriptoj.

set-mode {STRING reĝimo}

Elektu la dosiertipskemon por la nuna dokumento.

nn[oremap] {STRING originala} {STRING mapita}

Mapi la klavsekvencon origina al mapita.

indent

Indentigas la elektitajn liniojn aŭ la nunan linion.

unindent

Malstreĉigas la elektitajn liniojn aŭ aktualan linion.

cleanindent

Purigas la indentaĵon de la elektitaj linioj aŭ aktuala linio laŭ la indentaĵagordoj en la dokumento.

comment

Enmetas komentmarkojn por fari la elekton aŭ elektitajn liniojn aŭ nunan linion komento laŭ la tekstformato kiel difinita de la sintaksa emfaza difino por la dokumento.

uncomment

Forigas komentsignojn de la elekto aŭ elektitaj linioj aŭ aktuala linio laŭ la tekstformato kiel difinita de la sintaksa emfaza difino por la dokumento.

kill-line

Forigas la nunan linion.

replace { STRING ŝablono} {STRING anstataŭigo}

Anstataŭigas tekston kongruan kun ŝablono per anstataŭaĵo. Se vi volas enmeti blankspacon en la ŝablono, vi devas citi kaj la ŝablono kaj anstataŭaĵo per unuopaj aŭ duoblaj citiloj. Se la argumentoj estas necititaj, la unua vorto estas uzata kiel ŝablono kaj la ceteraj por anstataŭaĵo. Se anstataŭaĵo estas malplena, ĉiu okazo de ŝablono estas forigita.

Vi povas agordi flagojn por agordi la serĉon aldonante dupunkton, sekvitan de unu aŭ pluraj literoj ĉiu reprezentante agordon, donante la formon replace:options padronanstataŭigo. Disponeblaj opcioj estas:

b

Serĉi malantaŭen.

c

Serĉi ekde la pozicio de la kursoro.

e

Serĉi nur en la elekto.

r

Fari regul-espriman serĉon. Se agordita, vi povas uzi \N kie N estas nombro por reprezenti kaptojn en la anstataŭiga ĉeno.

s

Fari usklecdistingan serĉon.

p

Peti permeson anstataŭigi la sekvan okazon.

w

Kongrui nur tutajn vortojn.

date {STRING formato}

Enmetas daton/horan ĉenon kiel difinitan per la specifita formato, aŭ la formaton “jjyy-MM-dd hh:mm:ss” se neniu estas specifita. La sekvaj tradukoj estas faritaj dum interpretado de formato:

d	La tago kiel nombro sen unua nulo (1-31).
dd	La tago kiel nombro kun unua nulo (01-31).
ddd	La mallongigita lokalizita tagnomo (ekz. 'Lun'..'Suno').
ddd	La longa lokalizita tagnomo (ekz. 'lundo'..'dimanĉo').
M	La monato kiel nombro sen unua nulo (1-12).
MM	La monato kiel nombro kun unua nulo (01-12).
MMMM	La longa lokalizita monata nomo (ekz. 'januaro'..'decembro').
MMM	La mallongigita lokalizita monata nomo (ekz. 'Jan'..'Dec').
jj	La jaro kiel ducifera nombro (00-99).
yyyy	La jaro kiel kvarcifera nombro (1752-8000).
h	La horo sen antaŭa nulo (0..23 aŭ 1..12 se montriĝas AM/PM).
hh	La horo kun unua nulo (00..23 aŭ 01..12 se montriĝas AM/PM).
m	La minuto sen unua nulo (0..59).
mm	La minuto kun unua nulo (00..59).
s	La dua sen unua nulo (0..59).
ss	La dua kun unua nulo (00..59).
z	La milisekundoj sen antaŭaj nuloj (0..999).
zzz	La milisekundoj kun antaŭaj nuloj (000..999).
AP	Uzi AM/PM-montron. AP estos anstataŭigita per aŭ "AM" aŭ "PM".
ap	Uzi am/pm-montron. ap estos anstataŭigita per aŭ "am" aŭ "pm".

char {STRING identigilo}

Ĉi tiu komando permesas enmeti laŭvortajn signojn laŭ ilia nombra identigilo, en dekuma, okuma aŭ deksesuma formo. Por uzi ĝin lanĉu la dialogon de Redaktado-Komando kaj tajpu char: [numero] en la enirkesto, tiam premu OK.

Ekzemplo 5.1. char ekzemploj

Enigo: char:234

Eligo: ê

Enigo: char:0x1234

Eligo: ሴ

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

Ĉi tiu komando faras 'sed'-similan serĉan/anstataŭigan operacion sur la nuna linio, aŭ sur la tuta dosiero (%s///).

Resume, la teksto estas serĉata por teksto kongrua kun la serĉa ŝablono, la regula esprimo inter la unua kaj la dua oblikvo, kaj kiam kongruo estas trovita, la kongrua parto de la teksto estas anstataŭigita per la esprimo. inter la dua kaj lasta oblikvo. Krampoj en la serĉŝablono kreas malantaŭajn referencojn, tio estas la komando memoras kiu parto de la ĉeno kongruis en la krampoj; ĉi tiuj ĉenoj povas esti reuzitaj en la anstataŭiga ŝablono, nomata \1 por la unua aro de krampoj, \2 por la dua ktp.

Por serĉi laŭvortan ( aŭ ), vi devas eskapi ĝin per malantaŭa oblikva signo: \(\)

Se vi metas i ĉe la fino de la esprimo, la kongruo estos malsenca. Se vi metas g ĉe la fino, ĉiuj aperoj de la ŝablono estos anstataŭigitaj, alie nur la unua apero estas anstataŭigita.

Ekzemplo 5.2. Anstataŭigante tekston en la nuna linio

Via amika kompililo ĵus haltis, dirante al vi, ke la klaso miaKlaso menciita en linio 3902 en via fontdosiero ne estas difinita.

"Buko!" vi pensas, ĝi estas kompreneble MiaKlaso. Vi iras al linio 3902, kaj anstataŭ provi trovi la vorton en la teksto, vi lanĉas la Redaktan Komando-Dialogon, enigas s/miaklaso/MiaKlaso/i, premas la OK butonon, konservas la dosieron kaj kompilas – sukcese sen la eraro.

Ekzemplo 5.3. Anstataŭigante tekston en la tuta dosiero

Imagu, ke vi havas dosieron, en kiu vi plurfoje mencias “Fraŭlino Jensen”, kiam iu envenas kaj diras al vi, ke ŝi ĵus edziĝis al “Sinjoro Jones”. Vi volas, kompreneble, anstataŭigi ĉiun kaj ĉiun aperon de “Fraŭlino Jensen” per “S-ino Jones”.

Enigu la komandlinion kaj eligu la komandon %s/Miss Jensen/Ms Jones/ kaj premu enigklavon, vi finis.

Ekzemplo 5.4. Pli Altnivela Ekzemplo

Ĉi tiu ekzemplo uzas malantaŭajn referencojn kaj ankaŭ karaktroklason (se vi ne scias kio tio estas, bonvolu raporti al la rilata dokumentaro menciita sube).

Supozu, ke vi havas la sekvan linion:

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

Nun vi rimarkas, ke ĉi tio ne estas bela kodo, kaj decidas, ke vi volas uzi la ŝlosilvorton const por ĉiuj “adreso de” argumentoj, tiuj karakterizitaj de la & operatoro antaŭ la argumentnomo. Vi ankaŭ ŝatus simpligi la blankspacon, tiel ke estu nur 1 blankspaco inter ĉiu vorto.

Lanĉu la Redaktan Komandan Dialogon, kaj enigu: s/\s+(\w+)\s+(&)/ const \1 \2/g kaj premu la OK butono. La g ĉe la fino de la esprimo faras la regulan esprimon rekompili por ĉiu kongruo por konservi la malantaŭreferencojn.

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

Misio plenumita! Nun, kio okazis? Nu, ni serĉis iom da blankspaco (\s+) sekvata de unu aŭ pluraj alfabetaj signoj (\w+) sekvata de iom da plia blankspaco (\s+) sekvita de kaj-signo, kaj en la procezo konservis la alfabetan pecon kaj la kaj-signon por reuzo en la anstataŭiga operacio. Poste ni anstataŭigis la kongruan parton de nia linio per unu blankspaco sekvita de “konst” sekvita de unu blankspaco sekvita de nia konservita alfabeta peco (\1) sekvita de unu blankspaco sekvita de nia konservita kaj-signo (\2)

Nun en kelkaj kazoj la alfabeta peco estis “String”, en iu “int”, do uzante la signoklason \w kaj la + kvantigilo pruvis valora valoraĵo.

sort

Ordigas la elektitan tekston aŭ tutan dokumenton.

natsort

Ordigi la elektitajn liniojn aŭ tutan dokumenton nature.

Ekzemplo 5.5. sort kontraŭ natsort

sort(a10, a1, a2) rezultigas a1, a10, a2

natsort(a10, a1, a2) rezultigas a1, a2, a10

moveLinesDown

Movi elektitajn liniojn malsupren.

moveLinesUp

Movi elektitajn liniojn supren.

uniq

Forigi duobligitajn liniojn el la elektita teksto aŭ la tuta dokumento.

rtrim

Forigu malantaŭan spacon de la elektita teksto aŭ de la tuta dokumento.

ltrim

Forigi antaŭiran spacon el la elektita teksto aŭ el la tuta dokumento.

join [STRING disigilo]

Kunigi elektitajn liniojn aŭ tutan dokumenton. Laŭvole prenas parametron difinantan apartigilon, ekzemple: join ', '

rmblank

Forigi ĉiujn malplenajn spacojn el la elektita teksto aŭ la tuta dokumento.

alignon

Ĉi tiu komando vicigas liniojn en la elektita bloko aŭ tuta dokumento sur la kolumno donita per regula esprimo donita kiel argumento.

Se vi donas malplenan ŝablonon, ĝi vicigos al la unua nemalplena signo defaŭlte.

Se la ŝablono havas kapton, ĝi deŝovos sur la kaptita kongruo.

Ekzemploj:

alignon - enmetos spacojn antaŭ la unua '-' de ĉiu linio por vicigi ilin ĉiujn sur la sama kolumno.

alignon :\\s+(.) enmetos spacojn antaŭ la unua nemalplena signo kiu okazas post dupunkto por vicigi ilin ĉiujn sur la sama kolumno.

unwrap

Malvolvi la elektitan tekston aŭ la tutan dokumenton.

each {STRING skripto}

Donita JavaScript funkcion kiel argumento, voki tion por la listo de elektitaj linioj kaj anstataŭigi ilin per la liveraĵo de tiu retrovoko.

Ekzemplo 5.6. Kunigi elektitajn liniojn

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

Aŭ, pli mallonge:

each 'linioj.join(", ")'

filter {STRING skripto}

Donita JavaScript funkcion kiel argumento, voki tion por la listo de elektitaj linioj kaj forigi tiujn kie la revoko liveras malvera.

Ekzemplo 5.7. Forigi malplenajn liniojn

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

Aŭ, pli mallonge:

filter 'line.length > 0'

map {STRING skripto}

Donita JavaScript funkcion kiel argumento, voki tion por la listo de elektitaj linioj kaj anstataŭigi la linion per la valoro de la revoko.

Ekzemplo 5.8. Forigi malplenajn liniojn

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

Aŭ, pli mallonge:

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

duplicateLinesUp

Duobligi la elektitajn liniojn super la nuna elekto.

duplicateLinesDown

Duobligi la elektitajn liniojn sub la nuna elekto.

goto {INT linio}

Ĉi tiu komando navigas al la specifita linio.

grep {STRING ŝablono}

Priserĉi la dokumenton laŭ la regula esprimo ŝablono. Por pliaj informoj, vidu Apendico A, Regulaj Esprimoj.

find {STRING ŝablono}

Ĉi tiu komando navigas al la unua okazo de ŝablono laŭ la agordo. Sekvaj okazoj troveblas per Redakti → Trovi Sekvan (la defaŭlta ŝparvojo estas F3).

La find-komando povas esti agordita aldonante dupunkton sekvitan de unu aŭ pluraj opcioj, la formo estas find:options-ŝablono. La sekvaj opcioj estas subtenataj:

b

Serĉi malantaŭen.

c

Serĉi ekde la pozicio de la kursoro.

e

Serĉi nur en la elekto.

r

Fari regul-espriman serĉon. Se agordita, vi povas uzi \N kie N estas nombro por reprezenti kaptojn en la anstataŭiga ĉeno.

s

Fari usklecdistingan serĉon.

w

Kongrui nur tutajn vortojn.

ifind {STRING ŝablono}

Ĉi tiu komando provizas “kiel vi tajpas” serĉadon. Vi povas agordi la konduton de la serĉo aldonante dupunkton sekvitan de unu aŭ pluraj opcioj, kiel ĉi tio: ifind:options pattern. Permesitaj opcioj estas:

b

Serĉi malantaŭen.

r

Fari regul-espriman serĉon.

s

Fari usklecdistingan serĉon.

c

Serĉi ekde la pozicio de la kursoro.

w

Konservi la aktualan dokumenton.

wa

Konservi ĉiujn nuntempe malfermitajn dokumentojn.

q

Fermi la aktualan dokumenton.

qa

Fermi ĉiujn malfermitajn dokumentojn.

wq

Konservi kaj fermi la aktualan dokumenton.

wqa

Konservi kaj fermi ĉiujn nuntempe malfermitajn dokumentojn.

x

Konservi kaj fermi la aktualan dokumenton nur se ĝi ŝanĝiĝis.

x

Konservi kaj fermi ĉiujn nuntempe malfermitajn dokumentojn nur se ili ŝanĝiĝis.

bp

Iri al la antaŭa dokumento en la listo de dokumentoj.

bn

Iri al la sekva dokumento en la listo de dokumentoj.

new

Malfermi novan dokumenton en horizontale dividita vido.

vnew

Malfermi novan dokumenton en vertikale dividita vido.

e

Reŝargi la aktualan dokumenton se ĝi ŝanĝiĝis sur disko.

enew

Redakti novan dokumenton.

print

Malfermi la dialogon Presi por presi la aktualan dokumenton.

Ĉefaj sekcioj de KatePart Emfazaj Difindosierojn

Elstariga dosiero enhavas kaplinion kiu fiksas la XML versio:

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

La radiko de la difindosiero estas la elemento lingvo. Disponeblaj atributoj estas:

Bezonataj atributoj:

nomo fiksas la nomon de la lingvo. Ĝi aperas poste en la menuoj kaj dialogoj.

sekcio specifas la kategorion.

etendoj difinas dosierajn etendaĵojn, kiel "*.cpp;*.h"

versio specifas la nunan revizion de la difindosiero laŭ entjera nombro. Kiam ajn vi ŝanĝas elstaran difindosieron, certigu pliigi ĉi tiun nombron.

kateversion specifas la plej lastan subtenatan KatePart versio.

Laŭvolaj atributoj:

mimetype asocias MIME-tipon al dosieroj.

majusklesendebla difinas ĉu la ŝlosilvortoj distingas minusklecon aŭ ne.

prioritato estas necesa se alia elstara difindosiero uzas la samajn etendaĵojn. La pli alta prioritato venkos.

aŭtoro enhavas la nomon de la aŭtoro kaj lian retadreson.

licenco enhavas la permesilon, kutime la MIT-licencon por novaj sintaksaj eminentaj dosieroj.

stilo enhavas la provizitan lingvon kaj estas uzata de la indentistoj por la atributo required-syntax-style.

indentor difinas kiun indentigilo estos uzata defaŭlte. Disponeblaj indentiloj estas: ada, normala, cstyle, cmake, haskell, latex, lilypond, lisp, lua, pascal, python, replicode, ruby kaj xml.

kaŝita difinas ĉu la nomo aperu en la menuoj de KatePart.

Do la sekva linio povas aspekti jene:

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

Poste venas la elemento markigo, kiu enhavas la laŭvolan elementon list kaj la postulatajn elementojn kuntekstoj kaj itemDatas.

listo elementoj enhavas liston de ŝlosilvortoj. Ĉi-kaze la ŝlosilvortoj estas klaso kaj konst. Vi povas aldoni tiom da listoj kiom vi bezonas.

Ekde KDE Frameworks 5.53, listo povas inkluzivi ŝlosilvortojn de alia listo aŭ lingvo/dosiero, uzante la elementon include. ## estas uzata por apartigi la listonomon kaj la lingvodifinnomon, same kiel en la regulo Inkludi Regulojn. Ĉi tio estas utila por eviti duobligi ŝlosillistojn, se vi bezonas inkluzivi la ŝlosilvortojn de alia lingvo/dosiero. Ekzemple, la listo alianomo enhavas la ŝlosilvorton str kaj ĉiujn ŝlosilvortojn de la listo tipoj, kiu apartenas al la ISO C++ lingvo.

La elemento kuntekstoj enhavas ĉiujn kuntekstojn. La unua kunteksto estas defaŭlte la komenco de la reliefigo. Estas du reguloj en la kunteksto Normala Teksto, kiuj kongruas kun la listo de ŝlosilvortoj kun la nomo iunomo kaj regulo, kiu detektas citilon kaj ŝanĝas la kuntekston al ĉeno. Por lerni pli pri reguloj legu la sekvan ĉapitron.

La tria parto estas la elemento itemDatas. Ĝi enhavas ĉiujn kolorojn kaj tiparstilojn bezonatajn de la kuntekstoj kaj reguloj. En ĉi tiu ekzemplo, la itemData Normala Teksto, String kaj Ŝlosilvorto estas uzataj.

<highlighting>
    <list name="iunomo">
      <item>class</item>
      <item>const</item>
    </list>
    <list name="alianomo">
      <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="iunomo" />
        <keyword attribute="Keyword" context="#stay" String="alianomo" />
        <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>

La lasta parto de elstara difino estas la laŭvola sekcio ĝenerala. Ĝi povas enhavi informojn pri ŝlosilvortoj, kodfaldado, komentoj, deŝovo, malplenaj linioj kaj literuma kontrolo.

La sekcio komento difinas per kia ĉeno unulinia komento estas enkondukita. Vi ankaŭ povas difini plurlinian komenton uzante multiLine kun la kroma atributo end. Ĉi tio estas uzata se la uzanto premas la respondan ŝparvojon por comment/uncomment.

La sekcio keywords difinas ĉu ŝlosilvortlistoj distingas usklecon aŭ ne. Aliaj atributoj estos klarigitaj poste.

La aliaj sekcioj, folding, emptyLines kaj spellchecking, kutime ne necesas kaj estas klarigitaj poste.

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

La elemento context apartenas al la grupo contexts. Kunteksto mem difinas kunteksto-specifajn regulojn kiel ekzemple kio devus okazi se la elstara sistemo atingas la finon de linio. Disponeblaj atributoj estas:

name deklaras la kuntekstan nomon. Reguloj uzos ĉi tiun nomon por specifi la kuntekston por ŝanĝi, se la regulo kongruas.

attribute identigas la stilon por uzi por signo kiam neniu regulo kongruas aŭ kiam regulo ne specifas atributon. En ĉi-lasta kazo, estos uzata attribute de la kunteksto specifita en la context de la regulo.

lineEndContext difinas la kuntekston, al kiu la emfazsistemo ŝanĝas se ĝi atingas la finon de linio. Ĉi tio povas aŭ esti nomo de alia kunteksto, #stay por ne ŝanĝi la kuntekston (ekz.. fari nenion) aŭ #pop kiu igos ĝin forlasi ĉi tiun kuntekston. Eblas uzi ekzemple #pop#pop#pop por krevi trifoje, aŭ eĉ #pop#pop!OtherContext por krevi dufoje kaj ŝanĝi al la kunteksto nomata Alia Kunteksto. Eblas ankaŭ ŝanĝi al kunteksto, kiu apartenas al alia lingvodifino, same kiel en la reguloj Inkluzi Reguloj, ekz., IuKunteksto##JavaScript. Kuntekstŝaltiloj ankaŭ estas priskribitaj en la sekcio nomata “Emfazodetektaj Reguloj”. Defaŭlto: #stay.

lineEmptyContext difinas la kuntekston se malplena linio estas renkontita. La nomenklaturo de kuntekstŝaltiloj estas la sama kiel antaŭe priskribita en lineEndContext. Defaŭlto: #stay.

fallthroughContext specifas la sekvan kuntekston por ŝanĝi se neniu regulo kongruas. La nomenklaturo de kuntekstŝaltiloj estas la sama kiel antaŭe priskribita en lineEndContext. Defaŭlto: #stay.

fallthrough difinas ĉu la emfazsistemo ŝanĝas al la kunteksto specifita en fallthroughContext se neniu regulo kongruas. Notu ke ekde KDE Frameworks 5.62 ĉi tiu atributo estas malrekomendita favore al fallthroughContext, ĉar se la atributo fallthroughContext ĉeestas, estas implicite komprenite, ke la valoro de fallthrough estas true. Defaŭlto: false.

noIndentationBasedFolding malŝaltas indent-bazitan faldadon en la kunteksto. Se indent-bazita faldado ne estas aktivigita, ĉi tiu atributo estas senutila. Ĉi tio estas difinita en la elemento folding de la grupo general. Defaŭlto: false.

La elemento itemData estas en la grupo itemData. Ĝi difinas la tiparstilon kaj kolorojn. Do eblas difini viajn proprajn stilojn kaj kolorojn. Tamen, ni rekomendas vin alteni la defaŭltajn stilojn se eble, por ke la uzanto ĉiam vidu la samajn kolorojn uzatajn en malsamaj lingvoj. Tamen, foje ne ekzistas alia maniero kaj necesas ŝanĝi kolorojn kaj tipatributojn. La atributoj name kaj defStyleNum estas postulataj, la aliaj estas laŭvolaj. Disponeblaj atributoj estas:

name fiksas la nomon de la itemData. Kuntekstoj kaj reguloj uzos ĉi tiun nomon en sia atributo attribute por referenci elementon.

defStyleNum difinas kiun defaŭltan stilon uzi. Disponeblaj defaŭltaj stiloj estas klarigitaj detale poste.

color difinas koloron. Validaj formatoj estas '#rrggbb' aŭ '#rgb'.

selColor difinas la elektokoloron.

italic se true, la teksto estos kursiva.

bold se true, la teksto estos grasa.

underline se true, la teksto estos substrekita.

strikeout se true, la teksto estos forstrekita.

spellChecking se true, la teksto estos literumkontrolita.

La elemento keywords en la grupo general difinas ŝlosilvortojn. Disponeblaj atributoj estas:

casesensitive povas esti true aŭ false. Se true, ĉiuj ŝlosilvortoj estas kongruaj majuskle.

weakDeliminator estas listo de signoj, kiuj ne funkcias kiel vortlimigiloj. Ekzemple, la punkto '.' estas vortlimigilo. Supozu, ke ŝlosilvorto en listo enhavas punkton, ĝi nur kongruos se vi specifigas la punkton kiel malfortan limigilon.

additionalDeliminator difinas kromajn limigilojn.

wordWrapDeliminator difinas signojn post kiuj povas okazi linivolviĝo.

Defaŭltaj limigiloj kaj vortvolvaĵlimigiloj estas la signoj .():!+,-<=>%&*/;?[]^{|}~\, spaceto (' ') kaj tabeligilo ('\t').

La elemento komento en la grupo komentoj difinas komentajn trajtojn, kiuj estas uzataj por Iloj → Komento, Iloj → Malkomenti kaj Iloj → Baskuligi Komenton. Disponeblaj atributoj estas:

nomo estas aŭ unuLinio aŭ multlinio. Se vi elektas multLinio la atributoj fino kaj regiono estas postulataj. Se vi elektas unuLinio vi povas aldoni la laŭvolan atributon pozicio.

komenco difinas la ĉenon uzatan por komenci komenton. En C++ ĉi tio estus "/*" en plurliniaj komentoj. Ĉi tiu atributo estas postulata por tipoj multiLine kaj singleLine.

end difinas la ĉenon uzatan por fermi komenton. En C++ ĉi tio estus "*/". Ĉi tiu atributo estas nur disponebla kaj necesas por komentoj de tipo multiLine.

regiono devus esti la nomo de la faldebla plurlinia komento. Supozu, ke vi havas beginRegion="Comment" ... endRegion="Comment" en viaj reguloj, vi devus uzi region="Comment". Tiel malkomentado funkcias eĉ se vi ne elektas la tutan tekston de la plurlinia komento. La kursoro nur devas esti en la plurlinia komento. Ĉi tiu atributo disponeblas nur por tipo multilinio.

position difinas kie la unulinia komento estas enmetita. Defaŭlte, la unulinia komento estas metita komence de la linio ĉe kolumno 0, sed se vi uzas position="afterwhitespace" la komento estas enmetita post gvidado de blankspacoj dekstre, antaŭ la unua ne-blankspaca signo. Ĉi tio estas utila por meti komentojn ĝuste en lingvoj kie deŝoviĝo estas grava, kiel Python aŭ YAML. Ĉi tiu atributo estas nedeviga kaj la nura ebla valoro estas afterwhitespace. Ĉi tio disponeblas nur por tipo singleLine.

La elemento folding en la grupo general difinas kodfaldajn ecojn. Disponeblaj atributoj estas:

indentationsensitive se true, la kodaj faldmarkoj estos aldonitaj deŝovo bazitaj, kiel en la skriptlingvo Python. Kutime vi ne bezonas agordi ĝin, ĉar ĝi defaŭlte estas false.

La elemento emptyLine en la grupo emptyLines difinas kiuj linioj estu traktataj kiel malplenaj linioj. Ĉi tio permesas modifi la konduton de la atributo lineEmptyContext en la elementoj context. Disponeblaj atributoj estas:

regexpr difinas regulan esprimon, kiu estos traktata kiel malplena linio. Defaŭlte, malplenaj linioj enhavas neniujn signojn, tial ĉi tio aldonas pliajn malplenajn liniojn, ekzemple, se vi volas, ke linioj kun spacoj ankaŭ estu konsiderataj malplenaj linioj. Tamen, en la plej multaj sintaksaj difinoj vi ne bezonas agordi ĉi tiun atributon.

La elemento encoding en la grupo spellchecking difinas signan kodigon por literumkontrolo. Disponeblaj atributoj:

char estas kodita signo.

ĉeno estas sinsekvo de signoj kiuj estos kodita kiel la signo char en la literuma kontrolo. Ekzemple, en la lingvo LaTeX, la ĉeno \"{A} reprezentas la signon Ä.

Ĝeneralaj defaŭltaj stiloj:

dsNormal, kiam ne necesas speciala reliefigo.

dsKeyword, enkonstruitaj lingvaj ŝlosilvortoj.

dsFunction, funkciovokoj kaj difinoj.

dsVariable, se aplikebla: variablo-nomoj (ekz. $someVar en PHP/Perl).

dsControlFlow, kontrolfluaj ŝlosilvortoj kiel se, else, ŝaltilo, rompo, reveno, rendimento, ...

dsOperator, operatoroj kiel + - * / :: < >

dsBuiltIn, enkonstruitaj funkcioj, klasoj kaj objektoj.

dsExtension, oftaj etendaĵoj, kiel Qt™ klasoj kaj funkcioj/makrooj en C++ kaj Python.

dsPreprocessor, antaŭprocesoraj deklaroj aŭ makrodifinoj.

dsAttribute, komentarioj kiel @override kaj __declspec(...).

Defaŭltaj stiloj rilataj al ĉenoj:

dsChar, unuopaj signoj, kiel 'x'.

dsSpecialChar, signoj kun speciala signifo en ĉenoj kiel eskapoj, anstataŭaĵoj aŭ regex operatoroj.

dsString, ĉenoj kiel "saluton mondo".

dsVerbatimString, laŭvortaj aŭ krudaj ĉenoj kiel 'raw \backslash' en Perl, CoffeeScript, kaj ŝeloj, same kiel r'\raw' en Python.

dsSpecialString, SQL, regeksoj, TIE dokumentoj, L^AT_EX matematika reĝimo, ...

dsImport, importi, inkluzivi, postuli de moduloj.

Nombro-rilataj defaŭltaj stiloj:

dsDataType, enkonstruitaj datumtipoj kiel int, void, u64.

dsDecVal, decimalaj valoroj.

dsBaseN, valoroj kun bazo alia ol 10.

dsFloat, glitkomaj valoroj.

dsConstant, konstantoj enkonstruitaj kaj uzantodifinitaj kiel PI.

Komento kaj dokumentar-rilataj defaŭltaj stiloj:

dsComment, komentoj.

dsDocumentation, /** Dokumentaj komentoj */ aŭ """docstrings""".

dsAnnotation, dokumentaj komandoj kiel @param, @brief.

dsCommentVar, la variablonomoj uzataj en supraj komandoj, kiel "foobar" en @param foobar.

dsRegionMarker, regionmarkoj kiel //BEGIN, //END en komentoj.

Aliaj defaŭltaj stiloj:

dsInformation, notoj kaj konsiloj kiel @note en doxygen.

dsWarning, avertoj kiel @warning en doksigeno.

dsAlert, specialaj vortoj kiel TODO, FIXME, XXXX.

dsError, erara reliefigo kaj malĝusta sintakso.

dsOthers, kiam nenio alia taŭgas.

DetectChar

Detekti ununuran specifan signon. Ofte uzata ekzemple por trovi la finojn de cititaj ĉenoj.

<DetectChar char="(signo)" (komunaj atributoj) (dinamika) />

La atributo char difinas la signon por kongrui.

Detekti2Chars

Detekti du specifajn signojn en difinita ordo.

<Detect2Chars char="(signo)" char1="(signo)" (oftaj atributoj) />

La atributo char difinas la unuan signon kongruan, char1 la duan.

Ĉi tiu regulo ĉeestas pro historiaj kialoj kaj por legebleco estas preferinde uzi StringDetect.

AnyChar

Detekti unu signon de aro de specifitaj signoj.

<AnyChar String="(ĉeno)" (komunaj atributoj) />

La atributo String difinas la aron de signoj.

StringDetect

Detekti precizan ĉenon.

<StringDetect String = "(ĉeno)" [insensitive="true|false"] (oftaj atributoj) (dinamika) />

La atributo String difinas la ĉenon kongruan. La atributo insensitive defaŭlte estas false kaj estas transdonita al la ĉena kompara funkcio. Se la valoro estas true ne-usklecdistinga komparo estas uzata.

WordDetect

Detektu precizan ĉenon sed aldone postulas vortlimojn kiel punkton '.' aŭ blankspacon ĉe la komenco kaj la fino de la vorto. Pensu pri \b<string>\b laŭ regula esprimo, sed ĝi estas pli rapida ol la regulo RegExpr.

<WordDetect String="(ĉeno)" [insensitive="true|false"] (oftaj atributoj) (lokaj limigiloj) />

La atributo String difinas la ĉenon kongruan. La atributo insensitive defaŭlte estas false kaj estas transdonita al la ĉena kompara funkcio. Se la valoro estas true ne-usklecdistinga komparo estas uzata.

Ekde: Kate 3.5 (KDE 4.5)

RegEx

Kongruas kontraŭ regula esprimo.

<RegExpr String="(ĉeno)" [insensitive="true|false"] [minimal="true|false"] (oftaj atributoj) (dynamic) />

La atributo String difinas la regulan esprimon.

insensitive defaŭlte al false kaj estas transdonita al la regula esprimo-motoro.

minimuma defaŭlte al false kaj estas transdonita al la regula esprimo-motoro.

Ĉar la reguloj ĉiam kongruas kontraŭ la komenco de la nuna ĉeno, regula esprimo komencanta per signo (^) indikas ke la regulo devus esti egalita nur kontraŭ la komenco de linio.

Vidu Regulaj esprimoj por pliaj informoj pri tiuj.

keyword

Detekti ŝlosilvorton el difinita listo.

<keyword String="(listnomo)" (komunaj atributoj) (lokaj limigiloj) />

La atributo String identigas la ŝlosilvortliston laŭ nomo. Listo kun tiu nomo devas ekzisti.

La elstara sistemo prilaboras ŝlosilvortajn regulojn en tre optimumigita maniero. Ĉi tio igas absolutan neceson, ke ĉiuj ŝlosilvortoj kongruaj devas esti ĉirkaŭitaj de difinitaj limigiloj, aŭ implicitaj (la defaŭltaj limigiloj), aŭ eksplicite specifitaj ene de la eco additionalDeliminator de la keyword etikedo.

Se kongruota ŝlosilvorto enhavas limigan signon, ĉi tiu respektiva signo devas esti aldonita al la eco weakDeliminator de la etikedo keyword. Ĉi tiu signo tiam perdos sian limigilon en ĉiuj reguloj de keyword. Eblas ankaŭ uzi la atributon weakDeliminator de keyword tiel ke ĉi tiu modifo nur validu por ĉi tiu regulo.

Int

Detekti entjeron (kiel la regula esprimo: \b[0-9]+).

<Int (komunaj atributoj) (lokaj limigiloj) />

Ĉi tiu regulo ne havas specifajn atributojn.

Float

Detekti glitkoman nombron (kiel la regula esprimo: (\b[0-9]+\.[0-9]*|\.[0-9]+)([eE][- +]?[0-9]+)?).

<Float (komunaj atributoj) (lokaj limigiloj) />

Ĉi tiu regulo ne havas specifajn atributojn.

HlCOct

Detekti okuman punktonombro-reprezenton (kiel la regula esprimo: \b0[0-7]+).

<HlCOct (komunaj atributoj) (lokaj limigiloj) />

Ĉi tiu regulo ne havas specifajn atributojn.

HlCHex

Detekti deksesuman nombro-reprezenton (kiel regula esprimo: \b0[xX][0-9a-fA-F]+).

<HlCHex (komunaj atributoj) (lokaj limigiloj) />

Ĉi tiu regulo ne havas specifajn atributojn.

HlCStringChar

Detektu eskapintan signon.

<HlCStringChar (komunaj atributoj) />

Ĉi tiu regulo ne havas specifajn atributojn.

Ĝi kongruas laŭvortajn prezentojn de signoj kutime uzataj en programkodo, ekzemple \n (novlinio) aŭ \t (TAB).

La sekvaj signoj kongruos se ili sekvas malantaŭan oblikvon (\): abefnrtv"'?\. Aldone, eskapintaj deksesumaj nombroj kiel ekzemple \xff kaj eskapintaj okumaj nombroj, ekzemple \033 kongruos.

HlCChar

Detekti C-signon.

<HlCChar (komunaj atributoj) />

Ĉi tiu regulo ne havas specifajn atributojn.

Ĝi kongruas kun C-signoj enfermitaj en apostrofo (Ekzemplo: 'c'). La apostrofoj povas esti simpla signo aŭ eskapita signo. Vidu HlCStringChar por egalitaj eskapintaj signosekvencoj.

RangeDetect

Detekti ĉenon kun difinitaj komencaj kaj finaj signoj.

<RangeDetect char="(signo)" char1="(signo)" (oftaj atributoj) />

char difinas la signon komencantan la intervalon, char1 la signon finantan la intervalon.

Utila por detekti ekzemple malgrandajn cititajn ĉenojn kaj similajn, sed rimarku, ke ĉar la reliefiga motoro funkcias sur unu linio samtempe, ĉi tio ne trovos ĉenojn etendantajn super liniorompo.

LinioDaŭrigi

Kongruas kun specifita signo ĉe la fino de linio.

<LineContinue (komunaj atributoj) [char="\"] />

char laŭvola signo por kongrui, defaŭlta estas malantaŭa oblikvo ('\'). Nova ekde KDE 4.13.

Ĉi tiu regulo estas utila por ŝanĝi kuntekston ĉe fino de linio. Ĉi tio necesas ekzemple en C/C++ por daŭrigi makroojn aŭ ĉenojn.

Inkluzivi Regulojn

Enmeti regulojn de alia kunteksto aŭ lingvo/dosiero.

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

La atributo context difinas kiun kuntekston inkluzivi.

Se ĝi estas simpla ĉeno, ĝi inkluzivas ĉiujn difinitajn regulojn en la nunan kuntekston, ekzemple:

<IncludeRules context="aliaKunteksto" />

Se la ĉeno enhavas ## la reliefigsistemo serĉos kuntekston el alia lingvodifino kun la persona nomo, ekzemple

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

inkluzivus la kuntekston String el la C++-reliefiga difino.

Se la atributo includeAttrib estas true, ŝanĝi la cel-atributon al tiu de la fonto. Ĉi tio estas bezonata por ke, ekzemple, komentu funkciu, se teksto kongrua per la inkluzivita kunteksto estas malsama kulminaĵo de la gastiga kunteksto.

DetectSpaces

Detekti blankspacojn.

<DetectSpaces (komunaj atributoj) />

Ĉi tiu regulo ne havas specifajn atributojn.

Uzu ĉi tiun regulon se vi scias, ke povas esti pluraj blankspacoj antaŭe, ekzemple en la komenco de indentitaj linioj. Ĉi tiu regulo preterlasos ĉiujn blankspacojn samtempe, anstataŭ testi plurajn regulojn kaj preterlasi unu samtempe pro neniu kongruo.

DetektiIdentigilo

Detekti identigajn ĉenojn (kiel la regula esprimo: [a-zA-Z_][a-zA-Z0-9_]*).

<DetectIdentifier (komunaj atributoj) />

Ĉi tiu regulo ne havas specifajn atributojn.

Uzu ĉi tiun regulon por preterlasi ĉenon de vortsignoj samtempe, anstataŭ provi kun pluraj reguloj kaj salti unuope pro neniu kongruo.