La Redaktilkomponanta Komandlinio

La redaktilo de KatePart havas internan komandlinion, ebligante al vi fari diversajn agojn de minimuma GUI. La komandlinio estas teksta eniro ĉe la fundo de la redaktilo; por montri ĝin elektu Vidi → Ŝanĝu al komandlinio aŭ uzu la ŝparvojon (defaŭlte estas ). F7). La redaktilo disponigas aron da komandoj kiel dokumentite sube, kaj kromaj komandoj povas esti provizitaj per kromaĵoj.

Por efektivigi komandon, tajpu la komandon kaj premu la revenklavon. La komandlinio indikos ĉu ĝi sukcesis kaj eble montros mesaĝon. Se vi enigis la komandlinion premante F7 ĝi aŭtomate kaŝos post kelkaj sekundoj. Por forigi la mesaĝon kaj enigi novan komandon, premu F7 denove.

La komandlinio havas enkonstruitan helpsistemon; eldonu la komandon help por komenci. Por vidi liston de ĉiuj disponeblaj komandoj eldonu help list; por vidi helpon pri specifa komando, faru help komando.

La komandlinio havas enkonstruitan historion, do vi povas reuzi komandojn jam tajpitajn. Por navigi la historion, uzu la klavojn Up kaj Down. Kiam vi montras historiajn ordonojn, la argumenta parto de la komando estos elektita, permesante al vi facile anstataŭigi la argumentojn.

Normaj Komandliniaj Komandoj

Argumentaj tipoj

BOOLEAN: Ĉi tio estas uzata kun komandoj, kiuj ŝaltas aŭ malŝaltas aferojn. Laŭleĝaj valoroj estas on, off, true, false, 1 aŭ 0.
INTEGER: Entjera nombro.
STRING: Ĉeno, ĉirkaŭita de unuopaj citiloj (') aŭ duoblaj citiloj (") kiam ĝi enhavas spacojn.

Komandoj por Agordo de la Redaktoro

Ĉi tiuj komandoj estas provizitaj de la redaktilo, kaj permesas vin agordi la aktivan dokumenton kaj vidon nur. Ĉi tio estas oportuna se vi volas uzi agordon malsaman de la defaŭltaj agordoj, ekzemple por indentaĵo.

set-tab-width {INTEGER larĝo}

Agordas la tab-larĝon al la nombro kun.

set-indent-width {INTEGER larĝo}

Agordas la indentlarĝon al la nombro larĝo. Uzata nur se vi indentigas per spacoj.

set-word-wrap-column {INTEGER larĝo}

Agordas la linilarĝon por malmola volvado al larĝo. Ĉi tio estas uzata se vi envolvas vian tekston aŭtomate.

set-icon-border {BOOLEAN aktivigo}

Agordas la videblecon de la piktogramo.

set-folding-markers {BOOLEAN aktivigi}

Agordas la videblecon de la faldebla markilo-fenestro.

set-line-numbers {BOOLEAN ebligi}

Agordas la videblecon de la lininumera panelo.

set-replace-tabs {BOOLEAN aktivigo}

Se enŝaltite, taboj estas anstataŭigitaj per spacoj dum vi tajpas.

set-remove-trailing-space {BOOLEAN aktivigo}

Se ĝi estas ebligita, la malantaŭa blankspaco estas forigita kiam ajn la kursoro forlasas linion.

set-show-tabs {BOOLEAN aktivigi}

Se ĝi estas ebligita, TAB-signoj kaj malantaŭa blankspaco estos bildigitaj per malgranda punkto.

set-show-indent {BOOLEAN aktivigo}

Se ebligita, indentaĵo estos bildigita per vertikala punktlinio.

set-indent-spaces {BOOLEAN aktivigo}

Se ĝi estas ebligita, la redaktilo deŝovos per indent-width spacoj por ĉiu indentnivelo, prefere ol per unu TAB-signo.

set-mixed-indent {BOOLEAN aktivigo}

Se ebligita, KatePart uzos miksaĵon de TAB kaj spacoj por indentaĵo. Ĉiu indentnivelo estos larĝa indent-width, kaj pli da indentniveloj estos optimumigitaj por uzi tiom da TAB-signoj kiel eble.

Kiam efektivigata, ĉi tiu komando aldone ebligos spacetan deŝovon, kaj se la indentlarĝo estas nespecifita, ĝi estos agordita al duono de la tab-larĝo por la dokumento en la momento de la efektivigo.

set-word-wrap {BOOLEAN aktivigo}

Ebligas dinamikan vortŝanĝon laŭ ebligi.

set-replace-tabs-save {BOOLEAN aktivigi }

Kiam estas ebligita, taboj estos anstataŭigitaj per blankspaco kiam la dokumento estas konservita.

set-remove-trailing-space-save {BOOLEAN aktivigi}

Kiam ĝi estas ebligita, posta spaco estos forigita de ĉiu linio kiam la dokumento estas konservita.

set-indent-mode {STRING nomo}

Agordas la aŭtomatan indentan reĝimon al nomo. Se nomo ne estas konata, la reĝimo estas agordita al 'neniu'. Validaj reĝimoj estas 'neniu', 'normala', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' kaj 'xml'.

set-auto-ident {BOOLEAN skripto}

Ebligi aŭ malŝalti aŭtomatan deŝovon.

set-highlight {STRING elstarigi}

Agordas la sintaksan reliefigsistemon por la dokumento. La argumento devas esti valida elstara nomo, kiel vidite en la menuo Iloj → Elstarigado. Ĉi tiu komando provizas aŭtomatan liston por sia argumento.

reload-scripts

Reŝargi ĉiujn JavaScript skriptoj uzataj de Kate, inkluzive de endentiloj kaj komandliniaj skriptoj.

set-mode {STRING reĝimo}

Elektu la dosiertipskemon por la nuna dokumento.

nn[oremap] {STRING originala} {STRING mapita}

Mapi la klavsekvencon origina al mapita.

Komandoj por redaktado

Ĉi tiuj komandoj modifas la nunan dokumenton.

indent

Indentigas la elektitajn liniojn aŭ la nunan linion.

unindent

Malstreĉigas la elektitajn liniojn aŭ aktualan linion.

cleanindent

Purigas la indentaĵon de la elektitaj linioj aŭ aktuala linio laŭ la indentaĵagordoj en la dokumento.

comment

Enmetas komentmarkojn por fari la elekton aŭ elektitajn liniojn aŭ nunan linion komento laŭ la tekstformato kiel difinita de la sintaksa emfaza difino por la dokumento.

uncomment

Forigas komentsignojn de la elekto aŭ elektitaj linioj aŭ aktuala linio laŭ la tekstformato kiel difinita de la sintaksa emfaza difino por la dokumento.

kill-line

Forigas la nunan linion.

replace { STRING ŝablono} {STRING anstataŭigo}

Anstataŭigas tekston kongruan kun ŝablono per anstataŭaĵo. Se vi volas enmeti blankspacon en la ŝablono, vi devas citi kaj la ŝablono kaj anstataŭaĵo per unuopaj aŭ duoblaj citiloj. Se la argumentoj estas necititaj, la unua vorto estas uzata kiel ŝablono kaj la ceteraj por anstataŭaĵo. Se anstataŭaĵo estas malplena, ĉiu okazo de ŝablono estas forigita.

Vi povas agordi flagojn por agordi la serĉon aldonante dupunkton, sekvitan de unu aŭ pluraj literoj ĉiu reprezentante agordon, donante la formon replace:options padronanstataŭigo. Disponeblaj opcioj estas:

b: Serĉi malantaŭen.
c: Serĉi ekde la pozicio de la kursoro.
e: Serĉi nur en la elekto.
r: Fari regul-espriman serĉon. Se agordita, vi povas uzi \N kie N estas nombro por reprezenti kaptojn en la anstataŭiga ĉeno.
s: Fari usklecdistingan serĉon.
p: Peti permeson anstataŭigi la sekvan okazon.
w: Kongrui nur tutajn vortojn.

date {STRING formato}

Enmetas daton/horan ĉenon kiel difinitan per la specifita formato, aŭ la formaton “jjyy-MM-dd hh:mm:ss” se neniu estas specifita. La sekvaj tradukoj estas faritaj dum interpretado de formato:

`d`	La tago kiel nombro sen unua nulo (1-31).
`dd`	La tago kiel nombro kun unua nulo (01-31).
`ddd`	La mallongigita lokalizita tagnomo (ekz. 'Lun'..'Suno').
`ddd`	La longa lokalizita tagnomo (ekz. 'lundo'..'dimanĉo').
`M`	La monato kiel nombro sen unua nulo (1-12).
`MM`	La monato kiel nombro kun unua nulo (01-12).
`MMMM`	La longa lokalizita monata nomo (ekz. 'januaro'..'decembro').
`MMM`	La mallongigita lokalizita monata nomo (ekz. 'Jan'..'Dec').
`jj`	La jaro kiel ducifera nombro (00-99).
`yyyy`	La jaro kiel kvarcifera nombro (1752-8000).
`h`	La horo sen antaŭa nulo (0..23 aŭ 1..12 se montriĝas AM/PM).
`hh`	La horo kun unua nulo (00..23 aŭ 01..12 se montriĝas AM/PM).
`m`	La minuto sen unua nulo (0..59).
`mm`	La minuto kun unua nulo (00..59).
`s`	La dua sen unua nulo (0..59).
`ss`	La dua kun unua nulo (00..59).
`z`	La milisekundoj sen antaŭaj nuloj (0..999).
`zzz`	La milisekundoj kun antaŭaj nuloj (000..999).
`AP`	Uzi AM/PM-montron. AP estos anstataŭigita per aŭ "AM" aŭ "PM".
`ap`	Uzi am/pm-montron. ap estos anstataŭigita per aŭ "am" aŭ "pm".

char {STRING identigilo}

Ĉi tiu komando permesas enmeti laŭvortajn signojn laŭ ilia nombra identigilo, en dekuma, okuma aŭ deksesuma formo. Por uzi ĝin lanĉu la dialogon de Redaktado-Komando kaj tajpu char: [numero] en la enirkesto, tiam premu OK.

Ekzemplo 5.1. char ekzemploj

Enigo: char:234

Eligo: ê

Enigo: char:0x1234

Eligo: ሴ

s///[ig] %s///[ig]

Ĉi tiu komando faras 'sed'-similan serĉan/anstataŭigan operacion sur la nuna linio, aŭ sur la tuta dosiero (%s///).

Resume, la teksto estas serĉata por teksto kongrua kun la serĉa ŝablono, la regula esprimo inter la unua kaj la dua oblikvo, kaj kiam kongruo estas trovita, la kongrua parto de la teksto estas anstataŭigita per la esprimo. inter la dua kaj lasta oblikvo. Krampoj en la serĉŝablono kreas malantaŭajn referencojn, tio estas la komando memoras kiu parto de la ĉeno kongruis en la krampoj; ĉi tiuj ĉenoj povas esti reuzitaj en la anstataŭiga ŝablono, nomata \1 por la unua aro de krampoj, \2 por la dua ktp.

Por serĉi laŭvortan ( aŭ ), vi devas eskapi ĝin per malantaŭa oblikva signo: \(\)

Se vi metas i ĉe la fino de la esprimo, la kongruo estos malsenca. Se vi metas g ĉe la fino, ĉiuj aperoj de la ŝablono estos anstataŭigitaj, alie nur la unua apero estas anstataŭigita.

Ekzemplo 5.2. Anstataŭigante tekston en la nuna linio

Via amika kompililo ĵus haltis, dirante al vi, ke la klaso miaKlaso menciita en linio 3902 en via fontdosiero ne estas difinita.

"Buko!" vi pensas, ĝi estas kompreneble MiaKlaso. Vi iras al linio 3902, kaj anstataŭ provi trovi la vorton en la teksto, vi lanĉas la Redaktan Komando-Dialogon, enigas s/miaklaso/MiaKlaso/i, premas la OK butonon, konservas la dosieron kaj kompilas – sukcese sen la eraro.

Ekzemplo 5.3. Anstataŭigante tekston en la tuta dosiero

Imagu, ke vi havas dosieron, en kiu vi plurfoje mencias “Fraŭlino Jensen”, kiam iu envenas kaj diras al vi, ke ŝi ĵus edziĝis al “Sinjoro Jones”. Vi volas, kompreneble, anstataŭigi ĉiun kaj ĉiun aperon de “Fraŭlino Jensen” per “S-ino Jones”.

Enigu la komandlinion kaj eligu la komandon %s/Miss Jensen/Ms Jones/ kaj premu enigklavon, vi finis.

Ekzemplo 5.4. Pli Altnivela Ekzemplo

Ĉi tiu ekzemplo uzas malantaŭajn referencojn kaj ankaŭ karaktroklason (se vi ne scias kio tio estas, bonvolu raporti al la rilata dokumentaro menciita sube).

Supozu, ke vi havas la sekvan linion:

void MyClass::DoStringOps( String      &foo, String &bar, String *p, int  &a, int &b )

Nun vi rimarkas, ke ĉi tio ne estas bela kodo, kaj decidas, ke vi volas uzi la ŝlosilvorton const por ĉiuj “adreso de” argumentoj, tiuj karakterizitaj de la & operatoro antaŭ la argumentnomo. Vi ankaŭ ŝatus simpligi la blankspacon, tiel ke estu nur 1 blankspaco inter ĉiu vorto.

Lanĉu la Redaktan Komandan Dialogon, kaj enigu: s/\s+(\w+)\s+(&)/ const \1 \2/g kaj premu la OK butono. La g ĉe la fino de la esprimo faras la regulan esprimon rekompili por ĉiu kongruo por konservi la malantaŭreferencojn.

Eligo: void MyClass::DoStringOps( const String &foo, const String &bar, String *p, const int &a, const int &b )

Misio plenumita! Nun, kio okazis? Nu, ni serĉis iom da blankspaco (\s+) sekvata de unu aŭ pluraj alfabetaj signoj (\w+) sekvata de iom da plia blankspaco (\s+) sekvita de kaj-signo, kaj en la procezo konservis la alfabetan pecon kaj la kaj-signon por reuzo en la anstataŭiga operacio. Poste ni anstataŭigis la kongruan parton de nia linio per unu blankspaco sekvita de “konst” sekvita de unu blankspaco sekvita de nia konservita alfabeta peco (\1) sekvita de unu blankspaco sekvita de nia konservita kaj-signo (\2)

Nun en kelkaj kazoj la alfabeta peco estis “String”, en iu “int”, do uzante la signoklason \w kaj la + kvantigilo pruvis valora valoraĵo.

sort

Ordigas la elektitan tekston aŭ tutan dokumenton.

natsort

Ordigi la elektitajn liniojn aŭ tutan dokumenton nature.

Ekzemplo 5.5. sort kontraŭ natsort

sort(a10, a1, a2) rezultigas a1, a10, a2

natsort(a10, a1, a2) rezultigas a1, a2, a10

moveLinesDown

Movi elektitajn liniojn malsupren.

moveLinesUp

Movi elektitajn liniojn supren.

uniq

Forigi duobligitajn liniojn el la elektita teksto aŭ la tuta dokumento.

rtrim

Forigu malantaŭan spacon de la elektita teksto aŭ de la tuta dokumento.

ltrim

Forigi antaŭiran spacon el la elektita teksto aŭ el la tuta dokumento.

join [STRING disigilo]

Kunigi elektitajn liniojn aŭ tutan dokumenton. Laŭvole prenas parametron difinantan apartigilon, ekzemple: join ', '

rmblank

Forigi ĉiujn malplenajn spacojn el la elektita teksto aŭ la tuta dokumento.

alignon

Ĉi tiu komando vicigas liniojn en la elektita bloko aŭ tuta dokumento sur la kolumno donita per regula esprimo donita kiel argumento.

Se vi donas malplenan ŝablonon, ĝi vicigos al la unua nemalplena signo defaŭlte.

Se la ŝablono havas kapton, ĝi deŝovos sur la kaptita kongruo.

Ekzemploj:

alignon - enmetos spacojn antaŭ la unua '-' de ĉiu linio por vicigi ilin ĉiujn sur la sama kolumno.

alignon :\\s+(.) enmetos spacojn antaŭ la unua nemalplena signo kiu okazas post dupunkto por vicigi ilin ĉiujn sur la sama kolumno.

unwrap

Malvolvi la elektitan tekston aŭ la tutan dokumenton.

each {STRING skripto}

Donita JavaScript funkcion kiel argumento, voki tion por la listo de elektitaj linioj kaj anstataŭigi ilin per la liveraĵo de tiu retrovoko.

Ekzemplo 5.6. Kunigi elektitajn liniojn

each 'function(linioj){return linioj.join(", ")}'

Aŭ, pli mallonge:

each 'linioj.join(", ")'

filter {STRING skripto}

Donita JavaScript funkcion kiel argumento, voki tion por la listo de elektitaj linioj kaj forigi tiujn kie la revoko liveras malvera.

Ekzemplo 5.7. Forigi malplenajn liniojn

filter 'function(1){return 1.length > 0;}'

Aŭ, pli mallonge:

filter 'line.length > 0'

map {STRING skripto}

Donita JavaScript funkcion kiel argumento, voki tion por la listo de elektitaj linioj kaj anstataŭigi la linion per la valoro de la revoko.

Ekzemplo 5.8. Forigi malplenajn liniojn

map 'function(linio){return linio.replace(/^s+/,"");}'

Aŭ, pli mallonge:

map 'line.replace(/^s+/,"")'

duplicateLinesUp

Duobligi la elektitajn liniojn super la nuna elekto.

duplicateLinesDown

Duobligi la elektitajn liniojn sub la nuna elekto.

Komandoj por navigado

goto {INT linio}

Ĉi tiu komando navigas al la specifita linio.

grep {STRING ŝablono}

Priserĉi la dokumenton laŭ la regula esprimo ŝablono. Por pliaj informoj, vidu Apendico A, Regulaj Esprimoj.

find {STRING ŝablono}

Ĉi tiu komando navigas al la unua okazo de ŝablono laŭ la agordo. Sekvaj okazoj troveblas per Redakti → Trovi Sekvan (la defaŭlta ŝparvojo estas F3).

La find-komando povas esti agordita aldonante dupunkton sekvitan de unu aŭ pluraj opcioj, la formo estas find:options-ŝablono. La sekvaj opcioj estas subtenataj:

b: Serĉi malantaŭen.
c: Serĉi ekde la pozicio de la kursoro.
e: Serĉi nur en la elekto.
r: Fari regul-espriman serĉon. Se agordita, vi povas uzi \N kie N estas nombro por reprezenti kaptojn en la anstataŭiga ĉeno.
s: Fari usklecdistingan serĉon.
w: Kongrui nur tutajn vortojn.

ifind {STRING ŝablono}

Ĉi tiu komando provizas “kiel vi tajpas” serĉadon. Vi povas agordi la konduton de la serĉo aldonante dupunkton sekvitan de unu aŭ pluraj opcioj, kiel ĉi tio: ifind:options pattern. Permesitaj opcioj estas:

b: Serĉi malantaŭen.
r: Fari regul-espriman serĉon.
s: Fari usklecdistingan serĉon.
c: Serĉi ekde la pozicio de la kursoro.

Komandoj por Bazaj Redaktaj Funkcioj (Ĉi tiuj dependas de la aplikaĵo, en kiu la redaktilo estas uzata)

w: Konservi la aktualan dokumenton.
wa: Konservi ĉiujn nuntempe malfermitajn dokumentojn.
q: Fermi la aktualan dokumenton.
qa: Fermi ĉiujn malfermitajn dokumentojn.
wq: Konservi kaj fermi la aktualan dokumenton.
wqa: Konservi kaj fermi ĉiujn nuntempe malfermitajn dokumentojn.
x: Konservi kaj fermi la aktualan dokumenton nur se ĝi ŝanĝiĝis.
x: Konservi kaj fermi ĉiujn nuntempe malfermitajn dokumentojn nur se ili ŝanĝiĝis.
bp: Iri al la antaŭa dokumento en la listo de dokumentoj.
bn: Iri al la sekva dokumento en la listo de dokumentoj.
new: Malfermi novan dokumenton en horizontale dividita vido.
vnew: Malfermi novan dokumenton en vertikale dividita vido.
e: Reŝargi la aktualan dokumenton se ĝi ŝanĝiĝis sur disko.
enew: Redakti novan dokumenton.
print: Malfermi la dialogon Presi por presi la aktualan dokumenton.

http://docs.kde.org/
Antaŭen	Altnivelaj Redaktaj Iloj	Sekven

Antaŭen	Hejmen	Sekven
Altnivelaj Redaktaj Iloj	Altnivelaj Redaktaj Iloj	Uzante Kodfaldadon
http://docs.kde.org/