# Põhitõed

Kui sa oled kunagi tekstiredaktorit kasutanud, ei tohiks &kate; kasutamine mingeid raskusi valmistada. Kahes järgmises sektsioonis &kate; käivitamine ja Töö &kate;ga) selgitatakse kõike, mida läheb tarvis &kate; kiireks ja muretuks käivitamiseks ja kasutamiseks.

## &kate; käivitamine

&kate; on võimalik käivitada &kmenu;st või käsurealt.

### Menüüst

Ava &kde; programmimenüü klõpsuga ekraani all vasakul servas asuval ikoonil, millel on kujutatud suur K. See toob esile programmimenüü. Liigu hiirega menüükirjele Rakendused Utiliidid Võimas tekstiredaktor &kate;.

### Käsurealt

&kate; on võimalik käivitada lihtsalt seda käsureale kirjutades. Kui lisad ka failinime, nagu seda on tehtud allpool toodud näites, avatakse või luuakse nimetatud fail.

    %kate minufail.txt.

Kui sul on aktiivne internetiühendus ja vastavad õigused, võid kasutada &kde; suurepäraseid võrguomadusi ning avada ka faile võrgust.

    %kate ftp://ftp.kde.org/pub/kde/README

#### Käsurea võtmed

&kate; tunnustab järgmisi käsurea võtmeid:

``kate` `--help``

- Näitab peamisi võtmeid, mida käsurea puhul saab kasutada.

``kate` `--help-qt``

- Näitab võtmeid, mida saab kasutada &kate; ja &Qt; suhtlemise muutmiseks.

``kate` `--help-kde``

- Näitab võtmeid, mida saab kasutada &kate; ja &kde; suhtlemise muutmiseks.

``kate` `-s` `--start` `nimi``

- Käivitab Kate seansiga `nimi`. Kui seanssi ei ole, see luuakse. Kui määratud seansiga &kate; eksemplar on olemas, laaditakse sellesse määratud failid. Kasutamisel võtmega `--use` saab kasutada ka antud seansi eksemplari.

``kate` `-u` `--use` `URL``

- Paneb &kate; kasutama olemasolevat isendit, kui see on olemas. See on nüüd vaikekäitumine, kuid valik on ühilduvuse huvides alles jäetud.

``kate` `-p` `--pid` `PID``

- Võtab uuesti kasutusele ainult määratud PID-iga (protsessi ID) protsessi. Seda kasutatakse koos võtmega `--use`.

``kate` `-e` `--encoding` `kodeering` `URL``

- Kasutab dokumendi jaoks määratud kodeeringut.

``kate` `-l` `--line` `rida` `URL``

- Liigub dokumendi avamise järel määratud reale.

``kate` `-c` `--column` `veerg` `URL``

- Liigub dokumendi avamise järel määratud veergu.

``kate` `-i` `--stdin``

- Loeb dokumendi sisu standardsisendist (stdin). See on samasugune mitmes käsureaprogrammis kasutatava võtmega `-` ning lubab saata näiteks käsu väljundi toru kaudu &kate;le.

``kate` `--startanon``

- &kate; käivitamine uue anonüümse seansiga, eeldab võtit `-n`.

``kate` `-n` `--new``

- Uue &kate; protsessi jõuga käivitamine (eiratakse, kui kasutatud on võtit `start` ning teises &kate; protsessis on antud seanss juba avatud), mis sunnitakse peale, kui pole antud ühtegi parameetrit ega URL-i.

``kate` `-b` `--block``

- Juba töötava &kate; protsessi kasutamisel blokeeritakse väljumiseni, kui antud URL-id avatakse.

  Selle võtmega saab &kate;t kasutada redaktorina sissekandesõnumi kirjutamiseks mõnes versioonihaldussüsteemis, näiteks Git või Subversion. Need süsteemid eeldavad, et redaktor on blokeeritud, kuni oled sisestanud oma sõnumi, sest nad avavad ajutise faili, mis oleks aga tühi, kui Kate otsekohe tagasi pöörduks.

  Seda võtit on vaja ka KIO (&kde; sisend/väljund) puhul, kui avad võrgufaili (mis laaditakse alla ajutise failina), mis tuleb pärast salvestamist uuesti üles laadida.

``kate` `--tempfile``

- See &kde; standardvalik on toetatud alates &kate; versioonist 2.5.1. Kasutamise korral koheldakse määratud faile ajutiste failidena, mis kustutatakse (kui tegemist on kohalike failidega ja sul on vastavad õigused) pärast sulgemist, kui neid just ei ole pärast avamist muudetud.

``kate` `--help-all``

- Näitab kõiki käsurea võtmeid.

``kate` `--author``

- Näitab terminalis &kate; autoreid.

``kate` `-v` `--version``

- Näitab &Qt;, &kde; ja &kate; versiooniinfot.

``kate` `--license``

- Näitab infot litsentsi kohta.

### Lohistamine

&kate; kasutab &kde; lohistamisprotokolli. Faile võib lohistada &kate;sse töölaualt, failihaldurist &dolphin; või mõnelt võrgus asuvalt ftp-saidilt, mis on avatud ühes &dolphin;i aknas.

## &kate; kasutamine

Kiirstart selgitab, kuidas kasutada nelja lihtsat võimalust, mis lubavad sul seadistada kiiresti ja hõlpsalt mõned &kate; kõige võimsamad võimalused. Klahvikäsud toovad ära mõned vaikimisi kiirklahvid ja klahvikombinatsioonid neile, kes ei saa või ei taha kasutada hiirt.

### Kiirstart

See sektsioon kirjeldab mõningaid elemente menüüs Vaade, mis võimaldab sul kiiresti kohandada &kate; just selliseks, nagu soovid.

Kui käivitad &kate; esimest korda, näed valgel taustal kaht akent. Nende kohal asub tööriistariba tavapäraselt pealdistatud ikoonidega ja omakorda selle kohal menüüriba.

Vasakpoolne aken on külgriba, mis ühendab endas dokumentide ja failisüsteemi sirvija aknad. Nende kahe vahel saab liikuda klõpsuga akna vasakus servas paiknevatel sakkidel.

Kui käivitasid &kate; faili avades, näitab parempoolne aken redigeeritavat faili ning dokumentide nimekiri külgribal failinime. Failide avamiseks saab kasutada failisüsteemi sirvijat.

Dokumentide ja failisüsteemi sirvija näitamise saab lubada või keelata menüüs Vaade Tööriistavaated. See menüü pakub ka esimese pilguheidu &kate; võimsuse ja paindlikkuse kohta. Praeguses sektsioonis vaatleme kolme elementi:

Dokumentide näitamine

- Lülitab dokumentide nimekirja näitamise sisse ja välja. Kui dokumentide nimekirja/failisüsteemi sirvija aken ei ole avatud, käivitab &kate; külgriba eraldi, dokkimata aknas. Selle dokkimiseks napsa kahest peenest paralleelsest joonest sakkide kohal, klõpsates neil &HVNga; ja hoides nuppu all. Lohista aken &kate; redigeerimisaknasse ja vabasta &HVN;, kui oled asetanud dokumentide nimekirja/failisüsteemi sirvija akna sinna, kuhu soovisid.

  Kui oled edukalt napsanud paralleeljoontest, muutub hiirekursor lohistamise ajal kaheks ristamisi nooleks.

Failisüsteemi sirvija näitamine

- Lülitab failisüsteemi sirvija näitamise sisse ja välja. See on muidu samasuguse toimega nagu Dokumentide näitamine, ainult et selle lülitamine käivitab akna, kus on avatud failisüsteemi sirvija.

Terminali näitamine

- Lülitab sisse ja välja terminaliemulaatori näitamise &kate; akna alaosas. Teisisõnu annab see sulle võimaluse kasutada rakenduse sees käsurida.

### Klahvikäsud

Paljud &kate; klahvikäsud (kiirklahvid) on seadistatavad menüüst Seadistused. Vaikimisi tunnustab &kate; järgmisi klahvikäske.

Insert | Vahetab lisamis- ja ülekirjutamisrežiimi. Lisamisrežiimis lisab redaktor iga kirjutatud märgi tekstile, nihutades varem sisestatud teksti kursorist paremale. Ülekirjutamisrežiimis põhjustab iga märgi sisestamine kursorist vahetult paremale jääva märgi ülekirjutamise.
Nool vasakule | Liigutab kursorit ühe märgi võrra vasakule
Nool paremale | Liigutab kursorit ühe märgi võrra paremale
Nool üles | Liigutab kursorit ühe rea võrra ülespoole
Nool alla | Liigutab kursorit ühe rea võrra allapoole
Page Up | Liigutab kursorit ühe lehekülje võrra ülespoole
Page Down | Liigutab kursorit ühe lehekülje võrra allapoole
&Backspace; | Kustutab kursorist vasakule jääva märgi
Home | Liigutab kursori rea algusesse
End | Liigutab kursori rea lõppu
Delete | Hävitab kursorist paremale jääva märgi (või suvalise valitud teksti)
&Shift;&Enter; | Reavahetuse lisamine, kaasa arvatud aktiivse rea algusmärgid, mis ei ole tähed ega arvud. See on kasulik näiteks kommentaaride kirjutamiseks koodis. Rea // mingi tekst lõpus vajuta kiirklahvi ning järgmise rea algusse lisataksegi kohe // . Nii ei ole vaja kommentaaris uut rida alustades endal iga kord kommentaarimärke sisestada.
&Shift;Nool vasakule | Märgib teksti ühe märgi võrra vasakule
&Shift;Nool paremale | Märgib teksti ühe märgi võrra paremale
F1 | Abi
&Shift;F1 | Mis see on?
&Ctrl;F | Otsi
F3 | Otsi uuesti
&Ctrl;B | Seab järjehoidja
&Ctrl;C | Kopeerib märgitud teksti lõikepuhvrisse.
&Ctrl;N | Uus dokument
&Ctrl;P | Trükib
&Ctrl;Q | Väljub - sulgeb redaktori aktiivse koopia
&Ctrl;R | Asendab
&Ctrl;S | Salvestab faili.
&Ctrl;V | Asetab.
&Ctrl;X | Kustutab märgitud teksti ja kopeerib selle lõikepuhvrisse.
&Ctrl;Z | Võtab tegevuse tagasi.
&Ctrl;&Shift;Z | Teeb tegevuse uuesti

## Seansside kasutamine

Seanssidega saab &kate; talletada enam kui ühe failide nimekirja ja kasutajaliidese seadistuste komplekti. Sa võid luua nii palju seansse, kui vähegi soovid, andes neile nime, aga võid kasutada ka nimetuid ehk anonüümseid seansse failide korral, mida ainult korra tahadki avada. Praegu võib &kate; salvestada seansi tarbeks avatud failide nimekirja ja akna üldise seadistuss. Tulevikus võib &kate; seanssides salvestada ehk isegi rohkem infot. Seansid lubavad &kate;l avada ka suvalise arvu rakenduse protsesse erinevalt varasemast, mil oli võimalik kasutada ainult üht protsessi.

Seansse saab kasutada kolmel moel:

- käsureavõtmed lubavad valida ja käivitada seansse Kate avamisel käsurealt.

- menüü Seansid lubab seansside vahel lülituda, neid salvestada, käivitada ja hallata.

- seadistusvalikud lubavad kindlaks määrata seansside üldise käitumise.

Uue seansi avamisel laaditakse vaikimisi seanss vastava graafilise kasutajaliidesega. Vaikeseansi akna seadistuste salvestamiseks tuleb vastav valik seansiseadistuste kaardil sisse lülitada, avada seejärel vaikimisi seanss, anda aknale vajalik ilme ja salvestada seejärel seanss.

Nimega seansi avamisel näitab &kate; seansi nime akna tiitli alguses, nii et sellel on kuju "`Seansi nimi`: `dokumendi nimi või &URL;` - &kate;"

Failide avamisel käsurealt võtmega `--start `nimi`` või seansivalijast seansi valimisel laaditakse määratud seanss enne käsureal valitud failide avamist. Failide avamiseks käsurealt uues nimetus seansis seadista Kate käivitama vaikimisi uut seanssi seadistustedialoogi seansside kaardil või kasuta käsureal võtit `--start` tühja stringiga `''`.

Alates &kate; versioonist 2.5.1 eksporditakse aktiivse eksemplari PID keskkonnamuutujasse `KATE_PID`. Failide avamisel Kate sisemisest terminalist valitakse automaatselt aktiivne eksemplar, kui käsureal pole teisiti määratud.

### &kate; endise käitumise taastamine

Kui harjud veidi seanssidega, näed usutavasti, et need annavad sinu käsutusse väga lihtsa, ent väga tõhusa vahendi oma töö korraldamiseks. Kui sulle peaks aga olema südamelähedasem &kate; varasem käitumine (üks protsess kõigi failide avamiseks), saab seda samuti hõlpsasti teha:

- Käivita Kate alati parameetriga `--use`, lisades selle rakenduste seadistustes käsule või ka vastavat shellialiast kasutades.

- Seadista &kate; käivitamisel avama viimati kasutatud seanssi.

- Seadista &kate; seansi sulgemisel salvestama failide nimekieja.

- Laadi üks kord vaikeseanss

## Abi saamine

### &kate; puhul

See käsiraamat

- Pakub üksikasjalikku infot kõigi menüükäskude, seadistusvõimaluste, tööriistade, dialoogide, pluginate jne kohta, samuti kirjeldab &kate; akent, redaktorit ning mitmesuguseid rakenduses kasutatud põhimõtteid.

  Käsiraamatu uurimiseks vajuta F1 või kasuta menüükäsku Abi &kate; käsiraamat.

Mis see on?

- See võimalus pakub vahetut abi graafilise akna elementide, näiteks nuppude või ka muude elementide kohta.

  Me oleme püüdnud pakkuda seda abivõimalust iga elemendi kohta, mille puhul see vähegi mõttekas tundub. See on kättesaadav kõikjal seadistustedialoogis ning ka paljudes dialoogides.

  Kasutamaks abivõimalust "Mis see on?", vajuta &Shift;F1 või kasuta menüükäsku Abi Mis see on?. Seejärel muutub hiirekursor küsimärgiga nooleks ning sa võid klõpsata suvalisel aknaelemendil, et lugeda, mis see siis ikkagi on, seda muidugi juhul, kui abivõimalus on selle elemendi puhul kasutusel.

Abinupud dialoogides

- Mõnel dialoogil on olemas nupp Abi. Sellele vajutamine käivitab &abikeskus;e ning avab vastava dokumendi.

### Tekstifailide puhul

&kate; ei paku (veel!) mingeid võimalusi lugeda dokumendiga seotud dokumentatsiooni. Sõltuvalt redigeeritavast failist võib sisseehitatud terminaliemulaator olla päris kasulik &UNIX;i manuaalilehekülgede või infodokumentide lugemisel, samuti saab kasutada &konqueror;i.

### Artiklid &kate; kohta

&kate; kodulehekülg pakub mõningaid artikleid ja õpetusi teabega, mis väljuvad käesoleva käsiraamatu piiridest.