<chapter id="kate-part">

<title
>Töö &kate; redaktoriga</title>

<sect1 id="kate-part-overview">

<title
>Ülevaade</title>

<para
>&kate; redaktor kujutab endast &kate; akna redigeerimisala. Sama redaktorit kasutab ka &kwrite; ning seda võib kautada ka &konqueror;is tekstifailide näitamiseks, asugu need sinu arvutis või kuskil võrgus.</para>

<para
>Redaktor koosneb järgmistest komponentidest:</para>

<variablelist
> <varlistentry
> <term
>Redigeerimisala</term
> <listitem
><para
>See on koht, kus asub dokumendi tekst.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Kerimisribad</term
> <listitem
> <para
>Kerimisribad osutavad dokumendi teksti nähtava osa asukohale ning neid saab kasutada dokumendis liikumiseks. Kerimisriba kasutamine ei põhjusta siiski automaatselt kursori asukoha muutust.</para
> <para
>Kerimisribasid võib soovikohaselt näidata või varjata.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Ikoonipiire</term
> <listitem
> <para
>Ikoonipiire on väike riba redaktorist vasakul, mis näitab märgitud ridade kõrval väikest ikooni.</para
> <para
>Nähtava rea <link linkend="kate-part-bookmarks"
>järjehoidja</link
> saab paigaldada või eemaldada hiire vasaku nupu klõpsuga rea kõrval asuval ikoonipiirdel.</para
> <para
>Ikooniriba saab näidata või varjata menüükäsuga <menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Näita ikoonipiiret</guimenuitem
></menuchoice
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Reanumbrite paneel</term
> <listitem
> <para
>Reanumbrite paneel osutab dokumendi kõigi nähtavate ridade numbreid.</para
> <para
>Reanumbrite paneeli saab näidata või varjata menüükäsuga <menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Näita reanumbreid</guimenuitem
></menuchoice
>.</para
> </listitem
> </varlistentry
> </variablelist>

<itemizedlist
> <title
>Selles peatükis räägitakse veel:</title
> <listitem
><para
><link linkend="kate-part-navigation"
>Tekstis liikumisest</link
> </para
></listitem
> <listitem
><para
><link linkend="kate-part-selection"
>Tööst valikutega</link
></para
></listitem
> <listitem
><para
><link linkend="kate-part-copy-and-paste"
>Teksti kopeerimisest ja asetamisest</link
></para
></listitem
> <listitem
><para
><link linkend="kate-part-find-replace"
>Teksti otsimisest ja asendamisest</link
></para
></listitem
> <listitem
><para
><link linkend="kate-part-bookmarks"
>Järjehoidjate kasutamisest</link
></para
></listitem
> <listitem
><para
><link linkend="kate-part-auto-wrap"
>Teksti automaatsest reamurdmisest</link
></para
></listitem
> </itemizedlist>

</sect1>

<sect1 id="kate-part-navigation">
<title
>Tekstis liikumisest</title>

<para
>See sektsioon ei ole veel dokumenteeritud.</para>

</sect1>

<sect1 id="kate-part-selection">
<title
>Tööst valikutega</title>

<para
>&kate;s saab teksti valida kahel viisil: hiire ja klaviatuuri abil.</para>

<para
>Hiirt eelistades hoia all hiire vasak nupp ja libista hiirekursor kohast, kust soovid valikut alustada, kohani, kus soovid selle lõpetada. Selle operatsiooniga ongi tekst valitud.</para>

<para
>Topeltklõps sõnal valib selle sõna.</para>

<para
>Kolmikklõps real valib terve rea.</para>

<para
>Kui klõpsamise ajal hoida all klahvi &Shift;, valib see teksti järgmiselt:</para>

<itemizedlist
> <listitem
><para
>kui midagi ei olnud valitud, siis teksti sisestuskursori asukohast hiirekursori asukohani.</para
></listitem
> <listitem
><para
>kui midagi oli juba valitud, siis seal alates (kaasa arvatud valitu) hiirekursori asukohani.</para
></listitem
> </itemizedlist>

<note
> <para
>Kui teksti valitakse hiirt lohistades, kopeeritakse valitud tekst lõikelauale ja seda saab asetada, klõpsates hiire keskmise klahviga redaktoris või mõnes muus rakenduses, kuhu soovid teksti asetada. </para
> </note>

<para
>Klaviatuuri eelistades hoia alla klahvi &Shift; ning rakenda liikumisklahve (nooleklahvid ning klahvid <keycap
>Page Up</keycap
>, <keycap
>Page Down</keycap
>, <keycap
>Home</keycap
> ja <keycap
>End</keycap
>). Võimalik on ka kombinatsioon klahviga &Ctrl;, mis laiendab tekstikursori liikumist.</para>

<para
>Vaata ka samas peatükis sektsiooni <link linkend="kate-part-navigation"
>Tekstis liikumisest</link
>.</para>

<para
>Sooritamaks aktiivse valiku <action
>Kopeerimine</action
>, kasuta menüükäsku <menuchoice
><guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Kopeeri</guimenuitem
></menuchoice
> või kiirklahvikombinatsiooni (vaikimisi <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>).</para>

<para
>Andmaks käsku <action
>Tühista valik</action
>, kasuta menüükäsku <menuchoice
><guimenu
>Redigeeri</guimenu
> <guimenuitem
>Tühista valik</guimenuitem
></menuchoice
>, kiirklahvikombinatsiooni (vaikimisi <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>A</keycap
></keycombo
>) või klõpsa redaktoris hiire vasaku nupuga.</para>

<sect2 id="kate-part-selection-block">
<title
>Blokivaliku kasutamine</title>

<para
>Kui blokivalik on sisse lülitatud, saad sooritada tekstis <quote
> vertikaalseid valikuid</quote
>, mis tähendab teatud arvu veergude valimist mitmes reas. See võib olla kasulik näiteks tabulaatori abil eraldatud ridade puhul.</para>

<para
>Blokivalikut saab sisse/välja lülitada menüükäsuga <menuchoice
><guimenu
>Redigeeri</guimenu
> <guimenuitem
>Blokivaliku lülitamine</guimenuitem
></menuchoice
>. Vaikimisi kiirklahv on <keycap
>F4</keycap
>.</para>

</sect2>

<sect2 id="kate-part-seleciton-overwrite">

<title
>Valiku ülekirjutamine</title>

<para
>Kui valiku ülekirjutamine on sisse lülitatud, põhjustab kirjutamine või teksti asetamine valitud teksti alal selle asendamise. Kui see ei ole sisse lülitatud, lisatakse uus tekst tekstikursori asukohta.</para>

<para
>Vaikimisi on valiku ülekirjutamine sisse lülitatud.</para>

<para
>Selle võimaluse muutmiseks kasuta <link linkend="config-dialog"
>seadistustedialoogi</link
> lehekülge <link linkend="config-dialog-editor-select"
>Valimine</link
>.</para>

</sect2>

<sect2 id="kate-part-selection-persistent">

<title
>Püsiva valiku kasutamine</title>

<para
>Kui püsiv valik on sisse lülitatud, ei põhjusta märkide sisestamine või kursori liigutamine valiku tühistamist. See tähendab, et kursori võib liigutada valitud alalt mujale ja asuda teksti sisestama.</para>

<para
>Vaikimisi on püsiv valik välja lülitatud.</para>

<para
>Püsiva valiku saab sisse lülitada <link linkend="config-dialog"
>seadistustedialoogi</link
> leheküljel <link linkend="config-dialog-editor-select"
>Valimine</link
>.</para>

<warning>
<para
>Kui sisse on lülitatud nii püsiv valik kui valiku ülekirjutamine, põhjustab kirjutamine või teksti asetamine juhul, kui kursor asetsed valitud alal, nii teksti asendamist kui valiku tühistamist.</para>
</warning>

</sect2>

</sect1>

<sect1 id="kate-part-copy-and-paste">

<title
>Teksti kopeerimisest ja asetamisest</title>

<para
>Teksti kopeerimiseks vali see ja kasuta menüükäsku <menuchoice
><guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Kopeerimine</guimenuitem
></menuchoice
>. Teksti valimine hiirega põhjustab samuti selle kopeerimise lõikelauale.</para>

<para
>Lõikelaual asetseva teksti asetamiseks kasuta menüüksäku <menuchoice
><guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Asetamine</guimenuitem
></menuchoice
>.</para>

<para
>Lisaks võib hiirega valitud teksti asetada, kui sooritada soovitud kohas klõps <mousebutton
>keskmise</mousebutton
> hiireklahviga.</para>

<tip
> <para
>Kui kasutad &kde; töölauda, võid asetada suvalises rakenduses varem kopeeritud teksti, kasutades &kicker;i ikooni &klipper;.</para
> </tip>

</sect1>

<sect1 id="kate-part-find-replace">
<title
>Teksti otsimisest ja asendamisest</title>

<sect2 id="find-replace-dialog">
<title
>Dialoogid <guilabel
>Leia tekst</guilabel
> ja <guilabel
>Asenda tekst</guilabel
></title>


<para
>Teksti leidmise ja asendamise dialoogid on &kate;s üsna sarnased teistele analoogilistele dialoogidele, erinevuseks see, et teksti asendamise dialoog pakub võimalust sisestada asendatav tekst koos mõne lisavõtmega.</para>

<para
>Dialoogid pakuvad järgmisi tavapäraseid võimalusi:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Otsitav tekst</guilabel
></term
> <listitem
><para
>Siia saab sisestada otsimisstringi. Selle tõlgendamine sõltub mõningatest edaspidi kirjeldatavatest võimalustest.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Regulaaravaldis</guilabel
></term
> <listitem
> <para
>Kui see on märgitud, tõlgendatakse otsimisstringi regulaaravaldisena ning lülitatakse sisse nupp avaldise loomise või muutmise graafilise tööriista kasutamiseks.</para
> <para
>Vaata lähemalt peatükki <link linkend="regular-expressions"
>Regulaaravaldised</link
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tõstutundetu</guilabel
></term
> <listitem
> <para
>Kui see on sees, ei tee otsing suur- ja väiketähtedel vahet.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Ainult terved sõnad</guilabel
></term
> <listitem
> <para
>Kui see on märgitud, otsitakse ainult selliseid vasteid, mille puhul otsimisstringile vastab mõlemalt poolt eristatav sõna, mis ei tähenda tärki - ei mingit nähtavat märki ega realõppu.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Algusest</guilabel
></term
> <listitem
> <para
>Kui see on märgitud, algab otsing dokumendi esimesest reast, vastasel juhul kursori asukohast.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Otsi tagasisuunas</guilabel
></term
> <listitem
> <para
>Kui see on märgitud, püüab otsing leida esimest sobivust enne alguspunkti, milleks võib olla kursori asukoht või dokumendi algus, kui märgitud on ka võimalus <guilabel
>Algusest</guilabel
>.</para
> </listitem
> </varlistentry
> </variablelist>

<para
>Dialoog <guilabel
>Asenda tekst</guilabel
> pakub mõningaid lisavõimalusi:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Asenda järgnevaga</guilabel
></term
> <listitem
><para
>Siia saa sisestada stringi, millega otsitav tekst asendatakse.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Valitud tekst</guilabel
></term
> <listitem
> <para
>See võimalus on välja lülitatud, kui teksti ei ole valitud või kui sisse on lülitatud võimalus <guilabel
>Asendusel küsi kinnitust</guilabel
>. Kui see on märgitud, asendatakse valitud tekstis kõik otsingustringiga sobivad elemendid asendusstringiga.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Asendusel küsi kinnitust</guilabel
></term
> <listitem
><para
>Kui see on märgitud, hüppab iga kord, kui leitakse sobivus, esile väike dialoog, mis pakub järgmisi võimalusi: <variablelist
> <varlistentry
> <term
><guibutton
>Jah</guibutton
></term
> <listitem
><para
>Sellele vajutamine asendab leitud sobivuse (mis on valitud redaktoris).</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guibutton
>Ei</guibutton
></term
> <listitem
><para
>Sellele vajutamine jätab leitud sobivuse asendamata ja sunnib edasi otsima.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guibutton
>Kõik</guibutton
></term
> <listitem
><para
>Sellele vajutamine lõpetab kinnituse küsimise ja asendab kõik sobivused.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guibutton
>Sulge</guibutton
></term
> <listitem
><para
>Sellele vajutamine jätab leitud sobivuse asendamata ja lõpetab otsingu.</para
></listitem
> </varlistentry
> </variablelist
> </para
></listitem
> </varlistentry
> </variablelist>

<note
> <para
>Praegu puudub võimalus regulaaravaldise otsingul kasutada minimaalne sobivuse võimalust. Seda võimalust pakub &kate; tulevikus.</para
> </note>

</sect2>

<sect2 id="finding-text">
<title
>Teksti otsimine</title>

<para
>Teksti otsimiseks käivita dialoog <guilabel
>Leia tekst</guilabel
> kas kiirklahvikombinatsiooniga <keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
> või menüükäsuga <menuchoice
><guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Leia...</guimenuitem
></menuchoice
>, sisesta otsimisstring, määra soovitud <link linkend="find-replace-dialog"
>valikud</link
> ja vajuta nuppu <guibutton
>Olgu</guibutton
>. Kui alguspunktist (kas kursori asukoht või dokumendi algus) edasi sobivusi ei leita, küsitakse sinu käest luba jätkata otsingut dokumendi algusest (või lõpust, kui kasutad otsingut tagasisuunas).</para>

<para
>Kui sobivus leitakse, valitakse see ning dialoog <guilabel
>Leia tekst</guilabel
> varjatakse, aga see jääb alles, mis muudab edasiste sobivuste leidmise äärmiselt lihtsaks.</para>

<para
>Otsingusuunas järgmise sobivuse leidmiseks kasuta menüükäsku <menuchoice
><guimenu
>Redigeeri</guimenu
> <guimenuitem
>Leia järgmine</guimenuitem
></menuchoice
> või vajuta <keycap
>F3</keycap
>.</para>

<para
>Otsingusuunale vastassuunas järgmise sobivuse leidmiseks kasuta menüükäsku <menuchoice
><guimenu
>Redigeeri</guimenu
> <guimenuitem
>Leia eelmine</guimenuitem
></menuchoice
> või kiirklahvikombinatsiooni <keycombo action="simul"
>&Shift;<keycap
>F3</keycap
></keycombo
>.</para>

<para
>Kui sobivust ei leitud enne dokumendi piirini jõudmist, küsitakse sinu käest luba see ületada.</para>

</sect2>

<sect2>
<title
>Teksti asendamine</title>

<para
>Teksti asendamiseks käivita dialoog <guilabel
>Teksti asendamine</guilabel
> kas menüükäsuga <menuchoice
><guimenu
>Redigeeri</guimenu
> <guimenuitem
>Asendamine</guimenuitem
></menuchoice
> või kiirklahvikombinatsiooniga <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
>, sisesta otsimisstring ja asendusstring (kui viimane jäetakse tühjaks, siis pannakse iga sobivuse asemele &quot;&quot;), määra soovitud <link linkend="find-replace-dialog"
>valikud</link
> ning vajuta nuppu <guibutton
>Olgu</guibutton
>.</para>

<tip
> <para
>Kui kasutad asendamisel teksti otsimiseks regulaaravaldisi, on sul võimalus tarvitada ka tagasiviitu avaldise sulgudes oleva alammustriga haaratud teksti taaskasutamiseks.</para
> <para
>Nende kohta vaata lähemalt <xref linkend="regular-expressions"/>.</para
> </tip>

</sect2>

</sect1>

<sect1 id="kate-part-bookmarks">
<title
>Järjehoidjate kasutamisest</title>

<para
>Järjehoidjad võimaldavad märkida teatud ridu, et neid hiljem vajaduse korral hõlpsasti leida.</para>

<para
>Järjehoidjaid võib reaga siduda või eemaldada kahel viisil:</para>

<itemizedlist
> <listitem
> <para
>liigutades tekstikursori soovitud reale ja kasutades kas menüükäsku <menuchoice
><guimenu
>Järjehoidjad</guimenu
><guimenuitem
>Järjehoidja lülitamine</guimenuitem
></menuchoice
> või kiirklahvikombinatsiooni <keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
>.</para
> </listitem
> <listitem
> <para
>klõpsates rea kõrval asuval ikoonipiirdel.</para
> </listitem
> </itemizedlist>


<para
>Järjehoidjaid näeb menüüs <guimenu
>Järjehoidjad</guimenu
>. Iga järjehoidja on seal kättesaadav menüüelemendina, teda märgib reanumber ja selle rea mõned esimesed märgid. Tekstikursori liigutamiseks järjehoidjaga tähistatud rea algusesse ava menüü ja vali vajalik järjehoidja.</para>

<tip
> <para
>Kui <link linkend="config-dialog"
>seadistustedialoogis</link
> on sisse lülitatud võimalus <link linkend="config-dialog-general-reopen-files"
>Failide taasavamine</link
> või kui &kate; käivitatakse seansihalduriga, taastatakse dokumendi taasavamisel ka selle järjehoidjad.</para
> </tip>

</sect1>

<sect1 id="kate-part-auto-wrap">

<title
>Automaatne reamurdmine</title>

<para
>See võimalus lubab teksti vormindada äärmiselt lihtsalt: read murtakse, nii et ükski rida ei ületa määratud tähtede arvu, kui ei esine just pikem, ilma tühikuteta string.</para>

<para
>Selle lubamiseks või keelamiseks tee või eemalda märge <link linkend="config-dialog"
>seadistustedialoogi</link
> lehekülje <link linkend="config-dialog-editor-edit"
>Redaktor</link
> kastist <guibutton
>Reamurdmine</guibutton
>.</para>

<para
>Rea maksimumpikkuse määramiseks (maksimaalne märkide arv rea kohta) kasuta <link linkend="config-dialog"
>seadistustedialoogi</link
> lehekülje <link linkend="config-dialog-editor-edit"
>Redaktor</link
> valikut <link linkend="config-dialog"
><guibutton
>Reamurdmise veerg:</guibutton
></link
>.</para>

<para
>Kui see on sisse lülitatud, ilmnevad järgmised mõjud: <itemizedlist
> <listitem
><para
>kirjutamise ajal lisab redaktor automaatselt sunniviisilise reamurdmise märgi viimase tühku järele enne rea maksimaalse pikkuse saavutamist.</para
></listitem
> <listitem
><para
>dokumendi laadimiselt murrab redaktor read samal põhimõttel, et ükski rida ei oleks pikem lubatud maksimumist, kui neis muidugi esineb reamurdmist võimaldav tühik.</para
></listitem
> </itemizedlist
> </para>

<note
><para
>Praegu puudub võimalus määrata reamurdmine erinevatele dokumenditüüpidele, seda ei saa ka dokumenditasandil lubada või keelata. Neid võimalusi rakendab &kate; tulevikus.</para
></note>

</sect1>

</chapter>

