Configureren met documentvariabelenKate-variabelen is de implementatie van documentvariabelen van katepart, vergelijkbaar met modusregels van emacs en vi. In katepart hebben de regels het volgende formaat kate: VARIABELENAAM WAARDE; [ VARIABELENAAM WAARDE; ... ] de regels kunnen zich natuurlijk in commentaar bevinden, als het bestand in een formaat is met commentaar. Variabelennamen zijn enkele woorden (geen witruimte) en alles tot aan de volgende puntkomma is de waarde. De puntkomma is vereist.
Hier is een voorbeeld van een variabelenregel, die instellingen voor inspringen forceert voor een bestand met C++, java of javascript:
// kate: replace-tabs on; indent-width 4; indent-mode cstyle;
Opmerking
Alleen in de eerste en laatste 10 regels worden gezocht naar variabelenregels.
Bovendien, kunnen documentvariabelen in een bestand geplaatst worden genaamd .kateconfig in elke map en de geconfigureerde instellingen zullen worden toegepast alsof de modusregels ingevoerd zijn op elk bestand in de map en zijn submappen, tot zover als de geconfigureerde zoekdiepte. Documentvariabelen in .kateconfig gebruiken dezelfde syntax als die in modusregels.
Er zijn variabelen om bijna alle configuraties in katepart te ondersteunen, en extra plugins kunnen variabelen gebruiken, in welk geval het gedocumenteerd zou moeten zijn in de documentatie van de plugin.
Bij het lezen van de instellingen kijkt katepart op de volgende plaatsen (in die volgorde):
De globale instellingen.
Optionele sessiegegevens.
De instellingen voor "Bestandstype".
Documentvariabelen in
.kateconfig.Documentvariabelen in het document zelf.
Instellingen die zijn gemaakt tijdens het bewerken uit het menu of vanaf de commandoregel.
Zoals u ziet hebben documentvariabelen die gewijzigd zijn tijdens uitvoering voorrang. Wanneer een document wordt opgeslagen zullen de documentvariabelen worden herlezen en zullen de wijzigingen overschrijven die zijn gemaakt door menu-items of door de commandoregel te gebruiken.
Elke variabele, die niet hieronder wordt genoemd, wordt opgeslagen in het document en kan door andere objecten, zoals plugins, worden opgevraagd, die ze voor hun eigen doeleinden kunnen gebruiken. De variabele 'indent-mode' gebruikt bijvoorbeeld documentvariabelen voor zijn configuratie.
De hier getoonde variabelen documenteren Kate versie 3.7. Meer variabelen kunnen in de toekomst worden toegevoegd. Er zijn 3 mogelijke typen waarden voor variabelen, met de volgende geldige expressies:
BOOL - on|off|true|false|1|0
INTEGER - elk geheel getal
STRING - iets anders
auto-center-lines [INT]
Stelt het aantal autocentreer-regels in.
auto-insert-doxygen [BOOL]
Zet het invoegen van de start-sterretjes in doxygen commentaar aan of uit. Dit heeft geen effect tenzij u de C-style auto-indenteerder gebruikt.
background-color [STRING]
Stelt de kleur in kleur in van de achtergrond van het document. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld
#ff0000.backspace-indents [BOOL]
Indentering in- of uitschakelen wanneer Backspace wordt ingedrukt.
block-selection [BOOL]
Zet selectie van blokken aan of uit.
bom | byte-order-marker [BOOL]
Schakelt bytevolgordemarkering in/uit bij het opslaan van bestanden in het formaat unicode (utf8, utf16, utf32).
Sinds: Kate 3.4 (KDE 4.4)
encoding [STRING]
Stel de te gebruiken codering in voor het laden of opslaan van het bestand. Omdat de variabelen in het document gelezen zullen worden na het laden, heeft dit alleen invloed op het opslaan. Als u het in een bestand
.kateconfigplaatst, zal het ook van invloed zijn op het laden.Sinds: Kate 3.10 (KDE 4.10)
bracket-highlight-color [STRING]
Stel de kleur in voor accentuering van haakjes. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld
#ff0000"current-line-color [STRING]
Stelt de kleur in van de huidige regel. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld
#ff0000".default-dictionary [STRING]
Stelt het standaard woordenboek in dat wordt gebruikt voor spellingcontrole.
Sinds: Kate 3.4 (KDE 4.4)
dynamic-word-wrap [BOOL]
Schakelt dynamische regelafbreking in of uit.
eol | end-of-line [STRING]
Stelt de modus van einde-regel in. Geldige instellingen zijn
unix,macendosfolding-markers [BOOL]
Zet het tonen van invouwmarkering aan of uit.
font-size [INT]
Stelt de grootte van het lettertype van het document in in punten.
font [STRING]
Stelt het lettertype van het document in. De waarde moet de naam van een geldig lettertype zijn, bijvoorbeeld
courier.hl | syntax [STRING]
Stelt de accentuering van de syntax in. Geldige tekenreeksen zijn alle namen beschikbaar in de menu's. Bijvoorbeeld voor C++, schrijf eenvoudig
C++.icon-bar-color [STRING]
Stelt de kleur in de pictogrambalk. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld
#ff0000.icon-border [BOOL]
Zet het tonen van de pictogramrand aan of uit.
indent-mode [STRING]
Stelt de auto-inspringmodus in. De opties
none,normal,cstyle,haskell,lilypond,lisp,python,rubyenxmlworden herkend. Zie de sectie de paragraaf met de naam “Automatisch inspringen gebruiken ” voor details.indent-width [INT]
Stelt de inspringbreedte in.
keep-extra-spaces [BOOL]
Stelt in of extra spaties behouden blijven wanneer de inspringbreedte wordt berekend.
line-numbers [BOOL]
Zet het tonen van regelnummers aan of uit.
mixed-indent [BOOL]
Gemengd inspringen in/uitschakelen als in Emacs.
Opmerking: Verouderd sinds Kate 3 in KDE4. Deze variable wordt genegeerd, gebruik replace-tabs on; in plaats hiervan in de toekomst.
newline-at-eof [BOOL]
Voeg een lege regel toe aan het eind van het bestand (EOF) wanneer document wordt opgeslagen.
Sinds: Kate 3.9 (KDE 4.9)
overwrite-mode [BOOL]
Overschrijfmodus aan/uitzetten.
persistent-selection [BOOL]
Zet blijvende selecties aan of uit.
remove-trailing-space [BOOL]
Dynamisch wissen aan het eind van de regel aan/uitzetten.
Opmerking: Verouderd sinds KDE 4.10. Gebruik in plaatst daarvan liever verwijder-spaties-aan-het-eind met de gewenste keuze.
remove-trailing-spaces [TEKENREEKS]
Spaties aan het einde van de regel bij het opslaan verwijderen. Geldige opties zijn:
none,-of0: nooit spaties aan het einde verwijderen.modified,mod,+of1: spaties aan het eind alleen verwijderen in gewijzigde regels. De gewijzigde regels worden gemarkeerd door het regelwijzigingssysteem.all,*or2: spaties aan het eind in het gehele document verwijderen.
Sinds: KDE 4.10. Dit maakt dat de opties
remove-trailing-spaceenreplace-trailing-space-saveverouderd zijn.replace-tabs-save [BOOL]
Zet conversie van tab naar spatie bij opslaan aan of uit.
replace-tabs [BOOL]
Zet dynamische conversie van tab naar spatie aan of uit.
replace-trailing-space-save [BOOL]
Zet opschonen aan het eind van de regel aan of uit.
Opmerking: Verouderd sinds KDE 4.10. Gebruik in plaatst daarvan liever verwijder-spaties-aan-het-eind met de gewenste keuze.
scheme [STRING]
Stelt het kleurenschema in. De tekenreeks moet de naam van een kleurenschema zijn dat in uw configuratie bestaat om enig effect te hebben.
selection-color [STRING]
Stelt de kleur van een selectie in. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld
#ff0000.show-tabs [BOOL]
Zet het visuele tab-teken aan of uit.
smart-home [BOOL]
Zet intelligent navigeren naar de basismap aan of uit.
space-indent [BOOL]
Zet inspringen met spaties aan of uit.
Opmerking: Verouderd sinds Kate 3 in KDE4. Gemengd inspringen is standaard. Stel replace-tabs on; om inspringen met alleen spaties te verkrijgen.
tab-indents [BOOL]
Zet het inspringen met de Tab-toets aan of uit.
tab-width [INT]
Stelt de weergavebreedte van het tab-teken in.
undo-steps [INT]
Stelt het aantal te herinneren stappen in.
Opmerking: Verouderd sinds Kate 3 in KDE4. Deze variabele wordt genegeerd. Het maximum aantal stappen voor terugdraaien is ongelimiteerd.
word-wrap-column [INT]
Stelt breedte in van statische regelafbreking.
word-wrap-marker-color [TEKENREEKS]
Stelt de kleur in van de marker voor regelafbreking. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld
#ff0000.word-wrap [BOOL]
Zet statische regelafbreking aan of uit.