# Podręcznik &kalarm;

David
Jarvie

    &David.Jarvie.mail;

David
Jarvie

    &David.Jarvie.mail;

Programista
Maciej
Wikło

    maciej.wiklo@wp.pl

Polskie tłumaczenie
2001
2002
2003
2004
2005
2006
2007
2008
&David.Jarvie;
&FDLNotice;
2008-07-11
2.00.00

&kalarm; jest osobistym harmonogramem alarmów, poleceń i e-maili dla &kde;.

KDE
kdepim
kalarm
alarm
przypomnienie
harmonogram

## Wprowadzenie

&kalarm; pozwala planować wyświetlanie osobistych komunikatów alarmowych, odtwarzanie plików dźwiękowych, wykonywanie poleceń i wysyłanie wiadomości e-mail.

W domyślnym trybie graficznym &kalarm; wyświetla listę oczekujących alarmów, pokazując ich czas i szczegóły. Możesz utworzyć nowe alarmy lub wybrać jeden z istniejących do modyfikacji lub usunięcia. Możesz też opcjonalnie wyświetlić wygasłe alarmy.

Podczas konfiguracji alarmu możesz wybrać, czy powinien on być powtarzany oraz, czy powinien być anulowany, jeśli nie może być wywołany w zaplanowanym czasie. Dla alarmów wyświetlających komunikaty możesz wpisać wiadomość tekstową, określić tekst lub obrazek do wyświetlenia lub wpisać polecenie do wykonania. Możesz też wybrać kolor wiadomości oraz zdecydować, czy odtworzyć dźwięk lub wymówić wiadomość.

Alarmy mogą być również planowane z wiersza poleceń lub przez wywołania D-Bus z programów.

Gdy zaplanowano komunikat alarmowy, jest on wyświetlany na wszystkich pulpitach &kde;, aby upewnić się, że go nie przegapisz. Okno wiadomości pokazuje czas, na który zaplanowano wyświetlenie wiadomości. Zazwyczaj znajduje się w tym oknie również opcja odroczenia, powodująca późniejsze wyświetlenie alarmu. Przykład komunikatu alarmowego:

Zrzut ekranu z oknem wiadomości programu &kalarm;
Komunikat alarmowy

Gdy alarm tylko wykonuje polecenie lub wysyła e-mail, &kalarm; nie wyświetla żadnych komunikatów.

&kalarm; zazwyczaj wyświetla ikonę w tacce systemowej, jednakże może być ona ukryta, jeśli tak ustawiono.

## Używanie programu &kalarm;

Gdy wywołanie &kalarm; nastąpiło bez żadnych parametrów wiersza poleceń, program uruchamiany jest w trybie graficznym i wyświetla aktualną listę oczekujących alarmów.

Wszystkie pola przewijane w &kalarm; mają zintegrowane przyspieszenie. Aby spowodować zmianę wartości na większe kroki, przytrzymaj klawisz &Shift; podczas klikania na przyciski strzałek pól przewijanych.

### Lista alarmów

W głównym oknie &kalarm; znajduje się lista oczekujących obecnie alarmów, zawierająca ich czas, powtórzenia, kolory oraz wiadomości, pliki, polecenia lub tematy wiadomości e-mail. (W przypadku alarmów powtarzalnych pokazywany jest następny zaplanowany czas. W przypadku alarmów z przypomnieniem wyświetlany jest czas pierwotny, nie zaś czas przypomnienia.) Ikona po lewej każdego tekstu/pliku/polecenia/tematu określa typ alarmu.

Zrzut ekranu z głównym oknem &kalarm;.
Główne okno

W przypadku alarmów powtarzanych lista pokazuje następne zaplanowane powtórzenie i częstotliwość powtarzania alarmu (&eg; 1 dzień dla codziennego powtarzania, 3 tygodnie dla powtarzania w każdy poniedziałek i środę za trzy tygodnie, Logowanie dla alarmu powtarzanego przy zalogowaniu).

Alarmy mogą być porządkowane według daty/czasu, częstotliwości powtarzania, koloru, rodzaju lub tekstu za pomocą kliknięcia na pasek tytułu odpowiedniej kolumny. Aby odwrócić porządek sortowania, kliknij ponownie na tytuł kolumny.

Opcjonalnie można włączyć wyświetlanie czasu pozostałego do pojawienia się zaplanowanego alarmu, razem z czasem zaplanowanym na wyświetlenie tego alarmu lub zamiast niego. Aby pokazać/ukryć kolumnę czasu alarmu, wybierz Widok Pokaż czasy alarmów. Aby pokazać/ukryć kolumnę czasu do alarmu, wybierz Widok Pokaż czas do alarmu. Wyświetlana jest co najmniej jedna z tych kolumn.

Jeśli używasz kilku zasobów alarmów, możesz kolorować alarmy odpowiednio dla każdego zasobu, wybierając inny kolor tła dla każdego zasobu.

#### Nieaktualne alarmy

Domyślnie &kalarm; archiwizuje alarmy na określony czas po ich wygaśnięciu lub usunięciu. (Jednakże usunięte alarmy są zapisywane tylko, jeśli są powtarzane co najmniej raz.) Możesz ustawić sposób i czas archiwizacji wygasłych alarmów w &kalarm; w oknie Ustawienia.

Zarchiwizowane alarmy mogą być również wyświetlane na liście. W tym celu wybierz Widok Pokaż nieaktualne alarmy. Aby je ponownie ukryć, wybierz Widok Ukryj nieaktualne alarmy.

#### Przeszukiwanie listy alarmów

Możesz przeszukiwać listę alarmów, aby znaleźć alarm zawierający dany tekst. Aby tego dokonać, wybierz Edycja Znajdź. W oknie wyszukiwania wybierz typy alarmów, które chcesz znaleźć. Aby kontynuować wyszukiwanie dla większej ilości pasujących alarmów, wybierz Edycja Znajdź następny lub Edycja Znajdź poprzedni .

Wyszukiwanie jest przygotowane następująco:

- Teksty komunikatów alarmowych: wyszukiwany jest tekst komunikatu.

- Alarmy wyświetlające pliki: wyszukiwana jest ścieżka/&URL; pliku.

- Alarmy uruchamiające polecenia: wyszukiwany jest wiersz polecenia lub skrypt polecenia.

- Alarmy e-mail: przeszukiwane są temat, treść wiadomości, jej odbiorcy i adresy URL załączników.

W wyszukiwaniu uwzględniane są tylko alarmy aktualnie znajdujące się na liście. Więc jeśli chcesz przeszukać zarchiwizowane alarmy, musisz najpierw wyświetlić je w sposób opisany w powyższej sekcji.

### Tworzenie i zarządzanie alarmami

#### Tworzenie nowego alarmu

Aby utworzyć nowy alarm, wykorzystaj jeden z poniższych sposobów, a następnie wybierz typ alarmu z nowo otwartej listy. Wyświetla to okno Zmień alarm, za pomocą którego skonfigurujesz alarm.

- Wybierz Działania Nowy.

- Prawym przyciskiem myszy kliknij na ikonę w tacce systemowej i wybierz Nowy z menu kontekstowego.

- Kliknij środkowym przyciskiem myszy na ikonę w tacce systemowej.

- Prawym przyciskiem myszy kliknij na listę alarmów i z menu kontekstowego wybierz Nowy.

- Kliknij dwukrotnie na pustą przestrzeń pod ostatnim wpisie na liście alarmów.

Możesz również tworzyć nowe skonfigurowane alarmy z różnych źródeł:

- Aby utworzyć nowy alarm na podstawie istniejącego szablonu, zapoznaj się z działem Szablony alarmów.

- Aby oprzeć nowy alarm na istniejącym już, wybierz istniejący alarm z listy, a następnie wybierz Działania Kopiuj. Zostanie otwarte okno Zmień alarm z wypełnionymi już odpowiednimi polami.

- Aby utworzyć nowy alarm wyświetlający istniejącą wiadomość e-mail, przeciągnij wiadomość z &kmail; do głównego okna &kalarm; lub do ikony programu w tacce systemowej. Zostanie otwarte okno Zmień alarm, zawierające całą wiadomość e-mail (włącznie z nadawcą, odbiorcą &etc;) jako tekst alarmu.

- Aby utworzyć nowy alarm e-mail wysyłający kopię istniejącej wiadomości e-mail, przeciągnij ją z &kmail; do głównego okna &kalarm; lub do ikony programu w tacce systemowej. Następnie wybierz opcję E-mail. Okno Zmień alarm zawiera całą wiadomość e-mail oprócz nadawcy.

- Przeniesienie dowolnego fragmentu tekstu do okna głównego &kalarm; lub do ikony programu w tacce systemowej spowoduje otwarcie okna Zmień alarm i ustawienie tekstu alarmu.

- Aby utworzyć alarm wyświetlający plik, przenieś &URL; pliku do okna głównego &kalarm; lub do ikony programu w tacce systemowej. Zostanie otwarte okno Zmień alarm z daną nazwą pliku.

- Możesz automatycznie tworzyć alarmy urodzinowe dla ludzi z programu &kaddressbook;. Czynność tą opisano w Importowanie urodzin z programu &kaddressbook;.

#### Zmiana istniejącego alarmu

Aby zmienić istniejący oczekujący alarm (nie można zmienić wygasłych alarmów), wypróbuj jeden z poniższych sposobów:

- Kliknij dwukrotnie na wpis alarmu na liście.

- Wybierz go, klikając wpis na liście alarmów. Następnie wybierz Działania Edycja.

- Prawym przyciskiem myszy kliknij wpis na liście alarmów i wybierz Edycja z menu kontekstowego.

Zostanie wyświetlone okno Zmień alarm.

#### Usuwanie/Ponowne aktywowanie alarmu

Aby usunąć istniejący alarm, wybierz jedną z poniższych akcji:

- Wybierz jeden lub więcej alarmów wybierając odpowiednie wpisy na liście alarmów. Następnie wybierz Działania Usuń .

- Prawym przyciskiem myszy kliknij na odpowiednich wpisach na liście alarmów i wybierz Usuń z menu kontekstowego.

Gdy usuniesz aktywny alarm, jest on archiwizowany, pod warunkiem, że został wywołany co najmniej raz przed usunięciem oraz pod warunkiem, że włączone jest archiwizowanie wygasłych alarmów. (Użyj okna Ustawienia, aby ustawić, czy i na jak długo powinny być zapisywane wygasłe alarmy.) Gdy usuniesz nieaktualny alarm lub alarm ten nie został jeszcze wywołany, nie można go już odzyskać.

Możesz ponownie aktywować usunięty z listy nieaktualnych alarmów alarm, pod warunkiem, że nie wygasł on jeszcze. Aby to uczynić, najpierw włącz wyświetlanie nieaktualnych alarmów, co opisano w Nieaktualne alarmy, a następnie:

- Wybierz jeden lub kilka nieaktualnych alarmów, klikając na ich wpisy na liście alarmów. Następnie wybierz Działania Włącz ponownie .

- Kliknij prawym przyciskiem myszy na odpowiednie wpisy na liście nieaktualnych alarmów i wybierz Włącz ponownie z menu kontekstowego.

#### Włączanie/Wyłączanie alarmów

Przejdź do sekcji Włączanie i wyłączanie alarmów, aby dowiedzieć się, jak włączać i wyłączać alarmy, każdy osobno lub wszystkie razem.

#### Podgląd alarmu

Aby włączyć podgląd istniejącego alarmu bez możliwości zmiany, postąp według jednej z poniższych wskazówek:

- Wybierz go, klikając odpowiedni wpis na liście alarmów. Następnie wybierz Działania Widok .

- Prawym przyciskiem myszy kliknij na wpis na liście alarmów i wybierz Widok z menu kontekstowego.

Zostanie otwarte okno Zmień alarm w trybie tylko do odczytu.

#### Potwierdzanie alarmu

W rozdziale Okno komunikatu alarmowego, aby dowiedzieć się, jak potwierdzać alarmy.

#### Szablony alarmów

Jeśli chcesz często tworzyć podobne do siebie alarmy, możesz utworzyć szablon alarmu, aby uniknąć konieczności wpisywania szczegółów alarmu dla każdego alarmu osobno. Szablon może zawierać wszystkie szczegóły, które może zawierać alarm, oprócz daty rozpoczęcia.

Możesz na przykład chcieć regularnie włączać alarm przypominający o programie telewizyjnym, którego pora emisji zmienia się co tydzień. Szablon będzie zawierał wszystkie szczegóły alarmu (tekst wiadomości, odtwarzany dźwięk &etc;) oprócz czasu i daty. Teraz, aby utworzyć alarm, musisz tylko otworzyć okno Zmień alarm z tym szablonem oraz wpisać czas i datę.

Aby utworzyć alarm na podstawie szablonu, otwórz okno Zmień alarm prezentujące szczegóły szablonu:

- Wybierz Działania Nowy alarm z szablonu , a następnie wybierz odpowiedni szablon.

- Prawym przyciskiem myszy kliknij na ikonę w tacce systemowej i wybierz Nowy alarm z szablonu z menu kontekstowego. Następnie wybierz odpowiedni szablon.

- Otwórz okno Zmień alarm i kliknij przycisk Wczytaj szablon..., aby otworzyć okno wyboru szablonu.

##### Konfiguracja szablonów

Możesz tworzyć, modyfikować lub usuwać szablony za pomocą okna Szablony alarmów lub utworzyć nowy szablon alarmu na podstawie istniejącego już alarmu.

Aby utworzyć nowy szablon alarmu, wykonaj jedno z poniższych działań:

- Wyświetl okno Szablony alarmów, wybierając z menu Plik Szablony... , klikając Nowy i wybierając z nowo otwartej listy typ alarmu. Zostanie wyświetlone okno edycji szablonu.

- Wyświetl okno Szablony alarmów, wybierając z menu Plik Szablony... , wybierz istniejący szablon z listy i kliknij Kopiuj. Zostanie otwarte okno edycji szablonu, wypełnione już kopią szczegółów istniejącego szablonu.

- Wybierz alarm z listy alarmów i wybierz Działania Nowy szablon . Zostanie otwarte okno edycji szablonu, wypełnione już szczegółami wybranego alarmu.

Aby zmodyfikować istniejący szablon, wyświetl okno Szablony alarmów, wybierając Plik Szablony... z menu i kliknij Edycja. Zostanie wyświetlone okno edycji szablonu, które opisano poniżej.

Aby usunąć istniejące szablony, otwórz okno Szablony alarmów, wybierając z menu Plik Szablony... , wybierz jeden lub więcej szablonów i kliknij Usuń. Zostanie wyświetlone zapytanie o potwierdzenie dokonania tej akcji.

##### Okno edycji szablonu

Okno edycji szablonu jest podobne do okna Zmień alarm. Następujące pola są inne:

- Wpisz nazwę szablonu w polu Nazwa szablonu. Jest to nazwa, która wyświetlana będzie na liście szablonów, więc najlepiej jest wybrać nazwę, która będzie przypominać o funkcji, jaką pełni szablon. Każdy szablon musi mieć inną nazwę.

- W polu Czas wybierz jedną z poniższych pozycji:

  - Domyślny czas jeśli nie chcesz planować żadnego czasu. Alarmy oparte na takim szablonie będą miały w tym polu wpisaną domyślną wartość dla nowych alarmów.

  - Zaznacz Czas, aby wpisać czas wywołania alarmu.

  - Wybierz Dowolny czas, aby ustalić jedynie datę, bez czasu.

  - Zaznacz Czas od teraz, aby wpisać jak długo (w godzinach i minutach) po utworzeniu alarmu powinien on być wywołany.

- W polu Reguła powtarzania w karcie Powtarzanie nie trzeba wybierać żadnego dnia ani miesiąca dla powtarzania tygodniowego i rocznego.

#### Zasoby alarmów

Jeśli używasz tylko jednego komputera i pracujesz niezależnie, nie ma dla Ciebie znaczenia, gdzie &kalarm; zapisuje alarmy. Lecz jeśli potrzebny jest Ci dostęp do alarmów na kilku komputerach lub w kilku miejscach na jednym komputerze, możesz zdefiniować zasoby alarmów, dzięki którym &kalarm; użyje dodatkowych kalendarzów alarmów wraz z domyślnymi lub zamiast nich.

Możesz przeglądać i zarządzać zasobami poprzez listę zasobów, która wyświetlana może być obok listy alarmów w głównym oknie programu &kalarm;. Alarmy z wszystkich zasobów zostaną pokazane razem na liście alarmów. Gdy zapiszesz nowy alarm, możesz ustawić opcję decydującą, czy będzie on automatycznie zapisywany w domyślnym zasobie, czy wyświetlone zostanie okno wyboru zasobu. Podczas edycji istniejącego alarmu, jest on automatycznie zapisywany w jego oryginalnym zasobie.

##### Rodzaje zasobów i opcje

Zasoby alarmów są grupowane przy pomocy typów alarmów i rodzaju zapisu. Mogą być wyłączane, ustawiane tylko do odczytu lub ustawiane jako domyślne.

Typ alarmu

  Istnieją trzy typy alarmów – alarmy aktywne, alarmy nieaktualne i szablony alarmów – są zapisywane w osobnych zasobach alarmów. Dlatego też &kalarm; posiada trzy standardowe domyślne zasoby, jeden dla każdego typu (więcej szczegółów na ten temat w Pytania i odpowiedzi), co możesz zmienić, jeśli tylko chcesz.

Typ zapisu

  &kalarm; posiada trzy typy zapisu zasobów alarmu:

  - Plik lokalny: Alarmy zapisywane są w osobnych plikach lokalnych formatu iCalendar. &kalarm; używa zasobów plików lokalnych domyślnie (zobacz Pytania i odpowiedzi, aby uzyskać więcej informacji na ten temat). Pliki lokalne, oprócz plików na komputerze lokalnym, mogą być również kalendarze alarmów w sieci lokalnej tak długo, dopóki nazwa ich położenia rozpoczyna się znakiem `/`.

  - Katalog lokalny: Alarmy zapisywane są w katalogu lokalnym, każdy alarm w osobnym pliku iCalendar w tym katalogu. Przy takiej metodzie zapisu, gdy któryś plik zostanie uszkodzony, utracisz tylko jeden alarm, nie zaś cały kalendarz.

  - Plik zdalny: Alarmy są zapisywane w pojedynczych plikach zdalnych formatu iCalendar. Ta metoda zapisu pozwala uzyskać dostęp do Twoich danych o alarmach z każdego miejsca lub pozwala innym oglądać Twoje alarmy. Jeśli używasz plików zdalnych, &kalarm; pracuje z lokalną pamięcią podręczną danych.

    Jeśli zdalny kalendarz alarmów jest współdzielony pomiędzy użytkownikami, zmiany dokonane przez jedną osobę mogą nie być automatycznie dostępne dla innych użytkowników lub może wystąpić opóźnienie w widoczności zmian dla pozostałych użytkowników. Dlatego też jeden użytkownik może dokonać zmiany jednocześnie z innym użytkownikiem, co może być niezauważone przez inne osoby. Przyczyną techniczną tego jest to, że zmiany dokonane przez osobę A będą dostępne dla osoby B tylko pod warunkiem, że kopia osoby A została najpierw zapisana w pliku zdalnym, a chwilę potem kopia pliku zdalnego osoby B została ponownie wczytana (odświeżona). Gdy i jeśli kalendarz jest zapisywany i ponownie wczytywany w zależności od parametrów konfiguracji zasobów, które każdy użytkownik ustawił dla tego kalendarza alarmów.

    Aby zapobiec temu problemowi, włącznie z dostosowaniem źródeł, zapisz i wczytaj ponownie parametry konfiguracji lub przyjmij zasadę, że użytkownicy inni niż posiadacze kalendarza alarmów powinni otwierać go w trybie tylko do odczytu.

Stan włączony/wyłączony

  Wyłączanie zasobu daje taki sam efekt, jak usuwanie go, oprócz tego, że wciąż jest widoczny na liście zasobów, aby można było go łatwo włączyć. Gdy wyłączono, alarmy zasobu są ignorowane i nie pojawiają się na liście alarmów lub liście szablonów. Jeśli jest ponownie włączony, alarmy są znów wyświetlane i, jeśli jest to aktywny zasób alarmów, są aktywne.

Stan tylko do odczytu

  W zasobie tylko do odczytu alarmy nie mogą być zmieniane, nie można również do takiego zasobu dodać nowych alarmów. Nie jest możliwe również odroczenie alarmów, ponieważ w alarmie musi być zapisany czas odroczenia. Po uaktywnieniu alarmów są one usuwane z zasobu i archiwizowane, dopóki Ty lub inny użytkownik zasobu nie otworzy go w trybie tylko do odczytu.

  W oknie konfiguracji zasobów możesz zmienić stan zasobów na tylko do odczytu. Niektóre zasoby jednak nie mogą być zapisywane z różnych powodów:

  - Jeśli zasób został utworzony przez inny program, niebezpieczne mogłoby być zezwalanie programowi &kalarm; na jego aktualizację, dopóki różnice w formacie danych mogą uczynić go nieużytecznym przez program, w którym został utworzony.

  - Jeśli zasób został utworzony we wcześniejszej wersji programu &kalarm;, możesz utracić dane, jeśli Twoja wersja &kalarm-dopelniacz; je zaktualizowała.

  - Jeśli zasób został utworzony w poprzedniej wersji programu &kalarm;, dane mogą być utracone lub mogą stać się nieużyteczne dla poprzedniej wersji &kalarm-dopelniacz;, gdy zaktualizujesz je za pomocą Twojej wersji programu &kalarm;. Zostaniesz zapytany, czy przekonwertować format do zapisywalnego, rozwiązując potencjalne problemy kompatybilności, jeśli poprzednia zasób zostanie otwarty w poprzedniej wersji &kalarm-dopelniacz;.

  - Jeśli nie masz uprawnień do zapisu w pliku zasobu lub katalogu.

  Jeśli potrzebujesz dostępu zapisu do alarmów w zasobie, który nie może być zapisywalny, możesz skopiować alarmy, importując je do zasobu z możliwością zapisu, używając opcji menu kontekstowego zasobu Importuj... (zobacz Importowanie alarmów z zewnętrznych kalendarzy).

Domyślny stan zasobów

  Jeden zasób każdego typu alarmów może być opcjonalnie uczyniony domyślnym zasobem dla wybranego typu alarmów. Nowe alarmy będą automatycznie zapisywane w domyślnym dla ich typu zasobie, chyba że zaznaczysz opcję pytania o wybór zasoby dla nowych alarmów i szablonów w oknie Ustawienia.

##### Używanie zasobów

Możesz przeglądać i manipulować zasobami przez listę zasobów, która może być wyświetlona lub ukryta przez Widok Pokaż zasoby . Podczas używania listy zasobów wybierz najpierw typ alarmu za pomocą pola nad listą. Następnie kliknij na jednym z przycisków poniżej listy lub kliknij prawym przyciskiem myszy na odpowiedni zasób na liście i wybierz pozycję z menu kontekstowego. Dostępne działania to:

Dodaj...

  Dodaj zasób wybranego typu do listy. Zostaniesz poproszony o wybranie typu zapisu w oknie konfiguracji zasobu, gdzie możesz również wpisać położenie źródła i jego charakterystykę. Jeśli w danym położeniu nie ma żadnego zasobu alarmów, zostanie utworzony nowy.

Usuń

  Usuń zaznaczony zasób z listy.Zasób sam w sobie pozostaje nietknięty i może powrócić na listę, jeśli jest taka potrzeba.

Zmień...

  Zmień wybrany zasób. Zostanie wyświetlone okno konfiguracji wybranego zasobu.

Wczytaj ponownie

  Wczytaj ponownie wybrany zasób. Zasób jest ponownie wczytywany z położenia zapisu, zapewniając, że nie ma niezgodności pomiędzy tym, co wyświetla &kalarm; a obecnym stanem zasobu. Jeśli zasób jest współdzielony z innymi użytkownikami, wszelkie zmiany dokonane przez nich mogą być widoczne w &kalarm-miejscownik; po ponownym wczytaniu zasobu.

  Jeśli ponownie wczytasz zasób zdalny, utracisz wszystkie zmiany dokonane od ostatniego zapisu zasobu. Wszelkie alarmy wygasłe od ostatniego zapisu mogą być również aktywowane ponownie po dokonaniu tej akcji.

Zapisz

  Zapisz zmiany dokonane w wybranym zasobie. Zasób jest aktualizowany po dokonaniu wszelkich zmian w alarmach od ostatniego zapisu zasobu lub od ponownego wczytania. Jest to opcja użyteczna tylko dla zasobów zdalnych, dopóki lokalne zasoby są automatycznie zapisywane po każdej zmianie. Możesz skonfigurować kiedy i jak często zasoby zdalne powinny być automatycznie zapisywane za pomocą okna konfiguracji (opcja Edycja... menu kontekstowego)

  Jeśli zapiszesz zasób zdalny, który jest współdzielony z innymi użytkownikami, wszelkie dokonane przez nich zmiany od ostatniego przeładowania zasobu (automatycznego lub ręcznego) zostaną utracone.

Importuj...

  Importuj alarmy z zewnętrznego pliku kalendarza do wybranego zasobu. Jest to opisane w sekcji Importowanie alarmów z zewnętrznych kalendarzy. Opcja ta nie jest dostępna dla zasobów wyłączonych i tylko do odczytu.

Pokaż szczegóły

  Wyświetl szczegóły dotyczące wybranego zasobu. Wyświetlane są: położenie zasobu, typ zapisu i informacje o stanie.

Użyj jako domyślnego

  Uczyń wybrany zasób domyślnym dla wybranego typu zasobów. Opcja ta nie jest dostępna dla zasobów wyłączonych i tylko do odczytu.

Zmień kolor...

  Wybierz kolor tła, aby wyróżnić alarmy tego zasobu na liście alarmów. Pozwala to na łatwe przejrzenie, które alarmy należą do jakich zasobów.

Wyczyść kolor

  Wyczyść kolor wyróżniający dla alarmów tego zasobu na liście alarmów.

#### Importowanie alarmów z zewnętrznych kalendarzy

Możesz importować alarmy z różnych plików kalendarzy do programu &kalarm;. Funkcja importowania przeszukuje wybrany plik kalendarza, znajdując zdarzenia zawierające alarmy i kopiuje je (z nowymi identyfikatorami) do kalendarza &kalarm;. Zdarzenia bez alarmów i wpisy kalendarza inne niż zdarzenia są ignorowane. Istnieją dwa sposoby importowania alarmów:

- Użyj Plik Importuj alarmy..., aby zaimportować alarmy wszystkich typów (aktywne, nieaktualne i szablony alarmów) z kalendarza.

  Jeśli zasoby alarmów zostały skonfigurowane, alarmy każdego typu zostaną dodane do domyślnego zasobu, jeśli zaś została wybrana opcja pytania o wybór zasobu dla nowych alarmów i szablonów w oknie Ustawienia, będzie wyświetlane zapytanie, jakiego zasobu użyć.

- Kliknij prawym przyciskiem myszy na wybrany zasób z listy zasobów i wybierz opcję Importuj... z menu kontekstowego. Spowoduje to zaimportowanie alarmów wybranego typu do tego zasobu. Jeśli na przykład wybranym typem zasobów są szablony alarmów, szablony alarmów (oraz nieaktywne i nieaktualne alarmy) zostaną zaimportowane.

Jeśli importujesz alarmy z plików kalendarzy, które zostały utworzone przez programy inne niż &kalarm;, alarmy mogą ulec zmianie podczas procesu importu – mogą się zmienić nawet czasy alarmów. Zależy to od konwencji zapisu danych używanych przez inne programy i jest to nieuniknione, jeśli konwencje te różnią się od oczekiwać &kalarm-dopelniacz;. Zawsze sprawdzaj ważne alarmy w poszukiwaniu niezamierzonych zmian i dopasowuj je, jeśli to konieczne.

#### Importowanie urodzin z programu &kaddressbook;

Możesz ustawić wyświetlanie alarmów dla urodzin zapisanych w &kaddressbook-miejscownik;, wybierając Plik Importuj urodziny.... Zostanie otwarte okno, pozwalające wybrać, dla których urodzin powinny zostać utworzone alarmy.

- W polu Tekst alarmu możesz ustawić tekst wyświetlany w komunikatach alarmowych dla urodzin. Tekst wiadomości jest tworzony z kombinacji prefiksu, czyli imienia i nazwiska osoby oraz sufiksu. Nie dodawane są żadne odstępy, więc pamiętaj o włączeniu wszelkich niezbędnych spacji kończących w prefiksie i spacji rozpoczynających w sufiksie.

  Jeśli zmienisz tekst alarmu, lista urodzin zostanie ponownie zastosowana.

- Na liście Wybierz urodziny wybierz urodziny, dla których chcesz utworzyć alarmy. Zauważ, że lista pokazuje tylko te wpisy z programu &kaddressbook;, które zawierają urodziny i które nie mają już alarmów urodzinowych w formacie wybranym w polu Tekst alarmu.

- Pozostałe opcje są takie same, jak dla alarmów tekstowych w oknie Zmień alarm.

Jeśli zasoby alarmów zostały skonfigurowane, alarmy zostaną dodane do domyślnego zasobu aktywnych alarmów, jeśli zaś wybrana została opcja pytania o zasób dla nowych alarmów i szablonów w oknie Ustawienia, zostanie wyświetlone pytanie, którego zasobu użyć.

#### Cofnij / Przywróć

Możesz cofać i przywracać ostatnie zmiany dokonane podczas aktualnej sesji &kalarm-dopelniacz;. Większość działań może być cofnięta, włącznie z tworzeniem, edycją i usuwaniem alarmów i szablonów alarmów oraz reaktywowaniem alarmów. Aby zapobiec używaniu nadmiernej ilości zasobów w historii cofnięć, liczba zmian jest ograniczona do ostatnich 12.

Aby cofnąć ostatnią zmianę, wybierz Edycja Cofnij. Aby przywrócić ostatnią cofniętą zmianę, wybierz Edycja Przywróć .

Aby cofnąć wcześniejszą zmianę, kliknij przycisk Cofnij na pasku narzędzi i przytrzymaj na nim klawisz myszy. Pojawi się lista działań z której możesz wybrać, które chcesz cofnąć. Jeśli nie ma na tej liście działania, którego szukasz, pamiętaj, że możesz potrzebować cofnąć więcej ostatnich zmian najpierw, co zależy od zamierzonej zmiany. Jeśli na przykład zmieniłeś alarm i następnie został on usunięty, nie możesz cofnąć zmiany, dopóki nie cofniesz usunięcia.

Przywracanie zmiany innej niż ostania może być dokonane w podobny sposób, przy użyciu przycisku Przywróć paska narzędzi.

### Okno Zmień alarm

Okno Zmień alarm daje możliwość przeglądu i edycji alarmu.

Zrzut ekranu z oknem Zmień alarm
Okno Zmień alarm dla wyświetlanego alarmu

#### Działania alarmów

Opcje w polu Działania różnią się w zależności od typu edytowanego alarmu.

##### Wyświetl alarmy

Alarmy wyświetlane wyświetlają okno podczas wywoływania. Wybierz metodę używaną do generowania zawartości okna alarmu, używając pola na górze:

- Wiadomość tekstowa, aby wpisać tekst komunikatu alarmowego (który może zawierać nowe linie_ w polu edycji.

- Zawartość pliku, aby wpisać ścieżkę lub adres &URL; tekstu lub obrazka, którego zawartość ma być wyświetlona jako zawartość komunikatu alarmowego. Użyj przycisku obok pola edycji, aby wyświetlić okno wyboru pliku. Opcja Powiedz nie jest dostępna dla tego typu alarmu.

- Wyjście polecenia, aby określić, że tekst wiadomości zostanie wygenerowany przez polecenie wykonane podczas wywołania alarmu. Zobacz Alarmy z poleceniami poniżej, aby dowiedzieć się, jak wpisać polecenie lub skrypt polecenia do wykonania.

Opcje dostępne dla alarmów wyświetlanych to:

- Opcja Dźwięk pozwala zdecydować, czy i jaki dźwięk odtworzyć podczas wyświetlania wiadomości. Wybierz:

  - Żaden, aby wyświetlić cichy alarm.

  - Brzęczyk, aby uruchomić brzęczyk.

  - Powiedz, aby wymówić wiadomość alarmu podczas jej wyświetlania. Opcja ta dostępna jest tylko ,jeśli masz program KTTSD (z pakietu kdeaccessibility) zainstalowany i skonfigurowany oraz kompatybilny syntezator mowy, &eg; Festival.

  - Plik dźwiękowy, aby odtworzyć plik dźwiękowy. Użyj przycisku po prawej, aby wyświetlić okno Plik dźwiękowy, które pozwoli Ci wybrać odtwarzany plik oraz ustawić głośność i opcje powtarzania. Jeśli przytrzymasz mysz nad wskaźnikiem, wyświetli się dymek dotyczący wybranego pliku dźwiękowego.

    W oknie Plik dźwiękowy:

    - Wpisz ścieżkę pliku lub użyj przycisku obok pola edycji, aby wyświetlić okno wyboru pliku. Możesz odsłuchać wybranego pliku, klikając przycisk odtwarzania po lewej pola edycji. Przycisk ten zmieni funkcję, aby dać Ci możliwość zatrzymania odtwarzania, jeśli już został odsłuchany wystarczający fragment.

    - Zaznacz Powtarzaj, aby powtarzać plik dźwiękowy tak długo, jak długo wyświetlany jest alarm. (Okno komunikatu alarmowego zawiera przycisk pozwalający przerwać odtwarzanie dźwięku, jeśli potrzebujesz ciszy, lecz wciąż chcesz mieć otwarte okno.)

    - Zaznacz Głośność i przesuń suwak, jeśli chcesz zmienić głośność odtwarzanego pliku.

    - Jeśli chcesz, możesz włączyć narastanie głośności. Przenikanie to rozpoczynanie odtwarzania pliku dźwiękowego na jednym poziomie głośności i stopniowe przechodzenie do ostatecznego poziomu głośności, przez określony czas. Ostateczna głośność to ta ustalona w polu Narastanie powyżej. Aby włączyć narastanie, zaznacz Narastanie, a następnie ustal okres czasu w sekundach w polu Czas narastania oraz dopasuj suwak Głośność początkowa.

    Możesz użyć przycisku Testuj dźwięk, aby przetestować wybrane poziomy dźwięku.

- Użyj przycisku Czcionka i kolor..., aby wybrać czcionkę oraz kolor pierwszoplanowy i tło komunikatu alarmowego. W oknie Wybierz czcionkę i kolor alarmu wybierz Użyj domyślnej czcionki, aby wyświetlić treść wiadomości w domyślnie ustawionym kroju czcionki w czasie wyświetlania wiadomości. Aby wybrać osobną czcionkę dla wiadomości, odznacz pole Użyj domyślnej czcionki. (Domyślna czcionka i kolory wyświetlane na liście wyboru kolorów mogą być ustawione w oknie Ustawienia.)

  Wybrana czcionka i kolory wyświetlane są w przykładowym tekście wzdłuż przycisku. Możesz zmienić ten tekst, aby zobaczyć znaki specjalne.

- Użyj przycisku Działania specjalne..., aby określić polecenia powłoki do wykonania przed lub po wyświetleniu alarmu. W oknie Działania specjalne alarmów:

  - W polu Działanie przed alarmem wpisz polecenie powłoki do wykonania przed wyświetleniem alarmu. Zauważ, że &kalarm; zaczeka z wyświetleniem alarmu do ukończenia polecenia.

    Działanie przed alarmem wykonywane jest tylko raz podczas początkowego wyświetlania wiadomości, także gdy komunikat alarmowy jest zastępowany wiadomością przypominającą. Nie ono wykonywane w żadnym z poniższych przypadków:

    - Gdy wyświetlane jest przypomnienie

    - Gdy wiadomość jest ponownie wyświetlona po odroczeniu alarmu.

    - Gdy wiadomość została wyświetlona w czasie wylogowania i jest odnowiona podczas zalogowania.

    - Gdy wykonywany jest alarm powtarzalny, lecz komunikat alarmowy (lub odroczony komunikat alarmowy) z poprzedniego powtórzenia alarmu jest nadal widoczny; innymi słowy, gdy poprzednie powtórzenie alarmu nie zostało jeszcze zatwierdzone.

  - W polu Działanie po alarmie wpisz polecenie powłoki do wykonania po zatwierdzeniu alarmu (czyli po kliknięciu przycisku Zamknij lub użyciu przycisku zamknij na pasku tytułowym okna.) Nie jest ono wykonywane w żadnym z poniższych przypadków:

    - Gdy zamknięta jest wiadomość przypominająca.

    - Gdy odroczysz alarm, nawet gdy odroczony alarm jest ostatecznie zatwierdzony.

    - Gdy komunikat alarmowy jest zamknięty z powodu wylogowania.

  Zobacz Alarmy z poleceniami poniżej, gdzie dowiesz się, jak wykonywane są polecenia powłoki.

##### Alarmy z poleceniami

Alarmy z poleceniami wykonują polecenie bez wyświetlania żadnego komunikatu alarmowego.

Ten typ alarmu nie jest dostępny, jeśli &kde; jest uruchomione w trybie kiosk.

Oto dostępne opcje dla alarmów z poleceniami:

- Pole Wprowadź skrypt pozwala wybrać, czy wpisać polecenie powłoki czy skrypt.

  Jeśli ta opcja nie jest zaznaczona, możesz wpisać polecenie powłoki do wykonania. Polecenie jest przekazywane do domyślnej powłoki (zdefiniowanej w zmiennej środowiskowej `SHELL`) i może decydować, czy opcje, parametry, polecenia &etc; są dozwolone dla powłoki w pojedynczym wierszu polecenia.

  Jeśli ta opcja jest zaznaczona, możesz wpisać tekst skryptu do wykonania. Pamiętaj, by w pierwszym wierszu zawrzeć coś, jak `#!/bin/bash`, aby upewnić się, że zostanie wykorzystany poprawny interpretator poleceń.

- Użyj obszaru Wynik polecenia, aby określić, co należy wykonać z wyjściem terminala, które polecenie produkuje podczas jego wykonywania.

  - Zaznacz Wykonaj w oknie terminala, aby spowodować wykonanie polecenia w oknie terminala. Możesz wybrać, jaki typ okna terminala zostanie wyżyty w oknie Ustawienia.

  - Zaznacz Zapisz do pliku, aby zapisać wynik polecenia w pliku. Wyjście, poprzedzone nagłówkiem wyświetlającym czas, na który zaplanowano wykonanie polecenia, zostanie dołączony do istniejącej zawartości pliku. W polu edycji wpisz nazwę pliku lub użyj przycisku obok pola edycji, aby wyświetlić okno wyboru pliku.

  - Zaznacz Porzuć, aby porzucić wynik polecenia.

##### Alarmy e-mail

Alarmy e-mail wysyłają wiadomości e-mail bez wyświetlania jakichkolwiek komunikatów alarmowych.

Wypełnij adresy odbiorców, temat wiadomości i jej zawartość w trzech polach edycji. Użyj przycisku obok pola adresatów, aby wyświetlić Twoją książkę adresową &kde;, z której możesz wybrać adresy e-mail odbiorców. Załączniki możesz dodać za pomocą przycisku Dodaj.... Załączone pliki muszą nadal istnieć podczas wywołania alarmu; &kalarm; nie zapisuje kopii tych plików przy dodawaniu nowego alarmu. Aby usunąć załącznik, zaznacz go na liście i kliknij przycisk Usuń.

Ustaw poniższe opcje:

- Pole Od pozwala wybrać, której tożsamości &kmail; użyć jako Twojego adresu e-mail do wysłania poczty. Opcja pojawia się tylko, jeśli Twój adres Od w oknie Ustawienia jest ustawiony na Użyj tożsamości &kmail-dopelniacz;. W przeciwnym wypadku Twój adres e-mail zostanie ustawiony w oknie Ustawienia, nieodpowiednio przekładając tą opcję.

- Zaznacz Kopiuj e-mail do siebie, aby wysłać kopię wiadomości na Twoje konto e-mail po wykonaniu alarmu. Adres e-mail, na który zostanie wysłana kopia może być ustawiony w oknie Ustawienia, domyślnie będąc Twoim adresem e-mail ustawionym w Centrum Sterowania &kde;.

#### Odroczenie

Jeśli alarm jest alarmem powtarzalnym i został odroczony po ostatnim jego wyświetleniu, obszar Odroczony alarm wyświetla czas, do którego został odroczony alarm. Zmień... wyświetla okno, które pozwala zmienić czas odroczenia lub je anulować.

#### Czas

W obszarze Czas wybierz

- Data/czas, aby wpisać datę i czas wywołania alarmu. Wybierz Dowolny czas, jeśli chcesz wybrać tylko datę alarmu: w takim przypadku alarm zostanie wyświetlany przy pierwszej okazji lub po skonfigurowanym czasie "rozpoczęciu dnia" w określonym dniu. (Konfiguracja: &kalarm; opisuje, jak ustawić czas "rozpoczęcia dnia".)

  Dla alarmów niepowtarzalnych data/czas, które tu wpiszesz muszą być w przyszłości, gdy zaś wpisana została tylko data, musi to być dziś lub później. Dla alarmów powtarzalnych nie ma ograniczeń, ponieważ data/czas rozpoczęcia zostaną automatycznie dostosowane do pierwszego powtórzenia po obecnym czasie.

- Czas od teraz, aby wpisać, jak długo od teraz (w godzinach i minutach) alarm powinien być wywołany.

Wybierz strefę czasową dla alarmu. Strefa czasowa jest używana dla wszystkich dat i czasów powiązanych z tym alarmem, włącznie z powtórzeniami oraz wyjątkowymi datami/czasami. Normalnie powinieneś pozostawić opcje strefy czasowej niezmienione, chyba, że masz dobry powód, żeby je zmienić.

- Z listy rozwijanej wybierz strefę czasową, której chcesz użyć do alarmu. Podczas tworzenia nowego alarmu jest ona ustawiona już na strefę wybraną w oknie Ustawienia, która jest domyślną strefą czasową Twojego komputera, dopóki jej nie zmienisz.

- Zaznacz Ignoruj strefę czasową, jeśli chcesz użyć lokalnego czasu komputera (na jakimkolwiek komputerze zostanie uruchomiony &kalarm;), ignorując strefy czasowe.

  Nie jest zalecane wybieranie tej opcji, jeśli powtarzanie alarmu jest określone w godzinach i minutach; jeśli to uczynisz, alarm może wystąpić nieoczekiwanie wiele razy po zapisaniu zmiany czasu na letni/zimowy.

#### Przypomnienie

Dla alarmów wyświetlających komunikaty zaznacz Przypomnienie, jeśli chcesz wyświetlać przypomnienie przed głównym alarmem i przed każdym powtórzeniem (jeśli są ustalone). Wpisz, jak długie powinno być wyprzedzenie, używając opcji edycji obok pola wyboru.

Przypomnienia nie są wyświetlane dla podpowtórzeń. Powtórzenia są wyświetlane tylko przed każdym powtórzeniem głównym alarmu.

Jeśli alarm jest powtarzany, zaznacz Przypomnij tylko przy pierwszym powtórzeniu, jeżeli chcesz użyć przypomnienia tylko przed pierwszym powtórzeniu alarmu. Jeśli ta opcja nie jest zaznaczona, okres przypomnienia jest ograniczony do wartości mniejszych od częstotliwości powtarzania.

#### Anulowanie

Opcje anulowania spóźnionych alarmów określają, jak alarm jest traktowany po jego zaplanowanym czasie.

- Pole wyboru Anuluj spóźnione alarmy określa, co dzieje się, gdy alarm nie może być wywołany w zaplanowanym czasie.

  Zaznacz to pole, aby anulować alarm, jeśli nie może być on wywołany we wprowadzonym tu okresie po jego zaplanowanym czasie. Okres czasu może być wybrany przy pomocy elementów, które pojawią się, gdy zaznaczysz pole wyboru. Jeśli na przykład wpiszesz okres jednej godziny, alarm zostanie wywołany przy pierwszej okazji do godziny po zaplanowanym czasie, lecz nie może zostać wywołany po upłynięciu tego czasu.

  Spóźnienie alarmów, dla których ustalono tylko datę, czyli takich, które mają zaznaczoną opcję Dowolny czas, jest obliczane od czasu "rozpoczęcia dnia" w zaplanowanym dniu alarmu.

  Pozostaw pole niezaznaczone, aby wywołać alarm przy pierwszej okazji, rozpoczynając od zaplanowanego czasu, bez względu na opóźnienie alarmu.

  Alarm może być wykonany tylko, gdy jesteś zalogowany(a) i gdy uruchomione są zarówno &kalarm;, jak i X.

- Zaznacz Automatycznie zamknij okno po tym czasie, jeśli chcesz, aby okno alarmu zostało automatycznie zamknięte, gdy będzie wciąż wyświetlane w dniu wygaśnięcia czasu anulowania spóźnionych alarmów.

#### Powtarzanie

Określ, czy lub jak alarm powinien być powtarzany, używając karty Powtarzanie.

Podstawowa charakterystyka powtórzenia alarmu jest dla ułatwienia wyświetlana w tytule karty Powtarzanie. Częstotliwość powtarzania jest pokazywana jako pierwsza, zaraz po niej zaś częstotliwość podpowtórzenia, zmieniana za pomocą przycisku Podpowtórzenie.

W obszarze Reguła powtarzania wybierz typ powtarzania lub częstotliwość czasu, jak następuje:

- Aby wywołać alarm tylko raz, wybierz Bez powtarzania.

- Wybierz Przy logowaniu, aby wywołać alarm przy każdym zalogowaniu, aż do zaplanowanego czasu zakończenia. W zaplanowanym czasie zakończenia zostanie on wywołany ostatni raz. (Alarm powtarzany przy zalogowaniu będzie również wywołany za każdym razem, gdy zrestartujesz &kalarm;.)

- Aby alarm powtarzał się w regularnych odstępach czasu, wybierz jeden z typów okresu czasu, a następnie w polu Powtarzaj co wpisz, jak dużo okresów czasu powinno upłynąć pomiędzy powtórzeniami. Aby na przykład powtórzyć alarm co dwa tygodnie, wybierz Dni i wpisz 14 lub wybierz Tygodnie i wpisz 2. W zależności od wybranego typu okresu czasu możesz mieć do dyspozycji różne opcje:

  - Dla powtarzania tygodniowego, kliknij każdy dzień w tygodniu, w którym chcesz wywołać alarm.

  - W przypadku powtarzania miesięcznego, możesz wybrać zarówno stałą datę, jak i pozycję (&eg; drugi wtorek miesiąca).

  - Dla powtarzania rocznego możesz wybrać stały dzień w miesiącu lub pozycję w miesiącu (&eg; ostatnia sobota maja). Zaznacz każdy miesiąc roku, w którym chcesz wywołać alarm.

  Aby ustawić powtarzanie codziennego alarmu tylko w weekendy, użyj powtarzania tygodniowego i zaznacz każdy dzień weekendu.

W obszarze Koniec powtarzania ustaw całkowity czas powtarzania, jak poniżej:

- Wybierz Bez końca, aby kontynuować powtarzanie bez końca.

- Wybierz Koniec po, aby określić liczbę powtórzeń alarmu.

- Wybierz Koniec o, aby określić datę/czas, do których alarm będzie powtarzany. Zostanie użyta ta sama strefa czasowa, której użyto w czasie rozpoczęcia alarmu.

  Data/czas zakończenia decyduje, kiedy alarm zostanie wywołany po raz ostatni, lecz nie ogranicza podpowtórzeń. Jeśli skonfigurowano podpowtórzenia, zostaną one normalnie wywołane po ostatnim powtórzeniu głównym, bez względu na datę/czas zakończenia.

Jeśli chcesz wyłączyć z powtarzania niektóre daty/czasy, ustaw je w obszarze Wyjątki. Lista wyjątków (czyli wyłączonych dat/czasów) jest wyświetlana po lewej. Aby dodać nowy wyjątek, wpisz datę po prawej i naciśnij Dodaj. Aby zmienić wyjątek, zaznacz go na liście, wpisz nową datę po prawej i naciśnij Zmień. Aby usunąć wyjątek, wybierz go na liście i naciśnij Usuń.

Możesz ograniczyć alarm do powtarzania tylko podczas czasu pracy, zaznaczając Tylko podczas godzin pracy. Nie zmieni to sposobu zaplanowania alarmu; blokuje to tylko alarm, gdy ma być wywołany poza godzinami pracy. Dni i godziny pracy można ustawić w oknie Ustawienia.

##### Podpowtarzanie

Możesz użyć przycisku Podpowtarzanie, aby ustawić powtarzanie "w powtarzaniu". W takim przypadku przy każdym wywołaniu określonym w głównym powtarzaniu, zamiast wywoływania tylko raz jest on wywoływany wielokrotnie, w zależności od danych podpowtarzania. Aby na przykład ustawić alarm powtarzany co godzinę od południa do godz. 18 każdego czwartku, ustaw powtarzanie tygodniowe w czwartki o 12 i użyj podpowtarzania, aby dodać cogodzinne powtarzanie (sześciokrotne lub do 6 godzin).

W oknie Podpowtarzanie, które wyświetla się po kliknięciu przycisku Podpowtarzanie zaznacz Powtarzaj co, aby ustawić powtórzenie lub odznacz to pole, aby usunąć powtórzenie. Jeśli zaznaczono Powtarzaj co, ustaw powtarzanie następująco:

- Wprowadź okres czasu pomiędzy powtórzeniami za pomocą elementów obok Powtarzaj co. Wybierz odpowiednie jednostki czasu (&eg; dni), a następnie wpisz ich liczbę.

- Wybierz liczbę powtórzeń lub czas jego trwania:

  - Wybierz Liczba powtórzeń, aby wpisać, ile razy alarm powinien być wywołany po głównym powtórzeniu. Aby na przykład wywołać alarm 4 razy przy każdym głównym powtórzeniu, czyli 3 dodatkowe razy, wpisz tu 3.

  - Wybierz Czas trwania, aby wpisać całkowity okres czasu, podczas którego alarm powinien być powtórzony. Nie musi to być dokładna wielokrotność częstotliwości powtarzania; czas ten zostanie automatycznie zaokrąglony po kliknięciu przycisku OK.

Aby uniknąć zachodzenia podpowtórzeń tego samego alarmu, czas trwania podpowtórzeń jest ograniczony maksymalnie do wartości pomiędzy głównymi powtórzeniami. Przy każdym wywołaniu alarmu zgodnie z głównym powtórzeniem każde aktywne podpowtarzanie alarmu aktywowane przy ostatnim powtórzeniu jest automatycznie anulowane.

#### Inne opcje

Dla alarmów wyświetlanych pole Potwierdź odczytanie pozwala określić, czy wyświetlona ma być prośba o potwierdzenie przy zamknięciu komunikatu alarmowego. Może to być użyte jako ubezpieczenie przed przypadkowym zamknięciem okna.

Wybierz Pokaż w &korganizer-miejscownik;, aby dodać alarm do aktywnego kalendarza &korganizer-dopelniacz;, gdzie pojawi się wydarzenie bez alarmu. Opcja ta pozwala śledzić alarmy w &korganizer-miejscownik; za pomocą funkcji &kalarm-dopelniacz;.

Jeśli później zmienisz lub usuniesz alarm w &kalarm-miejscownik;, zdarzenie &korganizer-dopelniacz; zostanie jednocześnie zmienione lub usunięte. Lecz jeśli zmienisz zdarzenie w &korganizer-miejscownik;, alarm &kalarm-dopelniacz; nie zostanie zmieniony.

Kliknij przycisk Wczytaj szablon, aby wybrać szablon, za pomocą którego chcesz wypełnić okno, jak opisano w Tworzenie i zarządzanie alarmami

Kliknij przycisk Próbuj, aby przetestować alarm i sprawdzić, czy działa poprawnie. Alarm jest wykonywany tak, jak został zaplanowany.

Kliknij przycisk OK, gdy wszystkie szczegóły zostały poprawnie wprowadzone, aby dodać alarm do listy zaplanowanych alarmów.

### Okno komunikatu alarmowego

Gdy komunikat alarmowy zostaje wywołany, jest on wyświetlany na wszystkich pulpitach &kde; i nie może być zakryty zwykłymi oknami, aby upewnić się, że zostanie zauważony. Okno komunikatu pokazuje czas, na który został zaplanowany alarm, więc możesz zobaczyć, kiedy okienko zostało otwarte, jeśli przez jakiś czas nie było Cię przy komputerze. Jeśli czas zaplanowania alarmu jest w innej strefie czasowej niż ta ustawiona w Twoich ustawieniach systemowych, zostanie wyświetlona strefa alarmu. (W przypadku przypomnień data/czas dotyczą głównego alarmu lub jego powtórzenia, nie zaś czasu przypomnienia, a tytuł okna to Przypomnienie.)

Okna komunikatów alarmowych pozostają widoczne, dopóki nie potwierdzisz ich odczytania, chyba że została zaznaczona opcja Automatycznie zamknij okno po tym czasie w oknie Zmień alarm. W przypadku alarmu powtarzanego, jeśli niezatwierdzone okno wiadomości pozostaje z poprzedniego wywołania alarmu, istniejące okno jest po prostu przenoszone na górę, gdy alarm jest powtarzany. Dzięki temu można uniknąć konieczności zatwierdzania wielu kopii tej samej wiadomości, czego raczej sobie nie życzysz, lub gdy nie możesz zatwierdzić wiadomości wtedy, gdy się ona pojawia.

komunikatu alarmowego dostarcza

- Zatwierdź alarm, klikając przycisk Zamknij. Spowoduje to zamknięcie okna (po zapytaniu o potwierdzenie, jeśli została wybrana opcja Potwierdź odczytanie).

- Edytuj alarm, klikając przycisk Edycja.... Zostanie wyświetlone okno Zmień alarm.

- Wyświetl opcje, aby odroczyć alarm przed spóźnieniem poprzez kliknięcie przycisku Odrocz.... Następnie wybierz Odrocz do daty/czasu, aby wpisać datę i czas ponownego wyświetlenia komunikatu lub wybierz Odroczenie na dany odstęp czasu, aby wpisać, jak długo od teraz (w godzinach i minutach) wiadomość powinna być wyświetlona ponownie. Kliknij następnie Odrocz, aby odroczyć komunikat alarmowy i zamknąć jego okno.

  Czas, na jaki alarm został odroczony musi być wcześniej, niż następne zaplanowane powtórzenie lub następne przypomnienie. Z tego powodu przycisk Odrocz... w oknie komunikatu alarmowego i przycisk OK w oknie Odroczenie są wyłączane minutę przed następnym powtórzeniem lub przypomnieniem.

  Przycisk Odrocz... nie jest dostępny dla alarmów, które są wyświetlane przy logowaniu i mają zaznaczoną opcję Powtarzanie przy logowaniu.

- Zatrzymaj odtwarzanie pliku dźwiękowego, klikając przycisk z symbolem stop.

- Jeśli komunikat alarmowy został utworzony, przeciągając e-mail z &kmail-dopelniacz;, możesz bezpośrednio uzyskać dostęp do wiadomości w &kmail-miejscownik;, klikając przycisk z ikoną &kmail-dopelniacz;. Wiadomość zostanie wybrana i podświetlona na liście folderów w &kmail-miejscownik;.

  Jeśli indeksy &kmail-dopelniacz; są ponownie generowane, dowiązanie do wiadomości w &kmail-miejscownik; zostanie utracone.

- Przycisk z ikoną &kalarm-dopelniacz; dostarcza wygodny sposób aktywacji &kalarm-dopelniacz;.

W oknie Ustawienia możesz wybrać, które dwa schematy zostaną użyte w oknach komunikatów alarmowych.

- Okna wyświetlane są jak najdalej od obecnej pozycji kursora myszy. Powoduje to możliwość dalszej pracy i zmniejsza ryzyko przypadkowego zatwierdzenia alarmu.

- Okna wyświetlane są na środku ekranu. Aby zredukować szansę przypadkowego zatwierdzenia alarmu, przyciski okna są początkowo wyłączone, stają się aktywne dopiero po określonym czasie.

W oknie Ustawienia możesz również wybrać, który z dwóch różnych trybów powinien zostać użyty do wyświetlania okien komunikatów alarmowych:

- Jako normalne okno. W tym trybie aktywacja klawiatury jest przejmowana przez okno alarmu, gdy się ono pojawi, więc jeśli w tym czasie piszesz, praca zostanie przerwana, a działania klawiszowe będą przekazywane do okna alarmu, nie zaś do używanego właśnie programu.

- Jako nienormalne okno. W tym trybie aktywacja klawiatury nie jest zmieniana, gdy okno alarmu pojawia się, nie przeszkodzi więc to w pisaniu. W tym trybie jednakże okno nie ma paska tytułowego ani ramki, nie możesz więc go przenieść ani zmienić jego rozmiaru.

### Działania w tacce systemowej

&kalarm; domyślnie wyświetla ikonę w tacce systemowej. Ikona dostarcza zarówno kontrolę, jak i monitorowanie zmiany stanu alarmów. Normalna ikona &kalarm-dopelniacz; powiadamia o monitorowaniu alarmów, podczas gdy zielona ikona informuje, że alarmy nie są monitorowane.

Jeśli przytrzymasz kursor myszy nad ikoną w tacce systemowej, w dymku pojawi się spis pierwszych kilku alarmów do wykonania w następnych 24 godzinach. Możesz wyłączyć tą funkcję lub skonfigurować liczbę wyświetlanych alarmów i ich format w oknie Ustawienia.

Kliknij lewym przyciskiem myszy na ikonę w tacce systemowej, aby włączyć/wyłączyć wyświetlanie głównego okna &kalarm-dopelniacz;.

Kliknij prawym przyciskiem myszy na ikonę w tacce systemowej, aby wyświetlić jej menu kontekstowe:

Włącz alarmy

  Włącza monitorowanie alarmów. Opcja ta pojawia się tylko, jeśli alarmy są wyłączone.

  Zobacz Włączanie i wyłączanie alarmów, aby uzyskać więcej szczegółów.

Wyłącz alarmy

  Wyłącza monitorowanie alarmów. Opcja ta pojawia się tylko, jeśli alarmy są włączone.

  Zobacz Włączanie i wyłączanie alarmów, aby uzyskać więcej szczegółów.

Nowy alarm

  Po wybraniu typu alarmu z listy, która się pojawi, otwiera okno Zmień alarm, aby utworzyć nowy alarm/

Nowy alarm z szablonu

  Wyświetla listę szablonów alarmów w menu. Gdy wybierzesz jeden z nich, zostanie otwarte okno Zmień alarm, wypełnione szczegółami tego szablonu.

Konfiguracja: &kalarm;...

  Wyświetla okno Ustawienia &kalarm-dopelniacz;.

  Okno Ustawienia zostało opisane w rozdziale Konfiguracja: &kalarm;. Zostały tam opisane również opcje ikony w tacce systemowej.

Przywróć / Minimalizuj

  Przywraca lub minimalizuje główne okno &kalarm-dopelniacz;.

Zakończ

  Zamyka okna &kalarm-dopelniacz; i ikonę w tacce systemowej.

  Zakańcza &kalarm;, jeśli nie wyświetlane są żadne okna komunikatów alarmowych.

#### Wyświetlanie &kalarm-dopelniacz; w tacce systemowej

Aby wyświetlić &kalarm; w tacce systemowej, musisz uruchomić pulpit &kde; lub innego menedżera okien.

Aby wyświetlić &kalarm; w tacce systemowej, wybierz Widok Pokaż w tacce systemowej .

Aby usunąć &kalarm; z tacki systemowej, wybierzWidok Nie pokazuj w tacce systemowej.

Aby wybrać, czy &kalarm; ma być wyświetlany przy uruchomieniu w tacce systemowej, użyj karty Widok okna Ustawienia.

### Odświeżanie alarmów

Jeśli żaden alarm nie został wywołany w dniu, gdy powinien być wywołany, możesz odświeżyć listę alarmów i wywołać brakujące alarmy, wybierając Działania Odśwież alarmy . Spowoduje to przeładowanie wszystkich plików kalendarzy i zasobów &kalarm-dopelniacz;.

Możesz odświeżyć pojedynczy zasób i jego alarmy na liście, klikając prawym przyciskiem myszy zasób z listy zasobów i wybierając opcję Odśwież. Zobacz Zasoby alarmów, aby dowiedzieć się więcej.

### Włączanie i wyłączanie alarmów

Alarmy mogą być włączane lub wyłączane całościowo lub indywidualnie:

- Monitorowanie alarmów jest akceptowane dla wszystkich alarmów jako całości. Gdy monitorowanie alarmów jest wyłączone, właściwie żaden alarm nie jest wywoływany. Gdy monitorowanie alarmów jest włączone (zwyczajna sytuacja), wszystkie niewyłączone alarmy są wywoływane w odpowiednim czasie.

  Gdy monitorowanie alarmów jest włączone ponownie, alarmy, które powinny być wywołane wtedy, gdy monitorowanie alarmów było wyłączone zostaną wywołane teraz (chyba że zaznaczona jest opcja anulowania spóźnionych alarmów). Innymi słowy, wyłączanie monitorowania alarmów odnosi taki sam efekt, jak zatrzymanie &kalarm-dopelniacz; – alarmy są odkładane do ponownego włączenia funkcji.

- Alarmy mogą być osobno włączane i wyłączane, niezależnie od stanu monitorowania alarmów. Stan włączania/wyłączania pojedynczych alarmów nie zostanie więc zmieniony przez ponowne włączenie monitorowania alarmów. W przeciwieństwie do monitorowania alarmów, które potencjalnie może być wyłączone nawet, gdy &kalarm; nie jest uruchomiony, osobne alarmy mogą być wyłączone tylko, gdy użyjesz polecenia menu, które to powoduje.

  Gdy alarm jest indywidualnie włączony ponownie, nie jest wywoływany teraz, jeśli zaplanowany czas minął w czasie, gdy był on wyłączony. Innymi słowy, wyłączanie indywidualnego alarmu anuluje wszystkie jego powtórzenia do jego ponownego włączenia.

  Indywidualny stan wyłączonego/włączonego alarmu jest wyróżniany odpowiednim kolorem na liście alarmów (kolor ten można skonfigurować w karcie Czcionka i kolor okna Ustawienia).

Aby alarm został wywołany, musi być indywidualnie włączony, jak również włączone musi być monitorowanie alarmów.

#### Włączanie monitorowania alarmów

Aby włączyć monitorowanie alarmów, &kalarm; musi być uruchomiony. Gdy raz uruchomisz &kalarm;, będzie on automatycznie uruchomiał się po zalogowaniu, chyba że wyłączysz tą funkcję przy użyciu karty Ogólne okna Ustawienia.

Jeśli monitorowanie alarmów jest aktualnie wyłączone, wykonaj jedno z poniższych działać, aby włączyć alarmy:

- Wybierz Działania Włącz alarmy.

- Kliknij prawym przyciskiem myszy na ikonę w tacce systemowej i z menu kontekstowego wybierz Włącz alarmy.

#### Wyłączanie monitorowania alarmów

Możesz na jakiś czas wyłączyć monitorowanie alarmów, co uchroni &kalarm; od sprawdzania alarmów do ponownego włączenia alarmów lub – upewniając się, że &kalarm; uruchamia się przy zalogowaniu – do następnego zalogowania.

- Wybierz Działania Wyłącz alarmy.

- Kliknij prawym przyciskiem myszy na ikonę w tacce systemowej i z menu kontekstowego wybierz Wyłącz alarmy.

- Zatrzymaj &kalarm; jak opisano w Zakańczanie &kalarm-dopelniacz;.

Alarmy mogą być trwale wyłączane, wyłączając automatyczne uruchamianie &kalarm-dopelniacz; przy zalogowaniu, czego można dokonać w karcie Ogólne okna Ustawienia.

#### Włączanie i wyłączanie pojedynczych alarmów

Aby włączyć indywidualne alarmy, które są aktualnie wyłączone, wykonaj jedno z poniższych działań:

- Wybierz jeden lub więcej alarmów, klikając na ich wpisy na liście alarmów. Następnie wybierz Działania Włącz .

- Kliknij prawym przyciskiem myszy na odpowiedni wpisy na liście alarmów i wybierz Włącz z menu kontekstowego.

Aby wyłączyć indywidualne alarmy, które aktualnie są włączone, wykonaj jedno z poniższych działań:

- Wybierz jeden lub więcej alarmów, klikając na ich wpisy na liście alarmów. Następnie wybierz Działania Wyłącz .

- Kliknij prawym przyciskiem myszy na odpowiedni wpisy na liście alarmów i wybierz Wyłącz z menu kontekstowego.

### Zakańczanie &kalarm-dopelniacz;

Zakończ &kalarm;, wybierając Plik Zakończ lub Zakończ z menu kontekstowego ikony w tacce systemowej. Alternatywnie, jeśli ikona w tacce systemowej nie jest widoczna, zamknij wszystkie okna &kalarm-dopelniacz;.

## Konfiguracja: &kalarm;

Aby skonfigurować operacje &kalarm-dopelniacz; tak, by dopasować je do Twojego systemu i osobistych ustawień, wybierz Ustawienia Konfiguracja: &kalarm;.... Zostanie wyświetlone okno Ustawienia.

### Ogólne

Sekcja Ogólne pozwala kontrolować ogólne zachowanie &kalarm-dopelniacz;:

- Uruchamiaj przy logowaniu: &kalarm; zostanie automatycznie uruchomiony przy każdym zalogowaniu do &kde;, upewniając się, że &kalarm; będzie uruchomiony dopóki manualnie nie zakończysz pracy programu.

  Opcja ta powinna być zawsze włączona, chyba że nie chcesz już więcej używać &kalarm-dopelniacz;.

  Opcja ta jest automatycznie zaznaczana ponownie przy każdym uruchomieniu &kalarm-dopelniacz;. Więc jeśli została ona odznaczona i nadal nie chcesz uruchamiać &kalarm-dopelniacz; przy zalogowaniu, musisz odznaczyć tą opcję przy każdym uruchomieniu &kalarm-dopelniacz;.

- Potwierdź zakończenie: Gdy alarmy są wyłączone, a &kalarm; nie jest uruchomiony, wybranie tej opcji powoduje wyświetlanie zapytania o potwierdzenie, gdy spróbujesz zakończyć &kalarm; przy użyciu opcji Zakończ ikony w tacce systemowej. Dla bezpieczeństwa opcja ta jest automatycznie włączana ponownie przy każdej zmianie trybu uruchamiania.

- Potwierdzanie usuwania alarmów: Określ, czy powinna być wyświetlana prośba o potwierdzenie przy każdym usunięciu alarmu.

- Terminal dla alarmów w postaci poleceń: Możesz tu wybrać, który typ okna terminala powinien być użyty dla alarmów w postaci poleceń wykonywanych w oknie terminala. Niektóre z najpopularniejszych programów okien terminala są już skonfigurowane, &eg; xterm, &konsole;, jednakże zostaną wyświetlane tylko te terminale, które są zainstalowane w systemie. Możesz zobaczyć opcje poleceń używanych dla każdego programu, wyświetlając pomoc kontekstową dla jego opcji wyboru.

  Jeśli chcesz użyć innego programu lub jednego z listy, lecz z innymi opcjami polecenia, wybierz Inny i wpisz polecenie wywołujące okno terminala. Domyślnie polecenia alarmu zostanie dostosowane do tego, co wpiszesz. Możesz jednak określić, gdzie polecenie powinno być umieszczone, używając poniższych kodów:

  %c

    Polecenie alarmu zostanie zamienione.

  %w

    Polecenia alarmu zostanie zamienione przez `uśpij`.

  %C

    Tymczasowy plik polecenia zawierający ciąg polecenia alarmu zostanie utworzony, zaś polecenie wykonania pliku zostanie zastąpione.

  %W

    Tymczasowy plik polecenia zawierający ciąg polecenia alarmu zostanie utworzony z dołączonym `uśpieniem`, zaś polecenie wykonania pliku zostanie zastąpione.

  Gdy alarm z poleceniem zostanie wykonany, jego ciąg polecenia zostanie zacytowany przed umieszczeniem polecenia w oknie terminala.

### Czas i data

Sekcja Czas i data pozwala ustawić opcje powiązane z czasem i datą:

- Strefa czasowa: Wybierz Twoją strefę czasową. &kalarm; użyje tej strefy dla wszystkich alarmów, oprócz tych, dla których wybierzesz własną strefę czasową.

- Początek dnia dla alarmów bez podanego czasu: Ustaw czas rozpoczęcia dnia do wywołania alarmów bez określonego czasu, czyli takich, dla których wybrano opcję Dowolny czas. W dniu ivh wywołania takie alarmy zostaną wywołane przy pierwszej okazji w ciągu 24 godzin od czasu rozpoczęcia dnia.

- Jeśli ustawisz powtarzanie roczne 29 lutego, określ, jak traktować lata nieprzestępne, wybierając jedną z poniższych opcji:

  - 28. lutego: alarm zostanie wywołany 29. lutego w latach przestępnych, a 28/ lutego w latach nieprzestępnych.

  - 1. marca: alarm zostanie wywołany 29. lutego w latach przestępnych, a 1. marca w latach nieprzestępnych.

  - Nie powtarzaj: alarm zostanie wywołany 29. lutego w latach przestępnych, a w latach nieprzestępnych nie będzie wykonany.

  Zmiana tej opcji nie spowoduje ponownego wyliczenia następnego zaplanowanego powtórzenia któregokolwiek z istniejących alarmów. Odniesie efekt jedynie na nowych alarmach lub na istniejących alarmach po ich następnym wywołaniu.

- Godziny pracy: Opcje w tym obszarze pozwalają zdefiniować Twoje godziny pracy, potrzebne, gdy wybrana jest opcja Tylko podczas godzin pracy dla powtarzania w oknie Zmień alarm.

  - Zaznacz każdy dzień, który jest dniem pracy.

  - Początek dnia: wpisz czas rozpoczęcia pracy każdego dnia.

  - Koniec dnia: wpisz czas zakończenia pracy każdego dnia.

### Zapis

Sekcja Zapis pozwala wybrać opcje zapisu i archiwizacji alarmów:

- Nowe alarmy i szablony: Określ zasób do zapisywania nowych alarmów i szablonów podczas używania wielu zasobów alarmów:

  - Przechowuj w domyślnym zasobie: Nowe alarmy i szablony alarmów są automatycznie dodawane do domyślnego zasobu alarmów bez zapytania o potwierdzenie.

  - Zasugeruj w którym zasobie przechowywać: Gdy utworzysz nowy alarm lub szablon alarmu i jest więcej niż jeden zapisywalny zasób alarmów, wyświetlone zostanie pytanie, który zasób wybrać. Gdy alarmy są przechowywane do wygaśnięcia, zawsze są przechowywane w domyślnym zasobie archiwizowanych alarmów bez pytania.

- Obszar Zarchiwizowane alarmy: Opcje kontrolują zapis zarchiwizowanych alarmów w domyślnym zasobie zarchiwizowanych alarmów.

  - Przechowuj nieaktualne alarmy:Wybierz tą opcję, aby przechowywać nieaktualne i usunięte alarmy. Odznacz pole, jeśli nie chcesz zapisywać alarmów, gdy przestaną być aktywne. Usunięte alarmy są archiwizowane tylko, jeśli wcześniej zostały wywołane. Jeśli usuniesz alarm przed jego aktywacją, nie zostanie on przechowany.

  - Usuń nieaktualne alarmy po: Wybierz liczbę dni, na które nieaktualne i usunięte alarmy będą przechowywane. Po tym czasie będą one trwale usuwane.

  - Wyczyść nieaktualne alarmy: Przycisk ten usuwa wszystkie nieaktualne alarmy z domyślnego zasobu nieaktualnych alarmów. (Inne zasoby nieaktualnych alarmów zostaną nienaruszone, gdy są współdzielone z innymi ludźmi.) Nie odnosi to efektu na alarmach, które są wywołane lub usuwane później; będą one nadal przechowywane, gdy opcja ta jest wciąż aktywna.

### Wiadomość e-mail

Sekcja Wiadomość e-mail pozwala wybrać opcje dotyczące wysyłania i adresowania alarmów e-mail:

- Klient e-mail: Określ klienta e-mail używanego do wysyłania alarmów e-mail:

  - Kmail: Gdy wywoływany jest alarm e-mail, wiadomość jest wysyłana przy użyciu &kmail-dopelniacz; (który w razie potrzeby zostanie najpierw uruchomiony) jak poniżej:

    - Jeśli posiadasz &kmail; w wersji 1.7 lub późniejszej, wiadomość zostanie wysłana automatycznie.

    - Jeśli posiadasz &kmail; w wersji starszej, wiadomość zostanie dodana do folderu `do wysłania` &kmail-dopelniacz; do późniejszego wysłania.

  - Sendmail: Gdy wywoływany jest alarm e-mail, wiadomość jest automatycznie wysyłana przy użyciu &Sendmail-dopelniacz;. Opcja ta jest aktywna tylko, jeśli system został skonfigurowany tak, aby używać &Sendmail; lub kompatybilnego agenta transferu wiadomości, jak postfix lub qmail.

- Kopiuj wysłane wiadomości do folderu wysłane &kmail-dopelniacz;: Wybierz tą opcję, jeśli przy każdym wywołaniu alarmu e-mail chcesz kopiować przesłaną wiadomość do folderu `wysłane` &kmail-dopelniacz;.

  Opcja ta nie jest dostępna, gdy &kmail; jest wybrany jako klient e-mail dopóki &kmail; nie zrobi tego automatycznie.

- Wybierz adres e-mail, którego chcesz użyć jako adresu nadawcy w alarmach e-mail:

  - Wybierz Od, aby wpisać adres e-mail.

  - Wybierz Użyj adresu z Centrum sterowania, aby użyć adresu e-mail skonfigurowanego w Centrum sterowania &kde;.

  - Wybierz Użyj adresu z &kmail-dopelniacz;, aby wybrać tożsamość &kmail-dopelniacz;, której chcesz użyć przy konfiguracji alarmu e-mail. Domyślna tożsamość &kmail-dopelniacz; zostanie użyta dla alarmów skonfigurowanych przed wybraniem tej opcji.

- Wybierz adres e-mail, na który chcesz wysyłać kopie alarmów e-mail, gdy wybrana jest opcja Kopiuj e-mail do siebie:

  - Wybierz Bcc, aby wpisać adres e-mail. Jeśli kopie są wysyłane na adres e-mail, którego używasz w &kmail-miejscownik;, możesz tu wpisać tylko nazwę użytkownika.

  - Wybierz Użyj adresu z Centrum sterowania, aby użyć adresu e-mail skonfigurowanego w Centrum sterowania &kde;.

- Powiadom o kolejkowaniu wiadomości: Wybierz tą opcję, aby wyświetlać powiadomienie za każdym razem, gdy wiadomość e-mail zostanie dodana do kolejki wysłania systemu zdalnego przez alarm e-mail. Może być to użyteczne, jeśli na przykład masz połączenie dial-up lub wiadomość jest dodawana do kolejki w folderze `do wysłania` &kmail-dopelniacz;, dzięki czemu możesz się upewnić, że robisz wszystko, co możesz, by w odpowiednim czasie przesłać wiadomość.

### Widok

Sekcja Widok pozwala kontrolować niektóre aspekty wyglądu &kalarm-dopelniacz;:

- Pokaż w tacce systemowej: Gdy opcja ta jest zaznaczona, wyświetlana jest ikona w tacce systemowej, gdy &kalarm; jest uruchomiony. W tym trybie, zamknięcie ikony w tacce systemowej powoduje zamknięcie wszystkich głównych okien &kalarm-dopelniacz;, a jeśli nie są widoczne żadne komunikaty alarmowe, powoduje również zakończenie programu.

- Podpowiedź na tacce systemowej: Opcje te kontrolują, jakie informacje pokazywane są w podpowiedzi, która pojawia się po przytrzymaniu kursora nad ikoną &kalarm-dopelniacz; w tacce systemowej.

  - Pokaż alarmy w następnych 24 godzinach: Gdy ta opcja jest zaznaczona, wyświetlany jest spis pierwszych kilku alarmów zaplanowanych na następne 24.

  - Maksymalna liczba wyświetlanych alarmów: Odznacz tą opcję, aby wyświetlić wszystkie alarmy w ciągu następnych 24 godzin. Zaznacz ją, aby ustawić maksymalną liczę alarmów, które zostaną wyświetlone.

  - Pokaż czas alarmu: Wybierz tą opcję, aby wyświetlić czas, na który każdy alarm został zaplanowany.

  - Pokaż czas do uruchomienia alarmu: Zaznacz tą opcję, aby wyświetlić czas pozostały do następnego zaplanowanego wywołania alarmu. Czas wyświetlany jest w godzinach i minutach.

    - Przedrostek: Wpisz znak lub tekst wyświetlany przed czasem do wywołania alarmu, aby odróżnić go od czasu, na który został alarm zaplanowany.

- Okna wiadomości: Tu możesz kontrolować wygląd okien komunikatów alarmowych.

  - Rozmieszczaj okna jak najdalej od kursora myszy: Wybierz tą opcję, aby wyświetlać okna wiadomości jak najdalej od aktualnej pozycji kursora myszy. Minimalizuje to ryzyko przypadkowego zatwierdzenia alarmu przez niezamierzone kliknięcie przycisku zaraz po pojawieniu się wiadomości.

  - Wyśrodkowanie okien, opóźnienie przycisków okien: Wybierz tą opcję, aby wyświetlać okna komunikatów alarmowych na środku ekranu. Aby zminimalizować ryzyko przypadkowego zatwierdzenia alarmu, przyciski okna będą początkowo wyłączone. Opóźnienie w sekundach, zanim staną się one aktywne, można ustawić w Opóźnienie aktywacji przycisków (sekundy).

  - Okna wiadomości z paskiem tytułowym i przyjmowaniem klawiatury: Opcja ta kontroluje, czy okna komunikatów alarmowych są modalne czy nie, czyli czy przechwytują zachowanie klawiatury, gdy się pojawią. Więcej informacji znajdziesz w sekcji Okno komunikatu alarmowego.

### Czcionka i kolor

Sekcja Czcionka i kolor pozwala ustawiać domyślny wygląd komunikatów alarmowych oraz kolory używane na liście alarmów:

- Wybierz domyślną czcionkę i kolor tła dla komunikatu alarmowego.

- Zmień kolor listy, wyświetlany, gdy klikniesz na pole koloru tła:

  - Dodaj kolor...: Wyświetla okno wyboru koloru, które pozwala wybrać kolor, który chcesz dodać do listy.

  - Usuń kolor: Usuwa kolor wyświetlany w polu Kolor tła z listy. Pozycja Inny kolor nie może być usunięta z listy, a gdy jest wyświetlana, przycisk ten jest wyłączony.

- Wybierz kolor używany na liście alarmów dla wyłączonych alarmów.

- Wybierz kolor używany na liście alarmów dla nieaktualnych alarmów.

### Edycja

Sekcja Edycja pozwala wybrać domyślne wartości dla opcji w oknie Zmień alarm:

Alarmy wyświetlane:

- Ustaw domyślny stan dla pól Automatycznie zamknij okno po czasie unieważnienia i Potwierdź odczytanie.

- Ustaw domyślne jednostki przypominania.

- Ustaw domyślne działania specjalne dla alarmów wyświetlanych.

- Ustaw domyślne opcje dźwięku. Domyślny plik dźwiękowy może być określony nawet, gdy rodzajem dźwięku nie jest Plik dźwiękowy.

Alarmy w postaci poleceń:

- Ustaw domyślny stan dla pól Wprowadź skrypt i Wykonaj w oknie terminala.

Alarmy w postaci e-maili:

- Ustaw domyślny stan pola Kopiuj e-mail do siebie.

Wszystkie typy alarmów:

- Ustaw domyślny stan dla pól Pokaż w KOrganizerze i Anuluj spóźnione alarmy.

- Ustaw domyślny typ powtarzania.

- Wybierz domyślny sposób powtarzania alarmów zaplanowanych na 29. lutego w latach nieprzestępnych.

## Operacje wiersza poleceń

Gdy podawane są parametry wiersza poleceń, &kalarm; nie wyświetla listy zaplanowanych alarmów, jak opisano powyżej w Używanie &kalarm-dopelniacz;. Opcje wiersza poleceń specyficzne dla &kalarm-dopelniacz; mogą być użyte do wykonania poniższych operacji:

- zaplanować nowy alarm

- kontrolować tryb wyświetlania &kalarm-dopelniacz;

- uzyskać pomoc

Dodatkowe opcje wiersza poleceń dostarczane są przede wszystkim, aby nadać innym programom interfejs &kalarm-dopelniacz;. Są one opisane w rozdziale Przewodnik programisty &kalarm-dopelniacz;.

Wiersz poleceń musi zawierać tylko opcje odpowiednie dla operacji w &kalarm-miejscownik;. Jeśli chcesz wykonać wiele operacji, musisz wywołać &kalarm-biernik; wielokrotnie, za każdym razem z osobnym zestawem opcji.

### Zaplanuj nowy alarm

Poniższe opcje używane są do planowania nowego alarmu:

Opcja | Opis
--- | ---
`-a`, `--ack-confirm` | Zapytaj o potwierdzenie, gdy komunikat alarmowy jest zatwierdzany.
`-A`, `--attach URL` | Określ ścieżkę lub adres &URL; pliku, który chcesz załączyć do wiadomości. Opcja ta może być powtórzona w razie konieczności. `--mail` musi być podane z tą opcją.
`--auto-close` | Automatycznie zamknij okno alarmu po wygaśnięciu okresu `--late-cancel`. `--late-cancel` musi być podane z tą opcją.
`-b`, `--beep` | Odtwórz dźwięk brzęczyka podczas wyświetlania wiadomości. `--speak`, `--play` i `--play-repeat` nie mogą być podane z tą opcją.
`--bcc` | Wyślij kopię wiadomości do siebie. `--mail` musi być podane z tą opcją.
`-c`, `--color`, `--colour kolor` | Ustaw kolor tła wiadomości na określony przez nazwę &Qt; lub kod heksadecymalny 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg kolor` | Ustaw kolor pierwszoplanowy wiadomości na określony przez nazwę &Qt; lub kod heksadecymalny 0xRRGGBB.
`-d`, `--disable` | Wyłącz alarm. Nie będzie on wywołany, dopóki nie włączysz go ręcznie.

`-e`, `--exec wiersz poleceń`

Określ polecenie powłoki do wywołania. Jeśli określone, opcja ta musi być ostatnią opcją &kalarm-dopelniacz; w wierszu poleceń &kalarm-dopelniacz;. Wszystkie ponowne parametry i opcje polecenia są interpretowane jako wiersz polecenia do wykonania. `--file` i `--exec-display` oraz `--mail` nie mogą być podane z tą opcją. `--ack-confirm`, `--beep`, `--color` i `--colorfg` są ignorowane przy tej opcji.

`-E`, `--exec-display wiersz poleceń`

Określ polecenie powłoki do wykonania w celu wygenerowania tekstu wiadomości. Jeśli określone, opcja ta musi być ostatnią opcją &kalarm-dopelniacz; w wierszu poleceń &kalarm-dopelniacz;. Wszystkie ponowne parametry i opcje wiersza poleceń są interpretowane jako wiersz polecenia do wykonania. `--exec`, `--file` i `--mail` nie mogą być podane z tą opcją. `--ack-confirm`, `--beep`, `--color` i `--colorfg` są ignorowane przy tej opcji.

`-f`, `--file URL` | Określ ścieżkę lub adres &URL; pliku tekstowego lub graficznego, którego zawartości ma być użyta w wiadomości. `--exec`, `--exec-display` i `--mail` nie mogą być podane, a message nie może być obecne przy tej opcji.
`-F`, `--from-id ID` | Użyj określonej tożsamości &kmail-dopelniacz; jako nadawcy wiadomości. `--mail` musi być podane z tą opcją.

`-i`, `--interval okres`

Ustaw częstotliwości pomiędzy powtórzeniami alarmu. Godziny/minuty są określane w formacie nHnM, gdzie n jest liczbą, &eg; 3H30M. Inne okresy czasu określane są w formacie nX, gdzie n jest liczbą, a X jest jedną z poniższych liter: Y (lata), M (miesiące), W (tygodnie), D (dni). Jeśli podano również `--recurrence`, Y (lata) i M (miesiące) nie są dozwolone. Obowiązkowe, jeśli podano `--repeat` lub `--until`.

`-k`, `--korganizer` | Wyświetl alarm jako zdarzenie w aktywnym kalendarzu &korganizer-dopelniacz;.
`-l`, `--late-cancel okres` | Anuluj alarm, jeśli nie może być wywołany w określonym okresie po zaplanowanym czasie. Okres jest określano w takim samym formacie, jaki opisano dla `--reminder`. Domyślną wartością okresu jest 1 minuta.
`-L`, `--login` | Wywołaj alarm przy każdym zalogowaniu. `--interval`, `--repeat` i `--until` nie mogą być podane z tą opcją.
`-m`, `--mail adres` | Wyślij e-mail na określony adres. Opcja może być powtórzona w razie konieczności. `--exec`, `--exec-display` i `--file` nie mogą być podane z tą opcją. `--ack-confirm`, `--beep`, `--color` i `--colorfg` są ignorowane przy tej opcji.
`-p`, `--play URL` | Określ ścieżkę lub adres &URL; pliku dźwiękowego, który chcesz odtworzyć jednokrotnie podczas wyświetlania wiadomości. `--play-repeat`, `--beep` i `--speak` nie mogą być podane z tą opcją.
`-P`, `--play-repeat URL` | Określ ścieżkę lub adres &URL; pliku dźwiękowego odtwarzanego z powtarzaniem tak długo, jak wyświetlana jest wiadomości. `--play`, `--beep` i `--speak` nie mogą być podane z tą opcją.
`--recurrence specyfikacja` | Ustaw powtarzanie alarmu. Określ powtarzanie przy użyciu składni iCalendar (określonej w RFC2445), &eg; FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. `--until` nie może być podane z tą opcją.
`-r`, `--repeat liczba` | Ustaw liczbę wywołań alarmu lub, jeśli powtarzanie jest określone za pomocą `--recurrence`, liczbę wywołań alarmu przy każdej aktywacji `--recurrence` (czyli podpowtórzenie). Jeśli `--recurrence` nie jest ustawione, wpisz -1, aby powtarzać alarm bez końca. `--interval` musi być, a `--until` nie może być podane z tą opcją.

`-R`, `--reminder okres`

Wywołaj przypomnienie w określonym czasie przed głównym alarmem i każdym powtórzeniem (jeśli są). Godziny/minuty są określone w formacie nHnM, gdzie n to liczba, &eg; 3H30M. Inne okresy czasu są określane w formacie nX, gdzie n jest liczbą, a X jest jedną z następujących liter: W (tygodnie), D (dni). Ta opcja nie może być podana z `--exec`, `--mail` lub `--reminder-once`.

`--reminder-once okres` | Wywołaj przypomnienie raz, na określony czas przed pierwszym powtórzeniem alarmu. Nie zostanie wyświetlone żadne powtórzenie przed kolejnymi powtórzeniami (jeśli są). Opcja ta nie może być podana z `--exec`, `--mail` lub `--reminder`.
`-s`, `--speak` | Wymów wiadomość podczas jej wyświetlania. Wymaga to zainstalowanego KTTSD oraz kompatybilnego syntezatora mowy. `--beep`, `--play` i `--play-repeat` nie mogą być podane z tą opcją.
`-S`, `--subject temat` | Temat wiadomości e-mail. `--mail` musi być podane z tą opcją.

`-t`, `--time data/czas`

Wywołaj alarm w określonym dniu/o podanej godzinie. Określ datę bez czasu w formacie yyyy-mm-dd [TZ]; określ datę i czas w [[[yyyy-]mm-]dd-]hh:mm [TZ] (gdzie pominięto pole daty z wartością domyślną: dzisiaj). Jeśli nie określono strefy czasowej, zostanie użyta lokalna strefa czasowa systemu. Jeśli używane jest określanie strefy czasowej TZ, może być ono nazwą systemowej strefy czasowej (&eg; `Europa/Londyn`), `UTC` reprezentuje strefę czasową UTC lub `Zegar`, aby użyć lokalnego zegara systemowego i ignorować strefy czasowe.

`-v`, `--volume procent` | Ustaw głośność dźwięku dla plików dźwiękowych. Opcja ta może być użyta tylko, jeśli określono `--play` lub `--play-repeat`.
`-u`, `--until data/czas` | Powtarzaj alarm do określonej daty/czasu. Podaj datę lub datę/czas używając takiego samego schematu, jak dla `--time`. Jeśli określono `--time`, będzie użyta strefa czasowa z tej wartości i nie będzie trzeba podać strefy czasowej w `--until`. `--interval` musi być, a `--repeat` i `--recurrence` nie mogą być podane z tą opcją.
wiadomość | Tekst komunikatu do wyświetlenia lub, jeśli podano `--mail`, treść wiadomości e-mail.

Wpisz tekst wiadomości, `--file`, `--exec` lub `--exec-display` muszą być podane, oprócz tych opcji, wszystkie inne są niepotrzebne.

Dwa alternatywne przykłady, które wyświetlają wielowierszową wiadomość z czerwonym tłem o godz. 22, 27. dnia tego miesiąca to:

    % kalarm -c red -t 27-22:00 "Pamiętaj, żeby \nZATRZYMAĆ"
    % kalarm -c 0xFF0000 -t 27-22:00 "Pamiętaj, żeby\nZATRZYMAĆ"

### Inne opcje

Poniższe opcje używane są do wyświetlania okna Zmień alarm lub do kontroli wyglądu.

Opcja | Opis
--- | ---
`--edit IDzdarzenia` | Wyświetl okno Zmień alarm w celu edycji alarmu z określonym ID zdarzenia.
`--edit-new-command` | Otwórz okno Zmień alarm w celu edycji nowego alarmu z poleceniem.
`--edit-new-display` | Otwórz okno Zmień alarm w celu edycji nowego alarmu wyświetlającego.
`--edit-new-email` | Otwórz okno Zmień alarm w celu edycji nowego alarmu e-mail.
`--edit-new-preset nazwaSzablonu` | Otwórz okno Zmień alarm wypełnione szablonem alarmu określonej nazwy w celu edycji nowego alarmu.
`--tray` | Wyświetl &kalarm; jako ikonę w tacce systemowej.

### Opcje pomocy

Poniższe opcje pomocy odnoszą się do wszystkich programów &kde;:

Opcja | Opis
--- | ---
`--help` | Wyświetla skrócony spis opcji.
`--help-qt` | Wyświetla ogólne i dodatkowe specyficzne opcje &Qt;.
`--help-kde` | Wyświetla ogólne i dodatkowe specyficzne opcje &kde;.
`--help-all` | Wyświetla wszystkie opcje.
`--author` | Wyświetla imiona i nazwiska oraz adresy e-mail autorów &kalarm-dopelniacz;.
`-v`, `--version` | Wyświetla uruchomione wersje biblioteki &Qt;, &kde; i &kalarm-dopelniacz;.
`--license` | Wyświetla informacje licencyjne.

## Przewodnik programisty &kalarm-dopelniacz;.

&kalarm; dostarcza interfejs do zezwalania innym programom wykonywać następujące funkcje:

- zaplanować nowy alarm

- anulować zaplanowany już alarm

- wykonać zaplanowany alarm

- wyświetlić okno Zmień alarm

Każda z powyższych funkcji jest implementowana zarówno przez połączenie D-Bus, jak i wiersz polecenia. Połączenie D-Bus powinno być użyte jako pierwsze, jeśli &kalarm; jest już uruchomiony.

### Interfejs D-Bus

Połączenia D-Bus opisane w tym dokumencie są implementowane w ścieżce obiektów D-Bus `/kalarm` &kalarm-dopelniacz;. Interfejs jest definiowany w plikach `org.kde.kalarm.kalarm.xml` i `kalarmiface.h`.

cancelEvent

#### cancelEvent

anuluj zaplanowany alarm.

    void cancelEvent(const QString& IDzdarzenia)

##### Parametry

`IDzdarzenia`

  Określa unikalny ID anulowanego zdarzenia.

##### Opis

`cancelEvent()` jest połączeniem D-Bus, anulującym określony alarm. &kalarm; usuwa alarm z kalendarza bez wyświetlania i wykonywania go.

triggerEvent

#### triggerEvent

wykonaj zaplanowany alarm.

    void triggerEvent(const QString& IDzdarzenia)

##### Parametry

`IDzdarzenia`

  Określa unikalny ID wywoływanego zdarzenia.

##### Opis

`triggerEvent()` jest połączeniem D-Bus, powodującym natychmiastowe wyświetlenie lub wywołanie określonego alarmu (niezależnie od czasu, na który został zaplanowany). &kalarm; pobiera alarm z kalendarza, a następnie wyświetla lub wykonuje go.

Jeśli alarm jest już zrealizowany, &kalarm; usuwa wszystkie zaplanowane powtórzenia alarmu do aktualnego czasu, a jeśli nie ma żadnych powtórzeń alarmu, alarm jest usuwany z kalendarza. Jeśli alarm nie został jeszcze wywołany, jego zaplanowane powtórzenia pozostają niezmienione.

scheduleMessage

#### scheduleMessage

zaplanuj nowy komunikat alarmowy.

    bool scheduleMessage(const QString& wiadomość,
                         const QString& dataCzasRozpoczęcia,
                         int anulujSpóźnione,
                         unsigned flagi,
                         const QString& kolorTła,
                         const QString& kolorPp,
                         const QString& czcionka,
                         const QString& URLdźwięku,
                         int minutyPrzypomnienia,
                         const QString& powtarzanie,
                         int okresPodPowtórzenia,
                         int liczbaPodPowtórzeń)

    bool scheduleMessage(const QString& wiadomość,
                         const QString& dataCzasRozpoczęcia,
                         int anulujSpóźnione,
                         unsigned flagi,
                         const QString& kolorTła,
                         const QString& kolorPp,
                         const QString& czcionka,
                         const QString& URLdźwięku,
                         int minutyPrzypomnienia,
                         int typPowtarzania,
                         int okresPowtarzania,
                         int liczbaPowtórzeń)

    bool scheduleMessage(const QString& wiadomość,
                         const QString& dataCzasRozpoczęcia,
                         int anulujSpóźnione,
                         unsigned flagi,
                         const QString& kolorTła,
                         const QString& kolorPp,
                         const QString& czcionka,
                         const QString& URLdźwięku,
                         int minutyPrzypomnienia,
                         int typPowtarzania,
                         int okresPowtarzania,
                         const QString& dataCzasZakończenia)

##### Parametry

`wiadomość`

  Określa tekst zaplanowanej wiadomości lub, jeśli `flagi` mają ustawione `DISPLAY_COMMAND`, określa wiersz polecenia do wykonania w celu wygenerowania tekstu wiadomości.

`dataCzasRozpoczęcia`

  Określa zaplanowaną datę lub datę i czas, w których wiadomość powinna być wyświetlona. Dla alarmów z podaną tylko datą, ciąg powinien być w formacie YYYY-MM-DD [TZ] (zwracane jako `QDate::toString(Qt::ISODate)`). Dla alarmów z podanymi datą i czasem ciąg powinien być w formacie YYYY-MM-DDTHH:MM[:SS] [TZ] (zwracającym `QDateTime::toString(Qt::ISODate)`) lub HH:MM[:SS] [Clock] (zwracającym `QTime::toString(Qt::ISODate)`). Jeśli nie określono daty, użyta jest data dzisiejsza. Wartości sekundowe są ignorowane.

  Jeśli nie podano strefy czasowej, zostanie użyta lokalna strefa systemowa. Jeśli używane jest określanie strefy czasowej TZ, może być ono nazwą strefy systemowej (&eg; `Europa/Londyn`), `UTC`, czyli strefy czasowej UTC lub `Zegar`, aby użyć lokalnego zegara w komputerze i ignorować strefy czasowe.

`anulujSpóźnione`

  Powoduje anulowanie alarmu, jeśli nie może być on wywołany w określonej liczbie minut po zaplanowanym czasie alarmu. Jeśli wartością jest 0, alarm nie będzie anulowany, niezależnie od tego, jak późno zostanie wywołany.

`flagi`

  Określa logiczne OR odpowiednich flag alarmów. Bity flag to te określone w klasie `KAlarmIface` w `kalarmiface.h`. Nie wszystkie bity flag mogą zostać zastosowane do komunikatów alarmowych.

`kolorTła`

  Określa kolor tła komunikatu alarmowego. Ciąg może być podany w formacie #RRGGBB (zwracane jako `QColor::name()`), gdzie RR, GG i BB są dwucyfrowymi wartościami heksadecymalnymi dla kolorów czerwonego, zielonego i niebieskiego. Alternatywnie, ciąg może być podany w każdym innym formacie akceptowanym przez `QColor::setNamedColor()`, jak na przykład nazwa z bazy danych kolorów X (&eg; red lub steelblue). Ustaw ciąg na 0, aby użyć domyślnego koloru tła.

`kolorPp`

  Określa kolor pierwszoplanowy komunikatu alarmowego. Format ciągu jest taki sam, jak dla `kolorTła`, możesz też podać 0, aby użyć domyślnego koloru pierwszoplanowego.

`czcionka`

  Określa czcionkę komunikatu alarmowego. Format czcionki jest wyjściem `QFont::toString()`. Podaj 0, aby użyć domyślnej czcionki alarmu w czasie wyświetlania wiadomości.

`URLdźwięku`

  Podaj plik dźwiękowy, który ma być odtworzony podczas wyświetlania wiadomości. Ustaw wartość na 0, jeśli nie chcesz odtworzyć żadnego pliku dźwiękowego.

`minutyPrzypomnienia`

  Podaj liczbę minut przed głównym alarmem i każdym jego powtórzeniem (jeśli są), o której zostanie wyświetlone przypomnienie. Podaj 0, jeśli nie chcesz wyświetlać żadnego przypomnienia.

`powtarzanie`

  Określa regularne powtórzenie alarmu, używając schematu iCalendar, jak podano w RFC2445. FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO na przykład równe jest czterem powtórzeniom z 3-miesięczną przerwą, powtarzanych każdego ostatniego poniedziałku miesiąca. Dla alarmów niepowtarzanych podaj pusty ciąg.

`typPowtarzania`

  Określa typ powtarzania alarmu. Dopuszczalne wartości to MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY (minutowe, dzienne, tygodniowe, miesięczne, roczne). Są one zdefiniowane w klasie `KAlarmIface` w `kalarmiface.h`. Miesięczne powtarzania ustalane są za pomocą dnia w miesiącu, roczne zaś za pomocą daty w roku, gdzie w obu przypadkach data jest pobierana z parametru `dataCzasRozpoczęcia`.

`okresPowtarzania`

  Określa liczbę okresów (minut/dni/tygodni/miesięcy/lat, jak określono przez `typPowtarzania`) pomiędzy powtórzeniami alarmu.

`liczbaPowtórzeń`

  Określa liczbę powtórzeń alarmu. Podaj -1, aby powtarzać alarm w nieskończoność.

`dataCzasZakończenia`

  Określa datę lub datę i czas zakończenia powtórzeń alarmu. Jeśli `dataCzasRozpoczęcia` zawiera czas, parametr ten musi również zawierać czas. Jeśli `dataCzasRozpoczęcia` zawiera tylko datę, ten parametr musi również zawierać tylko datę. Nie może zawierać określenia strefy czasowej; w interpretacji wartości tego parametru używana jest strefa czasowa parametru `dataCzasRozpoczęcia`.

`okresPodPowtarzania`

  Określa liczbę minut pomiędzy pod-powtórzeniami alarmu. Podaj 0, jeśli nie chcesz ustawiać podpowtórzeń. Ignorowane, jeśli nie określono powtórzenia.

`liczbaPodPowtórzeń`

  Określa liczbę podpowtórzeń alarmu, włącznie z początkowym wywołaniem.

##### Opis

`scheduleMessage()` jest połączeniem D-Bus, planującym określony komunikat alarmowy na określoną datę i czas. Posiada trzy formy. Najbardziej ogólna forma pozwala określić dowolne powtórzenie – użyj tego także dla alarmów niepowtarzanych. Inne formy dostarczają wygodny dostęp do zastrzeżonej grupy typów powtórzeń alarmów, raz podając liczbę powtórzeń i czas zakończenia.

Jeśli zaplanowany czas (włącznie z powtórzeniami) już minął, &kalarm; niezwłocznie wyświetli wiadomość (chyba, że wartość `anulujSpóźnione` mówi, że jest już za późno na wyświetlenie alarmu - w takim przypadku &kalarm; zignoruje alarm). Jeśli zaplanowany czas (lub powtórzenie) jest w przyszłości, &kalarm; doda komunikat alarmowy do domyślnego zasobu aktywnych alarmów do późniejszego wyświetlenia.

scheduleFile

#### scheduleFile

zaplanuj nowy alarm, wyświetlający zawartość pliku tekstowego lub graficznego.

    bool scheduleFile(const QString& URL,
                      const QString& dataCzasRozpoczęcia,
                      int anulujSpóźnione,
                      unsigned flagi,
                      const QString& kolorTła,
                      const QString& URLdźwięku,
                      int minutyPrzypomnienia,
                      const QString& powtarzanie,
                      int okresPodPowtarzania,
                      int liczbaPodPowtórzeń)

    bool scheduleFile(const QString& URL,
                      const QString& dataCzasRozpoczęcia,
                      int anulujSpóźnione,
                      unsigned flagi,
                      const QString& kolorTła,
                      const QString& URLdźwięku,
                      int minutyPrzypomnienia,
                      int typPowtarzania,
                      int okresPowtarzania,
                      int liczbaPowtórzeń)

    bool scheduleFile(const QString& URL,
                      const QString& dataCzasRozpoczęcia,
                      int anulujSpóźnione,
                      unsigned flagi,
                      const QString& kolorTła,
                      const QString& URLdźwięku,
                      int minutyPrzypomnienia,
                      int typPowtarzania,
                      int okresPowtarzania,
                      const QString& dataCzasZakończenia)

##### Parametry

`URL`

  Określa plik tekstowy lub graficzny, którego zawartość ma być wyświetlona w zaplanowanej wiadomości.

`dataCzasRozpoczęcia`

  Określa zaplanowaną datę lub datę i czas, w których wiadomość powinna być wyświetlona. Dla alarmów z podaną tylko datą, ciąg powinien być w formacie YYYY-MM-DD [TZ] (zwracane jako `QDate::toString(Qt::ISODate)`). Dla alarmów z podanymi datą i czasem ciąg powinien być w formacie YYYY-MM-DDTHH:MM[:SS] [TZ] (zwracającym `QDateTime::toString(Qt::ISODate)`) lub HH:MM[:SS] [Clock] (zwracającym `QTime::toString(Qt::ISODate)`). Jeśli nie określono daty, użyta jest data dzisiejsza. Wartości sekundowe są ignorowane.

  Jeśli nie podano strefy czasowej, zostanie użyta lokalna strefa systemowa. Jeśli używane jest określanie strefy czasowej TZ, może być ono nazwą strefy systemowej (&eg; `Europa/Londyn`), `UTC`, czyli strefy czasowej UTC lub `Zegar`, aby użyć lokalnego zegara w komputerze i ignorować strefy czasowe.

`anulujSpóźnione`

  Powoduje anulowanie alarmu, jeśli nie może być on wywołany w określonej liczbie minut po zaplanowanym czasie alarmu. Jeśli wartością jest 0, alarm nie będzie anulowany, niezależnie od tego, jak późno zostanie wywołany.

`flagi`

  Określa OR logiczne odpowiednich flag alarmu. Bity flag są zdefiniowane w klasie `KAlarmIface` w `kalarmiface.h`. Nie wszystkie bity flag można zastosować do alarmów w postaci plików.

`kolorTła`

  Określa kolor tła wyświetlanego pliku. Ciąg może być podany w formacie #RRGGBB (zwracanym jako `QColor::name()`), gdzie RR, GG i BB to dwucyfrowe wartości heksadecymalne dla kolorów: czerwonego, zielonego i niebieskiego. Alternatywnie, ciąg może być przedstawiony w dowolnym innym formacie akceptowanym przez `QColor::setNamedColor()`, jak na przykład nazwa z bazy danych kolorów X (&eg; red lub steelblue). Ustaw ciąg na 0, aby użyć domyślnego koloru tła.

`URLdźwięku`

  Podaj plik dźwiękowy, który ma być odtworzony podczas wyświetlania wiadomości. Ustaw wartość na 0, jeśli nie chcesz odtworzyć żadnego pliku dźwiękowego.

`minutyPrzypomnienia`

  Podaj liczbę minut przed głównym alarmem i każdym jego powtórzeniem (jeśli są), o której zostanie wyświetlone przypomnienie. Podaj 0, jeśli nie chcesz wyświetlać żadnego przypomnienia.

`powtarzanie`

  Określa regularne powtórzenie alarmu, używając schematu iCalendar, jak podano w RFC2445. FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO na przykład równe jest czterem powtórzeniom z 3-miesięczną przerwą, powtarzanych każdego ostatniego poniedziałku miesiąca. Dla alarmów niepowtarzanych podaj pusty ciąg.

`typPowtarzania`

  Określa typ powtarzania alarmu. Dopuszczalne wartości to MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY (minutowe, dzienne, tygodniowe, miesięczne, roczne). Są one zdefiniowane w klasie `KAlarmIface` w `kalarmiface.h`. Miesięczne powtarzania ustalane są za pomocą dnia w miesiącu, roczne zaś za pomocą daty w roku, gdzie w obu przypadkach data jest pobierana z parametru `dataCzasRozpoczęcia`.

`okresPowtarzania`

  Określa liczbę okresów (minut/dni/tygodni/miesięcy/lat, jak określono przez `typPowtarzania`) pomiędzy powtórzeniami alarmu.

`liczbaPowtórzeń`

  Określa liczbę powtórzeń alarmu. Podaj -1, aby powtarzać alarm w nieskończoność.

`dataCzasZakończenia`

  Określa datę lub datę i czas zakończenia powtórzeń alarmu. Jeśli `dataCzasRozpoczęcia` zawiera czas, parametr ten musi również zawierać czas. Jeśli `dataCzasRozpoczęcia` zawiera tylko datę, ten parametr musi również zawierać tylko datę. Nie może zawierać określenia strefy czasowej; w interpretacji wartości tego parametru używana jest strefa czasowa parametru `dataCzasRozpoczęcia`.

`okresPodPowtarzania`

  Określa liczbę minut pomiędzy pod-powtórzeniami alarmu. Podaj 0, jeśli nie chcesz ustawiać podpowtórzeń. Ignorowane, jeśli nie określono powtórzenia.

`liczbaPodPowtórzeń`

  Określa liczbę podpowtórzeń alarmu, włącznie z początkowym wywołaniem.

##### Opis

`scheduleFile()` jest połączeniem D-Bus planującym wyświetlenie określonego pliku tekstowego lub graficznego w określonym dniu i o podanej godzinie. Oprócz podawania ścieżki pliku lub adresu &URL;, pomijając kolor tła i czcionkę, jego użycie jest identyczne, jak `scheduleMessage` - zobacz opis tej funkcji, jeśli chcesz dowiedzieć się więcej.

scheduleCommand

#### scheduleCommand

zaplanuj nowy alarm, wykonujący polecenie powłoki.

    bool scheduleCommand(const QString& wierszPolecenia,
                         const QString& dataCzasRozpoczęcia,
                         int anulujSpóźnione,
                         unsigned flagi,
                         const QString& powtarzanie,
                         int okresPodPowtarzania,
                         int liczbaPodPowtórzeń)

    bool scheduleCommand(const QString& wierszPolecenia,
                         const QString& dataCzasRozpoczęcia,
                         int anulujSpóźnione,
                         unsigned flagi,
                         int typPowtarzania,
                         int okresPowtarzania,
                         int liczbaPowtórzeń)

    bool scheduleCommand(const QString& wierszPolecenia,
                         const QString& dataCzasRozpoczęcia,
                         int anulujSpóźnione,
                         unsigned flagi,
                         int typPowtarzania,
                         int okresPowtarzania,
                         const QString& dataCzasZakończenia)

##### Parametry

`wierszPolecenia`

  Określa polecenie, którego wykonanie jest zaplanowane. Parametr `flagi` określa, czy ten parametr zawiera wiersz polecenia powłoki, czy skrypt polecenia.

`dataCzasRozpoczęcia`

  Określa zaplanowaną datę lub datę i czas, w których wiadomość powinna być wyświetlona. Dla alarmów z podaną tylko datą, ciąg powinien być w formacie YYYY-MM-DD [TZ] (zwracane jako `QDate::toString(Qt::ISODate)`). Dla alarmów z podanymi datą i czasem ciąg powinien być w formacie YYYY-MM-DDTHH:MM[:SS] [TZ] (zwracającym `QDateTime::toString(Qt::ISODate)`) lub HH:MM[:SS] [Clock] (zwracającym `QTime::toString(Qt::ISODate)`). Jeśli nie określono daty, użyta jest data dzisiejsza. Wartości sekundowe są ignorowane.

  Jeśli nie podano strefy czasowej, zostanie użyta lokalna strefa systemowa. Jeśli używane jest określanie strefy czasowej TZ, może być ono nazwą strefy systemowej (&eg; `Europa/Londyn`), `UTC`, czyli strefy czasowej UTC lub `Zegar`, aby użyć lokalnego zegara w komputerze i ignorować strefy czasowe.

`anulujSpóźnione`

  Powoduje anulowanie alarmu, jeśli nie może być on wywołany w określonej liczbie minut po zaplanowanym czasie alarmu. Jeśli wartością jest 0, alarm nie będzie anulowany, niezależnie od tego, jak późno zostanie wywołany.

`flagi`

  Określa logiczne OR odpowiednich flag alarmu. Bity flag zdefiniowane są w klasie `KAlarmIface` w `kalarmiface.h`. Nie wszystkie bity flag można zastosować w alarmach w postaci poleceń.

`powtarzanie`

  Określa regularne powtórzenie alarmu, używając schematu iCalendar, jak podano w RFC2445. FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO na przykład równe jest czterem powtórzeniom z 3-miesięczną przerwą, powtarzanych każdego ostatniego poniedziałku miesiąca. Dla alarmów niepowtarzanych podaj pusty ciąg.

`typPowtarzania`

  Określa typ powtarzania alarmu. Dopuszczalne wartości to MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY (minutowe, dzienne, tygodniowe, miesięczne, roczne). Są one zdefiniowane w klasie `KAlarmIface` w `kalarmiface.h`. Miesięczne powtarzania ustalane są za pomocą dnia w miesiącu, roczne zaś za pomocą daty w roku, gdzie w obu przypadkach data jest pobierana z parametru `dataCzasRozpoczęcia`.

`okresPowtarzania`

  Określa liczbę okresów (minut/dni/tygodni/miesięcy/lat, jak określono przez `typPowtarzania`) pomiędzy powtórzeniami alarmu.

`liczbaPowtórzeń`

  Określa liczbę powtórzeń alarmu. Podaj -1, aby powtarzać alarm w nieskończoność.

`dataCzasZakończenia`

  Określa datę lub datę i czas zakończenia powtórzeń alarmu. Jeśli `dataCzasRozpoczęcia` zawiera czas, parametr ten musi również zawierać czas. Jeśli `dataCzasRozpoczęcia` zawiera tylko datę, ten parametr musi również zawierać tylko datę. Nie może zawierać określenia strefy czasowej; w interpretacji wartości tego parametru używana jest strefa czasowa parametru `dataCzasRozpoczęcia`.

`okresPodPowtarzania`

  Określa liczbę minut pomiędzy pod-powtórzeniami alarmu. Podaj 0, jeśli nie chcesz ustawiać podpowtórzeń. Ignorowane, jeśli nie określono powtórzenia.

`liczbaPodPowtórzeń`

  Określa liczbę podpowtórzeń alarmu, włącznie z początkowym wywołaniem.

##### Opis

`scheduleCommand()` jest połączeniem D-Bus planującym określony wiersz polecenia powłoki lub skrypt polecenia do wykonania o podanej dacie i czasie. Oprócz podawania polecenia, pomijając kolor wiadomości, czcionkę i parametry pliku, jego użycie jest identyczne, jak użycie `scheduleMessage` - zobacz opis tej funkcji, jeśli chcesz dowiedzieć się więcej.

scheduleEmail

#### scheduleEmail

zaplanuj nowy alarm wysyłający e-mail.

    bool scheduleEmail(const QString& IDod,
                       const QString& adresy,
                       const QString& temat,
                       const QString& wiadomość,
                       const QString& załączniki,
                       const QString& dataCzasRozpoczęcia,
                       int anulujSpóźnione,
                       unsigned flagi,
                       const QString& powtarzanie,
                       int okresPodPowtarzania,
                       int liczbaPodPowtórzeń)

    bool scheduleEmail(const QString& IDod,
                       const QString& adresy,
                       const QString& temat,
                       const QString& wiadomość,
                       const QString& załączniki,
                       const QString& dataCzasRozpoczęcia,
                       int anulujSpóźnione,
                       unsigned flagi,
                       int typPowtarzania,
                       int okresPowtarzania,
                       int liczbaPowtórzeń)

    bool scheduleEmail(const QString& IDod,
                       const QString& adresy,
                       const QString& temat,
                       const QString& wiadomość,
                       const QString& załączniki,
                       const QString& dataCzasRozpoczęcia,
                       int anulujSpóźnione,
                       unsigned flagi,
                       int typPowtarzania,
                       int okresPowtarzania,
                       const QString& czasZakończenia)

##### Parametry

`IDod`

  Tożsamość &kmail-dopelniacz;, której chcesz użyć jako nadawcy wiadomości. Jeśli puste, zostanie użyty adres e-mail skonfigurowany w Ustawieniach e-mail &kmail-dopelniacz;.

`adresy`

  Rozdzielona przecinkami lista adresów e-mail odbiorców wiadomości.

`temat`

  Określa temat wiadomości.

`wiadomość`

  Określa treść wiadomości e-mail.

`załączniki`

  Rozdzielona przecinkami lista ścieżek lub adresów &URL; plików do wysłania jako załączniki do wiadomości.

`dataCzasRozpoczęcia`

  Określa zaplanowaną datę lub datę i czas, w których wiadomość powinna być wyświetlona. Dla alarmów z podaną tylko datą, ciąg powinien być w formacie YYYY-MM-DD [TZ] (zwracane jako `QDate::toString(Qt::ISODate)`). Dla alarmów z podanymi datą i czasem ciąg powinien być w formacie YYYY-MM-DDTHH:MM[:SS] [TZ] (zwracającym `QDateTime::toString(Qt::ISODate)`) lub HH:MM[:SS] [Clock] (zwracającym `QTime::toString(Qt::ISODate)`). Jeśli nie określono daty, użyta jest data dzisiejsza. Wartości sekundowe są ignorowane.

  Jeśli nie podano strefy czasowej, zostanie użyta lokalna strefa systemowa. Jeśli używane jest określanie strefy czasowej TZ, może być ono nazwą strefy systemowej (&eg; `Europa/Londyn`), `UTC`, czyli strefy czasowej UTC lub `Zegar`, aby użyć lokalnego zegara w komputerze i ignorować strefy czasowe.

`anulujSpóźnione`

  Powoduje anulowanie alarmu, jeśli nie może być on wywołany w określonej liczbie minut po zaplanowanym czasie alarmu. Jeśli wartością jest 0, alarm nie będzie anulowany, niezależnie od tego, jak późno zostanie wywołany.

`flagi`

  Określa OR logiczne odpowiednich flag alarmu. Bity flag są zdefiniowane w klasie `KAlarmIface` w `kalarmiface.h`. Nie wszystkie bity flag można zastosować w alarmach e-mail.

`powtarzanie`

  Określa regularne powtórzenie alarmu, używając schematu iCalendar, jak podano w RFC2445. FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO na przykład równe jest czterem powtórzeniom z 3-miesięczną przerwą, powtarzanych każdego ostatniego poniedziałku miesiąca. Dla alarmów niepowtarzanych podaj pusty ciąg.

`typPowtarzania`

  Określa typ powtarzania alarmu. Dopuszczalne wartości to MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY (minutowe, dzienne, tygodniowe, miesięczne, roczne). Są one zdefiniowane w klasie `KAlarmIface` w `kalarmiface.h`. Miesięczne powtarzania ustalane są za pomocą dnia w miesiącu, roczne zaś za pomocą daty w roku, gdzie w obu przypadkach data jest pobierana z parametru `dataCzasRozpoczęcia`.

`okresPowtarzania`

  Określa liczbę okresów (minut/dni/tygodni/miesięcy/lat, jak określono przez `typPowtarzania`) pomiędzy powtórzeniami alarmu.

`liczbaPowtórzeń`

  Określa liczbę powtórzeń alarmu. Podaj -1, aby powtarzać alarm w nieskończoność.

`dataCzasZakończenia`

  Określa datę lub datę i czas zakończenia powtórzeń alarmu. Jeśli `dataCzasRozpoczęcia` zawiera czas, parametr ten musi również zawierać czas. Jeśli `dataCzasRozpoczęcia` zawiera tylko datę, ten parametr musi również zawierać tylko datę. Nie może zawierać określenia strefy czasowej; w interpretacji wartości tego parametru używana jest strefa czasowa parametru `dataCzasRozpoczęcia`.

`okresPodPowtarzania`

  Określa liczbę minut pomiędzy pod-powtórzeniami alarmu. Podaj 0, jeśli nie chcesz ustawiać podpowtórzeń. Ignorowane, jeśli nie określono powtórzenia.

`liczbaPodPowtórzeń`

  Określa liczbę podpowtórzeń alarmu, włącznie z początkowym wywołaniem.

##### Opis

`scheduleEmail()` jest połączeniem D-Bus planującym wysłanie o określonej dacie i czasie wysłanie wiadomości e-mail. Oprócz podawania nagłówka e-mail i jego zawartości, pomijając kolor wiadomości, czcionkę i parametry pliku dźwiękowego, jego użycie jest takie samo, jak użycie `scheduleMessage` - zobacz opis tej funkcji, jeśli chcesz dowiedzieć się więcej.

edit

#### edit

Wyświetl okno Zmień alarm w celu edycji alarmu.

    bool edit(const QString& IDzdarzenia)

##### Parametry

`IDzdarzenia`

  Określa unikalny ID edytowanego zdarzenia.

##### Zwróć wartość

false, jeśli określony alarm nie został odnaleziony lub jest tylko do odczyty, true w odwrotnym przypadku.

##### Opis

`edit()` jest połączeniem D-Bus wyświetlającym okno Zmień alarm w celu edycji określonego alarmu.

editNew

#### editNew

Wyświetl okno Zmień alarm w celu edycji nowego alarmu.

    bool editNew(int typ)

    bool editNew(const QString& nazwaSzablonu)

##### Parametry

`typ`

  Określa typ alarmu. Możliwe wartości to: DISPLAY, COMMAND, EMAIL (wyświetlający, polecenie, e-mail). Określone są one w klasie `KAlarmIface` w `kalarmiface.h`.

`nazwaSzablonu`

  Określa nazwę szablonu alarmu, na którym chcesz oprzeć nowy alarm.

##### Zwróć wartość

false, jeśli `typ` ma niepoprawną wartość lub jeśli nie odnaleziono szablonu o nazwie z `nazwaSzablonu`; true w przeciwnym wypadku.

##### Opis

`editNew()` jest połączeniem D-Bus wywołującym wyświetlenie okna Zmień alarm w celu edycji nowego alarmu. Jeśli określono jako parametr typ alarmu, wyświetlane jest zwykłe okno. Alternatywnie, jeśli określono jako parametr nazwę szablonu, okno jest wypełnione szczegółami szablonu.

### Interfejs wiersza poleceń

Opcje wiersza poleceń dostarczane są, aby pozwolić innym programom uruchamiać &kalarm-biernik;, jeśli jeszcze nie jest uruchomiony, aby wywołać lub anulować zaplanowane alarmy, bądź zaplanować nowe alarmy. Powodem, dla którego warto używać opcji wiersza poleceń w tym celu jest to, że jeśli &kalarm; został uruchomiony bez żadnych parametrów wiersza poleceń, a następnie otrzymał polecenie D-Bus, zostanie uruchomiony w domyślnym trybie graficznym, co jest nieosiągalne dla żądań innych programów.

Programy powinny najpierw sprawdzić, czy &kalarm; jest uruchomiony; jeśli jest, powinny użyć połączenia D-Bus, aby wykonać te operacje.

Opcje wiersza poleceń dla planowania nowego alarmu są opisane w rozdziale Operacje wiersza poleceń. Opcje dla planowania i anulowania zaplanowanych alarmów są następujące:

Zwykli użytkownicy mogą również, jeśli chcą, użyć tych opcji wiersza poleceń (upewniając się, że mogą podać informacje o parametrze).

Opcja | Opis
--- | ---
`--cancelEvent IDzdarzenia` | Anuluj alarm z określonym ID zdarzenia. `--triggerEvent` nie może być podane z tą opcją.
`--triggerEvent IDzdarzenia` | Wywołaj alarm z określonym ID zdarzenia. Skutek działania taki sam, jak dla połączenia D-Bus triggerEvent(). `--cancelEvent` nie może być podane z tą opcją.

Przykłady:

    % kalarm --triggerEvent &kalarm;-387486299.702
    % kalarm --cancelEvent &kalarm;-388886299.793

## Pytania i odpowiedzi

&reporting.bugs; &updating.documentation;

Jakich plików konfiguracyjnych używa &kalarm;?

`$KDEHOME/share/config/kalarmrc` przechowuje Twoje ustawienia &kalarm-dopelniacz;.

`$KDEHOME/share/config/kresources/alarms/stdrc` przechowuje Twoją konfigurację zasobów alarmów.

($`KDEHOME` to zazwyczaj `~/.kde` lub coś podobnego.)

Gdzie &kalarm; zapisuje alarmy?

Nazwy plików kalendarza, które &kalarm; tworzy przy pierwszym uruchomieniu są następujące (mogą być one nadpisane przez wpisy w sekcji `Ogólne` pliku ustawień &kalarm-dopelniacz;):

- `$KDEHOME/share/apps/kalarm/calendar.ics` przechowuje aktywne alarmy (może być nadpisane przez wpis `Kalendarz`).

- `$KDEHOME/share/apps/kalarm/expired.ics` przechowuje nieaktualne alarmy (może być nadpisane przez wpis `WygasłeKalendarze`).

- `$KDEHOME/share/apps/kalarm/template.ics` przechowuje szablony alarmów (może być nadpisywane przez wpis `KalendarzSzablonów`).

Możesz się dowiedzieć, które pliki kalendarzy są aktualnie używane, przeglądając szczegóły każdego zasobu na liście zasobów alarmów. Nazwy plików są zapisywane w pliku konfiguracyjnym zasobów alarmów.

Szczegóły dotyczące alarmów aktualnie wyświetlanych są zapisywane w pliku kalendarza `$KDEHOME/share/apps/kalarm/displaying.ics`.

W jakim formacie zapisywane są alarmy?

Pliki kalendarzy, w których &kalarm; zapisuje alarmu są plikami tekstowymi, których format jest definiowany w dokumencie RFC2445 - Specyfikacja Tworzenia Kalendarzy i Planowania Podstawowych Obiektów (iCalendar). Jest to standardowy format, używany przez wszystkie programy kdepim. &kalarm; używa kilku niestandardowych właściwości, zgodnych z RFC2445. W komponencie VEVENT: `X-KDE-KALARM-FLAGS`, `X-KDE-KALARM-NEXTRECUR`, `X-KDE-KALARM-REPEAT`, `X-KDE-KALARM-ARCHIVE`, `X-KDE-KALARM-LOG`, a w komponencie VALARM: `X-KDE-KALARM-TYPE`, `X-KDE-KALARM-NEXTREPEAT`, `X-KDE-KALARM-FONTCOLOR`, `X-KDE-KALARM-VOLUME`, `X-KDE-KALARM-SPEAK`, `X-KDE-KALARM-EMAILID`.

Co to jest kalarmautostart?

kalarmautostart jest małym pomocnym programem, którego funkcją jest uruchamianie &kalarm-dopelniacz; przy zalogowaniu.

&kalarm; jest aktualnie odzyskiwany przez menedżera sesji przy zalogowaniu (aby wyświetlić ponownie okna w takim samym stanie, w jakim znajdowały się przed wylogowaniu). Lecz jeśli nie był on uruchomiony przed wylogowaniu, nie zostanie uruchomiony przez menedżera autostartu i z tego właśnie powodu musi być uruchamiany automatycznie. Problem występuje, gdy program jest zarówno zarządzany przez menedżera sesji, jak i uruchamiany automatycznie, nie ma wtedy gwarancji, który zostanie uruchomiony jako pierwszy. Jeśli autostart jest aktywowany najpierw, zapobiegnie to odzyskiwaniu stanu programu przez menedżera sesji.

Aby uniknąć tego problemu, kalarmautostart jest automatycznie uruchamiany przy zalogowaniu, zamiast &kalarm-dopelniacz;. Wszystko, co wykonuje ten program, to odczekanie chwili (aby upewnić się, że menedżer sesji wykona swoje zadanie) przed uruchomieniem &kalarm-dopelniacz;, po czym kończy swoje działanie.

## Podziękowania i licencja

&kalarm;

Program copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 &David.Jarvie; &David.Jarvie.mail;

Documentation copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 &David.Jarvie; &David.Jarvie.mail;

Maciej Wikłomaciej.wiklo@wp.pl

&underFDL; &underGPL;

Podziękowania dla autora programu &kde; 1 KAlarm, Stefana Nikolausa stefan.nikolaus@stuco.uni-oldenburg.de, który pozwolił użyć nazwy programu &kalarm;, który był początkowo dostępny dla &kde; 2.

## Instalacja

### Jak zdobyć &kalarm;

&install.intro.documentation;

&kalarm; jest dostępny dla &kde; 2 oraz jako samodzielny pakiet dla &kde; 2 ze strony http://www.astrojar.org.uk/kalarm

### Wymagania

&kalarm; wymaga standardowych bibliotek &kde; do zainstalowania (pakiety `kdelibs` i `kdepimlibs`) oraz pakietu `kdebase/runtime`. Do kompilacji ze źródeł potrzebujesz również ważnych pakietów bibliotek programistycznych i pakietu programistycznego &Qt;.

Poniższe opcjonalne pakiety przyspieszają czas działania &kalarm-dopelniacz;, gdy są zainstalowane:

- KTTSD (z pakietu kdeaccessibility): jeśli zainstalowany i skonfigurowany, razem z kompatybilnym syntezatorem mowy, pozwala &kalarm-celownik; wymówić wiadomości podczas ich wyświetlania.

&kalarm; używa około 12 Mb pamięci do działania, lecz wartość może się różnić, w zależności od Twojej platformy i konfiguracji.

Lista zmian znajduje się w pliku `ChangeLog` oraz na stronie http://www.astrojar.org.uk/kalarm.

### Kompilacja i instalacja

Jeśli nie możesz zdobyć odpowiadającego prekompilowanego pakietu binarnego, musisz skompilować &kalarm-biernik; samodzielnie ze źródeł. Pobierz plik pakietu źródłowego `kdepim-x.x.tar.bz2` lub `kalarm-x.x.tar.bz2` (lub podobny) w zależności, czy chcesz zainstalować pakiet, czy tylko &kalarm;. Rozpakuj plik do nowego katalogu, używając polecenia podobnego do ``tar` `xvfj package.tar.bz2``, a następnie zmień utworzony katalog.

&install.compile.documentation;

Jeśli masz zainstalowaną więcej niż jedną wersję &kde; (np. &kde; 2 i &kde; 3), może to prawdopodobnie zainstalować &kalarm; w nieodpowiednim katalogu &kde;. Jeśli to konieczne, możesz podać katalog &kde; jako parametr do ``./configure`` . Jeśli na przykład Twoje &kde; jest zainstalowane w katalogu `/opt/kde2`:

``./configure` --prefix=/opt/kde2`

Jeśli zainstalujesz &kalarm; w katalogu innym, niż ten, w którym zainstalowano &kde;, nie będzie on działał poprawnie, dopóki nie zmienisz jego położenia na znane dla &kde;. Aby to uczynić, musisz poprzedzisz zmienną środowiskową`KDEDIRS` położeniem &kalarm-dopelniacz; przy każdym uruchomieniu &kde;.

Jeśli na przykład &kde; jest zainstalowane w `/opt/kde`, `KDEDIRS` może normalnie zostać ustawione na `/etc/opt/kde:/opt/kde`. Jeśli zainstalujesz &kalarm; w `/usr/local`, zaistnieje potrzeba ustawienia `KDEDIRS` na `/usr/local:/etc/opt/kde:/opt/kde` przed uruchomieniem &kde;.

Samodzielna wersja &kalarm-dopelniacz; posiada specjalną opcję konfiguracji, która pozwala wybrać języki dokumentacji do zainstalowania, podając kod języka lub listę kodów języków, jako parametr do `./configure`. Dokumentacja jest domyślnie instalowana we wszystkich językach. Lista języków dokumentacji jest włączona w pakiet, razem z ich kodami, w pliku `DOC-LANGUAGES`. Aby na przykład zainstalować dokumentację tylko w języku angielskim i francuskim:

``./configure` --enable-doc-language="fr en_GB"`

Zauważ, że opcja ta nie odnosi efektu, na którym interfejsie użytkownika są zainstalowane tłumaczenia.

### Konfiguracja

Aby uruchomić &kalarm; w środowisku &kde; nie jest potrzebna żadna specjalna konfiguracja. Gdy raz uruchomisz &kalarm-biernik;, będzie on uruchamiał się przy każdym zalogowaniu, aby monitorować zaplanowane alarmy.

Aby uruchomić &kalarm; w środowisku innym niż &kde;, należy upewnić się, że &kalarm; uruchamia się przy każdym zalogowaniu. Bardziej szczegółowe instrukcje zawarte są w pliku `INSTALL`, rozpowszechnianym wraz z &kalarm-narzednik;.

&documentation.index;