# Altnivelaj Redaktaj Iloj

## Komenti/Malkomenti

La komandoj Komenti kaj Malkomenti, disponeblaj el la menuo Iloj permesas aldoni aŭ forigi komentsignojn al la elekto, aŭ la nunan linion se ne. teksto estas elektita, se komentoj estas subtenataj de la formato de la teksto, kiun vi redaktas.

La reguloj pri kiel komentado estas farata estas difinitaj en la sintaksaj difinoj, do se sintaksa reliefigo ne estas uzata, komentado/malkomentado ne eblas.

Kelkaj formatoj difinas unuliniajn komentmarkojn, kelkajn plurliniajn markilojn kaj iujn ambaŭ. Se plurliniaj markiloj ne estas disponeblaj, ne eblas komenti elekton, kiu ne plene inkluzivas ĝian lastan linion.

Se unulinia markilo estas disponebla, komentado de unulinioj estas preferinda kie aplikebla, ĉar tio helpas eviti problemojn kun nestitaj komentoj.

Kiam oni forigas komentajn markilojn, neniu nekomentita teksto estu elektita. Kiam oni forigas plurliniajn komentmarkojn de elekto, ajna blankspaco ekster la komentmarkoj estas ignorita.

Por meti komentajn markilojn, uzu la menueron Iloj Komento aŭ la rilatan klavkombinan sekvencon, la defaŭlta estas &Ctrl;D.

Por forigi komentajn markilojn, uzu la menueron Iloj Malkomenti aŭ la rilatan klavkombion, la defaŭlta estas &Ctrl;&Shift;D.

## La Redaktilkomponanta Komandlinio

La redaktilo de &kappname; 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-widthINTEGER larĝo

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

    set-indent-widthINTEGER larĝo

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

    set-word-wrap-columnINTEGER 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-borderBOOLEAN aktivigo

- Agordas la videblecon de la piktogramo.

    set-folding-markersBOOLEAN aktivigi

- Agordas la videblecon de la faldebla markilo-fenestro.

    set-line-numbersBOOLEAN ebligi

- Agordas la videblecon de la lininumera panelo.

    set-replace-tabsBOOLEAN aktivigo

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

    set-remove-trailing-spaceBOOLEAN aktivigo

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

    set-show-tabsBOOLEAN aktivigi

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

    set-show-indentBOOLEAN aktivigo

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

    set-indent-spacesBOOLEAN aktivigo

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

    set-mixed-indentBOOLEAN aktivigo

- Se ebligita, &kappname; 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-wrapBOOLEAN aktivigo

- Ebligas dinamikan vortŝanĝon laŭ `ebligi`.

    set-replace-tabs-saveBOOLEAN aktivigi

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

    set-remove-trailing-space-saveBOOLEAN aktivigi

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

    set-indent-modeSTRING 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-identBOOLEAN skripto

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

    set-highlightSTRING 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-modeSTRING 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.

    dateSTRING 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 (⪚ 'Lun'..'Suno').
  `ddd` | La longa lokalizita tagnomo (⪚ '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 (⪚ 'januaro'..'decembro').
  `MMM` | La mallongigita lokalizita monata nomo (⪚ '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".

    charSTRING 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.

  ##### `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.

  ##### 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.

  ##### 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.

  ##### 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.

  ##### `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.

    joinSTRING 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.

    eachSTRING 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.

  ##### Kunigi elektitajn liniojn

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

  Aŭ, pli mallonge:

  ``each` 'linioj.join(", ")'`

    filterSTRING skripto

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

  ##### Forigi malplenajn liniojn

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

  Aŭ, pli mallonge:

  ``filter` 'line.length > 0'`

    mapSTRING 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.

  ##### 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

    gotoINT 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 regular-expressions.

    findSTRING ŝ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.

    ifindSTRING ŝ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.

## Uzante Kodfaldadon

Kodfaldado permesas vin kaŝi partojn de dokumento en la redaktilo, faciligante superrigardi grandajn dokumentojn. En &kappname; la faldeblaj regionoj estas kalkulitaj per reguloj difinitaj en la sintaksaj elstaraj difinoj, kaj tial ĝi estas disponebla nur en kelkaj formatoj - tipe programkodo, XML-markado kaj similaj. Plej elstaraj difinoj subtenantaj kodfaldadon ankaŭ ebligas vin mane difini faldeblajn regionojn, kutime uzante la ŝlosilvortojn `BEGIN` kaj `END`.

Por uzi la kodfaldajn funkciojn, aktivigu la faldmarkojn per la menuero Vidi Montri faldeblajn markilojn menuero se ili ne estas jam videblaj. La Folding Markers-Panelo sur la maldekstra flanko de la ekrano montras grafikan vidon de la faldeblaj regionoj, kun triangulsimboloj por indiki la eblan operacion sur antaŭfiksita regiono: desupra malsupren triangulo signifas ke la regiono estas vastigita, alklakante ĝin malvastigos la regionon kaj dekstren-indika triangulo estos montrita anstataŭe.

Tri komandoj estas provizitaj por manipuli la staton de faldregionoj, vidu la menudokumentadon.

La falditaj linioj estas memoritaj kiam dosiero estas fermita, do kiam vi remalfermas la dosieron, la falditaj nodoj ankoraŭ estos falditaj. Ĉi tio validas ankaŭ por reŝargi operaciojn.

Se vi ne volas uzi la kodan faldfunkcion, vi povas malŝalti la opcion Montri faldmarkojn (se disponeblas) en la paĝo Apero de la agordo de la redaktilo.