<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [
  <!ENTITY kappname "&klipper;">
  <!ENTITY package "kdebase">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE"
> <!-- change language only here -->
]>

<book id="klipper" lang="&language;">
<bookinfo>
<title
>&klipper;i käsiraamat </title>

<authorgroup>
<author
>&Philip.Rodrigues; &Philip.Rodrigues.mail;</author>

<othercredit role="developer"
>&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail; </othercredit>

<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@starman.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 

</authorgroup>

<copyright>
<year
>2000-2003</year>
<holder
>&Philip.Rodrigues;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2013-06-02</date>
<releaseinfo
>0.9.7 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>&klipper; on &kde; lõikepuhver, <quote
>lõika &amp; aseta</quote
> vahend.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Klipper</keyword>
<keyword
>kdebase</keyword>
<keyword
>lõikepuhver</keyword>
</keywordset>
</bookinfo>
 
<chapter id="introduction">
<title
>Sissejuhatus</title>
<para
>&klipper; on &kde; lõikepuhvrirakendus. See salvestab lõikepuhvri ajaloo ja võimaldab siduda lõikepuhvri sisu rakenduse tegevusega. Anna palun mis tahes probleemidest või soovidest teada <ulink url="http://bugs.kde.org"
>KDE Bugzillas</ulink
> või kasuta käsku <guimenuitem
>Saada vearaport</guimenuitem
>, mille leiad menüüst <guimenu
>Abi</guimenu
>.</para>

</chapter>

<chapter id="using-klipper">
<title
>&klipper;i kasutamine</title>

<sect1 id="basic-usage">
<title
>Põhialused</title>
<screenshot>
<screeninfo
>&klipper;i ikoon.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screenshot.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>&klipper;i ikoon</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Lõikepuhvri ajaloo vaatamiseks klõpsa &klipper;i ikoonil &kde; paneelil või kasuta kiirklahvi <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>V</keycap
></keycombo
>. Varasemad lõikepuhvri elemendid on näha ilmuva hüpikmenüü ülaosas. Neist mõne valimine kopeerib selle lõikepuhvrisse, kust see on võimalik tavapäraselt kopeerida suvalisse &kde; või X'i rakendusse.</para>

<note
><para
>Selle toimingu kiirklahvi saab seadistada <guilabel
>kirjete</guilabel
> kaardil <guilabel
>süsteemisalve seadistuste</guilabel
> all.</para
></note>

<para
>Lõikepuhvri ajaloos saab otsida, kui see avada (klõpsuga &klipper;il) ning kirjutada päring. Tulemusi uuendatakse jooksvalt päringu kirjutamise käigus. &klipper;i menüüs saab kasutada ka kiirklahve, milleks tuleb vajutada klahvi &Alt; ning siis teist vajalikku klahvi. Näiteks lõikepuhvri ajaloo puhastamiseks (kui &klipper;i menüü on avatud) vajuta &Alt; ning käsus <guimenuitem
>Puhasta lõikepuhvri ajalugu</guimenuitem
> allajoonitud tähte.</para>

<para
>Vali &klipper;i hüpikmenüüst käsk <guilabel
>Näita ribakoodi</guilabel
>, mis avab dialoogi <ulink url="http://en.wikipedia.org/wiki/QR_Code"
>QR-koodi</ulink
> ja <ulink url="http://en.wikipedia.org/wiki/Datamatrix"
>DataMatrixi</ulink
> ribakoodiga. &ksnapshot; võimaldab teha ribakoodidest pildi ja need salvestada. </para>

<para
>&klipper;i väljalülitamiseks klõpsa selle ikoonil ning vali ilmuvast menüüst <guimenuitem
>Välju</guimenuitem
>.</para>

</sect1>

<sect1 id="actions">
<title
>Toimingud</title>

<para
>&klipper; võib lõikepuhvri sisuga mitmesuguseid operatsioone sooritada vastavalt sellele, kas nad vastavad teatud regulaaravaldisele või mitte. Näiteks lõikepuhvri element, mille alguses seisab <quote
>http://</quote
>, tähendab &URL;-i, mille avamiseks sobib hästi Firefox või &konqueror;. Lisaks saab juhul, kui sisu sobib asukohaga, võtta samalaadseid toiminguid ette vastavalt faili tüübile. Kui näiteks lõikepuhvrisse on kopeeritud <acronym
>PDF</acronym
>-faili asukoht, saab faili vaadata &okular;iga.</para>

<para
>Selle võimaluse kasutamiseks vali lihtsalt &URL; või failinimi. Kui see vastab &klipper;i nimekirjas olevale regulaaravaldisele, ilmub menüü, mis näitab valikule vastavaid programme. Vali soovitud tegevus hiire või klaviatuuri abil ning &klipper; käivitab valitud programmi, avades aadressi, millele valik viitas.</para>

<para
>Kui sa ei soovi, et lõikepuhvri sisuga midagi ette võetaks, vali <guimenuitem
>Keela see hüpikmenüü</guimenuitem
>, mis laseb tagasi pöörduda varasema tegevuse juurde. Menüüst lahkudes see kaob, võimaldades jätkata muud tegevust. Aega, kui kaua menüü nähtaval püsib, saab määrata <guilabel
>Eelistuste</guilabel
> dialoogis võimalusega <guilabel
>Tegevuste hüpikmenüü aegumine</guilabel
> kaardil <guilabel
>Üldine</guilabel
>. Eraldi võib keelata faili asukoha võimaluse, kasutades valikut <guilabel
>MIME-põhiste toimingute lubamine</guilabel
> kaardil <guilabel
>Toimingud</guilabel
>.</para>
  
<para
>Tegevused võib ka täielikult keelata, klõpsates &klipper;il ja eemaldades märke valiku <guimenuitem
>Lõikepuhvri toimingute lubamine</guimenuitem
> eest. Sama tulemuse annab kiirklahvi <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>X</keycap
></keycombo
> kasutamine.</para>

<para
>Regulaaravaldisele vastavat lõikepuhvri sisu saab ka enne tegevuse rakendamist redigeerida. Selleks vali &klipper;i hüpikmenüüst käsk <guimenuitem
>Redigeeri sisu...</guimenuitem
> ning ilmuvas dialoogis saadki lõikepuhvri sisu muuta, seejärel vajutusega nupul <guibutton
>OK</guibutton
> vastavat tegevust käivitades.</para>

<para
>Kiirklahv <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>R</keycap
></keycombo
> toob esile hüpikmenüü, mis kordab viimast &klipper;i sooritatud tegevust.</para>

</sect1>

<sect1 id="clipboard-modes">
<title
>Lõikepuhvri/valikupuhvri käitumine</title>

<sect2 id="clipboard-modes-general">
<title
>Üldine</title>
<para
>&klipper;i abil võib määrata lõikepuhvri ja valikupuhvri käitumist &kde;s. </para>

<note
><para
>&X-Window; kasutab kaht eraldi lõikepuhvrit: <quote
>valikupuhver</quote
> ja <quote
>lõikepuhver</quote
>. Tekst asetatakse valikupuhvrisse pelgalt selle valimisega ning seda saab asetada hiire keskmise nupuga. Lõikepuhvrisse tuleb aga tekst spetsiaalselt asetada, valides selle ja vajutades <keycombo
>&Ctrl;<keycap
>X</keycap
> </keycombo
> või <keycombo
>&Ctrl;<keycap
>C</keycap
> </keycombo
>. Lõikepuhvrist saab teksti asetada klahvikombinatsiooniga <keycombo
>&Ctrl;<keycap
>V</keycap
> </keycombo
> või valides menüükäsu <menuchoice
><guimenu
>Redigeerimine</guimenu
><guimenuitem
>Aseta</guimenuitem
> </menuchoice
>.</para>
</note>

<!-- &klipper; can be used to set the clipboard mode for the whole of &kde;. The
first mode will be familiar to &Microsoft; &Windows; and &Mac; users: Text is
inserted into the clipboard using an application's cut/copy (or generally
<keycombo
>&Ctrl;<keycap
>X</keycap
></keycombo
> and
<keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
> respectively)
function, and the application's paste (or generally 
<keycombo
>&Ctrl;<keycap
>V</keycap
></keycombo
>) function pastes the
contents of this clipboard.
</para>
<para>
The second mode will be more familiar to longtime &UNIX; users: Selected text
is copied to this clipboard, and clicking the <mousebutton
>middle</mousebutton
> 
mouse button pastes the
contents of this clipboard.
-->
</sect2>

<sect2 id="changing-clipboard-modes">
<title
>Lõikepuhvri/valikupuhvri käitumise muutmine</title>
<para
>Lõikepuhvri/valikupuhvri käitumise muutmiseks vali &klipper;i hüpikmenüüst <guimenuitem
>&klipper;i seadistamine...</guimenuitem
> ning ilmuvas dialoogis kaart <guilabel
>Üldine</guilabel
>. Kui jätta märkimata <guilabel
>Lõikepuhvri ja valikupuhvri sisu sünkroniseeritakse</guilabel
>, toimivadki need eraldi nagu ülal kirjeldatud. Selle sisselülitamisel väldib näiteks võimaluse <guilabel
>Valikupuhvrit ignoreeritakse</guilabel
> valimine &klipper;il valikupuhvri sisu kaasamise oma lõikepuhvri ajalukku ning takistab tal sooritamast mingit tegevust valikupuhvri sisuga. Kui valida võimalus <guilabel
>Lõikepuhvri ja valikupuhvri sisu sünkroniseeritakse</guilabel
>, siis on lõikepuhver ja valikupuhver alati ühesugune, mis tähendab, et teksti saab asetada kas hiire <mousebutton
>keskmise</mousebutton
> nupuga või kiirklahviga <keycombo
>&Ctrl;<keycap
>V</keycap
> </keycombo
> ning sama kehtib ka lõikepuhvri kohta. </para>

 <!-- The
<guilabel
>Synchronize contents of the clipboard and the
selection</guilabel
> check box determines the clipboard mode. If the box is
selected, the clipboard functions in the &UNIX; mode; if not, the
&Windows;/&Mac; mode is used. -->

</sect2>


</sect1>

</chapter>

<chapter id="preferences">
<title
>&klipper;i seadistamine</title>

<sect1 id="viewing-options">

<title
>Seadistustedialoog</title>

<para
>&klipper;i seadistuste vaatamiseks või muutmiseks ava &klipper;i hüpikmenüü ning vali <guimenuitem
>&klipper;i seadistamine...</guimenuitem
>. Seejärel ilmub &klipper;i seadistuste dialoog, mille sisu kohe kirjeldame.</para>

</sect1>

<sect1 id="general-page">
<title
>Üldised valikud</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Väljumisel salvestatakse lõikepuhvri sisu</guilabel
></term
> <listitem
><para
>Selle sisselülitamisel salvestatakse lõikepuhvri sisu &klipper;i töö lõpetamisel, mis võimaldab seda taas kasutada &klipper;i järgmisel käivitamisel.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Välditakse tühja lõikepuhvrit</guilabel
></term>
<listitem
><para
>Kui see on lubatud, ei ole lõikepuhver kunagi tühi: &klipper; kannab viimased elemendid lõikepuhvrist selle ajalukku ega luba sel tühjana seista.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Piltide eiramine</guilabel
></term>
<listitem
><para
>Kui ekraani ala valitakse hiirega või klaviatuuri abil, nimetakse seda <quote
>valikuks</quote
>. Märkimisel salvestatakse ajalukku ainult teksti valik, mitte aga pilte ja muid valikuid. </para>
</listitem>
</varlistentry
> 

<varlistentry>
<term
><guilabel
>Valikupuhvrit ignoreeritakse</guilabel
></term>
<listitem
><para
>Lõikepuhvri režiimi määramine. See valik takistab &klipper;il lisamast valiku sisu lõikepuhvri ajalikku ning sooritamast toiminguid valiku sisuga. Vt. <xref linkend="clipboard-modes"/>. </para>
</listitem>
</varlistentry
> 

<varlistentry>
<term
><guilabel
>Ainult teksti valik</guilabel
></term>
<listitem
><para
>Kui ekraani ala valitakse hiirega või klaviatuuri abil, nimetakse seda <quote
>valikuks</quote
>. Märkimisel salvestatakse ajalukku ainult teksti valik, mitte aga pilte ja muid valikuid. Vt. <xref linkend="clipboard-modes"/>. </para>
</listitem>
</varlistentry
> 

<varlistentry>
<term
><guilabel
>Lõikepuhvri ja valikupuhri sisu sünkroniseeritakse</guilabel
></term>
<listitem
><para
>Määrab lõikepuhvri režiimi. Kui ekraani ala valitakse hiirega või klaviatuuri abil, nimetakse seda <quote
>valikuks</quote
>. Märkimisel hoitakse valik ja lõikepuhver võrdsena, nii et valik on otsekohe saadaval asetamiseks mujal mis tahes viisil, kaasa arvatud traditsioonilise hiire keskmise klõpsu abil. Vastasel juhul jäädvustatakse valik lõikepuhvri ajalukku, aga valikut saab asetada ainult hiire keskmise nupuga. Vaata ka <guilabel
>lõikepuhvri eiramise</guilabel
> võimalust. Vt. <xref linkend="clipboard-modes"/>. </para>
</listitem>
</varlistentry
> 

<varlistentry>
<term
><guilabel
>Aegumine tegevuste hüpikmenüüle</guilabel
></term>
<listitem
><para
>Määrab aja, mille jooksul hüpikmenüü nähtaval püsib, kui sa midagi ette ei võta.</para
></listitem>
</varlistentry>

<varlistentry
><term
><guilabel
>Lõikepuhvri ajaloo suurus</guilabel
></term>
<listitem
><para
>Määrab lõikepuhvri ajalukku salvestatavate elementide arvu.</para
></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="actions-page">
<title
>Tegevuste valikud</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Tegevusi rakendatakse ka ajaloost valitud elementidele</guilabel
></term>
<listitem
><para
>Kui see on lubatud, sunnib elemendi valimine ajaloost &klipper;i hüpikmenüüs näitama selle puhul võimalikke tegevusi (kui neid on).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Toimingute rakendamisel eemaldatakse tühimärk</guilabel
></term>
<listitem
><para
>Mõnikord on valitud tekstil lõpus tühimärke, mis &URL;-ina lehitsejas avatuna võivad tekitada vigu. Selle võimaluse sisselülitamine eemaldab valitud stringi lõpust ja algusest kõik tühimärgid (lõikepuhvri algupärast sisu ei muudeta).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>MIME-põhiste toimingute lubamine</guilabel
></term>
<listitem
><para
>Valimise korral ilmub hüpikmenüüs lisaks määratud toimingutele nähtavale veel rakenduste loend vastavalt tuvastatud MIME tüübile.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Regulaaravaldise/tegevuse redigeerimine</term>
<listitem
><para
>Tee kaardil <guilabel
>Tegevused</guilabel
> topeltklõps regulaaravaldisel või tegevusel, mida soovid redigeerida, või vali see ja klõpsa nupule <guibutton
>Muuda tegevust</guibutton
>. Ilmub dialoog, kus saad avaldise teksti oma tahtmist mööda muuta.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Regulaaravaldise/tegevuse lisamine</term>
<listitem
><para
>Kui soovid lisada regulaaravaldise, mida &klipper; saaks kasutada, klõpsa nupul <guibutton
>Lisa tegevus</guibutton
>. &klipper; kasutab &Qt; klassi <classname
>QRegExp</classname
>, mis tunnistab enamikku regulaaravaldisi, mida kasutatakse näiteks rakendustes <application
>grep</application
> või <application
>egrep</application
>.</para>
<para
>Regulaaravaldise kirjelduse (&eg; <quote
>HTTP URL</quote
>) saab lisada hiire <mousebutton
>vasaku</mousebutton
> nupu klõpsuga veerul <guilabel
>Kirjeldus</guilabel
>.</para
>   

<note
><para
>Põhjaliku info <classname
>QRegExp</classname
> regulaaravaldiste kasutamise kohta leiab internetis aadresil <ulink url="http://qt-project.org/doc/qt-4.8/qregexp.html#details"
>http://qt-project.org/doc/qt-4.8/qregexp.html#details</ulink
>. Pane tähele, et &klipper; ei toeta seal mainitud metamärkide kasutamist.</para
></note
> 

<para
>Redigeeri regulaaravaldist sarnaselt eespool kirjeldatule. Käivitatava käsu lisamiseks klõpsa <guimenuitem
>Lisa käsk</guimenuitem
> ning redigeeri käsku aktiveeruvas tekstikastis. Topeltklõps käsul võimaldab seda muuta.</para>

<para
>Pane tähele, et parameeter <token
>%s</token
> asendatakse käsureal lõikepuhvri sisuga, &eg; kui käsk on <userinput
><command
>kwrite</command
> <token
>%s</token
></userinput
> ja lõikepuhvri sisu <filename
>/home/pets/tekstifail</filename
>, siis käivitatakse käsk <userinput
><command
>kwrite</command
><filename
>/home/pets/tekstifail</filename
></userinput
>. Et käsurida parameetrit <token
>%s</token
> arvestaks, tuleb see märkida längkriipsuga: <userinput
>\%s</userinput
>.</para
></listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Muu</guibutton
></term>
<listitem
><para
>Avab dialoogi <guilabel
>Alltoodud akende klasside (WM_CLASS) puhul ei rakendata tegevusi</guilabel
>.</para>
<para
>Mõned rakendused, näiteks &konqueror;, kasutavad lõikepuhvrit seesmiselt. Kui sa teatud rakendust kasutades oled hädas pidevalt ilmuvate &klipper;i hüpikmenüüdega, võta ette järgmised sammud:</para>

<orderedlist>
<listitem
><para
>Ava rakendus.</para
></listitem>
<listitem
><para
>Anna terminalis käsk <userinput
><command
>xprop</command
> | <command
>grep</command
> <parameter
>WM_CLASS</parameter
></userinput
> ning klõpsa siis käivitatud rakenduse aknal.</para
></listitem
> 
<listitem
><para
>Esimene string pärast võrdusmärki ongi see, mis tuleb sisestada.</para
></listitem>
</orderedlist>

<para
>Kui WM_CLASS on lisatud, ei käivitata enam selle rakenduse akendes tegevusi.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="shortcuts-page">
<title
>Kiirklahvide valikud</title>

<para
>Kiirklahvide kaart võimaldab muuta klahvikombinatsioone, mida saab kasutada &klipper;i võimaluste rakendamiseks. Väärtusi saab muuta järgmiselt:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Puudub</guilabel
></term>
<listitem
><para
>Valitud tegevust ei saa esile kutsuda klaviatuurilt antava otsekorraldusega</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Vaikeväärtus</guilabel
></term>
<listitem
><para
>Valitud tegevuseks kasutatakse &klipper;i vaikimisi määratud kiirklahvi. Need on samad, millest on juttu käesolevas käsiraamatus.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Kohandatud</guilabel
></term>
<listitem
><para
>Valitud tegevust rakendatakse sinu määratud klahvidega.</para>
<para
>Kohandatud klahvi määramiseks klõpsa <guilabel
>Kohandatud</guilabel
> ja siis <guilabel
>Puudub</guilabel
>. Nüüd sisesta soovitud kombinatsioon täpselt samamoodi, nagu see käib muudes &kde; rakendustes. </para
> </listitem>
</varlistentry>
</variablelist>

<para
>Kui määrad kiirklahvi käsule <guilabel
>Klipper avatakse hiirekursori asukohas</guilabel
>, paneb selle kiirklahvi kasutamine &klipper;i hüpikmenüü ilmuma seal, kus asub hiirekursor, selle asemel, et seda tavapäraselt &kde; paneelil avada. See võib olla kasulik, kui oled harjunud hiirt klaviatuurist enam kasutama.</para>

</sect1>
</chapter>

<chapter id="credits">
<title
>Autorid ja litsents</title>

<para
>&klipper; </para>
<para
>Rakenduse autoriõigus 1998: &Andrew.Stanley-Jones; <email
>asj@cban.com</email
> </para>
<para
>Rakenduse autoriõigus 1998-2000: &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</para>
<para
>Praegune hooldaja: Esben Mose Hansen. Täpsemat kontaktinfot vaata aadressilt <ulink url="http://mosehansen.dk/about"
>http://mosehansen.dk/about</ulink
>. </para>

<para
>Dokumentatsiooni autoriõigus 2000-2003, 2005: &Philip.Rodrigues; &Philip.Rodrigues.mail;</para>

<para
>Tõlge eesti keelde: Marek Laane <email
>bald@starman.ee</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Paigaldamine</title>

<sect1 id="getting-klipper">
<title
>&klipper;i hankimine</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Kompileerimine ja paigaldamine</title>
&install.compile.documentation; </sect1>
</appendix>

&documentation.index; 

</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step: 0
End:
-->










