Indstil med dokumentvariabler

Variabler i Kate er Kate-programdelens implementering af dokumentvariabler, som ligner modelines i Emacs og Vi. I Kate-programdelen har linjerne formatet kate: VARIABELNAVN VÆRDI; [ VARIABELNAVN VÆRDI; ... ]. Linjerne kan naturligvis være i en kommentar, hvis filen har et format med kommentarer. Variabelnavne er enkelte ord (ingen blanke tegn), og alt frem til næste semikolon er værdien. Semikolonet er nødvendigt.

Her er et eksempel på en variabellinje, som styrer indrykningsindstillinger for en C++, Java- eller Javascript-fil:

// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;

Bemærk

Kun de første og sidste 10 linjer gennemsøges for variabellinjer.

Der er variabler som understøtter næsten alle indstillinger i Kate-programdelen, og yderligere plugin kan bruge variabler, som i så fald skal være dokumenterede i pluginnets dokumentation.

Hvordan Kate bruger variabler

Når indstillingerne læses, leder Kate-programdelen på følgende steder (i denne rækkefølge):

  • Den generelle indstilling.

  • Valgfri sessionsdata.

  • Indstillingen under "filtype".

  • Dokumentvariabler i selve dokumentet.

  • Indstillinger som gøres under redigering fra menuen eller kommandolinjen.

Som du forstår har dokumentvariabler næst højest prioritet. Så snart et dokument gemmes, læses dokumentvariablerne igen, og overskriver ændringer som er lavet med menupunkter eller fra kommandolinjen.

Alle variabler som ikke angives nedenfor opbevares i dokumentet og kan læses af andre objekter, eksempelvis plugin, som kan bruge dem til egne formål. Den variabelbaserede indrykningstilstand bruger for eksempel dokumentvariabler til sin indstilling.

Variablerne som angives her dokumenterer Kate version 2.4. Flere variabler kan tilføjes i fremtiden. Der er tre mulige typer af værdier definerede for variabler, med følgende gyldige udtryk:

  • BOOL - on|off|true|false|1|0

  • HELTAL - hvilket som helst heltal

  • STRENG - alt andet

Tilgængelige variabler

auto-brackets [BOOL]

Slå til eller fra for automatisk indsættelse af parenteser.

auto-center-lines [HELTAL]

Indstil antal linjer for automatisk centrering.

auto-insert-doxygen [BOOL]

Slå til eller fra for indsætning af indledende stjerne i Doxygen-kommentarer. Dette har ingen effekt hvis du ikke bruger automatisk indrykning i C-stil.

background-color [STRENG]

Indstil dokumentets baggrundsfarve. Værdien skal være noget som kan tolkes som en gyldig farve, for eksempel "#ff0000".

backspace-indents [BOOL]

Slå til eller fra for indrykning med backspace.

block-selection [BOOL]

Slå til eller fra for blokmarkering.

bracket-highlight-color [STRENG]

Indstil farven for markering af parenteser. Værdien skal være noget som kan tolkes som en gyldig farve, for eksempel "#ff0000".

current-line-color [STRENG]

Indstil farven for nuværende linje. Værdien skal være noget som kan tolkes som en gyldig farve, for eksempel "#ff0000".

dynamic-word-wrap [BOOL]

Slå til eller fra for dynamisk linjebrud.

eol | end-of-line [STRENG]

Indstil in linjeslutstilstanden. Gyldige indstillinger er “unix”, “mac” og “dos”.

encoding [STRENG]

Indstil dokumentets tegnsæt. Værdien skal være et gyldigt tegnsætnavn, såsom “utf8”.

font-size [HELTAL]

Indstil tegnstørrelsen i punkter for dokumentets skrifttype.

font [STRENG]

Indstil in dokumentets skrifttype. Værdien skal være et gyldigt skrifttypenavn, for eksempel “courier”.

icon-bar-color [STRENG]

Indstil ikonlinjens farve. Værdien skal være noget som kan tolkes som en gyldig farve, for eksempel "#ff0000".

icon-border [BOOL]

Slår til eller fra for visning af ikonkanten.

folding-markers [BOOL]

Slår til eller fra for visning af foldningsmarkører.

indent-mode [STRENG]

Indstiller automatisk indrykningstilstand. Tilvalgene “none”, “normal”, “cstyle”, “csands”, “python” og “xml” genkendes. Se afsnittet “Brug af automatisk indrykning” for detaljer.

indent-width [HELTAL]

Indstil indrykningsbredden.

keep-extra-spaces [BOOL]

Indstiller om ekstra mellemrum skal beholdes når indrykningsbredden beregnes.

keep-indent-profile [BOOL]

Hvis aktiveret, forhindres afindrykning af en blok hvis mindst en linje ikke har nogen indrykning.

line-numbers [BOOL]

Slå til eller fra for visning af linjenumre.

mixed-indent [BOOL]

Slå blandet indrykning a la Emacs til eller fra.

overwrite-mode [BOOL]

Slår til eller fra af øverskrivningstilstand.

persistent-selection [BOOL]

Slå til eller fra for langlivede markeringer.

remove-trailing-space [BOOL]

Slår til eller fra for dynamisk korrigering af linjeslut.

replace-tabs-save [BOOL]

Slår til eller fra for konvertering af tabulatortegn til mellemrum.

replace-tabs [BOOL]

Slår til eller fra for dynamisk konvertering af tabulatortegn til mellemrum.

replace-trailing-space-save [BOOL]

Slår til eller fra for korrigering af linjeslut når dokumentet gemmes.

system [STRENG]

Indstiller farvesammensætningen. Strengen skal være navnet på en farvesammensætning som findes i dine indstillinger for at have nogen effekt.

selection-color [STRENG]

Indstiller markeringsfarven. Værdien skal være noget som kan tolkes som en gyldig farve, for eksempel "#ff0000".

show-tabs [BOOL]

Slår til eller fra for synligt tabulatortegn.

smart-home [BOOL]

Slår til eller fra for smart Home-navigering.

space-indent [BOOL]

Slår til eller fra for indrykning med mellemrum.

tab-indents [BOOL]

Slår til eller fra for indrykning med tabulatortegn.

tab-width [HELTAL]

Indstil in tabulatorbredden.

undo-steps [HELTAL]

Indstil antallet fortryde-trin som skal huskes.

word-wrap-column [HELTAL]

Indstiller bredden for hårdt linjebrud.

word-wrap-marker-color [STRENG]

Indstil farven som markerer linjebrud. Værdien skal være noget som kan tolkes som en gyldig farve, for eksempel "#ff0000".

word-wrap [BOOL]

Slår til eller fra for hårdt linjebrud.

wrap-cursor [BOOL]

Slår til eller fra for linjebrudsmarkører.