# &kwrite; käsiraamat

## Sissejuhatus

&kwrite; on enam kui pelgalt &kde; töölaua tekstiredaktor. See on mõeldud programmeerija redaktoriks ning vähemalt osaliselt alternatiivina võimsamatele redaktoritele. Võimalik, et kõige parem on seda kasutada koos &konqueror;iga erinevates programmeerimiskeeltes kirja pandud lähtefailide sirvimisel. &kwrite; toimib aga väga hästi ka tavalise tekstiredaktorina. Üks &kwrite; peamisi omadusi on süntaksi värviline esiletõstmine vastavalt programmeerimiskeelele (C/C++, &Java;, Python, Perl, Bash, Modula 2, &HTML; ja Ada).

## Mõned põhitõed

&kwrite; kasutamine on ääretult lihtne. Mitte kellelgi, kes üldse kunagi on tekstiredaktoriga kokku puutunud, ei tohiks see üle jõu käia.

### Lohistamine

&kwrite; kasutab &kde; lohistamisprotokolli. Faile võib lohistada &kwrite; tööaknasse töölaualt, &konqueror;ist või ka mõnest &konqueror;i aknas parajasti avatud &FTP; saidilt.

### Käsurea võtmed

Kuigi &kwrite; käivitatakse arvatavasti üldjuhul &kde; rakenduste menüüst või töölaua ikoonilt, saab selle avada ka terminalist käsurealt. Sellisel juhul saab kasutada mitmeid kasulikke võtmeid.

#### Faili määramine

Konkreetse faili asukohta ja nime määrates saab kasutaja panna &kwrite; seda faili kohe käivitumisel avama (või looma). Selline käsk näeb välja selline:

    % kwrite
    /home/minu_kodukataloog/docs/minu_fail.txt

#### Internetis asuva faili määramine

Ülalmainitud meetodit saab kasutada isegi selliste failide avamiseks, mis asuvad internetis (muidugi peab kasutajal parajasti olema ka toimiv ühendus). Seda saab teha umbes sellise käsuga:

    % kwrite
    ftp://ftp.kde.org/pub/kde/Welcome.msg

#### Muud käsurea võtmed

Kasutada saab järgmisi käsurea abivõtmeid

``kwrite` `--help``

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

``kwrite` `--help-qt``

- Näitab võtmeid, mille abil saab muuta &kwrite; ja &Qt; suhtlemist.

``kwrite` `--help-kde``

- Näitab võtmeid, millega saab muuta &kwrite; ja &kde; suhtlemist.

``kwrite` `--help-all``

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

``kwrite` `--author``

- Näitab terminaliaknas &kwrite; autoreid

``kwrite` `--version``

- Näitab &Qt;, &kde; ja &kwrite; versiooni. Sama tulemuse annab käsk ``kwrite` `-v``

``kwrite` `--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 &kwrite;'ile.

``kwrite` `--encoding` `kodeering` `&URL;``

- &kwrite; kasutab dokumendi jaoks määratud kodeeringut.

``kwrite` `--line` `rida` `&URL;``

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

``kwrite` `--column` `veerg` `&URL;``

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

### Kiirklahvid

Enamikku kiirklahve saab seadistada seadistuste menüü abil. Vaikimisi kasutab &kwrite; järgmisi kiirklahve:

Insert | Lülitab lisamis- ja ülekirjutamisrežiimi. Lisamisrežiimis lisatakse iga klaviatuuril sisestatud märk tekstile ning tekstikursorist paremal asuv tekst nihutatakse edasi. Ülekirjutamisrežiimis kirjutab iga sisestatud märk üle tekstikursorist vahetult paremal asuva märgi.
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
&Alt;Page Up | Eelmine järjehoidja
Page Down | Liigutab kursorit ühe lehekülje võrra allapoole
&Alt;Page Down | Järgmine järjehoidja
Backspace | Kustutab kursorist vasakule jääva märgi
Home | Liigutab kursori rea algusesse
End | Liigutab kursori rea lõppu
Delete | Kustutab kursorist paremale jääva märgi (või suvalise valitud teksti)
&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?
F3 | Otsi uuesti
&Shift;F3 | Otsi eelmine
&Ctrl;A | Vali kõik
&Ctrl;&Shift;A | Tühista kõigi valik
&Ctrl;&Shift;B | Blokivaliku režiim
&Ctrl;B | Määrab järjehoidja
&Ctrl;C | Kopeerib märgitud teksti lõikepuhvrisse.
&Ctrl;D | Kommentaar
&Ctrl;&Shift;D | Kommentaari eemaldamine
&Ctrl;F | Otsi
&Ctrl;G | Mine reale...
&Ctrl;I | Valiku treppimine
&Ctrl;&Shift;I | Valiku tagasitreppimine
&Ctrl;J | Ridade ühendamine
&Ctrl;N | Uus dokument
&Ctrl;O | Avab dokumendi
&Ctrl;P | Trükib
&Ctrl;Q | Väljub - sulgeb redaktori aktiivse koopia
&Ctrl;R | Asendab
&Ctrl;S | Rakendab käsku Salvesta.
&Ctrl;U | Suurtähed
&Ctrl;&Shift;U | Väiketähed
&Alt;&Ctrl;U | Sõnaalguse suurtähed
&Ctrl;V | Asetab lõikepuhvri teksti tekstikursori asukohta.
&Ctrl;W | Sulgeb
&Ctrl;X | Kustutab märgitud teksti ja kopeerib selle lõikepuhvrisse.
&Ctrl;Z | Võtab sooritatud tegevuse tagasi
&Ctrl;&Shift;Z | Sooritab viimati tagasi võetud tegevuse uuesti
&Ctrl;- | Kerib ühe kohaliku taseme kokku
&Ctrl;&Shift;- | Kerib tipptaseme kokku
&Ctrl;+ | Avab ühe kohaliku taseme
&Ctrl;&Shift;+ | Avab tipptaseme
F5 | Laeb uuesti
F6 | Ikoonipiirde näitamine/peitmine
F7 | Lülitumine käsureale
F9 | Voltimismärkide näitamine/peitmine
F10 | Dünaamiline reamurdmine
F11 | Reanumbrite näitamine/peitmine

## Menüükirjed

### Menüü Fail

&Ctrl;N Fail Uus

- Avab redaktoris uue dokumendi. Kui parajasti avatud dokumendis on salvestamata muudatusi, küsitakse kasutajalt, kas ta soovib need salvestada.

&Ctrl;O Fail Ava...

- Avab &kde; standardse dialoogi Faili avamine. Vali failivaates fail, mida soovid avada, ning klõpsa nupule Ava. Rohkem infot &kde; dialoogi Faili avamine annab &kde; kasutaja käsiraamat.

Fail Ava hiljutine

- Siin saab kiiresti avada hiljuti salvestatud dokumente. Sellel menüükäsul klõpsates avaneb alammenüü mõne viimati salvestatud failiga. Mõnel neist klõpsates avaneb see &kwrite;'is - kui fail mõistagi on ikka veel samas asukohas ja sama nimega.

&Ctrl;S Fail Salvesta

- Salvestab parajasti avatud dokumendi. Kui see on juba salvestatud, kirjutatakse varasem variant ilma kasutajalt luba küsimata üle. Kui tegemist on uue dokumendi esmakordse salvestamisega, ilmub (allpool kirjeldatav) salvestamisdialoog.

Fail Salvesta kui...

- Võimaldab salvestada dokumendi uue nimega. Seda saab teha failidialoogi abil, mida kirjeldati eespool menüükäsu Ava juures.

F5 Fail Laadi uuesti

- Avab aktiivse faili uuesti kettalt. See on kasuks, kui mõni muu programm või protsess on muutnud faili ajal, mil see oli avatud &kwrite;'is.

&Ctrl;P Fail Trüki...

- Avab lihtsa trükkimisdialoogi, mis võimaldab kasutajal määrata, mida, kuhu ja kuidas trükkida.

Fail Ekspordi HTML-ina...

- Ekspordib faili HTML-vormingusse, et seda saaks vaadata näiteks veebis.

&Ctrl;W Fail Sulge

- Selle käsuga saab sulgeda aktiivse faili. Kui selles on salvestamata muudatusi, küsitakse sinu käest, kas salvestada need, enne kui &kwrite; faili sulgeb.

&Ctrl;Q Fail Välju

- Sulgeb redaktori akna. Kui avatud on enam kui üks &kwrite;'i aken, olgu menüükäsuga Uus vaade või Uus aken, suletakse ainult käesolev aken.

### Menüü Redigeerimine

&Ctrl;Z Redigeerimine Võta tagasi

- Sellega saab tühistada või tagasi võtta viimati sooritatud toimingu või operatsiooni.

&Ctrl;&Shift;Z Redigeerimine Tee uuesti

- Tühistab viimati rakendatud tagasivõtmise käsu ja sooritab vastava toimingu uuesti.

&Ctrl;X Redigeerimine Lõika

- See käsk kustutab parajasti valitud teksti ja asetab selle lõikepuhvrisse. Lõikepuhver on &kde; üks nutikas võimalus, mis tagab taustal töötades võimaluse vahetada andmeid rakenduste vahel.

&Ctrl;C Redigeerimine Kopeeri

- Kopeerib parajasti valitud teksti lõikepuhvrisse, kust selle saab seejärel mujale asetada. Lõikepuhver on &kde; üks nutikas võimalus, mis tagab taustal töötades võimaluse vahetada andmeid rakenduste vahel.

Redigeerimine Kopeeri HTML-ina

- Kopeerib valitud teksti lõikepuhvrisse HTML-ina.

&Ctrl;V Redigeerimine Aseta

- Lisab lõikepuhvri sisu kursori asukohta. Lõikepuhver on &kde; üks nutikas võimalus, mis tagab taustal töötades võimaluse vahetada andmeid rakenduste vahel.

&Ctrl;A Redigeerimine Vali kõik

- Valib kogu dokumendi. See on kasulik näiteks kogu faili kopeerimisel mõnesse muusse rakendusse.

&Ctrl;&Shift;A Redigeerimine Tühista valik

- Tühistab redaktoris teksti valiku (kui esineb).

&Ctrl;&Shift;B Redigeerimine Blokivaliku režiim

- Lülitab valikurežiimi. Kui valikurežiim on BLOKK, siis saab teha vertikaalseid valikud, s.t. valida näiteks ridades 9 kuni 15 veerud 5 kuni 10. Olekuriba näitab valikurežiimi kehtivat olekut: NORM või BLK.

Insert Redigeerimine Ülekirjutamisrežiim

- Lülitab lisamis/ülekirjutamisrežiimi. Esimese ("INS") korral lisatakse märk kursori asukohta. Teise korral ("OVR") asendab märgi sisestamine märgi, mille ees kursor asetseb. Olekuriba näitab valikurežiimi kehtivat olekut: LISAMINE või ÜLEKIRJUTAMINE.

&Ctrl;F Redigeerimine Otsi

- Avab otsimisdialoogi, kus on võimalik määrata dokumendis otsitav tekst. Otsimismustri saab kirjutada väiksesse tekstikasti, mis ühtlasi toimib hüpikkastina. Kasti serval asuvale noolele klõpsates avaneb nimekiri hiljuti kasutatud otsingumustritega. Otsingut saab muuta tõhusamaks mõne lisavõimalusega. Tõstutundlik piirab leitavad kirjed vastavalt sellele, kas nad sobivad täpselt otsingumustris määratud väikeste ja suurte tähtedega. Otsi tagasisuunas sunnib peale otsimise tagant ettepoole. Valitud tekst võimaldab otsida parajasti valitud teksti. Ainult terved sõnad väldib selliste sõnade leidmist, mis vaid sisaldavad otsingumustrit. Kursorist alates alustab otsingut kursori asukohast, mitte aga tavapäraselt dokumendi algusest.

F3 Redigeerimine Otsi järgmine

- Kordab viimast otsimisoperatsiooni (kui see on sooritatud) ilma otsimisdialoogi avamata.

&Shift;F3 Redigeerimine Otsi eelmine

- Kordab viimast otsimisoperatsiooni (kui see on sooritatud) ilma otsimisdialoogi avamata, kuid otsib dokumendis alguse, mitte lõpu poole.

&Ctrl;R Redigeerimine Asenda...

- See käsk avab asendamisdialoogi. Asendamisdialoog on äravahetamiseni sarnane eespool kirjeldatud otsingudialoogiga, kuid siin on lisaks veel ka teksti/hüpikkast Asendatakse järgnevaga:. Selle dialoogi abil saab määrata nii otsitava teksti kui ka teksti, millega leitu asendatakse. Võimaluse Asendamisel küsitakse märkimisel pärib &kwrite; iga kord, kas soovid tõesti leitu asendada.

&Ctrl;G Redigeerimine Mine reale

- Avab reale liikumise dialoogi, mille abil saab kursori liigutada dokumendis konkreetsele (numbriga määratavale) reale. Reanumbri saab sisestada vahetult tekstikasti või kasutada selle määramiseks tekstikasti kõrval asuvaid noolenuppe. Üles osutav nool suurendab, alla osutav nool vähendab reanumbrit. Tekstikastist paremal asub ka liugur, mille abil saab samuti määrata rea, kuhu kursor liigutada.

### Menüü Vaade

Menüüs Vaade saab hallata aktiivsele redaktoriakna spetsiifilis seadistusi ning paneele.

Vaade Uus aken

- Avab uue akna sama tekstiga.

F7 Vaade Lülita käsureale

- Avab akna allservas Kate komponendi käsurea. Abi nägemiseks anna seal käsk "help", kõigi käskude nägemiseks "help list".

Vaade Skeem

- Valib fondiskeemi.

F10 Vaade Dünaamiline reamurdmine

- Tekstiread murtakse vaate nähtavas servas.

F10 Vaade Dünaamiline reamurdmise märkijad

- Võimaldab määrata, millal ja kuidas dünaamilise reamurdmise märkijaid näidata. Seda saab kasutada ainult siis, kui sisse on lülitatud Dünaamiline reamurdmine.

Vaade Staatilise reamurdmise märkija näitamine

- Lülitab sisse või välja püstjoone näitamise, mis osutab reamurdmise veerule, nagu see on kindlaks määratud dialoogi Seadistused Redaktori seadistamine... redigeerimise kaardil. See eeldab, et sa kasutad fikseeritud laiusega fonti.

F6 Vaade Ikoonipiirde näitamine

- See on lülitav element, mille märkimine esitab ikoonipiirde aktiivsest redaktorist vasakul, märkimise tühistamine aga kaotab selle.

F11 Vaade Reanumbrite näitamine

- See on lülitav element, mille märkimine näitab aktiivses redaktoris avatud dokumendist vasakul asuval paneelil reanumbreid, tühistamine aga eemaldab need.

Vaade Kerimisriba märkide näitamine

- Märkimisel näidatakse märke püstisel kerimisribal.

F9 Voltimismärkide peitmine

- Märkimisel peidetakse koodivoltimise märgid.

Koodi voltimine

- Ctrl Shift- Ahenda tipptase

- Kerib kokku kõik dokumendi tipptaseme piirkonnad.

Ctrl Shift+ Laienda tipptase

- Avab kõik dokumendi tipptaseme piirkonnad.

Ctrl - Ahenda üks kohalik tase

- Kerib kokku kursorile lähima piirkonna.

Ctrl + Laienda üks kohalik tase

- Avab kursorile lähima piirkonna.

### Menüü Järjehoidjad

&Ctrl;B Järjehoidjad Sea järjehoidja

- Lisab või eemaldab aktiivse dokumendi aktiivse rea järjehoidja (kui järjehoidja on olemas, siis eemaldab, kui mitte, siis lisab).

Järjehoidjad Kõrvalda kõik järjehoidjad

- See käsk eemaldab dokumendist kõik järjehoidjad, samuti järjehoidjate nimekirja, mis muidu on näha menüü allosas.

Alt Page Up Järjehoidjad Eelmine

- Viib kursori antud reast eespool seisva järjehoidja rea algusse. Menüükirje tekst sisaldab ka reanumbrit ja rea teksti algust. See on kasutatav ainult siis, kui reast, millel kursor asub, eespool on mõni järjehoidja.

Alt Page Down Järjehoidjad Järgmine

- Viib kursori antud reast tagapool seisva järjehoidja rea algusse. Menüükirje tekst sisaldab ka reanumbrit ja rea teksti algust. See on kasutatav ainult siis, kui reast, millel kursor asub, tagapool on mõni järjehoidja.

Menüü allosas on näha kõik antud dokumendi vaates olemasolevad järjehoidjad.

### Menüü Tööriistad

Tööriistad Kirjutuskaitstud režiim

- Määrab aktiivsele dokumendile kirjutuskaitstud režiimi. See väldib igasugust teksti lisamist ja dokumendi vorminduse muutmist.

Tööriistad Failitüüp

- Vali aktiivse dokumendi failitüübi skeem. See tühistab aktiivse dokumendi jaoks globaalse failitüübi, mis on kindlaks määratud dialoogi Seadistused Redaktori seadistamine... failitüüpide kaardil.

Tööriistad Esiletõstmine

- Vali aktiivse dokumendi esiletõstmise skeem. See tühistab aktiivse dokumendi jaoks globaalse esiletõstmise, mis on kindlaks määratud dialoogis Seadistused Redaktori seadistamine...

Tööriistad Treppimine

- Vali aktiivse dokumendi treppimise stiil. See tühistab aktiivse dokumendi jaoks globaalse treppimise, mis on kindlaks määratud dialoogis Seadistused Redaktori seadistamine...

Tööriistad Kodeering

- Vali aktiivse dokumendi kodeering. See tühistab aktiivse dokumendi jaoks vaikekodeeringu, mis on kindlaks määratud dialoogi Seadistused Redaktori seadistamine... kaardil Avamine/Salvestamine.

Tööriistad Rea lõpp

- Vali aktiivse dokumendi rea lõpu stiil. See tühistab aktiivse dokumendi jaoks rea lõpu stiili, mis on kindlaks määratud dialoogis Seadistused Redaktori seadistamine...

Tööriistad Õigekirja kontroll...

- See käivitab õigekirja kontrollimise programmi, mille eesmärk on aidata leida ja parandada valesti kirjutatud sõnu. Kirjel klõpsates ilmub kontrollija aken, kus kasutaja saab määrata, mida ja kuidas parandatakse. Dialoogis on üksteise kohal neli põhiosa, mis ülevalt alla on järgmised:

  Tundmatu sõna:

- Siin näitab õigekirja kontrollija vigaseks peetavat sõna. See tähendab, et seda sõna ei leidu sõnaraamatus ehk failis, mis sisaldab kõigi korrektseid sõnu, millega võrreldakse redaktori tekstis leiduvaid sõnu.

Asendatakse järgnevaga

- Kui kontrollija leiab sõnaraamatust sarnaseid sõnu, näidatakse siin neist esimest. Kasutaja võib pakkumise vastu võtta, kirjutada siia oma variandi või valida allolevast kastist mõne teise pakkumise.

Soovitused:

- Siin näitab õigekirja kontrollija tundmatu sõna võimalikke asendusi, kui leiab neid sõnaraamatust. Mõnel soovitusel klõpsates sisestatakse see ülalolevasse kasti Asendatakse järgnevaga.

Keel:

- Kui sul on paigaldatud mitu sõnaraamatut, saad siin valida, millist keelt/sõnaraamatut kasutada.

Dialoogi paremas servas on viis nuppu, millega kasutaja saab juhtida õigekirja kontrollimist. Need on järgmised:

Lisa sõnaraamatusse

- Sellele nupule klõpsates lisatakse kastis Tundmatu sõna olev sõna sõnaraamatusse. See tähendab, et edaspidi peab õigekirja kontrollija seda sõna õigesti kirjutatuks.

Asenda

- Sellele nupule klõpsates asendatakse tundmatu sõna sõnaga, mis leidub väljal Asendatakse järgnevaga.

Asenda kõik

- Sellele nupule klõpsates ei asendata mitte ainult aktiivne tundmatu sõna, vaid sooritatakse sama asendus ka kõigil järgnevatel tundmatu sõna esinemiskordadel dokumendis.

Ignoreeri

- Sellele klõpsates liigub õigekirja kontrollija järgmise tundmatu sõna juurde ilma praegusega midagi ette võtmata.

Ignoreeri kõiki

- Sellele klõpsates ei võeta midagi ette aktiivse tundmatu sõnaga ning seda ei võeta vaatluse alla ka edaspidi.

  See käib ainult aktiivse kontrollimise kohta. Kui käivitad õigekirja kontrolli kunagi hiljem uuesti, peetakse seda sõna taas vigaseks.

Dialoogi alumises servas asub veel kolm nuppu. Need on järgmised:

Abi

- See avab &kde; abikeskuses &kwrite;'i käsiraamatu (käesoleva dokumendi).

Lõpetatud

- Sellele nupule klõpsates lõpetatakse kontrollimine ja naastakse dokumendi juurde.

Loobu

- Sellele nupule klõpsates lõpetatakse kontrollimine, kõik tehtud muudatused tühistatakse ja naastakse dokumendi juurde.

Tööriistad Õigekirja kontroll (alates kursorist)...

- See käivitab õigekirja kontrollimise mitte dokumendi algusest, vaid kursori hetkeasukohast.

Tööriistad Valiku õigekirja kontroll...

- Kontrollib aktiivse valiku õigekirja.

&Ctrl;I Tööriistad Treppimine

- Suurendab lõigu taandust ühe sammu võrra. Sammu suurus sõltub treppimise seadistustest.

&Ctrl;&Shift;I Tööriistad Tagasitreppimine

- Vähendab lõigu taandust ühe sammu võrra. Sammu suurus sõltub treppimise seadistustest.

Tööriistad Eemalda treppimine

- Eemaldab aktiivse valiku või kursori asukoharea treppimise. Treppimise eemaldamisel rakendatakse kogu valitud tekstile sinu valitud treppimise seadistusi.

Tööriistad Joonda

- Joondab aktiivse rea või valitud read vastavalt treppimise režiimile ja dokumendi treppimise seadistustele.

&Ctrl;D Tööriistad Kommentaar

- Lisab ühe tühiku selle rea algusesse, kus asub tekstikursor, või iga valitud rea algusesse.

&Ctrl;&Shift;D Tööriistad Kommentaari eemaldamine

- Eemaldab ühe tühiku (kui see on olemas) selle rea algusest, kus asub tekstikursor, või kõigi valitud ridade algusest.

&Ctrl;U Tööriistad Suurtähed

- Muudab valitud teksti või kursori järel asuva tähe suurtäheliseks.

&Ctrl;&Shift;U Tööriistad Väiketähed

- Muudab valitud teksti või kursori järel asuva tähe väiketäheliseks.

&Alt;&Ctrl;U Tööriistad Suur algustäht

- Annab valitud teksti sõnadele või aktiivsele sõnale suure algustähe.

&Ctrl;J Tööriistad Ühenda read

- Liidab valitud read või aktiivse rea ja selle järel asuva rea, kasutades eraldajana üht tühimärki. Ühendatud ridade alguses või lõpus olevad tühimärgid eemaldatakse.

Tööriistad Reamurdmine dokumendis

- Rakendab staatilist reamurdmist kogu dokumendile. See tähendab, et teksti uut rida alustatakse automaatselt kohe pärast seda, kui mingi rida ületab pikkust, mis on määratud kindlaks dialoogi Seadistused Redaktori seadistamine... kaardi Redigeerimine valikuga Reamurdmise veerg.

### Menüü Seadistused

Seadistused Tööriistariba näitamine

- Kui see on lubatud, näidatakse liigutatavat tööriistariba, kus leiduvad ikoonid sageli kasutatud käskude jaoks. Kui see ei ole lubatud, tööriistariba ei näidata.

Seadistused Olekuriba näitamine

- Kui see on lubatud, näidatakse redaktori allservas väikest riba, mis sisaldab infot parajasti avatud dokumendi oleku kohta. Kui see ei ole märgitud, on olekuriba peidetud.

Seadistused Asukoha näitamine

- Kui see on lubatud, näidatakse tiitliribal käesoleva dokumendi asukohta failisüsteemis. Kui see ei ole lubatud, asukohta ei näidata.

Seadistused Redaktori seadistamine...

- See menüü avab dialoogi, kus saab kohandada mitmesuguseid seadistusi.

Seadistused Redaktori valik...

- Võimaldab valida tekstiredaktori komponendi, mida &kwrite; kasutab. Valikuteks on Süsteemne vaikeväärtus, Põimitud võimas tekstiredaktor või &Qt; Designerile tuginev tekstiredaktor (pane tähele, et &Qt; Designerile tuginev tekstiredaktor on saadaval ainult siis, kui paigaldatud on KDevelop). Kui valid süsteemse vaikeväärtuse, kasutab &kwrite; &juhtimiskeskus;es langetatud valikut. Kõik muud valikud tühistavad sealvalitu.

Seadistused Kiirklahvide seadistamine...

- See käsk avab dialoogi, kus on võimalik muuta kiirklahve. Ülal asuvas aknas on näha käskude/toimingute nimekiri, millele on kiirklahvid omistatud. Nimekirja all asub kolm raadionuppu: 'Puudub', 'Vaikeväärtus' ja 'Kohandatud'. (Pane tähele, et raadionupud võimaldavad valida ainult ühe pakutavatest võimalustest - selles mõttes sarnanevad nad näiteks autoraadio nuppudega, mis pakuvad korraga ainult ühe eelnevalt määratud jaama. Vaikeväärtus on sealjuures võimalik ainult sellise käsu/toimingu puhul, millel tõepoolest on vaikimisi kasutatav kiirklahv olemas.) Võimaluse 'Kohandatud' valimine aktiveerib dialoogi allosas kolm märkekasti ja klahvinupu. Nüüd saab kasutaja valida märkekasti ja klahvinuppu kasutades antud käsule/toimingule klahvikombinatsiooni. Näiteks käsu '&kde; info' korral võib valida &Ctrl; ja Alt, klõpsata klahvinupul ning vajutada siis klaviatuuril klahvi K. See tähendab, et alati, kui hoitakse all klahve &Ctrl; ja Alt ning vajutatakse klahvi K (&kwrite;'i kasutamise korral mõistagi), avatakse &kde; infot näitav dialoog.

Seadistused Tööriistaribade seadistamine...

- See avab dialoogi, kus saab muuta tööriistaribade väljanägemist. Kasutaja saab valida, millised kiirkorralduste ikoonid on tööriistaribal näha ja millised mitte. Vasakul asuvas aknas on nende käskude nimekiri, mida on võimalik tööriistaribale lisada. Paremal asuvas aknas on nende käskude nimekiri, mis juba asuvad tööriistaribal. Nelja nupuga kahe akna vahel on võimalik valikuid seadistada. Paremale osutav noolenupp viib vasakus aknas valitud käsu paremasse aknasse, s.t. lisab tööriistaribale. Vasakule osutav noolenupp teeb täpselt vastupidist, eemaldades parempoolses aknas valitud käsu tööriistaribalt. Üles ja alla osutavate noolenuppudega saab parempoolses aknas muuta käskude järjekorda, mis ühtlasi muudab ikoonide järjekorda tööriistaribal.

### Menüü Abi

&help.menu.documentation;

## &kwrite;'i seadistamine

Menüükäsk Seadistused Redaktori seadistamine... avab redaktori seadistamise dialoogi. Selle abil saab muuta mitmeid rakenduse seadistusi. See, milliseid seadistusi parajasti muuta saab, sõltub sellest, milline kategooria on dialoogi vasakus servas asuvast nimekirjast valitud. Kasti allosas asuva kolme nupu abil saab kasutaja seadistamisprotsessi juhtida.

Klõpsuga nupul Abi saab avada KDE abikeskuse ning klõpsuga nupul OK või Loobu vastavalt seadistusi rakendada ja dialoog sulgeda või need rakendamata jätta ja ikkagi dialoog sulgeda. Allpool kirjeldame lähemalt kategooriaid Värvid, Fondid, Treppimine, Valimine, Redigeerimine, Õigekiri ja Esiletõstmine.

### Välimus

Reamurdmine

- Dünaamiline reamurdmine

- Selle märkimisel murtakse tekstiread akna nähtava osa piiril.

Dünaamilise reamurdmise indikaatorid

- Siin saab valida, kas dünaamilise reamurdmise indikaatoreid näidatakse või mitte.

Dünaamiliselt murtud ridade püstjoondus taandesügavusele

- See võimaldab joondada dünaamiliselt murtud read püstsuunas esimese rea taandesügavuse järgi. See on abiks koodi või märkekeele muutmisel loetavamaks.

  Lisaks saab siin määrata protsendina akna maksimaalse laiuse, mille ületamise korral dünaamiliselt murtud ridu enam püstsuunas ei joondata. Näiteks 50% valimise korral ei joondata ridu, mis on dünaamiliselt murtud kaugemal kui 50% akna laiusest.

Koodi voltimine

- Voltimismärkide näitamine (kui võimalik)

- Selle märkimisel näitab vaade koodi voltimise tähiseid, kui muidugi koodi voltimine on üldse võimalik.

Piirded

- Ikoonipiirde näitamine

- Märkimise korral näeb vasakus servas ikoonipiiret. See näitab näiteks järjehoidjate tähiseid.

Reanumbrite näitamine

- Märkimise korral näeb vasakus servas reanumbreid.

Kerimisriba märkide näitamine

- Märkimise korral näeb püstisel kerimisribal märke, mis tähistavad näiteks järjehoidjaid.

Järjehoidjate menüü sortimine

- Positsiooni järgi

- Järjehoidjad järjestatakse reanumbrite järgi, millele nad on seatud.

Loomisaja järgi

- Uus järjehoidja lisatakse alati teiste järele sõltumata sellest, millisele kohale dokumendis ta osutab.

Treppimisjoonte näitamine

- Märkimisel näitab redaktor püstjooni, mis aitavad näha treppimise asukohti.

### Fondid ja värvid

Siin saab seadistada kõigi värviskeemide kõiki fonte ja värve, samuti luua uusi skeeme või olemasolevaid kustutada. Igal skeemil on oma värvid, fondid ning tavalise ja esiletõstetud teksti stiilid.

&kwrite; on juba ette valinud parajasti aktiivse skeemi. Kui soovid kasutada mõnda muud skeemi, vali see liitkastist Skeem.

#### Värvid

Tekstiala taust

- Tavaline tekst

- See on redaktoriala vaikimisi taust ja ühtlasi redaktoriala domineeriv värv.

Valitud tekst

- See on valitud teksti taust. Vaikimisi on see globaalne valiku värv, mille määravad kindlaks sinu &kde; värviseadistused.

Praegune rida

- See on aktiivse rea värv. Kui määrata see mõnevõrra erinevaks tavalise teksti värvist, näed paremini, millisel real parajasti viibid.

Järjehoidja

- Selles liitkastis saab määrata mitmesuguste konkreetsete tekstielementide värvi. Siinne värv segatakse vastava rea taustavärviga, nii et rida, milles esineb mitu siinset elementi, võib olla päris kirju. Samu värve kasutatakse ka kerimisriba märkidel, kui nende näitamine on sisse lülitatud.

Lisaelemendid

- Vasaku piirde taust

- Seda märki kasutatakse ikooni-, reanumbrite ja koodivoltimise märkide piirde näitamisel redaktori vasakus servas, kui nende näitamine on sisse lülitatud.

Reanumbrid

- Seda värvi kasutatakse reanumbrite näitamiseks vaate vasakus servas, kui nende näitamine on sisse lülitatud.

Sulgude esiletõst

- Seda värvi kasutatakse ühtekuuluvate sulgude tausta näitamiseks.

Reamurdmise märkijad

- Seda värvi kasutatakse nii püstiselt joondatud dünaamiliselt murtud ridade vasakul pool asuva mustri kui ka staatilise reamurdmise märkija näitamisel.

Tabeldusmärkide märkijad

- Seda värvi kasutatakse tühimärkide tähistamiseks.

#### Fondid

Siin saab valida skeemi fondi. Selleks võib olla mis tahes süsteemis saadaolev font, valida saab ka selle vaikesuuruse. Dialoogi allosas näeb näidisteksti, mis võimaldab kohe näha, kas valik vastab sinu maitsele.

#### Tavalise teksti stiilid

Tavalise teksti stiilid päritakse esiletõstetud teksti stiilidest, mis lubab redaktoril näidata teksti väga ühtlaselt - nii kasutab näiteks kommentaaritekst sama stiili peaaegu kõigis tekstivormingutes, milles Kate üldse suudab teksti esile tõsta.

Nimed stiilide nimekirjas kasutavad nende jaoks määratud stiili, mis lubab kohe näha, milline antud element välja näeb.

Iga stiili puhul saab määrata üldisi atribuute ning esiplaani ja taustavärvi. Taustavärvi tühistamiseks kasuta hiire parema nupuga klõpsates ilmuvat menüüd.

#### Esiletõstetud teksti stiilid

Siin saab muuta konkreetsete esiletõstu definitsioonide korral kasutatavaid stiile. Redaktor valib juba ette esiletõstu, mida kasutab aktiivne dokument. Mõne muut esiletõstu stiilide muutmiseks vali see stiilide nimekirja kohal asuvast liitkastist Esiletõst.

Nimed stiilide nimekirjas kasutavad nende jaoks määratud stiili, mis lubab kohe näha, milline antud element välja näeb.

Iga stiili puhul saab määrata üldisi atribuute ning esiplaani ja taustavärvi. Taustavärvi tühistamiseks kasuta hiire parema nupuga klõpsates ilmuvat menüüd. Lisaks näeb, kas stiil vastab vaikimisi stiilile või mitte, ning soovi korral määrata, kas see peab sellele vastama või mitte.

Kindlasti märkad, et mitmed esiletõstud sisaldavad teisi esiletõste, mida tähistavad rühmad stiilide nimekirjas. Näiteks enamik esiletõste kasutab esiletõstu Alert ning paljud lähtekoodivormingud esiletõstu Doxygen. Nende rühmade värvide muutmine mõjutab aga ainult stiile valitud esiletõstus.

### Kursor ja valimine

Tekstikursori liikumine

- Nutikas kojuminek

- Valimise korral sunnib klahvi Home vajutamine kursori tühimärke eirama ja suunduma rea teksti algusse.

Kursori üleviimine

- Sisselülitamise korral viib liikumine klahvidega Nool vasakule ja Nool paremale kursori rea alguses või lõpus viibimisel korral suunduma eelmisele või järgmisele reale, nagu seda teeb enamik redaktoreid.

  Kui see ei ole sisse lülitatud, ei saa kursorit küll liigutada rea algusest vasakule, küll aga edasi rea lõpust, mis on abiks eriti programmeerijatele.

Page Up/Down liigutab kursorit

- See võimalus muudab kursori käitumist klahvile Page Up või Page Down vajutamisel. Kui see ei ole sisse lülitatud, jätab &kwrite; kursori uue teksti näitamisel suhteliselt samale positsioonile. Kui kursor oli näiteks lehekülje keskel, jääb ta ka klahvile vajutades lehekülje keskele (kui just ei jõuta algusesse või lõppu). Kui see on sisse lülitatud, paneb klahvile vajutamine kursori uuel leheküljel liikuma vastavalt nähtava teksti lõppu või algusesse.

Kursori automaatne tsentreerimine (rida)

- Määrab ridade arvu, mida võimaluse korral näidatakse all- ja ülevalpool kursorit.

Valimise režiim

- Normaalne

- Valik kirjutatakse teksti sisestamisel üle ja läheb kaotsi kursori liikumisel.

Püsiv

- Valik jääb alles ka pärast kursori liikumist ja teksti sisestamist.

### Redigeerimine

Tabeldusmärgid

- Tabeldusmärgid asendatakse tühikutega

- Märkimise korral lisab redaktor klahvi TAB vajutamisel kindla arvu tühikuid vastavalt asukohale tekstis ja määratlusele `TAB laius`.

Tabeldusmärkide näitamine

- Sisselülitamise korral näitab &kwrite; tabeldusmärke visuaalselt punktidena.

  See tähendab ka seda, et alustava või lõpetava tühimärgi asemel näidatakse punkti. See viga parandatakse &kwrite; tulevastes versioonides.

TAB laius

- Kui võimalus Tabeldusmärgid asendatakse tühikutega on sisse lülitatud, määrab see tühikute arvu, millega redaktor tabeldusmärgid automaatselt asendab.

Staatiline reamurdmine

- Reamurdmine paneb redaktori automaatselt alustama uut tekstirida ja liigutama kursori selle uue rea algusesse. &kwrite; alustab automaatselt uut tekstirida, kui käesolev rida jõuab veeruni, mis on määratud võimalusega Reamurdmise veerg.

  Staatilise reamurdmise lubamine

- Lülitab staatilise reamurdmise sisse või välja.

Staatilise reamurdmise märkija näitamine (kui võimalik)

- Lülitab sisse või välja püstjoone näitamise, mis osutab reamurdmise veerule, nagu see on kindlaks määratud dialoogi Seadistused Redaktori seadistamine... redigeerimise kaardil. See eeldab, et sa kasutad fikseeritud laiusega fonti.

Reamurdmise veerg

- Kui reamurdmine on sisse lülitatud, määrab see kirje (tähemärkides) veeru, milleni jõudmisel redaktor automaatselt alustab uut rida.

Lõputühikud eemaldatakse

- &kwrite; eemaldab automaatselt tekstiridade lõpus olevad ülearused tühikud.

Automaatsed sulud

- Kui kasutaja sisestab vasakpoolse sulu ([, ( või {), lisab &kwrite; automaatselt kursorist paremale parempoolse vastava sulu (], ) või }).

Maks. tühistamisi

- Siin saab määrata, mitu sammu jätab &kwrite; tagasivõtmiste tarbeks endale meelde. See tähendab, et mida suurem arv määrata, seda rohkem &kwrite; nende meeleshoidmise jaoks ka mälu kasutab. Kui määrata näiteks 10, saab kasutaja võtta tagasi viimased kümme toimingut, s.t. klõps ikoonile Võta tagasi toimib edukalt kümme korda.

Teksti nutikas otsing kasutab

- Siin saab määrata, millist teksti kasutab &kwrite; otsimisel (seda kasutatakse automaatselt otsimisdialoogis):

  - Eimidagi: otsitavat teksti ei üritata ära arvata.

  - Ainult valikut: olemasolu korral kasutatakse parajasti valitud teksti.

  - Valikut, siis käesolevat sõna: olemasolu korral kasutatakse parajasti valitud teksti, muul juhul aktiivset sõna.

  - Ainult käesolevat sõna: olemasolu korral kasutatakse sõna, milles asetseb parajasti kursor.

  - Käesolevat sõna, siis valikut: olemasolu korral kasutatakse aktiivset, muul juhul aktiivset valikut.

  Pane tähele, et kõigi režiimide korral kasutab otsimisdialoog juhul, kui otsitavat stringi ei ole või seda ei saa tuvastada, viimati kasutatud otsinguteksti.

### Treppimine

Automaatne treppimine

- Treppimise režiim

- Siin saab valida vaikimisi kasutatava automaatse treppimise režiimi. Väga soovitatav on valida siin `Puudub` või `Tavaline` ning määrata failitüübi seadistustes treppimise režiimid erijuhtudeks, näiteks C/C++ koodile või &XML;-ile.

Kirjutamisel lisatakse Doxygeni alustav "*"

- Selle märkimisel lisatakse Doxygeni stiilis kommentaari kirjutamisel automaatselt alustav "*". Seda valikut saab sisse või välja lülitada ainult sobiva režiimi korral.

Treppimine tühikutega

- Tabeldusmärgid asendatakse tühikutega

- Selle valimisel asendatakse tabeldusmärgid tühikutega, mille arvu määrab allpool olev valik Tühikute arv.

Emacsi stiilis segarežiim

- Treppimiseks saab kasutada tabeldusmärke ja tühimärke segiläbi.

Tühikute arv

- Siin saab määrata tühikute arvu, mida kasutatakse, kui ülevalpool on märgitud Tabeldusmärgid asendatakse tühikutega.

Treppimise profiil salvestatakse

- Sisselülitamisel ei eemalda redaktor valikus ridadelt täiendavalt taanet, kui see eemaldatakse vähima taandega realt. Kui mõnikord eemaldad taande treppimist kasutava koodi plokkidelt, võib sellest valikust abi olla.

Liigsed tühikud hoitakse alles

- Treppimisi, mis on tehtud rohkema kui valitud arvu tühikutega, ei lühendata.

Kasutatavad klahvid

- Treppimine tabeldusklahviga

- See võimaldab kasutada treppimisel klahvi TAB.

Treppimine klahviga Backspace

- See võimaldab kasutada treppimisel klahvi Backspace.

Tabeldusklahvi režiim, kui midagi pole valitud

- Lisatakse treppimismärgid

- See lubab klahviga Tab sisestada treppimismärke.

Lisatakse tabeldusmärk

- See lubab klahviga Tab sisestada tabeldusmärgi.

Trepitakse käesolev rida

- See lubab klahviga Tab treppida aktiivse rea.

### Avamine ja salvestamine

Faili vorming

- Kodeering

- See määrab failide vaikimisi kodeeringu.

Rea lõpp

- See määrab aktiivse dokumendi eelistatud rea lõpu režiimi. Võimalikud valikud on &UNIX;, DOS/&Windows; või Macintosh.

Automaatne rea lõpu tuvastamine

- Märkimisel tuvastab redaktor ise automaatselt rea lõpu tüübi. Esimest leitud rea lõpu tüüpi kasutatakse terves failis.

Mälukasutus

- Maks. laetud plokke faili kohta

- Redaktor laeb mällu määratud arvu tekstiplokke (umbes 2048 rida). Kui fail on suurem, puhverdatakse ülejäänud plokid kettale ja laaditakse vajaduse korral.

  See tekitab dokumendis liikumisel väikseid viivitusi: suurem plokkide arv suurendab redigeerimise kiirust, kuid nõuab enam mälu.

  Üldiselt võib siin valida suurima võimaliku plokkide arvu. Seda tasub piirata ainult siis, kui tekib probleeme mäluga.

Automaatne puhastus avamisel/salvestamisel

- Lõputühikud eemaldatakse

- Redaktor eemaldab faili avamisel või salvestamisel automaatselt tekstiridade lõpust liigsed tühikud.

Kataloogi seadistustefail

- Seadistustefaili otsimissügavus

- Redaktor otsib &kwrite;'i seadistustefaili määratud arvu kataloogitasemeid ülespoole ja laeb sellest seadistused.

Salvestamisel tehakse varukoopia

- Salvestamise ajal varukoopia loomise kasutamisel kopeerib &kwrite; selle enne muudatuste salvestamist kettale, andes failile nime <prefiks><failinimi><sufiks>. Sufiks on vaikimisi ~ ning prefiks vaikimisi puudub.

  Kohalikest failidest

- Märkimisel tehakse salvestamisel varukoopia kohalikest failidest.

Võrgufailidest

- Märkimisel tehakse salvestamisel varukoopia võrgufailidest.

Prefiks

- Varundatud failide nime ette lisatav prefiks.

Sufiks

- Varundatud failide nime järele lisatav sufiks.

### Esiletõstmine

Siin pakutavate valikutega saab seadistada iga programmeerimiskeele esiletõstu stiili. Kõik dialoogis tehtavad muudatused kehtivad ainult konkreetse keele puhul.

Esiletõst

- Siin saab valida, millise keele esiletõstu seadistada.

Informatsioon

- Siin näeb valitud keele esiletõstmise reeglite omadusi: autori nime ja litsentsi.

Omadused

- Faili laiendid

- See on faililaiendite nimekiri, millega määratakse kindlaks, milliste failide korral kasutatakse antud süntaksi esiletõstmise režiimi.

MIME tüübid

- Nõustaja nupule klõpsates avaneb dialoog kõigi saadaolevate MIME tüüpidega, kust saab valida vajalikud.

  Automaatselt muudetakse ka faili laiendite valikut.

Prioriteet

- Määrab esiletõstmise reegli prioriteedi.

Laadi alla...

- Sellele nupule klõpsates saab alla laadida uusi või uuendada seniseid süntaksi esiletõstmise definitsioone &kate; veebileheküljelt.

### Failitüübid

Sellel leheküljel saab tühistada konkreetsete MIME tüüpidega dokumentide vaikeseadistused. Kui redaktor avab dokumendi, uuritakse, kas see vastab mõnele defineeritud failimaskile või MIME tüübile ning kui vastab, siis rakendatakse antud tüübile määratud muutujad. Kui sobib mitu failitüüpi, kasutatakse seda, millel on kõrgem prioriteet.

Faili tüüp

- Esimeses hüpikkastis näidatakse kõrgeima prioriteediga failitüüpi. Kui leitakse rohkem failitüüpe, on ka need nimekirjas näha.

  Uus

- Selle nupuga saab luua uue failitüübi. Klõpsamise järel muutuvad allolevad väljad tühjaks ja sa saad need ise vajaliku infoga täita.

Kustuta

- Olemasoleva failitüübi eemaldamiseks vali see hüpikkastist ja klõpsa nupule Kustuta.

Aktiivse failitüübi omadused

- Esimeses hüpikkastis näidatakse kõrgeima prioriteediga failitüüpi. Kui leitakse rohkem failitüüpe, on ka need nimekirjas näha.

  Nimi

- See on nimi kujul, nagu seda näidatakse menüüs Tööriistad Failitüübid.

Sektsioon

- See on sektsiooni nimi kujul, nagu seda näidatakse menüüs Tööriistad Failitüübid.

Muutujad

- Selle stringiga saab muuta &kwrite;'i seadistusi antud MIME tüübiga failide korral, kasutades selleks &kwrite;'i muutujaid. Siin saab määrata peaaegu kõiki asju, näiteks esiletõst, treppimise režiim, kodeering jne.

  Kõigi muutujate täieliku nimekirja toob ära käsiraamat.

Faili laiendid

- Metamärke kasutades saab valida faile nime järgi. Tüüpiline metamärgimask kasutab tärni ja faililaiendit, näiteks `*.txt; *.text`. String koosneb semikooloniga eraldatud maskide nimekirjast.

MIME tüübid

- Avab nõustaja, kust saab valida MIME tüübid.

Prioriteet

- Määrab antud failitüübi prioriteedi. Kui fail sobib mitme failitüübiga, kasutatakse seda, millel on kõrgem prioriteet.

### Kiirklahvid

Siin saab muuta kiirklahve. Vali toiming ja klõpsa Kohandatud, kui soovid antud toimingu kiirklahvi muuta.

Otsingureal saab otsida vajalikku toimingut ja näha sellega seotud kiirklahvi.

### Pluginad

Sellel leheküljel on näha kõik saadaolevad pluginad ning siin saab märkida, milliseid neist kasutada, milliseid mitte. Märkimise korral saab tarvitada nuppu Seadista ning vastavat pluginat seadistada.

## Autorid ja litsents

&kwrite; autoriõigus 2001: &kate; meeskond.

Aluseks on algupärane &kwrite;, mille autoriõigus 2000: Jochen Wilhelmy digisnap@cs.tu-berlin.de

Kaasautorid:

- &Christoph.Cullmann; &Christoph.Cullmann.mail;

- Michael Bartl michael.bartl1@chello.at

- Philip philip_cpp@my-deja.com

- &Anders.Lund; &Anders.Lund.mail;

- Matt Newell newell@proaxis.com

- &Joseph.Wenninger; &Joseph.Wenninger.mail;

- Jochen Wilhelmy digisnap@cs.tu-berlin.de

- &Michael.Koch; &Michael.Koch.mail;

- &Christian.Gebauer; &Christian.Gebauer.mail;

- &Simon.Hausmann; &Simon.Hausmann.mail;

- Glen Parker glenebob@nwlink.com

- Scott Manson sdmanson@altel.net

- &John.Firebaugh; &John.Firebaugh.mail;

Algupärane dokumentatsioon: &Thad.McGinnis; &Thad.McGinnis.mail;

Uuendasid: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; ja &Anders.Lund; &Anders.Lund.mail;

Selle &kwrite;'i käsiraamatu versiooni aluse autor on &Cristian.Tibirna; &Cristian.Tibirna.mail;

Teisendas docbook-vormingusse ja korrigeeris &Lauri.Watts; &Lauri.Watts.mail;

Tõlge eesti keelde: Marek Laane bald@starman.ee

&underFDL; &underGPL;
&documentation.index;