set-tab-width {INTEGER width}

Stelt de tablengte in op width.

set-indent-width {INTEGER width}

Stelt de breedte voor het inspringen in op width. Gebruik dit alleen als u met spaties inspringt.

set-word-wrap-column {INTEGER width}

Stelt de regellengte in op width. Dit wordt gebruikt als u tekst automatisch laat afbreken.

set-icon-border {BOOLEAN enable}

Toont of verbergt de pictogramrand.

set-folding-markers {BOOLEAN enable}

Toont of verbergt de vouwmarkeringen.

set-line-numbers {BOOLEAN enable}

Toont of verbergt de regelnummering.

set-replace-tabs {BOOLEAN enable}

Als deze optie ingeschakeld is, worden tabs door spaties vervangen terwijl u typt.

set-remove-trailing-space {BOOLEAN enable}

Als deze optie ingeschakeld is, wordt witruimte aan het einde van de regel verwijderd als de cursor naar een andere regel gaat.

set-show-tabs {BOOLEAN enable}

Als deze optie ingeschakeld is, worden tabs en spaties aan het einde van de regel zichtbaar gemaakt door middel van een punt.

set-show-indent {BOOLEAN enable}

Als deze optie ingeschakeld is, wordt inspringen zichtbaar gemaakt door middel van een verticale lijn van puntjes.

set-indent-spaces {BOOLEAN enable}

Als deze optie ingeschakeld is, zal de editor elk inspringniveau met indent-width spaties laten inspringen in plaats van met tabs.

set-mixed-indent {BOOLEAN enable}

Als deze optie ingeschakeld is, zal KatePart tabs en spaties gebruiken voor het inspringen. Elk inspringniveau zal het aantal spaties hebben dat bij indent-width is ingesteld en meerdere inspringniveaus zullen geoptimaliseerd worden door zoveel mogelijk tabs te gebruiken.

Wanneer dit commando uitgevoerd wordt, zal ook het inspringen met spaties ingeschakeld worden. Als de inspringbreedte niet gespecificeerd is, zal deze op de helft van tab-width voor het document ingesteld worden.

set-word-wrap {BOOLEAN enable}

Schakelt dynamische regelafbreking in of uit, afhankelijk van enable.

set-replace-tabs-save {BOOLEAN enable }

Als deze optie ingeschakeld is, zullen tabs vervangen worden door spaties zodra het document opgeslagen wordt.

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

Als deze optie ingeschakeld is, zullen spaties aan het einde van elke regel verwijderd worden zodra het document opgeslagen wordt.

set-indent-mode {STRING name}

Stelt de automatische inspringmodus in op naam. Als naam onbekend is, wordt "none" (geen) gebruikt. Geldige modi zijn 'none', 'normal', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' en 'xml'.

set-auto-ident {BOOLEAN script}

Automatisch inspringen in- of uitschakelen.

set-highlight {STRING highlight}

Stelt de accentuering van syntaxis in voor het document. Het argument moet een geldige naam zijn, zoals die in het menu Hulpmiddelen → Accentueringmodus staat. Bij dit commando is automatische aanvulling beschikbaar voor het argument.

reload-scripts

Alle door Kate gebruikte JavaScript-scripts herladen, inclusief indenteerders en commandoregelscripts.

set-mode {STRING modus}

Het bestandstypeschema voor het huidige document kiezen.

nn[oremap] {STRING original} {STRING mapped}

Laat de originele toetsenreeks overeenkomen met de overeenkomstige.

indent

Laat de geselecteerde regels of de huidige regel inspringen.

unindent

Verwijdert de inspringing van de geselecteerde regels of van de huidige regel.

cleanindent

Schoont de inspringing van de geselecteerde regels of van de huidige regels op, in overeenstemming met de instellingen in het document.

comment

Voegt commentaarmarkeringen aan de geselecteerde regels of aan de huidige regel toe, in overeenstemming met de tekstopmaak zoals die gedefinieerd is voor de syntaxisaccentuering van het document.

uncomment

Verwijdert commentaarmarkeringen van de geselecteerde regels of van de huidige regel, in overeenstemming met de tekstopmaak zoals die gedefinieerd is voor de syntaxisaccentuering van het document.

kill-line

Verwijdert de huidige regel.

replace { STRING pattern} {STRING replacement}

Vervangt tekst die overeenkomt met pattern door replacement. Als u spaties in pattern wilt gebruiken, moet u om pattern en om replacement enkele of dubbele aanhalingstekens zetten. Als er geen aanhalingstekens om de argumenten staan, wordt het eerste woord als pattern gebruikt en de rest als replacement. Als replacement geen tekens bevat, wordt elk gevonden pattern verwijderd.

U kunt extra opties aan de zoekopdracht meegeven door een dubbele punt toe te voegen, gevolgd door één of meer letters die elk een optie vertegenwoordigen. De zoekopdracht krijgt de vorm replace:options pattern replacement. Beschikbare opties zijn:

b

Zoek achterwaarts.

c

Zoek vanaf de cursorpositie.

e

Zoek alleen in de geselecteerde tekst.

r

Gebruik een reguliere expressie in de zoekopdracht. In dit geval kunt u ook N gebruiken, N is een getal dat het aantal overeenkomsten in de vervangende tekenreeks vertegenwoordigt.

s

De zoekopdracht is hoofdlettergevoelig.

p

Vraag om toestemming om de volgende overeenkomst te vervangen.

w

Zoek alleen naar hele woorden.

date {STRING format}

Voegt een datum/tijd in volgens de gespecificeerde format, of in de opmaak “yyyy-MM-dd hh:mm:ss” als er geen opmaak gespecificeerd is. De mogelijke vormen van format en de resulterende interpretatie:

d	De dag als een getal zonder voorloopnul (1-31).
dd	De dag als een getal met voorloopnul (01-31).
ddd	De verkorte gelokaliseerde dagnaam ('Ma'..'Zo').
dddd	De lange gelokaliseerde dagnaam ('Maandag'..'Zondag').
M	De maand als een getal zonder voorloopnul (1-12).
MM	De maand als een getal met voorloopnul (01-12).
MMMM	De lange gelokaliseerde maandnaam (bijv. 'januari'..'december').
MMM	De verkorte gelokaliseerde maandnaam ('Jan'..'Dec').
yy	Het jaar als een getal van twee cijfers (00-99).
yyyy	Het jaar als een getal van vier cijfers (1752-8000).
h	Het uur zonder voorloopnul (0..23 of 1..12 als AM/PM gebruikt wordt).
hh	Het uur met voorloopnul (00..23 of 01..12 als AM/PM gebruikt wordt).
m	De minuut zonder voorloopnul (0..59).
mm	De minuut met voorloopnul (00..59).
s	De seconde zonder voorloopnul (0..59).
ss	De seconde met voorloopnul (00..59).
z	De milliseconden zonder voorloopnul (0..999).
zzz	De milliseconden met voorloopnul (000..999).
AP	Gebruik AM/PM. AP wordt vervangen door "AM" of "PM".
ap	Gebruik am/pm. ap wordt vervangen door "am" of "pm".

char {STRING identifier}

Met behulp van dit commando kunt u tekens invoegen door het intypen van een decimaal, octaal of hexadecimaal getal. Open het dialoogvenster "Bewerkcommando's" en typ char: [number] in het invoerveld, klik daarna op OK.

Voorbeeld 5.1. char voorbeelden

Invoer: char:234

Uitvoer: ê

Invoer: char:0x1234

Uitvoer: ሴ

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

Dit commando voert een zoeken/vervangen-opdracht op de manier van sed uit op de huidige regel of in het gehele bestand (%s///).

Kort gezegd gebeurt er het volgende: In de tekst wordt naar de eerstvolgende overeenkomst met het zoekpatroon gezocht, de reguliere expressie tussen de eerste en de tweede slash, en wanneer een overeenkomst gevonden is, wordt het overeenkomende gedeelte van de tekst vervangen door de expressie tussen de tweede en de laatste slash. Haakjes in het zoekpatroon (search pattern) vertegenwoordigen terugverwijzingen, dit betekent dat het commando onthoudt welk gedeelte overeenkomt met het gedeelte tussen de haakjes; deze tekenreeksen kunnen opnieuw in de vervangende tekst gebruikt worden, \1 verwijst naar de eerste set haakjes, \2 naar de tweede set, enzovoort.

Om naar een ( of ) te zoeken moet u het teken vooraf laten gaan door een backslash: \(\)

Als u een i aan het einde van de expressie toevoegt, maakt de zoekopdracht geen verschil tussen hoofd- en kleine letters. Als u een g aan het einde toevoegt, worden alle overeenkomsten met het zoekpatroon vervangen, anders wordt alleen de eerste overeenkomst in een regel vervangen.

Voorbeeld 5.2. Tekst vervangen in de huidige regel

Uw aardige compiler is zojuist gestopt met de mededeling dat de class myClass in regel 3902 in uw bronbestand niet gedefinieerd is.

"Kreukels nog an toe!" denkt u, het is natuurlijk MyClass. U gaat naar regel 3902 en in plaats van te proberen het woord in de tekst te vinden, opent u het dialoogvenster "Bewerkcommando's", u typt s/myclass/MyClass/i, klikt op OK, slaat het bestand op en compileert – ditmaal zonder fouten.

Voorbeeld 5.3. Tekst vervangen in het gehele bestand

Stel dat u aan een bestand werkt waarin de naam “Anna Jensen” verscheidene keren voorkomt. Dan hoort u van iemand dat ze pasgeleden getrouwd is met “Harry Jones”. U wilt natuurlijk overal in het bestand “Anna Jensen” vervangen door “Anna Jones-Jensen”.

Open de commandoregel en typ %s/Anna Jensen/Anna Jones-Jensen/ en druk op de Enter-toets; dat was alles.

Voorbeeld 5.4. Een iets ingewikkelder voorbeeld

In dit voorbeeld gebruiken we zowel terugverwijzingen als teken-class (als u niet weet wat dit is, lees dan de uitleg hieronder).

Stel dat u de volgende regel hebt:

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

U bedenkt dat dit geen nette code is en besluit dat u het sleutelwoord const wilt gebruiken voor alle “adressen van” argumenten, herkenbaar aan de operator & voor de naam van het argument. U wilt ook de witruimte (de spaties of tabs) aanpassen, zodat er overal slechts één witruimteteken tussen de woorden staat.

Open het dialoogvenster "Bewerkcommando's" en typ: s/\s+(\w+)\s+(&)/ const \1 \2/g, klik daarna op OK. De g aan het einde van de expressie zorgt ervoor dat de reguliere expressie voor elke overeenkomst opnieuw opgebouwd wordt om de terugverwijzingen te behouden.

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

Taak volbracht! Wat is er nu gebeurd? We hebben gezocht naar witruimte (\s+) gevolgd door één of meer lettertekens (\w+) gevolgd door nog meer witruimte (\s+) gevolgd door een ampersand, en tegelijkertijd hebben we de lettertekens en de ampersand opgeslagen voor hergebruik bij het vervangen. Daarna hebben we het overeenkomende gedeelte van de regel vervangen door één spatie gevolgd door “const” gevolgd door één spatie gevolgd door de opgeslagen lettertekens (\1) gevolgd door één spatie gevolgd door de opgeslagen ampersand (\2).

Nu waren de lettertekens op sommige plaatsen “String”, op andere plaatsen “int”, het gebruik van de tekenklasse \w en het bepalingsteken + bleek een handig hulpmiddel.

sort

De geselecteerde tekst of het gehele document sorteren.

natsort

De geselecteerde regels of het gehele document op een natuurlijke manier sorteren.

Voorbeeld 5.5. sort vs. natsort

sort(a10, a1, a2) resulteert in a1, a10, a2

natsort(a10, a1, a2) resulteert in a1, a2, a10

moveLinesDown

Geselecteerde regels omlaag verplaatsen.

moveLinesUp

Geselecteerde regels omhoog verplaatsen.

uniq

Dubbele regels uit de geselecteerde tekst of het gehele document verwijderen.

rtrim

Spaties aan het eind van de regel uit de geselecteerde tekst of het gehele document verwijderen.

ltrim

Spaties aan het begin van de regel uit de geselecteerde tekst of het gehele document verwijderen.

join [STRING separator]

Geselecteerde regels of het gehele document samenvoegen. Neemt optioneel een parameter die een scheidingsteken definieert, bijvoorbeeld: join ', '

rmblank

Alle spaties uit de geselecteerde tekst of het gehele document verwijderen.

unwrap

Alle regelafbrekingen uit de geselecteerde tekst of het gehele document ongedaan maken.

each {STRING script}

Met een JavaScript-functie als argument, roep die aan voor de lijst met geselecteerde regels en vervang ze met de terugkeerwaarde van die aanroep.

Voorbeeld 5.6. Geselecteerde regels samenvoegen

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

Of, korter:

each 'lines.join(", ")'

filter {STRING script}

Met een JavaScript-functie als argument, roep die aan voor de lijst met geselecteerde regels en verwijder ze als de terugkeerwaarde van die aanroep 'false' is.

Voorbeeld 5.7. Blanco regels verwijderen

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

Of, korter:

filter 'line.length > 0'

map {STRING script}

Met een JavaScript-functie als argument, roep die aan voor de lijst met geselecteerde regels en vervang de regel met de terugkeerwaarde van die aanroep.

Voorbeeld 5.8. Blanco regels verwijderen

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

Of, korter:

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

duplicateLinesUp

De geselecteerde regels boven de huidige selectie dupliceren.

duplicateLinesDown

De geselecteerde regels onder de huidige selectie dupliceren.

goto {INT line}

Dit commando plaatst de cursor op de gespecificeerde regel.

grep {STRING pattern}

Doorzoek het document met de reguliere expressie patroon. Voor meer informatie, zie Bijlage A, Reguliere expressies

find {STRING pattern}

Dit commando plaatst de cursor bij de eerstgevonden overeenkost met pattern, afhankelijk van de eventuele opties. Volgende overeenkomsten kunnen gevonden worden door het menu Bewerken → Volgende zoeken te gebruiken of door op F3 te drukken.

Het gedrag van de zoekopdracht kan ingesteld worden door een dubbele punt gevolgd door één of meer opties aan het commando toe te voegen: find:options pattern. De volgende opties kunnen gebruikt worden:

b

Zoek achterwaarts.

c

Zoek vanaf de cursorpositie.

e

Zoek alleen in de geselecteerde tekst.

r

Gebruik een reguliere expressie in de zoekopdracht. In dit geval kunt u ook N gebruiken, N is een getal dat het aantal overeenkomsten in de vervangende tekenreeks vertegenwoordigt.

s

De zoekopdracht is hoofdlettergevoelig.

w

Zoek alleen naar hele woorden.

ifind {STRING pattern}

Met behulp van dit commando kunt u zoeken “terwijl-u-typt”. Het gedrag van de zoekopdracht kan ingesteld worden door een dubbele punt gevolgd door één of meer opties aan het commando toe te voegen: ifind:options patroon. De volgende opties kunnen gebruikt worden:

b

Zoek achterwaarts.

r

Gebruik een reguliere expressie in de zoekopdracht.

s

De zoekopdracht is hoofdlettergevoelig.

c

Zoek vanaf de cursorpositie.

w

Het huidige document opslaan.

wa

Alle huidige geopende documenten opslaan.

q

Het huidige document sluiten.

qa

Sluit alle geopende documenten.

wq

Het huidige document opslaan en sluiten.

wqa

Alle huidige open documenten opslaan en sluiten.

x

Het huidige document alleen opslaan en sluiten als het is gewijzigd.

x

Alleen alle huidige geopende documenten opslaan en sluiten als ze zijn gewijzigd.

bp

Naar het vorige document in de documentenlijst gaan.

bn

Naar het volgende document in de documentenlijst gaan.

new

Een nieuw document openen in horizontaal gesplitste weergave.

vnew

Een nieuw document openen in verticaal gesplitste weergave.

e

Het huidige document herladen als het op de schijf is gewijzigd.

enew

Een nieuw document bewerken.

print

Het printerdialoogvenster openen om het huidige document af te drukken.

Hoofdsecties van bestanden voor accentueringsdefinities van KatePart

Een bestand voor accentuering bevat een kop die de XML-versie instelt:

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

De basis van het definitiebestand is het element language. Beschikbare attributen zijn:

Vereiste attributen:

name stelt de naam van de taal in. Het verschijnt nadien in de menu's en dialogen.

section specificeert de categorie.

extensions definieert bestandsextensies, zoals "*.cpp;*.h"

versie specificeert de huidige revisie van het definitiebestand in termen van een geheel getal. Wanneer u een geaccentueerd definitiebestand wijzigt, verzeker u ervan dat dit getal wordt verhoogt.

kateversion specificeert de laatst ondersteunde versie van KatePart.

Optionele attributen:

mimetype associeert ket MIME-type van bestanden.

casesensitive definieert of de sleutelwoorden gevoelig zijn voor hoofd- en kleine letters.

priority is nodig als een andere bestand met accentueringsdefinities dezelfde extensies gebruiken. De hogere prioriteit wint.

author bevat de naam van de auteur en zijn/haar e-mailadres.

license bevat de licentie, gewoonlijk de MIT licentie voor nieuwe bestanden met accentuering van syntaxis.

style bevat de geleverde taal en wordt gebruikt door de indenteerders voor het attribuut required-syntax-style.

hidden definieert of de naam moet verschijnen in de menu's van KatePart.

De volgende regel kan er als volgt uitzien:

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

Vervolgens komt het element highlighting, die het optionele element list bevat en de vereiste elementen contexts en itemDatas.

Elementen list bevatten een lijst met sleutelwoorden. In dit geval zijn de sleutelwoorden class en const. U mag zoveel elementen 'list' toevoegen als nodig is.

Het element contexts bevat alle contexten. De eerste context is per definitie het begin van de accentuering. Er zijn twee regels in de context Normal Text, die overeenkomt met de lijst sleutelwoorden met de naam somename en een regel die een aanhalingsteken detecteert en de context om schakelt naar String. Om meer over regels te leren, leest u het volgende hoofdstuk.

Het derde deel is het element itemDatas. Het bevat alle kleur- en lettertypestijlen nodig voor de contexten en regels. In dit voorbeeld worden itemData Normal Text, String en Keyword gebruikt.

<highlighting>
    <list name="somename">
      <item> class </item>
      <item> const </item>
    </list>
    <contexts>
      <context attribute="Normal Text" lineEndContext="#pop" name="Normal Text" >
        <keyword attribute="Keyword" context="#stay" String="somename" />
        <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>

Het laatste deel van een accentueringsdefinitie is de optionele sectie general. Het mag informatie over sleutelwoorden, vouwen van code, commentaar en inspringen bevatten.

De sectie comment definieert met welke tekenreeks een enkele regel commentaar wordt aangegeven. U kunt ook commentaar op meerdere regels definiëren met multiLine met het additionele attribuut end. Dit wordt gebruikt als de gebruiker op de bijbehorende sneltoets voor comment/uncomment drukt.

De sectie keywords definieert of lijsten met sleutelwoorden onderscheid maken tussen hoofd- en kleine letters. Andere attributen zullen later worden verklaard.

<general>
    <comments>
      <comment name="singleLine" start="#"/>
    </comments>
    <keywords casesensitive="1"/>
  </general>
</language>

Het element context behoort tot de groep contexts. Een context zelf definieert context specifieke regels zoals wat zou moeten gebeuren als het systeem voor accentuering het eind van een regel bereikt. Beschikbare attributen zijn:

name geeft de contextnaam aan. Regels zullen deze naam gebruiken om de context te specificeren om om te schakelen als de regel overeenkomt.

lineEndContext definieert de context waarnaar het systeem voor accentuering omschakelt als het einde van een regel wordt bereikt. Dit kan of de naam van een andere context zijn, #stay om de context niet om te schakelen (bijv.. niets doen) of #pop wat de oorzaak is van het verlaten van deze context. Het is mogelijk om bijvoorbeeld #pop#pop#pop te gebruiken om drie keer te poppen of zelfs #pop#pop!AndereContext om twee keer te poppen en om te schakelen naar de context genaamd AndereContext.

lineEmptyContext definieert de context als een lege regel wordt bereikt. Standaard: #stay.

fallthrough definieert of het systeem voor accentuering omschakelt naar de context gespecificeerd in fallthroughContext als er geen regel overeenkomt. Standaard: false.

fallthroughContext specificeert de volgende context als geen regel overeenkomt.

dynamic indien true, dan herinnert de context tekenreeksen/plaatshouders opgeslagen door dynamische regels. Dit is bijvoorbeeld nodig voor HIER-documenten. Standaard: false.

Het element itemData is in de groep itemDatas. Het definieert de lettertypestijl en kleuren. Het is dus mogelijk om uw eigen stijlen en kleuren te definiëren. Wij bevelen echter aan om, indien mogelijk, bij de standaard stijlen te blijven zodat de gebruiker altijd dezelfde zal zien in verschillende talen. Soms is er echter geen andere manier en is het noodzakelijk de kleur- en lettertypeattributen te wijzigen. De attributen naam en defStyleNum zijn vereist, de anderen zijn optioneel. Beschikbare attributen zijn:

name stelt de naam van het itemData in. Contexten en regels zullen deze naam in hun attribuut attribute gebruiken om naar een itemData te verwijzen.

defStyleNum definieert welke standaard stijl te gebruiken. Beschikbare standaard stijlen worden later in detail verklaard.

color definieert een kleur. Geldige formaten zijn '#rrggbb' of '#rgb'.

selColor definieert de selectiekleur.

italic indien true, de tekst zal cursief worden.

bold indien true, de tekst zal vet worden.

underline indien true, de tekst zal onderstreept worden.

strikeout indien true, door de tekst zal een streep worden gezet.

spellChecking indien true, de tekst zal gecontroleerd worden op spelling.

Het element keywords in de groep general definieert sleutelwoordeigenschappen. Beschikbare attributen zijn:

casesensitive mag true of false zijn. Indien true, worden alle sleutelwoorden met onderscheid tussen hoofd- en kleine letters met elkaar vergeleken

weakDeliminator is een lijst met tekens die niet als scheiding tussen woorden werken. Bijvoorbeeld: de punt '.' is een scheider van woorden. Als een sleutelwoord in een list een punt bevat, dan zal die alleen overeenkomen als u de punt als een zwak scheidingsteken specificeert.

additionalDeliminator definieert extra scheidingstekens.

wordWrapDeliminator definieert tekens waarna een regel mag afbreken.

Standaard scheidingstekens en regelafbreektekens zijn de tekens .():!+,-<=>%&*/;?[]^{|}~\, spatie (' ') en tab ('\t').

Het element comment in de groep comments definieert eigenschappen van commentaar die gebruikt worden voor Hulpmiddelen → Commentaar en Hulpmiddelen → Commentaar verwijderen. Beschikbare attributen zijn:

name is either singleLine or multiLine. If you choose multiLine the attributes end and region are required.

start definieert de gebruikte tekenreeks om commentaar te laten beginnen. In C++ zou dit "/*" zijn.

end definieert de gebruikte tekenreeks om commentaar te laten eindigen. In C++ zou dit "*/" zijn.

region moet de naam van het opvouwbare multiregel commentaar. U hebt beginRegion="Comment" ... endRegion="Comment" in uw regels, u zou region="Comment" moeten gebruiken. Op deze manier werkt verwijderen zelfs als u niet alle tekst van het multiregel commentaar selecteert. De cursor hoeft alleen in het multiregel commentaar te staan.

Het element folding in de groep general definieert de eigenschappen van het invouwen van broncode. Beschikbare attributen zijn:

De markeringen voor code opvouwen, als indentationsensitive true is, zullen worden toegevoegd gebaseerd op inspringen, zoals in de scripttaal Python. Het is gewoonlijk niet nodig dit in te stellen omdat de standaard false is.

Het element indentation in de groep general definieert welke inspringing gebruikt zal worden. We bevelen ten zeerste aan om dit element over te slaan, omdat de inspringing gewoonlijk ingesteld zal worden door ofwel een Bestandstype of door een modusregel toe te voegen aan het tekstbestand. Als u toch een inspringing definieert, forceert u een specifieke inspringing op de gebruiker, die hij helemaal niet wil. Beschikbare attributen zijn:

mode is de naam van de inspringing. Beschikbare inspringingen op dit moment zijn: normal, cstyle, haskell, lilypond, lisp, python, ruby en xml.

Algemene standaard stijlen:

dsNormal, wanneer geen speciale accentuering is vereist.

dsKeyword, ingebouwde sleutelwoorden van taal.

dsFunction, functie-aanroepen en definities.

dsVariable, indien van toepassing: namen van variabelen (bijv. $eenVar in PHP/Perl).

dsControlFlow, sleutelwoorden voor flowcontrol zoals if, else, switch, break, return, yield, ...

dsOperator, operatoren zoals + - * / :: < >

dsFunction, ingebouwde functies, klassen en objecten.

dsExtension, algemene extensies, zoals Qt klassen en functies/macro's in C++ en Python.

dsPreprocessor, preprocessor statements of macro-definities.

dsAttribute, annotaties zoals @override en __declspec(...).

Standaard stijlen gerelateerd aan tekenreeksen

dsChar, enkele tekens, zoals 'x'.

dsSpecialChar, tekens met een speciale betekenis in tekenreeksen zoals escapes, substituties of regex-operatoren.

dsString, tekenreeksen zoals "hello world".

dsVerbatimString, letterlijke of raw-tekenreeksen zoals 'raw \backlash' in Perl, CoffeeScript en shells, evenals r'\raw' in Python.

dsSpecialString, SQL, regexes, HERE-docs, LaTeX math mode, ...

dsImport, import, include, require van modulen.

Standaard stijlen gerelateerd aan getallen:

dsDataType, ingebouwde typen gegevens zoals int, void, u64.

dsDecVal, decimale waarden.

dsBaseN, waarden met een andere basis dan 10.

dsFloat, drijvende-komma waarden.

dsConstant, ingebouwde en gebruikergedefineerde constanten zoals pi.

Standaard stijlen gerelateerd aan commentaar en documentatie:

dsComment, commentaar.

dsDocumentation, /** Documentatie commentaar */ of """docstrings""".

dsAnnotation, documentatiecommando's zoals @param, @brief.

dsCommentVar, de in bovenstaande commando's gebruikte namen van variabelen, zoals "foobar" in @param foobar.

dsRegionMarker, gebiedsmarkeringen zoals//BEGIN, //END in commentaar.

Andere standaard stijlen:

dsInformation, notities en tips zoals @note in doxygen.

dsWarning, waarschuwingen zoals @warning in doxygen.

dsAlert, speciale woorden zoals TODO, FIXME, XXXX.

dsError, accentuering van fouten en foute syntaxis.

dsOthers, wanneer niets anders past.

DetectChar

Detecteert een enkele specifiek teken. Gewoonlijk gebruikt, bijvoorbeeld om het einde van een tekenreeks tussen accenten of aanhalingstekens.

<DetectChar char="(teken)" (common attributes) (dynamic) />

Het attribuut char definieert het teken dat moet overeenkomen.

Detect2Chars

Detecteert twee specifieke tekens in een gedefinieerde volgorde.

<Detect2Chars char="(teken)" char1="(teken)" (common attributes) (dynamic) />

Het attribuut char definieert het eerste teken dat moet overeenkomen, char1 the tweede.

AnyChar

Detecteer één teken van een set van gespecificeerde tekens.

<AnyChar String="(tekenreeks)" (common attributes) />

Het attribuut String definieert de set tekens.

StringDetect

Detecteert een exacte tekenreeks.

<StringDetect String="(tekenreeks)" [insensitive="true|false"] (common attributes) (dynamic) />

Het attribuut String definieert de overeen te komen tekenreeks. Het attribuut insensitive is standaard false en wordt doorgegeven aan de vergelijkingsfunctie van de tekenreeks. Als de waarde true is wordt 'insensitive' vergelijking gebruikt.

WordDetect

Detecteert een exacte tekenreeks maar vereist extra woordgrenzen zoals een punt '.' of witruimte aan het begin en eind van het woord. Denk aan \b<tekenreeks>\b in termen van een reguliere expressie, het is echter sneller dan de regel RegExpr.

<WordDetect String="(tekenreeks)" [insensitive="true|false"] (common attributes) (dynamic) />

Het attribuut String definieert de overeen te komen tekenreeks. Het attribuut insensitive is standaard false en wordt doorgegeven aan de vergelijkingsfunctie van de tekenreeks. Als de waarde true is wordt 'insensitive' vergelijking gebruikt.

Sinds: Kate 3.5 (KDE 4.5)

RegExpr

Komt overeen met een reguliere expressie.

<RegExpr String="(tekenreeks)" [insensitive="true|false"] [minimal="true|false"] (common attributes) (dynamic) />

Het attribuut String definieert de reguliere expressie.

insensitive is standaard false en wordt doorgegeven aan de engine voor de reguliere expressie.

minimal is standaard false en wordt doorgegeven aan de engine voor de reguliere expressie.

Omdat de regels altijd vergeleken worden met het begin van de huidige tekenreeks, zal een reguliere expressie die begint met een dakje (^) aangeven dat de regel alleen overeen moet komen met het begin van een regel.

Zie Reguliere expressies voor meer informatie hierover.

trefwoord

Detecteert een sleutelwoord uit een gespecificeerde lijst.

<keyword String="(lijstnaam)" (common attributes) />

Het attribuut String identificeert de lijst met sleutelwoorden met een naam. Een lijst met die naam moet bestaan.

Het systeem voor accentuering bewerkt sleutelwoordregels op een zeer geoptimaliseerde manier. Dit maakt het absoluut noodzakelijk dat elk te vinden sleutelwoord omgeven wordt door gedefinieerde scheidingstekens, ofwel impliciet (de standaard scheidingstekens) of expliciet gespecificeerd binnen de eigenschap additionalDeliminator van de sleutelwoord-tag.

Als een te vinden sleutelwoord een scheidingsteken moet bevatten, dan moet dit teken toegevoegd worden aan de eigenschap weakDeliminator van de sleutelwoord-tag. Dit teken zal dan zijn eigenschap scheidingsteken in alle sleutelwoord-regels verliezen.

Int

Detecteert een geheel getal.

<Int (common attributes) (dynamic) />

Deze regel heeft geen specifieke attributen. Dochterregels worden typisch gebruikt om combinaties met L en U na het getal te detecteren, die het type geheel getal in programmacode aangeeft. Alle dochterregels zijn toegestaan als dochterregels, hoewel de DTD alleen de dochterregel StringDetect toestaat.

Het volgende voorbeeld laat overeenkomst zien met gehele getallen gevolgd door het teken 'L'.

<Int attribute="Decimal" context="#stay" >
  <StringDetect attribute="Decimal" context="#stay" String="L" insensitive="true"/>
</Int>

Zwevend

Een drijvende kommagetal detecteren.

<Drijvende komma (algemene attributen) />

Deze regel heeft geen specifieke attributen. AnyChar is toegestaan als een dochterregel en wordt typisch gebruikt om combinaties te detecteren, zie de regel Int als referentie.

HlCOct

Detecteert de representatie van een octaal puntgetal.

<HlCOct (common attributes) />

Deze regel heeft geen specifieke attributen.

HlCHex

Detecteert de representatie van een hexadecimaal getal.

<HlCHex (common attributes) />

Deze regel heeft geen specifieke attributen.

HlCStringChar

Detecteer een escaped teken.

<HlCStringChar (common attributes) />

Deze regel heeft geen specifieke attributen.

Komt overeen met de letterlijke representatie van tekens, gewoonlijk gebruikt in programmacode, bijvoorbeeld \n (nieuwe-regel) of \t (TAB).

De volgende tekens zullen overeenkomen als ze volgen op een backslash (\): abefnrtv"'?\. Bovendien escaped hexadecimale getallen zoals bijvoorbeeld \xff en escaped octale getallen, zoals bijvoorbeeld \033 zullen overeenkomen.

HlCChar

Detecteer een C-teken.

<HlCChar (gezamenlijke attributen) />

Deze regel heeft geen specifieke attributen.

Komt overeen met een C-teken tussen accenten (Bijvoorbeeld: 'c'). De accenten kunnen een eenvoudig teken zijn of een escaped teken. Zie HlCStringChar voor overeenkomende reeksen van escaped tekens.

RangeDetect

Detecteert een tekenreeks met gedefinieerde begin- en eindtekens.

<RangeDetect char="(teken)"  char1="(teken)" (gezamenlijke attributen) />

char defines the character starting the range, char1 the character ending the range.

Bruikbaar om bijvoorbeeld kleine tekenreeksen of zoiets te detecteren, maar merk op dat de accentiëringsengine werkt op één regel tegelijk, hierdoor zullen tekenreeksen over meerdere regels niet gevonden worden.

LineContinue

Komt overeen met een gespecificeerd teken aan het eind van een regel.

<LineContinue (gezamenlijke attributen) [char="\"] />

char optioneel teken dat moet overeenkomen, standaard is de backslash ('\'). Nieuw sinds KDE 4.13.

Deze regel is bruikbaar voor het omschakelen van context aan het einde van een regel. Dit is bijvoorbeeld nodig in C/C++ om macro's of tekenreeksen door te laten lopen.

IncludeRules

Voeg regels in uit een ander context- of taalbestand.

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

Het attribuut context definieert welke context in te voegen.

Als het een eenvoudige tekenreeks is dan zijn alle gedefinieerde regels in de huidige context ingevoegd, bijvoorbeeld:

<IncludeRules context="anotherContext" />

Als de tekenreeks ## bevat zal het accentueringssysteem zoeken naar een context uit een andere taaldefinitie met de gegeven naam, bijvoorbeeld

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

zou de context String uit de accentueringsdefinitie van C++ invoegen.

Als attribuut includeAttrib true is, dan wijzigt het doelattribuut naar die van de bron. Dit is vereist om bijvoorbeeld het aanbrengen van commentaar te laten werken als tekst die overeenkomt met de ingevoegde context een verschillende accentuering is van de host-context.

DetectSpaces

Detecteert witruimte.

<DetectSpaces (gezamenlijke attributen) />

Deze regel heeft geen specifieke attributen.

Gebruik deze regel als u weet dat er verschillende witruimtes aankomen, bijvoorbeeld aan het begin van inspringende regels. Deze regel slaat alle witruimte in een keer over, in plaats van testen met meerdere regels en een voor een overslaan vanwege geen overeenkomst.

DetectIdentifier

Detecteer tekenreeksen voor een identifier (als een reguliere expressie: [a-zA-Z_][a-zA-Z0-9_]*).

<DetectIdentifier (gezamenlijke attributen) />

Deze regel heeft geen specifieke attributen.

Gebruik deze regel om een reeks woordtekens in een keer over te slaan, in plaats van deze te testen met meerdere regels en ze een voor een over te slaan omdat er geen overeenkomst is.