set-tab-width {HELTAL bredd}

Ställer in tabulatorbredden till talet bredd.

set-indent-width {HELTAL bredd}

Ställer in indenteringsbredden till talet bredd. Används bara om du indenterar med mellanslag.

set-word-wrap-column {HELTAL bredd}

Ställer in radbredden för hård radbrytning till bredd. Detta används om du använder automatisk radbrytning för din text.

set-icon-border {BOOLESK aktivera}

Ställer in synligheten hos ikonkanten.

set-folding-markers {BOOLESK aktivera}

Ställer in synligheten hos vikmarkörrutan.

set-line-numbers {BOOLESK aktivera}

Ställer in synligheten hos radnummerrutan.

set-replace-tabs {BOOLESK aktivera}

Om aktiverad, ersätts tabulatortecken med mellanslag medan du skriver.

set-remove-trailing-space {BOOLESK aktivera}

Om aktiverad, tas avslutande blanktecken bort så fort markören lämnar en rad.

set-show-tabs {BOOLESK aktivera}

Om aktiverad, synliggörs tabulatortecken och avslutande blanktecken med en liten punkt.

set-show-indent {BOOLESK aktivera}

Om aktiverad, synliggörs indentering av en vertikal punktlinje.

set-indent-spaces {BOOLESK aktivera}

Om aktiverad, indenterar editorn med indenteringsbredd mellanslag för varje indenteringsnivå, istället för ett tabulatortecken.

set-mixed-indent {BOOLESK aktivera}

Om aktiverad, använder KatePart en blandning av tabulatortecken och mellanslag för indentering. Varje indenteringsnivå har bredden indenteringsbredd, och fler indenteringsnivåer optimeras så att så många tabulatortecken som möjligt används.

När det utförs aktiverar kommandot dessutom indentering med mellanslag, och om indenteringsbredden inte anges ställs den in till halva tabulatorbredden för dokumentet.

set-word-wrap {BOOLESK aktivera}

Aktiverar dynamisk radbrytning enligt aktivera.

set-replace-tabs-save {BOOLESK aktivera }

Om aktiverad, ersätts tabulatortecken med blanktecken så fort dokumentet sparas.

set-remove-trailing-space-save {BOOLESK aktivera}

Om aktiverad, tas avslutande mellanslag bort från alla rader så fort dokumentet sparas.

set-indent-mode {STRÄNG namn}

Ställer in automatiskt indenteringsläge till namn. Om namn inte känns igen, ställs läget in till 'none'. Giltiga lägen är 'none', 'normal', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' och 'xml'.

set-auto-ident {BOOLESK skript}

Aktivera eller inaktivera automatisk indentering.

set-highlight {STRÄNG färgläggning}

Ställer in dokumentets syntaxfärgläggningssystem. Argumentet måste vara ett giltigt färgläggningsnamn, som visas i menyn Verktyg → Färgläggning. Kommandot tillhandahåller en lista för automatisk komplettering av dess argument.

reload-scripts

Läs in alla JavaScript-skript som används av Kate, inklusive indenterare och kommandoradskript.

set-mode {STRÄNG läge}

Välj filtypschema för aktuellt dokument.

nn[oremap] {STRÄNG original} {STRÄNG avbildad}

Avbilda tangentsekvensen original till avbildad.

indent

Indenterar de markerade raderna eller den nuvarande raden.

unindent

Avindenterar markerade rader eller nuvarande rad.

cleanindent

Rensar indenteringen för markerade rader eller nuvarande rad enligt dokumentets indenteringsinställningar.

comment

Infogar kommentarmarkeringar för att göra markeringen, markerade rader eller nuvarande rad en kommentar enligt textformatet som definieras av dokumentets syntaxfärgläggningsdefinition.

uncomment

Tar bort kommentarmarkeringar från markeringen, markerade rader eller nuvarande rad enligt textformatet som definieras av dokumentets syntaxfärgläggningsdefinition.

kill-line

Tar bort den nuvarande raden.

replace { STRÄNG mönster} {STRÄNG ersättning}

Ersätter text som matchar mönster med ersättning. Om du vill att mönster ska innehålla blanktecken, måste både mönster och ersättning placeras inom enkla eller dubbla citationstecken. Om argumenten inte är citerade, används det första ordet som mönster och resten som ersättning. Om ersättning är tom, tas varje förekomst av mönster bort.

Du kan anpassa kommandot genom att lägga till ett kolon följt av en eller flera bokstäver som var och en representerar en inställning, genom att ange replace:alternativ mönster ersättning. Tillgängliga alternativ är:

b

Sök bakåt.

c

Sök från markörens position.

e

Sök bara i markeringen.

r

Utför en sökning med ett reguljärt uttryck. Om det anges, kan du använda \N, där N är ett tal, för att representera hittad text i ersättningssträngen.

s

Utför skiftlägeskänslig sökning.

p

Fråga efter tillåtelse att ersätta nästa förekomst.

w

Matcha bara hela ord.

date {STRÄNG format}

Infogar en datum- och tidssträng som definieras av angivet format, eller formatet ”yyyy-MM-dd hh:mm:ss” om inget anges. Följande översättningar görs när format tolkas:

d	Dagen som ett tal utan inledande nolla (1-31).
dd	Dagen som ett tal med inledande nolla (01-31).
ddd	Dagens förkortade lokala namn (t.ex. 'mån', 'sön').
dddd	Dagens långa lokala namn (t.ex. 'måndag', 'söndag').
M	Månaden som ett tal utan inledande nolla (1-12).
MM	Månaden som ett tal med inledande nolla (01-12).
MMMM	Månadens långa lokala namn (t.ex. 'januari', 'december').
MMM	Månadens förkortade lokala namn (t.ex. 'jan', 'dec').
yy	Året som ett tal med två siffror (00-99).
yyyy	Året som ett tal med fyra siffror (1752-8000)
h	Timman utan inledande nolla (0-23 eller 1-12 om FM/EM visas).
hh	Timman med inledande nolla (00-23 eller 01-12 om FM/EM visas).
m	Minuten utan inledande nolla (0-59).
mm	Minuten med inledande nolla (00-59).
s	Sekunden utan inledande nolla (0-59).
ss	Sekunden med inledande nolla (00-59).
z	Millisekunden utan inledande nolla (0-999).
zzz	Millisekunden med inledande nolla (000-999).
AP	Använd FM/EM visning. AP ersätts antingen av "FM" eller "EM".
ap	Använd fm/em visning. ap ersätts antingen av "fm" eller "em".

char {STRÄNG identifierare}

Det här kommandot låter dig infoga enskilda tecken med deras numeriska kod, på decimal, oktal eller hexadecimal form. För att använda det, starta dialogrutan för redigeringskommandot och skriv char: [nummer] i inmatningsrutan, och tryck sedan på Ok.

Exempel 5.1. Exempel på användning av char

Inmatning: char:234

Utmatning: ê

Inmatning: char:0x1234

Utmatning: ሴ

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

Det här kommandot söker och ersätter på ett sätt som liknar sed, för den nuvarande raden, eller för hela filen (%s///).

I kortet, så söks texten igenom efter en text som matchar sökmönstret, det reguljära uttrycket mellan det första och andra snedstrecket, och vid en träff så ersätts texten med uttrycket mellan det andra och sista snedstrecket. Parenteser i sökmönstret skapar bakåtreferenser, det vill säga kommandot kommer ihåg vilken del av strängen som matchade inom parenteserna. Strängarna kan återanvändas i ersättningsmönstret, med referenserna \1, för första paret parenteser, \2 för det andra, och så vidare.

För att söka efter tecknen ( eller ), måste du undanta dem med ett bakstreckstecken \(\).

Om du lägger till i sist i uttrycket, blir matchningen skiftlägesokänslig. Om du lägger till g sist, ersätts alla förekomster av mönstret, annars ersätts bara den första förekomsten.

Exempel 5.2. Ersätta text på den nuvarande raden

Din vänliga kompilator stannade just, och talade om för dig att klassen minKlass som nämns på rad 3902 i din källkodsfil inte är definierad.

"Tusan också!" tänker du. Det ska förstås vara MinKlass. Du går till rad 3902, och istället för att försöka hitta ordet i texten, så startar du dialogrutan för redigeringskommandot, och skriver in s/minklass/MinKlass/i, trycker på knappen Ok, sparar filen och kompilerar – utan problem med felet borta.

Exempel 5.3. Ersätta text i hela filen

Antag att du har en fil där du nämner namnet ”Anna Johansson” flera gånger, och någon kommer in och talar om för dig att hon precis har gift sig och bytt namn till ”Anna Svensson”. Du vill, förstås, byta ut alla förekomster av ”Anna Johansson” mot ”Anna Svensson”.

Starta kommandoraden, och skriv in kommandot: %s/Anna Johansson/Anna Svensson/, tryck på returtangenten och du är klar.

Exempel 5.4. Ett mer avancerat exempel

Det här exemplet använder bakåtreferenser samt en ordklass (om du inte vet vad det är, se tillhörande dokumentation som nämns nedan).

Antag att du har följande rad:

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

Nu inser du att det inte är bra kod, och bestämmer dig för att du vill använda nyckelordet const för alla ”adress”- parametrar, de som markeras med operatorn & framför argumentets namn. Du skulle också vilja förenkla blanktecknen, så att det bara finns ett blanktecken mellan varje ord.

Starta dialogrutan för redigeringskommandot, skriv in: s/\s+(\w+)\s+(&)/ const \1 \2/g och tryck sedan på knappen Ok. Tecknet g i slutet på raden gör att det reguljära uttrycket görs om för varje träff, så att bakåtreferenserna sparas.

Utmatning: void MinKlass::DoStringOps( const String &x, const String &y String *p, const int &a, const int &b )

Åtgärden utförd! Vad hände nu egentligen? Ja, vi letade efter blanktecken (\s+), följt av en eller flera bokstäver (\w+), följt av ytterligare blanktecken (\s+), följt av ett och-tecken, och sparade bokstäverna samt och-tecknet för att återanvända i ersättningsoperationen. Därefter ersatta vi den matchande delen av vår rad, med ett blanktecken följt av ”const”, följt av ett blanktecken, följt av våra sparade bokstäver (\1), följt av vårt sparade och-tecken (\2)

I vissa fall var bokstäverna ”String”, i andra ”int”, så att använda teckenklassen \w och tecknet + visade sig vara en värdefull tillgång.

sort

Sorterar den markerade texten eller hela dokumentet.

natsort

Sorterar de markerade raderna eller hela dokumentet i naturlig ordning.

Exempel 5.5. sort mot natsort

sort(a10, a1, a2) ger resultatet a1, a10, a2

natsort(a10, a1, a2) ger resultatet a1, a2, a10

moveLinesDown

Flytta markerade rader neråt.

moveLinesUp

Flytta markerade rader uppåt.

uniq

Ta bort duplicerade rader från den markerade texten eller hela dokumentet.

rtrim

Ta bort avslutande blanktecken från den markerade texten eller hela dokumentet.

ltrim

Ta bort inledande blanktecken från den markerade texten eller hela dokumentet.

join [STRÄNG separator]

Sammanfoga markerade linjer eller hela dokumentet. Har en valfri parameter som definierar ett separatortecken, till exempel: join ','.

rmblank

Ta bort alla blanktecken från den markerade texten eller hela dokumentet.

unwrap

Ta bort radbrytning för markerad text eller hela dokumentet.

each {STRÄNG skript}

Givet en JavaScript-funktion som argument, anropa den för listan med markerade rader och ersätt dem med returvärdet från anropet.

Exempel 5.6. Sammanfoga markerade linjer

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

Eller, kortare:

each 'lines.join(", ")'

filter {STRÄNG skript}

Givet en JavaScript-funktion som argument, anropa den för listan med markerade rader och ta bort de där anropet returnerar falskt.

Exempel 5.7. Ta bort tomma linjer

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

Eller, kortare:

filter 'line.length > 0'

map {STRÄNG skript}

Givet en JavaScript-funktion som argument, anropa den för listan med markerade rader och ersätt raden med värdet från anropet.

Exempel 5.8. Ta bort tomma linjer

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

Eller, kortare:

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

duplicateLinesUp

Duplicera markerade rader ovanför den nuvarande markeringen.

duplicateLinesDown

Duplicera markerade rader nedanför den nuvarande markeringen.

goto {HELTAL rad}

Det här kommandot går till den angivna raden.

grep {STRÄNG mönster}

Sök i dokumentet efter det reguljära uttrycket mönster. För mer information, se Appendix A, Reguljära uttryck.

find {STRÄNG mönster}

Kommandot går till första förekomsten av mönster enligt inställningen. Följande förekomster kan hittas genom att använda Redigera → Sök igen (normal snabbtangent är F3).

Kommandot kan anpassas genom att lägga till ett kolon följt av ett eller flera alternativ. Formatet är find:alternativ mönster. Följande alternativ stöds:

b

Sök bakåt.

c

Sök från markörens position.

e

Sök bara i markeringen.

r

Utför en sökning med ett reguljärt uttryck. Om det anges, kan du använda \N, där N är ett tal, för att representera hittad text i ersättningssträngen.

s

Utför skiftlägeskänslig sökning.

w

Matcha bara hela ord.

ifind {STRÄNG mönster}

Kommandot tillhandahåller ”sökning medan du skriver”. Du kan ställa in beteendet eller sökningen genom att lägga till ett kolon följt av ett eller flera alternativ, på detta sätt: ifind:alternativ mönster. Tillåtna alternativ är:

b

Sök bakåt.

r

Gör en sökning med ett reguljärt uttryck.

s

Utför skiftlägeskänslig sökning.

c

Sök från markörens position.

w

Spara aktuellt dokument.

wa

Spara alla dokument som för närvarande är öppna.

q

Stäng aktuellt dokument.

qa

Stäng alla öppna dokument.

wq

Spara och stäng aktuellt dokument.

wqa

Spara och stäng alla dokument som för närvarande är öppna.

x

Spara och stäng aktuellt dokument, men bara om det har ändrats.

x

Spara och stäng alla dokument som för närvarande är öppna, men bara om de har ändrats.

bp

Gå till föregående dokument i dokumentlistan.

bn

Gå till nästa dokument i dokumentlistan.

new

Öppna ett nytt dokument i en horisontellt delad vy.

vnew

Öppna ett nytt dokument i en vertikalt delad vy.

e

Läs in aktuellt dokument om det har ändrats på disk.

enew

Redigera ett nytt dokument.

print

Öppna utskriftsdialogrutan för att skriva ut det aktuella dokumentet.

Huvudkomponenter i KateParts färgläggningsdefinitioner

En syntaxfärgläggningsfil innehåller ett huvud som anger XML-versionen:

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

Definitionsfilens rot är elementet language. Följande egenskaper är tillgängliga:

Egenskaper som krävs:

name anger språkets namn. Det visas senare i menyer och dialogrutor.

section anger kategorin.

extensions definierar filändelser, såsom "*.cpp;*.h".

version anger aktuell version av definitionsfilen i form av ett heltal. När en definitionsfil för färgläggning ändras, försäkra dig om att talet ökas.

kateversion anger senaste version av KatePart som stöds.

Valfria egenskaper:

mimetype associerar filers MIME-typ.

casesensitive definierar om nyckelord är skiftlägeskänsliga eller inte.

priority krävs om en annan syntaxfärgläggningsfil använder samma filändelse. Den högsta prioriteten vinner.

author innehåller författarens namn och e-postadress.

license innehåller licensen, oftast MIT-licensen för nya syntaxfärgläggningsfiler.

stil innehåller språket som tillhandahålls och används av indenterare för egenskapen required-syntax-style.

indenter definierar vilken indenterare som normalt används. Tillgängliga indenterare är:ada, normal, cstyle, cmake, haskell, latex, lilypond, lisp, lua, pascal, python, replicode, ruby och xml.

hidden definierar om namnet ska visas i KateParts menyer.

Nästa rad kan alltså se ut så här:

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

Därefter kommer elementet highlighting som innehåller det valfria elementet list och det nödvändiga elementen contexts och itemDatas.

list element innehåller en lista med nyckelord. I det här fallet är nyckelorden class och const. Du kan lägga till så många listor som du behöver.

Sedan KDE Ramverk 5.53 kan en lista inkludera nyckelord från en annan lista, språk eller fil, genom att använda elementet include element.## är att separera listnamnet och språkdefinitionens namn, på samma sätt som regeln IncludeRules. Det är användbart för att undvika att duplicera nyckelordslistor, om du behöver inkludera nyckelorden från ett annat språk eller fil. Exempelvis innehåller listan annat-namn nyckelordet str och alla nyckelorden från listan types, vilken hör till språket ISO C++.

Elementet contexts innehåller alla sammanhang. Det första sammanhanget är förvalt som start för färgläggningen. Det finns två regler i sammanhanget Normal Text som matchar listan av nyckelord med namnet något-namn och en regel som detekterar ett citationstecken och byter sammanhang till string. För att lära dig mer om regler, läs nästa kapitel.

Den tredje delen är elementet itemDatas. Det innehåller alla färger och teckenstilar som behövs av sammanhangen och reglerna. I det här exemplet används itemData Normal Text, String och Keyword.

<highlighting>
    <list name="något-namn">
      <item> class </item>
      <item> const </item>
    </list>
    <list name="annat-namn">
      <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="något-namn" />
        <DetectChar attribute="String" context="String="annat-namn" />
        <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>

Den sista delen av färgläggningsdefinitionen är den valfria sektionen general. Den kan innehålla information om nyckelord, kodvikning, kommentarer, indentering, tomma rader och stavningskontroll.

Sektionen comment definierar den sträng som enradskommentarer inleds med. Du kan också definiera en flerradskommentar med multiLine och den ytterligare egenskapen end. Det är användbart när användaren trycker på snabbtangenten som motsvarar kommentera/avkommentera.

Sektionen keywords definierar om listor med nyckelord är skiftlägeskänsliga eller inte. Andra egenskaper förklaras senare.

Övriga sektioner, folding, emptyLines och spellchecking, behövs oftast inte och förklaras senare.

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

Elementet context hör till gruppen contexts. Själva sammanhanget definierar sammanhangsspecifika regler, som vad som ska ske om färgläggningssystemet når slutet på en rad. Tillgängliga egenskaper är:

name anger sammanhangets namn. Regler använder namnet för att ange sammanhanget att byta till om regeln matchar.

lineEndContext definierar sammanhanget som färgläggningssystemet byter till om det når ett radslut. Det kan antingen vara namnet på ett annat sammanhang, #stay för att inte byta sammanhang (dvs. göra ingenting) eller #pop som gör att det lämnar sammanhanget. Det är till exempel möjligt att använda #pop#pop#pop för att återgå tre steg, eller till och med #pop#pop!Annat_Sammanhang för att återgå två steg och byta till sammanhanget som heter Annat_Sammanhang. Det är också möjligt att byta till ett sammanhang som hör till en annan språkdefinition, på samma sätt som för reglerna IncludeRules, t.ex. Något_Sammanhang##JavaScript. Observera att det inte går att använda det här sammanhangsbytet tillsammans med #pop, exempelvis är #pop!Något_Sammanhang##JavaScript inte giltigt. Sammanhangsbyten beskrivs också i ”Regler för syntaxdetektering”.

lineEmptyContex definierar sammanhanget om en tom rad påträffas. Terminologin för sammanhangsbyte är samma som tidigare beskrivits i lineEndContext. Förval: #stay.

fallthroughContext anger nästa sammanhang att byta till om ingen regel matchar. Terminologin för sammanhangsbyte är samma som tidigare beskrivits i lineEndContext. Förval: #stay.

fallthrough definierar om färgläggningssystemet byter till sammanhanget som anges i fallthroughContext om ingen regel matchar. Observera att sedan KDE Frameworks 5.62 avråds användning av egenskapen, använd istället fallthroughContext, eftersom om egenskapen fallthroughContext finns förstås implicit att värdet på fallthrough är true. Förval: false.

noIndentationBasedFolding inaktiverar indenteringsbaserad vikning i sammanhanget. Om indenteringsbaserad vikning inte är aktiverad är egenskapen meningslös. Det definieras av elementet folding i gruppen general. Förval: false.

Elementet itemData är i gruppen itemDatas. Det definierar teckenstilen och färgerna. Det är alltså möjligt att definiera egna stilar och färger. Dock rekommenderar vi att du håller dig till standardstilarna om möjligt, så att användaren alltid ser samma färger använda i olika språk. Ibland finns det dock inget annat sätt, och det är nödvändigt att ändra färg- och teckenegenskaper. Egenskapens namn och defStyleNum krävs, övriga är valfria. Tillgängliga egenskaper är:

name anger namnet på itemData. Sammanhang och regler använder namnet i egenskapen attribute för att referera till itemData.

defStyleNum definierar vilken standardstil som ska användas. Tillgängliga standardstilar förklaras i detalj senare.

color definierar en färg. Giltiga format är '#rrggbb' eller '#rgb'.

selColor definierar markeringens färg.

italic om true, är texten kursiv.

bold om true, är texten i fetstil.

underline om true, är texten understruken.

strikeout om true, är texten överstruken.

spellChecking om true, stavningskontrolleras texten.

Elementet keywords i gruppen general definierar nyckelordens egenskaper. Tillgängliga egenskaper är:

casesensitive kan vara true eller false. Om det är true, matchas alla nyckelord skiftlägeskänsligt.

weakDeliminator är en lista med tecken som inte fungerar som ordavgränsare. Punkt '.' är till exempel en ordavgränsare. Med antagandet att ett nyckelord i en list innehåller en punkt, matchar det bara om du anger att punkten är en svag avgränsare.

additionalDeliminator definierar ytterligare avgränsare.

wordWrapDeliminator definierar tecken som en radbrytning kan ske efter.

Standardavgränsare och radbrytningsavgränsare är tecknen .():!+,-<=>%&*/;?[]^{|}~\, mellanslag (' ') och tabulator ('\t').

Elementet comment i gruppen comments definierar kommentaregenskaper som används för Verktyg → Kommentera, Verktyg → Avkommentera och Verktyg → Växla kommentar. Tillgängliga egenskaper är:

name är antingen singleLine eller multiLine. Om du väljer multiLine krävs egenskaperna end och region. Om du väljer singleLine kan du lägga till den valfria egenskapen position.

start definierar strängen som används för att inleda en kommentar. I C++ skulle det vara "/*". Egenskapen krävs för typerna multiLine och singleLine.

end definierar strängen som används för att avslutar en kommentar. I C++ skulle det vara "*/". Egenskapen är bara tillgänglig för och krävs för kommentarer av typen multiLine.

region ska vara namnet på den vikbara flerraderskommentaren. Med antagandet att du har beginRegion="Comment" ... endRegion="Comment" i dina regler, ska du använda region="Comment". På så sätt fungerar avkommentering även om du inte markerar all text i en flerraderskommentar. Markören måste bara vara inne i flerraderskommentaren. Egenskapen är bara tillgänglig för typen multiLine.

position definierar var enraderskommentaren infogas. Normalt placeras enraderskommentaren i början av raden på kolumn 0, men om position="afterwhitespace" används infogas kommentaren efter inledande blanktecken, precis före det första tecknet som inte är ett blanktecken. Det är användbart för att placera kommentarer korrekt i språk där indentering är viktig, såsom Python eller YAML. Egenskapen är valfri och det enda möjliga värdet är afterwhitespace. Den är bara tillgänglig för typen singleLine.

Elementet folding i gruppen general definierar kodvikningsegenskaper. Tillgängliga egenskaper är:

indentationsensitive om true läggs kodvikningsmarkörerna till baserat på indentering, som i skriptspråket Python. Oftast behöver du inte ange det, eftersom det har det förvalda värdet false.

Elementet emptyLine i gruppen emptyLines definierar vilka rader som ska behandlas som tomma rader. Det gör det möjligt att ändra beteendet hos egenskapen lineEmptyContext i elementets context. Tillgängliga egenskaper är:

regexpr definierar ett reguljärt uttryck som behandlas som en tom rad. Normalt innehåller tomma rader inte några tecken, därför lägger det här till ytterligare tomma rader, om du exempelvis vill att rader med mellanslag också ska anses vara tomma rader. Dock behöver man inte ange den här egenskapen i de flesta syntaxdefinitioner.

Elementet encoding i gruppenspellchecking definierar en teckenkodning för stavningskontroll. Tillgängliga egenskaper:

charär ett kodat tecken.

string är en teckenföljd som kodas som tecknet char i stavningskontrollen. Exempelvis representerar strängen \"{A} tecknet Ä i språket Latex.

Allmänna standardstilar:

dsNormal, när ingen särskild färgläggning krävs.

dsKeyword, nyckelord för inbyggda språk.

dsFunction, funktionsanrop och definitioner.

dsVariable, om tillämpligt: variabelnamn (t.ex. $enVariabel i PHP eller Perl).

dsControlFlow, nyckelord för kontrollflöde såsom if, else, switch, break, return, yield, ...

dsOperator, operatorer såsom + - * / :: < >

dsBuiltin, inbyggda funktioner, klasser och objekt.

dsExtension, vanliga ändelser såsom Qt™-klasser och funktioner eller makron i C++ och Python.

dsPreprocessor, preprocessorsatser eller makrodefinitioner.

dsAttribute, anmärkningar som @override och __declspec(...).

Strängrelaterade standardstilar:

dsChar, enstaka tecken såsom 'x'.

dsSpecialChar, tecken med speciell betydelse i strängar som undantag, ersättningar eller operatorer i reguljära uttryck.

dsString, strängar såsom "hej allihop".

dsVerbatimString, ordagranna eller obehandlade strängar som 'raw \backlash' i Perl, CoffeeScript och skal, samt r'\raw' i Python.

dsSpecialString, SQL-satser, reguljära uttryck, HERE-dokument, L^AT_EX-matematikläge, ...

dsImport, import, inkludering och require för moduler.

Nummerrelaterade standardstilar:

dsDataType, inbyggda datatyper såsom int, void, u64.

dsDecVal, decimala värden.

dsBaseN, värden med en bas skild från 10.

dsFloat, flyttalsvärden.

dsConstant, inbyggda och användardefinierade konstanter såsom PI.

Kommentar- och dokumentationsrelaterade standardstilar:

dsComment, kommentarer.

dsDocumentation, /** dokumentationskommentarer */ eller """dokumentsträngar""".

dsAnnotation, dokumentationskommandon som @param, @brief.

dsCommentVar, variabelnamnen som används i ovanstående kommandon, som "exempel" i @param exempel.

dsRegionMarker, områdesmarkeringar som //BEGIN, //END i kommentarer.

Andra standardstilar:

dsInformation, anmärkningar och tips som @note i doxygen.

dsWarning, varningar som @warning i doxygen.

dsAlert, specialord som TODO, FIXME, XXXX.

dsError, färgläggning av fel och felaktig syntax.

dsOthers, när ingenting annat passar in.

DetectChar

Detektera ett enda specifikt tecken. Används ofta för att till exempel hitta slutet på strängar inom citationstecken.

<DetectChar char="(tecken)" (gemensamma egenskaper) (dynamisk) />

Egenskapen char definierar tecknet som ska matchas.

Detect2Chars

Detektera två angivna tecken i en definierad ordning.

<Detect2Chars char="(tecken)" char1="(tecken)" (gemensamma egenskaper) />

Egenskapen char definierar det första tecknet som ska matcha, char1 det andra.

AnyChar

Detektera ett tecken i en angiven teckenmängd.

<AnyChar String="(sträng)" (gemensamma egenskaper) />

Egenskapen String definierar teckenmängden.

StringDetect

Detektera en sträng exakt.

<StringDetect String="(sträng)" [insensitive="TRUE|FALSE;"] (gemensamma egenskaper) (dynamisk) />

Egenskapen String definierar strängen som ska matcha. Egenskapen insensitive (okänslig) är normalt FALSE (FALSK) och skickas med till strängjämförelsefunktionen. Om värdet är TRUE (SANT) så används en jämförelse som inte bryr sig om skiftläge.

WordDetect

Detektera en exakt sträng, men kräv dessutom ordgränser som en punkt '.' eller ett blanktecken i början och slutet av ordet. Betrakta \b<string>\b som ett reguljärt uttryck, men snabbare än regeln RegExpr.

<WordDetect String="(sträng)" [insensitive="TRUE|FALSE;"] (gemensamma egenskaper) (lokala avgränsare)/>

Egenskapen String definierar strängen som ska matcha. Egenskapen insensitive (okänslig) är normalt FALSE (FALSK) och skickas med till strängjämförelsefunktionen. Om värdet är TRUE (SANT) så används en jämförelse som inte bryr sig om skiftläge.

Sedan: Kate 3.5 (KDE 4.5)

RegExpr

Matchar med ett reguljärt uttryck.

<RegExpr String="(sträng)" [insensitive="TRUE|FALSE;"] [minimal="TRUE| FALSE"] (gemensamma egenskaper) (dynamisk) />

Egenskapen String definierar det reguljära uttrycket.

Egenskapen insensitive (okänslig) är normalt FALSE (FALSK) och skickas med det reguljära uttrycket.

Egenskapen minimal är normalt FALSE (FALSK) och skickas med det reguljära uttrycket.

Eftersom reglerna alltid matchas mot början av den nuvarande strängen, så anger ett reguljärt uttryck som börjar med en hatt (^) att regeln bara ska matchas mot radens början.

Se Reguljära uttryck för mer information om dem.

keyword

Detektera ett nyckelord från en angiven lista.

<keyword String="(listnamn)" (gemensamma egenskaper) (lokala avgränsare)/>

Egenskapen String identifierar en lista på nyckelord med namn. En lista med det namnet måste finnas.

Färgläggningssystemet behandlar nyckelordsregler på ett mycket optimerat sätt. Det gör det absolut nödvändigt att alla nyckelord som ska matchas måste omges med definierade avgränsare, antingen underförstått (standardavgränsare) eller explicit definierade inne i egenskapen additionalDeliminator i taggen keywords.

Om ett nyckelord som ska matchas måste innehålla ett skiljetecken, måste detta tecken läggas till i egenskapen weakDeliminatori taggen keywords. Detta tecken förlorar då sin avgränsningsegenskap i alla regler med keyword. Det är också möjligt att använda egenskapen weakDeliminator i keyword så att ändringen bara gäller den regeln.

Int

Detektera ett heltal (som det reguljära uttrycket: \b[0-9]+).

<Int (gemensamma egenskaper) (lokala avgränsare) />

Den här regeln har inga specifika egenskaper.

Float

Detektera ett flyttal (som det reguljära uttrycket: (\b[0-9]+\.[0-9]*|\.[0-9]+)([eE][-+]?[0-9]+)?).

<Float (gemensamma egenskaper) (lokala avgränsare) />

Den här regeln har inga specifika egenskaper.

HlCOct

Detektera en oktal talrepresentation (som det reguljära uttrycket: \b0[0-7]+).

<HlCOct (gemensamma egenskaper) (lokala avgränsare) />

Den här regeln har inga specifika egenskaper.

HlCHex

Detektera en hexadecimal talrepresentation (som det reguljära uttrycket: \b0[xX][0-9a-fA-F]+).

<HlCHex (gemensamma egenskaper) (lokala avgränsare) />

Den här regeln har inga specifika egenskaper.

HlCStringChar

Detektera ett undantaget tecken.

<HlCStringChar (gemensamma egenskaper) />

Den här regeln har inga specifika egenskaper.

Det matchar bokstavsrepresentationer av osynliga tecken som ofta används i programkod, till exempel \n (nyrad) eller \t (tabulator).

Följande tecken matchar om de följer ett bakstreck (\): abefnrtv"'?. Dessutom matchar undantagna hexadecimala tal, som till exempel \xff och undantagna oktala tal, till exempel \033.

HlCChar

Detektera ett C-tecken.

<HlCChar (gemensamma egenskaper) />

Den här regeln har inga specifika egenskaper.

Det matchar C-tecken omgivna av apostrofer (till exempel 'c'). Apostroferna kan innehålla ett enkelt tecken eller en teckenföljd. Se HlCStringChar för matchade teckenföljder.

RangeDetect

Detektera en sträng med definierade start- och sluttecken.

<RangeDetect char="(tecken)"  char1="(tecken)" (gemensamma egenskaper) />

char definierar tecknet som inleder intervallet, och char1 tecknet som avslutar intervallet.

Användbar för att till exempel detektera små strängar inom citationstecken och liknande, men observera att eftersom färgläggningen arbetar med en rad i taget, så hittar det inte strängar som fortsätter på nästa rad.

LineContinue

Matchar ett angivet tecken vid radens slut.

<LineContinue (gemensamma egenskaper) [char="\"] />

Egenskapen char definierar valfritt tecken som ska matchas, förval är bakstreck ('\'). Ny sedan KDE 4.13.

Regeln är användbar för att byta sammanhang vid radslut. Det behövs till exempel i C/C++ för att fortsätta makron eller strängar.

IncludeRules

Inkludera regler från ett annat sammanhang eller språk/fil.

<IncludeRules context="sammanhangslänk" [includeAttrib="true|false"] />

Egenskapen context definierar vilket sammanhang som ska inkluderas.

Om den är en enkelt sträng innehåller den alla definierade regler i det nuvarande sammanhanget, till exempel:

<IncludeRules context="annat-sammanhang" />

Om strängen innehåller ## letar färgläggningssystemet efter ett sammanhang från en annan språkdefinition med angivet namn, exempelvis skulle

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

inkludera sammanhanget String från färgläggningsdefinitionen av C++.

Om egenskapen includeAttrib är true, ändras målegenskapen till källans egenskap. Det krävs till exempel för att kommentarer ska fungera om text som matchas av det inkluderade sammanhanget har en annan färgläggning än värdsammanhanget.

DetectSpaces

Detektera blanktecken.

<DetectSpaces (gemensamma egenskaper) />

Den här regeln har inga specifika egenskaper.

Använd den här regeln om du vet att det kan finnas flera blanktecken framför, till exempel i början av indenterade rader. Regeln hoppar över alla blanktecken på en gång, istället för att prova flera regler och hoppa över en åt gången eftersom den inte matchar.

DetectIdentifier

Detektera strängar för identifierare (som det reguljära uttrycket: [a-zA-Z_][a-zA-Z0-9_]*).

<DetectIdentifier (gemensamma egenskaper) />

Den här regeln har inga specifika egenskaper.

Använd den här regeln för att hoppa över en sträng med ordtecken på en gång, istället för att testa den med flera regler och hoppa ett steg i taget beroende på att ingenting matchar.