# Podręcznik &kalarm-dopelniacz;

David
Jarvie

    &David.Jarvie.mail;

David
Jarvie

    &David.Jarvie.mail;

Twórca
Krzysztof
Woźniak

    wozniakk@ceti.pl

Polskie tłumaczenie
2001
2002
2003
2004
2005
2006
2007
2008
2009
&David.Jarvie;
&FDLNotice;
2008-09-25
2.2.7

&kalarm; to osobisty harmonogram alarmów dla &kde;.

KDE
kdepim
kalarm
alarm
przypomnienie
program planujący

## Wprowadzenie

Program &kalarm; pozwala na zaplanowanie wyświetlania wiadomości alarmowych, odtwarzania dźwięków, wykonywania poleceń lub wysłania wiadomości email.

W domyślnym graficznym trybie pracy, &kalarm; wyświetla listę nadchodzących alarmów, pokazując terminy i informacje o nich. Można tu utworzyć nowy alarm, zmienić lub usunąć istniejące alarmy. Można też wyświetlić alarmy, których czas już minął.

Podczas ustawiania alarmu, można zdecydować czy ma on być regularnie powtarzany oraz czy ma być anulowany, w przypadku gdy nie mógł być wyświetlony w określonym czasie. Dla alarmów wyświetlanych, można wprowadzić wiadomość tekstową, wybrać plik tekstowy lub graficzny do wyświetlenia lub wprowadzić polecenie, którego wynik będzie wyświetlony. Można także wybrać kolor tła dla wiadomości, oraz ustawić odtwarzanie dźwięku lub wypowiedzenie wiadomości.

Alarmy mogą być także ustawiane za pomocą linii poleceń za pomocą wywołań interfejsu D-Bus.

Gdy nadejdzie czas wyświetlenia danego alarmu, wiadomość pokazywana jest na wszystkich pulpitach &kde; aby użytkownik jej nie przeoczył. Okno wiadomości wyświetla godzinę, na którą alarm został ustawiony. Okno zawiera też z reguły możliwość odroczenia alarmu, aby był wyświetlony później. Przykładowa wiadomość alarmu:

Zrzut ekranu okna wiadomość programu &kalarm;
Wiadomość alarmu

Gdy alarm jest zdefiniowany jako wywołanie polecenia lub wysłanie wiadomości email, program &kalarm; nie wyświetla niczego.

Program &kalarm; pokazuje ikonę na tacce systemowej, może ona być jednak ukryta jeżeli jest to pożądane.

## Użytkowanie programu &kalarm;

Po uruchomieniu &kalarm; bez parametrów, otwiera się w trybie graficznym. W oknie wyświetlana jest lista zaprogramowanych alarmów.

Wszystkie pola przewijania w programie &kalarm; posiadają funkcję przyśpieszania. Aby wartość w polu zmieniała się szybciej, należy wcisnąć klawisz &Shift; podczas klikania na strzałki obok pola przewijania.

### Typy alarmów

Podstawowe rodzaje alarmów dostępne w programie &kalarm; są następujące:

- Wyświetla alarm jako wiadomość tekstową wprowadzoną przez użytkownika, zawartość pliku tekstowegolub graficznego albo treść komunikatu wyjściowego polecenia uruchomionego po włączeniu alarmu. Oprócz wyświetlania ww. elementów, może być również zagrany plik dźwiękowy, krótki dźwięk bip lub wypowiedź z syntezatora mowy. Można także określić polecenia do wykonania przed i po wyświetleniu wiadomości alarmu.

- Alarmy w postaci polecenia uruchamiają polecenie lub skrypt powłoki. W przypadku, gdy polecenie wykonane jest bez błędu to nic nie jest wyświetlane na ekranie

- Alarm w postaci e-mail wysyłają wiadomość na podany adres. Nic nie wyświetla się, jeżeli nie wystąpił błąd.

#### Obsługa błędów

W przypadku wystąpienia błędu w momencie zajścia wyzwalacza alarmu, wyświetla się komunikat błędu (chyba że użytkownik wcześniej zdecydował, aby nie pokazywać kolejnych komunikatów błędów)

Jeżeli w trakcie wykonywania polecenia związanego z alarmem wystąpił błąd, do obok pola wiadomości pojawi się biały lub czerwony wykrzyknik, a w kolumnie z kolorem pojawi się czerwona barwa. Szczegółowe informacje o błędzie pojawiają się jako podpowiedź po najechaniu kursorem na linię w liście alarmów. Analogiczne informacje o błędach pojawiają się w przypadku błędów w wykonaniu poleceń przed i po wyświetleniu alarmu wpisanych w oknie "Działania specjalne". W tym jednak przypadku kolumna z kolorem nie zmienia barwy na czerwoną.

### Lista alarmów

Główne okno programu &kalarm; wyświetla aktualną listę nadchodzących alarmów, wyświetlając ich czas, odstęp do powtórzenia, kolor i tekst wiadomości, nazwę pliku do wyświetlenia, polecenie do wykonania lub temat wiadomości. (Dla alarmów powtarzających się, wyświetlany jest czas następnego wystąpienia alarmu. Dla alarmów z przypomnieniem, pokazywany jest czas właściwego alarmu, a nie przypomnienia). Ikona po lewej stronie opisu alarmu wskazuje na rodzaj alarmu.

Zrzut ekranu okna głównego programu &kalarm;
Okno główne

Dla alarmów powtarzających się, w liście widoczny jest czas najbliższego wystąpienia alarmu i podstawowy okres powtarzania (&eg; 1 dzień dla codziennych wystąpień, 3 tygodnie dla alarmów powtarzanych w każdy poniedziałek i czwartek co trzeci tydzień, Logowanie dla alarmów wyświetlanych po każdym zalogowaniu).

W przypadku wystąpienia błędu wykonania polecenia dla alarmów w postaci polecenia, lub polecenia wykonywanego przed lub po wyświetleniu alarmu, w kolumnie kolor pojawi się ikona błędu co zostało opisane powyżej w części Obsługa błędów.

#### Zmiana wyglądu listy alarmów

Alarmy mogą być sortowane w kolejności wg. daty/czasu, częstotliwości powtarzania, koloru, rodzaju lub treści. Zmiana kolejności sortowania odbywa się przez kliknięcie nagłówka danej kolumny, odwrócenie kolejności sortowania odbywa się przez ponowne kliknięcie na ten sam nagłówek.

Można opcjonalnie wyświetlać czas do uruchomienia każdego alarmu, razem lub zamiast informacji o ustawionym czasie alarmu. Aby wyświetlić lub schować okno z czasem alarmu należy wybrać opcję w menu: Widok Pokaż czasy alarmu. Aby wyświetlić lub schować kolumnę z czasem pozostałym do zadziałania alarmu należy wybrać opcję Widok Pokaż czas do alarmu. Zawsze wyświetlana jest przynajmniej jedna z tych kolumn.

Jeżeli w użyciu jest wiele kalendarzy alarmów, można ustawić kodowanie alarmów kolorem w zależności od tego, do którego kalendarza należy poprzez ustalenie różnych kolorów tła dla każdego kalendarza.

#### Zarchiwizowane alarmy

Domyślnie, &kalarm; archiwizuje alarmu przez pewien czas po ich wygaśnięciu lub usunięciu. (Usunięte alarmy są archiwizowane tylko wtedy gdy przynajmniej raz wystąpiły). Ustawienia czasu archiwizacji możliwe jest w oknieKonfiguracji.

Zarchiwizowane alarmy mogą być wyświetlane na liście alarmów po wybraniu opcji Widok Show Archived Alarms. Aby je schować, należy ponownie wybrać opcję Widok Show Archived Alarms.

#### Przeszukiwanie listy alarmów

Użytkownik może poszukiwać dowolnego tekstu na liście alarmów. Funkcja wyszukiwania znajduje się menu Edycja Znajdź.... W wyświetlonym oknie dialogowym należy wybrać typ wyszukiwanego alarmu. Aby kontynuować operację wyszukiwania po znalezieniu tekstu można skorzystać z poleceń Edycja Znajdź następne lub Edycja Znajdź poprzednie .

Przeszukiwanie działa następująco:

- W alarmach wyświetlanych, przeszukiwany jest tekst z treścią wiadomości.

- Dla alarmów wyświetlających plik, przeszukiwana jest ścieżka &URL; pliku.

- Dla alarmów w postaci poleceń, przeszukiwane jest polecenie lub skrypt.

- Dla alarmów w postaci wiadomości przeszukiwane są: temat wiadomości, treść wiadomości, odbiorcy wiadomości i adresy &URL; załączników.

Tylko alarmy wyświetlane w liście alarmów mogą być przeszukiwane. Jeżeli użytkownik chce przeszukać alarmy archiwalne, musi najpierw włączyć ich wyświetlanie, co zostało opisane w poprzedniej sekcji.

### Tworzenie i zarządzanie alarmami

#### Tworzenie nowego alarmu

Aby utworzyć nowy alarm, należy wybrać odpowiedni tym alarmu na wyświetlonej liście. Spowoduje to otwarcie okna Edycji alarmu za pomocą którego można ustawić parametry alarmu.

- Wybrać Działania Nowy.

- Kliknąć Prawy przycisk myszy na ikonie na tacce systemowej i wybrać Nowy alarm z menu kontekstowego.

- Nacisnąć Prawy przycisk na alarmie z listy i wybrać opcję Nowy z menu kontekstowego.

Dodatkowo, można tworzyć wstępnie skonfigurowane alarmy z różnych źródeł:

- Aby utworzyć alarm na podstawie szablonu, należy skorzystać z instrukcji w sekcjiSzablony alarmów.

- Aby utworzyć nowy alarm na podstawie istniejącego, należy wybrać pozycję Działania Kopiuj.... Spowoduje to otwarcie okna edycji alarmu wypełnionego ustawieniami pobranymi z kopiowanego alarmu.

- Aby utworzyć alarm wyświetlający wiadomość email, należy przeciągnąć z programu &kmail; wiadomość i opuścić ją w oknie programu &kalarm; lub na ikonie na tacce systemowej. Spowoduje to otwarcieOkna edycji alarmu, w którym cała wiadomość email (wraz z nadawcą, odbiorcę, &etc;) będzie wprowadzona jako treść do wyświetlenia.

- Aby utworzyć nowy alarm w postaci wiadomości email, lub wysłać kopię istniejącego maila, należy przeciągnąć wiadomość z okna &kmail; do głównego okna &kalarm-dopelniacz; lub do ikony na tacce systemowej. Następnie należy wybrać opcję Email. W oknie edycji alarmu pojawią się wszystkie szczegóły emaila poza nadawcą wiadomości.

- Aby utworzyć alarm wyświetlający informację o pozycji do zrobienia, należy przeciągnąć element do zrobienia z &korganizer-dopelniacz; lub innej aplikacji do głównego okna programu &kalarm; lub ikony na tacce systemowej. Otworzy to okno edycji alarmu w którym zawartość czynności do zrobienia będzie wprowadzona jako treść wiadomości alarmu.

- Przeciągnięcie dowolnego zaznaczonego fragmentu tekstu do okna &kalarm-dopelniacz; lub do ikony na tacce systemowej otwiera okno edycji alarmu i ustawienie przeciąganego tekstu jako wiadomości alarmu.

- Aby utworzyć alarm wyświetlający zawartość pliku, należy przeciągnąć ścieżkę &URL; do głównego okna &kalarm; lub ikony na tacce systemowej. Otworzy sięokno edycji alarmu z ustawioną nazwą pliku.

- Można automatycznie utworzyć alarmy związane z urodzinami kontaktów z programu &kaddressbook;. Opisane to zostało w sekcji Importowanie urodzin z&kaddressbook-dopelniacz;.

#### Modyfikacja istniejącego alarmu

Aby zmodyfikować istniejący alarm oczekujący na wyświetlenie (alarmy których czas minął nie mogą być zmieniane), należy wykonać następujące operacje:

- Dwukrotnie kliknąć na alarmie w liście alarmów.

- Wybrać alarm klikając raz na pozycji w liście alarmów, a następnie wybrać opcję Działania Edytuj.

- Nacisnąć Prawy przycisk na alarmie z listy i wybrać opcję Edytuj z menu kontekstowego.

Wyświetli się okno Modyfikacji alarmu.

#### Usuwanie/Przywracanie alarmu

Aby usunąć istniejące alarmy, należy wybrać jedną lub więcej pozycji na liście alarmów, i wykonać następujące czynności:

- Wybrać Działania Usuń.

- Nacisnąć Prawy przycisk na wybranych na liście alarmachi wybrać opcję Usuń z menu kontekstowego.

- Aby usunąć je bez pytania o potwierdzenie, należy wcisnąć &Shift;-Delete.

Przy usuwaniu aktywnego alarmu, jest on przenoszony do archiwum pod warunkiem że został przynajmniej raz aktywowany przed usunięciem oraz jeżeli włączona jest opcja archiwizacji alarmów. (Za pomocą opcji zawartych w oknie konfiguracji można kontrolować czy i jak długo program będzie przechowywał zarchiwizowane alarmy). Alarmy zarchiwizowane albo takie, które nigdy wcześniej nie były aktywowane usuwane są bezpowrotnie.

Można ponownie aktywować usunięty alarm z listy zarchiwizowanych alarmów, zakładając że jest on jeszcze dostępny. Aby tego dokonać, najpierw należy włączyć wyświetlanie zarchiwizowanych alarmów, co zostało opisanew sekcji Zarchiwizowane alarmy. Następnie należy:

- Wybrać jeden lub więcej zarchiwizowanych alarmów z listy klikając na odpowiednie pozycje, a następnie skorzystać z opcji Działania Włącz ponownie .

- Należy nacisnąć Prawy przycisk na zarchiwizowanym alarmie z listy i wybrać opcję Włącz ponownie z menu kontekstowego.

#### Włączanie i wyłączanie alarmu

W sekcji Włączanie i wyłączanie alarmów znajdują się informacje jak włączać lub wyłączać wszystkie lub wybrane alarmy.

#### Potwierdzanie alarmu

W sekcji Okno wiadomości alarmu znajdują się informację o tym jak potwierdzać alarmy.

#### Szablony alarmów

Jeżeli użytkownik często ustawia podobne alarmy, można utworzyć szablon alarmu aby uniknąć ciągłego powtarzania konfiguracji tych samych ustawień. Szablon może zawierać wszystkie informacje ze zwykłego alarmu, poza terminem rozpoczęcia.

Przykładowo, możesz często ustawiać alarm przypominający o programie telewizyjnym, który pojawia się o różnych porach dnia z tygodnia na tydzień. Szablon będzie zawierał wszystkie parametry alarmu (tekst wiadomości, czy alarm będzie odtwarzał dźwięk, &etc;) oprócz daty i czasu. Po stworzeniu takiego szablonu, wystarczy teraz na jego podstawie utworzyć nowy alarm i w otwartym oknie edycji alarmu wprowadzić datę i czas.

Aby utworzyć alarm na podstawie szablonu, trzeba otworzyć okno edycji alarmu z ustawieniami pobranymi z szablonu:

- Należy wybrać polecenie Działania Nowy alarm z szablonu , a następnie wybrać pożądany szablon.

- Nacisnąć Prawy przycisk myszy, wybraćNowy alarm z szablonu w menu kontekstowym, a następnie wybrać pożądany szablon.

- Otworzyć okno edycji alarmu w standardowy sposób, a następnie nacisnąć przycisk Wczytaj szablon... aby wybrać pożądany szablon.

##### Konfiguracja szablonów

Można tworzyć, zmieniać i usuwać szablony za pomocą okna szablonów alarmów, można też utworzyć nowy szablon alarmu na podstawie istniejącego alarmu.

Aby utworzyć nowy szablon alarmu, należy wykonać następujące operacje:

- Należy otworzyć okno szablonów alarmów przez wybranie polecenia Plik Szablony... w menu, następnie trzeba kliknąć Nowy, i wybrać rodzaj alarmu z wyświetlonej listy. Spowoduje to otwarcie pustego okna edycji szablonu.

- Można otworzyć okno szablonów alarmu poprzez wybranie w menu Plik Szablony... , wybranie istniejącego szablonu i kliknięcie przycisku Kopiuj. Spowoduje to otwarcie okna edycji szablonu wypełnionego ustawieniami skopiowanymi z wybranego szablonu.

- Można podświetlić alarm na liście alarmów i wybrać Działania Utwórz szablon... . Spowoduje to otwarcie okna edycji szablonu wypełnionego kopią ustawień pobraną z wybranego alarmu.

Aby zmodyfikować istniejący szablon, należy otworzyć okno edycji szablonu poprzez Plik Szablony... a następnie Edycja. Spowoduje to otwarcie okna edycji szablonu opisanego poniżej.

Aby usunąć istniejący szablon, należy otworzyć okno edycji szablonu poprzez Plik Szablony... a następnie wybranie jednego lub więcej szablonów i kliknięcie Usuń. Pojawi się prośba o potwierdzenie aby uniknąć przypadkowego usunięcia.

##### Okno edycji szablonu

Okno edycji szablonu jest podobne do okna edycji alarmu. Okna różnią się następującymi ustawieniami:

- Wprowadzanie nazwy szablonu możliwe jest w polu Nazwa szablonu. Jest to nazwa wyświetlana we wszystkich listach wyboru szablonu alarmu, tak więc najlepiej wybrać nazwę, która będzie jednoznacznie określać funkcję szablonu. Każda nazwa szablonu musi być unikalna.

- W polu wyboru Czas należy wybrać jedną z pozycji:

  - Domyślny czas oznacza, że nie będzie ustalany żaden czas aktywacji alarmu. Alarmy bazujące na tym szablonie będą używały domyślnego czasu aktywacji dla nowych alarmów.

  - Czas aby umożliwić wpisanie terminu aktywacji alarmu.

  - Tylko data dla ustalenia że alarm powinien mieć ustawianą tylko datę bez czasu.

  - Czas od teraz umożliwia wprowadzenie jak długo (w godzinach i minutach) od utworzenia alarmu, ma zostać ustawiony czas jego aktywacji.

- W sekcji Reguła powtarzania w zakładce Powtarzanie, nie trzeba wybierać dnia ani miesiąca dla powtórzeń cotygodniowych i corocznych.

#### Kalendarze alarmów

Jeżeli użytkownik pracuje tylko na jednym komputerze i nie współpracuje z innymi osobami, nie jest dla niego istotne gdzie &kalarm; przechowuje swoje alarmy. Jeżeli jednak, alarmy mają być dostępne na więcej niż jednym komputerze, w więcej niż jednej lokalizacji, można zdefiniować kalendarze alarmów aby &kalarm; mógł w nich przechowywać swoje alarmy dodatkowo lub zamiast kalendarzy domyślnych.

Można przeglądać i manipulować kalendarzami za pomocą listy kalendarzy, która może być wyświetlona obok listy alarmów w głównym oknie programu &kalarm;. Alarmy z wszystkich kalendarzy alarmów są połączone w jedną listę. Podczas zapisywania nowego alarmu, można ustawić opcję konfiguracji określającą czy ma być zapisywany automatycznie do kalendarza domyślnego, lub czy użytkownik będzie proszony o wybranie kalendarza. Podczas edytowania istniejącego alarmu, jest on automatycznie zapisywane do oryginalnego kalendarza.

##### Rodzaje i ustawienia kalendarzy

Kalendarze alarmów są pogrupowane według rodzaju alarmu oraz rodzaju przechowywania. Mogą być wyłączone, ustawiane w tryb tylko do odczytu lub ustawiane jako domyślne dla danego rodzaju alarmu.

Typ alarmu

  Trzy typy alarmów – aktywne, zarchiwizowane i szablon – są przechowywane w oddzielnych kalendarzach. W związku z tym &kalarm; posiada trzy domyślne standardowe kalendarze, po jednym dla każdego typu (więcej na ten temat w sekcji Pytania i odpowiedzi), które mogą być zmienione na życzenie użytkownika.

Miejsce przechowywania

  Program &kalarm; obsługuje trzy miejsca przechowywania alarmu:

  - Plik lokalny: Alarmy są przechowywane w lokalnym pliku w formacie iCalendar.Domyślnie &kalarm; używa lokalnych plików kalendarza (więcej na ten temat w sekcji Pytania i odpowiedzi). Plik lokalny może także oznaczać kalendarz umieszczony w sieci lokalnej, warunkiem jest tylko to, aby mógł być określony przez ścieżkę dostępu zaczynającą się od znaku: `/`.

  - Lokalny katalog: Pliki przechowywane są w katalogu lokalnym. Każdy alarm umieszczany jest w osobnym pliku w formacie iCalendar. Ta metoda przechowywania ma tą przewagę, że w przypadku uszkodzenia pliku utracony zostanie tylko jeden alarm, a nie cały kalendarz.

  - Plik zdalny: Alarmy są przechowywane w pojedynczym pliku zdalnym w formacie iCalendar. Ta metoda pozwala na zdalny dostęp do danych o alarmach niezależnie od miejsca pobytu, pozwala także na oglądanie alarmów użytkownika przez inne osoby. Podczas używania plików zdalnych, &kalarm; pracuje na lokalnej podręcznej kopii danych.

    Jeżeli zdalne kalendarze alarmów są współdzielone między użytkownikami, zmiany dokonane przez jedną osobę nie będą automatycznie dostępne dla innych, albo może wystąpić opóźnienie zanim inni zobaczą te zmiany. Może się zdarzyć, że zmiany dokonane przez kogoś mogą zostać nadpisane przez kogoś innego, bez żadnej informacji że stało się coś takiego.Technicznymi przyczynami takiego zachowania jest fakt, iż zmiany dokonane przez osobę A będą widoczne dla osoby B, dopiero wtedy gdy podręczna kopia kalendarza A zostanie zapisana w pliku zdalnym, a następnie osoba B ponownie załaduje kalendarz zdalny do pamięci podręcznej. To czy i kiedy kalendarze zdalne są zapisywane i ponownie ładowane zależy od parametrów konfiguracji ustawianych przez każdego użytkownika dla tego kalendarza.

    Metodą uniknięcia ww. problemów może być dostosowanie parametrów konfiguracyjnych dotyczących zapisywania i przeładowywania kalendarzy lub wdrożenie zasady, że jedynie właściciel kalendarza może do niego zapisywać, a pozostałe osoby powinny otwierać go w trybie tylko do odczytu.

Stan włączony/wyłączony

  Wyłączanie kalendarza ma taki sam efekt jak jego usunięcie, z tym wyjątkiem, że będzie on dalej dostępny na liście kalendarzy i można go ponownie włączyć. Jeżeli kalendarz jest wyłączony, alarmy w nim zdefiniowane są ignorowane i nie pojawiają się na liście alarmów lub na liście szablonów. Jeżeli zostanie ponownie włączony, alarmy pojawią się na liście i staną się aktywne.

Stan tylko do odczytu

  Kalendarze tylko do odczytu nie mogą być zmieniane, nie da się też do nich dodawać alarmów. Nie można więc edytować alarmów. Nie jest także możliwe odkładanie alarmów, ponieważ wymagałoby to zapisania czasu odłożenia. Po aktywacji alarmu, nie jest on usuwany z kalendarza ani archiwizowany dopóki jakiś użytkownik z prawami zapisu nie otworzy kalendarza.

  Można ustawić tryb tylko do odczytu dla kalendarza w oknie konfiguracyjnym. Niektóre kalendarze nie mogą jednak zostać ustawione w tryb zapisu, z kilku powodów:

  - Jeżeli kalendarz został utworzony w innej aplikacji, nie będzie bezpieczne jego modyfikowanie przez program &kalarm;, gdyż różnice w formacie danych mogą spowodować, iż nie będzie można go używać w oryginalnej aplikacji.

  - Jeżeli kalendarz został utworzony w nowszej wersji programu &kalarm;, dane mogą być utracone jeżeli starsza wersja &kalarm; go zaktualizuje.

  - Jeżeli kalendarz został utworzony we wcześniejszej wersji programu &kalarm;, dane mogą być utracone lub staną się bezużyteczne dla starszej wersji, jeżeli zostaną zaktualizowane przez nowszą wersję &kalarm;. Wyświetli się pytanie, czy użytkownik chce skonwertować format kalendarza aby można go było zmieniać, z ostrzeżeniem o potencjalnych problemachz kompatybilnością jeżeli poprzednia wersja &kalarm; będzie otwierać kalendarz.

  - Jeżeli nie masz prawa zapisu do pliku lub katalogu kalendarza.

  Jeżeli użytkownik potrzebuje zapisać coś w alarmach kalendarza, który jest tylko do odczytu, można skopiować alarmy i zaimportować do kalendarza, w którym można zapisywać, za pomocą polecenia Importuj... w menu kontekstowym kalendarza docelowego (więcej na ten temat w sekcji Importowanie alarmów z zewnętrznych kalendarzy).

Domyślny stan kalendarza

  Dla każdego rodzaju alarmu można zdefiniować po jednym kalendarzu domyślnym. Nowe alarmy będą automatycznie zapisywane w kalendarzu domyślnym dla danego rodzaju alarmu, chyba że zaznaczona została opcja pytania o miejsce zapisywania nowych alarmów i szablonów w oknie konfiguracji.

##### Korzystanie z kalendarzy

Użytkownik może przeglądać i manipulować kalendarzami poprzez okno listy kalendarzy, które może być wyświetlone lub ukryte za pomocą polecenia Widok Pokaż kalendarze . Podczas używania listy kalendarzy, najpierw należy wybrać rodzaj alarmu z listy rozwijanej znajdującej się w górnej części lub nacisnąć Prawy przycisk myszy na wybranym kalendarzu i wybrać działanie z menu kontekstowego. Dostępne są następujące działania:

Dodaj...

  Dodaje kalendarz wybranego rodzaju do listy. Użytkownik musi określić rodzaj nośnika, a następnie wyświetli się okno konfiguracji kalendarza, gdzie ustawić można lokalizację kalendarza i inne parametry. Jeżeli w danej lokalizacji nie ma żadnego kalendarza, to utworzony zostanie nowy plik z kalendarzem.

Usuń

  Usunięcie wybranego kalendarza z listy. Sam kalendarz nie jest usuwany, nie będzie tylko go na liście, może on być później dodany jeżeli pojawi się potrzeba.

Edycja...

  Edytuje wybrany kalendarz. Wyświetla się okno konfiguracji dla wybranego kalendarza.

Wczytaj ponownie

  Wczytuje ponownie wybrany kalendarz. Kalendarz jest ponownie wczytany z ustawionej lokalizacji, aby zapewnić że nie ma niezgodności pomiędzy alarmami wyświetlanymi w &kalarm; a aktualną zawartością kalendarza. Jeżeli kalendarz jest współdzielony z innymi użytkownikami, wszelkie zmiany przez nich dokonane staną się widoczne w &kalarm;.

  Jeżeli użytkownik wczyta ponownie zdalny kalendarz, to wszelkie zmiany w alarmach dokonane po ostatnim jego zapisaniu zostaną utracone. Dodatkowo, alarmy które wygasły od ostatniego zapisu mogą zostać ponownie aktywowane.

Zapisz

  Zapisuje wszystkie zmiany w wybranym kalendarzu. Aktualizowane są wszelkie zmiany w alarmach, które wystąpiły od ostatniego zapisania lub przeładowania kalendarza. Polecenie jest użyteczne jedynie dla kalendarzy zdalnych, kalendarze lokalne są bowiem zapisywane po każdej zmianie. Użytkownik może ustawić jak często i kiedy zdalny kalendarz powinien być automatycznie zapisywany za pomocą okna konfiguracji kalendarza (polecenie Edytuj... w jego menu kontekstowym).

  Jeżeli zapisywany jest kalendarz zdalny współdzielony z innymi użytkownikami, wszelkie zmiany przez nich dokonane od momentu ostatniego przeładowania kalendarza (automatycznego lub ręcznego) zostaną utracone.

Importuj...

  Importuje alarmy z zewnętrznego kalendarza do bieżącego kalendarza. Jest to opisane w sekcji Importowanie alarmów z zewnętrznych kalendarzy. Opcja nie jest dostępna dla kalendarzy wyłączonych lub znajdujących się w trybie tylko do odczytu.

Eksportuj...

  Eksportuje wszystkie alarmy z bieżącego kalendarza do zewnętrznego pliku kalendarza. Jest to opisane w sekcji Eksportowanie alarmów do zewnętrznych kalendarzy. Opcja nie jest dostępna dla kalendarzy wyłączonych.

Pokaż szczegóły

  Wyświetla informacje o wybranym kalendarzu: lokalizację, rodzaj pamięci oraz status.

Użyj jako domyślny

  Ustawia wybrany kalendarz jako domyślny dla danego typu kalendarza. Opcja nie jest dostępna dla kalendarzy wyłączonych lub będących tylko do odczytu.

Ustaw kolor...

  Ustawia kolor tła dla podświetlania alarmów z danego kalendarza na liście alarmów. Dzięki temu, można łatwo zidentyfikować alarmu należące do poszczególnych kalendarzy.

Wyczyść kolor

  Usuwa kolor podświetlania alarmów należących do tego kalendarza.

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

Użytkownik może importować alarmy z innych plików kalendarza do programu &kalarm;. Funkcja importowania skanuje wybrany kalendarz w poszukiwaniu zdarzeń zawierających alarmy, a następnie kopiuje je (nadając nowy unikalny numer ID) do kalendarza &kalarm;. Zdarzenia bez alarmów, oraz wpisy kalendarza nie będące zdarzeniami, są ignorowane. Możliwe są dwa sposoby importowania alarmów:

- Za pomocą polecenia Plik Importuj Alarmy... można zaimportować alarmy wszystkich typów (aktywne, zarchiwizowane oraz szablony) z kalendarza.

  Jeżeli ustawiono kalendarz alarmu, dla każdego typu, alarmy zostaną dodane do kalendarzy odpowiednich dla ich typu. Jeżeli w oknie konfiguracji ustawiono konieczność decyzji użytkownika, to pojawi się pytanie jakiego kalendarza użyć do zapisania importowanych alarmów.

- Naciśnięcie prawego przycisku myszy na kalendarzu w liście i wybranie polecenia Importuj... z menu kontekstowego. Importuje to alarmy aktualnie wybranego rodzaju do tego kalendarza. Na przykład, jeżeli dany kalendarz dotyczy szablonów alarmów, to zaimportowane zostaną tylko szablony alarmów (a nie aktywne bądź zarchiwizowane alarmy).

Jeżeli alarmy są importowane z plików utworzonych przez inne programy, alarmy mogą zostać zmienione podczas procesu importowania, zmianie mogą ulec nawet czasy alarmów. Zależy to od formatu danych stosowanych przez inną aplikację, i jest to nieuniknione jeżeli ten format jest inny od tego, którego oczekuje &kalarm;. Zawsze po zaimportowaniu należy sprawdzić alarmy i poprawić jeśli zajdzie potrzeba.

#### Eksportowanie alarmów do kalendarzy zewnętrznych

Użytkownik może eksportować alarmy z programu &kalarm; do innych plików kalendarza. Może eksportować alarmy wybrane na liście lub wszystkie alarmy zapisane w kalendarzu. Różne sposoby eksportowania zostały opisane poniżej. Którykolwiek z tych sposobów zostanie użyty, można zarówno utworzyć nowy plik lub dopisać alarmy do istniejącego pliku kalendarza. Aby dopisać alarmy do pliku, należy zaznaczyć opcję Dołącz do istniejącego pliku w oknie wyboru pliku, w przeciwnym wypadu plik zostanie nadpisany.

- Aby wyeksportować alarmy zaznaczone na liście, należy nacisnąć prawy przycisk myszki na zaznaczeniu i wybrać Eksportuj... z menu kontekstowego, lub wybrać polecenie Plik Eksportuj zaznaczone alarmy... z menu głównego.

- Aby wyeksportować wszystkie alarmy z kalendarza, należy nacisnąć prawy przycisk myszki na kalendarzu w liście, i wybrać Eksportuj... z menu kontekstowego.

#### Importowanie urodzin z programu &kaddressbook;

Użytkownik może zdefiniować alarmy dla dat urodzin kontaktów zapisany w programie &kaddressbook;, poprzez wybranie poleceniaPlik Importujurodziny.... Wyświetli się okno dialogowe, w którym można wybrać dla czyich urodzin zdefiniować alarm.

- W sekcji Tekst alarmu można wpisać tekst wyświetlany w wiadomościach alarmu dla urodzin. Tekst wiadomości jest tworzony przez połączenie tekstów z pola Przedrostek imienia i nazwiska osoby oraz pola Przyrostek. Nie są dodawane spacje, więc należy uwzględnić je w polach Przyrostek i Przedrostek.

  Jeżeli tekst alarmu zostanie zmieniony, lista wyboru urodzin zostanie odświeżona.

- W tabeli Wybierz urodziny należy wybrać osoby, dla których użytkownik chce ustawić alarm. Uwaga: lista wyświetla tylko te wpisy w programie&kaddressbook;, które zawierają datę urodzin i dla których nie został wcześniej zdefiniowany alarm o treści wprowadzonej w sekcji Tekst alarmu.

- Pozostałe ustawienia są takie same jak dla alarmów Tekstowych w oknie edycji alarmu.

Jeżeli ustawiono kalendarz alarmu, alarmy zostaną dodane do aktywnego kalendarza. Jeżeli w oknie konfiguracji ustawiono konieczność decyzji użytkownika, to pojawi się pytanie jakiego kalendarza użyć do zapisania importowanych alarmów.

#### Cofnij/przywróć

Można cofać i przywracać ostanie zmiany dokonane w bieżącej sesji programu &kalarm;. Większość działań może zostać wycofana, włączając w to: tworzenie, edycję i usuwanie alarmu i szablonów alarmu, oraz ponowną aktywację alarmów. Aby zapobiec nadmiernemu zużyciu zasobów, historia poleceń, które można wycofać jest ograniczona do ostatnich 12 działań.

Aby wycofać ostatnią zmianę, należy wybrać Edycja Cofnij. Aby przywrócić ostatnio wycofaną zmianę, należy wybrać Edycja Przywróć .

Aby wycofać zmianę inną niż ostatnia, należy kliknąć przycisk Cofnij na pasku narzędzi i przytrzymać klawisz myszki. Wyświetli się lista działań, z których można wybrać działanie, które użytkownik chce wycofać. Jeżeli działanie nie jest widoczne na liście, konieczne może być wcześniejsze wycofanie ostatnich zmian, od których poszukiwana zmiana jest uzależniona. Na przykład, jeżeli użytkownik zmienił alarm, a następnie go skasował, to nie można wycofać operacji edycji alarmu, jeżeli wcześniej nie wycofa się operacji jego usunięcia

Przywracania zmian innych niż ostatnia, odbywa się analogicznie za pomocą przycisku Przywróć na pasku narzędzi.

### Okno edycji alarmu

Okno edycji alarmu umożliwia oglądanie i zmianę alarmu. Przy pierwszym użyciu programu &kalarm;, wyświetla się uproszczona forma okna, z niewielką liczbą opcji. Aby zobaczyć wszystkie dostępne opcje należy kliknąć przycisk Więcej opcji; aby powrócić do okna uproszczonego, należy kliknąć przyciskMniej opcji. Program &kalarm; zapamiętuje wybór użytkownika przy każdym kolejnym wyświetleniu okna edycji alarmu.

Zrzut ekranu uproszczonego okna edycji alarmu
Zrzut ekranu uproszczonego okna edycji alarmu

Zrzut ekranu uproszczonego okna edycji alarmu

Zrzut ekranu okna edycji alarmu z pełną listą opcji
Zrzut ekranu okna edycji alarmu z pełną listą opcji

Zrzut ekranu okna edycji alarmu z pełną listą opcji

#### Działanie alarmu

Ustawienia w sekcji Działanie są zróżnicowane w zależności od edytowanego rodzaju alarmu.

##### Wyświetlaj alarmy

Alarmy wyświetlane pokazują okno po aktywacji alarmu. Sposób generowania zawartości okna alarmu odbywa się za pomocą listy rozwijanej: Typ wyświetlania, znajdującej się w górnej części okna:

- Wiadomość tekstowa pozwala na wprowadzenie treści wiadomości (która może zawierać wiele linii) w oknie edycyjnym.

- Zawartość pliku umożliwia wprowadzenie ścieżki lub adresu &URL; pliku tekstowego lub obrazka, którego zawartość ma być wyświetlona jako wiadomość alarmu. Przycisk obok pola adresu pliku otwiera okno wyboru pliku. Opcja Przeczytaj nie jest dostępna dla tego rodzaju alarmu.

- Wynik polecenia pozwala na wyświetlania alarmu, którego treść będzie wynikiem polecenia uruchomionego po aktywacji alarmu. Więcej na temat wprowadzania poleceń i skryptów wykonywalnych można znaleźć w sekcji Alarmy w postaci poleceń poniżej.

Ustawienia dostępne dla wyświetlania alarmów są następujące:

- Opcja Dźwięk pozwala na włączenie odtwarzania dźwięku przy wyświetlaniu wiadomości alarmu. Możliwe do wyboru są opcje:

  - Żaden wyświetla alarm po cichu.

  - Bip odtworzy krótki dźwięk.

  - Powiedz wiadomość alarmu zostanie przeczytana i wyświetlona.Opcja jest dostępna tylko wtedy gdy zainstalowany jest program KTTSD (z pakietu kdeaccessibility) oraz skonfigurowany został zgodny z nim syntezator mowy, &eg; Festival.

  - Plik dźwiękowy odtworzy plik dźwiękowy. Korzystając z przycisku po prawej stronie można wyświetlić okno dialogowe wyboru pliku oraz ustawienia głośności i powtarzania odtwarzania. Przesuwając myszkę nad przyciskiem wyboru, pojawi się podpowiedź wyświetlająca aktualnie skonfigurowaną nazwę pliku dźwiękowego.

    W oknie dialogowym pliku dźwiękowego:

    - Należy wprowadzić ścieżkę dostępu do pliku dźwiękowego, lub skorzystać z przycisku obok pola aby wyświetlić okno wyboru pliku. Można posłuchać wybranego pliku naciskając przycisk odtwarzania po lewej stronie pola edycyjnego. Po naciśnięciu przycisku odtwarzania zmieni się jego funkcja, ponowne jego naciśnięcie zatrzyma odtwarzanie jeżeli użytkownik już ma dość słuchania.

    - Wybranie opcji Powtarzaj spowoduje powtarzanie odtwarzania dźwięku tak długo, dopóki wiadomość alarmu jest wyświetlana. (Okno wiadomości alarmu ma przycisk zatrzymujący odtwarzanie, tak aby użytkownik mógł wyłączyć dźwięk nie usuwając okna z alarmem).

    - Suwak Ustaw głośność pozwala na ustawienie głośności odtwarzania wybranego pliku dźwiękowego.

    - Użytkownik może w razie potrzeby włączyć zanikanie głośności. Zanikanie oznacza iż plik dźwiękowy zaczyna grać na początkowym poziomie głośności, a następnie ten poziom stopniowo zmienia się do osiągnięcia pożądanego poziomu głośności w określonym przedziale czasu. Końcowy poziom głośności ustala się suwakiem Ustaw głośność. Aby włączyć zanikanie należy wybrać opcję zanikanie, podać czas zanikania w sekundach w polu Czas zanikania oraz ustawić suwakiemgłośność początkową.

    Można skorzystać z przycisku Testuj dźwięk aby sprawdzić ustawienia głośności.

- Za pomocą przycisku Czcionka i kolor można zmieniać czcionkę, kolor czcionki i kolor tła dla wiadomości alarmu. Zaznaczenie opcji Użyj domyślnej czcionki w oknie Wybierz czcionkę i kolor alarmu wyświetli wiadomość w kolorze zdefiniowanym jako domyślny w momencie jej wyświetlania. Aby wybrać własny kolor dla wyświetlanej wiadomości, należy wyłączyć opcję Użyj domyślnej czcionki. (Domyślne czcionki i kolory mogą być ustawionew oknie konfiguracji.)

  Wybrane kolory są pokazywane w oknie wprowadzania wiadomości alarmu.

- Przycisk Działania specjalne... służą do zdefiniowania działań powłoki do wykonania przed wyświetleniem alarmu. W oknie Specjalne działania alarmu dostępne są opcje:

  - W polu Działanie przed alarmem należy wprowadzić polecenie powłoki, które ma być wykonane przez wyświetleniem alarmu. Uwaga: &kalarm; będzie oczekiwał na zakończenie polecenia przed wyświetleniem alarmu.

    Działanie przed alarmem jest wykonywane raz, gdy alarm jest wyświetlany po raz pierwszy, włączając w to sytuację, gdy wiadomość przypomnienia jest zastępowana przez właściwy alarm. Polecenie nie jest wykonywane w następujących sytuacjach:

    - Gdy wyświetla się wiadomość przypomnienia.

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

    - Gdy wiadomość powinna być wyświetlana w czasie gdy użytkownik był wylogowany i jest przywracana po zalogowaniu.

    - Jeżeli powtarzający się alarm zostanie aktywowany w czasie gdy wiadomość alarmu (lub odłożona wiadomość alarmu) z jego poprzedniego wystąpienia jest dalej widoczna; innymi słowy, gdy poprzednie wystąpienie alarmu nie zostało zatwierdzone.

  - W polu Działanie po alarmie należy wprowadzić polecenie powłoki do wykonania wtedy, gdy alarm jest zatwierdzony (za pomocą przycisku Zamknij lub ikony zamknij na pasku tytułowym okna). Polecenie nie jest wykonywane w żadnym z następujących przypadków:

    - Gdy wiadomość przypomnienia została zamknięta.

    - Gdy użytkownik odroczy alarm, z wyjątkiem sytuacji gdy odroczony alarm jest potwierdzony przez użytkownika.

    - Gdy wiadomość alarm została zamknięta po wylogowaniu.

  Zobacz informacje o działaniu poleceń powłoki w sekcji Alarmy w postaci poleceń poniżej.

##### Alarmy w postaci poleceń

Alarmy w postaci poleceń uruchamiają polecenie bez wyświetlania żadnej wiadomości alarmu.

Te rodzaj alarmu nie jest dostępny, gdy środowisko &kde; pracuje w trybie kiosku.

Ustawienia dla alarmów w postaci poleceń są następujące:

- Opcja Wprowadź skrypt pozwala wybrać pomiędzy wprowadzaniem skryptu lub wiersza polecenia.

  Jeżeli opcja nie jest zaznaczona, to można wprowadzić polecenia dla powłoki. Jest ono przekazywane do domyślnej powłoki (określonej w zmiennej środowiskowej: `SHELL`), można dodać do polecenia dowolne opcje, parametry, polecenia potokowe, &etc;, które są dopuszczane przez powłokę dla poleceń.

  Jeżeli opcja jest zaznaczona, użytkownik może wprowadzić skrypt do wykonania. Należy pamiętać aby skrypt rozpoczynał się od linii w postaci np. `#!/bin/bash` aby uruchomiony został prawidłowy interpreter poleceń.

- W sekcji Wynik polecenia można ustalić co program ma zrobić z informacjami wyjściowymi produkowanymi w terminalu przez program po uruchomieniu.

  - Opcja Wykonaj w oknie terminala spowoduje wykonanie polecenia w oknie terminala. Rodzaj okna terminala może być zdefiniowany w oknie konfiguracji.

  - Opcja Zapisz do pliku zapisuje wyjście polecenia do pliku. to save the command's output in a file. Wyjście polecenia, poprzedzone nagłówkiem zawierającym datę i czas, w którym polecenie było zdefiniowane do uruchomienia, będzie dopisane do poprzedniej zawartości pliku. Można wprowadzić nazwę pliku w polu lub użyć przycisku obok do wyświetlenia okna wyboru pliku.

  - Zaznaczenie opcji Odrzuć, wyrzuca wynik polecenia.

##### Alarmy w postaci e-maili

Alarmy w postaci e-mail wysyłają wiadomość bez wyświetlania żadnego komunikatu.

W trzech polach należy wprowadzić adresy odbiorców, temat wiadomości email i jej treść. Przycisk obok pola edycji adresu wyświetli książkę adresową &kde; z której można wybrać adresy mailowe odbiorców. Załączniki mogą być dodawane za pomocą przycisku Dodaj.... Uwaga, należy pamiętać aby załączanie pliki były dostępne na dysku w momencie wywołania alarmu; kopia tych plików nie jest tworzona w momencie definiowania alarmu. Aby usunąć załącznik, należy wybrać listę rozwijaną i nacisnąć przycisk Usuń.

Dostępne są następujące ustawienia:

- Lista rozwijana Od pozwala na wybranie tożsamości programu &kmail;, która ma zostać wykorzystana do wysyłania wiadomości. Opcja jest dostępna tylko wtedy, gdy w oknie konfiguracji została włączona opcja Użyj tożsamości &kmail-dopelniacz;. W innej sytuacji, użyty zostanie adres użytkownika zdefiniowany w oknie konfiguracji.

- Zaznaczenie opcji Kopiuj e-mail do siebie spowoduje wysłanie wiadomości email bcc na adres użytkownika po aktywacji alarmu. Adres email, na który ma być wysłana kopia wiadomości może zostać ustawiony w Oknie konfiguracji, wartością domyślną jest adres użytkownika zdefiniowany w ustawieniach systemowych &kde;.

#### Odroczenie

Jeżeli alarm ma ustawione powtarzanie i został odroczony przy ostatnim wyświetleniu, to w sekcji Odroczony alarm widoczny będzie czas, do którego alarm został odroczony. Przycisk Zmień... wyświetli okno dialogowe, w którym można zmienić czas odroczenia alarmu lub anulować odroczenie.

#### Czas

W sekcji Czas można wybrać:

- Dnia/Czas i wprowadzić datę i czas wyświetlenia alarmu. Zaznaczenia opcji Kiedykolwiek pozwala na określenie tylko daty alarmu. W takim przypadku alarm zostanie wyświetlony przy najbliżej okazji o ustalonej dacie (lub po niej). Godzina wyświetlenia alarmu zależy od wartości ustawianej w oknie konfiguracji. (W części Konfiguracja &kalarm-dopelniacz; opisano jak ustalić godzinę początku dnia dla alarmów bez podanego czasu.)

  Dla alarmów bez określonego powtarzania, data i czas muszą dotyczyć przyszłości. Jeżeli podano tylko datę, to musi ona odnosić się do dnia bieżącego lub kolejnych. Dla alarmów z określonym powtarzaniem nie ma tego typu ograniczeń, gdyż data i godzina alarmu będzie automatycznie zmieniona na termin pierwszego powtórzenia.

- Czas od teraz i wprowadzić kiedy licząc od chwili obecnej (w godzinach i minutach) ma zostać aktywowany alarm.

W razie potrzeby, można dla wyświetlanego alarmu ustawić strefę czasową. To ustawienie jest wykorzystywane dla wszystkich dat i czasów ustawionych dla alarmu, włączając w to powtórzenia i wyjątki. W normalnej sytuacji bez ważnego powodu, raczej nie należy zmieniać ustawień strefy czasowej.

Opcje ustawień dla stref czasowych są wyświetlane tylko wtedy, jeżeli wybrana strefa czasowa jest inna od ustawionej w oknie konfiguracji, lub po naciśnięciu przycisku Strefa czasowa.

- W liście rozwijanej, dokonuje się wyboru strefy czasowej, dotyczącej wywołania alarmu. Przy tworzeniu nowego alarmu, przyjmowana jest strefa czasowa ustawiona w oknie konfiguracji, którą jest zwykle strefa czasowa używanego komputera (chyba że użytkownik ją zmienił).

- Aby włączyć działanie programu wg. lokalnego zegara (komputera, na którym w danej chwili działa program &kalarm;) niezależnie od strefy czasowej,należy zaznaczyć opcję Ignoruj strefę czasową.

  Nie jest polecane używanie tej opcji kiedy alarm ma być powtarzany w określonych godzinach/minutach. Jeśli tak bowiem postąpisz, alarm może być wywołany w nieokreślonych momentach po zmianie czasu z zimowego na letni i odwrotnie.

#### Przypomnienie

Dla alarmów wyświetlanych, można włączyć Przypomnienie wyświetlające okno przypominające wcześniej o każdym wystąpieniu powtórzenia głównego alarmu (jeżeli się powtarza). W polu obok opcji przypomnienia należy podać ile minut wcześniej przed alarmem ma wyświetlić się przypomnienie.

Przypomnienia nie są wyświetlane dla pod-powtórzeń w ramach danego powtórzenia. Są one wyświetlane tylko przez wystąpieniem głównego powtórzenia alarmu.

Jeżeli alarm ma włączone powtarzanie, można włączyć opcję Przypomnij tylko przy pierwszym powtórzeniu. Jeżeli opcja nie jest włączona, to okres, na który można zdefiniować przypomnienie jest ograniczony odstępem czasowym między powtórzeniami.

#### Anulowanie

Opcje anulowania opóźnionych alarmów określają w jaki sposób alarm będzie traktowany jeżeli minie czas dla niego zdefiniowany:

- Opcja Anuluj gdy opóźniony określa co dzieje się z alarmem, który nie mógł być aktywowany w ustalonym dla niego czasie.

  Zaznaczenie tej opcji spowoduje anulowanie alarmu, który nie mógł być wyświetlony przez określony czas po ustawionym terminie aktywacji. Okres ten jest ustawiony za pomocą pola, które pojawi się po zaznaczeniu opcji. Jeżeli na przykład ustawiona zostanie wartość na 1 godzinę, alarm będzie pokazywany przy najbliższej okazji po ustawionym terminie aktywacji, ale tylko przez 1 godzinę po tym terminie. Jeżeli nie będzie mógł być w ciągu tej godziny aktywowany, to zostaje anulowany bez wyświetlania.

  Opóźnienie dla alarmów, dla których ustawiona jest tylko data (tzn. tych dla których zaznaczono opcjęKiedykolwiek, obliczane jest od godziny początku dnia, dla którego ustawiono alarm.

  Pozostawienie opcji nie zaznaczonej, spowoduje wywołanie alarmu w najbliższej nadarzającej się sposobności po ustawionym terminie, niezależnie od tego jak późno już jest.

  Alarm może być aktywowany tylko wtedy gdy użytkownik jest zalogowany, oraz gdy uruchomiony jest menedżer okien X oraz program &kalarm;.

- Zaznaczenie opcji Automatycznie zamknij okno po tym czasie spowoduje, iż okno alarmu będzie automatycznie zamykane (jeżeli jest jeszcze widoczne) po wygaśnięciu czasu zdefiniowanego dla anulowania opóźnionego alarmu.

#### Powtarzanie

W zakładce Powtarzanie możne określić czy i w jaki sposób alarm powinien być powtarzany.

Podstawowe informacje o powtarzaniu alarmu, wyświetlane są dla wygody w tytule zakładki Powtarzanie. Jako pierwszy widoczny jest okres powtarzania, a następnie okres pod-powtórzenia ustawianego po naciśnięciu przycisku Pod-powtórzenie.

W sekcji Reguła powtarzania można ustawić zasady i czas powtarzania alarmu:

- Aby alarm był uruchamiany tylko raz, należy wybrać opcję Bez powtarzania.

- Wybranie opcji Po zalogowaniu spowoduje wyświetlenie alarmu po każdym zalogowaniu użytkownika, aż do czasu kiedy minie ustawiony okres powtarzania. W terminie ostatniego powtórzenia, alarm zostanie aktywowany ostatni raz. (Uwaga: alarmy powtarzające się po zalogowaniu będą aktywowane także po każdym restarcie &kalarm-dopelniacz;.)

- Aby zdefiniować alarm powtarzający się w regularnych odstępach czasu, należy wybrać pożądany rodzaj odstępu i wprowadzić w polu Powtarzaj co wpisać ile okresów musi minąć pomiędzy powtórzeniami. Na przykład aby ustawić alarm wyświetlający się co dwa tygodnie, należy zaznaczyć opcję Codzienny i wprowadzić w polu wartość 14 lub Cotygodniowy i wpisać wartość 2. W zależność od rodzaju okresu mogą być dostępne także inne opcje:

  - Dla powtórzeń cotygodniowych, należy zaznaczyć dni tygodnia, w których alarm ma być aktywowany.

  - Dla powtórzeń miesięcznych, można określić albo stałą datę albo pozycję względną w miesiącu(&eg; drugi czwartek miesiąca).

  - Dla powtórzeń rocznych, można wprowadzić określony dzień w miesiącu, lub pozycję w ramach miesiące (&eg; ostatnia niedziela maja). Należy zaznaczyć wszystkie miesiące w roku, dla których alarm ma być aktywowany.

    Jeżeli ustawiono roczne powtarzanie na dzień 29 lutego, można określić jak będzie traktowana ta data w latach nieprzestępnych poprzez wybranie odpowiedniej wartości opcji Alarm 29 lutego w lata nieprzestępne:

    - Brak: Alarm wyświetli się 29 lutego w latach przestępnych, ale nie wyświetli się w latach nieprzestępnych.

    - 28 Lut: Alarm wyświetli się 29 lutego w roku przestępnym, a 28 lutego w latach nieprzestępnych.

    - 1 Mar: Alarm wyświetli się 29 lutego w roku przestępnym, a 1 marca w latach nieprzestępnych.

  Aby ustawić codzienne powtarzanie tylko dla dni roboczych, trzeba skorzystać z powtarzania tygodniowego i zaznaczyć wszystkie dni robocze w tygodniu.

W sekcji Koniec powtarzania ustawia się ogólny okres powtarzania dla alarmu:

- Wybranie opcji Nie ma końca powoduje, iż alarm będzie powtarzany w nieskończoność.

- Opcja Koniec po pozwala na określenie całkowitej liczby wystąpień powtórzenia alarmu.

- OpcjaKoniec przy umożliwia wprowadzenie daty/czasu do której alarm będzie powtarzany. Parametr wykorzystuje tą samą strefę czasową, która używana jest dla czasu rozpoczęcia alarmu.

  Czas zakończenia powtarzania alarmu, określa kiedy wystąpi ostanie główne powtórzenie alarmu, nie ogranicza jednak pod-powtórzeń. Jeżeli zdefiniowane są pod-powtórzenia, będą one dalej aktywowane po ostatnim głównym wystąpieniu, niezależnie od daty/czasu.

Sekcja Wyjątki pozwala na wyłączenie pewnych dat/terminów z reguł powtarzania. Uwaga: opcje te nie są pokazywane w uproszczonej wersji okna edycji alarmu. Aby je zobaczyć należy kliknąć przycisk Więcej opcji.

- Lista wyjątków (wyłączonych dat i terminów) jest pokazana po lewej stronie. Aby dodać nowy wyjątek do listy, należy wprowadzić datę po prawej stronie i nacisnąć przycisk Dodaj. Aby zmienić wyjątek należy go wybrać na liście, i wpisać nową datę i nacisnąć przycisk Zmień. Aby usunąć wyjątek, należy go podświetlić na liście i nacisnąć Usuń.

- Można wyłączyć powtarzanie alarmu w dni świąteczne poprzez wybranie opcji Nie wliczaj świąt. Ta opcja nie zmienia ustawień powtarzania alarmu, blokuje tylko jego wyświetlanie w sytuacji gdyby miał się wyświetlić w dzień świąteczny. Ustawienie dni świątecznych zależnych od kraju i regionu odbywa się w oknie konfiguracji.

- Można spowodować aby alarm pokazywał się jedynie w godzinach pracy poprzez wybranie opcji Tylko podczas godzin pracy. Ta opcja nie zmienia ustawień powtarzania alarmu, blokuje tylko jego wyświetlanie w sytuacji gdyby miał się wyświetlić poza godzinami pracy. Ustawienie dni roboczych i godzin pracy odbywa się w oknie konfiguracji.

##### Pod-powtórzenie

Za pomocą przycisku Pod-powtórzenie można zdefiniować pod-powtórzenia w ramach danego powtórzenia. W takich przypadkach, zawsze gdy alarm ma zostać wyświetlony zgodnie z ustawieniami głównego powtórzenia, zamiast pojedynczej aktywacji, będzie włączany wielokrotnie zgodnie z ustawieniami pod-powtórzenia. Przykładowo aby ustawić alarm powtarzający się co godzinę między godziną 12 a 18 w każdy wtorek, należy zdefiniować cotygodniowe powtarzanie na wtorek na godzinę 12, i w oknie dialogowym pod-powtórzenia określić okres powtarzania na 1 godzinę i ustalić albo liczbę powtórzeń na 6 razyalbo czas trwania na 6 godzin.

W oknie pod-powtórzenia wyświetlanym po naciśnięciu przycisku Pod-powtórzenie, należy zaznaczyć opcję Powtarzaj co aby włączyć pod-powtórzenie, lub usunąć zaznaczenie w celu wyłączenia pod-powtarzania. Po zaznaczeniu opcji Powtarzaj co można określić następujące parametry pod-powtórzenia:

- Określić odstęp czasu pomiędzy powtórzeniami w poluPowtarzaj co. Obok pola wartości należy wybrać odpowiednią jednostkę czasu (&eg; dni) i wpisać liczbę jednostek.

- Określić ilość powtórzeń i czas trwania:

  - W polu Liczba powtórzeń można wprowadzić ile razy ma nastąpić powtórzenie alarmu po głównym jego wystąpieniu. Tak więc, przykładowo, aby alarm pojawił się 4 razy po każdym głównym wystąpieniu, tzn. 3 dodatkowe razy, to należy tutaj wprowadzić wartość 3.

  - W polu Czas trwania można wprowadzić całkowity czas trwania okresu, w którym alarm będzie powtarzany. Nie musi to być wartość odpowiadająca wielokrotności odstępu między powtórzeniami, będzie ona automatycznie zaokrąglona po naciśnięciu przycisku OK.

Aby uniknąć nakładania się pod-powtórzeń dla tego samego alarmu, czas trwania pod-powtórzeń jest ograniczona do najdłuższego odstępu pomiędzy głównymi wystąpieniami alarmu. Za każdym razem, gdy alarm wystąpi zgodnie z regułą ustaloną dla głównego powtórzenia, wszystkie aktywne pod-powtórzenia, które zostały uruchomione wraz z poprzednim jego wystąpieniem, zostaną automatycznie anulowane.

#### Inne ustawienia

Opcja alarmów wyświetlonych Potwierdzenie pozwala na włączenie zapytania o potwierdzenie, przy zamykaniu okna z wiadomością alarmu. Może to być wykorzystane jako zabezpieczenie przed przypadkowym zamknięciem okna i zatwierdzeniem alarmu.

Opcja Pokaż w &korganizer; dodaje alarm do aktywnego kalendarza w programie &korganizer;, gdzie jest widoczny jako zdarzenie bez alarmu. Pozwala to na zarządzanie zdarzeniami w programie &korganizer;, korzystając jednak z funkcjonalności programu &kalarm;.

Jeżeli później alarm zostanie zmodyfikowany lub usunięty w programie &kalarm;, odpowiadające mu zdarzenie w programie &korganizer; będzie także zmodyfikowane lub usunięte. Jednak zmiana zdarzenia w &korganizer;, nie spowoduje zmiany odpowiadającego mu alarmu w &kalarm;.

Naciśnięcie przycisku Wczytaj szablon pozwala na wybranie szablonu dla alarmu za pomocą okna opisanego w sekcji Tworzenie i modyfikacja alarmów.

Naciśnięcie przycisku Próbuj spowoduje sprawdzenie alarmu czy poprawnie się wyświetla. Okno wiadomości wyświetla się tak samo jakby alarm został aktywowany w normalny sposób.

Naciśnięcie OK po poprawnym wprowadzeniu wszystkich ustawień, dodaje alarm do listy zaplanowanych alarmów.

### Okno wiadomości alarmu

Gdy nadejdzie termin alarmu, wiadomość wyświetlana jest na wszystkich pulpitach środowiska &kde; i nie może być przykryta przez zwykłe okna, aby użytkownik jej nie przeoczył. Okno wiadomości zawiera czas, w którym alarm był zaplanowany, tak więc można sprawdzić kiedy wiadomość się wyświetliła, jeżeli użytkownika akurat nie było przed komputerem. Jeżeli ustawiona dla alarmu strefa czasowa jest inna od strefy ustawionej dla lokalnego komputera, to pokazana zostanie także strefa czasowa (Dla wiadomości przypominających wyświetla się data i czas zaplanowanego alarmu, a nie czas wyświetlenia wiadomości przypominającej, zaś w tytule okna widoczny jest tekst Przypomnienie.)

Okna alarmów są widoczne, aż do czasu ich zatwierdzenia przez użytkownika chyba że włączona została opcja Automatycznie zamknij okno po tym czasie w oknie edycji alarmu.W przypadku alarmów powtarzających się, jeżeli widoczna jest niezatwierdzona wiadomość z poprzedniego wystąpienia alarmu, to to samo okno wystąpienia wyskakuje na pulpit dla kolejnego wystąpienia. Pozwala to uniknąć zatwierdzania wielu kopii tej samej wiadomości, jeżeli użytkownik nie mógł tego zrobić w czasie ich wystąpienia.

Okno w którym wyświetla się komunikat alarmu, zawiera następujące polecenia dotyczące wyświetlonego alarmu:

- Zatwierdzenie alarmu jest możliwe za pomocą przycisku Zamknij.Spowoduje to zamknięcie okna z komunikatem (ewentualnie wyświetli się dodatkowe okno potwierdzeniew przypadku wybrania opcji Potwierdzenie w ustawieniach alarmu).

- Edycja parametrów alarmu. Po kliknięciu przycisku Edytuj... wyświetla się okno Edycji alarmu.

- Naciśnięcie przycisku Odrocz... wyświetla opcje służące do odkładania alarmu na późniejszy termin. W oknie tym należy wybrać Odrocz do daty/czasu aby wprowadzić datę i czas, w którym wiadomość ma zostać ponownie wyświetlona, lub opcję Odroczenie na dany odstęp czasu aby określić po jakim czasie licząc od chwili obecnej (w godzinach i minutach) wiadomość ma być ponownie wyświetlona. Po wybraniu jednej z opcji naciśnięcie przycisku OK spowoduje odroczenie wiadomości alarmu i zamkniecie okna.

  Czas, do którego alarm jest odraczany musi być wcześniejszy od jego kolejnego wystąpienia lub kolejnego przypomnienia. Z tego powodu przyciski Odrocz... w oknie wiadomości alarmu oraz OK w oknie odraczania, są wyłączane na jedną minutę przed wystąpieniem następnego alarmu lub przypomnienia.

  Przycisk Odrocz... nie jest wyświetlany dla alarmów wyświetlanych po zalogowaniu ponieważ opcja Powtarzaj po zalogowaniu została wybrana.

- Można wyłączyć odtwarzanie pliku dźwiękowego alarmu, poprzez naciśnięcie klawisza z ikona zatrzymaj odtwarzanie.

- Jeżeli wiadomość alarmu została wprowadzona poprzez przeciągnięcie wiadomości z programu &kmail;, można szybko otworzyć wiadomość klikając na ikonę &kmail-dopelniacz;. Spowoduje to wybranie i podświetlenie wiadomości w liście folderów &kmail-dopelniacz;.

  Jeżeli indeks wiadomości w programie &kmail; zostanie ponownie utworzony, spowoduje to utratę połączenia do wiadomości.

- Przycisk wyświetlający ikonę programu &kalarm; umożliwia wygodny dostęp do &kalarm-dopelniacz;.

W oknie Konfiguracji można wybrać jeden z dwóch trybów wyświetlania wiadomości alarmu:

- Jako zwykłe okno. W tym trybie, po wyświetleniu alarmu okno staje się aktywne i przejmuje obsługę klawiatury. Oznacza to, że jeżeli alarm wyświetli się w trakcie pisania tekstu (np. w edytorze) wciskane klawisze będą obsługiwane przez &kalarm; a nie wykorzystywaną w danym momencie aplikację.

- Jako okno nie modalne. W tym trybie, wyświetlenie alarmu, nie spowoduje przejęcie klawiatury i nie przeszkodzi w trakcie pisania. W tym trybie jednak, okno alarmu nie ma paska tytułowego i ramki, tak więc nie można go przesuwać ani zmieniać jego rozmiaru.

Gdy alarm jest wyświetlany w trakcie korzystania z aplikacji pełnoekranowej, zawsze wyświetla się w trybie nie modalnym niezależnie od ustawień. Spowodowane jest to ograniczeniami systemu obsługi okien.

#### Ustalanie pozycji okien wiadomości

W oknie Konfiguracji można wybrać jeden z dwu sposobów pozycjonowania okien wiadomości alarmu:

- Okna wyświetlane są tak daleko od aktualnej pozycji kursora, jak to jest możliwe. Ogranicza to możliwość przeszkodzenia w aktualnie wykonywanej pracy i ogranicza możliwość przypadkowego zatwierdzenia alarmu.

- Okna wyświetlane są w środku ekranu. Aby ograniczyć możliwość pomyłkowego zatwierdzenia alarmu, na początku przyciski są nieaktywne. Stają się aktywne po pewnym czasie, który można ustawić.

Jeżeli wyświetlanych jest wiele okien wiadomości alarmu lub komunikatów błędów, można je uporządkować na ekranie tak, aby wszystkie były widoczne, lub zgrupować je w górnym lewym rogu ekranu. Odbywa się to za pomocą opcji menu: Widok Spread Windows . W razie potrzeby można dla tej akcji ustawić globalny skrót klawiszowy.

### Tacka systemowa

Domyślnie &kalarm; wyświetla ikonę na tacce systemowej. Korzystają z ikony, można sterować programem. Służy też ona jako wskaźnik stanu pracy. Standardowa ikona &kalarm-dopelniacz; wskazuje, że alarmy są monitorowane, natomiast ikona w szarym kolorze wskazuje, że program jest nieaktywny.

Przesunięcie kursora myszy nad ikonę na tacce systemowej, wyświetli podsumowanie pierwszych kilku alarmów zaprogramowanych na najbliższe 24 godziny. Funkcja ta może zostać wyłączona. Można również ustawić jak dużo alarmów ma być wyświetlanych oraz w jaki sposób. Dokonuje się tego w oknie Konfiguracji.

Wciśnięcie Lewego przycisku myszy na ikonie na tacce systemowej, wyświetla i chowa główne okno programu &kalarm;.

Wciśnięcie prawego przycisku myszy na ikonie na tacce systemowej, wyświetla menu kontekstowe:

Włącz alarmy

  Włącza lub wyłącza monitorowanie alarmów.

  Więcej na ten temat w sekcji:Włączanie i wyłączanie alarmów.

Nowy alarm

  Pozwala na wybranie alarmu z listy, a następnie otwarcie okna edycji dla tworzonego alarmu.

Nowy alarm z szablonu

  Wyświetla listę szablonów alarmów. Po wybraniu jednej z pozycji, wyświetla się okno edycji alarmu, wypełnione wstępnymi ustawieniami pobranymi z szablonu.

Konfiguracja &kalarm;...

  Wyświetla okno konfiguracji &kalarm;.

  Okno konfiguracji opisane zostało w sekcji Konfiguracja &kalarm;. Zawiera ono opcje dotyczące zachowania ikony &kalarm-dopelniacz; na tacce systemowej.

Przywróć/Minimalizuj

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

Zakończ

  Zamyka program &kalarm; i ikonę na tacce systemowej.

  Zamyka program &kalarm; jeżeli nie ma wyświetlanych żadnych okien alarmów.

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

Aby wyświetlić program &kalarm; na tacce systemowej. Użytkownik musi mieć uruchomione środowisko &kde; lub odpowiedni inny menedżer okien.

Aby wyświetlić ikonę &kalarm; na tacce systemowej należy wybrać z menu Widok Pokaż w tacce systemowej .

Aby usunąć &kalarm; z tacki systemowej, należy usunąć zaznaczenie pozycji menu:Widok Pokaż w tacce systemowej.

Aby ustawić wyświetlanie lub nie &kalarm-dopelniacz; w tacce systemowej po uruchomieniu, należy skorzystać z sekcji Widok okna konfiguracji.

### Odświeżanie alarmów

Jeżeli z jakiegoś mało prawdopodobnego powodu, jakieś alarmy nie zostały aktywowane wtedy kiedy powinny, można odświeżyć listę alarmów i wywołać wszystkie pominięte alarmy za pomocą polecenia Działania Odśwież alarmy . Spowoduje to, iż &kalarm; przeładuje wszystkie kalendarze alarmów.

Możliwe jest przeładowywanie wybranych kalendarzy alarmów i odświeżanie ich alarmów, za pomocą kliknięcia prawym przyciskiem myszki na kalendarz a liście, i wybrania opcji Odśwież z menu kontekstowego. Więcej na ten temat w sekcji Kalendarze alarmów.

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

Wszystkie lub pojedyncze alarmy mogą być włączane lub wyłączane:

- Monitorowanie alarmów dotyczy wszystkich alarmów. Jeżeli opcja zostanie wyłączona, to nie będzie wywołany żaden alarm. Jeżeli alarmy są włączone (sytuacja normalna), wszystkie alarmy, które nie zostały wyłączone przez użytkownika będą wyświetlone w zaplanowanym czasie.

  Powtórne włączenie monitorowania alarmu, powoduje iż alarmy, które byłyby wyświetlone w czasie wyłączenia monitoringu, są teraz wyświetlany (z wyjątkiem alarmów. dla których określono zasadę anulowania po opóźnienia). Innymi słowo, wyłączenie monitorowania alarmów, ma takie samo działanie jak zamknięcie programu &kalarm; - alarmy są odkładane do czasu ponownego jego uruchomienia.

- Pojedyncze alarmy mogą być włączane lub wyłączane niezależnie od działania funkcji monitorowania alarmów. Tak więc stan włączenia lub wyłączenia pojedynczego alarmu nie będzie się zmieniał po włączeniu lub wyłączeniu monitorowania alarmów. Inaczej niż w przypadku monitorowania alarmów, które może być wyłączone z powodu nie uruchomienia programu &kalarm;, pojedyncze alarmy mogą być wyłączone jedynie za pomocą polecenia menu.

  Gdy pojedynczy alarm jest ponownie włączany, nie powoduje to jego wyświetlenia w przypadku gdyby w trakcie wyłączenia upłynął termin jego wywołania. Innymi słowy, wyłączenie pojedynczego alarmu usuwa wszelkie informacje o jego wystąpieniach, aż do czasu ponownego jego włączenia.

  Stan włączenia lub wyłączenia dla pojedynczego alarmu jest wskazywany za pomocą koloru na liście alarmów (kolor ten może zostać ustawiony w sekcji Widok okna konfiguracji).

Aby alarm mógł być wyświetlony, powinien być włączony alarm oraz funkcja monitorowania alarmów.

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

Aby działało monitorowanie alarmów, program &kalarm; musi być uruchomiony. Po pierwszym uruchomieniu &kalarm-dopelniacz; będzie on automatycznie się uruchamiał po każdym zalogowaniu, chyba że zostanie to wyłączone w sekcji Ogólne okna konfiguracji.

Jeżeli monitorowanie alarmów jest wyłączone, to aby je ponownie włączyć należy:

- Wybrać opcję Działania Włącz alarmy.

- Nacisnąć prawy przycisk myszy na ikonie programu w tacce systemowej i wybrać Włącz alarmy z menu kontekstowego.

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

Można tymczasowo wyłączyć monitorowanie alarmów, co spowoduje iż program &kalarm; nie będzie sprawdzał i wyświetlał alarmów, dopóki nie zostanie ono ponownie włączone, lub – zakładając że tak jest skonfigurowany – do ponownego zalogowania użytkownika.

- Wyłączyć zaznaczenie opcji w menu Działania Włącz alarmy.

- Nacisnąć prawy przycisk myszy na ikonie programu w tacce systemowej i usunąć zaznaczenie opcji Włącz alarmy w menu kontekstowym.

- Zatrzymać program &kalarm; zgodnie z opisem w sekcji Zakończenie pracy programu &kalarm;.

Alarmy mogą być całkowicie wyłączone poprzez wyłączenie opcji uruchamiania &kalarm-dopelniacz; po zalogowaniu, w sekcji Ogólne okna konfiguracji.

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

Aby włączyć pojedynczy wyłączony alarm, należy wykonać jedną z następujących operacji:

- Po wybraniu jednego lub większej liczby alarmów za pomocą kliknięcia pozycji na liście alarmów, należy wybrać opcję Działania Włącz .

- Należy nacisnąć Prawy przycisk na alarmie z listy i wybrać opcję Włącz z menu kontekstowego.

Aby wyłączyć pojedynczy włączony alarm, należy wykonać jedną z następujących operacji:

- Po wybraniu jednego lub większej liczby alarmów za pomocą kliknięcia pozycji na liście alarmów, należy wybrać opcję Działania Wyłącz .

- Należy nacisnąć Prawy przycisk na alarmie z listy i wybrać opcję Wyłącz z menu kontekstowego.

### Zakończenie pracy programu &kalarm;

Aby zakończyć działanie programu &kalarm; należy wybrać polecenie Plik Zakończ, lub Zakończ w menu kontekstowym ikony programu na tacce systemowej. W przypadku, gdy ikona na tacce systemowej nie jest widoczna, wystarczy zamknąć wszystkie widoczne okna &kalarm-dopelniacz;.

## Konfiguracja &kalarm;

Aby skonfigurować działanie programu &kalarm; do indywidualnych wymagań systemu i użytkownika, należy wybrać Ustawienia Konfiguruj &kalarm;.... Spowoduje to wyświetlenie okna konfiguracji programu.

### Ogólne

Sekcja Ogólne pozwala na ustawianie ogólnych parametrów zachowania programu &kalarm;:

- Uruchamiaj przy logowaniu: &kalarm; będzie uruchamiany automatycznie przy każdej sesji logowania do &kde;, aby zapewnić jego ciągłe działanie do momentu jego ręcznego wyłączenia przez użytkownika.

  Ta opcja powinna być zawsze zaznaczona, chyba że użytkownik rezygnuje z korzystania z &kalarm-dopelniacz;.

  Ta opcja jest automatycznie włączana przy każdym uruchomieniu &kalarm-dopelniacz;. Jeżeli opcja została wyłączona przez użytkownika, a następnie program został przez niego uruchomiony, to żeby uniemożliwić jego uruchamianie po zalogowaniu, trzeba za każdym razem wyłączać ją w oknie konfiguracji.

- Potwierdź zakończenie: Jeżeli alarmy są wyłączone w czasie, gdy &kalarm; nie jest uruchomiony, włączenie tej opcji spowoduje wyświetlenie pytania o potwierdzenie, jeżeli użytkownik będzie chciał zakończyć pracę z programem za pomocą polecenia Zakończ z menu kontekstowego ikony w tacce systemowej. Zapobiega to przypadkowemu wyłączeniu alarmów. Dla bezpieczeństwa, opcja jest automatycznie włączana po każdym uruchomieniu programu.

- Potwierdzenie usuwania alarmów: Włącza wyświetlanie potwierdzenia przy próbie usunięcia alarmu.

- Odroczenie na dany odstęp czasu: Pozwala wprowadzić domyślny odstęp czasu w godzinach i minutach, pokazywany w oknie dialogowym odraczania alarmów. Uwaga, jeżeli alarm był wcześniej odroczony, to okres wyświetlony w kolejnym oknie odroczenia będzie taki sam jaki został użyty przy poprzednim odroczeniu.

- Terminal dla alarmów w postaci poleceń: Pozwala na wybranie, jaki program obsługi terminala powinien być użyty do wyświetlania terminala dla alarmów w postaci poleceń. Wstępnie skonfigurowanych jest kilka najpowszechniejszych programów &eg; xterm, &konsole;, jednak wyświetlone zostaną tylko te, które są zainstalowane w systemie. Pełny kod wywołania programu terminala wraz z opcjami dodatkowymi, jest widoczny po wyświetleniu pomocy kontekstowej dla przycisku opcji.

  Jeżeli użytkownik chce użyć innego programu terminala, lub chce dodać swoje własne opcje do wywołania okna terminala, należy wybrać Inny i wpisać w polu polecenie służące do wywołania okna terminala. Domyślnie na końcu tego polecenia, będzie dopisane polecenie powłoki wpisane w definicji alarmu. Można też zadecydować o miejscu umieszczenia polecenia alarmu w wywołaniu terminala, poprzez użycie następujących kodów:

  %c

    Kod zastępuje polecenie shella zdefiniowane do wykonania w alarmie.

  %w

    Kod zastępuje polecenie shella zdefiniowane do wykonania w alarmie, z dołożoną opcją `sleep`

  %C

    Kod spowoduje utworzenie tymczasowego pliku wykonywalnego zawierającego polecenie shella zdefiniowane w alarmie, a następnie kod zostanie zastąpiony poleceniem uruchomienia tego pliku.

  %W

    Kod spowoduje utworzenie tymczasowego pliku wykonywalnego zawierającego polecenie shella zdefiniowane w alarmie uzupełnionego o opcję `sleep`, a następnie kod zostanie zastąpiony poleceniem uruchomienia tego pliku.

  Jeżeli alarm w postaci polecenia zostanie wywołany, tekst polecenia będzie zamknięty w cudzysłowach przed przekazaniem go to polecenia wywołania terminala.

### Czas i data

Sekcja Czas i data umożliwia ustawianie parametrów związanych z czasem i datą:

- Strefa czasowa: Pozwala na wybranie strefy czasowej. &kalarm; będzie ją wykorzystywał w trakcie działania, można ją jednak zmieniać dla wybranych pojedynczych alarmów.

- Ustawienia świąt: Umożliwia określenie kraju lub regionu, którego dni świąteczne będą uwzględniane w programie. Dotyczy to alarmów powtarzających się, dla których zaznaczono opcję wyjątku: Nie wliczaj świąt.

- Początek dnia dla alarmów bez podanego czasu: Ustawia godzinę rozpoczęcia dnia, używaną dla wywoływania alarmów, dla których ustalona została tylko data, tzn. tych dla których zaznaczono opcję: Kiedykolwiek. W dniu, na który został ustawiony alarm, będzie on wywołany w najbliższej nadarzającej się okazji poczynając od zdefiniowanej tutaj godziny początku dnia.

- Sekcja Godziny pracy: Te ustawienia pozwalają na określenie godzin pracy, wykorzystywanych przez opcję Tylko w godzinach pracy wybieraną dla alarmów powtarzanych w oknie edycji alarmu.

  - Należy zaznaczyć opcję przy każdym dniu roboczym.

  - Początek dnia: należy tu wprowadzić, godzinę o której zaczyna się praca w dniu roboczym.

  - Koniec dnia: należy tu wprowadzić, godzinę o której kończy się praca w dniu roboczym.

### Nośnik

Sekcja Nośnik pozwala ustawić opcje wykorzystywane do zapisywania i archiwizacji alarmów.

- Nowe alarmy i szablony: Pozwala określić, kalendarz w którym będą przechowywane nowe alarmy i szablony, w przypadku gdy wykorzystywanych jest wiele kalendarzy alarmów.

  - Przechowuj w domyślnym kalendarzu: Nowe alarmy i szablony alarmów, będą automatycznie dodawane do domyślnego kalendarza, bez pytania o potwierdzenie.

  - Zapytaj, w którym kalendarzu zapisać: Przy tworzeniu nowego alarmu lub szablonu alarmu, jeżeli istnieje więcej niż jeden kalendarz z możliwością zapisu, użytkownik zostanie zapytany, w którym kalendarzu ma zostać umieszczony nowy alarm. Uwaga, jeżeli alarm wygaśnie, to zawsze bez pytania będzie użyty domyślny kalendarz dla zarchiwizowanych alarmów.

- Sekcja Zarchiwizowane alarmy: Można tutaj skonfigurować parametry archiwizacji alarmów oraz wybrać domyślny kalendarz dla zarchiwizowanych alarmów.

  - Przechowuj nieaktualne alarmy: Wybranie tej opcji włącza funkcję przechowywania nieaktualnych i usuniętych alarmów. Wyłączenie opcji spowoduje że program nie będzie przechowywał żadnych informacji o alarmach po ich wystąpieniu. Uwaga, usuwane alarmy są archiwizowane tylko wtedy, gdy wcześniej zostały wyświetlone. Usunięcie alarmu, przed jego aktywacją, nie powoduje przeniesienia go do archiwum, informacje o nim są utracone.

  - Usuń zarchiwizowane alarmy po: Pozwala określić czas w dniach, przez jaki program ma przechowywać zarchiwizowane i usunięte alarmy. Po tym czasie są one bezpowrotnie usuwane.

  - Przycisk Wyczyść zarchiwizowane alarmy: Usuwa wszystkie aktualnie zarchiwizowane alarmy z domyślnego kalendarza (Inne niż domyślny kalendarze zarchiwizowanych alarmów nie są usuwane, gdyż mogą być współdzielone z innymi osobami.). Przycisk nie ma wpływu na alarmy, które dopiero staną się nieaktualne lub będą usuwane; dla takich alarmów archiwizacja będzie się dokonywać zgodnie z ustawieniami.

### Poczta

Sekcja Poczta pozwala ustawić parametry wysyłania i adresowania dla alarmów w postaci wiadomości alarm.

- Klient e-mail: Pozwala na wybranie programu obsługi poczty, używanego do wysyłania wiadomości alarmu:

  - KMail: Gdy alarm w postaci wiadomości się aktywuje, wiadomość jest wysyłana za pomocą programu &kmail; (uruchamianego w razie potrzeby) w następujący sposób:

    - Jeżeli zainstalowana jest wersja &kmail-dopelniacz; 1.7 lub wyższa, email jest wysyłany automatycznie.

    - Jeżeli wersja programu &kmail; jest starsza, to wiadomość jest dodawana do folderu `poczty wychodzącej` programu &kmail; gdzie oczekuje na późniejsze wysłanie.

  - Sendmail: Gdy alarm w postaci wiadomości się aktywuje, wiadomość jest wysyłana za pomocą programu &Sendmail;. Ta opcja zadziała, tylko w przypadku jeżeli w systemie skonfigurowany jest program &Sendmail; lub kompatybilny, jak np.: postfix lub qmail.

- Kopiuj wysłane wiadomości do folderu "wysłane" KMaila: Gdy ta opcja będzie zaznaczona to kopia wysłanej wiadomości zostanie zapamiętana w folderze `wysłane` programu &kmail;.

  Opcja ta jest niedostępna jeżeli został wybrany &kmail; jako klient poczty, gdyż &kmail; robi to automatycznie.

- Powiadom o kolejce zdalnych maili: Powoduje wyświetlenie powiadomienia za każdym razem, gdy alarm w postaci wiadomości email wprowadzi email do kolejki wiadomości do wysłania. Ta opcja może być pożyteczna, jeśli na przykład użytkownik korzysta z połączenia dial-up lub wiadomość zostanie umieszczona w folderze poczty `wychodzącej` programu &kmail;. Dzięki tej informacji, użytkownik może podjąć działania niezbędne do właściwego wysłania wiadomości.

- Można wybrać adres email używany jako adres nadawcy w wysyłanych wiadomościach e-mail.

  - Opcja Od umożliwia ręczne wpisanie adresu

  - Opcja Użyj adresu z /"Ustawień systemowych/" spowoduje użycie adresu określonego w ustawieniach systemowych środowiska &kde;.

  - Zaznaczenie Użyj tożsamości KMaila pozwala na wybranie w momencie tworzenia alarmu w postaci wiadomości email, tożsamości programu &kmail;, która ma zostać wykorzystana do wysłania emaila. Dla alarmów skonfigurowanych przez włączeniem tej opcji, użyta zostanie domyślna tożsamość ustawiona w programie &kmail;.

- Tutaj należy podać adres email wykorzystywany do wysyłania ukrytych kopii wiadomości alarmu, jeżeli zaznaczono opcję: Kopiuj wysłane wiadomości do folderu "wysłane" KMaila.

  - W polu UDW należy wprowadzić adres email. Jeżeli ukryte kopie mają być wysyłane do użytkownika na komputerze lokalnym, na którym działa &kalarm;. to wystarczy tu podać tylko nazwę użytkownika.

  - Opcja Użyj adresu z /"Ustawień systemowych/" spowoduje użycie adresu określonego w ustawieniach systemowych środowiska &kde;.

### Widok

Sekcja Widok pozwala na ustawienie niektórych elementów związanych z wyglądem programu &kalarm;. W zakładce Ogólne dostępne są opcje:

- Pokaż w tacce systemowej: Jeżeli zaznaczona, spowoduje wyświetlenie ikony programu &kalarm; na tacce systemowej. W tym trybie, zamknięcie programu poprzez ikonę na tacce systemowej zamyka główne okno &kalarm; i jeżeli nie ma wyświetlonych żadnych okien z wiadomościami, wychodzi z programu.

- Sekcja Podpowiedź na tacce systemowej: Te opcje pozwalają na ustawienie rodzaju informacji pokazywanych w podpowiedzi, gdy kursor myszki znajdzie się nad ikoną programu &kalarm; w tacce systemowej.

  - Pokaż alarmy w następnych 24 godzinach: Jeżeli zaznaczona, powoduje wyświetlenie podsumowania pierwszych kilku alarmów, dla których czas aktywacji mija w ciągu następnych 24 godzin.

  - Maksymalna liczba wyświetlanych alarmów: Wyłączenie tej opcji spowoduje wyświetlenie wszystkich alarmów zaplanowanych w ciągu następnych 24 godzin. Włączenie tej opcji pozwala na wpisanie liczby alarmów, które mają być wyświetlane.

  - Pokaż czas alarmu: Włącza wyświetlanie czasu, na który został zaplanowany alarm.

  - Pokaż czas do alarmu: Włączenie opcji wyświetla czas pozostały do aktywacji następnego wystąpienia alarmu. Czas jest pokazywany w godzinach i minutach.

    - Przedrostek: Określa symbol lub tekst dodawany na początku czasu pozostałego do aktywacji alarmu, aby odróżniał się on od czasu, na który alarm został zaplanowany.

- Sekcja Lista alarmów umożliwia wybranie kolorów wykorzystywanych w głównym oknie listy alarmów programu &kalarm; do wyświetlania wyłączonych i zarchiwizowanych alarmów.

Zakładka Okna alarmowe zawiera ustawienia sterujące wyglądem okien z wiadomościami alarmów.

- Umieść okna jak najdalej od kursora: Włączenie tej opcji wyświetla okna wiadomości alarmów tak daleko od aktualnej pozycji kursora myszki jak tylko jest to możliwe. Ogranicza to możliwość przypadkowego potwierdzenia alarmu poprzez naciśnięcie myszki w momencie pojawienia się okna.

- Wyśrodkuj okna, zablokuj chwilowo przyciski: Powoduje wyświetlenie wiadomości alarmu w środku ekranu. Aby ograniczyć możliwość przypadkowego potwierdzenia alarmu, przyciski w oknie są przez pewien czas wyłączone. Czas zablokowania przycisków ustawia się w polu Czas zablokowania przycisków (w sekundach).

- Okna wiadomości z paskiem tytułowym i przejmowaniem klawiatury: Ta opcja steruje modalnością okna wiadomości alarmu, tzn. czy spowodują one przejęcie klawiatury po wyświetleniu. Więcej na ten temat w sekcji Okno wiadomości alarmu.

### Edycja

W sekcji Modyfikuj można ustawić domyślne ustawienia edycji alarmu, wykorzystywane przez Okno edycji alarmu:

- Zakładka Ogólne zawiera opcje odnoszące się do wszystkich rodzajów alarmu.

  - Ustawienie domyślnych wartości opcjiPokaż w KOragnizer oraz Anuluj gdy opóźniony.

  - Ustawienie domyślnego typu powtarzania.

  - Ustawienie domyślnego traktowania lat nieprzestępnych dla powtórzeń alarmów zdefiniowanych na dzień 29 lutego.

- Zakładka Typy alarmówzawiera opcje odnoszące się do wybranych rodzajów alarmów.

  - Dla alarmów wyświetlanych:

    - Ustawienie domyślnych wartości opcji Automatycznie zamknij okno po czasie opóźnionego unieważnienia oraz Potwierdzenie.

    - Ustawienie domyślnej jednostki czasu dla przypomnienia.

    - Ustawienie domyślnych działań specjalnych dla akcji alarmów wyświetlanych.

    - Ustawienie domyślnych opcji dla dźwięku. Uwaga, domyślny plik dźwiękowy może być ustawiony, nawet jeżeli nie wybrano domyślnego rodzaju dźwięku w liście rozwijanej.

  - Dla alarmów w postaci poleceń:

    - Ustawienie domyślnych wartości opcji Wprowadź skrypt oraz Wykonaj w oknie terminala.

  - Dla alarmów w postaci wiadomości email:

    - Ustawienie domyślnej wartości opcji Kopiuj e-mail do siebie.

- Zakładka Czcionki i kolory pozwala na zdefiniowanie domyślnego wyglądu wiadomości alarmu. Można tu ustawić domyślną czcionkę, kolor tła i kolor tekstu.

## Wywołanie z wiersza poleceń

Jeżeli w momencie wywołania programu &kalarm; wprowadzono parametry do wiersza polecenia, nie wyświetli on okna listy alarmów opisywanego w sekcji Wykorzystanie &kalarm; powyżej. Parametry wiersza poleceń specyficzne dla &kalarm; mogą być wykorzystane do wykonywania następujących operacji:

- zdefiniowanie nowego alarmu

- ustawienia trybu wyświetlania &kalarm;

- uzyskanie pomocy

Dodatkowe funkcje dostępne z linii poleceń służą w pierwszej kolejności umożliwieniu innym programom komunikacji z programem &kalarm;. Są one opisane w Podręczniku programisty &kalarm;.

Opcje w wierszu poleceń mogą dotyczyć tylko jednej operacji w programie &kalarm; . Jeżeli użytkownik chce wykonać kilka operacji, to musi wywołać &kalarm; wielokrotnie z jednym zestawem opcji za każdym razem.

### Zdefiniowanie nowego alarmu

Następujące opcje wykorzystywane są do definiowania nowych alarmów:

Opcja | Opis
--- | ---
`-a`, `--ack-confirm` | Pyta o potwierdzenie po przeczytaniu wiadomości.
`-A`, `--attach URL` | Określa ścieżkę lub adres &URL; pliku, który ma być załączony do wiadomości email. Opcja ta może być w razie potrzeby kilka razy powtórzona. Opcja może być użyta tylko razem z opcją `--mail`.
`--auto-close` | Automatycznie zamyka okno alarmu po upłynięciu terminu określonego opcją `--late-cancel`. Może być stosowana tylko razem z opcją `--late-cancel`.
`-b`, `--beep` | Odtwarza krótkie bip przy wyświetlaniu alarmu. Nie można razem z tą opcją wykorzystywać opcji `--speak`, `--play` oraz `--play-repeat`.
`--bcc` | Ukryta kopia wiadomości do użytkownika. Może być stosowana tylko razem z opcją `--mail`.
`-c`, `--color`, `--colour kolor` | Określa kolor tła dla wiadomości alarmu za pomocą nazwy koloru zdefiniowanej w bibliotece &Qt; lub wartości szesnastkowej RGB: 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg kolor` | Określa kolor tekstu dla wiadomości alarmu za pomocą nazwy koloru zdefiniowanej w bibliotece &Qt; lub wartości szesnastkowej RGB: 0xRRGGBB.
`-d`, `--disable` | Wyłącza alarm. Nie będzie on aktywowany, aż do czasu jego ręcznego włączenia.

`-e`, `--exec polecenie`

Określa polecenie powłoki do wykonania. Może występować jedynie jako ostatni parametr wywołania &kalarm; w wierszu poleceń. Wszystkie następujące po nim parametry są interpretowane jako parametry polecenia powłoki do wykonania. Opcja nie może być stosowana razem z opcjami: `--file`, `--exec-display` oraz `--mail`.Parametry: `--ack-confirm`, `--beep`, `--color` oraz `--colorfg` są ignorowane.

`-E`, `--exec-display polecenie`

Określa polecenie powłoki do wykonania będące źródłem wiadomości alarmu. Może występować jedynie jako ostatni parametr wywołania &kalarm; w wierszu poleceń. Wszystkie następujące po nim parametry są interpretowane jako parametry polecenia powłoki do wykonania. Opcja nie może być stosowana razem z opcjami: `--file`, `--exec-display` oraz `--mail`.Parametry: `--ack-confirm`, `--beep`, `--color` oraz `--colorfg` są ignorowane.

`-f`, `--file URL` | Określa ścieżkę lub adres &URL; pliku tekstowego lub graficznego, którego zawartość ma się wyświetlić jako wiadomość alarmu. Opcja nie może być stosowana razem z parametrami: `--exec`, `--exec-display` oraz `--mail`. Nie może też być w wywołaniu żadnej wiadomości do wyświetlenia.
`-F`, `--from-id ID` | Wskazuje na określoną tożsamość programu &kmail; do użycia jako nadawcy wiadomości email. Może być stosowana tylko razem z opcją `--mail`.

`-i`, `--interval okres`

Określa odstęp pomiędzy powtórzeniami alarmu. Godziny i minuty podawane są w formacie nHnM, gdzie n oznacza liczbę, &eg; 3H30M. Inne odstępy są określane w formacie nX, gdzie n oznacza numer a X jedną z następujących liter:: Y (lata), M (miesiące), W (tygodnie), D (dni). Jeżeli jednocześnie podano parametr `--recurrence` to nie można stosować liter, Y (lata) oraz M (miesiące). Opcja jest wymagana w przypadku zastosowania parametrów:`--repeat` oraz `--until`.

`-k`, `--korganizer` | Wyświetla alarm jako zdarzenie w aktywnym kalendarzu &korganizer-dopelniacz;.
`-l`, `--late-cancel okres` | Anuluje alarm, jeżeli nie może być aktywowany w ciągu określonego okresu po zaplanowanym terminie. Parametr okres należy wprowadzić w takim samym formacie jak dla opcji`--reminder`. Domyślną wartością okresu jest jedna minuta.
`-L`, `--login` | Aktywuje alarm po każdym zalogowaniu. Opcja nie może być stosowana razem z parametrami: `--interval`, `--repeat` oraz `--until`.
`-m`, `--mail adres` | Wysyła wiadomość email na podany adres. Opcja może być użyta wielokrotnie w razie potrzeby. Opcja nie może być stosowana razem z opcjami: `--file`, `--exec-display` oraz `--mail`.Parametry: `--ack-confirm`, `--beep`, `--color` oraz `--colorfg` są ignorowane.
`-p`, `--play URL` | Określa ścieżkę lub adres &URL; pliku dźwiękowego, który ma być odtworzony jednokrotnie podczas wyświetlania wiadomości alarmu. Opcja nie może być stosowana razem z parametrami: `--play-repeat`, `--beep` oraz `--speak`.
`-P`, `--play-repeat URL` | Określa ścieżkę lub adres &URL; pliku dźwiękowego, który ma być odtwarzany wielokrotnie podczas wyświetlania wiadomości alarmy. Opcja nie może być stosowana jednocześnie z parametrami: `--play`, `--beep` oraz `--speak`.
`--recurrence specyfikacja` | Określa regułę powtarzania alarmu. Należy określić regułę używając składni iCalendar (opisanej w dokumencie RFC2445), &eg; FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. Opcja nie może występować razem z opcją `--until`.

`-r`, `--repeat liczba`

Określa liczbę powtórzeń alarmu, albo jeżeli powtórzenie jest zdefiniowane za pomocą `--recurrence`, liczbę powtórzeń przy każdym zadziałaniu opcji `--recurrence`(czyli podpowtórzenie w ramach powtórzenia). Jeżeli nie podano parametru `--recurrence` wpisanie wartości -1 powtarza alarm bez końca. Parametr wymaga jednoczesnego podania opcji `--interval`. Nie można go stosować razem z `--until`.

`-R`, `--reminder okres`

Powoduje wyświetlenie przypomnienia o alarmie w określonym czasie przed terminem aktywacji właściwego alarmu i każdego z jego powtórzeń (jeżeli są). Godziny i minuty należy wprowadzić w formacie:nHnM, gdzie n jest liczbą, &eg; 3H30M. Inne odstępy są określane w formacie nX, gdzie n oznacza numer a X jedną z następujących liter: W (tygodnie), D (dni). Opcja nie może być stosowana razem z parametrami `--exec`, `--mail` lub `--reminder-once`.

`--reminder-once okres` | Powoduje wyświetlenie jednokrotnego przypomnienia o alarmie w określonym czasie przed terminem aktywacji właściwego alarmu. Przypomnienie nie będzie wyświetlane przed powtórzeniami alarmu (jeżeli są). Opcja nie może być stosowana razem z parametrami: `--exec`, `--mail` lub `--reminder`.
`-s`, `--speak` | Przy tej opcji wiadomość alarmu zostanie przeczytana i wyświetlona.Opcja jest dostępna tylko wtedy gdy zainstalowany jest program KTTSD oraz skonfigurowany został zgodny z nim syntezator mowy. Razem z tą opcją nie można stosować opcji: `--beep`, `--play` oraz `--play-repeat`.
`-S`, `--subject temat` | Temat wiadomości email. Wymaga jednoczesnego wpisania opcji `--mail`.

`-t`, `--time date/time`

Aktywuje alarm o określonej dacie lub dacie/godzinie. Datę bez czasu należy podać w formacie yyyy-mm-dd [TZ], datę z czasem należy podać w formacie: [[[yyyy-]mm-]dd-]hh:mm [TZ] (jeżeli pola daty są pominięte, to przyjmowana jest wartość domyślna, tzn. bieżący dzień). Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej TZ odbywa się za pomocą nazwy strefy czasowej (&eg; `Europa/Londyn`), wartości `UTC` reprezentującej strefę czasową, lub tekstu `Clock` dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.

`-v`, `--volume procent` | Ustawia poziom głośności odtwarzania pliku dźwiękowego. Opcja ta może być wykorzystywana jedynie razem z opcjami: `--play` lub `--play-repeat`.

`-u`, `--until date/time`

Powtarza alarm do określonej daty lub daty/czasu. Wprowadzenie daty lub daty/czasu odbywa się w formacie takim jak dla opcji: `--time`. Uwaga, jeżeli podano parametr `--time`, to ustawienia strefy czasowej są pobierane z jego wartości, nie można wtedy podać strefy czasowej jako wartości parametru `--until`. Razem z tą opcją musi występować opcja: `--interval`. Opcje `--repeat` oraz `--recurrence` nie mogą występować razem z tą opcją.

wiadomość | Treść wiadomości do wyświetlenia, a w przypadku opcji `--mail` zawartość wiadomości email.

W każdym wywołaniu w wierszu polecenia treść wiadomości albo parametry `--file`, `--exec` lub `--exec-display` muszą być podane. Wszystkie pozostałe opcje są opcjonalne.

Dwa poniższe przykłady wyświetlają dwu-linijkową wiadomość na czerwonym tle o godzinie 10 po południu 27-go bieżącego miesiąca:

    % kalarm -c red -t 27-22:00 "Pamiętaj aby \nZATRZYMAĆ"
    % kalarm -c 0xFF0000 -t 27-22:00 "Pamięŧaj aby \nZATRZYMAĆ"

### Pozostałe parametry

Następujące opcje są wykorzystywane do wyświetlania okna edycji alarmu lub do ustawiania sposobu wyświetlania okna programu &kalarm;.

Opcja | Opis
--- | ---
`--edit ID` | Wyświetla okno edycji alarmu dla alarmu o określonym numerze ID zdarzenia.
`--edit-new-command` | Wyświetla okno edycji alarmu dla ustawienia parametrów nowego alarmu w postaci polecenia.
`--edit-new-display` | Wyświetla okno edycji alarmu dla ustawienia parametrów nowego alarmu wyświetlanego.
`--edit-new-email` | Wyświetla okno edycji alarmu dla ustawienia parametrów nowego alarmu w postaci wiadomości alarm.
`--edit-new-preset nazwaSzablonu` | Wyświetla okno edycji alarmu dla nowego alarmu i ładuje do niego ustawienia określone we wskazanym szablonie.
`--tray` | Wyświetla program &kalarm; jako ikonę na tacce systemowej.

### Opcje pomocy

Opisane poniżej opcje odnoszą się do wszystkich programów dla środowiska &kde;:

Opcja | Opis
--- | ---
`--help` | Wyświetla pomoc na temat opcji programu.
`--help-qt` | Wyświetla różne opcje związane z biblioteką &Qt;.
`--help-kde` | Wyświetla różne opcje związane z &kde;.
`--help-all` | Wyświetla wszystkie dostępne opcje.
`--author` | Pokazuje nazwiska i adresy email autorów &kalarm-dopelniacz;.
`-v`, `--version` | Wyświetla wersję biblioteki &Qt;, środowiska &kde; oraz programu &kalarm;.
`--license` | Podaje informacje na temat licencji.

## Podręcznik programisty &kalarm;

&kalarm; udostępnia interfejs pozwalający innym aplikacjom wykonanie następujących funkcji:

- zdefiniowanie nowego alarmu

- anulowanie zdefiniowanego alarmu

- wywołanie zdefiniowanego alarmu

- wyświetlenie okna edycji alarmu

Wszystkie powyższe funkcje są dostępne zarówno jako wywołania interfejsu D-Bus lub z linii poleceń. Wywołania D-Bus należy zdecydowanie preferować w przypadku, gdy &kalarm; jest już uruchomiony.

### Interfejs D-Bus

Wszystkie wywołania D-Bus opisane tutaj są zaimplementowane w ścieżce obiektu `/kalarm` dla interfejsu D-Bus. Interfejs jest zdefiniowany w plikach `org.kde.kalarm.kalarm.xml` oraz `kalarmiface.h`.

cancelEvent

#### cancelEvent

anuluje zdefiniowany alarm.

    void cancelEvent(const QString& eventID)

##### Parametry

`eventID`

  Określa unikalny numer ID zdarzenia, które ma zostać anulowane.

##### Opis

`cancelEvent()` to wywołania D-Bus anuluje określony alarm. Program &kalarm; usuwa alarm z kalendarza bez wyświetlenia go lub aktywowania.

triggerEvent

#### triggerEvent

wywołuje zdefiniowany alarm.

    void triggerEvent(const QString& eventID)

##### Parametry

`eventID`

  Określa unikalny numer ID zdarzenia, które ma zostać wywołane.

##### Opis

`triggerEvent()` jest wywołaniem D-Bus służącym do natychmiastowego wyświetlenia lub aktywacji określonego alarmu (niezależnie od zaplanowanego czasu). Program &kalarm; pobiera informacje o alarmie z kalendarza i aktywuje go.

Jeżeli dla alarmu minął termin wyświetlenia, &kalarm; usuwa wszystkie zaplanowane wystąpienia do chwili obecnej, a jeżeli dla alarmu nie ma żadnych kolejnych powtórzeń, to jest usuwany z kalendarza. Jeżeli termin wyświetlenia alarmu jeszcze nie upłynął, to żadne zmiany w zaplanowanych terminach nie są dokonywane.

scheduleMessage

#### scheduleMessage

definiuje nowy alarm wyświetlający wiadomość.

    bool scheduleMessage(const QString& wiadomość,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         const QString& recurrence,
                         int subRepeatInterval,
                         int subRepeatCount)

    bool scheduleMessage(const QString& wiadomość,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleMessage(const QString& wiadomość,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parametry

`wiadomość`

  Określa tekst wiadomości planowanego alarmu, a jeżeli parametr `flags` ma ustawiony bit `DISPLAY_COMMAND`, to definiowane jest tutaj polecenia powłoki generujące tekst wiadomości alarmu.

`startDateTime`

  Określa zaplanowaną datę lub datę i czas, w których alarm ma zostać wyświetlony. Dla alarmów zaplanowanych na dzień, wartość należy podać w formacie:YYYY-MM-DD [TZ] (format daty zwracany przez metodę `QDate::toString(Qt::ISODate)`). Dla alarmów zaplanowanych na dzień i godzinę, format powinien być następujący: YYYY-MM-DDTHH:MM[:SS] [TZ] (format daty zwracany przez metodę`QDateTime::toString(Qt::ISODate)`) lub HH:MM[:SS] [Clock] (format zwracany przez metodę: `QTime::toString(Qt::ISODate)`). Jeżeli nie podano daty, to przyjęta zostanie data aktualna. Uwaga, wartości określające sekundy są ignorowane.

  Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej TZ odbywa się za pomocą nazwy strefy czasowej (&eg; `Europa/Londyn`), wartości `UTC` reprezentującej strefę czasową, lub tekstu `Clock` dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.

`lateCancel`

  Powoduje anulowanie alarmu, jeżeli nie może być aktywowany przez określony w minutach czas po zaplanowanej aktywacji alarmu. Jeżeli wartość wynosi 0, alarm nie zostanie anulowany, niezależnie od tego jak późno mógł być aktywowany.

`flags`

  Definiuje logiczne OR dla wybranych bitów sterujących alarmu. Bity sterujące zdefiniowane są przez klasę `KAlarmIface` w pliku `kalarmiface.h`. Uwaga, nie wszystkie bity sterujące są adekwatne dla alarmów wyświetlanych.

`bgColor`

  Określa kolor tła dla wyświetlanej wiadomości. Format koloru powinien mieć postać: #RRGGBB (taki jak wartość zwracana przez metodę `QColor::name()`) gdzie RR, GG i BB są dwuznakowymi szesnastkowymi wartościami składowych czerwonej, zielonej i niebieskiej. Dodatkowo kolor może być określony w dowolnym innym formacie akceptowanym przez metodę `QColor::setNamedColor()`, jak na przykład nazwa koloru z bazy danych kolorów X (&eg; red or steelblue). Pusta wartość spowoduje użycie bieżącego koloru domyślnego.

`fgColor`

  Określa kolor tekstu dla wyświetlanej wiadomości alarmu. Format wartości jest taki sam jak dla parametru `bgColor`, możne też podać ciąg pusty, dla określenia domyślnego koloru tekstu.

`font`

  Określa czcionkę użytą do wyświetlenia wiadomości. Format tekst jest taki jak zwracany przez metodę `QFont::toString()`. Pusta wartość spowoduje użycie domyślnej w momencie wyświetlania czcionki dla wiadomości.

`audioURL`

  Określa plik dźwiękowy, który ma być odtworzony przy wyświetlaniu wiadomości alarmu. Podanie wartości pustej nie odtworzy żadnego dźwięku.

`reminderMins`

  Określa na ile minut przed wyświetleniem alarmu i każdego z jego powtórzeń (jeżeli są) ma się wyświetlać przypomnienie. Wartość 0 oznacza brak przypomnienia.

`recurrence`

  Definiuje powtarzanie alarmu z użyciem składni iCalendar zdefiniowanej w dokumencie: RFC2445. Na przykład: FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO definiuje 4 powtórzenia w odstępach 3 miesięcznych, w ostatni poniedziałek miesiące. Dla alarmów bez powtórzeń, należy tutaj podać pustą wartość.

`recurType`

  Określa rodzaj powtórzenia dla alarmu. Dostępne wartości są następujące:MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Są one zdefiniowane przez klasę `KAlarmIface` w pliku `kalarmiface.h`. Miesięczne powtarzanie odnosi się do dnia w ramach miesiąca, w coroczne dotyczy dnia w roku, gdzie dzień jest w obu przypadkach pobierany z parametru:`startDateTime`.

`recurInterval`

  Określa liczbę okresów (minut, dni, tygodni, miesięcy, lat zgodnie z parametrem`recurType`) pomiędzy powtórzeniami alarmu.

`recurCount`

  Określa ile razy alarm ma zostać powtórzony. Liczba -1 wskazuje iż alarm ma być powtarzany bez końca.

`endDateTime`

  Określa datę lub czas i datę zakończenia powtarzania alarmu. Jeżeli parametr`startDateTime` zawiera czas, to również w tym parametrze czas musi zostać podany. Jeżeli zaś `startDateTime` zawiera tylko datę, to i tutaj musi być tylko data. Nie należy tutaj podawać określenia strefy czasowej, do interpretacji parametru używana jest strefa czasowa podana w parametrze `startDateTime`.

`subRepeatInterval`

  Określa ilość minut pomiędzy pod-powtórzeniami alarmu. Wartość 0 oznacza brak pod-powtórzeń. Parametr jest ignorowany, jeżeli nie zdefiniowano powtórzeń dla alarmu.

`subRepeatCount`

  Określa liczbę pod-powtórzeń alarmu, uwzględniającą pierwsze powtórzenie.

##### Opis

`scheduleMessage()` jest to wywołanie D-Bus do zaplanowania alarmu w postaci wiadomości do wyświetlenia w określonej dacie i czasie. Wywołanie ma trzy postacie: Najbardziej ogólna postać pozwala na zdefiniowanie typowego powtarzania alarmu i jest także używana dla alarmów bez powtórzeń. Pozostałe formy pozwalają zdefiniować tylko określone typy alarmów z powtórzeniami, jedna dla określenia liczby powtórzeń i druga dla określania początku i końca powtórzeń.

Jeżeli zaplanowany czas alarmu (i wszystkich powtórzeń) minął, &kalarm; natychmiast wyświetli wiadomość (z wyjątkiem sytuacji gdy parametr `lateCancel` określa, iż na wyświetlenie alarmu jest już za późno. Wtedy &kalarm; ignoruje wywołanie). Jeżeli zaplanowany czas alarmu (lub jego powtórzenia) odnosi się do przyszłości, &kalarm; dodaje alarm do domyślnego aktywnego kalendarza alarmów, celem późniejszego jego wyświetlenia.

scheduleFile

#### scheduleFile

definiuje nowy alarm wyświetlający wiadomość lub zawartość pliku tekstowego lub graficznego.

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      const QString& recurrence,
                      int subRepeatInterval,
                      int subRepeatCount)

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      int recurType,
                      int recurInterval,
                      int recurCount)

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      int recurType,
                      int recurInterval,
                      const QString& endDateTime)

##### Parametry

`URL`

  Określa plik z tekstem lub obrazkiem, którego zawartość ma być wyświetlona jako wiadomość alarmu.

`startDateTime`

  Określa zaplanowaną datę lub datę i czas, w których alarm ma zostać wyświetlony. Dla alarmów zaplanowanych na dzień, wartość należy podać w formacie:YYYY-MM-DD [TZ] (format daty zwracany przez metodę `QDate::toString(Qt::ISODate)`). Dla alarmów zaplanowanych na dzień i godzinę, format powinien być następujący: YYYY-MM-DDTHH:MM[:SS] [TZ] (format daty zwracany przez metodę`QDateTime::toString(Qt::ISODate)`) lub HH:MM[:SS] [Clock] (format zwracany przez metodę: `QTime::toString(Qt::ISODate)`). Jeżeli nie podano daty, to przyjęta zostanie data aktualna. Uwaga, wartości określające sekundy są ignorowane.

  Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej TZ odbywa się za pomocą nazwy strefy czasowej (&eg; `Europa/Londyn`), wartości `UTC` reprezentującej strefę czasową, lub tekstu `Clock` dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.

`lateCancel`

  Powoduje anulowanie alarmu, jeżeli nie może być aktywowany przez określony w minutach czas po zaplanowanej aktywacji alarmu. Jeżeli wartość wynosi 0, alarm nie zostanie anulowany, niezależnie od tego jak późno mógł być aktywowany.

`flags`

  Definiuje logiczne OR dla wybranych bitów sterujących alarmów. Bity sterujące zdefiniowane są przez klasę `KAlarmIface` w pliku `kalarmiface.h`. Uwaga, nie wszystkie bity sterujące są adekwatne dla alarmów wyświetlanych.

`bgColor`

  Określa kolor tła dla wyświetlanej wiadomości Format koloru powinien mieć postać: #RRGGBB (taki jak wartość zwracana przez metodę `QColor::name()`) gdzie RR, GG i BB są dwuznakowymi szesnastkowymi wartościami składowych czerwonej, zielonej i niebieskiej. Dodatkowo kolor może być określony w dowolnym innym formacie akceptowanym przez metodę `QColor::setNamedColor()`, jak na przykład nazwa koloru z bazy danych kolorów X (&eg; red or steelblue). Pusta wartość spowoduje użycie bieżącego koloru domyślnego.

`audioURL`

  Określa plik dźwiękowy, który ma być odtworzony przy wyświetlaniu wiadomości alarmu. Podanie wartości pustej nie odtworzy żadnego dźwięku.

`reminderMins`

  Określa na ile minut przed wyświetleniem alarmu i każdego z jego powtórzeń (jeżeli są) ma się wyświetlać przypomnienie. Wartość 0 oznacza brak przypomnienia.

`recurrence`

  Definiuje powtarzanie alarmu z użyciem składni iCalendar zdefiniowanej w dokumencie: RFC2445. Na przykład: FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO definiuje 4 powtórzenia w odstępach 3 miesięcznych, w ostatni poniedziałek miesiące. Dla alarmów bez powtórzeń, należy tutaj podać pustą wartość.

`recurType`

  Określa rodzaj powtórzenia dla alarmu. Dostępne wartości są następujące:MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Są one zdefiniowane przez klasę `KAlarmIface` w pliku `kalarmiface.h`. Miesięczne powtarzanie odnosi się do dnia w ramach miesiąca, w coroczne dotyczy dnia w roku, gdzie dzień jest w obu przypadkach pobierany z parametru:`startDateTime`.

`recurInterval`

  Określa liczbę okresów (minut, dni, tygodni, miesięcy, lat zgodnie z parametrem`recurType`) pomiędzy powtórzeniami alarmu.

`recurCount`

  Określa ile razy alarm ma zostać powtórzony. Liczba -1 wskazuje iż alarm ma być powtarzany bez końca.

`endDateTime`

  Określa datę lub czas i datę zakończenia powtarzania alarmu. Jeżeli parametr`startDateTime` zawiera czas, to również w tym parametrze czas musi zostać podany. Jeżeli zaś `startDateTime` zawiera tylko datę, to i tutaj musi być tylko data. Nie należy tutaj podawać określenia strefy czasowej, do interpretacji parametru używana jest strefa czasowa podana w parametrze `startDateTime`.

`subRepeatInterval`

  Określa ilość minut pomiędzy pod-powtórzeniami alarmu. Wartość 0 oznacza brak pod-powtórzeń. Parametr jest ignorowany, jeżeli nie zdefiniowano powtórzeń dla alarmu.

`subRepeatCount`

  Określa liczbę pod-powtórzeń alarmu, uwzględniającą pierwsze powtórzenie.

##### Opis

`scheduleFile()` jest wywołaniem D-Bus powodującym zaplanowanie alarmu wyświetlającego zawartość pliku tekstowego lub graficznego. Z wyjątkiem parametrów pozwalających określić ścieżkę lub adres &URL; pliku, oraz parametrów dotyczących koloru i czcionki, pozostałe parametry są identyczne jak dla funkcji `scheduleMessage` - i w opisie tej funkcji, należy szukać dalszych szczegółów.

scheduleCommand

#### scheduleCommand

definiuje nowy alarm w postaci polecenia powłoki.

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& recurrence,
                         int subRepeatInterval,
                         int subRepeatCount)

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parametry

`commandLine`

  Określa polecenie powłoki, którego wykonanie jest planowane. Flagi `flags` określają czy parameter zawiera polecenie powłoki czy skrypt do wykonania.

`startDateTime`

  Określa zaplanowaną datę lub datę i czas, w których alarm ma zostać wyświetlony. Dla alarmów zaplanowanych na dzień, wartość należy podać w formacie:YYYY-MM-DD [TZ] (format daty zwracany przez metodę `QDate::toString(Qt::ISODate)`). Dla alarmów zaplanowanych na dzień i godzinę, format powinien być następujący: YYYY-MM-DDTHH:MM[:SS] [TZ] (format daty zwracany przez metodę`QDateTime::toString(Qt::ISODate)`) lub HH:MM[:SS] [Clock] (format zwracany przez metodę: `QTime::toString(Qt::ISODate)`). Jeżeli nie podano daty, to przyjęta zostanie data aktualna. Uwaga, wartości określające sekundy są ignorowane.

  Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej TZ odbywa się za pomocą nazwy strefy czasowej (&eg; `Europa/Londyn`), wartości `UTC` reprezentującej strefę czasową, lub tekstu `Clock` dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.

`lateCancel`

  Powoduje anulowanie alarmu, jeżeli nie może być aktywowany przez określony w minutach czas po zaplanowanej aktywacji alarmu. Jeżeli wartość wynosi 0, alarm nie zostanie anulowany, niezależnie od tego jak późno mógł być aktywowany.

`flags`

  Definiuje logiczne OR dla wybranych bitów sterujących alarmów. Bity sterujące zdefiniowane są przez klasę `KAlarmIface` w pliku `kalarmiface.h`. Uwaga, nie wszystkie bity sterujące są adekwatne dla alarmów w postaci poleceń.

`recurrence`

  Definiuje powtarzanie alarmu z użyciem składni iCalendar zdefiniowanej w dokumencie: RFC2445. Na przykład: FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO definiuje 4 powtórzenia w odstępach 3 miesięcznych, w ostatni poniedziałek miesiące. Dla alarmów bez powtórzeń, należy tutaj podać pustą wartość.

`recurType`

  Określa rodzaj powtórzenia dla alarmu. Dostępne wartości są następujące:MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Są one zdefiniowane przez klasę `KAlarmIface` w pliku `kalarmiface.h`. Miesięczne powtarzanie odnosi się do dnia w ramach miesiąca, w coroczne dotyczy dnia w roku, gdzie dzień jest w obu przypadkach pobierany z parametru:`startDateTime`.

`recurInterval`

  Określa liczbę okresów (minut, dni, tygodni, miesięcy, lat zgodnie z parametrem`recurType`) pomiędzy powtórzeniami alarmu.

`recurCount`

  Określa ile razy alarm ma zostać powtórzony. Liczba -1 wskazuje iż alarm ma być powtarzany bez końca.

`endDateTime`

  Określa datę lub czas i datę zakończenia powtarzania alarmu. Jeżeli parametr`startDateTime` zawiera czas, to również w tym parametrze czas musi zostać podany. Jeżeli zaś `startDateTime` zawiera tylko datę, to i tutaj musi być tylko data. Nie należy tutaj podawać określenia strefy czasowej, do interpretacji parametru używana jest strefa czasowa podana w parametrze `startDateTime`.

`subRepeatInterval`

  Określa ilość minut pomiędzy pod-powtórzeniami alarmu. Wartość 0 oznacza brak pod-powtórzeń. Parametr jest ignorowany, jeżeli nie zdefiniowano powtórzeń dla alarmu.

`subRepeatCount`

  Określa liczbę pod-powtórzeń alarmu, uwzględniającą pierwsze powtórzenie.

##### Opis

`scheduleCommand()` jest wywołaniem D-Bus do ustawienia określonego polecenia powłoki lub skryptu do wykonania w określonym czasie i dacie. Oprócz ustawień polecenia do wykonania, oraz pomijając parametry koloru, czcionki i pliku dźwiękowego, pozostałe parametry są takie same jak dla wywołania: `scheduleMessage` - i w opisie tej funkcji, należy szukać dalszych szczegółów.

scheduleEmail

#### scheduleEmail

definiuje nowy alarm w postaci emaila.

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       const QString& recurrence,
                       int subRepeatInterval,
                       int subRepeatCount)

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       int recurCount)

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       const QString& endTime)

##### Parametry

`fromID`

  Tożsamość programu &kmail;, która ma być użyta jako nadawca wiadomości email. Jeżeli pusta, użyty zostanie adres nadawcy ostawiony w oknie konfiguracji &kalarm; Ustawienia email.

`addresses`

  Oddzielana przecinkami lista adresów odbiorców wiadomości emai.

`subject`

  Temat wiadomości email.

`wiadomość`

  Treść wiadomości email.

`attachments`

  Rozdzielana przecinkami lista ścieżek lub &URL; do plików, które mają zostać wysłane jako załączniki.

`startDateTime`

  Określa zaplanowaną datę lub datę i czas, w których alarm ma zostać wyświetlony. Dla alarmów zaplanowanych na dzień, wartość należy podać w formacie:YYYY-MM-DD [TZ] (format daty zwracany przez metodę `QDate::toString(Qt::ISODate)`). Dla alarmów zaplanowanych na dzień i godzinę, format powinien być następujący: YYYY-MM-DDTHH:MM[:SS] [TZ] (format daty zwracany przez metodę`QDateTime::toString(Qt::ISODate)`) lub HH:MM[:SS] [Clock] (format zwracany przez metodę: `QTime::toString(Qt::ISODate)`). Jeżeli nie podano daty, to przyjęta zostanie data aktualna. Uwaga, wartości określające sekundy są ignorowane.

  Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej TZ odbywa się za pomocą nazwy strefy czasowej (&eg; `Europa/Londyn`), wartości `UTC` reprezentującej strefę czasową, lub tekstu `Clock` dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.

`lateCancel`

  Powoduje anulowanie alarmu, jeżeli nie może być aktywowany przez określony w minutach czas po zaplanowanej aktywacji alarmu. Jeżeli wartość wynosi 0, alarm nie zostanie anulowany, niezależnie od tego jak późno mógł być aktywowany.

`flags`

  Definiuje logiczne OR dla wybranych bitów sterujących alarmów. Bity sterujące zdefiniowane są przez klasę `KAlarmIface` w pliku `kalarmiface.h`. Uwaga, nie wszystkie bity sterujące są adekwatne dla alarmów w postaci wiadomości email.

`recurrence`

  Definiuje powtarzanie alarmu z użyciem składni iCalendar zdefiniowanej w dokumencie: RFC2445. Na przykład: FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO definiuje 4 powtórzenia w odstępach 3 miesięcznych, w ostatni poniedziałek miesiące. Dla alarmów bez powtórzeń, należy tutaj podać pustą wartość.

`recurType`

  Określa rodzaj powtórzenia dla alarmu. Dostępne wartości są następujące:MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Są one zdefiniowane przez klasę `KAlarmIface` w pliku `kalarmiface.h`. Miesięczne powtarzanie odnosi się do dnia w ramach miesiąca, w coroczne dotyczy dnia w roku, gdzie dzień jest w obu przypadkach pobierany z parametru:`startDateTime`.

`recurInterval`

  Określa liczbę okresów (minut, dni, tygodni, miesięcy, lat zgodnie z parametrem`recurType`) pomiędzy powtórzeniami alarmu.

`recurCount`

  Określa ile razy alarm ma zostać powtórzony. Liczba -1 wskazuje iż alarm ma być powtarzany bez końca.

`endDateTime`

  Określa datę lub czas i datę zakończenia powtarzania alarmu. Jeżeli parametr`startDateTime` zawiera czas, to również w tym parametrze czas musi zostać podany. Jeżeli zaś `startDateTime` zawiera tylko datę, to i tutaj musi być tylko data. Nie należy tutaj podawać określenia strefy czasowej, do interpretacji parametru używana jest strefa czasowa podana w parametrze `startDateTime`.

`subRepeatInterval`

  Określa ilość minut pomiędzy pod-powtórzeniami alarmu. Wartość 0 oznacza brak pod-powtórzeń. Parametr jest ignorowany, jeżeli nie zdefiniowano powtórzeń dla alarmu.

`subRepeatCount`

  Określa liczbę pod-powtórzeń alarmu, uwzględniającą pierwsze powtórzenie.

##### Opis

`scheduleEmail()` jest wywołaniem D-Bus pozwalającym na zaplanowanie alarmu w postaci wiadomości email wysłanej w określonej dacie i czasie. Oprócz ustawień nagłówka wiadomości i treści, oraz pomijając parametry koloru, czcionki i pliku dźwiękowego, pozostałe parametry są takie same jak dla wywołania: `scheduleMessage` - i w opisie tej funkcji, należy szukać dalszych szczegółów.

edit

#### edit

Wyświetla okno edycji alarmu do modyfikacji alarmu.

    bool edit(const QString& eventID)

##### Parametry

`eventID`

  Określa unikalny ID zdarzenia do modyfikacji.

##### Wartości zwracane

false jeżeli wskazany alarm nie został znaleziony lub jest w trybie tylko do odczytu, true w przeciwnym wypadku.

##### Opis

`edit()` jest wywołaniem D-Bus służącym do wyświetlenia okna edycji alarmu i umożliwienia zmiany określonego alarmu.

editNew

#### editNew

Wyświetla okno edycji alarmu do modyfikacji nowego alarmu.

    bool editNew(int typ)

    bool editNew(const QString& templateName)

##### Parametry

`typ`

  Określa typ alarmu. Dostępne wartości są następujące: DISPLAY, COMMAND, EMAIL. Są one zdefiniowane przez klasę `KAlarmIface` w pliku źródłowym `kalarmiface.h`.

`templateName`

  Określa nazwę szablonu bazowego dla nowych alarmów

##### Wartości zwracane

false jeżeli parametr `typ` zawiera nieprawidłową wartość, lub jeżeli nie można znaleźć szablonu określonego nazwą: `templateName`; w innym przypadku zwraca wartość true.

##### Opis

`editNew()` jest wywołaniem D-Bus wyświetlającym okno edycji alarmu dla utworzenia nowego alarmu. Jeżeli w parametrze podano typ alarmu, wyświetla się puste okno. Jeżeli podano nazwę szablonu, to wyświetla się okno z ustawieniami pobranymi z szablonu.

### Interfejs do uruchamiania poleceń

Parametry wiersza poleceń są udostępniane, aby umożliwić innym programom uruchamianie programu &kalarm; jeżeli jeszcze nie jest uruchomiony, w celu aktywacji lub anulowania zaplanowanych alarmów, a także dodawania nowych alarmów. Powodem użycia w tym celu parametrów wiersza poleceń, jest fakt iż jeżeli &kalarm; byłby uruchomiony bez żadnych parametrów, a następnie zastosowano by wywołania D-Bus, to uruchomiłby się w domyślnym trybie graficznym, co jest niepożądane w przypadku komunikacji między aplikacjami.

Inne programy, powinny najpierw sprawdzić czy &kalarm; jest uruchomiony. Jeżeli tak jest to powinny używać wywołań D-Bus celem wykonania tych operacji.

Parametry wiersza poleceń służące do zaplanowania nowego alarmu są opisane w rozdziale:Wywołanie z wiersza poleceń. Parametry dla aktywacji i anulowania zaplanowanych alarmów są następujące:

Zwykli użytkownicy mogą wykorzystywać możliwość wywoływania programu z wiersza poleceń (zakładając że potrafią wprowadzić wszystkie niezbędne wartości parametrów).

Opcja | Opis
--- | ---
`--cancelEvent eventID` | Anuluje alarm z podanym ID zdarzenia. Parametr `--triggerEvent` nie może być podany razem z tą opcją.
`--triggerEvent eventID` | Aktywuje alarm określony wartością parametru ID zdarzenia. Wykonane zostanie działanie takie samo jak dla wywołania triggerEvent() D-Bus. Nie może być stosowany razem z parametrem `--cancelEvent`.

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;?

W pliku `$KDEHOME/share/config/kalarmrc` znajdują się ustawienia programu &kalarm;.

W pliku `$KDEHOME/share/config/kresources/alarms/stdrc` znajdują się ustawienia kalendarzy.

($`KDEHOME` odnosi się zwykle do katalogu `~/.kde` lub podobnego.)

Gdzie &kalarm; przechowuje swoje kalendarze?

Nazwy plików kalendarzy tworzonych przy pierwszym uruchomieniu programu &kalarm; są następujące (mogą one być zmienione w sekcji `General` w pliku konfiguracyjnym programu &kalarm;):

- Plik `$KDEHOME/share/apps/kalarm/calendar.ics` przechowuje aktywne alarmy (może być to zmienione przez parametr `Calendar`).

- Plik `$KDEHOME/share/apps/kalarm/expired.ics` przechowuje zarchiwizowane alarmy (może być to zmienione przez parametr `ExpiredCalendar`).

- Plik `$KDEHOME/share/apps/kalarm/template.ics` przechowuje szablony alarmów (może być to zmienione przez parametr `TemplateCalendar`).

Użytkownik może sprawdzić jaki plik jest używany dla danego kalendarza, sprawdzając szczegółu kalendarza w liście kalendarzy. Nazwy pliku kalendarza są przechowywane w pliku konfiguracyjnym kalendarza.

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

W jakim formacie program przechowuje alarmy?

Pliki kalendarza używane w programie &kalarm; do przechowywania alarmów, są plikami tekstowymi o formacie zdefiniowanym w dokumencie: RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). Jest to standardowy format używany przez wszystkie programy modułu kdepim. Program &kalarm; wykorzystuje kilka nie standardowych właściwości, w zgodzie ze standardem RFC2445. W elemencie VEVENT, są to:`X-KDE-KALARM-FLAGS`, `X-KDE-KALARM-NEXTRECUR`, `X-KDE-KALARM-REPEAT`, `X-KDE-KALARM-ARCHIVE`, `X-KDE-KALARM-LOG`, oraz w elemencie 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 robi program kalarmautostart?

kalarmautostart jest niewielkim pomocniczym programem, którego zadaniem jest automatyczne uruchomienie &kalarm-dopelniacz; po zalogowaniu.

Program &kalarm; jest zwykle przywracany do działania po zalogowaniu przez menedżera sesji (wyświetla się układ okien taki sam jaki był przy wylogowaniu). Jeżeli jednak nie był uruchomiony w momencie wylogowania, menedżer sesji nie uruchomi go, więc konieczne jest jest automatyczny start. Jeżeli jednak aplikacja jest jednocześnie zarządzana przez menedżera sesji i automatycznie uruchamiana, to nie ma gwarancji, która z tych sytuacji nastąpi wcześniej. Jeżeli automatyczny start zadziała na początku, to uniemożliwi to menedżerowi sesji przywrócenie stanu aplikacji z momentu wylogowania.

Aby uniknąć tego problemu, program kalarmautostart jest uruchamiany po zalogowaniu zamiast programu &kalarm;. Jego zadaniem jest odczekanie krótkiego czasu (aby menedżer sesji mógł zakończyć swoje działanie) przed uruchomieniem programu &kalarm;, po czym kończy on pracę.

## Licencje i zasługi

&kalarm;

Prawa autorskie: 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 &David.Jarvie; &David.Jarvie.mail;

Prawa autorskie dokumentacji 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 &David.Jarvie; &David.Jarvie.mail;

Krzysztof Woźniak wozniakk@ceti.pl

&underFDL; &underGPL;

Podziękowania należą się autorowi aplikacji KAlarm dla &kde; Stefanowi Nikolausowi stefan.nikolaus@stuco.uni-oldenburg.de, który zgodził się na użycie nazwy &kalarm; dla tego programu, który jest dostępny od wersji &kde; 2.

## Instalacja

### Jak zdobyć &kalarm;

&install.intro.documentation;

&kalarm; jest dostępne dla &kde; 2 i jako samodzielna aplikacja dla &kde; 3 pod adresem:http://www.astrojar.org.uk/kalarm

### Wymagania

Program &kalarm; wymaga zainstalowania standardowych bibliotek &kde; (pakiety `kdelibs`, `kdepimlibs`), oraz pakietu aplikacji `kdebase/runtime`. Kompilacja ze źródeł, wymaga również zainstalowania właściwych pakietów deweloperskich &kde; oraz &Qt;.

Następujące opcjonalne aplikacje zwiększają funkcjonalność programu &kalarm; (jeżeli są zainstalowane):

- KTTSD (element pakietu kdeaccessibility): jeżeli jest zainstalowany i skonfigurowany razem z kompatybilnym syntezatorem mowy, pozwala programowi &kalarm; na wypowiadanie wyświetlanych wiadomości alarmu.

Program &kalarm; wykorzystuje do pracy około 12 MB pamięci, ale ta wartość może się zmieniać w zależności od środowiska i konfiguracji.

Listę zmian można znaleźć w pliku `ChangeLog` lub na stronie http://www.astrojar.org.uk/kalarm.

### Kompilacja i instalacja

Jeżeli użytkownik nie może skorzystać z odpowiedniego pakietu binarnego z programem, powinien samodzielnie skompilować &kalarm; z plików źródłowych. Należy pobrać pliki: `kdepim-x.x.tar.bz2` lub `kalarm-x.x.tar.bz2` (lub podobne), w zależności czy chce zainstalować cały pakiet kdepim czy tylko &kalarm;. Rozpakować w katalogu roboczym, za pomocą komendy podobnej do:``tar` `xvfj package.tar.bz2``, i przejść do tego katalogu.

&install.compile.documentation;

Jeżeli użytkownik ma zainstalowaną więcej niż jedną wersję &kde; (np. &kde; 2 i &kde; 3), to możliwe jest zainstalowanie się programu &kalarm; w niewłaściwym katalogu &kde;. W razie konieczności, można podać katalog &kde; jako parametr polecenia ``./configure`` . Przykładowo, jeżeli &kde; jest zainstalowane w`/opt/kde2`, można napisać:

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

Jeżeli &kalarm; zostanie zainstalowany w katalogu innym niż środowisko &kde;, to nie będzie poprawnie działał do czasu, aż w &kde; zostanie poprawnie zdefiniowana jego lokalizacja. Aby to zrobić, należy w zmiennej środowiskowej `KDEDIRS` dołączyć ścieżkę do programu&kalarm; za każdym razem przed uruchomieniem &kde;.

Na przykład, jeżeli &kde; jest zainstalowane w `/opt/kde`, to zmienna `KDEDIRS` jest zwykle ustawiona na:`/etc/opt/kde:/opt/kde`. Jeżeli użytkownik zainstaluje &kalarm; w katalogu `/usr/local`, to zmienna `KDEDIRS` musi być ustawiona na: `/usr/local:/etc/opt/kde:/opt/kde` przed uruchomieniem &kde;.

Samodzielna wersja programu &kalarm; posiada specjalną opcję konfiguracyjną pozwalającą na wybór języka dokumentacji do zainstalowania, poprzez określenie kodu języka lub języków przy wywoływaniu polecenia`./configure`. Domyślnie, instalowane są wszystkie języki dokumentacji. Lista języków dokumentacji zawartych w pakiecie, razem z ich kodami, znajduje się w pliku `DOC-LANGUAGES`. Na przykłady, aby zainstalować tylko francuską i brytyjską dokumentację należy wpisać:

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

Uwaga: opcja ta nie ma żadnego wpływu, na to jakie tłumaczenia interfejsu zostaną zainstalowane.

### Konfiguracja

Program &kalarm; nie wymaga żadnych specjalnych czynności konfiguracyjnych przed uruchomieniem w środowisku &kde;. Po pierwszych uruchomieniu &kalarm-dopelniacz; program będzie uruchamiał się automatycznie po każdym zalogowaniu, aby monitorować zdefiniowane alarmy.

Korzystanie z programu &kalarm; w środowisku innym niż &kde; wymaga upewnienia się że &kalarm; jest uruchamiany automatycznie po zalogowaniu. Szczegółowe informacje na ten temat znajdują się w pliku `INSTALL` rozpowszechnianym z programem &kalarm;.

&documentation.index;