<?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 % Polish "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">
<bookinfo>
<title
>Podręcznik programu &klipper; </title>

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

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

<othercredit role="translator"
><firstname
>Krzysztof</firstname
><surname
>Woźniak</surname
><affiliation
><address
><email
>wozniakk@ceti.pl</email
></address
></affiliation
><contrib
>Polskie tłumaczenie</contrib
></othercredit
> 

</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2005-01-31</date>
<releaseinfo
>2.92.00</releaseinfo>

<abstract>
<para
>Program &klipper; to narzędzie schowka dla środowiska &kde;, obsługujące operacje wycinania i wklejania.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Klipper</keyword>
<keyword
>kdebase</keyword>
<keyword
>schowek</keyword>
</keywordset>
</bookinfo>
 
<chapter id="introduction">
<title
>Wprowadzenie</title>
<para
>&klipper; odgrywa rolę schowka w środowisku &kde;. Przechowuje historię skopiowanych lub wyciętych obiektów oraz umożliwia wykonywanie różnych działań na zawartości schowka. Wszelkie uwagi, problemy i zgłoszenia rozbudowy programu prosimy kierować do opiekuna programu, którym jest Esben Mose Hansen (dane kontaktowe dostępne są na stronie: <ulink url="http://mosehansen.dk/about"
>http://mosehansen.dk/about</ulink
>).</para>

</chapter>

<chapter id="using-klipper">
<title
>Korzystanie z programu &klipper;</title>

<sect1 id="basic-usage">
<title
>Operacje podstawowe</title>
<screenshot>
<screeninfo
>Ikona programu&klipper;.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screenshot.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ikona programu&klipper;</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Wyświetlenie historii schowka możliwe jest po naciśnięciu ikony programu &klipper; w panelu &kde; lub kombinacji klawiszy <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>V</keycap
> </keycombo
>. Pozycje stanowiące zawartość schowka wyświetlone zostaną w górnej części wyskakującego menu. Wybranie dowolnej pozycji z historii przenosi ją do schowka, skąd może zostać wklejona do dowolnego programu środowiska &kde; lub X-Windows.</para>

<para
>Możliwe jest wyszukiwanie tekstu w historii wpisów. Aby tego dokonać należy otworzyć historię (klikając na ikonę programu &klipper;) i wpisać z klawiatury poszukiwany fragment tekstu. Lista rezultatów będzie automatycznie aktualizowana w trakcie pisania. W menu programu działają klawisze szybkiego dostępu, a korzystać z nich można naciskając klawisz &Alt; i klawisz z literą dla której widoczne jest podkreślenie w żądanej pozycji menu. Na przykład, aby usunąć historię schowka, należy otworzyć menu programu &klipper; i nacisnąć <keycombo action="simul"
>&Alt;<keycap
>L</keycap
> </keycombo
>.</para>

<para
>Aby usunąć ikonę programu &klipper; z zasobnika systemowego, należy na nią kliknąć i z wyświetlonego menu wybrać pozycję <guimenuitem
>Zakończ</guimenuitem
>.</para>

</sect1>

<sect1 id="actions">
<title
>Działania </title>

<para
>Program &klipper; może wykonywać różne operacje (działania) na zawartości schowka w zależności od spełnienia warunków dopasowania odpowiedniego wyrażenia regularnego. Na przykład każdy tekst wklejony do schowka i rozpoczynających się od <quote
>http://</quote
> może zostać przesłany do programów &Netscape; lub &konqueror; .i otwarty w ich oknie jako strona w sieci Internet.</para>

<para
>Aby skorzystać z tej możliwości wystarczy skopiować adres &URL; lub nazwę pliku do schowka. Jeżeli program &klipper; znajdzie na liście pasujące wyrażenie regularne wyświetli się menu z listą dostępnych działań (np: Otwórz stronę &URL; w programie &konqueror;, Otwórz stronę &URL; w &Netscape;). Należy wybrać właściwy program za pomocą myszki lub klawiatury, a &klipper; uruchomi wybrany program otwierając w nim stronę o adresie skopiowanym to schowka.</para>

<para
>Jeżeli użytkownik nie chce wykonywać żadnych działań związanych z zawartością schowka powinien wybrać w menu pozycję<guimenuitem
>Nic nie rób</guimenuitem
> co zamknie menu i pozwoli na kontynuację pracy. Możliwe jest ustawienie czasu wyświetlania wyskakującego menu, w oknie <guilabel
>Konfiguracja Klippera...</guilabel
> w karcie <guilabel
>Ogólne</guilabel
> poprzez zmianę suwaka <guilabel
>Czas wyświetlania menu działań</guilabel
>.</para>
	  
<para
>Wykonywanie działań może zostać wyłączone poprzez kliknięcie na ikonę programu &klipper; oraz wybranie pozycji <guimenuitem
>Włącz działania</guimenuitem
> lub naciśnięcie klawiszy <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>X</keycap
></keycombo
>.</para>

<para
>Zawartość schowka pasująca do wyrażenia regularnego może być zmieniona przed wykonaniem działania z nią związanego. Należy wybrać pozycję <guimenuitem
>Zmień zawartość...</guimenuitem
> w wyskakującym menu programu, a następnie zmienić tekst w wyświetlonym oknie dialogowym. Naciśnięcie przycisku <guibutton
>OK</guibutton
> wykona działanie na zmienionej przez użytkownika zawartości schowka.</para>

<para
>Naciśnięcie klawisza <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>R</keycap
></keycombo
> spowoduje wyświetlenie menu pozwalającego na powtórzenie ostatnio wykonanego przez program &klipper; działania.</para>

</sect1>

<sect1 id="clipboard-modes">
<title
>Zachowanie schowka/wyboru</title>

<sect2 id="clipboard-modes-general">
<title
>Informacje ogólne</title>
<para
>Za pomocą programu &klipper; można skonfigurować sposób działania schowka i zaznaczenia w środowisku &kde;. </para>

<note
><para
>Środowisko okienkowe &X-Window; wykorzystuje dwa oddzielne bufory dla <quote
>zaznaczenia</quote
> oraz <quote
>schowka</quote
>. Tekst umieszczany jest w pierwszym z nich przy każdej operacji zaznaczenia, może być on wklejony w innym miejscu przez naciśnięcie środkowego klawisza myszki. Aby umieścić tekst w buforze schowka, należy nacisnąć klawisze <keycombo
>&Ctrl;<keycap
>X</keycap
> </keycombo
> lub <keycombo
>&Ctrl;<keycap
>C</keycap
> </keycombo
>. Wklejanie tekstu z bufora schowka odbywa się za pomocą klawiszy <keycombo
>&Ctrl;<keycap
>V</keycap
> </keycombo
> lub poprzez wybór pozycji w menu <menuchoice
><guimenu
>Edycja</guimenu
><guimenuitem
>Wklej</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
>Zmiana zachowania schowka/wyboru</title>
<para
>Aby zmienić sposób obsługi operacji schowka/zaznaczania, należy wybrać z menu programu pozycję <guimenuitem
>Konfiguracja Klippera...</guimenuitem
> i w wyświetlonym oknie dialogowym wybrać kartę <guilabel
>Ogólne</guilabel
>. Wybranie opcji <guilabel
>Rozdziel schowek i zaznaczenie</guilabel
> włącza tradycyjne - opisane wcześniej - zachowanie czyli oddzielne bufory dla schowka i zaznaczenia. Dodatkowo możliwe jest wtedy ustawienie opcji <guilabel
>Ignoruj wybór</guilabel
> co spowoduje iż  &klipper; nie będzie zamieszczać zawartości zaznaczenia w historii i nie będzie wykonywał działań z nim związanych. Wybranie opcji <guilabel
>Synchronizuj zawartość schowka i zaznaczenia</guilabel
> spowoduje iż zawartość buforów schowka i zaznaczenia zawsze będzie identyczna, co oznacza iż zaznaczony fragment będzie mógł być wklejony za pomocą <mousebutton
>środkowego</mousebutton
> przycisku myszy ale również za pomocą kombinacji klawiszy <keycombo
>&Ctrl;<keycap
>V</keycap
> </keycombo
>. Dotyczy to także teksty znajdującego się w buforze schowka. </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
>Konfiguracja &klipper-dopelniacz;</title>

<sect1 id="viewing-options">

<title
>Wyświetlanie okna konfiguracji</title>

<para
>Aby zobaczyć lub zmienić ustawienia programu &klipper; należy wybrać pozycję <guimenuitem
>Konfiguracja Klippera</guimenuitem
> z menu programu. Spowoduje to otwarcie okna dialogowego konfiguracji programu, którego zawartość opisana jest poniżej.</para>

</sect1>

<sect1 id="general-tab">
<title
>Parametry ogólne</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Menu w pozycji kursora myszy</guilabel
></term>
<listitem
><para
>Powoduje, iż wyskakujące menu programu &klipper; wyświetlać się będzie obok bieżącego położenia kursora myszy, a nie w miejscu domyślnym (tzn. na panelu &kde;). Jest to użyteczne dla osób, które częściej korzystają z myszki niż z klawiatury.</para
></listitem>
</varlistentry>


<varlistentry>
<term
><guilabel
>Zapisz schowek przy wyjściu</guilabel
></term
> <listitem
><para
>Zaznaczenie tej opcji spowoduje iż &klipper; będzie zapisywać teksty przechowywane w schowku przy wychodzeniu dzięki czemu będzie można z nich skorzystać po ponownym uruchomieniu programu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Usuwaj spacje przy uruchamianiu działań</guilabel
></term>
<listitem
><para
>Włączenie tej opcji powoduje iż wszelkie tzw. białe znaki (spacje, tabulatory, itp.) na początku i końcu znajdującego się w schowku tekstu będą usuwane przed wklejeniem zawartości schowka do innego programu. Opcja ta przydaje się na przykład wtedy gdy w schowku znajduje się adres &URL; zawierający spacje. Otwarcie takiego adresu w przeglądarce mogłoby spowodować błąd.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Wykonaj działania na pozycji wybranej z historii</guilabel
></term>
<listitem
><para
>Jeżeli ta opcja jest włączona, to wybranie pozycji z historii schowka spowoduje iż &klipper; wyświetli listę działań do wykonania dla tej pozycji (jeżeli jakieś działania są dostępne).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nigdy nie czyść schowka</guilabel
></term>
<listitem
><para
>Jeżeli opcja zostanie włączona to schowek systemowy nigdy nie będzie pusty: &klipper; zawsze umieści w nim ostatnią pozycję z historii schowka nie pozwalając na opróżnienie schowka systemowego.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ignoruj wybór</guilabel
></term>
<listitem
><para
>Powoduje ustawienie trybu pracy schowka. Więcej na ten temat tutaj: <xref linkend="clipboard-modes"/>. </para>
</listitem>
</varlistentry
> 


<varlistentry>
<term
><guilabel
>Synchronizuj zawartość schowka i zaznaczenia</guilabel
></term>
<listitem
><para
>Powoduje ustawienie trybu pracy schowka. Więcej na ten temat tutaj: <xref linkend="clipboard-modes"/>. </para>
</listitem>
</varlistentry
> 

<varlistentry>
<term
><guilabel
>Rozdziel schowek i zaznaczenie</guilabel
></term>
<listitem
><para
>Powoduje ustawienie trybu pracy schowka. Więcej na ten temat tutaj: <xref linkend="clipboard-modes"/>. </para>
</listitem>
</varlistentry
> 


<varlistentry>
<term
><guilabel
>Czas wyświetlania menu działań</guilabel
></term>
<listitem
><para
>Powoduje ustawienie czasu po jakim zniknie wyskakujące menu, jeżeli użytkownik nie wykona żadnej operacji.</para
></listitem>
</varlistentry>

<varlistentry
><term
><guilabel
>Rozmiar historii schowka</guilabel
></term>
<listitem
><para
>Określa liczbę obiektów przechowywanych w historii schowka.</para
></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="actions-tab">
<title
>Ustawienia działań</title>

<variablelist>
<varlistentry>
<term
>Edycja wyrażeń/działań</term>
<listitem
><para
>W karcie <guilabel
>Działania</guilabel
> należy dwukrotnie kliknąć na wyrażenie regularne, które ma być zmienione. W miejscu wyrażenia pojawi się pole edycyjne wraz z kursorem pozwalające na zmianą tego wyrażenia. Po zakończeniu edycji należy koniecznie nacisnąć klawisz <keysym
>Enter</keysym
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Dodawanie wyrażeń/działań</term>
<listitem
><para
>Należy kliknąć przycisk <guibutton
>Dodaj działanie</guibutton
> i wprowadzić wyrażenie regularne używane do dopasowywania tekstu przez program &klipper;. Program wykorzystuje standardową klasę biblioteki &Qt;: <classname
>QRegExp</classname
>, która obsługuje znaczną część składni wyrażeń regularnych i pozwala na używanie składni identycznej jak na przykład w programach <application
>grep</application
> lub <application
>egrep</application
>.</para>
<para
>Można dodać do wyrażenia regularnego krótki opis (np.: <quote
>HTTP URL</quote
>) naciskając <mousebutton
>lewy</mousebutton
> przycisk myszy w kolumnie <guilabel
>Opis</guilabel
>..</para
>   

<note
><para
>Więcej informacji o obsłudze wyrażeń regularnych przez klasę <classname
>QRegExp</classname
> można uzyskać pod adresem: <ulink url="http://doc.trolltech.com/qregexp.html#details"
>http://doc.trolltech.com/qregexp.html#details</ulink
>. Należy zwrócić uwagę iż program &klipper; nie obsługuje trybu "wildcard" opisywanego na tej stronie.</para
></note
> 

<para
>Po zakończeniu edycji wyrażenia regularnego można dodać polecenia, które powinny być wykonane po jego dopasowaniu. Należy kliknąć <mousebutton
>prawy</mousebutton
> przycisk myszy, wybrać pozycję <guimenuitem
>Dodaj polecenie</guimenuitem
> i wpisać polecenia, które będą wyświetlane w postaci drzewka pod zmienianym wyrażeniem regularnym.</para>

<para
>We wprowadzonych poleceniach makropolecenie <token
>%s</token
> jest zamieniane na zawartość schowka, np. jeżeli polecenie jest zdefiniowane tak: <userinput
><command
>kedit</command
> <token
>%s</token
></userinput
> a w schowku znajduje się napis <filename
>/home/phil/textfile</filename
> to program wykona polecenie <userinput
><command
>kedit</command
> <filename
>/home/phil/textfile</filename
></userinput
>. Jeżeli w linii poleceń niezbędne jest wpisanie tekstu <token
>%s</token
> to należy zapisać go w postaci sekwencji specjalnej tzn.: <userinput
>\%s</userinput
>.</para
></listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Zaawansowane...</guibutton
></term>
<listitem
><para
>Wyświetla okno dialogowe <guilabel
>Wyłącz działania dla okien typu WM_CLASS</guilabel
>.</para>
<para
>Część programów (takich jak np.: &konqueror;) posiada własne mechanizmy korzystania ze schowka. Jeżeli w trakcie ich pracy pojawiają się niepożądane okna i komunikaty programu &klipper;, należy wykonać następujące operacje:</para>

<orderedlist>
<listitem
><para
>Uruchomić program.</para
></listitem>
<listitem
><para
>W konsoli tekstowej należy wykonać polecenie <userinput
><command
>xprop</command
> | <command
>grep</command
> <parameter
>WM_CLASS</parameter
></userinput
>, a następnie kliknąć na okno uruchomionego programu.</para
></listitem
> 
<listitem
><para
>Pierwszy napis wyświetlony po znaku "=" jest tym który należy wprowadzić w oknie dialogowym konfiguracji programu &klipper;.</para
></listitem>
</orderedlist>

<para
>Po dodaniu odpowiedniej pozycji WM_CLASS dla okien tego programu nie będą generowane żadne działania.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="shortcuts-tab">
<title
>Skróty klawiszowe</title>

<para
>W tej zakładce możliwe jest zdefiniowanie skrótów klawiszowych wykorzystywanych do wykonywania różnych działań w programie &klipper;. Możliwe są następujące trzy ustawienia dla każdej funkcji:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Brak</guilabel
></term>
<listitem
><para
>Wybrane działanie nie będzie dostępne bezpośrednio z klawiatury</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Domyślny</guilabel
></term>
<listitem
><para
>Wybranej akcji zostanie przypisany domyślny klawisz programu &klipper;. Do tych skrótów odwołuje się niniejszy podręcznik.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Własny</guilabel
></term>
<listitem
><para
>Użytkownik będzie mógł przypisać własną kombinację klawiszy do wywołania wybranego działania. </para>
<para
>Aby zdefiniować własną kombinację klawiszy dla wybranego polecenia, należy kliknąć na obrazku przypominającym klawisz w dolnej prawej części okna aby go włączyć, a następnie nacisnąć pożądaną kombinację na klawiaturze. </para
> </listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>

<chapter id="credits">
<title
>Zasługi i licencje</title>

<para
>&klipper; </para>
<para
>Prawa autorskie do programu (c) 1998 &Andrew.Stanley-Jones; <email
>asj@cban.com</email
> </para>
<para
>Prawa autorskie do programu (c) 1998-2000 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</para>
<para
>Aktualnym opiekunem programu jest Esben Mose Hansen. Informacje dotyczące kontaktu znajdują się na stronie: <ulink url="http://mosehansen.dk/about"
>http://mosehansen.dk/about</ulink
>. </para>

<para
>Prawa autorskie do dokumentacji (c) 2000-2003, 2005 &Philip.Rodrigues; &Philip.Rodrigues.mail;</para>

<para
>Polskie tłumaczenie: Krzysztof Woźniak <email
>wozniakk@ceti.pl</email
></para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-klipper">
<title
>Jak zdobyć program &klipper;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Kompilacja i instalacja</title>
<para
>Program &klipper; powinien być skompilowany i zainstalowany wraz z pakietem "kdebase" i widoczny na panelu &kde; (tzn. programie &kicker;) po uruchomieniu środowiska. Jeżeli ikona programu nie jest widoczna, można go uruchomić poprzez wywołanie <guimenuitem
>Dodaj element interfejsu...</guimenuitem
> w dowolnym menu kontekstowym &kicker-dopelniacz; (Panelu &kde;) i wybranie  <guilabel
>Klipper</guilabel
> w oknie dialogowym.</para
> 

<screenshot>
<screeninfo
>Ikona programu &klipper;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Zrzut ekranu</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<!--
<para
>To remove &klipper; from your panel, select <guimenuitem
>Remove
Klipper</guimenuitem
> from the context menu (accessed by left-clicking the
small handle to the left of the &klipper; icon).</para>
-->
<!--
<para
>To disable this, simply remove the file 
<filename
>$<envar
>KDEDIR</envar
>/share/autostart/klipper.desktop</filename>
or create a file <filename
>$<envar
>HOME</envar
>/share/autostart/klipper.desktop</filename>
with the following contents:

<programlisting
>
[Desktop Entry]
Hidden=true
</programlisting>

The latter will keep the system installation intact and only prevent
&klipper; being started for you, without affecting other users.
</para>
-->
</sect1>
</appendix>

&documentation.index; 

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