Configureren met documentvariabelenKatePart-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. Documentvariabelen in .kateconfig gebruiken dezelfde syntax als die in modusregels, maar met uitgebreide opties.
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.
KatePart heeft ondersteuning voor het lezen van configuraties uit .editorconfig bestanden, wanneer de bibliotheek editorconfig is geïnstalleerd. KatePart zoekt automatisch naar een .editorconfig wanneer u een bestand opent. Het geeft echter prioriteit aan bestanden .kateconfig.
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 kunt zien 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 KatePart versie 5.38. 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-brackets [BOOL]
Automatische vierkante haakjes invoegen inschakelen.
auto-center-lines [INT]
Stelt het aantal autocentreer-regels in.
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-mark | byte-order-marker [BOOL]
Schakelt bytevolgordemarkering (BOM) in/uit bij het opslaan van bestanden in het formaat unicode (utf8, utf16, utf32).
Sinds: Kate 3.4 (KDE 4.4)
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,macendos.folding-markers [BOOL]
Zet het tonen van invouwmarkering aan of uit.
folding-preview [BOOL]
Voorbeeld van invouwen in de rand van bewerker.
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-pasted-text [BOOL]
Inspringen in-/uitschakelen van tekst geplakt vanaf het klembord
Sinds: Kate 3.11 (KDE 4.11)
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.
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.
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.
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.
scrollbar-minimap [BOOL]
Schuifbalk met mini-weergave tonen
scrollbar-preview [BOOL]
Voorbeeld op schuifbalk tonen
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.
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.
KatePart zoekt altijd naar een .kateconfig bestand voor locale bestanden (geen bestanden op afstand). Bovendien is het mogelijk opties in te stellen gebaseerd op jokers (bestandsextensies) als volgt:
kate: tab-width 4; indent-width 4; replace-tabs on; kate-wildcard(*.xml): indent-width 2; kate-wildcard(Makefile): replace-tabs off;
In dit voorbeeld gebruiken alle bestanden een tab-breedte van 4 spaties, een indentatiebreedte van 4 spaties en tabs worden vervangen door spaties. Voor alle *.xml bestanden, is de indentatiebreedte ingesteld op 2 spaties. En Makefiles gebruiken tabs, bijv. tabs worden niet vervangen door spaties.
Jokers worden gescheiden door puntkomma's, bijv. u kunt ook meerdere bestandsextensies specificeren als volgt:
kate-wildcard(*.json;*.xml): indent-width 2;
U kunt verder ook het MIME-type te gebruiken om overeen te laten komen, bijv. om alle C++ bronbestanden te indenteren met 4 spaties, u kunt schrijven:
kate-mimetype(text/x-c++src): indent-width 4;
Opmerking
Naast de ondersteuning in .kateconfig bestandstypen, worden jokers en MIME-type afhankelijke documentvariabelen ook ondersteund in de bestandstype zelf als as commentaar.