set-tab-width {INTEGER ampiezza}

Imposta l'ampiezza della tabulazione al numero ampiezza.

set-indent-width {INTEGER ampiezza}

Imposta l'ampiezza del rientro al numero ampiezza. È usata solo se fai rientrare con gli spazi.

set-word-wrap-column {INTEGER ampiezza}

Imposta l'ampiezza della riga al numero ampiezza. È usata se il testo deve andare a capo automaticamente.

set-icon-border {BOOLEAN abilitazione}

Imposta la visibilità del bordo per le icone.

set-folding-markers {BOOLEAN abilitazione}

Imposta la visibilità del pannello per gli indicatori di raggruppamento.

set-line-numbers {BOOLEAN abilitazione}

Imposta la visibilità del pannello per i numeri di riga.

set-replace-tabs {BOOLEAN abilitazione}

Se è abilitata, le tabulazioni sono sostituite con spazi durante l'inserimento.

set-remove-trailing-space {BOOLEAN abilitazione}

Se è abilitata, gli spazi in fin di riga vengono rimossi quando il cursore lascia una riga.

set-show-tabs {BOOLEAN abilitazione}

Se è abilitata, le tabulazioni e gli spazi in fin di riga saranno evidenziati con dei puntini.

set-show-indent {BOOLEAN abilitazione}

Se è abilitata, il rientro sarà evidenziato con una linea punteggiata verticale.

set-indent-spaces {BOOLEAN abilitazione}

Se è abilitata, l'editor farà rientrare il testo di indent-width spazi ad ogni livello di rientro, invece che di un carattere di tabulazione.

set-mixed-indent {BOOLEAN abilitazione}

Se abilitato, KatePart userà una miscela di tabulazioni e spazi per i rientri delle righe. Ciascun livello di rientro sarà largo indent-width, e più livelli di rientro saranno ottimizzati usando il maggior numero possibile di tabulazioni.

Quando viene eseguito, questo comando abilita inoltre i rientri con gli spazi, e, se l'ampiezza dei rientri non è specificata, sarà impostata alla metà di tab-width del documento al momento dell'esecuzione.

set-word-wrap {BOOLEAN abilitazione}

Abilita o disabilita l'a capo automatico dinamico a seconda del parametro abilitazione.

set-replace-tabs-save {BOOLEAN abilitazione}

Quando è attiva questa opzione, le tabulazioni verranno sostituite con spazi durante il salvataggio del documento.

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

Quando è attiva questa opzione, gli spazi alla fine delle righe saranno scartati durante il salvataggio del documento.

set-indent-mode {STRING nome}

Imposta la modalità di autorientro a nome. Se nome è sconosciuto, la modalità sarà impostata a none. Le modalità valide sono none, normal, cstyle, haskell, lilypond, lisp, python, ruby, e xml.

set-auto-ident {BOOLEAN script}

Abilita o disabilita il rientro automatico.

set-highlight {STRING evidenziazione}

Imposta il sistema di evidenziazione della sintassi per il documento. L'argomento deve essere un nome di evidenziazione valido, così come è indicato nel menu Strumenti → Evidenziazione. Questo comando fornisce un elenco per il completamento automatico dell'argomento.

reload-scripts

Ricarica tutti gli script in JavaScript usati da Kate, inclusi i rientratori e gli script dalla riga di comando.

set-mode {STRING modalità}

Scegli lo schema di tipo di file per il documento attuale.

nn[oremap] {STRINGA originale} {STRINGA mappata}

Mappa la sequenza di tasti originale nella mappata.

indent

Fa rientrare le righe selezionate o la riga attuale.

unindent

Riduce il rientro delle righe selezionate o di quella attuale.

cleanindent

Riordina il rientro delle righe selezionate o della riga attuale secondo le impostazioni per il rientro del documento.

comment

Inserisce indicatori di commento per rendere la selezione o le righe selezionate o la riga attuale un commento secondo il formato di testo così com'è definito dalle regole di evidenziazione della sintassi del documento.

uncomment

Rimuove gli indicatori di commento dalla selezione o dalle righe selezionate o dalla riga attuale secondo il formato di testo così com'è definito dalle regole di evidenziazione della sintassi del documento.

kill-line

Elimina la riga attuale.

replace {STRINGA modello} {STRINGA sostituzione}

Sostituisce il testo corrispondente a modello con sostituzione. Se vuoi includere spazi nel modello, devi mettere le virgolette single o doppie attorno sia al modello, sia alla sostituzione. Se gli argomenti non sono tra virgolette, la prima parola è usata come modello ed il resto come sostituzione. Se la sostituzione è vuota, vengono rimosse le corrispondenze con il modello.

Puoi impostare dei modificatori per configurare la ricerca aggiungendo un due punti, seguiti da una o più lettere rappresentanti la configurazione, data nella forma replace:opzioni modello sostituzione. Le opzioni disponibili sono:

b

Cerca all'indietro.

c

Cerca dalla posizione del cursore.

e

Cerca solo all'interno della selezione.

r

Esegue la ricerca con un'espressione regolare. Se è impostata, puoi usare \N, dove N è un numero che rappresenta le catture nella stringa di sostituzione.

s

Esegue la ricerca facendo distinzione fra maiuscole e minuscole.

p

Chiede il permesso prima di effettuare la sostituzione.

w

Fa in modo che la ricerca consideri solo parole intere.

date {STRINGA formato}

Inserisce la stringa dell'ora/data come è specificato in formato, o nel formato «yyyy-MM-dd hh:mm:ss» se non ne è specificato nessuno. Le seguenti traduzioni sono effettuate nell'interpretazione di formato:

d	Il giorno in forma numerica, senza zeri iniziali (1–31).
dd	Il giorno in forma numerica, con uno zero iniziale di allineamento (01–31).
ddd	Il nome del giorno abbreviato in forma locale (ad es.: «lun» ... «dom»).
dddd	Il nome del giorno completo in forma locale (ad es. «lunedì» ... «domenica»).
M	Il mese in forma numerica, senza zeri iniziali (1–12).
MM	Il mese in forma numerica, con uno zero iniziale se necessario (01–12).
MMMM	Il nome del mese per esteso in forma locale (ad es. «Gennaio» ... «Dicembre»).
MMM	Il nome del mese abbreviato in forma locale (ad es. «gen» ... «dic»).
yy	Le ultime due cifre dell'anno (00–99).
yyyy	L'anno come numero di quattro cifre (1752–8000).
h	L'ora senza zero iniziali (0–23 o 1–12 se in modalità AM/PM).
hh	L'ora con zero iniziali (00–23 o 01–12 se in modalità AM/PM).
m	I minuti senza zero iniziali (0–59).
mm	I minuti con zero iniziali (00–59).
s	I secondi senza zero iniziali (0–59).
ss	I secondi con zero iniziali (00–59).
z	I millisecondi senza zeri iniziali (0–999).
zzz	I millisecondi con zeri iniziali (000–999).
AP	Usa modalità AM/PM. AP sarà sostituito da "AM" per le ore antimeridiane o "PM" per quelle pomeridiane.
ap	Usa modalità am/pm. ap sarà sostituito da "am" per le ore antimeridiane o "pm" per quelle pomeridiane.

char {STRINGA identificativo}

Questo comando permette di inserire caratteri indicando il loro identificativo numerico, in decimale, ottale o esadecimale. Per usarlo, apri la finestra dei comandi di modifica e digita char: [numero] nel campo di inserimento, quindi fai clic su OK.

Esempio 5.1. Esempi con il comando char

Inserisci: char:234

Ottieni: ê

Inserisci: char:0x1234

Ottieni: ሴ

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

Questo comando fa una ricerca/sostituzione nella riga di testo corrente o in tutto il file (%s///) in maniera del tutto simile a sed.

In breve, la ricerca viene effettuata in base a un modello di ricerca, a un'espressione regolare compresa tra la prima e la seconda barra. Quando viene trovata una corrispondenza, la parte che corrisponde viene sostituita con l'espressione compresa tra la seconda e l'ultima barra. Le parentesi nel modello di ricerca creano dei riferimenti all'indietro, vale a dire che il comando ricorda quali parti della stringa di ricerca tra parentesi hanno trovato corrispondenza; queste stringhe possono essere riutilizzate per sostituire dei modelli riferiti a \1 per il primo gruppo di parentesi, \2 per il secondo e così via.

Per cercare precisamente il simbolo di parentesi ( o ), devi evitare il problema usando la barra rovescia in questo modo: \(\)

Se metti una i alla fine dell'espressione, la corrispondenza avverrà senza tener far distinzione fra maiuscole o minuscole. Se metti una g, verranno sostituite tutte le corrispondenze del modello, altrimenti verrà sostituita solo la prima.

Esempio 5.2. Sostituire del testo nella riga corrente

Il tuo caro vecchio compilatore ha appena finito di bloccarsi dicendoti che la classe myClass, che compare nella riga 3902 del tuo file sorgente, non è definita.

"Naturale!" pensi, sai benissimo che si scrive MyClass. Vai alla riga 3902 e, invece di provare a cercare la parola nel testo, apri la finestra dei comandi di modifica, inserisci s/myclass/MyClass/i, premi OK, salvi il file e lo compili – con successo senza errori.

Esempio 5.3. Sostituire del testo nell'intero file

Immagina di avere un file, nel quale nomini «Miss Jensen» parecchie volte, e che arriva qualcuno che ti dice che si è appena sposata con «Mr Jones». Naturalmente tu vuoi sostituire tutti i «Miss Jensen» con «Ms Jones».

Vai alla riga di comando e digita il comando %s/Miss Jensen/Ms Jones/ e premi invio. Il gioco è fatto!

Esempio 5.4. Un esempio più avanzato

Questo esempio usa i riferimenti all'indietro e le classi di carattere (se non sai che cosa sono, leggi la relativa documentazione citata più in basso).

Immagina di avere la seguente riga:

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

Ora ti rendi conto che il codice non va bene, e decidi di usare la parola chiave const per tutti gli argomenti «reference», quelli caratterizzati dall'operatore & posto davanti al nome dell'argomento. Inoltre vorresti semplificare lo spazio vuoto, in modo che ci sia solo uno spazio tra ogni parola.

Apri la finestra dei comandi di modifica e inserisci: s/\s+(\w+)\s+(&)/ const \1 \2/g e premi il pulsante OK. La g che alla fine dell'espressione fa ricompilare l'espressione regolare per ogni corrispondenza per salvarne i riferimenti all'indietro.

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

Missione compiuta! Ora cos'è successo? Abbiamo cercato alcuni spazi vuoti (\s+) seguiti da alcuni caratteri alfabetici (\w+), seguiti da altri spazi vuoti (\s+), seguiti da una e commerciale e la porzione alfabetica con la e commerciale salvati nel processo per essere usati nell'operazione di sostituzione. Quindi abbiamo sostituito la parte corrispondente della nostra riga con uno spazio vuoto seguito da «const», seguito da un altro spazio vuoto, seguito dalla porzione alfabetica (\1), seguito da uno spazio vuoto e infine seguito dalla e commerciale salvata (\2)

Ora, in alcuni casi la porzione alfabetica era una «String». in altri «int», quindi se usi \w e il quantificatore + sarà meglio.

sort

Ordina il testo selezionato o tutto il documento.

natsort

Ordina le righe selezionate o tutto il documento naturalmente.

Esempio 5.5. sort e natsort

sort(a10, a1, a2) produce a1, a10, a2.

natsort(a10, a1, a2) produce a1, a2, a10.

moveLinesDown

Sposta le righe selezionate in basso.

moveLinesUp

Sposta le righe selezionate in alto.

uniq

Rimuovi le righe duplicate dal testo selezionato o tutto il documento.

rtrim

Rimuovi gli spazi finali dal testo selezionato o tutto il documento.

ltrim

Rimuovi gli spazi iniziali dal testo selezionato o tutto il documento.

join [STRINGA separatore]

Unisce le righe selezionate o tutto il documento. A scelta, prende un parametro che definisce un separatore, per esempio join ', '.

rmblank

Rimuove tutti gli spazi vuoti dal testo selezionato o da tutto il documento.

alignon

Questo comando allinea, alla colonna data da un'espressione regolare data come argomento, le righe nel blocco selezionato o nell'intero documento.

Per impostazione predefinita, se inserisci un modello vuoto l'allineamento sarà col primo carattere non di spazio.

Se il modello ha una cattura, il rientro sarà con la prima corrispondenza catturata.

Esempi:

alignon - inserirà degli spazi prima del primo «-» di ogni riga per allinearle nella stessa colonna.

alignon :\\s+(.) inserirà degli spazi prima del primo carattere non di spazio che ricorre dopo i due punti per allinearle nella stessa colonna.

unwrap

Unisce il testo selezionato o tutto il documento.

each {STRINGA script}

Data una funzione JavaScript come argomento, la chiama per l'elenco di righe selezionate e le sostituisce con il valore restituito dalla funzione.

Esempio 5.6. Unire le righe selezionate

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

O più brevemente:

each 'lines.join(", ")'

filter {STRINGA script}

Data una funzione JavaScript come argomento, la chiama per l'elenco di righe selezionate e rimuove quelle per cui la funzione restituisce falso.

Esempio 5.7. Rimuovere le righe vuote

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

O più brevemente:

filter 'line.length > 0'

map {STRINGA script}

Data una funzione JavaScript come argomento, la chiama per l'elenco di righe selezionate e sostituisce la riga con il valore della funzione.

Esempio 5.8. Rimuovere le righe vuote

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

O più brevemente:

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

duplicateLinesUp

Duplica le righe selezionate sopra la selezione attuale.

duplicateLinesDown

Duplica le righe selezionate sotto la selezione attuale.

goto {INT riga}

Questo comando sposta il cursore alla riga indicata.

grep {STRINGA modello}

Cerca nel documento l'espressione regolare modello. Per maggiori informazioni, vedi Appendice A, Le espressioni regolari.

find {STRINGA modello}

Questo comando si sposta alla prima corrispondenza del modello secondo la configurazione. Le corrispondenze successive possono essere trovate usando Modifica → Trova successivo (la scorciatoia predefinita è F3).

Il comando find può essere configurato aggiungendo in fondo un due punti seguito da una o più opzioni, nella forma find:opzioni modello. Le seguenti opzioni sono disponibili:

b

Cerca all'indietro.

c

Cerca dalla posizione del cursore.

e

Cerca solo all'interno della selezione.

r

Esegue la ricerca con un'espressione regolare. Se è impostata, puoi usare \N, dove N è un numero che rappresenta le catture nella stringa di sostituzione.

s

Esegue la ricerca facendo distinzione fra maiuscole e minuscole.

w

Fa in modo che la ricerca consideri solo parole intere.

ifind {STRINGA modello}

Questo comando fornisce la ricerca «mentre scrivi». Puoi configurarne il comportamento aggiungendo in fondo un due punti seguito da una o più opzioni, nella forma ifind:opzioni modello. Le seguenti opzioni sono disponibili:

b

Cerca all'indietro.

r

Esegue la ricerca di un'espressione regolare.

s

Esegue la ricerca facendo distinzione fra maiuscole e minuscole.

c

Cerca dalla posizione del cursore.

w

Salva il documento attuale.

wa

Salva tutti i documenti attualmente aperti.

q

Chiudi il documento attuale.

qa

Chiudi tutti i documenti aperti.

wq

Salva e chiudi il documento attuale.

wqa

Salva e chiudi tutti i documenti attualmente aperti.

x

Salva e chiudi il documento attuale solo se è stato modificato.

x

Salva e chiudi tutti i documenti attualmente aperti solo se sono stati modificati.

bp

Vai al documento precedente nell'elenco dei documenti.

bn

Vai al documento successivo nell'elenco dei documenti.

new

Apri un nuovo documento nella vista separata orizzontalmente.

vnew

Apri un nuovo documento nella vista separata verticalmente.

e

Ricarica il documento attuale se è stato modificato sul disco.

enew

Modifica un nuovo documento.

print

Apri la finestra di stampa per stampare il documento attuale.

Le sezioni principali dei file di definizione dell'evidenziazione di KatePart

Un file di evidenziazione contiene un'intestazione che imposta la versione XML:

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

Il file di definizione inizia con l'elemento language. Gli attributi disponibili sono:

Attributi richiesti:

name imposta il nome del linguaggio. Appare successivamente nei menu e nelle finestre.

section specifica la categoria.

extensions definisce le estensioni dei file, come "*.cpp;*.h"

version specifica l'attuale revisione del file di definizione in termini di un numero intero; sii certo di incrementare questo numero se cambi un file di definizione dell'evidenziazione.

kateversion specifica l'ultima versione supportata di KatePart.

Attributi opzionali:

mimetype associa i tipi MIME dei file.

casesensitive definisce se le parole chiave sono sensibili alle maiuscole oppure no.

priority è necessaria se un'altra definizione di evidenziazione usa le stesse estensioni; vince quella con priorità più alta.

author contiene il nome dell'autore e il suo indirizzo di posta elettronica.

license contiene la licenza, di solito MIT, per i nuovi file di evidenziazione della sintassi.

style contiene il linguaggio fornito, ed è usato dai rientratori per gli attributi required-syntax-style.

rientratore definisce quale rientratore sarà usato come predefinito. Quelli disponibili sono: ada, normal, cstyle, cmake, haskell, latex, lilypond, lisp, lua, pascal, python, replicode, ruby e xml.

hidden definisce se il nome deve apparire nei menu di KatePart.

Allora la prossima riga potrebbe apparire così:

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

Viene poi l'elemento highlighting, che contiene l'elemento opzionale list, e i richiesti contexts e itemDatas.

L'elemento list contiene una lista di parole chiave; in questo caso le parole chiave sono class e const; puoi aggiungere tutte le liste di cui hai bisogno.

Da KDE Frameworks 5.53 una lista può includere delle parole chiave di un'altra lista oppure da un'altra lingua (o da un altro file) usando l'elemento include. Viene usato ## per separare il nome della lista da quello del linguaggio di definizione del nome, come per il ruolo IncludeRules. Ciò è utile per evitare la duplicazione di liste delle parole se hai bisogno di includere le parole chiave di un altro linguaggio o file. Ad esempio, la lista othername contiene la parola chiave str e tutte le parole chiave della lista types che appartiene al linguaggio ISO C++.

L'elemento contexts contiene tutti i contesti; il primo è di default l'inizio dell'evidenziazione. Ci sono due regole nel contesto Normal Text, una associa la lista delle parole chiave con nome somename, e un'altra rileva una virgoletta, passando il contesto a string. Per saperne di più leggi il prossimo capitolo.

La terza parte è l'elemento itemDatas: contiene tutti i colori e gli stili dei caratteri che sono necessari per il contesto e per le regole. In questo esempio vengono usati itemData Normal Text, String e Keyword.

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

L'ultima parte di una definizione di evidenziazione è la sezione opzionale general. Può contenere informazioni sulle parole chiave, sul raggruppamento del codice, sui commenti, sui rientri, sulle righe vuote e sul controllo ortografico.

La sezione comment definisce con quale stringa viene introdotta una singola riga di commento. Puoi anche definire un commento multi-riga usando multiLine con l'attributo addizionale end. Questo viene usato se l'utente preme la scorciatoia per commentare/non commentare.

La sezione keywords definisce se la lista delle parole chiave è sensibile alle maiuscole oppure no. Altri attributi verranno spiegati più tardi.

Le altre sezioni, folding, emptyLines e spellchecking sono di solito non necessarie e verranno spiegate in seguito.

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

L'elemento context appartiene al gruppo contexts. Di per sé un contesto definisce le regole specifiche del contesto, tipo cosa dovrebbe accadere qualora il sistema di evidenziazione raggiunga il fine riga. Gli attributi disponibili sono:

name dichiara il nome del contesto. Le regole faranno uso di questo nome per specificare il contesto al quale passare se la regola viene soddisfatta.

lineEndContext definisce il contesto a cui il sistema di evidenziazione passa se viene raggiunta la fine della riga. Questo può essere sia il nome di un altro contesto, #stay per non lasciare il contesto (ad es.. non fare niente), oppure #pop, che causerà l'abbandono di questo contesto. È possibile usare per esempio #pop#pop#pop per saltare tre volte, o anche #pop#pop!OtherContext per saltare due volte e passare al contesto chiamato OtherContext. È possibile passare anche ad un contesto che appartiene ad un'altra definizione di linguaggio, come in IncludeRules, ad es. SomeContext##JavaScript. Nota che non è possibile usare questo cambio di contesto in combinazione con #pop, ad esempio #pop!SomeContext##JavaScript non è valido. I cambi di contesto sono descritti anche in la sezione chiamata «Regole di rilevamento dell'evidenziazione».

lineEmptyContext definisce il contesto se viene incontrata una riga vuota. Predefinito: #stay. La nomeclatura dei cambi di contesto è la stessa che è stata precedentemente descritta in lineEndContext. Predefinito: #stay.

fallthroughContext specifica il contesto successivo a cui passare se nessuna regola viene soddisfatta. La nomenclatura dei cambi di contesto è la stessa che era stata descritta in precedenza in lineEndContext. Predefinito: #stay.

fallthrough definisce se il sistema di evidenziazione passa al contesto specificato in fallthroughContext se non viene soddisfatta nessuna regola. Note che da KDE Frameworks 5.62 questo attributo è deprecato in favore di fallthroughContext, dal momento che se l'attributo fallthroughContext è presente, è implicitamente inteso che il valore di fallthrough è true. Predefinito: false.

noIndentationBasedFolding disabilita il raggruppamento basato sui rientri nel contesto. Se il raggruppamento basato sui rientri non è attivato questo attributo è inutile. Esso è definito nell'elemento folding del gruppo general. Predefinito: falso.

L'elemento itemData appartiene al gruppo itemDatas. Definisce lo stile del carattere e i colori, e quindi è possibile definire i propri stili e i propri colori. Raccomandiamo però di attenersi agli stili predefiniti, se possibile, cosicché gli utenti vedranno sempre gli stessi colori anche in linguaggi diversi. Tuttavia a volte non c'è altro modo se non quello di cambiare i colori e gli attributi dei caratteri. Sono richiesti il nome degli attributi e StileNumDef, ma gli altri sono opzionali. Gli attributi disponibili sono:

name imposta il nome di itemData. I contesti e le regole useranno questo nome nei loro attributi attribute a cui fa riferimento itemData.

defStyleNum definisce quale stile predefinito usare. Gli stili predefiniti disponibili sono spiegati in dettaglio più tardi.

color definisce un colore. Sono validi i formati «#rrggbb» o «#rgb».

selColor definisce la selezione del colore.

Il testo sarà in corsivo se italic è true.

Il testo sarà in grassetto se bold è true.

Il testo sarà sottolineato se underline è true.

Il testo sarà in barrato se strikeout è true.

Il testo sarà controllato ortograficamente se spellChecking è true.

L'elemento keywords del gruppo general definisce le proprietà delle parole chiave. Gli attributi disponibili sono:

casesensitive può essere true oppure false; se è true tutte le parole chiave soddisfano la sensibilità alle maiuscole.

weakDeliminator è una lista di caratteri che non agiscono da delimitatori di parole; per esempio, il punto «.» è un delimitatore di parola. Se assumiamo che una parola chiave in una lista possa contenere un punto, sarà soddisfatta solo se specifichi che il punto è un delimitatore debole.

additionalDeliminator definisce delimitatori addizionali.

wordWrapDeliminator definisce i caratteri dopo dei quali una riga può andare a capo.

Sono delimitatori predefiniti e terminatori di parola i caratteri .():!+,-<=>%&*/;?[]^{|}~\, gli spazi (« ») e i tabulatori («\t»).

L'elemento comment del gruppo comments definisce le proprietà che sono usate in Strumenti → Commenta, Strumenti → Decommenta e Strumenti → Commenta/decommenta. Gli attributi disponibili sono:

name può essere singleLine o multiLine. Se scegli multiLine sono richiesti gli attributi end e region. Se scegli singleLine puoi aggiungere l'attributo facoltativo position.

start definisce la stringa usata per iniziare un commento. In C++ sarebbe "/*" nei commenti multi-riga. Questo attributo è richiesto per i tipi multiLine e singleLine.

end definisce la stringa per chiudere un commento. In C++ questo sarebbe "*/". Questo attributo è solo disponibile ed è richiesto per i commenti di tipo multiLine.

region dovrebbe essere il nome dei commenti multi-riga raggruppabili. Assumendo di avere nelle regole beginRegion="Comment" ... endRegion="Comment" si dovrebbe usare region="Comment". In questo modo l'azione di decommento funziona anche se non viene selezionato tutto il testo di un commento multi-riga, il cursore deve solo essere all'interno del commento. Questo attributo è disponibile solo per il tipo multiLine.

position definisce dove vengono inseriti i commenti di una sola riga. Per impostazione predefinita essi sono posizionati all'inizio della riga, alla colonna 0, ma se utilizzi position="afterwhitespace" il commento viene inserito dopo i primi spazi sulla destra, prima del primo carattere non di spaziatura. Ciò è utile per inserire correttamente i commenti nei linguaggi in cui il rientro è importante, ad esempio Python o YAML. Questo attributo è facoltativo, e l'unico valore possibile è afterwhitespace. È disponibile solo per il tipo singleLine.

L'elemento raggruppamento del gruppo general definisce le proprietà di raggruppamento del codice. Gli attributi disponibili sono:

Se indentationsensitive è true i marcatori del raggruppamento del codice saranno aggiunti basandosi sul rientro, come nel linguaggio di scripting Python. Di solito non hai necessità di impostarlo, e di solito è impostato a false.

L'elemento emptyLine nel gruppo emptyLines definisce quali righe dovrebbero essere trattate come vuote. Ciò permette di modificare il comportamento dell'attributo lineEmptyContext negli elementi context. Gli attributi disponibili sono:

regexpr definisce un'espressione regolare che verrà trattata come una riga vuota. Per impostazione predefinita le righe vuote non contengono nessun carattere, perciò esso aggiunge delle altre righe vuote, ad esempio se vuoi considerare come vuote anche le righe con gli spazi. Ad ogni modo, nella maggior parte delle definizioni di sintassi non è necessario impostare questo attributo.

L'elemento encoding del gruppo spellchecking definisce una codifica dei caratteri per il controllo ortografico. Gli attributi disponibili sono:

char è un carattere codificato.

string è una sequenza di caratteri che verrà codificata come il caratterechar nel controllo ortografico. Ad esempio, nel linguaggio LaTex la stringa \"{A} rappresenta il carattere Ä.

Stili generali predefiniti:

dsNormal, quando non è richiesta nessuna evidenziazione speciale.

dsKeyword, parola chiave integrata nel linguaggio.

dsFunction, chiamate di funzioni e definizioni.

dsVariabile, se applicabile: nomi delle variabili (ad es. $someVar in PHP/Perl).

dsControlFlow, parole chiave per il controllo del flusso, come if, else, switch, break, return, yield, ...

dsOperator, operatori come + - * / :: < >

dsBuiltIn, funzioni integrate, classi e oggetti.

dsExtension, estensioni comuni, come le classi Qt™ e le funzioni o le macro in C++ e in Python.

dsPreprocessor, direttive al preprocessore o definizioni di macro.

dsAttribute, annotazioni come @override e __declspec(...).

Stili predefiniti relativi alle stringhe:

dsChar, caratteri singoli, come 'x'.

dsSpecialChar, caratteri con significati speciali nelle stringhe, come escape, sostituzioni, oppure operatori regex.

dsString, stringhe come "hello world".

dsVerbatimString, letterale o stringa grezza, come 'raw \backlash' in Perl, CoffeeScript, e shell, come r'\raw' in Python.

dsSpecialString, SQL, regexes, documenti HERE, modi L^AT_EX math, ...

dsImport, importazione, inclusione, richieste di moduli.

Stili predefiniti relativi ai numeri:

dsDataType, tipi di dati integrati, come int, void, u64.

dsDecVal, valori decimali.

dsBaseN, valori con base diversa da 10.

dsFloat, valori in virgola mobile.

dsCostant, costanti integrate e definite dall'utente, come PI.

Commenti e stili predefiniti relativi alla documentazione:

dsComment, commenti.

dsDocumentation, /** Commenti nella documentazione */ o """docstrings""".

dsAnnotation, comandi nella documentazione, come @param, @brief.

dsCommentVar, i nomi delle variabili usati nei comandi precedenti, come "pippobar" in @param pippobar.

dsRegionMarker, delimitatori di regioni, come //BEGIN e //END nei commenti.

Altri stili predefiniti:

dsInformation, annotazioni e suggerimenti, come @note in doxygen.

dsWarning, avvisi, come @warning in doxygen.

dsAlert, parole speciali, come TODO, FIXME, XXXX.

dsError, evidenziazione di errori e sintassi errata.

dsOthers per tutto il resto.

DetectChar

Rileva un singolo carattere specifico. Usato comunemente per trovare ad esempio la fine di una stringa tra virgolette.

<DetectChar char="(carattere)" (attributi comuni) (dynamic) />

L'attributo char definisce il carattere da abbinare.

Detect2Chars

Rileva due caratteri specifici in un ordine definito.

<Detect2Chars char="(carattere)" char1="(carattere)" (attributi comuni) />

L'attributo char definisce il primo carattere da associare, char1 il secondo.

AnyChar

Rileva un carattere da un insieme di caratteri specificati.

<AnyChar String="(stringa)" (attributi comuni) />

L'attributo String definisce l'insieme dei caratteri.

StringDetect

Rileva una stringa esatta.

<StringDetect String="(stringa)" [insensitive="true|false"] (attributi comuni) (dynamic) />

L'attributo String definisce la stringa da abbinare. All'attributo insensitive viene assegnato come valore predefinito false, e viene passato alla funzione di confronto della stringa. Se il valore è true allora nel confronto non si terrebbe conto delle maiuscole.

WordDetect

Non rileva una stringa esatta, ma i confini di una parola quali un punto '.' o uno spazio all'inizio o alla fine della parola. Pensa \b<string>\b come un'espressione regolare, ma più veloce della regola RegExpr.

<WordDetect String="(stringa)" [insensitive="true|false"] (attributi comuni) (deliminatori locali) />

L'attributo String definisce la stringa da abbinare. All'attributo insensitive viene assegnato come valore predefinito false, e viene passato alla funzione di confronto della stringa. Se il valore è true allora nel confronto non si terrebbe conto delle maiuscole.

Da: Kate 3.5 (KDE 4.5)

RegExpr

Corrisponde con un'espressione regolare.

<RegExpr String="(stringa)" [insensitive="true|false"] [minimal="true|false"] (attributi comuni) (dynamic) />

L'attributo String definisce l'espressione regolare.

insensitive ha come valore predefinito false, e viene passato al motore per le espressioni regolari.

minimal ha come valore predefinito false, e viene passato al motore per le espressioni regolari.

Le regole sono sempre confrontate con l'inizio della stringa corrente, tuttavia un'espressione regolare iniziante con un apice (^) è segno che la regola dovrebbe essere confrontata invece con l'inizio di una riga.

Vedi Espressioni regolari per maggiori informazioni.

keyword

Rileva una parola chiava da una lista specifica.

<keyword String="(nome lista)" (attributi comuni) (deliminatori locali) />

L'attributo String identifica la lista di parole chiave per nome. Deve esistere una lista con questo nome.

Il sistema di evidenziazione elabora regole di parole chiave in maniera molto ottimizzata. Questo rende assolutamente necessario che ogni parola chiave da confrontare sia circondata da delimitatori definiti, sia impliciti (i delimitatori predefiniti) che espliciti, specificati dalla proprietà additionalDeliminator con l'etichetta keywords.

Se una parola chiave da confrontare dovesse contenere un carattere di delimitazione, allora questo dovrebbe essere aggiunto alla proprietà weakDeliminator con l'etichetta keywords. Questo carattere perderebbe le sue proprietà di delimitatore in tutte le regole keywords. È possibile anche usare l'attributo weakDeliminator di keyword in modo da applicare questa modifica solo a questa regola.

Int

Rileva un numero intero (come nell'espressione regolare \b[0-9]+).

<Int (attributi comuni) (deliminatori locali) />

Questa regola non ha attributi specifici.

Float

Rileva un numero in virgola mobile (come nell'espressione regolare (\b[0-9]+\.[0-9]*|\.[0-9]+)([eE][-+]?[0-9]+)?).

<Float (attributi comuni) (deliminatori locali) />

Questa regola non ha attributi specifici.

HlCOct

Rileva un numero rappresentato in ottale (come nell'espressione regolare \b0[0-7]+).

<HlCOct (attributi comuni) (deliminatori locali) />

Questa regola non ha attributi specifici.

HlCHex

Rileva un numero rappresentato in esadecimale (come nell'espressione regolare \b0[xX][0-9a-fA-F]+).

<HlCHex (attributi comuni) (deliminatori locali) />

Questa regola non ha attributi specifici.

HlCStringChar

Rileva un carattere di escape.

<HlCStringChar (attributi comuni) />

Questa regola non ha attributi specifici.

Controlla la corrispondenza di espressioni letterali di caratteri generalmente usate nel codice dei programmi, per esempio \n (nuova riga) o \t (TAB).

I seguenti caratteri corrisponderanno se saranno seguiti da una barra inversa (\): abefnrtv"'?\. Inoltre corrisponderanno numeri esadecimali preceduti dal carattere di escape, come per esempio \xff e numeri ottali preceduti dal carattere di escape, per esempio \033.

HlCChar

Rileva il carattere C

<HlCChar (attributi comuni) />

Questa regola non ha attributi specifici.

Controlla la corrispondenza di caratteri C racchiusi da un accento (Esempio: 'c'). Gli accenti possono essere caratteri singoli o caratteri di escape. Vedi HlCStringChar per le sequenze di caratteri di escape associate.

RangeDetect

Rileva una stringa con caratteri di inizio e di fine definiti.

<RangeDetect char="(carattere)"  char1="(carattere)" (attributi comuni) />

char definisce il carattere con cui inizia l'intervallo, char1 il carattere con cui finisce.

Utile per individuare per esempio piccole stringhe tra virgolette e simili; nota però che non verranno in questo modo trovate le stringhe che si estendono dopo un'interruzione di riga. Questo perché il motore di evidenziazione lavora su una riga alla volta.

LineContinue

Associa un carattere specificato con la fine di una riga.

<LineContinue (attributi comuni) [char="\"] />

char carattere opzionale da associare; come predefinito c'è la barra inversa ('\'). Novità da KDE 4.13.

Questa regola è utile per cambiare il contesto alla fine di una riga. È necessaria per esempio in C/C++, per continuare le macro o le stringhe.

IncludeRules

Include delle regole da un altro file di contesto o da un linguaggio.

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

L'attributo context definisce quale contesto includere.

Se è una stringa semplice include tutte le regole nel contesto corrente, per esempio:

<IncludeRules context="altroContesto" />

Se la stringa contiene ## il sistema di evidenziazione cercherà un contesto in un altra definizione di linguaggio con il nome assegnato, per esempio

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

dovrebbe includere il contesto String dalle definizioni di evidenziazione del C++.

Se l'attributo includeAttrib è true cambia l'attributo di destinazione con uno del sorgente. Questo è richiesto per esempio per fare dei commenti, se il testo associato al contesto incluso ha una diversa evidenziazione dal contesto che lo ospita.

DetectSpaces

Rileva gli spazi.

<DetectSpaces (attributi comuni) />

Questa regola non ha attributi specifici.

Usa questa regola quando sai che potrai incontrare numerosi spazi, per esempio all'inizio di righe rientrate. Questa regola salterà tutti gli spazi in un colpo solo, invece di provare regole multiple da scartarle di volta in volta per mancanza di corrispondenza.

DetectIdentifier

Rileva gli identificatori di stringhe (come un'espressione regolare [a-zA-Z_][a-zA-Z0-9_]*).

<DetectIdentifier (attributi comuni) />

Questa regola non ha attributi specifici.

Usa questa regola per saltare subito una stringa di caratteri alfanumerici, invece di usare più regole e saltare i caratteri uno alla volta per mancanza di corrispondenza.