Agordo kun Dokumentaj VariablojKatePart variables estas la efektivigo de dokumentvariabloj de KatePart, simila al Emacs kaj vi modelines. En katepart, la linioj havas la jenan formaton: kate: VARIABLENAME VALUE; [ VARIABLENAME VALUE; ... ] La linioj povas kompreneble esti en komento, se la dosiero estas en formato kun komentoj. Variaj nomoj estas unuopaj vortoj (sen blankspaco), kaj ĉio ĝis la sekva punktokomo estas la valoro. La punktokomo estas postulata.
Jen ekzempla varia linio, deviganta indentajn agordojn por C++, Java™ aŭ JavaScript dosiero:
// kate: replace-tabs on; indent-width 4; indent-mode cstyle;
Rimarko
Nur la unuaj kaj lastaj 10 linioj estas serĉataj por variaj linioj.
Aldone, dokumentvariabloj povas esti metitaj en dosieron nomitan .kateconfig en iu ajn dosierujo, kaj la agorditaj agordoj estos aplikitaj kvazaŭ la modellinioj estus enigitaj en ĉiu dosiero en la dosierujo kaj ĝiaj subdosierujoj. Dokumentvariabloj en .kateconfig uzas la saman sintakson kiel en modellinioj, sed kun plilongigitaj opcioj.
Estas variabloj por subteni preskaŭ ĉiujn agordojn en KatePart, kaj aldone kromaĵojn povas uzi variablojn, tiukaze ĝi devus esti dokumentita en la dokumentaro de la kromprogramo.
KatePart havas subtenon por legi agordojn de .editorconfig dosieroj, kiam la editorconfig biblioteko estas instalita. KatePart aŭtomate serĉas .editorconfig kiam ajn vi malfermas dosieron. Ĝi tamen donas prioritaton al dosieroj .kateconfig.
Legante agordon, katepart rigardas en la sekvaj lokoj (en tiu ordo):
La ĉiea agordo.
Laŭvolaj seancaj datumoj.
La agordo "Dosierotipo".
Dokumentvariabloj en
.kateconfig.Dokumentvariabloj en la dokumento mem.
Agordoj faritaj dum redaktado el menuo aŭ komandlinio.
Kiel vi povas vidi, dokumentaj variabloj estas nur anstataŭitaj de ŝanĝoj faritaj ĉe rultempo. Kiam ajn dokumento estas konservita, la dokumentvariabloj estas relegitaj, kaj anstataŭigos ŝanĝojn faritajn per menueroj aŭ la komandlinio.
Ajna variablo ne listigita malsupre estas konservita en la dokumento kaj povas esti pridemandita de aliaj objektoj kiel kromaĵojn, kiuj povas uzi ilin por sia propra celo. Ekzemple, la varia indentreĝimo uzas dokumentvariablojn por sia agordo.
La variabloj listigitaj ĉi tie dokumentas KatePart versio 5.38. Pli da variabloj povas esti aldonitaj estonte. Estas 3 eblaj specoj de valoroj por variabloj, kun la sekvaj validaj esprimoj:
BOOL - on|off|true|false|1|0
INTEGER - ajna entjera nombro
STRING - io alia
aŭtomate krampoj [BOOL]
Ebligi aŭtomatan enmeton de krampoj.
aŭtomatcentraj linioj [INT]
Agordi la nombron da aŭtocentraj linioj.
background-color [STRING]
Agordu la fonkoloron de la dokumento. La valoro devas esti io taksebla al valida koloro, ekzemple
#ff0000.backspace-indents [BOOL]
Ebligi aŭ malŝalti maldeŝovadon kiam Retropaŝo estas premita.
block-selection [BOOL]
Ŝalti aŭ malŝalti blok-elekton.
bom | byte-order-mark | byte-order-marker [BOOL]
Ebligu/malŝaltu la bajtan ordomarkon (BOM) dum konservado de dosieroj en Unikoda formato (utf8, utf16, utf32).
Ekde: Kate 3.4 (KDE 4.4)
bracket-highlight-color [STRING]
Agordu la koloron por la krampo elstara. La valoro devas esti io taksebla al valida koloro, ekzemple
#ff0000.current-line-color [STRING]
Agordu la koloron por la nuna linio. La valoro devas esti io taksebla al valida koloro, ekzemple
#ff0000.defaŭlta vortaro [STRING]
Agordas la defaŭltan vortaron uzatan por literumkontrolo.
Ekde: Kate 3.4 (KDE 4.4)
dynamic-word-wrap [BOOL]
Enŝaltas aŭ malŝaltas dinamikan vortvolvadon.
eol | end-of-line [STRING]
Agordu la finon de linio-reĝimo. Validaj agordoj estas
unikso,mackajdos.faldeblaj markiloj [BOOL]
Ŝalti aŭ malŝalti la montradon de faldmarkiloj.
folding-preview [BOOL]
Ebligi faldeblan antaŭrigardo en la redaktora rando.
font-size [INT]
Agordi la punktograndon de la dokumenttiparo.
font [STRING]
Agordi la tiparon de la dokumento. La valoro estu valida tiparonomo, ekzemple
kuristo.hl | syntax [STRING]
Agordi la sintaksan reliefigon. Validaj ĉenoj estas ĉiuj nomoj disponeblaj en la menuoj. Ekzemple, por C++ simple skribu
C++.icon-bar-color [STRING]
Agordi la koloron de la piktogramo. La valoro devas esti io taksebla al valida koloro, ekzemple
#ff0000.icon-border [BOOL]
Ŝalti aŭ malŝalti la montradon de la piktolimo.
indent-mode [STRING]
Agordi la aŭtomatan indentan reĝimon. La opcioj
neniu,normala,cstyle,haskell,lilypond,lisp,python,rubykajxmlestas rekonitaj. Vidu la sekcion la sekcio nomata “Uzado de aŭtomata deŝovo” por detaloj.indent-pasted-text [BOOL]
Ebligi/malŝalti ĝustigi indentaĵon de teksto gluita el la tondujo.
Ekde: Kate 3.11 (KDE 4.11)
indent-width [INT]
Agordu la deŝovolarĝon.
keep-extra-spaces [BOOL]
Agordu ĉu konservi kromajn spacojn dum kalkulado de deŝovolarĝo.
line-numbers [BOOL]
Ŝaltu aŭ malŝaltu la montradon de linionumeroj.
newline-at-eof [BOOL]
Aldonu malplenan linion ĉe la fino de la dosiero (EOF) dum konservado de la dokumento.
Ekde: Kate 3.9 (KDE 4.9)
overwrite-mode [BOOL]
Ŝaltu aŭ malŝaltu anstataŭigan reĝimon.
persistent-selection [BOOL]
Ŝaltu aŭ malŝaltu daŭran elekton.
replace-tabs-save [BOOL]
Agordu tabon al spackonverto sur konservado aŭ malŝaltita.
replace-tabs [BOOL]
Ŝaltu aŭ malŝaltu dinamikan tabon al spaca konvertiĝo.
remove-trailing-spaces [STRING]
Forigas postajn spacojn dum konservado de la dokumento. Validaj opcioj estas:
neniu,-aŭ0: neniam forigu postajn spacojn.modifita,mod,+aŭ1: forigi postajn spacojn nur en modifitaj linioj. La modifitaj linioj estas markitaj per la liniomodifsistemo.ĉiuj,*aŭ2: forigu postajn spacojn en la tuta dokumento.
scrollbar-minimap [BOOL]
Montru rulumbren minimapon.
scrollbar-preview [BOOL]
Montru antaŭrigardon de rulumbreto.
scheme [STRING]
Agordu la kolorskemon. La ĉeno devas esti la nomo de kolorskemo kiu ekzistas en via agordo por havi ajnan efikon.
selection-color [STRING]
Agordu la elektan koloron. La valoro devas esti io taksebla al valida koloro, ekzemple
#ff0000.show-tabs [BOOL]
Ŝaltu aŭ malŝaltu la vidan tabon.
inteligenta hejmo [BOOL]
Ŝaltu aŭ malŝaltu inteligentan hejman navigadon.
tab-indents [BOOL]
Agordu Tab-klavan deŝovon ŝaltita aŭ malŝaltita.
tab-width [INT]
Agordu la montritan larĝon de tab-signo.
undo-steps [INT]
Agordu la nombron da malfaraj paŝoj por memori.
Noto: Malrekomendita ekde Kate 3 en KDE4. Ĉi tiu variablo estas ignorita. La maksimuma nombro de malfari paŝoj estas senlima.
word-wrap-column [INT]
Agordu la larĝon de senmova vortvolvaĵo.
word-wrap-marker-color [STRING]
Agordu la vortvolvaĵan markilon. La valoro devas esti io taksebla al valida koloro, ekzemple
#ff0000.word-wrap [BOOL]
Ŝaltu aŭ malŝaltu statikan vortvolvadon.
KatePart ĉiam serĉu dosieron .kateconfig por lokaj dosieroj (ne foraj dosieroj). Krome, eblas agordi opciojn bazitajn sur ĵokeroj (dosieraj etendoj) jene:
kate: tab-width 4; indent-width 4; replace-tabs on; kate-wildcard(*.xml): indent-width 2; kate-wildcard(Makefile): replace-tabs off;
En ĉi tiu ekzemplo, ĉiuj dosieroj uzas klapeton-larĝon de 4 spacoj, indent-larĝon de 4 spacoj, kaj taboj estas anstataŭigitaj vastigitaj al spacoj. Tamen, por ĉiuj dosieroj *.xml, la indentlarĝo estas agordita al 2 spacoj. Kaj Makefiles uzas tabojn, t.s. taboj ne estas anstataŭigitaj per spacoj.
Ĵokkartoj estas punktokomo apartigitaj, t.s. vi ankaŭ povas specifi plurajn dosier-etendojn jene:
kate-wildcard(*.json;*.xml): indent-width 2;
Plue, vi povas ankaŭ uzi la MIME-tipon por kongrui kun certaj dosieroj, ekz. por indentigi ĉiujn C++ fontdosierojn kun 4 spacoj, vi povas skribi:
kate-mimetype(text/x-c++src): indent-width 4;
Rimarko
Apud la subteno en dosieroj .kubeconfig, ĵokero kaj MIME; tipo dependaj dokumentvariabloj ankaŭ estas subtenataj en la dosieroj mem kiel komentoj.