&Anders.Lund; &Anders.Lund.mail;
&Dominik.Haumann; &Dominik.Haumann.mail;
Marek
Laane

    bald@smail.ee

Tõlge eesti keelde

# Täiustatud redigeerimisvahendid

## Kommentaari lisamine/eemaldamine

Käsud Kommentaar ja Eemalda kommentaar, mida saab kasutada menüüst Tööriistad, võimaldavad lisada valitud tekstiosale või kui midagi ei ole valitud, siis parajasti aktiivsele reale kommentaarimärgid või need sealt eemaldada. Seda muidugi juhul, kui parajasti redigeeritava teksti vorming kommentaare üldse kasutada lubab.

Reeglid, mil moel kommentaar välja näeb, on määratud süntaksi definitsioonis, nii et kui süntaksi esiletõstu ei kasutata, ei ole võimalik ka kommentaarimärke lisada või eemaldada.

Mõned vormingud defineerivad ühe rea kommentaarimärgid, mõned lubavad kommenteerida mitut rida korraga ja mõned mõlemat. Kui mitme rea kommentaarimärke ei ole saadaval, siis ei ole võimalik kommenteerida valikut, mille viimane rida ei ole valitud tervikuna.

Kui saadaval on ühe rea kommentaarimärgid, on võimaluse korral mõttekas kommenteerida üksikuid ridasid - nii saab ära hoida näiteks "kommentaari kommentaari sees".

Kommentaarimärkide eemaldamisel ei tohi olla valitud kommenteerimata teksti. Valikult mitmerealise kommentaarimärgistuse eemaldamisel eiratakse iga tühikut väljaspool kommentaarimärgistust.

Kommentaarimärkide lisamiseks kasuta menüükäsku Tööriistad Kommentaar või vastavat kiirklahvikombinatsiooni, mis vaikimisi on &Ctrl;D.

Kommentaarimärkide eemaldamiseks kasuta menüükäsku Tööriistad Eemalda kommentaar või vastavat klahvikombinatsiooni, mis vaikimisi on &Ctrl;&Shift;D.

## Redaktori käsureakomponent

&kappname; redaktorikomponent kasutab seesmist käsurida, mis võimaldab minimaalse GUI-ga väga mitmesuguseid toiminguid ette võtta. Käsurida on terminal redaktori allosas, mille saab nähtavaks muuta menüükäsuga Vaade Lülitu käsureale või kiirklahviga (vaikimisi F7). Redaktor pakub omalt poolt välja rea käske, mida tutvustatakse allpool, pluginad võivad neile veelgi lisa pakkuda.

Käsu käivitamiseks vajuta klahvi Enter. Käsurida annab märku, kas täitmine õnnestus ning näitab vajaduse korral teadet. Kui avasid käsurea klahviga F7, peidetakse see automaatselt mõne sekundi pärast. Teate eemaldamiseks ja uue käsu sisestamiseks vajuta uuesti klahvi F7.

Käsureal on omaenda abisüsteem, mille käivitamiseks anna käsk `help`. Kõigi võimalike käskude nägemiseks anna käsk `help list`, mõne konkreetse käsu abi nägemiseks käsk `help käsk`.

Käsureal on ka omaenda mälu ehk ajalugu, mis võimaldab uuesti kasutada juba varem antud käske. Ajaloos saab liikuda klahvidega Nool üles ja Nool alla. Varasemate käskude näitamisel valitakse selle argument, mis võimaldab neid kergesti asendada.

### Standardsed käsureakäsud

#### Argumenditüübid

TÕEVÄÄRTUS

  Seda kasutatakse käskude puhul, millega saab midagi sisse või välja lülitada. Väärtusteks võivad olla `on` ('sees'), `off` ('väljas'), `true` ('tõene'), `false` ('väär'), `1` või `0`.

TÄISARV

  Täisarv.

SÕNE

  String, mida ümbritsevad ühekordsed (') või kahekordsed jutumärgid ("), kui see sisaldab tühikuid.

#### Redaktori seadistamise käsud

Neid käske võimaldab kasutada redaktorikomponent ja need on mõeldud ainult aktiivse dokumendi ja vaate seadistamiseks. See on mugav juhul, kui sa ei soovi mingil põhjusel kasutada vaikeseadistusi (näiteks soovid teistmoodi treppida).

    set-tab-widthTÄISARV laius

  Määrab tabelduskoha laiuseks arvu `laius`.

    set-indent-widthTÄISARV laius

  Määrab taande laiuseks arvu `laius`. Ainult sel juhul, kui trepitakse tühikutega.

    set-word-wrap-columnTÄISARV laius

  Määrab sõnamurdmise korral rea laiuseks arvu `laius`. Ainult siis, kui teksti automaatne murdmine on sisse lülitatud.

    set-icon-borderTÕEVÄÄRTUS enable

  Ikoonipiirde näitamine.

    set-folding-markersTÕEVÄÄRTUS enable

  Voltimismärkide paneeli näitamine.

    set-line-numbersTÕEVÄÄRTUS enable

  Reanumbrite paneeli näitamine.

    set-replace-tabsTÕEVÄÄRTUS enable

  Sisselülitamisel asendatakse tabeldusmärgid kirjutamise ajal tühimärkidega.

    set-remove-trailing-spaceTÕEVÄÄRTUS enable

  Sisselülitamisel eemaldatakse rea lõpus seisvad tühimärgid kohe pärast seda, kui kursor lahkub realt.

    set-show-tabsTÕEVÄÄRTUS enable

  Sisselülitamisel näidatakse tabeldusmärke ja rea lõpus seisvaid tühimärke väikeste punktidena.

    set-show-indentTÕEVÄÄRTUS enable

  Sisselülitamisel näidatakse treppimist vertikaalse punktidest reana.

    set-indent-spacesTÕEVÄÄRTUS enable

  Sisselülitamisel trepib redaktor igal treppimistasemel `indent-width`'iga määratud tühikutega, mitte aga tabeldusmärgiga.

    set-mixed-indentTÕEVÄÄRTUS enable

  Sisselülitamisel kasutab &kappname; treppimisel tabeldus- ja tühimärkide segu. Iga treppimistase on laiusega `indent-width` ning täiendavaid treppimistasemeid optimeeritakse nii paljude tabeldusmärkide kasutamisega kui võimalik.kui võimalik.

  Käivitamisel rakendab see käsk ka treppimise tühikumärkidega ning kui taande laius ei ole määratud, määratakse see täitmise ajal kogu dokumendile poole `tab-width` väärtusele.

    set-word-wrapTÕEVÄÄRTUS enable

  Dünaamilise reamurdmise sisselülitamine vastavalt `enable` väärtusele.

    set-replace-tabs-saveTÕEVÄÄRTUS enable

  Sisselülitamisel asendatakse tabeldusmärgid dokumendi salvestamisel tühimärkidega.

    set-remove-trailing-space-saveTÕEVÄÄRTUS enable

  Sisselülitamisel eemaldatakse dokumendi salvestamisel ridade lõpust tühikud.

    set-indent-modeSTRING nimi

  Määrab automaatse treppimise režiimiks väärtuse `nimi`. Kui `nimi` pole tuntud, on režiimiks 'none' ehk 'puudub'. Sobivad režiimid on 'none', 'normal', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' ja 'xml'.

    set-auto-identTÕEVÄÄRTUS skript

  Automaatse treppimise lubamine või keelamine.

    set-highlightSTRING highlight

  Määrab dokumendi süntaksi esiletõstmise süsteemi. Argument peab olema kehtiv esiletõstu nimi, nagu seda näeb näiteks menüüs Tööriistad Esiletõstmine. Käsk võimaldab argumendi lisamisel kasutada automaatset lõpetamist.

    reload-scripts

  Kõigi Kate kasutatud JacaScripti skriptide taaslaadimine, kaasa arvatud treppimis- ja käsureaskriptid.

    set-indent-modeSTRING režiim

  Failitüübi skeemi valimine aktiivsele dokumendile.

    nn[oremap]STRING originaal STRING seostatud

  Klahvijada `originaal` seostamine jadaga `seostatud`.

#### Redigeerimiskäsud

Nende käskudega saab muuta aktiivset dokumenti.

    indent

  Trepib valitud read või aktiivse rea.

    unindent

  Eemaldab valitud ridade või aktiivse rea treppimise.

    cleanindent

  Puhastab valitud ridade või aktiivse rea treppimise vastavalt dokumendi treppimisseadistustele.

    comment

  Lisab kommentaarimärgid, millega muuta valik või valitud read või aktiivne rida kommentaariks vastavalt tekstivormindusele, mille määrab dokumendi süntaksi esiletõstu definitsioon.

    uncomment

  Eemaldab kommentaarimärgid valikult või valitud ridadelt või aktiivselt realt vastavalt tekstivormindusele, mille määrab dokumendi süntaksi esiletõstu definitsioon.

    kill-line

  Kustutab aktiivse rea.

    replace STRING muster STRING asendus

  Asendab teksti, mille määrab `muster`, tekstiga, mille määrab `asendus`. Kui soovid, et `muster` sisaldaks tühimärki, tuleb nii `muster` kui ka `asendus` muuta ühe- või kahekordsete jutumärkidega tsitaadiks. Kui argumendid pole tsiteeritud, arvab käsk, et esimene sõna on `muster` ja ülejäänud `asendus`. Kui `asendus` andmata jätta, eemaldatakse kogu tekst, kus esineb `muster`.

  Otsingule võib lisada lippe, milleks kirjuta koolon ja selle järele vajalik täht või tähed, nii et käsk võtab kuju `replace:võtmed muster asendus`. Kasutada saab järgmisi võtmeid:

  `b`

    Otsing tagasisuunas

  `c`

    Otsing alates kursori asukohast.

  `e`

    Otsing ainult valikus.

  `r`

    Regulaaravaldise otsing. Selle korral võid anda `\N`, kus N on arv, mis tähistab asendusstringi hõivet.

  `s`

    Tõstutundlik otsing.

  `p`

    Loa küsimine järgmise asenduse korral.

  `w`

    Ainult täissõnade sobivus.

    dateSTRING vorming

  Kuupäeva/kellaajastring lisamine kujul, nagu selle määrab `vorming` või kui seda pole antud, siis kujul yyyy-MM-dd hh:mm:ss. Argument `vorming` võib esineda järgmisel kujul:

  `d` | Päev arvuna ilma alustava nullita (1-31).
  `dd` | Päev arvuna alustava nulliga (01-31).
  `ddd` | Lühendatud ja lokaliseeritud päevanimi (nt. 'Esm', 'Püh').
  `dddd` | Pikk ja lokaliseeritud päevanimi (nt. 'Esmaspäev', 'Pühapäev').
  `M` | Kuu arvuna ilma alustava nullita (1-12).
  `MM` | Kuu arvuna alustava nulliga (01-12).
  `MMMM` | Lühendatud ja lokaliseeritud kuunimi (nt. 'Jaan', 'Dets').
  `MMM` | Lühendatud ja lokaliseeritud kuunimi (nt. 'Jaan', 'Dets').
  `yy` | Aasta kahekohalise arvuna (00-99).
  `yyyy` | Aasta neljakohalise arvuna (1752-8000).
  `h` | Tunnid ilma alustava nullita (0-23 või 1-12, kui näidatakse AM/PM).
  `hh` | Tunnid alustava nulliga (00-23 või 01-12, kui näidatakse AM/PM).
  `m` | Minutid ilma alustava nullita (0-59).
  `mm` | Minutid alustava nulliga (00-59).
  `s` | Sekundid ilma alustava nullita (0-59).
  `ss` | Sekundid alustava nulliga (00-59).
  `z` | Millisekundid ilma alustava nullita (0-999).
  `zzz` | Millisekundid alustava nulliga (000-999).
  `AP` | AM/PM kasutamine. AP asemele pannakse kas "AM" või "PM".
  `ap` | am/pm kasutamine. ap asemele pannakse kas "am" või "pm".

    charSTRING identifikaator

  See võimaldab sisestada tähemärke nende numbrilise koodi kaudu kümnend-, kaheksand- või kuueteistkümnendvormis. Selle kasutamiseks käivita redigeerimiskäsu dialoog, kirjuta sisendikasti `char: [number]` ja klõpsa nupule OK.

  ##### `char` näited

  Sisend: `char:234`

  Väljund: `ê`

  Sisend: `char:0x1234`

  Väljund: `ሴ`

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

  See käsk käivitab sedi-sarnase otsi/asenda-operatsiooni aktiivsel real või kogu failis (`%s///`).

  Nii otsitakse tekst läbi, et leida sobivused otsingumustriga, st esimese ja teise kaldkriipsu vahele jääva regulaaravaldisega. Kui sobivus leitakse, asendatakse sobiv tekstiosa avaldisega stringi keskmise ja viimase kaldkriipsu vahel. Sulud otsingumustris tekitavad tagasiviidad, see tähendab, et käsk peab meeles, milline osa sobivusest vastas sulgudes olnule; neid stringe saab otsingumustris uuesti kasutada, viidates neile esimese sulukombinatsiooni puhul kui `\1`, teise puhul kui `\2` jne.

  Otsimaks märki `(` või `)`, tuleb need varjestada längkriipsu kasutades: `\(\)`

  Kui kirjutada avaldise lõppu `i`, ei arvestata sobivuse juures tõstu ehk tähesuurust. Kui kirjutada lõppu `g`, asendatakse kõik mustri sobivused, muidu asendatakse ainult esimene sobivus.

  ##### Teksti asendamine aktiivses reas

  Armas arvuti katkestas just äsja töö ja teatas, et lähtefaili real 3902 mainitud klass `myClass` ei ole defineeritud.

  "Neetud!" mõtled sina: aga muidugi peab see olema `MyClass`. Lähed siis reale 3092 ja selle asemel, et püüda tekstist sõnakest üles leida, käivitad redigeerimiskäsu dialoogi, sisestad seal `s/myclass/MyClass`, vajutad nupule OK, salvestad faili ja kompileerid selle – edukalt ja ilma vigadeta.

  ##### Teksti asendamine kogu failis

  Kujuta ette, et sul on fail, kus esineb mitu korda preili Maasikas, ja siis tuleb keegi, kes ütleb, et too neiu äsja abiellus ja kannab nüüd nime proua Vaarikas. On päris mõistetav, et sind tabab võitmatu iha kirjutada kõikjal tekstis preili Maasikas asemele proua Vaarikas.

  Selleks käivita käsurida, anna käsk `%s/preili Maasikas/proua Vaarikas/`, vajuta klahvi Enter - ja asendused ongi tehtud.

  ##### Nõudlikum näide

  See näide selgitab tagasiviidete ja märgiklasside kasutamist (kui sa ei tea, mis need on, vaata selgitusi edaspidi viidatud dokumentides).

  Oletame, et sul on selline rida:

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

  Äkki taipad, et see pole mitte kõige kaunim kood, ja otsustad kasutada võtit `const` kõigi aadressiargumentide puhul (need on need, mille puhul argumendi ees seisab operaator &). Ühtlasi tahad ühtlustada tühikute kasutamist, nii et iga sõna vahel oleks vaid üks tühik.

  Käivita redigeerimiskäsu dialoog ja sisesta sinna: `s/\s+(\w+)\s+(&)/ const \1 \2/g` ning vajuta nuppu OK. Avaldise lõpus paiknev `g` annab regulaaravaldisele korralduse rekompileerida iga sobivus tagasiviidete säilitamiseks.

  Väljund: `void MyClass::DoStringOps( const String &foo, const String &bar, String *p, const int &a, const int &b )`

  Ja ongi valmis! Mis siis tegelikult juhtus? Juhtus see, et me otsisime tühikut (`\s+`), millele järgneks üks või enam tähte (`\w+`), millele omakorda järgneks tühik (`\s+`) ja sellele omakorda ja-märk. Otsingu käigus salvestasime tähekombinatsioonid ja ja-märgid edasiseks kasutamiseks asendusoperatsioonis. Seejärel asendasime sobinud kohad tühikuga, millele järgneb const, millele järgneb tühik, millele järgneb meelde jäetud tähekombinatsioon (`\1`, millele järgneb tühik, millele järgneb meelde jäetud ja-märk (`\2`). Lihtne, eks ju?

  Pane tähele, et mõnel juhul oli täheühendiks String, mõnel juhul aga int, nii et märgiklassi `\w` ja kvantori `+` kasutamine oli väga mõistlik tegu.

    sort

  Valitud teksti või kogu dokumendi sortimine.

    natsort

  Valitud ridade või kogu dokumendi loomulik sortimine.

  ##### `sort` vs. `natsort`

  ``sort`(a10, a1, a2)` tagastab `a1, a10, a2`

  ``natsort`(a10, a1, a2)` tagastab `a1, a2, a10`

    moveLinesDown

  Valitud ridade liigutamine alla.

    moveLinesUp

  Valitud ridade liigutamine üles.

    uniq

  Topeltridade eemaldamine valitud tekstist või kogu dokumendist.

    rtrim

  Lõputühikute eemaldamine valitud tekstist või kogu dokumendist.

    ltrim

  Algustühikute eemaldamine valitud tekstist või kogu dokumendist.

    joinSTRING eraldaja

  Valitud ridade või kogu dokumendi ühendamine. Lisavõimalusena võib anda parameetri, mis defineerib eraldaja, näiteks: ``join` ', '`

    rmblank

  Kogu tühiruumi eemaldamine valitud tekstist või kogu dokumendist.

    unwrap

  Valitud teksti või kogu dokumendi reamurdmine.

    eachSTRING skript

  Argumendina antud JavaScripti funktsiooni väljakutsumine valitud ridade loendile ja nende asendamine väljakutse tagastatud väärtusega.

  ##### Valitud ridade ühendamine

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

  Või lühemalt:

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

    filterSTRING skript

  Argumendina antud JavaScripti funktsiooni väljakutsumine valitud ridade loendile ja nende eemaldamine, kui väljakutse tagastab 'väär'.

  ##### Tühjade ridade eemaldamine

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

  Või lühemalt:

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

    mapSTRING skript

  Argumendina antud JavaScripti funktsiooni väljakutsumine valitud ridade loendile ja rea asendamine väljakutse väärtusega.

  ##### Tühjade ridade eemaldamine

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

  Või lühemalt:

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

    duplicateLinesUp

  Valitud ridade kloonimine aktiivse valiku kohal.

    duplicateLinesDown

  Valitud ridade kloonimine aktiivse valiku all.

#### Liikumiskäsud

    gotoTÄISARV rida

  Selle käsuga saab liikuda määratud reale.

    grep STRING muster

  Dokumendis regulaaravaldise `mustri` otsimine. Täpsemalt kõneleb sellest

    findSTRING muster

  Selle käsuga saab liikuda sinna, kus esimest korda esineb `muster`. Selle järgmisi esinemisi saab leida menüükäsuga Redigeerimine Otsi järgmine (vaikimisi kiirklahv F3).

  Otsimiskäsku saab täiendavalt seadistada, kui lisada koolon ja selle järele mõni võti, nii et käsk võtab kuju `find:võtmed muster`. Kasutada saab järgmisi võtmeid:

  `b`

    Otsing tagasisuunas

  `c`

    Otsing alates kursori asukohast.

  `e`

    Otsing ainult valikus.

  `r`

    Regulaaravaldise otsing. Selle korral võid anda `\N`, kus N on arv, mis tähistab asendusstringi hõivet.

  `s`

    Tõstutundlik otsing.

  `w`

    Ainult täissõnade sobivus.

    ifindSTRING muster

  See käsk võimaldab otsimist lennult, see tähendab, otse kirjutamise ajal. Selle käitumist või otsingut saab seadistada käsule koolonit ja selle järele mõnda võtit lisades, nii et käsk võtaks kuju `ifind:võtmed muster`. Kasutada saab järgmisi võtmeid

  `b`

    Otsing tagasisuunas

  `r`

    Regulaaravaldise otsing.

  `s`

    Tõstutundlik otsing.

  `c`

    Otsing alates kursori asukohast.

#### Redaktori põhifunktsioonide käsud (need sõltuvad rakendusest, milles redaktorikomponenti kasutatakse)

    w

  Aktiivse dokumendi salvestamine.

    wa

  Kõigi parajasti avatud dokumendite salvestamine.

    q

  Aktiivse dokumendi sulgemine.

    qa

  Kõigi avatud dokumentide sulgemine.

    wq

  Aktiivse dokumendi salvestamine ja sulgemine.

    wqa

  Kõigi parajasti avatud dokumentide salvestamine ja sulgemine.

    x

  Aktiivse dokumendi salvestamine ja sulgemine ainult siis, kui seda on muudetud.

    x

  Kõigi parajasti avatud dokumentide salvestamine ja sulgemine ainult siis, kui neid on muudetud.

    bp

  Liikumine dokumentide nimekirja eelmisele dokumendile.

    bn

  Liikumine dokumentide nimekirja järgmisele dokumendile.

    new

  Uue dokumendi avamine rõhtsalt poolitatud vaates.

    vnew

  Uue dokumendi avamine püstiselt poolitatud vaates.

    e

  Aktiivse dokumendi taaslaadimine, kui seda on kettal muudetud.

    enew

  Uue dokumendi muutmine.

    print

  Trükkimisdialoogi avamine aktiivse dokumendi trükkimiseks.

## Koodi voltimise kasutamine

Koodi voltimine võimaldab peita redaktoris dokumendi osi, muutes nii eriti suured dokumendid lihtsamini jälgitavaks.&kappname; arvutab voltimispiirkondi välja süntaksi esiletõstu definitsioonides antud reeglite põhjal, mistõttu see on kasutatav ainult teatud vormingutes - tavaliselt lähtekoodis, XML-märkekeeles ja muude selliste failide korral. Enamik koodivoltimist toetavaid esiletõstu definitsioone lubab ka kasutajal endal määrata voltimispiirkondi, mida tavaliselt tähistavad võtmesõnad `BEGIN` ja `END`.

Koodivoltimise kasutamiseks lülita sisse voltimismärgid käsuga Vaade Voltimismärkide näitamine. Voltimismärkide paneel vasakus servas näitab graafiliselt voltimispiirkondi, kolmnurgad osutavad antud piirkonnas võimalikele toimingutele: alla suunatud kolmnurk tähendab, et piirkond on avatud ning märgil klõpsamine suleb piirkonna, kusjuures selle asemel kuvatakse paremale osutavat kolmnurka.

Voltimispiirkondades saab kasutada käske, mida tutvustab lähemalt menüükäskude ülevaade.

Kokku keritud read peetakse faili sulgemisel meeles, nii et kui faili taas avad, on kokkukeritud sõlmed endiselt kokku keritud. See kehtib ka taaslaadimise kohta.

Kui sa ei soovi koodivoltimist kasutada, võid eemaldada märke valiku Voltimismärkide näitamine (kui võimalik) eest redaktori seadistuste välimuse kaardil.