# Podręcznik programu &klipper;

## Wprowadzenie

&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: http://mosehansen.dk/about).

## Korzystanie z programu &klipper;

### Operacje podstawowe

Ikona programu&klipper;. Ikona programu&klipper;

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

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ąć &Alt;L .

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

### Działania

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 http:// może zostać przesłany do programów &Netscape; lub &konqueror; .i otwarty w ich oknie jako strona w sieci Internet.

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.

Jeżeli użytkownik nie chce wykonywać żadnych działań związanych z zawartością schowka powinien wybrać w menu pozycjęNic nie rób co zamknie menu i pozwoli na kontynuację pracy. Możliwe jest ustawienie czasu wyświetlania wyskakującego menu, w oknie Konfiguracja Klippera... w karcie Ogólne poprzez zmianę suwaka Czas wyświetlania menu działań.

Wykonywanie działań może zostać wyłączone poprzez kliknięcie na ikonę programu &klipper; oraz wybranie pozycji Włącz działania lub naciśnięcie klawiszy &Ctrl;&Alt;X.

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

Naciśnięcie klawisza &Ctrl;&Alt;R spowoduje wyświetlenie menu pozwalającego na powtórzenie ostatnio wykonanego przez program &klipper; działania.

### Zachowanie schowka/wyboru

#### Informacje ogólne

Za pomocą programu &klipper; można skonfigurować sposób działania schowka i zaznaczenia w środowisku &kde;.

Środowisko okienkowe &X-Window; wykorzystuje dwa oddzielne bufory dla zaznaczenia oraz schowka. 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 &Ctrl;X lub &Ctrl;C . Wklejanie tekstu z bufora schowka odbywa się za pomocą klawiszy &Ctrl;V lub poprzez wybór pozycji w menu Edycja Wklej .

#### Zmiana zachowania schowka/wyboru

Aby zmienić sposób obsługi operacji schowka/zaznaczania, należy wybrać z menu programu pozycję Konfiguracja Klippera... i w wyświetlonym oknie dialogowym wybrać kartę Ogólne. Wybranie opcji Rozdziel schowek i zaznaczenie włącza tradycyjne - opisane wcześniej - zachowanie czyli oddzielne bufory dla schowka i zaznaczenia. Dodatkowo możliwe jest wtedy ustawienie opcji Ignoruj wybór 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 Synchronizuj zawartość schowka i zaznaczenia 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ą środkowego przycisku myszy ale również za pomocą kombinacji klawiszy &Ctrl;V . Dotyczy to także teksty znajdującego się w buforze schowka.

## Konfiguracja programu

### Wyświetlanie okna konfiguracji

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

### Parametry ogólne

Menu w pozycji kursora myszy

- 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.

Zapisz schowek przy wyjściu

- 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.

Usuwaj spacje przy uruchamianiu działań

- 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.

Wykonaj działania na pozycji wybranej z historii

- 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).

Nigdy nie czyść schowka

- 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.

Ignoruj wybór

- Powoduje ustawienie trybu pracy schowka. Więcej na ten temat tutaj: clipboard-modes.

Synchronizuj zawartość schowka i zaznaczenia

- Powoduje ustawienie trybu pracy schowka. Więcej na ten temat tutaj: clipboard-modes.

Rozdziel schowek i zaznaczenie

- Powoduje ustawienie trybu pracy schowka. Więcej na ten temat tutaj: clipboard-modes.

Czas wyświetlania menu działań

- Powoduje ustawienie czasu po jakim zniknie wyskakujące menu, jeżeli użytkownik nie wykona żadnej operacji.

Rozmiar historii schowka

- Określa liczbę obiektów przechowywanych w historii schowka.

### Ustawienia działań

Edycja wyrażeń/działań

- W karcie Działania 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 Enter.

Dodawanie wyrażeń/działań

- Należy kliknąć przycisk Dodaj działanie i wprowadzić wyrażenie regularne używane do dopasowywania tekstu przez program &klipper;. Program wykorzystuje standardową klasę biblioteki &Qt;: `QRegExp`, 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 grep lub egrep.

  Można dodać do wyrażenia regularnego krótki opis (np.: HTTP URL) naciskając lewy przycisk myszy w kolumnie Opis..

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

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

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

Zaawansowane...

- Wyświetla okno dialogowe Wyłącz działania dla okien typu WM_CLASS.

  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:

  1. Uruchomić program.

  2. W konsoli tekstowej należy wykonać polecenie ``xprop` | `grep` `WM_CLASS``, a następnie kliknąć na okno uruchomionego programu.

  3. Pierwszy napis wyświetlony po znaku "=" jest tym który należy wprowadzić w oknie dialogowym konfiguracji programu &klipper;.

  Po dodaniu odpowiedniej pozycji WM_CLASS dla okien tego programu nie będą generowane żadne działania.

### Skróty klawiszowe

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:

Brak

- Wybrane działanie nie będzie dostępne bezpośrednio z klawiatury

Domyślny

- Wybranej akcji zostanie przypisany domyślny klawisz programu &klipper;. Do tych skrótów odwołuje się niniejszy podręcznik.

Własny

- Użytkownik będzie mógł przypisać własną kombinację klawiszy do wywołania wybranego działania.

  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.

## Zasługi i licencje

&klipper;

Prawa autorskie do programu (c) 1998 Andrew Stanley-Jones asj@cban.com

Prawa autorskie do programu (c) 1998-2000 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;

Aktualnym opiekunem programu jest Esben Mose Hansen. Informacje dotyczące kontaktu znajdują się na stronie: http://mosehansen.dk/about.

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

&underFDL; &underGPL;

## Instalacja

### Jak zdobyć program &klipper;

&install.intro.documentation;

### Kompilacja i instalacja

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 Menu panelu Dodaj Aplet Klipper w menu kontekstowym po naciśnięciu prawym przyciskiem myszki na panelu &kde;.

Ikona programu &klipper; Zrzut ekranu
&documentation.index;