Configuració amb variables de documentLes variables de la KatePart són implementacions de la KatePart de les variables de document, similar als modes de línia d'Emacs i vi. A la katepart, les línies tenen el format kate: NOMVARIABLE VALOR; [ NOMVARIABLE VALOR; ... ] les línies poden ser un comentari, si el fitxer és en un format amb comentaris. Els noms de les variables són paraules soles (sense espais en blanc), i quelcom que el segueixi fins als dos punts serà el valor. Els dos punts són requerits.
Tot seguit hi ha un exemple de línia de variable, aquesta força la configuració del sagnat per a un fitxer en C++, Java™ o JavaScript:
// kate: replace-tabs on; indent-width 4; indent-mode cstyle;
Nota
Només se cercaran línies de variable en les primeres i últimes 10 línies.
A més, les variables de document es poden posar en un fitxer anomenat .kateconfig en qualsevol directori, i les opcions configurades s'aplicaran com si els modes de línia es van introduir en cadascun dels fitxers en el directori i els seus subdirectoris. Les variables de document en el .kateconfig utilitzen la mateixa sintaxi que en els modes de línia, però amb les opcions esteses.
Hi ha variables que suporten la gran majoria de configuracions a la KatePart, i addicionalment els connectors poden utilitzar variables, en el qual cas haurien de ser documentades en la documentació del connector.
El KatePart té suport per a llegir configuracions des de fitxers .editorconfig quan hi ha instal·lada la biblioteca editorconfig. El KatePart cerca automàticament un fitxer .editorconfig cada cop que s'obre un fitxer. Tanmateix, dona prioritat als fitxers .kateconfig.
Quan llegeix la configuració, la katepart cercarà en els següents llocs (en aquest ordre):
La configuració global.
Dades opcionals de la sessió.
La configuració del «tipus de fitxer».
Variables de document en
.kateconfig.Variables de document en el document mateix.
Opcions canviades durant l'edició des del menú o des de la línia d'ordres.
Com podeu imaginar, les variables de document només seran substituïdes pels canvis realitzats en temps d'execució. Quan es desa un document, es tornaran a llegir les variables de document, i se sobreescriuran els canvis realitzats utilitzant els elements del menú o de la línia d'ordres.
Qualsevol variable no llistada a continuació serà emmagatzemada en el document i podrà ser consultada per altres objectes com connectors, els quals les podran utilitzar per a les seves pròpies finalitats. Per exemple, la variable «indent mode» utilitza variables de document per a la seva configuració.
Les variables aquí llistades són documents de la KatePart versió 5.38. En el futur s'hi poden afegir més variables. Hi ha 3 tipus de valors possibles per a les variables, amb les següents expressions vàlides:
BOOL - on|off|true|false|1|0
INTEGER - qualsevol nombre enter
STRING - tota la resta
auto-brackets [BOOLEÀ]
Activa la inserció automàtica de parèntesis.
auto-center-lines [ENTER]
Defineix el nombre de línies d'autocentrat.
background-color [CADENA]
Estableix el color de fons del document. El valor haurà de ser quelcom a un color vàlid, per exemple «
#ff0000».backspace-indents [BOOLEÀ]
Activa o desactiva treure el sagnat quan es prem la tecla Retrocés.
block-selection [BOOLEÀ]
Activa o desactiva la selecció per blocs.
bom | byte-order-mark | byte-order-marker [BOOLEÀ]
Activa/desactiva el marcador d'ordre de bytes (BOM) en desar fitxers en el format Unicode (utf8, utf16, utf32).
Des del: Kate 3.4 (KDE 4.4)
bracket-highlight-color [CADENA]
Estableix el color del ressaltat per al claudàtor. El valor haurà de ser quelcom a un color vàlid, per exemple «
#ff0000».current-line-color [CADENA]
Estableix el color del ressaltat per a la línia actual. El valor haurà de ser quelcom a un color vàlid, per exemple «
#ff0000».default-dictionary [CADENA]
Defineix el diccionari predeterminat utilitzat per a la correcció ortogràfica.
Des del: Kate 3.4 (KDE 4.4)
dynamic-word-wrap [BOOLEÀ]
Activa o desactiva l'ajust dinàmic de les línies.
eol | end-of-line [CADENA]
Estableix el mode del final de les línies. Les opcions vàlides són «
unix», «mac» i «dos».folding-markers [BOOLEÀ]
Estableix l'ús de la visualització de les marques de plegat («on» o «off»).
folding-preview [BOOLEÀ]
Activa la vista prèvia del text plegat a la vora de l'editor.
font-size [ENTER]
Defineix la mida del punt de la lletra del document.
font [CADENA]
Estableix la lletra del document. El valor haurà de ser un nom vàlid de font, per exemple «
courier».hl | syntax [CADENA]
Ajusta el ressaltat de la sintaxi. Les cadenes vàlides són tots els noms disponibles en els menús. Per exemple, per a C + + escriviu
C++.icon-bar-color [CADENA]
Estableix el color de la barra de les icones. El valor haurà de ser quelcom a un color vàlid, per exemple
#ff0000.icon-border [BOOLEÀ]
Estableix l'ús de la visualització de la vora de la icona («on» o «off»).
indent-mode [CADENA]
Estableix el mode del sagnat automàtic. Les opcions «
cap», «normal», «cstyle», «haskell», «lilypond», «lisp», «python», «ruby» i «xml» són reconegudes. Vegeu la secció «Usar el sagnat automàtic» per als detalls.indent-pasted-text [BOOLEÀ]
Activa/desactiva l'ajust del sagnat del text enganxat des del porta-retalls.
Des del: Kate 3.11 (KDE 4.11)
indent-width [ENTER]
Estableix l'amplada del sagnat.
keep-extra-spaces [BOOLEÀ]
Estableix l'ús d'espais extra per a calcular l'amplada del sagnat.
line-numbers [BOOLEÀ]
Estableix l'ús de la visualització dels números de línia («on» o «off»).
newline-at-eof [BOOLEÀ]
Afegeix una línia en blanc al final del fitxer (EOF) en desar el document.
Des del: Kate 3.9 (KDE 4.9)
overwrite-mode [BOOLEÀ]
Estableix l'ús del mode de sobreescriptura («on» o «off»).
persistent-selection [BOOLEÀ]
Estableix l'ús de les seleccions persistents («on» o «off»).
replace-tabs-save [BOOLEÀ]
Estableix l'ús de la conversió de les tabulacions a espais durant el desament («on» o «off»).
replace-tabs [BOOLEÀ]
Estableix l'ús de la conversió dinàmica de les tabulacions a espais («on» o «off»).
remove-trailing-spaces [CADENA]
Elimina els espais finals en desar el document. Les opcions vàlides són:
none,-o0: mai elimina els espais finals.modified,mod,+o1: elimina els espais finals només en les línies modificades. Les línies modificades són marcades pel sistema de modificació de la línia.all,*o2: elimina els espais finals a tot el document.
scrollbar-minimap [BOOLEÀ]
Mostra un mapa en miniatura a la barra de desplaçament.
scrollbar-preview [BOOLEÀ]
Mostra una vista prèvia a la barra de desplaçament.
scheme [CADENA]
Estableix l'esquema de color. La cadena haurà de ser un nom d'esquema de color que ja existeixi a la vostra configuració per a aconseguir qualsevol efecte.
selection-color [CADENA]
Estableix la selecció del color. El valor haurà de ser quelcom que pugui ser avaluat com un color vàlid, per exemple «
#ff0000».show-tabs [BOOLEÀ]
Estableix l'ús de la visualització del caràcter de tabulació («on» o «off»).
smart-home [BOOLEÀ]
Estableix l'ús de la navegació intel·ligent («on» o «off»).
tab-indents [BOOLEÀ]
Estableix l'ús del sagnat amb la tecla Tab («on» o «off»).
tab-width [ENTER]
Estableix l'amplada del caràcter de tabulació.
undo-steps [ENTER]
Estableix el nombre de passos a desfer que es poden recordar.
Nota: Obsolet des del Kate 3 al KDE 4. Aquesta variable serà ignorada. El compte màxim de passos a desfer serà il·limitat.
word-wrap-column [ENTER]
Estableix l'amplada de l'ajust estàtic de les línies.
word-wrap-marker-color [CADENA]
Estableix el color de la marca del salt de línia. El valor haurà de ser quelcom a un color vàlid, per exemple «
#ff0000».word-wrap [BOOLEÀ]
Estableix l'ús de l'ajust estàtic de les línies («on» o «off»).
La KatePart sempre cerca per un fitxer .kateconfig en fitxers locals (no remots). A més, és possible configurar les opcions basades en comodins (extensions de fitxer) de la manera següent:
kate: tab-width 4; indent-width 4; replace-tabs on; kate-wildcard(*.xml): indent-width 2; kate-wildcard(Makefile): replace-tabs off;
En aquest exemple, tots els fitxers utilitzen una amplada de la pestanya de 4 espais, una amplada del sagnat de 4 espais, i les tabulacions se substitueixen expandides a espais. Tanmateix, per a tots els fitxers *.xml, l'amplada del sagnat s'estableix a 2 espais. I als Makefiles es fan servir tabulacions, és a dir, que les tabulacions no se substitueixen per espais.
Els comodins estan separats per un punt i coma, és a dir, també podeu especificar múltiples extensions de fitxer de la manera següent:
kate-wildcard(*.json;*.xml): indent-width 2;
A més, també podeu utilitzar els tipus MIME per a fer-les coincidir amb certs fitxers, p. ex., per a sagnar tots els fitxers font de C++ amb 4 espais, podeu escriure:
kate-mimetype(text/x-c++src): indent-width 4;
Nota
Al costat del suport en els fitxers .kateconfig, els comodins i els tipus MIME que depenen de variables de document també són admesos en els mateixos fitxers com a comentaris.