<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Slovenian "INCLUDE"
><!-- change language only here -->
]>

<!-- The language must NOT be changed here. -->

<book id="kalarm" lang="&language;">

<bookinfo id="kalarminfo">
<title
>&kalarm; priročnik</title>

<authorgroup>
<author
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
> <address
>&David.Jarvie.mail;</address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
><address
>&David.Jarvie.mail;</address
></affiliation>
<contrib
>Razvijalec</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Luka</firstname
><surname
>Puhar</surname
><affiliation
><address
><email
>puhar.luka@gmail.com</email
></address
></affiliation
><contrib
>Prevod</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2001</year
><year
>2002</year
><year
>2003</year
><year
>2004</year
><year
>2005</year
><year
>2006</year
><year
>2007</year
><year
>2008</year
><year
>2009</year
><year
>2010</year
><year
>2011</year
><year
>2012</year
><year
>2013</year
><year
>2016</year
><year
>2018</year
><year
>2019</year
><year
>2020</year
><year
>2021</year
><year
>2022</year
><year
>2023</year
><year
>2024</year>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date
>12.09.2024</date>
<releaseinfo
>3.10.0 (KDE Gear 24.12)</releaseinfo>

<abstract>
<para
>&kalarm; je osebni planer alarmov, ukazov in načrtovalec e-pošte, ki ga &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarm</keyword>
<keyword
>opomnik</keyword>
<keyword
>razporejevalnik</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title
>Uvod</title>

<para
>&kalarm; omogoča načrtovanje prikaza osebnih alarmnih sporočil, predvajanja zvočnih datotek, izvajanja ukazov in pošiljanja e-pošte.</para>

<para
>&kalarm; prikaže seznam čakajočih alarmov, čas in podrobnosti. Ustvarite lahko nove alarme ali izberete obstoječe alarme, ki jih želite spremeniti ali izbrisati. Po želji si lahko ogledate tudi pretečene alarme.</para>

<para
>Pri konfiguriranju alarma lahko izberete, ali naj se ponavlja in ali naj se alarm prekliče, če ga ni mogoče sprožiti ob načrtovanem času. Za prikaz alarmov lahko vnesete besedilo sporočila, določite besedilno ali slikovno datoteko, ki naj se prikaže, ali pa določite ukaz, katerega izpis naj se prikaže. Izberete lahko tudi barvo alarmnega sporočila in izberete, ali naj se predvaja zvok ali naj se sporočilo govori.</para>

<para
>Alarme lahko načrtujete tudi iz ukazne vrstice ali prek klicev &DBus; iz programov.</para>

<para
>Ko pride do alarmnega sporočila, se prikaže na vsakem namizju, če okenski sistem dopušča, da se zagotovi, da ga ne zamudite. Okno s sporočilom prikazuje čas, za katerega je bil načrtovan alarm. Običajno ima možnost odloga, da zahteva, da se alarm znova prikaže pozneje. Primer alarmnega sporočila:</para>

<screenshot>
<screeninfo
>Zaslonska slika okna s &kalarm; sporočilom</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Alarmno sporočilo</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Po želji se lahko alarmno sporočilo namesto v oknu prikaže kot obvestilo.</para>

<para
>Ko alarm določi ukaz, ki ga je treba izvesti, ali elektronsko sporočilo, ki ga je treba poslati, simbol &kalarm; ne prikaže ničesar.</para>

<para
>&kalarm; običajno prikaže ikono v sistemski vrstici, a jo lahko po želji skrijete.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Uporaba &kalarm;</title>

<para
>Ko je program &kalarm; zagnan brez parametrov ukazne vrstice, se zažene v grafičnem načinu in prikaže trenutni seznam nerešenih alarmov.</para>

<tip
><para
>Vsa polja za vrtenje v sistemu &kalarm; imajo možnost pospeševanja. Če želite, da se vrednost spreminja po večjih korakih, med klikanjem na gumbe s puščicami držite pritisnjeno tipko &Shift;.</para>

<mediaobject>
<imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject>
</mediaobject>
</tip>

<sect1 id="alarm-types">
<title
>Tipi alarmov</title>

<para
>Osnovne funkcije, ki so na voljo v različnih vrstah alarmov, ki jih zagotavlja &kalarm;, so:</para>

<itemizedlist>
<listitem>
<para
>Prikazni alarmi prikažejo besedilno sporočilo, ki ga vnesete, vsebino besedilne ali slikovne datoteke ali besedilni izpis ukaza, ki se zažene ob sprožitvi alarma. Poleg prikaza enega od teh elementov lahko predvajajo tudi zvočne datoteke, govorijo besedilo ali oddajajo preprost zvočni signal. Določite lahko tudi ukaze, ki se izvedejo pred prikazom alarmnega sporočila in po njem.</para>
</listitem>

<listitem>
<para
>Ukazni alarmni naprave izvedejo ukaz ali skriptno programsko opremo, ki jo lahko vnesete. Nič se ne prikaže, razen če pride do napake.</para>
</listitem>

<listitem>
<para
>E-poštni alarmi pošljejo e-poštno sporočilo. Nič se ne prikaže, razen če pride do napake.</para>
</listitem>

<listitem>
<para
>Zvočni alarmi predvajajo zvočno datoteko. Nič se ne prikaže, razen če pride do napake.</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Ravnanje z napakami</title>

<para
>Če se ob sprožitvi alarma pojavi napaka, se prikaže sporočilo o napaki (razen če ste predhodno določili, da se ta vrsta sporočila ne sme več prikazati).</para>

<para
>Če se je ob zadnjem sprožitvi ukaza za alarm zgodila napaka pri izvajanju, se v sporočilnem barvnem stolpcu prikaže belo rdeči klicaj. Podrobnosti o napaki se prikažejo v opombi, če postavite kazalec na to vrstico v seznamu alarmov. Enake navedbe napak so prikazane za prikaz alarmov, če je prišlo do napake pri izvajanju ukaza pred ali po alarmu, določenega v pogovornem oknu Posebna dejanja, le da se barvni stolpec ne spremeni v rdeče ozadje.</para>

</sect2>
</sect1>

<sect1 id="alarm-list">
<title
>Seznam alarmov</title>

<para
>V glavnem oknu &kalarm; je prikazan trenutni seznam čakajočih alarmov, ki prikazuje njihove čase, intervale ponavljanja, barve, namena in besedila sporočil, namena datotek za predvajanje ali prikazovanje, ukaze za izvajanje ali predmete e-pošte. (Pri ponavljajočem se alarmu je prikazani čas naslednji načrtovani čas sprožitve. Za alarm z opomnikom je prikazan čas pravega alarma in ne čas opomnika.) Ikona na levi strani vsakega predmeta besedila/datoteke/priporočila/elektronske pošte označuje vrsto alarma.</para>

<para
>Upoštevajte, da stolpec <guilabel
>Ime</guilabel
> obstaja samo, če je uporaba namen alarmov omogočena v zavihku <link linkend="preferences-general"
>Splošno</link
> pogovornega okna Konfiguracija.</para>

<screenshot>
<screeninfo
>Zaslonska slika &kalarm; glavnega okna</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Glavno okno</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Za ponavljajoči alarm sta na seznamu prikazana naslednji načrtovani čas sprožitve in osnovni interval ponavljanja (&eg; <quote
>1 dan</quote
> za dnevno ponavljanje, <quote
>3 tedne</quote
> za ponavljanje, ki se sproži v ponedeljek in sredo vsak tretji teden, <quote
>Prijava</quote
> za alarm s ponovitvijo ob prijavi).</para>

<para
>Če je prišlo do napake pri izvajanju ob zadnjem sprožitvi ukaznega alarma ali ob zadnjem izvajanju ukaza pred alarmom ali po njem, se v barvnem stolpcu prikaže oznaka napake, kot je opisano v <link linkend="errors"
>Obravnava napak</link
> zgoraj.</para>

<sect2 id="listappear">
<title
>Spreminjanje videza seznama alarmov</title>

<para
>Alarme lahko razvrstite po datumu/času, intervalu ponavljanja, barvi, vrsti, namenu ali besedilu s klikom na naslovno vrstico ustreznega stolpca. Če želite obrniti vrstni red, ponovno kliknite naslovno vrstico stolpca.</para>

<para
>Po želji lahko skupaj z načrtovanim časom alarma ali namesto njega prikažete preostali čas, ki bo ostal do začetka vsakega alarma.</para>

<para
>Stolpce, ki jih želite prikazati ali skriti, lahko izberete tako, da <mousebutton
>Desno</mousebutton
> kliknete na naslove stolpcev in s pomočjo kontekstnega menija določite stolpce, ki jih želite prikazati. Upoštevajte, da je vedno prikazan vsaj eden od stolpcev <guilabel
>Ime</guilabel
> ali <guilabel
>Sporočilo, datoteka ali ukaz</guilabel
> in vsaj eden od stolpcev <guilabel
>Čas</guilabel
> ali <guilabel
>Čas do</guilabel
>.</para>

<para
>Če uporabljate več koledarjev, lahko alarme barvno označite glede na to, kateremu koledarju pripadajo, tako da za vsak koledar izberete drugo barvo ozadja (glejte <link linkend="using-calendars"
>Uporaba koledarjev</link
>).</para>

</sect2>

<sect2 id="expired">
<title
>Arhivirani alarmi</title>

<para
>Privzeto &kalarm; za omejeno obdobje arhivira alarme, ko potečejo ali so izbrisani. (Upoštevajte pa, da se alarmi, ki jih izbrišete, shranijo le, če so se že vsaj enkrat sprožili.) V pogovornem oknu <link linkend="preferences-storage"
>Konfiguracija</link
> lahko določite, ali &kalarm; arhivira pretečene alarme in koliko časa.</para>

<para
>Arhivirane alarme lahko prikažete na seznamu alarmov z izbiro <menuchoice
><guimenu
>Pogled</guimenu
><guimenuitem
>Pokaži arhivirane alarme</guimenuitem
></menuchoice
>. Če jih želite znova skriti, odstranite izbiro <menuchoice
><guimenu
>Pogled</guimenu
><guimenuitem
>Pokaži arhivirane alarme</guimenuitem
></menuchoice
>.</para>

</sect2>

<sect2 id="datepicker">
<title
>Filtriranje seznama alarmov po datumu</title>

<para
>Seznam alarmov lahko omejite tako, da so prikazani samo alarmi, ki se bodo predvidoma pojavili na izbrani datum. To dosežemo z izbirnikom datuma alarma, ki ga lahko prikažemo ali skrijemo z <menuchoice
><guimenu
>Pogled</guimenu
> <guimenuitem
>Pokaži izbirnik datumov</guimenuitem
> </menuchoice
>. Izberite datum s klikom nanj v izbirniku datumov ali ga odstranite s ponovnim klikom nanj. V izbirniku datuma je prikazan en mesec. Če želite prikazati drug mesec, uporabite puščice v izbirniku datuma ali kolesce miške.</para>

</sect2>

<sect2 id="search">
<title
>Iskanje po seznamu alarmov</title>

<para
>Po seznamu alarmov lahko iščete alarme, ki vsebujejo iskano besedilo. Če ga želite priklicati, izberite <menuchoice
> <guimenu
>Uredi</guimenu
><guimenuitem
>Najdi...</guimenuitem
></menuchoice
>. V pogovornem oknu za iskanje izberite vrste alarmov, ki jih želite iskati. Če želite nadaljevati iskanje več alarmov, ki se ujemajo, uporabite <menuchoice
> <guimenu
>Uredi</guimenu
><guimenuitem
>Najdi naslednje</guimenuitem
></menuchoice
> ali <menuchoice
> <guimenu
>Uredi</guimenu
><guimenuitem
>Najdi predhodno</guimenuitem
> </menuchoice
>.</para>

<para
>Iskanje poteka na naslednji način:</para>

<itemizedlist>
<listitem>
<para
>Besedilo: Poišče se besedilo sporočila.</para>
</listitem>

<listitem>
<para
>Datoteka: išče se pot do datoteke/&URL;.</para>
</listitem>

<listitem>
<para
>Ukaz: išče se ukazna vrstica ali ukazna skripta.</para>
</listitem>

<listitem>
<para
>E-pošta: poleg predmeta in vsebine e-pošte se iščejo tudi prejemniki in URL-ji priponk.</para>
</listitem>

<listitem>
<para
>Zvok: išče se pot do datoteke/&URL;.</para>
</listitem>
</itemizedlist>

<note
><para
>Za iskanje lahko izberete samo alarme, ki so trenutno prikazani na seznamu alarmov. Če torej želite iskati arhivirane alarme, jih morate najprej prikazati, kot je opisano v zgornjem razdelku.</para
></note>
</sect2>
</sect1>

<sect1 id="create-edit">
<title
>Ustvarjanje in upravljanje alarmov</title>

<sect2>
<title
>Ustvarjanje novega alarma</title>

<para
>Če želite ustvariti nov alarm, naredite eno od naslednjih dejanj, nato pa s seznama, ki se prikaže, izberite vrsto alarma. Prikaže se <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarma</link
>, prek katerega konfigurirate alarm.</para>

<itemizedlist>
<listitem>
<para
>Izberite <menuchoice
><guimenu
>Datoteka</guimenu
> <guimenuitem
>Nova</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite ikono v sistemski vrstici in v kontekstnem meniju izberite <menuchoice
><guimenuitem
>Nov alarm</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite v seznamu alarmov in v kontekstnem meniju izberite <menuchoice
><guimenuitem
>Nova</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

<para
>Ustvarite lahko tudi nove alarme, ki so vnaprej konfigurirani iz različnih virov:</para>

<itemizedlist>
<listitem>
<para
>Če želite vnaprej nastaviti datum alarma v <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
>, <mousebutton
>desno</mousebutton
> kliknite želeni datum v izbirniku datuma alarma (glejte <link linkend="datepicker"
>Filtriranje seznama alarmov po datumu</link
>) in v kontekstnem meniju izberite ustrezno vrsto alarma.</para>
</listitem>

<listitem>
<para
>Če želite, da nov alarm temelji na predlogi za alarm, upoštevajte navodila v razdelku <link linkend="templates"
>Predloge alarmov</link
>.</para>
</listitem>

<listitem>
<para
>Če želite, da vaš novi alarm temelji na obstoječem, označite obstoječi alarm na seznamu in izberite <menuchoice
> <guimenu
>Datoteka</guimenu
><guimenuitem
>Kopiraj</guimenuitem
></menuchoice
>. To odpre <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarma</link
>, ki je že izpolnjeno s kopijo podrobnosti izbranega alarma.</para>
</listitem>

<listitem>
<para
>Če želite ustvariti nov alarm, ki prikazuje obstoječe e-poštno sporočilo, povlecite e-poštno sporočilo iz &kmail; v glavno okno &kalarm;. Nato izberite možnost <guilabel
>Prikazni alarm</guilabel
>. To odpre <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> s celotnim e-poštnim sporočilom (vključno s pošiljateljem, prejemnikom in drugimi podatki) kot besedilom alarma.</para>
</listitem>

<listitem>
<para
>Če želite ustvariti nov e-poštni alarm za pošiljanje kopije obstoječega e-poštnega sporočila, povlecite e-poštno sporočilo iz programa &kmail; v glavno okno programa &kalarm;. Nato izberite možnost <guilabel
>E-poštni alarm</guilabel
>. <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarma</link
> je prednastavljeno s celotnim e-poštnim sporočilom razen pošiljatelja.</para>
</listitem>

<listitem>
<para
>Če želite ustvariti nov alarm, ki prikazuje povzetek obstoječega opravila, povlecite opravilo iz programa &korganizer; ali druge aplikacije v glavno okno programa &kalarm;. To odpre <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> z vsebino opravila kot besedilom alarma.</para>
</listitem>

<listitem>
<para
>Če želite ustvariti nov ukazni alarm, povlecite besedilo skripte, ki se začne z <quote
>#!</quote
>, v glavno okno programa &kalarm;. Nato izberite možnost <guilabel
>Ukazni Alarm</guilabel
>. To odpre prednastavitev <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarmov</link
> z besedilom scenarija.</para>
</listitem>

<listitem>
<para
>Če želite ustvariti prikazni alarm, povlecite besedilno ali slikovno datoteko &URL; v glavno okno programa &kalarm;. To odpre <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> in nastavi ime datoteke.</para>
</listitem>

<listitem>
<para
>Če želite ustvariti zvočni alarm, povlecite zvočno datoteko &URL; v glavno okno programa &kalarm;. To odpre <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarmov</link
> in nastavi ime datoteke.</para>
</listitem>

<listitem>
<para
>Če želite ustvariti Besedilni alarm, povlecite poljuben del besedila v glavno okno programa &kalarm;. Če ste pozvani, izberite možnost <guilabel
>Prikazni alarm</guilabel
>. To odpre prednastavitev <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> z besedilom alarma.</para>
</listitem>

<listitem>
<para
>Za osebe v &kaddressbook; lahko samodejno ustvarite rojstnodnevne alarme, kot je opisano v <link linkend="birthdays"
>Uvoz rojstnih dni iz &kaddressbook;</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Spreminjanje obstoječega alarma</title>

<para
>Če želite spremeniti obstoječi čakajoči alarm (pretečenih alarmov ni mogoče spremeniti), naredite eno od naslednjih dejanj:</para>

<itemizedlist>
<listitem>
<para
>Dvakrat kliknite na njegov vnos na seznamu alarmov.</para>
</listitem>

<listitem>
<para
>Izberite ga s klikom na njegov vnos na seznamu alarmov. Nato izberite <menuchoice
><guimenu
>Uredi</guimenu
> <guimenuitem
>Uredi</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite njegov vnos na seznamu alarmov in v kontekstnem meniju izberite <menuchoice
><guimenuitem
>Uredi</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

<para
>Prikaže se <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarmov</link
>.</para>

</sect2>

<sect2>
<title
>Brisanje/ponovno aktiviranje alarma</title>

<para
>Če želite izbrisati obstoječe alarme, izberite enega ali več s klikom na njihov vnos na seznamu alarmov. Nato naredite eno od naslednjih dejanj:</para>

<itemizedlist>
<listitem>
<para
>Izberite <menuchoice
> <guimenu
>Uredi</guimenu
><guimenuitem
>Izbriši</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite na izbrane vnose in izberite <menuchoice
><guimenuitem
>Izbriši</guimenuitem
></menuchoice
> iz kontekstnega menija.</para>
</listitem>
<listitem>
<para
>Če jih želite izbrisati brez poziva za potrditev, vnesite &Shift;-<keycap
>Delete</keycap
>.</para>
</listitem>
</itemizedlist>

<para
>Ko izbrišete aktivni alarm, se ta arhivira, če se je pred izbrisom vsaj enkrat sprožil in če se alarmi, ki jim je potekla veljavnost, sploh arhivirajo. (Uporabite <link linkend="preferences-storage"
>Pogovorno okno Konfiguracija</link
> za nadzor, ali in koliko časa se arhivirani alarmi shranjujejo.) Ko izbrišete arhiviran alarm ali aktivni alarm, ki se še ni sprožil, se ta trajno odstrani.</para>

<para
>Izbrisan alarm s seznama arhiviranih alarmov lahko ponovno aktivirate, če še ni potekel. To storite tako, da najprej prikažete arhivirane alarme, kot je opisano v <link linkend="expired"
>Arhivirani Alarmi</link
>. Nato:</para>

<itemizedlist>
<listitem>
<para
>Izberite enega ali več ustreznih arhiviranih alarmov s klikom na njihove vnose na seznamu alarmov. Nato izberite <menuchoice
> <guimenu
>Dejanja</guimenu
><guimenuitem
>Znova omogoči</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite želene vnose na seznamu arhiviranih alarmov in izberite <menuchoice
><guimenuitem
>Znova omogoči</guimenuitem
></menuchoice
> iz kontekstnega menija.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Omogočanje/izklop alarma</title>

<para
>Glejte <link linkend="enable-disable"
>Omogočanje in Izklop alarmov</link
>, kako vključiti in izključiti alarme, posamično ali kot celoto.</para>

</sect2>

<sect2>
<title
>Nastavitev budilke za prebujanje iz stanja mirovanja</title>

<para
>Glejte <link linkend="wake-suspend"
>Prebujanje iz stanja mirovanja</link
>, kjer je opisano, kako konfigurirati alarm za prebujanje sistema iz stanja mirovanja ali hibernacije.</para>

</sect2>

<sect2>
<title
>Potrditev alarma</title>

<para
>Glejte <link linkend="message-display"
>Prikaz alarmnega sporočila</link
> za potrditev alarmov.</para>

</sect2>

<sect2 id="templates">
<title
>Predloge alarmov</title>

<para
>Če želite pogosto nastavljati podobne alarme, lahko ustvarite predlogo alarma, da vam ne bo treba vsakič znova vnašati vseh podrobnosti. Predloga lahko vsebuje vse podrobnosti, ki jih lahko vsebuje alarm, razen datuma začetka.</para>

<para
>Na primer, morda želite redno nastaviti alarm, ki vas bo opomnil na televizijski program, katerega čas se iz tedna v teden spreminja. Predloga bi vsebovala vse podrobnosti alarma (besedilo sporočila, ali naj se predvaja zvok &etc;), razen ure in datuma. Če želite ustvariti alarm, morate odpreti <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> s to predlogo in nato vnesti čas in datum.</para>

<para
>Če želite ustvariti alarm na podlagi predloge, odprite <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> s podrobnostmi predloge:</para>

<itemizedlist>
<listitem>
<para
>Izberite element menija <menuchoice
> <guimenu
>Datoteka</guimenu
><guimenuitem
>Nova</guimenuitem
> <guimenuitem
>Nov alarm iz predloge</guimenuitem
> </menuchoice
> in nato izberite želeno predlogo.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite ikono v sistemski vrstici in izberite <menuchoice
><guimenuitem
>Nov alarm</guimenuitem
> <guimenuitem
>Nov alarm iz predloge</guimenuitem
></menuchoice
> iz kontekstnega menija. Nato izberite želeno predlogo.</para>
</listitem>

<listitem>
<para
>Odprite <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarmov</link
> na običajen način in kliknite gumb <guibutton
>Naloži predlogo...</guibutton
>, da izberete predlogo, s katero boste prednastavili pogovorno okno.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Konfiguriranje predlog</title>

<para
>Predloge lahko ustvarite, spremenite ali izbrišete v pogovornem oknu Predloge alarmov ali pa ustvarite novo predlogo alarma na podlagi obstoječega alarma.</para>

<para
>Če želite ustvariti novo predlogo za alarm, naredite eno od naslednjih dejanj:</para>

<itemizedlist>
<listitem>
<para
>Prikažite pogovorno okno Predloge alarmov tako, da izberete element menija <menuchoice
> <guimenu
>Datoteka</guimenu
><guimenuitem
>Predloge...</guimenuitem
> </menuchoice
>, kliknete <guibutton
>Nova</guibutton
> in na prikazanem seznamu izberete vrsto alarma. Prikaže se prazno pogovorno okno za urejanje predloge.</para>
</listitem>

<listitem>
<para
>Prikažite pogovorno okno Predloge alarmov tako, da izberete element menija <menuchoice
> <guimenu
>Nova</guimenu
><guimenuitem
>Predloge...</guimenuitem
> </menuchoice
>, s seznama izberete obstoječo predlogo in kliknete <guibutton
>Kopiraj</guibutton
>. To odpre pogovorno okno Urejanje predloge, ki je že izpolnjeno s kopijo podrobnosti obstoječe predloge.</para>
</listitem>

<listitem>
<para
>Označite alarm na seznamu alarmov in izberite <menuchoice
> <guimenu
>Datoteka</guimenu
><guimenuitem
>Ustvari predlogo...</guimenuitem
> </menuchoice
>. To odpre pogovorno okno Urejanje predloge, ki je že izpolnjeno s kopijo podrobnosti izbranega alarma.</para>
</listitem>
</itemizedlist>

<para
>Če želite spremeniti obstoječo predlogo, prikažite pogovorno okno Predloge alarmov tako, da izberete element menija <menuchoice
> <guimenu
>Datoteka</guimenu
><guimenuitem
>Predloge...</guimenuitem
> </menuchoice
> in kliknete <guibutton
>Uredi</guibutton
>. Prikaže se pogovorno okno Urejanje predloge, ki je opisano v nadaljevanju.</para>

<para
>Če želite izbrisati obstoječe predloge, prikažite pogovorno okno Predloge alarmov tako, da izberete meni <menuchoice
> <guimenu
>Datoteka</guimenu
><guimenuitem
>Predloge...</guimenuitem
> </menuchoice
>, izberete eno ali več predlog in kliknete <guibutton
>Izbriši</guibutton
>. Da bi preprečili nenamerno brisanje, se prikaže poziv za potrditev.</para>

</sect3>

<sect3>
<title
>Pogovorno okno za Urejanje predloge</title>

<para
>Pogovorno okno za urejanje predloge je podobno pogovornemu oknu <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarmov</link
>. Naslednje kontrole se razlikujejo:</para>

<itemizedlist>
<listitem>
<para
>Ime predloge vnesite v polje <guilabel
>Ime predloge</guilabel
>. Ime predloge je tisto, ki se prikaže v seznamih za izbiro predlog, zato je najbolje izbrati ime, ki vas bo spominjalo na njeno funkcijo. Ime vsake predloge mora biti edinstveno.</para>
</listitem>

<listitem>
<para
>V polju skupine <guilabel
>Čas</guilabel
> izberite eno od naslednjih možnosti:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Privzet čas</guilabel
>, če ne želite določiti nobenega časa sprožitve. Alarmi, ki temeljijo na tej predlogi, bodo na začetku uporabljali običajni privzeti čas sprožitve za nove alarme.</para>
</listitem>

<listitem>
<para
>Označite <guilabel
>Čas</guilabel
>, da vnesete čas, ko naj bi se alarm sprožil.</para>
</listitem>

<listitem>
<para
>Označite <guilabel
>Samo datum</guilabel
>, če želite določiti, da naj alarm vsebuje samo datum in ne časa.</para>
</listitem>

<listitem>
<para
>Označite možnost <guilabel
>Čas od zdaj</guilabel
>, da vnesete, koliko časa (v urah in minutah) po ustvarjenem alarmu naj bi se ta sprožil.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>V skupinskem polju <guilabel
>Pravilo za ponovitev</guilabel
> v zavihku <guilabel
>Ponovitev</guilabel
> za tedenske oziroma letne ponovitve ni treba izbrati dneva ali meseca.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="calendars">
<title
>Alarmi v koledarju</title>

<para
>Če uporabljate samo en računalnik in delate samostojno, vam morda ni pomembno, kje &kalarm; shranjuje alarme. Če pa potrebujete dostop do alarmov v več kot enem računalniku ali na več kot enem mestu v lokalnem računalniku, lahko določite <quote
>Alarme v koledarju</quote
>, s čimer sporočite programu &kalarm;, naj poleg privzetih koledarjev alarmov ali namesto njih uporablja druge koledarje alarmov.</para>

<para
>Koledarje si lahko ogledate in z njimi upravljate prek koledarskega seznama, ki je lahko prikazan poleg seznama alarmov v glavnem oknu programa &kalarm;. Alarmi iz vseh koledarjev so na seznamu alarmov prikazani združeni. Ko shranite nov alarm, lahko nastavite možnost konfiguracije, s katero določite, ali se alarm samodejno shrani v privzeti koledar ali pa boste pozvani k izbiri koledarja. Ko uredite obstoječi alarm, se samodejno shrani nazaj v prvotni koledar alarmov.</para>

<screenshot>
<screeninfo
>Zaslonska slika glavnega okna programa &kalarm; prikazuje seznam koledarjev</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow-calendars.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Glavno okno s seznamom koledarjev</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3>
<title
>Vrste in možnosti koledarja</title>

<para
>Koledarji alarmov so razvrščeni glede na vrsto alarma in vrsto shranjevanja. Lahko jih onemogočite, nastavite samo za branje ali določite kot privzeti koledar za svojo vrsto alarma.</para>

<variablelist>
<varlistentry>
<term
>Vrsta alarma</term>
<listitem>
<para
>Trije tipi alarmnih entitet &ndash; aktivni alarmi, arhivirani alarmi in predloge alarmov &ndash; so shranjeni v ločenih koledarjih alarmov. &kalarm; ima zato tri standardne privzete koledarje, enega za vsako vrsto (za podrobnosti glejte <link linkend="faq"
>Vprašanja in odgovori</link
>), ki jih lahko po želji spremenite.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Vrsta shranjevanja</term>
<listitem>
<para
>&kalarm; obdeluje dve vrsti shranjevanja koledarja alarma:</para>

<itemizedlist>
<listitem
><para
>Lokalna datoteka: Alarmi so shranjeni v eni lokalni datoteki v formatu iCalendar. &kalarm; privzeto uporablja koledarje lokalnih datotek (za podrobnosti glejte <link linkend="faq"
>Vprašanja in odgovori</link
>). <quote
>Lokalne datoteke</quote
> lahko poleg datotek v lokalnem računalniku vključujejo tudi koledarje alarmov v lokalnem omrežju, če je njihovo lokacijo mogoče predstaviti z namenom poti, ki se začne z <literal
>/</literal
>.</para>
</listitem>

<listitem
><para
>Oddaljena datoteka: Alarmi so shranjeni v eni oddaljeni datoteki v formatu iCalendar. Ta način shranjevanja vam omogoča dostop do podatkov o alarmih na daljavo, ne glede na to, kje ste, ali omogoča drugim osebam ogled koledarjev alarmov. Ko uporabljate oddaljene datoteke, &kalarm; deluje z lokalno kopijo podatkov.</para>

<warning
><para
>&kalarm; ne nadzoruje oddaljenih alarmnih koledarjev za spremembe, tako da, če spremembe izvede nekdo drug, &kalarm; jih lahko prepiše. Da bi se temu izognili, vam priporočamo, da sprejmete enega od naslednjih pravilnikov:</para>
<itemizedlist>
<listitem
><para
>Zagotovite, da do koledarja hkrati dostopa samo ena oseba ali aplikacija.</para
></listitem>
<listitem
><para
>Vsi uporabniki razen lastnika koledarja morajo koledar konfigurirati kot samo za branje.</para
></listitem>
</itemizedlist>
<para
>V nasprotnem primeru morate vsaj znova naložiti koledar, preden ga spremenite ali se zanašate na njegovo vsebino, z uporabo metode, opisane v <link linkend="using-calendars"
>Uporaba koledarjev</link
>. Upoštevajte tudi, da če je koledar konfiguriran za branje in pisanje, &kalarm; ga bo prepisal vsakič, ko se sproži alarm. </para
></warning>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Vključeno/izključeno stanje</term>
<listitem>
<para
>Onemogočanje koledarja ima enak učinek kot njegovo odstranjevanje, le da je koledar še vedno prikazan na seznamu koledarjev, da ga lahko znova omogočite. Če je onemogočen, se njegovi alarmi ne upoštevajo in niso prikazani na seznamu alarmov ali seznamu predlog. Ko ga ponovno omogočite, se njegovi alarmi ponovno prikažejo in, če gre za aktiven koledar alarmov, postanejo aktivni.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Stanje samo za branje</term>
<listitem>
<para
>Alarmov koledarja, ki je namenjen samo branju, ni mogoče spreminjati ali dodajati. Zato ne morete urejati njegovih alarmov ali vanj shranjevati novih alarmov. Prav tako ni mogoče odložiti njegovih alarmov, saj bi bilo treba čas odložitve shraniti v alarm. Ko se sprožijo njegovi alarmi, se ne odstranijo iz koledarja in ne arhivirajo, dokler vi ali drug uporabnik ne dostopate do koledarja v bralno-pisalnem načinu.</para>

<para
>V pogovornem oknu za konfiguracijo koledarja lahko nastavite stanje koledarja samo za branje. Vendar nekaterih koledarjev zaradi različnih razlogov ni mogoče napisati:</para>

<itemizedlist>
<listitem
><para
>Če je koledar ustvarila druga aplikacija, bi bilo nevarno dovoliti, da ga &kalarm; posodobi, saj bi zaradi razlik v obliki podatkov aplikacija, ki ga je ustvarila, tega koledarja morda ne mogla uporabljati.</para>
</listitem>

<listitem
><para
>Če je bil koledar ustvarjen s poznejšo različico programa &kalarm;, se lahko podatki izgubijo, če ga vaša različica programa &kalarm; posodobi.</para>
</listitem>

<listitem
><para
>Če je bil koledar ustvarjen s prejšnjo različico programa &kalarm;, se lahko podatki izgubijo ali pa so neuporabni za prejšnjo različico programa &kalarm;, če ga vaša različica programa &kalarm; posodobi. Pozvali vas bomo, ali naj pretvorite njegovo obliko tako, da ga bo mogoče zapisovati, pri čemer je treba upoštevati morebitne težave z združljivostjo, če bo prejšnja različica programa &kalarm; ponovno potrebovala dostop do njega.</para>
</listitem>

<listitem
><para
>Če nimate dovoljenja za pisanje v datoteko ali mapo koledarja.</para>
</listitem>
</itemizedlist>

<para
>Če potrebujete dostop za pisanje alarmov v koledarju, ki ga ni mogoče narediti pisalnega, lahko njegove alarme kopirate tako, da jih uvozite v pisalni koledar z uporabo možnosti <menuchoice
><guimenuitem
>Uvoz...</guimenuitem
></menuchoice
> kontekstnega menija slednjega (glejte <link linkend="import"
>Uvoz alarmov iz zunanjih koledarjev</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Privzeto stanje koledarja</term>
<listitem>
<para
>En koledar vsake vrste alarma lahko po želji postane privzeti koledar za to vrsto alarma. Novi alarmi se samodejno shranijo v privzeti koledar za ustrezno vrsto alarma, razen če ste v <link linkend="preferences-storage"
>Pogovornem oknu za konfiguracijo</link
> izbrali možnost poziv za nove alarme in predloge.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="using-calendars">
<title
>Uporaba koledarjev</title>

<para
>Koledarje si lahko ogledate in z njimi upravljate prek seznama koledarjev, ki ga lahko prikažete ali skrijete z <menuchoice
> <guimenu
>Pogled</guimenu
><guimenuitem
>Pokaži koledarje</guimenuitem
> </menuchoice
>. Če uporabljate seznam koledarja, najprej izberite vrsto alarma v izbirnem polju nad seznamom. Nato kliknite enega od gumbov pod seznamom ali <mousebutton
>Desno</mousebutton
> kliknite ustrezen koledar na seznamu in izberite element v kontekstnem meniju. Na voljo so naslednji ukrepi:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Dodaj...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Na seznam dodajte koledar izbrane vrste. Izbrati morate vrsto shranjevanja, nato se prikaže pogovorno okno za konfiguracijo koledarja, v katerem lahko vnesete lokacijo koledarja in njegove značilnosti. Če na določenem mestu ni obstoječega koledarja z alarmi, se ustvari nov koledar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Odstrani</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Odstranite izbrani koledar s seznama. Sam koledar ostane nedotaknjen; preprosto se odstrani s seznama in se lahko po želji ponovno vključi na seznam.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Uredi...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Urejanje izbranega koledarja. Prikaže se pogovorno okno za konfiguracijo izbranega koledarja.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Znova naloži</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Ponovno naložite izbrani koledar. Koledar se ponovno prebere iz shranjevalnega mesta, s čimer se zagotovi, da ni neskladja med tem, kar prikazuje &kalarm;, in trenutnim stanjem koledarja. Če je koledar v skupni rabi z drugimi uporabniki, bo vse njihove spremembe zdaj videl tudi &kalarm;.</para>

<warning
><para
>Če ponovno naložite oddaljeni koledar, se izgubijo vse spremembe alarmov, ki ste jih naredili od zadnjega shranjevanja koledarja. Prav tako se lahko ponovno sprožijo vsi alarmi, ki so potekli od zadnjega shranjevanja.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Uvozi...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Uvoz alarmov iz zunanjih koledarskih datotek v izbrani koledar. To je opisano v <link linkend="import"
>Uvoz alarmov iz zunanjih koledarjev</link
>. Ta možnost ni na voljo za onemogočene koledarje ali koledarje samo za branje.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Izvoz...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Izvozite vse alarme v izbranem koledarju v zunanjo datoteko koledarja. To je opisano v <link linkend="export"
>Izvoz alarmov v zunanje koledarje</link
>. Ta možnost ni na voljo za onemogočene koledarje.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Prikaži podrobnosti</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Prikaz podrobnosti o izbranem koledarju. To prikazuje lokacijo koledarja, vrsto shranjevanja in informacije o stanju. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Uporabi kot privzeto</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Izbrani koledar postane privzeti koledar za izbrano vrsto koledarja. Ta možnost ni na voljo za onemogočene koledarje ali koledarje samo za branje.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Nastavi barvo...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Izberi barvo ozadja za poudarjanje alarmov tega koledarja na seznamu alarmov. Tako lahko na prvi pogled vidite, kateri alarmi pripadajo določenemu koledarju.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Počisti barvo</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Izbrišite barvno osvetlitev za alarme tega koledarja na seznamu alarmov. Ta možnost se prikaže šele po tem, ko je bila za ta koledar uporabljena možnost <guimenuitem
>Nastavi barvo</guimenuitem
>.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="import">
<title
>Uvoz alarmov iz zunanjih koledarjev</title>

<para
>V program &kalarm; lahko uvozite alarme iz drugih koledarskih datotek. Funkcija za uvoz pregleda izbrane koledarske datoteke za dogodke, ki vsebujejo alarme, in jih kopira (z novimi edinstvenimi ID-ji) v koledar &kalarm;. Dogodki brez alarmov in koledarski vnosi, ki niso dogodki, se ne upoštevajo. Alarme lahko uvozite na dva načina:</para>

<itemizedlist>
<listitem>
<para
>Uporabite <menuchoice
><guimenu
>Datoteka</guimenu
> <guimenuitem
>Uvozi Alarme...</guimenuitem
></menuchoice
> za uvoz alarmov vseh vrst (aktivni alarmi, arhivirani alarmi in predloge alarmov) iz koledarskih datotek.</para>

<para
>Če ste konfigurirali <link linkend="calendars"
>Koledarje alarmov</link
>, bodo alarmi vsake vrste dodani v ustrezen privzeti koledar, če pa ste v <link linkend="preferences-storage"
>Pogovornem oknu za konfiguracijo</link
> izbrali možnost poziva za nove alarme in predloge, boste pozvani k uporabi koledarja.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite koledar na seznamu koledarjev in izberite <menuchoice
><guimenuitem
>Uvozi...</guimenuitem
></menuchoice
> iz kontekstnega menija. S tem v koledar uvozite alarme trenutno izbrane vrste. Če je na primer izbrana vrsta koledarja predloga za alarm, bodo uvožene predloge za alarm (in ne aktivni alarmi ali arhivirani alarmi).</para>
</listitem>
</itemizedlist>

<warning
><para
>Če uvozite alarme iz koledarskih datotek, ki so bile ustvarjene s programi, ki niso &kalarm;, se lahko alarmi pri uvozu spremenijo &ndash; celo časi alarmov se lahko spremenijo. To je odvisno od načinov za shranjevanje podatkov, ki jih uporablja druga aplikacija, in je neizogibno, če se ti načini razlikujejo od tistih, ki jih pričakuje &kalarm;. Uvožene alarme vedno preverite za nepričakovane spremembe in jih po potrebi prilagodite.</para
></warning>

</sect2>

<sect2 id="export">
<title
>Izvoz alarmov v zunanje koledarje</title>

<para
>Alarme lahko izvozite iz programa &kalarm; v druge koledarske datoteke, bodisi alarme, ki so trenutno izbrani na seznamu alarmov, bodisi vse alarme iz koledarja alarmov. Načini za to so navedeni v nadaljevanju. Ne glede na uporabljeno metodo lahko ustvarite novo datoteko koledarja ali pa izvožene alarme dodate obstoječi datoteki koledarja. Če želite dodati alarme, v pogovornem oknu za izbiro datoteke označite <guilabel
>Dodaj v obstoječo datoteko</guilabel
>; v nasprotnem primeru se prepiše vsaka obstoječa datoteka.</para>

<itemizedlist>
<listitem>
<para
>Če želite izvoziti alarme, ki so trenutno izbrani na seznamu alarmov, <mousebutton
>Desno</mousebutton
> kliknite na izbor in izberite <menuchoice
><guimenuitem
>Izvozi...</guimenuitem
></menuchoice
> iz kontekstnega menija ali uporabite <menuchoice
><guimenu
>Datoteka</guimenu
> <guimenuitem
>Izvozi izbrane alarme...</guimenuitem
></menuchoice
> v glavnem meniju.</para>
</listitem>

<listitem>
<para
>Če želite izvoziti vse alarme iz koledarja, <mousebutton
>Desno</mousebutton
> kliknite koledar na seznamu koledarjev in v kontekstnem meniju izberite <menuchoice
><guimenuitem
>Izvoz...</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="birthdays">
<title
>Uvoz rojstnih dni iz &kaddressbook;</title>

<note
><para
>Ta funkcija je na voljo le, če je nameščen in omogočen vtičnik <link linkend="akonadi-plugin"
>Akonadi</link
>.</para>
</note>

<para
>Nastavite lahko prikaz alarmov za rojstne dneve, shranjene v &kaddressbook;, z <menuchoice
><guimenu
>Datoteka</guimenu
> <guimenuitem
>Uvozi Rojstne dneve...</guimenuitem
></menuchoice
>. Prikaže se pogovorno okno, v katerem lahko izberete rojstne dneve, za katere želite ustvariti alarme.</para>

<itemizedlist>
<listitem>
<para
>V polju skupine <guilabel
>Besedilo alarma</guilabel
> lahko nastavite besedilo, ki bo prikazano v rojstnodnevnih alarmnih sporočilih. Besedilo sporočila je ustvarjeno z združitvijo besedila <guilabel
>Predpona</guilabel
>, ki mu sledi ime osebe in besedilo <guilabel
>Pripona</guilabel
>. Presledki se ne dodajajo, zato ne pozabite vključiti potrebnega zadnjega presledka v <guilabel
>Predpona</guilabel
> in začetnega presledka v <guilabel
>Pripona</guilabel
>.</para>

<note
><para
>Če spremenite besedilo alarma, se seznam za izbiro rojstnih dni ponovno oceni.</para
></note>
</listitem>

<listitem>
<para
>Na seznamu <guilabel
>Izberi rojstne dneve</guilabel
> izberite rojstne dneve, za katere želite ustvariti alarme. Upoštevajte, da so na seznamu prikazani samo tisti vnosi v &kaddressbook;, ki vsebujejo rojstni dan in ki še nimajo alarma za rojstni dan v obliki, ki je trenutno določena v polju skupine <guilabel
>Besedilo alarma</guilabel
>.</para>
</listitem>

<listitem>
<para
>Preostali kontrolniki so enaki kot za <guilabel
>Besedilne</guilabel
> alarme v <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
>.</para>
</listitem>
</itemizedlist>

<para
>Če ste konfigurirali <link linkend="calendars"
>koledarje alarmov</link
>, bodo alarmi dodani v privzeti aktivni alarmni koledar, če pa ste v pogovornem oknu <link linkend="preferences-storage"
>Pogovorno okno Konfiguracija</link
> izbrali možnost poziv za nove alarme in predloge, boste morali izbrati koledar, ki ga želite uporabiti.</para>
</sect2>

<sect2 id="undo">
<title
>Razveljavi / Ponovno uveljavi</title>

<para
>Zadnje spremembe, ki ste jih naredili med trenutno sejo programa &kalarm;, lahko razveljavite in ponovite. Večino dejanj je mogoče preklicati, vključno z ustvarjanjem, urejanjem in brisanjem alarmov in alarmnih predlog ter ponovnim aktiviranjem alarmov. Da zgodovina razveljavitev ne bi porabila preveč virov, je število shranjenih sprememb omejeno na zadnjih 12.</para>

<para
>Če želite preklicati zadnjo spremembo, izberite <menuchoice
> <guimenu
>Uredi</guimenu
><guimenuitem
>Razveljavi</guimenuitem
></menuchoice
>. Če želite ponoviti zadnjo razveljavljeno spremembo, izberite <menuchoice
> <guimenu
>Urejanje</guimenu
><guimenuitem
>Ponovno uveljavi</guimenuitem
> </menuchoice
>.</para>

<para
>Če želite preklicati spremembo, ki ni zadnja, kliknite gumb <guibutton
>Razveljavi</guibutton
> v orodni vrstici in držite pritisnjen gumb miške. Prikaže se seznam akcij, s katerega lahko izberete tisto, ki jo želite preklicati. Če ne vidite želenega ukrepa, ne pozabite, da boste morda morali najprej razveljaviti novejše spremembe, od katerih je odvisna želena sprememba. Če ste na primer uredili alarm in ga nato izbrisali, ne morete razveljaviti urejanja, dokler ne razveljavite izbrisa.</para>

<para
>Ponovno izvedbo spremembe, ki ni bila zadnja, lahko izvedete na podoben način, in sicer z gumbom <guibutton
>Ponovno uveljavi</guibutton
> v orodni vrstici.</para>

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<title
>Pogovorno okno Uredi alarm</title>

<para
>V pogovornem oknu Uredi alarm si lahko ogledate in uredite alarm. Ob prvi uporabi funkcije &kalarm; se prikaže poenostavljena oblika pogovornega okna, v kateri je vidnih le nekaj možnosti. Če želite prikazati vse možnosti, kliknite gumb <guibutton
>Več Možnosti</guibutton
>; če se želite vrniti na poenostavljeno pogovorno okno, kliknite gumb <guibutton
>Manj možnosti</guibutton
>. &kalarm; si vedno zapomni vašo zadnjo izbiro prikaza, kadar koli se ponovno prikaže pogovorno okno urejanja alarmov.</para>

<para
>Privzete vrednosti številnih nastavitev v pogovornem oknu Urejanje alarmov lahko nastavite z uporabo zavihka <link linkend="preferences-edit"
>Konfiguracija pogovornega okna Uredi</link
>.</para>

<screenshot>
<screeninfo
>Zaslonska slika poenostavljenega pogovornega okna za urejanje alarmov</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Poenostavljeno pogovorno okno za urejanje alarma za alarm na zaslonu</phrase>
</textobject>
<caption
><para
>Poenostavljeno pogovorno okno za urejanje alarma za alarm na zaslonu</para
></caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Zaslonska slika pogovornega okna za urejanje alarma, ki prikazuje vse možnosti</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Pogovorno okno za urejanje alarma zaslona, ki prikazuje vse možnosti</phrase>
</textobject>
<caption
><para
>Pogovorno okno za urejanje alarma za prikaz, ki prikazuje vse možnosti</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Ime alarma</title>

<para
>V polju <guilabel
>Ime alarma</guilabel
> lahko alarma poimenujete. To je pripomoček za lažjo prepoznavo alarma. Imena vam ni treba vnesti in ni nujno, da je edinstveno.</para>

<para
>Upoštevajte, da je to polje prikazano le, če je uporaba imen alarmov omogočena v zavihku <link linkend="preferences-general"
>Splošno</link
> pogovornega okna Konfiguracija.</para>

</sect2>

<sect2>
<title
>Dejanja alarma</title>

<para
>Nadzorni elementi v skupinskem polju <guilabel
>Dejanja</guilabel
> se razlikujejo glede na vrsto alarma, ki ga urejate.</para>

<sect3>
<title
>Prikazni alarmi</title>

<para
>Prikaz alarmov prikaže okno, ko se alarm sproži. V izbirnem oknu na vrhu izberite metodo, ki se uporablja za ustvarjanje vsebine alarmnega okna:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Besedilo</guilabel
>, če želite v urejevalno polje vnesti besedilo alarmnega sporočila (ki lahko vključuje nove vrstice).</para>
</listitem>

<listitem>
<para
><guilabel
>Vsebina datoteke</guilabel
> za vnos poti ali &URL; besedilne ali slikovne datoteke, katere vsebina bo prikazana v alarmnem sporočilu. Za prikaz pogovornega okna za izbiro datoteke uporabite gumb poleg polja za urejanje. Možnost <guilabel
>Govora</guilabel
> za to vrsto alarma ni na voljo.</para>
</listitem>

<listitem>
<para
><guilabel
>Izhod ukaza</guilabel
> za določitev, da bo besedilo sporočila o alarmu ustvarjeno z ukazom, ki se izvede ob sprožitvi alarma. Za podrobnosti o vnosu ukaza ali skripte ukaza za izvedbo glejte <link linkend="command-alarm"
>Ukazni alarmi</link
> spodaj.</para>
</listitem>
</itemizedlist>

<para
>Za prikaz alarmov so na voljo naslednji upravljalni elementi:</para>

<itemizedlist>
<listitem>
<para
>Z možnostjo <guilabel
>Zvok</guilabel
> lahko izberete, ali naj se ob prikazu alarmnega sporočila sproži zvočni alarm. Izberite:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Brez</guilabel
>, da se alarm prikaže tiho.</para>
</listitem>

<listitem>
<para
><guilabel
>Pisk</guilabel
> za zvočni signal.</para>
</listitem>

<listitem>
<para
><guilabel
>Govor</guilabel
>, če želite, da se alarmno sporočilo poleg prikaza tudi govori. Ta možnost je na voljo le, če je bil program &kalarm; zgrajen z omogočenim govorom in če imate nameščen in deluje modul &Qt; Speech.</para>
</listitem>

<listitem>
<para
><guilabel
>Zvočna datoteka</guilabel
> za predvajanje zvočne datoteke. Z gumbom na desni strani prikažite pogovorno okno Zvočna datoteka, v katerem lahko izberete datoteko za predvajanje ter nastavite glasnost in možnosti ponavljanja. Če se z miško pomaknete nad izbirnik, se v opombi prikaže trenutno izbrana zvočna datoteka.</para>

<para
>V pogovornem oknu Zvočna datoteka:</para>

<itemizedlist>
<listitem>
<para
>Vnesite pot do zvočne datoteke ali uporabite gumb poleg urejevalnega polja, da prikažete pogovorno okno za izbiro datoteke. Izbrano datoteko lahko poslušate tako, da kliknete gumb za predvajanje levo od polja za urejanje. Ta gumb nato spremeni svojo funkcijo in omogoča, da preneha igrati, ko slišite dovolj.</para>
</listitem>

<listitem>
<para
>Označite možnost <guilabel
>Ponovi</guilabel
>, če želite zvočno datoteko neprekinjeno ponavljati toliko časa, dokler je prikazan alarm. (Okno s sporočilom alarma vsebuje gumb za zaustavitev predvajanja zvoka, če ga želite utišati, vendar želite še vedno prikazati alarm.)</para>
</listitem>

<listitem>
<para
>Če želite prilagoditi glasnost predvajanja zvočne datoteke, označite možnost <guilabel
>Nastavi glasnost</guilabel
> in nastavite drsnik.</para>
</listitem>

<listitem>
<para
>Če zvočno zaledje, ki je trenutno v uporabi, to podpira, lahko zmanjšate glasnost. Pojemanje pomeni začetek predvajanja zvočne datoteke pri eni glasnosti in postopno spreminjanje do končne glasnosti v določenem časovnem intervalu. Končna glasnost je tista, ki je vnesena v <guilabel
>Glasnost</guilabel
> zgoraj. Če želite omogočiti pojemanje, označite <guilabel
>Pojemaj</guilabel
> in nato vnesite obdobje pojemanja v sekundah v polje <guilabel
>Čas pojemanja</guilabel
> ter prilagodite drsnik <guilabel
>Začetna glasnost</guilabel
>.</para>
</listitem>
</itemizedlist>

<tip
><para
>Z gumbom <guibutton
>Poskusi</guibutton
> lahko preizkusite izbrane ravni zvoka.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Z gumbom <guibutton
>Pisava &amp; Barva...</guibutton
> lahko izberete pisavo ter barvo v ospredju in ozadju za alarmno sporočilo. V pogovornem oknu <guilabel
>Izberi pisavo &amp; barvo alarma</guilabel
> potrdite možnost <guilabel
>Uporabi privzeto pisavo</guilabel
>, da se sporočilo prikaže v pisavi, ki je v času prikaza sporočila konfigurirana kot privzeta. Če želite izbrati določeno pisavo za sporočilo, odstranite potrditev <guilabel
>Uporabi privzeto pisavo</guilabel
>. (Privzeto pisavo in barve lahko nastavite v <link linkend="preferences-edit"
>Pogovorno okno konfiguracije</link
>.)</para>

<para
>Izbrane barve so prikazane v polju za vnos besedila alarma.</para>
</listitem>

<listitem>
<para
>Z možnostjo <guilabel
>Metoda prikaza</guilabel
> lahko izberete način prikaza alarma. Izberite:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Okno</guilabel
> za prikaz alarma v oknu. Ta možnost omogoča uporabo celotnega nabora možnosti pri konfiguriranju alarma.</para>
</listitem>

<listitem>
<para
><guilabel
>Obvestilo</guilabel
> za uporabo standardnega sistema obveščanja za prikaz alarmnega sporočila. Zaradi omejitev sistema obveščanja z obvestili ni mogoče uporabljati naslednjih možnosti konfiguracije alarma: nastavitev pisave in barve; nastavitev zvočne datoteke, ki se predvaja ob prikazu alarma; potrditev potrditve alarma; samodejno zaprtje zaslona ob izteku časa pozne odpovedi.</para>
</listitem>
</itemizedlist>

<para
>Za več podrobnosti o prikazu alarmnih sporočil glejte razdelek <link linkend="message-display"
>Prikaz alarmnega sporočila</link
>.</para>
</listitem>

<listitem>
<para
>Z gumbom <guibutton
>Posebna dejanja...</guibutton
> določite ukaze lupine, ki se izvedejo pred ali po prikazu alarma. V pogovornem oknu <guilabel
>Posebna dejanja alarmov</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
>V polje <guilabel
>Dejanje pred alarmom</guilabel
> vnesite ukaz lupine, ki se izvede pred prikazom alarma. Upoštevajte, da bo ukaz &kalarm; počakal, da se ukaz zaključi, preden bo prikazal alarm.</para>

<para
>Predalarmno dejanje se izvede samo enkrat, ko se alarmno sporočilo prikaže na začetku, vključno s tem, ko opomnik nadomesti dejansko alarmno sporočilo. <emphasis
>Ne</emphasis
> izvede se v kateri koli od naslednjih okoliščin:</para>

<itemizedlist>
<listitem
><para
>Ko se prikaže sporočilo z opomnikom.</para
></listitem>
<listitem
><para
>Ko se sporočilo ponovno prikaže po odložitvi alarma, razen če je označena možnost <guilabel
>Izvedi za odložene alarme</guilabel
>.</para
></listitem>
<listitem
><para
>Ko je bilo sporočilo prikazano v času odjave in se obnovi, ko se ponovno prijavite.</para
></listitem>
<listitem
><para
>Ko se sproži ponavljajoči se alarm, vendar je alarmno sporočilo (ali odloženo alarmno sporočilo) iz prejšnjega pojava alarma še vedno vidno; z drugimi besedami, ko prejšnji pojav alarma še ni bil potrjen.</para
></listitem>
</itemizedlist>

<para
>S predalarmnim dejanjem lahko določite, ali naj se prikaže alarmno sporočilo:</para>

<itemizedlist>
<listitem
><para
>Označite <guilabel
>Ob napaki prekliči alarm</guilabel
>, da prekličete alarm, če ukaz za predalarm vrne status napake. S tem preprečite prikaz alarmnega sporočila in izvedbo vseh ukrepov po alarmu.</para
></listitem>

<listitem
><para
>Če ukaz za predalarm vrne napako, se običajno prikaže sporočilo o napaki, na seznamu alarmov pa se prikaže oznaka napake. Ta obvestila o napakah lahko preprečite tako, da preverite možnost <guilabel
>Ne obveščaj o napakah</guilabel
>.</para
></listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>V polje <guilabel
>Dejanje po alarmu</guilabel
> vnesite ukaz lupine, ki se izvede, ko je alarm potrjen (s klikom na <guibutton
>Prekliči</guibutton
> ali z uporabo gumba za zapiranje v naslovni vrstici okna). <emphasis
>Ne</emphasis
> izvede se v kateri koli od naslednjih okoliščin:</para>

<itemizedlist>
<listitem
><para
>Ko je sporočilo opomnika zaprto.</para
></listitem>
<listitem
><para
>Ko odložite alarm, razen ko je odloženi alarm dokončno potrjen.</para
></listitem>
<listitem
><para
>Ko se alarmno sporočilo zapre zaradi odjave.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Za podrobnosti o izvajanju ukazov lupine glejte <link linkend="command-alarm"
>Odredbe za ukaze</link
> spodaj.</para>

</listitem>
</itemizedlist>
</sect3>

<sect3 id="command-alarm">
<title
>Ukazni alarmi</title>

<para
>Alarmi ukazov izvedejo ukaz brez prikaza kakršnega koli alarmnega sporočila.</para>

<note
><para
>Ta vrsta alarma ni na voljo, če se program &kde; izvaja v načinu kiosk.</para
></note>

<para
>Ko se ukaz izvrši, okoljska spremenljivka <envar
>KALARM_UID</envar
> vsebuje UID dogodka za alarm. Upoštevajte, da bo pri izvajanju ukaza iz gumba <guibutton
>Poskusi</guibutton
> pogovornega okna Urejanje alarma <envar
>KALARM_UID</envar
> prazen, če gre za nov alarm ali če je bil alarm spremenjen v pogovornem oknu, saj alarm dobi UID šele, ko je shranjen v koledar alarmov.</para>

<para
>Za alarmne ukaze so na voljo naslednji upravljalni elementi:</para>

<itemizedlist>
<listitem>
<para
>S potrditvenim poljem <guilabel
>Vnesite skript</guilabel
> lahko izberete, ali želite vnesti ukazno vrstico lupine ali skripto.</para>

<para
>Če ta možnost ni označena, lahko vnesete ukazno vrstico lupine, ki se izvede. Ukaz se posreduje neposredno privzeti lupini (opredeljeni z okoljsko spremenljivko <envar
>SHELL</envar
>) in lahko vključuje vse možnosti, parametre, cevovodne ukaze in drugo, kar lupina dovoljuje v enovrstičnem ukazu.</para>

<para
>Če je ta možnost označena, lahko vnesete besedilo skripte, ki se izvede. Ne pozabite vključiti prve vrstice, kot je <literal
>#!/bin/bash</literal
>, da zagotovite, da se sproži pravilen prevajalnik ukazov.</para>
</listitem>

<listitem
><para
>Če ukaz vrne napako, se običajno prikaže sporočilo o napaki, na seznamu alarmov pa je prikazana oznaka napake. Sporočilo o napaki lahko preprečite tako, da preverite možnost <guilabel
>Ne obveščaj o napakah</guilabel
>.</para
></listitem>

<listitem>
<para
>V skupinskem polju <guilabel
>Izhod ukaza</guilabel
> lahko določite, kaj želite narediti z izhodnimi podatki terminala, ki jih ukaz ustvari med izvajanjem.</para>

<itemizedlist>
<listitem>
<para
>Označite možnost <guilabel
>Izvedi v terminalskem oknu</guilabel
>, da se ukaz izvede v terminalskem oknu. V pogovornem oknu <link linkend="preferences-general"
>Pogovorno okno za konfiguracijo</link
> lahko izberete, katera vrsta terminalskega okna naj se uporabi.</para>
</listitem>

<listitem>
<para
>Označite možnost <guilabel
>Beleži v datoteko</guilabel
>, če želite izpis ukaza shraniti v datoteko. Izpis, pred katerim je naslov, ki prikazuje čas, ko je bil ukaz načrtovan za izvedbo, bo dodan obstoječi vsebini datoteke. V urejevalno polje vnesite ime datoteke ali uporabite gumb poleg urejevalnega polja, da prikažete pogovorno okno za izbiro datoteke.</para>
</listitem>

<listitem>
<para
>Označite <guilabel
>Zavrzi</guilabel
>, če želite izpis ukaza zavreči.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect3>

<sect3>
<title
>E-poštni alarmi</title>

<para
>E-poštni alarmi pošljejo e-pošto, ne da bi prikazali sporočilo alarma.</para>

<para
>V tri polja za urejanje vnesite naslove prejemnikov, predmet e-pošte in vsebino sporočila. Z gumbom poleg polja za urejanje naslovnika prikažite svoj imenik, iz katerega lahko izberete prejemnike e-pošte. (Upoštevajte, da je gumb prikazan le, če je nameščen in omogočen <link linkend="akonadi-plugin"
>Vtičnik Akonadi</link
>.) Priloge lahko dodate z gumbom <guibutton
>Dodaj...</guibutton
>. Upoštevajte, da morajo priložene datoteke ob sprožitvi alarma še vedno obstajati; ob konfiguriranju alarma se kopija ne shrani. Če želite odstraniti priponko, jo označite na spustnem seznamu in kliknite gumb <guibutton
>Odstrani</guibutton
>.</para>

<para
>Nastavite naslednje možnosti:</para>

<itemizedlist>
<listitem>
<para
>V izbirnem polju <guilabel
>Od</guilabel
> lahko izberete identiteto &kmail;, ki jo želite uporabiti kot e-poštni naslov za pošiljanje e-pošte. Ta možnost se prikaže le, če je vaš <guilabel
>Od</guilabel
> e-poštni naslov v <link linkend="preferences-email"
>Pogovorno okno konfiguracije</link
> nastavljen na <guilabel
>Uporabi &kmail; identitete</guilabel
>. V nasprotnem primeru je vaš e-poštni naslov vnaprej nastavljen v <link linkend="preferences-email"
>Pogovorno okno za konfiguracijo</link
>, zato ta možnost ni uporabna.</para>
</listitem>

<listitem>
<para
>Označite možnost <guilabel
>Pošlji kopijo e-pošte sebi</guilabel
>, da si ob sprožitvi alarma pošljete slepo kopijo e-pošte. E-poštni naslov, na katerega bo poslana kopija, lahko nastavite v <link linkend="preferences-email"
>Pogovoru za konfiguracijo</link
>, pri čemer je privzeto vaš e-poštni naslov, nastavljen v &kmail;.</para>
</listitem>
</itemizedlist>

</sect3>

<sect3>
<title
>Zvočni alarmi</title>

<para
>Zvočni alarmi predvajajo zvočno datoteko brez prikaza alarmnega sporočila.</para>

<para
>Nastavite naslednje možnosti:</para>

<itemizedlist>
<listitem>
<para
>Vnesite pot do zvočne datoteke ali uporabite gumb poleg urejevalnega polja, da prikažete pogovorno okno za izbiro datoteke.</para>
</listitem>

<listitem>
<para
>Označite možnost <guilabel
>Ponovi</guilabel
>, če želite zvočno datoteko nenehno ponavljati, dokler ne izberete možnosti <guilabel
>Ustavi predvajanje</guilabel
>. Če želite ustaviti predvajanje datoteke, izberite možnost menija <menuchoice
><guimenu
>Dejanja</guimenu
> <guimenuitem
>Ustavi Predvajanje</guimenuitem
></menuchoice
> ali <mousebutton
>Desno</mousebutton
> kliknite ikono v sistemski vrstici in v kontekstnem meniu izberite <menuchoice
><guimenuitem
>Ustavi Predvajanje</guimenuitem
></menuchoice
>. Če želite, lahko za to dejanje nastavite globalno bližnjico.</para>
</listitem>

<listitem>
<para
>Če želite prilagoditi glasnost predvajanja zvočne datoteke, označite možnost <guilabel
>Nastavi glasnost</guilabel
> in nastavite drsnik.</para>
</listitem>

<listitem>
<para
>Če zvočno zaledje, ki je trenutno v uporabi, to podpira, lahko zmanjšate glasnost. Pojemanje pomeni začetek predvajanja zvočne datoteke pri eni glasnosti in postopno spreminjanje do končne glasnosti v določenem časovnem intervalu. Končna glasnost je tista, ki je vnesena v <guilabel
>Glasnost</guilabel
> zgoraj. Če želite omogočiti pojemanje, označite <guilabel
>Pojemaj</guilabel
> in nato vnesite obdobje pojemanja v sekundah v polje <guilabel
>Čas pojemanja</guilabel
> ter prilagodite drsnik <guilabel
>Začetna glasnost</guilabel
>.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>

<sect2>
<title
>Odložitev</title>

<para
>Če je alarm ponavljajoči se alarm in je bil odložen po zadnjem prikazu, je v skupinskem polju <guilabel
>Odloženi alarm</guilabel
> prikazan čas, na katerega je bil alarm odložen. <guibutton
>Spremeni...</guibutton
> prikaže pogovorno okno, v katerem lahko spremenite odloženi čas ali prekličete odložitev.</para>

</sect2>

<sect2>
<title
>Čas</title>

<para
>V polju skupine <guilabel
>Čas</guilabel
> izberite</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Na datum/čas</guilabel
> za vnos datuma in ure, ko naj se sproži alarm. Označite <guilabel
>Poljuben čas</guilabel
>, če želite za alarm določiti samo datum: v tem primeru se bo alarm prikazal ob prvi priložnosti ob ali po nastavljenem času začetka dneva na določen datum. (<link linkend="preferences-time"
>Konfiguriranje &kalarm;</link
> opisuje, kako nastaviti čas začetka dneva.)</para>

<para
>Za enkratni alarm mora biti vneseni datum/čas v prihodnosti, če vnesete samo datum, pa mora biti danes ali pozneje. Za ponavljajoči se alarm ni takšnih omejitev, saj se začetni datum/čas samodejno prilagodi prvemu ponovnemu dogodku po trenutnem času.</para>
</listitem>

<listitem>
<para
><guilabel
>Čas od zdaj</guilabel
> za vnos časa, po katerem naj se sproži alarm (v urah in minutah).</para>
</listitem>
</itemizedlist>

<para
>Po želji izberite časovni pas, ki ga želite uporabiti za alarm. Ta časovni pas se uporablja za vse datume in ure, povezane s tem alarmom, vključno z datumi in urami ponovitve in izjeme. Običajno morate pustiti kontrole časovnega pasu nespremenjene, razen če imate dober razlog, da jih spremenite.</para>

<para
>Krmilniki časovnega pasu se prikažejo le, če se izbrani časovni pas razlikuje od privzetega časovnega pasu, nastavljenega v <link linkend="preferences-time"
>Pogovorno okno Konfiguracija</link
>, ali če kliknete gumb <guibutton
>Časovni pas...</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>V izbirnem polju izberite časovni pas, ki ga bo uporabljal ta alarm. Pri ustvarjanju novega alarma je ta sprva nastavljen na časovni pas, izbran v <link linkend="preferences-time"
>Pogovorno okno za konfiguracijo</link
>, ki bo časovni pas vašega računalnika, razen če ste ga spremenili.</para>
</listitem>

<listitem>
<para
>Izberite <guilabel
>Sistemski časovni pas</guilabel
>, če želite uporabiti lokalni časovni pas računalnika (na katerem koli računalniku, na katerem je v tistem trenutku nameščen program &kalarm;).</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Opomnik</title>

<para
>Za Prikazni alarm potrdite možnost <guilabel
>Opomnik</guilabel
>, če želite prikazati opomnik pred ali po glavnem alarmu in vseh njegovih ponovitvah (če obstajajo). Z gumbi za urejanje poleg potrditvenega polja vnesite, koliko časa vnaprej ali pozneje. Če se alarm ponovi, je obdobje opomnika običajno krajše od intervala ponovitve ali pod-ponovitve.</para>

<note
><para
>Opomniki niso prikazani za pod-ponovitve znotraj ponovitve. Opomniki se prikažejo samo za vsako glavno ponovitev alarma.</para
></note>

<para
>Če se alarm ponavlja, označite možnost <guilabel
>Opomnik samo za prvo ponovitev</guilabel
>, če želite opomnik samo za prvo ponovitev alarma. Če je to označeno in gre za vnaprejšnji opomnik, za obdobje opomnika ne velja običajna omejitev, da je krajše od intervala ponovitve ali ponovitve.</para>


</sect2>

<sect2>
<title
>Preklic</title>

<para
>Možnosti pozne preklica določajo, kako se obravnava alarm po izteku načrtovanega časa:</para>

<itemizedlist>
<listitem>
<para
>Označevalno polje <guilabel
>Prekliči, če je prepozno</guilabel
> določa, kaj se zgodi, če alarma ni mogoče sprožiti ob načrtovanem času.</para>

<para
>Označite to polje, če želite preklicati alarm, če ga ni mogoče sprožiti v določenem časovnem obdobju po pravem času. Časovno obdobje izberete s kontrolnimi elementi, ki se prikažejo, ko potrdite polje. Če na primer vnesete časovno obdobje 1 ure, se bo alarm sprožil ob prvi priložnosti do ene ure po roku, če pa ga ne bo mogoče sprožiti v eni uri, bo njegova aktivacija preklicana.</para>

<note
><para
>Poznost alarmov, &ie; ki so vezani samo na datum, in alarmov, za katere je izbrana možnost <guilabel
>Katerikoli čas</guilabel
>, se izračuna od časa začetka dneva na načrtovani datum alarma.</para
></note>

<para
>Polje pustite neodkljukano, če želite sprožiti alarm ob prvi priložnosti, ki se začne ob načrtovani uri, ne glede na to, koliko je že pozno.</para>

<note
><para
>Alarm lahko sprožite le, če ste prijavljeni in če sta vklopljena programa X in &kalarm;.</para
></note>
</listitem>

<listitem>
<para
>Označite možnost <guilabel
>Samodejno zapri okno po tem času</guilabel
>, če želite, da se okno alarma samodejno zapre, če je ob izteku časa pozne preklica še vedno prikazano.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Ponovitev</title>

<para
>V zavihku <guilabel
>Ponovitev</guilabel
> določite, ali naj se alarm ponovi.</para>

<note
><para
>Osnovne značilnosti ponavljanja alarma so zaradi priročnosti prikazane v naslovu zavihka <guilabel
>Ponovitev</guilabel
>. Najprej je prikazan interval ponavljanja, nato pa morebitni interval pod-ponavljanja, nastavljen z gumbom <guibutton
>Pod-Ponavljanje</guibutton
>.</para
></note>

<para
>V polju skupine <guilabel
>Pravilo ponavljanja</guilabel
> nastavite vrsto ponavljanja ali časovno obdobje, kot sledi:</para>

<itemizedlist>
<listitem
><para
>Če želite alarm sprožiti samo enkrat, izberite <guilabel
>Brez ponovitev</guilabel
>.</para
></listitem>

<listitem
><para
>Izberite <guilabel
>Pri prijavi</guilabel
>, če želite sprožiti alarm, kadar koli se prijavite, do načrtovanega časa zaključka. Nato se ob načrtovanem času zaključka še zadnjič sproži. (Upoštevajte, da se alarm, ki se ponovi ob prijavi, sproži tudi vsakič, ko znova zaženete &kalarm;.)</para
></listitem>

<listitem>
<para
>Če želite, da se alarm ponavlja v rednih časovnih presledkih, izberite eno od vrst časovnih obdobij in nato v polje <guilabel
>Ponovi vsakih</guilabel
> vnesite, koliko časovnih obdobij naj preteče med ponovitvami. Če želite na primer ponoviti vsakih štirinajst dni, lahko izberete <guilabel
>Dnevno</guilabel
> in vnesete vrednost 14 ali izberete <guilabel
>Tedensko</guilabel
> in vnesete vrednost 2. Glede na izbrano vrsto časovnega obdobja so na voljo dodatne možnosti:</para>

<itemizedlist>
<listitem>
<para
>Za tedensko ponavljanje označite vsak dan v tednu, ko želite sprožiti alarm.</para>
</listitem>

<listitem>
<para
>Za mesečno ponavljanje lahko izberete fiksni datum ali položaj (&eg; drugi torek).</para>
</listitem>

<listitem>
<para
>Za letno ponavljanje lahko izberete določen dan v mesecu ali mesto v mesecu (&eg; zadnja sobota v maju). Označite vsak mesec v letu, v katerem želite sprožiti alarm.</para>

<para
>Če nastavite letno ponavljanje za 29. februar, lahko z izbiro ustrezne možnosti <guilabel
> 29. februar v prestopnih letih</guilabel
> določite, kako naj se obravnava v prestopnih letih: položaj v mesecu (npr. zadnja sobota v maju). Označite vsak mesec v letu, v katerem želite sprožiti alarm:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Brez</guilabel
>: v prestopnih letih se alarm pojavi 29. februarja, v neprestopnih letih pa je izključen.</para>
</listitem>

<listitem
><para
><guilabel
>28 Feb</guilabel
>: alarm se v prestopnih letih pojavi 29. februarja, v neprestopnih letih pa 28. februarja.</para>
</listitem>

<listitem
><para
><guilabel
>1. marec</guilabel
>: v prestopnih letih se alarm pojavi 29. februarja, v neprestopnih letih pa 1. marca.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<tip
><para
>Če želite dnevni alarm nastaviti tako, da se bo pojavljal samo ob delavnikih, uporabite tedensko ponavljanje in preverite vsak delavnik.</para
></tip>

</listitem>
</itemizedlist>

<para
>V skupinskem polju <guilabel
>Konec ponavljanja</guilabel
> nastavite skupni časovni razpon ponovitve, kot sledi:</para>

<itemizedlist>
<listitem
><para
>Izberite <guilabel
>Brez konca</guilabel
>, če želite nadaljevati s ponavljanjem za nedoločen čas.</para
></listitem>

<listitem
><para
>Izberite <guilabel
>Končaj po</guilabel
>, da določite skupno število pojavitev alarma.</para
></listitem>

<listitem
><para
>Izberite <guilabel
>Končaj do</guilabel
>, da določite datum/čas, do katerega se bo alarm ponavljal. Upoštevajte, da se pri tem uporablja isti časovni pas kot čas začetka alarma.</para>

<note
><para
>Končni datum/čas določa, kdaj bo zadnje glavno ponavljanje, vendar ne omejuje pod-ponovitev. Če so konfigurirane pod-ponovitve, se bodo sprožile kot običajno po zadnji glavni ponovitvi, ne glede na končni datum/čas.</para
></note>
</listitem>
</itemizedlist>

<para
>Polje skupine <guilabel
>Izjeme</guilabel
> vam omogoča, da iz nastavljenega ponavljanja izključite določene datume/čase. Upoštevajte, da ti gumbi niso prikazani v poenostavljeni obliki pogovornega okna Urejanje alarmov: če jih želite videti, kliknite <guibutton
>Več možnosti</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>Seznam izjem (&ie; izločeni datum/čas) je prikazan na levi strani. Če želite dodati novo izjemo, na desni strani vnesite datum in pritisnite <guibutton
>Dodaj</guibutton
>. Če želite spremeniti izjemo, jo označite na seznamu, na desni strani vnesite nov datum in pritisnite <guibutton
>Spremeni</guibutton
>. Če želite izbrisati izjemo, jo označite na seznamu in pritisnite <guibutton
>Izbriši</guibutton
>.</para>
</listitem>

<listitem>
<para
>Z izbiro možnosti <guilabel
>Izključi praznike</guilabel
> lahko omejite, da se alarm ne pojavi ob praznikih. To ne spremeni načina načrtovanja alarma, temveč ga preprosto odpravi, kadar se sproži na praznik. Državo ali regijo počitnic lahko izberete v <link linkend="preferences-time"
>Pogovornem oknu za konfiguracijo</link
>.</para>
</listitem>

<listitem>
<para
>Z izbiro možnosti <guilabel
>Tudi med delovnim časom</guilabel
> lahko omejite, da se alarm pojavi samo med delovnim časom. To ne spremeni načina načrtovanja alarma, temveč ga preprosto izključi, kadar se sproži zunaj delovnega časa. Delovni dnevi in delovni čas so nastavljeni v <link linkend="preferences-time"
>Pogovornem oknu konfiguracije</link
>.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Pod-ponavljanje</title>

<para
>Z gumbom <guibutton
>Pod-ponavljanje</guibutton
> lahko nastavite ponovitev znotraj ponovitve. V tem primeru se alarm vsakič, ko zapade, kot je določeno v glavnem ponavljanju, namesto da bi se sprožil samo enkrat, sproži večkrat v skladu z vašo specifikacijo pod-ponavljanja. Če želite na primer nastaviti alarm, ki se ponavlja vsako uro od poldneva do 18. ure vsak četrtek, nastavite tedensko ponavljanje v četrtek ob 12:00 in v pogovornem oknu Pod-ponovitev določite interval 1 ure in število 6 ali trajanje 6 ur.</para>

<para
>V pogovornem oknu Pod-Ponavljanje, ki se prikaže, ko kliknete gumb <guibutton
>Pod-ponavljanje</guibutton
>, označite <guilabel
>Ponovi vsakih</guilabel
>, če želite nastaviti ponavljanje, ali ga odstranite, če želite odstraniti ponavljanje. Če je označen <guilabel
>Ponavljaj vsakič</guilabel
>, nastavite ponavljanje na naslednji način:</para>

<itemizedlist>
<listitem
><para
>Časovni razmik med ponovitvami vnesite v kontrolne elemente poleg <guilabel
>Ponavljaj vsakič</guilabel
>. Izberite želene časovne enote (&eg; <guilabel
>dni</guilabel
>) in nato vnesite število enot.</para>
</listitem>

<listitem
><para
>Določite število ponovitev ali njihovo trajanje:</para>

<itemizedlist>
<listitem
><para
>Izberite <guilabel
>Število ponovitev</guilabel
>, da vnesete, kolikokrat naj se alarm sproži po glavnem ponavljanju. Če želite na primer, da se alarm pri vsakem glavnem ponovitvi pojavi 4-krat, &ie; 3-krat dodatno, morate tukaj vnesti 3.</para>
</listitem>

<listitem
><para
>Izberite <guilabel
>Trajanje</guilabel
> in vnesite skupno časovno obdobje, v katerem naj se alarm ponovi. Ni nujno, da je to natančen večkratnik intervala ponavljanja; ko kliknete <guibutton
>OK</guibutton
>, se samodejno zaokroži navzdol.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note
><para
>Da bi preprečili prekrivanje podponudb za isti alarm, je trajanje podponudbe omejeno tako, da je krajše od najdaljšega intervala med glavnimi ponovitvami. Vsakič, ko se alarm ponovi, kot je določeno v glavnem ponavljanju, se samodejno prekličejo vsa še vedno aktivna podponavljanja, ki so se začela ob prejšnjem ponavljanju.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Drugi nadzori</title>

<para
>Če sistemska konfiguracija dovoljuje več alarmov, da prebudijo sistem iz začasne zaustavitve, lahko izberete <guilabel
>Prebudi iz začasne zaustavitve</guilabel
>, da prebudite sistem, če je trenutno začasno zaustavljen, ko pride do alarma. Ta funkcija ni na voljo za alarme samo z datumom, ker njihov čas ni določen. Za več informacij glejte <link linkend="wake-suspend"
>Prebujanje iz stanja mirovanja</link
>.</para>

<para
>Pri prikaznih alarmih lahko s potrditvenim poljem <guilabel
>Potrdi seznanjenost</guilabel
> določite, ali boste ob zaprtju okna z alarmnim sporočilom pozvani k potrditvi. To se lahko uporablja kot varovalo pred naključnim potrditvijo alarmov.</para>

<para
>Izberite <guilabel
>Pokaži v &korganizer;</guilabel
>, da dodate alarm v aktivni koledar &korganizer;, kjer bo prikazan kot dogodek brez alarma. Ta možnost omogoča sledenje alarmom v programu &korganizer; in hkrati uporabo funkcij programa &kalarm;.</para>

<note
><para
>Če pozneje spremenite ali izbrišete alarm v &kalarm;, se ustrezno spremeni ali izbriše tudi dogodek &korganizer;. Če pa spremenite dogodek v &korganizer;, to ne bo vplivalo na alarm v &kalarm;.</para
></note>

<para
>Pritisnite gumb <guibutton
>Za nalaganje predloge</guibutton
> in izberite predlogo, s katero boste prednastavili pogovorno okno, kot je opisano v <link linkend="create-edit"
>Ustvarjanje in upravljanje alarmov</link
>. </para>

<para
>Pritisnite gumb <guibutton
>Poskusi</guibutton
>, da preizkusite alarm in preverite, ali deluje pravilno. Alarm se izvede, kot če bi bil načrtovan na običajen način. V primeru zvočnega alarma pritisnite gumb <guibutton
>Poskusi</guibutton
> drugič, da ustavite predvajanje zvočne datoteke.</para>

<para
>Ko so vsi podatki pravilni, pritisnite gumb <guibutton
>V redu</guibutton
>, da alarm dodate na seznam načrtovanih. Upoštevajte, da je pri urejanju obstoječega alarma gumb <guibutton
>V redu</guibutton
> onemogočen, dokler niso opravljene nobene spremembe.</para>

</sect2>
</sect1>

<sect1 id="message-display">
<title
>Prikaz alarmnega sporočila</title>

<para
>Alarmna sporočila so lahko prikazana v oknih ali kot obvestila, odvisno od možnosti, izbrane v <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
>. Ti dve možnosti prikaza sta opisani v nadaljevanju.</para>

<para
>Če zaustavite obvestila za namizje, bo izvajanje alarmov na zaslonu prekinjeno, dokler obvestila ne bodo ponovno omogočena. Upoštevajte, da to velja za vse alarme na zaslonu, ne glede na to, ali so prikazani v oknih ali kot obvestila.</para>

<sect2 id="message-window">
<title
>Okno s sporočilom o alarmu</title>

<para
>Alarmna sporočila, ki so prikazana v oknih, zagotavljajo največjo funkcionalnost.</para>

<para
>Ko pride alarmno sporočilo, je po možnosti prikazano na vsakem namizju in ga ne morejo prekriti navadna okna, da zagotovite, da ga vidite. (Upoštevajte, da to možnost trenutno omogoča samo okenski sistem X11.) Okno s sporočilom prikazuje čas, za katerega je bil načrtovan alarm, tako da lahko vidite, kdaj se je pojavil, če niste bili takrat pri računalniku. Če je načrtovani čas alarma v drugem časovnem pasu od nastavitve vašega lokalnega računalnika, bo prikazan tudi njegov časovni pas. (Pri sporočilih z opomniki je prikazan datum/čas glavnega alarma ali njegove ponovitve, ne čas sporočila z opomniki, naslov okna pa je <quote
>Opomnik</quote
>.)</para>

<para
>Okna alarmnih sporočil ostanejo vidna, dokler jih ne potrdite, razen če je bila v <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarmov</link
> označena možnost <guilabel
>Samodejno zapri okno po tem času</guilabel
>. Če pri ponavljajočem se alarmu ostane nepotrjeno okno s sporočilom iz prejšnjega pojava alarma, se obstoječe okno preprosto odpre, ko se alarm ponovi. Tako se izognete potrditvi več kopij istega sporočila, če ne želite ali ne morete potrditi sporočila ob njegovem prikazu.</para>

<para
>V oknu s sporočilom alarma je na voljo katera koli od naslednjih možnosti, ki veljajo za prikazani alarm:</para>

<itemizedlist>
<listitem>
<para
>Alarm potrdite s klikom na gumb <guibutton
>Zapri</guibutton
>. S tem se okno zapre (po pozivu za potrditev, če ste izbrali možnost <guilabel
>Potrdi seznanjenost</guilabel
>).</para>
</listitem>

<listitem>
<para
>Alarm uredite s klikom na gumb <guibutton
>Uredi...</guibutton
>. Prikaže se <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarmov</link
>.</para>
</listitem>

<listitem>
<para
>S klikom na gumb <guibutton
>Odloži...</guibutton
> prikažite možnosti za odložitev alarma na pozneje. Nato izberite <guilabel
>Odloži za</guilabel
>, da vnesete, čez koliko časa naj se sporočilo ponovno prikaže (gumb <guilabel
>Prednastavitev</guilabel
> omogoča izbiro s seznama običajnih časovnih intervalov), ali izberite <guilabel
>Odloži do</guilabel
>, da vnesete datum in čas, ko naj se sporočilo ponovno prikaže. Nato kliknite <guibutton
>V redu</guibutton
>, da odložite alarmno sporočilo in zaprete njegovo okno.</para>

<note
><para
>Čas, na katerega je alarm odložen, mora biti zgodnejši od naslednjega načrtovanega dogodka ali naslednjega vnaprejšnjega opomnika. Zato sta gumb <guibutton
>Odloži...</guibutton
> v oknu z alarmnim sporočilom in gumb <guibutton
>V redu</guibutton
> v pogovornem oknu Odložitev onemogočena eno minuto pred naslednjim dogodkom ali predhodnim opomnikom.</para>
<para
>Upoštevajte, da če je opomnik konfiguriran <emphasis
>za</emphasis
> alarmom, lahko <emphasis
>odložite</emphasis
> alarm po času opomnika. V tem primeru se opomnik izklopi.</para
></note>

<note
><para
>Gumb <guibutton
>Odloži...</guibutton
> ni na voljo za alarme, ki se prikažejo ob prijavi, ker je bila izbrana možnost <guilabel
>Ponovi ob prijavi</guilabel
>.</para
></note>
</listitem>

<listitem>
<para
>Prekinite predvajanje zvočne datoteke alarma s klikom na gumb s simbolom <quote
>prenehaj predvajati</quote
>.</para>
</listitem>

<listitem>
<para
>Če je bilo alarmno sporočilo ustvarjeno z vlečenjem e-poštnega sporočila iz storitve &kmail;, lahko neposredno dostopate do e-poštnega sporočila v storitvi &kmail; s klikom na gumb z ikono &kmail;. Tako se prikaže e-poštno sporočilo in na seznamu map &kmail; se izbere mapa, ki vsebuje e-poštno sporočilo.</para>

<warning
><para
>Če se indeksi &kmail; obnovijo, se povezava do e-pošte v &kmail; izgubi.</para
></warning>
</listitem>

<listitem>
<para
>Gumb z ikono <guiicon
>&kalarm;</guiicon
> omogoča priročen način za aktiviranje glavnega okna &kalarm; s poudarjenim alarmom.</para>
</listitem>
</itemizedlist>

<para
>Način prikaza oken z alarmnimi sporočili je odvisen od uporabljenega okenskega sistema.</para>

<itemizedlist>
<listitem>
<para
><application
>X11 okenski sistem</application
></para>

<para
>V <link linkend="preferences-view"
>Pogovornem oknu za konfiguracijo</link
> lahko izberete, kateri od dveh različnih načinov se bo uporabil za prikaz oken z alarmnimi sporočili:</para>

<itemizedlist>
<listitem>
<para
>Kot običajno okno. V tem načinu fokus tipkovnice prevzame okno z alarmnim sporočilom, ko se prikaže, zato bodo vaši pritiski na tipke preusmerjeni nanj in ne na prvotno aplikacijo, če v tem času tipkate.</para>
</listitem>

<listitem>
<para
>Kot nemodalno okno. V tem načinu fokus tipkovnice ne vpliva na prikaz okna z alarmnim sporočilom, zato ne ovira vašega tipkanja. Vendar v tem načinu okno nima naslovne vrstice ali okvirja, zato ga ne morete premikati ali spreminjati njegove velikosti.</para>
</listitem>
</itemizedlist>

<note
><para
>Kadar je alarm prikazan na vrhu celozaslonske aplikacije, je ne glede na to nastavitev konfiguracije prikazan kot nemodalno okno. To je posledica omejitve okenskega sistema.</para
></note>

<para
>V <link linkend="preferences-view"
>Pogovornem oknu za konfiguracijo</link
> lahko izberete, katera od dveh shem naj se uporabi za postavitev oken alarmnih sporočil:</para>

<itemizedlist>
<listitem>
<para
>Okna se prikažejo čim dlje od trenutnega kazalca miške. S tem čim manj motite svoj delovni proces in zmanjšate možnost, da bi pomotoma potrdili alarm.</para>
</listitem>

<listitem>
<para
>Okna so prikazana na sredini zaslona. Da bi zmanjšali možnost nenamerne potrditve alarma, so gumbi na oknu sprva onemogočeni in postanejo aktivni šele po nastavljivem zakasnitvi.</para>
</listitem>
</itemizedlist>

<para
>Če imate prikazanih več oken z alarmnimi sporočili ali sporočili o napakah, lahko okna razporedite po zaslonu, da so vidna vsa, ali pa jih ponovno združite v zgornjem levem kotu zaslona s pomočjo menijske možnosti <menuchoice
> <guimenu
>Pogled</guimenu
><guimenuitem
>Razširi okna</guimenuitem
> </menuchoice
>. Če želite, lahko za to dejanje nastavite globalno bližnjico.</para>

</listitem>

<listitem>
<para
><application
>Wayland okenski sistem</application
></para>

<para
>Okenski sistem Wayland aplikacijam ne dovoljuje nadzora položaja ali dekoracije svojih oken, zato so možnosti prikaza veliko bolj omejene.</para>

<para
>Da bi zmanjšali možnost nenamerne potrditve alarma, so gumbi na oknu sprva onemogočeni in postanejo aktivni šele po nastavljivi zakasnitvi.</para>

</listitem>

</itemizedlist>

</sect2>

<sect2>
<title
>Obvestila o alarmnih sporočilih</title>

<para
>Alarmna sporočila, ki so prikazana kot obvestila, imajo manj funkcij kot tista, ki so prikazana v oknih.</para>

<para
>Ko zapade alarmno sporočilo, se prikaže kot obvestilo. Obvestilo prikazuje čas, za katerega je bil načrtovan alarm. Če je načrtovani čas alarma v drugem časovnem pasu, kot je nastavljen v lokalnem računalniku, bo prikazan tudi njegov časovni pas. (Pri opomnikih je prikazan datum/čas glavnega alarma ali njegove ponovitve in ne čas opomnika, poleg tega je prikazan naslov "Opomnik".)</para>

<para
>Obvestilo se po kratkem času samodejno zapre. (Upoštevajte, da je časovna omejitev skupna vsem aplikacijam; spremenite jo lahko v nastavitvah &systemsettings;.) Ko se obvestilo izteče, je še vedno vidno v zgodovini obvestil, dokler ga ne odstranite ali dokler se ne odjavite. Ker aplikacije nimajo dostopa do zgodovine obvestil, &kalarm; ne more odstraniti ali zamenjati obvestil v zgodovini, kot bi to storil za alarmna okna. Tako lahko zgodovina vsebuje več obvestil za isti alarm, vključno z opomniki in ponovitvami.</para>

<para
>Obvestilo o alarmnem sporočilu omogoča naslednje možnosti. Upoštevajte, da se z izbiro katere koli možnosti obvestilo takoj zapre in se ne prikaže v zgodovini obvestil. Upoštevajte tudi, da so te možnosti na voljo le, dokler je obvestilo aktivno, preden se prekine. Če do obvestila pozneje dostopate v zgodovini obvestil, je zaradi omejitev sistema obvestil edina razpoložljiva interakcija odstranitev obvestila iz zgodovine.</para>

<itemizedlist>
<listitem>
<para
>Alarm potrdite s klikom na gumb <guibutton
>Zapri</guibutton
>. S tem zaprete obvestilo.</para>
</listitem>

<listitem>
<para
>Alarm uredite s klikom na gumb <guibutton
>Uredi</guibutton
>. Prikaže se <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarmov</link
>.</para>
</listitem>

<listitem>
<para
>S klikom na gumb <guibutton
>Odloži</guibutton
> prikažite možnosti za odložitev alarma na pozneje. Ta gumb se prikaže le, če je mogoče alarm odložiti. Za podrobnosti glejte opis možnosti odlog v razdelku <link linkend="message-window"
>Okno alarmnega sporočila</link
>.</para>
</listitem>

<listitem>
<para
>Če kliknete obvestilo kjer koli drugje kot na gumb, se aktivira glavno okno programa &kalarm; z označenim alarmom.</para>
</listitem>

</itemizedlist>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Delovanje v sistemskem predalu</title>

<para
>&kalarm; privzeto prikaže ikono v sistemski vrstici. Ikona omogoča nadzor in spremljanje stanja alarma. Običajna ikona &kalarm; pomeni, da se spremljajo vsi alarmi, medtem ko dve različni spremenjeni ikoni pomenita, da se nekateri alarmi ali vsi alarmi ne spremljajo. Spremembe ikon so odvisne od uporabljene teme ikon.</para>

<para
>Ikona v sistemski vrstici programa &kalarm; se privzeto samodejno skrije, kadar v naslednjih 24 urah ni predvidenih alarmov. Časovno omejitev samodejnega skrivanja lahko spremenite ali vedno prikažete ikono v sistemski vrstici z uporabo <link linkend="preferences-view"
>Pogovorno okno za konfiguracijo</link
>. Če želite prikazati ikono, ki je bila samodejno skrita, kliknite puščico v sistemski vrstici za prikaz skritih ikon.</para>

<para
>Če se z miškinim kazalcem pomaknete nad ikono v sistemski vrstici, se kot namig prikaže povzetek prvih nekaj alarmov s sporočili, ki jih je treba poslati v naslednjih 24 urah. To funkcijo lahko izklopite ali konfigurirate število prikazanih alarmov in njihovo obliko v <link linkend="preferences-view"
>Pogovorno okno Konfiguracija</link
>.</para>

<para
><mousebutton
>Levi</mousebutton
> klik na ikono v sistemski vrstici za preklapljanje med prikazom in skrivanjem glavnega okna &kalarm;.</para>

<para
><mousebutton
>Desno</mousebutton
> kliknite ikono v sistemski vrstici, da prikažete njen kontekstni meni:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Omogoči alarme</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Omogoči ali onemogoči spremljanje alarmov.</action
></para>
<para
>Za podrobnosti glejte <link linkend="enable-disable"
>Omogočanje in izklop alarmov</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Nov alarm</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Ko izberete vrsto alarma s seznama, ki se prikaže, se odpre pogovorno okno Urejanje alarma za ustvarjanje novega alarma.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Ustavi predvajanje</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Ustavi predvajanje zvočne datoteke, ki se trenutno predvaja.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Razprši okna</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Okna z alarmnimi sporočili in sporočili o napakah razporedi po zaslonu ali jih ponovno združi.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Konfiguriranje &kalarm;...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Prikaže pogovorno okno &kalarm; Konfiguracija.</action
></para>
<para
>Pogovorno okno za konfiguracijo je opisano v <link linkend="preferences"
>Konfiguriranje alarmov;</link
>. Vključuje možnosti, povezane z ikono &kalarm; sistemskega pladnja.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Obnovi / zmanjšaj</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Obnovi ali zmanjša glavno okno &kalarm;.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Izhod</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Zapre ikono &kalarm; v sistemski vrstici in glavna okna.</action
></para>
<para
>Zaključi program &kalarm;, če ni prikazano nobeno okno z alarmnim sporočilom.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title
>Prikaz &kalarm; v sistemskem pladnju</title>

<para
>Za prikaz &kalarm; v sistemskem pladnju mora biti nameščeno namizje &plasma; ali drug ustrezen upravljalnik oken.</para>

<para
>Izberite <menuchoice
><guimenu
>Pogled</guimenu
> <guimenuitem
>Pokaži v sistemski vrstici</guimenuitem
></menuchoice
>, če želite prikazati &kalarm; v sistemski vrstici v skladu z nastavitvami, določenimi v <link linkend="preferences-view"
>Pogled</link
> zavihku Configuration dialog dialogue.</para>

<para
>Če želite &kalarm; odstraniti iz sistemske vrstice, odstranite izbiro <menuchoice
><guimenu
>Pogled</guimenu
> <guimenuitem
>Pokaži v sistemski vrstici</guimenuitem
></menuchoice
>.</para>

<para
>Če želite izbrati, ali bo &kalarm; ob zagonu prikazan v sistemski vrstici, uporabite zavihek <link linkend="preferences-view"
>Pogled</link
> v pogovornem oknu Konfiguracija.</para>
</sect2>
</sect1>

<sect1 id="refreshing">
<title
>Osveževanje alarmov</title>

<para
>Če se v malo verjetnem primeru kakšen alarm ni sprožil, ko bi se moral, lahko osvežite seznam alarmov in sprožite vse zamujene alarme z izbiro <menuchoice
> <guimenu
>Dejanja</guimenu
><guimenuitem
>Osveži alarme</guimenuitem
> </menuchoice
>. To povzroči, da &kalarm; ponovno naloži vse koledarje alarmov.</para>

<para
>Posamezen koledar lahko ponovno naložite in osvežite njegove alarme na seznamu alarmov tako, da <mousebutton
>Desno</mousebutton
> kliknete koledar na seznamu koledarjev in izberete možnost menija <menuchoice
><guimenuitem
>Ponovno naloži</guimenuitem
></menuchoice
>. Za podrobnosti glejte <link linkend="calendars"
>Koledarji alarmov</link
>.</para>

</sect1>

<sect1 id="enable-disable">
<title
>Omogočanje in onemogočanje alarmov</title>

<para
>Alarme je mogoče omogočiti in onemogočiti v celoti ali posamezno:</para>

<itemizedlist>
<listitem>
<para
><quote
>Nadzor alarmov</quote
> velja za alarme kot celoto. Če je spremljanje alarmov onemogočeno, se alarmi sploh ne sprožijo. Ko je omogočeno spremljanje alarmov (običajna situacija), se vsi alarmi, ki niso posamično onemogočeni, sprožijo ob ustreznem času.</para>

<para
>Ko je spremljanje alarmov ponovno omogočeno, se sprožijo alarmi, ki bi se sprožili, ko je bilo spremljanje onemogočeno (razen če to preprečuje možnost pozne preklica). Z drugimi besedami, onemogočanje spremljanja alarmov ima enak učinek kot ustavitev funkcije &kalarm; &ndash; alarmi so odloženi, dokler ni ponovno omogočena.</para>
</listitem>

<listitem>
<para
>Alarme je mogoče posamično omogočiti in onemogočiti, neodvisno od stanja spremljanja alarma. Tako se stanje vključenosti/izključenosti posameznih alarmov ne bo spremenilo, če onemogočite in nato ponovno omogočite spremljanje alarmov. V nasprotju s spremljanjem alarmov, ki ga je mogoče onemogočiti, če se program &kalarm; ne izvaja, je mogoče posamezne alarme onemogočiti le, če to storite z menijskimi ukazi.</para>

<para
>Ko je alarm ponovno posamično omogočen, se zdaj ne sproži, če se je sprožil, ko je bil onemogočen. Z drugimi besedami, onemogočanje posameznega alarma prekliče vse njegove dogodke, dokler ga ponovno ne omogočite.</para>

<para
>Status posameznega alarma, ki je omogočen/izključen, je označen z barvo na seznamu alarmov (barvo je mogoče konfigurirati v zavihku <link linkend="preferences-view"
>Pogled</link
> pogovornega okna Configuration).</para>
</listitem>
</itemizedlist>

<para
>Da se alarm sproži, mora biti omogočen individualno in omogočeno mora biti nad alarma.</para>

<sect2>
<title
>Omogočanje nadzora alarma</title>

<para
>Za spremljanje alarma mora delovati program &kalarm;. Ko zaženete program &kalarm;, se bo od takrat naprej samodejno zagnal ob vsaki prijavi, razen če ga pozneje onemogočite v zavihku <link linkend="preferences-general"
>Splošno</link
> pogovornega okna Configuration.</para>

<para
>Če je spremljanje alarmov trenutno onemogočeno, naredite eno od naslednjih dejanj, da omogočite alarme:</para>

<itemizedlist>
<listitem>
<para
>Izberite <menuchoice
><guimenu
>Dejanja</guimenu
> <guimenuitem
>Omogoči Alarme</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite ikono v sistemski vrstici in v kontekstnem meniju izberite <menuchoice
><guimenuitem
>Omogoči alarme</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Onemogočanje nadzora alarma</title>

<para
>Začasno lahko onemogočite spremljanje alarmov, kar prepreči, da bi program &kalarm; preverjal vse alarme, dokler jih ponovno ne omogočite, ali &ndash; če je program &kalarm; konfiguriran tako, da se začne ob prijavi &ndash; do naslednje prijave.</para>

<itemizedlist>
<listitem>
<para
>Izberite <menuchoice
><guimenu
>Dejanja</guimenu
> <guimenuitem
>Omogoči Alarme</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite ikono v sistemski vrstici in v kontekstnem meniju odstranite kljukico <menuchoice
><guimenuitem
>Omogoči alarme</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Zaženite &kalarm; z možnostjo ukazne vrstice <option
>--disable-all</option
>.</para>
</listitem>

<listitem>
<para
>Ustavite &kalarm;, kot je opisano v <link linkend="quitting"
>Ustavitev &kalarm;</link
>.</para>
</listitem>
</itemizedlist>

<para
>Alarme lahko trajno onemogočite tako, da preprečite, da bi se ob prijavi sprožila funkcija &kalarm; z uporabo zavihka <link linkend="preferences-general"
>Splošno</link
> v pogovornem oknu Konfiguracija.</para>

</sect2>

<sect2>
<title
>Omogočanje in onemogočanje posameznih alarmov</title>

<para
>Če želite omogočiti posamezne alarme, ki so trenutno onemogočeni, naredite eno od naslednjih dejanj:</para>

<itemizedlist>
<listitem>
<para
>Izberite enega ali več alarmov s klikom na njihove vnose na seznamu alarmov. Nato izberite <menuchoice
> <guimenu
>Dejanja</guimenu
><guimenuitem
>Omogoči</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite želene vnose na seznamu alarmov in v kontekstnem meniju izberite <menuchoice
><guimenuitem
>Omogoči</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

<para
>Če želite onemogočiti posamezne alarme, ki so trenutno omogočeni, naredite eno od naslednjih dejanj:</para>

<itemizedlist>
<listitem>
<para
>Izberite enega ali več alarmov s klikom na njihove vnose na seznamu alarmov. Nato izberite <menuchoice
> <guimenu
>Dejanja</guimenu
><guimenuitem
>Onemogoči</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Desno</mousebutton
> kliknite želene vnose na seznamu alarmov in v kontekstnem meniju izberite <menuchoice
><guimenuitem
>Onemogoči</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="wake-suspend">
<title
>Prebudi se iz mirovanja</title>

<para
>Alarme je mogoče konfigurirati tako, da ob sprožitvi alarma prebudijo računalnik iz mirovanja ali mirovanja, tako da se lahko alarmno dejanje izvede tudi, ko je sistem izklopljen. Mehanizem, ki ga &kalarm; uporablja za prebujanje sistema, in uporabniški vmesnik za nadzor sistema sta odvisna od vrste sistema in uporabniških pooblastil. Obstajata dve možnosti:</para>

<sect2>
<title
>Časovnik Linuxovega jedra Prebudi se iz mirovanja</title>

<para
>Če ima uporabnik v sistemih Linux možnost časovnika alarmov jedra (<literal
>cap_wake_alarm</literal
>), lahko za prebujanje iz stanja mirovanja nastavi poljubno število alarmov. V tem primeru je prebujanje iz stanja mirovanja konfigurirano za vsak posamezni alarm v <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> z uporabo možnosti <guilabel
>Prebujanje iz stanja mirovanja</guilabel
>.</para>

<para
>V pogovornem oknu <link linkend="preferences-time"
>Configuration dialog</link
> lahko nastavite, koliko časa pred alarmom naj se sistem zbudi iz stanja mirovanja, da se zagotovi čas za popolno obnovitev pred sprožitvijo alarma.</para>

</sect2>

<sect2>
<title
>RTC Prebudi se iz mirovanja</title>

<para
>V sistemih, ki niso sistemi Linux, ali v sistemih Linux, kjer uporabnik nima možnosti <literal
>cap_wake_alarm</literal
>, se uporabi alarm ure realnega časa (<acronym
>RTC</acronym
>). To lahko nastavite samo za en alarm naenkrat. V tem primeru se za konfiguracijo uporabi posebno pogovorno okno Wake From Suspend. Pogovorno okno omogoča nastavitev, preklic ali prikaz alarma Wake From Suspend. Za dostop do pogovornega okna izberite <menuchoice
><guimenu
>Dejanja</guimenu
> <guimenuitem
>Prebudi se iz mirovanja</guimenuitem
></menuchoice
>.</para>

<para
>Uporaba funkcije Prebudi se iz mirovanja zahteva upraviteljske privilegije. Ko nastavite ali prekličete alarm Obujanje iz stanja mirovanja, boste pozvani k vpisu korenskega gesla.</para>

<note
><para
>V nekaterih računalnikih, zlasti starejših, funkcija zbujanja iz stanja mirovanja ni podprta, nekateri računalniki pa podpirajo le nastavitev časa zbujanja za največ 24 ur vnaprej. Obstajajo lahko tudi omejitve glede načina mirovanja, iz katerega se bo funkcija prebudila. Preden se zanesete na to funkcijo, razmislite o nastavitvi testnih alarmov, da preverite zmogljivost sistema.</para
></note>

<warning
><para
>Računalnik lahko naenkrat načrtuje le eno prebuditev iz stanja mirovanja. Če to funkcijo uporabljate s funkcijo &kalarm;, morate zagotoviti, da ne pride do konflikta z drugimi aplikacijami, ki prav tako uporabljajo funkcijo Prebudi se iz mirovanja. Kadar koli aplikacija načrtuje ali izbriše funkcijo Bujenje iz stanja mirovanja, to razveljavi vse predhodno nastavljene funkcije Bujenje iz stanja mirovanja, ne glede na to, ali jih je nastavil &kalarm; ali katera koli druga aplikacija.</para
></warning>

<para
>Pogovorno okno Prebuditev iz stanja mirovanja se uporablja v povezavi s seznamom alarmov v glavnem oknu programa &kalarm;.</para>

<itemizedlist>
<listitem>
<para
><guibutton
>Uporabi poudarjen alarm</guibutton
>: s tem nastavite alarm, ki je trenutno označen na seznamu alarmov, kot alarm v stanju mirovanja. Vsako obstoječe načrtovano prebujanje iz stanja mirovanja se prekliče, kot je pojasnjeno zgoraj. Gumb je omogočen le, če je označen natanko en alarm.</para>
</listitem>

<listitem>
<para
><guibutton
>Prekliči prebuditev iz stanja mirovanja</guibutton
>: prekliče vse obstoječe prebuditve iz stanja mirovanja (ki jih je nastavil &kalarm; ali katera koli druga aplikacija - glej zgoraj). Upoštevajte, da se s tem prekliče samo funkcija zbujanja, povezana z alarmom; sam alarm se ne izbriše in bo še naprej deloval kot običajno.</para>
</listitem>

<listitem>
<para
><guibutton
>Pokaži trenutni alarm</guibutton
>: s tem na seznamu alarmov poudarite trenutni alarm Prebujanje iz stanja mirovanja, da ga lahko prepoznate. Gumb je onemogočen, če trenutno ni konfigurirana funkcija Prebudi iz stanja mirovanja.</para>
</listitem>

<listitem>
<para
>S kontrolnikom <guilabel
>Število minut pred alarmom za prebuditev iz stanja mirovanja</guilabel
> lahko po želji zagotovite, da ima sistem čas, da se pred sprožitvijo alarma popolnoma obnovi, tako da se alarm lahko sproži ob pravem času.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="quitting">
<title
>Zapiranje &kalarm;</title>

<para
>&kalarm; zaprete tako, da izberete <menuchoice
> <guimenu
>Datoteka</guimenu
><guimenuitem
>Končaj</guimenuitem
></menuchoice
> ali <menuchoice
><guimenuitem
>Končaj</guimenuitem
></menuchoice
> v kontekstnem meniju ikone v sistemski vrstici. Če ikona v sistemski vrstici ni vidna, zaprite vsa okna programa &kalarm;.</para>

</sect1>
</chapter>

<chapter id="preferences">
<title
>Konfiguriranje &kalarm;</title>

<para
>Če želite konfigurirati delovanje &kalarm; tako, da ustreza vašemu sistemu in vašim osebnim željam, izberite <menuchoice
><guimenu
>Nastavitve</guimenu
> <guimenuitem
>Konfiguracija &kalarm;...</guimenuitem
></menuchoice
>. Prikaže se pogovorno okno Konfiguracija.</para>

<sect1 id="preferences-general">
<title
>Splošno</title>

<para
>V razdelku <guilabel
>Splošno</guilabel
> lahko upravljate splošno obnašanje programa &kalarm;:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Način izvajanja</guilabel
>: To vam omogoča, da izberete, ali se mora &kalarm; izvajati samodejno, ročno ali pa sploh ne.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Samodejno zaženi</guilabel
>: izberite to možnost za zagon &kalarm; samodejno ob prijavi, da zagotovite, da se vedno izvaja. To možnost morate izbrati za &kalarm; da deluje normalno in da vedno sproža alarme.</para>
</listitem>

<listitem>
<para
><guilabel
>Zaženi samo ročno</guilabel
>: izberite to možnost, če želite uporabljati &kalarm; samo občasno. Ne bo se zagnal samodejno in ga boste morali zagnati ročno, ko ga boste potrebovali. Ko se zapre (ali ko se odjavite), ne bo več deloval ali sprožal alarmov, dokler ga znova ne zaženete ročno.</para>
</listitem>

<listitem>
<para
><guilabel
>Ne zaženi</guilabel
>: izberite to možnost, če želite prenehati uporabljati &kalarm;. Ne bo se več zagnal ob prijavi in ​​ko se zapre ali se odjavite, ne bo več sprožal alarmov.</para>

<para
>Upoštevajte, da če znova kasneje zaženete &kalarm; po izbiri te možnosti, bo &kalarm; nato ponovno začel normalno delovati in se samodejno zagnal ob prijavi. Če še vedno &kalarm; ne želite uporabljati po tem, boste morali še enkrat izbrati to možnost <guilabel
>Ne zaženi</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Opozori pred izhodom</guilabel
>: &kalarm; mora delovati, da se sprožijo alarmi. To možnost izberite tako, da če poskušate prekiniti &kalarm; z njegovo možnostjo <menuchoice
><guimenu
>Izhod</guimenu
></menuchoice
> boste opozorjeni, da bodo alarmi onemogočeni in pozvani k potrditvi. To preprečuje nenamerno onemogočanje alarmov. Zaradi varnosti je ta možnost privzeto samodejno znova omogočena vsakič, ko spremenite način delovanja.</para>
</listitem>

<listitem
><para
><guilabel
>Omogoči namena alarmov</guilabel
>: Določite, ali lahko vsak alarm dobi ime, ki vam bo pomagalo pri njegovi identifikaciji. To določa, ali bo stolpec <guilabel
>Ime</guilabel
> prikazan v <link linkend="alarm-list"
>seznam alarmov</link
> in ali bo polje <guilabel
>Ime alarma</guilabel
> prikazano v <link linkend="alarm-edit-dlg"
>Pogovorno okno urejanja alarmov</link
>.</para>
</listitem>

<listitem
><para
><guilabel
>Potrdi brisanje alarma</guilabel
>: Določite, ali naj se ob vsakem brisanju alarma zahteva potrditev.</para>
</listitem>

<listitem
><para
><guilabel
>Privzeto časovno obdobje odložitve</guilabel
>: Vnesite privzeti časovni interval v urah in minutah, ki se na začetku prikaže, ko je prikazano pogovorno okno Odloži alarm. Upoštevajte, da če je bil alarm že prej odložen, bo interval, ki je na začetku prikazan v pogovornem oknu Odloži alarm, enak intervalu odložitve, ki je bil uporabljen ob zadnjem odlaganju tega alarma.</para>
</listitem>

<listitem
><para
><guilabel
>Terminal za alarmne ukaze</guilabel
>: Tukaj lahko izberete, katera vrsta terminalskega okna naj se uporabi za alarmne ukaze, ki se izvajajo v terminalskem oknu. Nekatere najpogostejše aplikacije terminalskega okna so vnaprej konfigurirane, &eg; <application
>xterm</application
>, &konsole;, vendar bodo tukaj prikazane le tiste, ki so nameščene v vašem sistemu. Dejanske možnosti ukazov, ki se uporabljajo za vsako aplikacijo, si lahko ogledate tako, da prikažete kontekstno pomoč za njen radijski gumb.</para>

<para
>Če želite uporabiti drugo aplikacijo ali če želite uporabiti eno od naštetih aplikacij, vendar z drugimi možnostmi ukazov, izberite <guilabel
>Drugo</guilabel
> in vnesite ukaz za priklic terminalskega okna. Privzeto se niz ukazov alarma doda tistemu, ki ga določite. Lahko pa določite, kam naj se vstavi niz ukazov alarma, in sicer z uporabo naslednjih kod:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>Nadomeščen bo niz ukazov alarma.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>Nadomeščen bo ukazni niz alarma z dodanim <literal
>spanjem</literal
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%C</term>
<listitem>
<para
>Ustvarjena bo začasna datoteka z ukazom, ki vsebuje niz ukazov alarma, in zamenjan bo ukaz za izvršitev datoteke.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%W</term>
<listitem>
<para
>Ustvarjena bo začasna datoteka z ukazi, ki bo vsebovala niz ukazov alarma, z dodanim <literal
>spanjem</literal
>, ukaz za izvršitev datoteke pa bo zamenjan.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%t</term>
<listitem>
<para
>nadomeščeno bo ime &kalarm; v trenutnem jeziku.Ko se sproži alarm ukaza, se njegov ukazni niz pred vstavitvijo v ukaz terminalskega okna navede v narekovajih.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Ko se sproži alarm ukaza, se njegov ukazni niz pred vstavitvijo v ukaz terminalskega okna navede v narekovajih.</para>
</listitem>

<listitem
><para
><guilabel
>Omogoči Akonadi</guilabel
>: Izberite, ali želite uporabljati &akonadi; za zagotavljanje funkcij, ki so od njega odvisne. Za podrobnosti glejte <link linkend="akonadi-plugin"
>Vtičnik Akonadi</link
>. Upoštevajte, da je ta možnost prikazana le, če je nameščen vtičnik Akonadi.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Čas &amp; Datum</title>

<para
>V razdelku <guilabel
>Čas in datum</guilabel
> lahko nastavite možnosti v zvezi s časom in datumom:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Časovni pas</guilabel
>: Izberite svoj časovni pas. &kalarm; uporablja ta časovni pas ves čas, razen kadar ga prekrijete za posamezne alarme.</para>
</listitem>

<listitem
><para
><guilabel
>Prazniki za območje</guilabel
>: Izberite države ali regije, katerih praznike želite uporabiti. To vpliva na ponavljajoče se alarme, za katere je izbrana možnost izključitve praznikov.</para>
</listitem>

<listitem
><para
><guilabel
>Prebujanje iz mirovanja pred alarmom</guilabel
>: Vnesite število minut pred časom sprožitve alarma za prebujanje sistema za alarme, nastavljene na prebujanje iz mirovanja. Tako lahko zagotovite, da ima sistem čas, da se pred sprožitvijo alarma popolnoma obnovi, tako da se alarm sproži ob pravem času. Ta možnost je prikazana le, če konfiguracija sistema omogoča, da več alarmov prebudi sistem iz stanja mirovanja. Za več informacij glejte <link linkend="wake-suspend"
>Prebujanje iz stanja mirovanja</link
>.</para>
</listitem>

<listitem
><para
><guilabel
>Začetek dneva za datumske alarme</guilabel
>: Nastavite čas začetka dneva za namene sprožitve alarmov samo z datumom, &eg; tistih, za katere je bila izbrana možnost <guilabel
>Katerakoli ura</guilabel
>. Na dan, ko so ti alarmi potrebni, se bodo sprožili ob prvi priložnosti v 24 urah od začetka dneva.</para>
</listitem>

<listitem
><para
>skupinsko okno <guilabel
>Delovni časi</guilabel
>: Te možnosti vam omogočajo, da določite svoj delovni čas, ki je potreben, ko je za ponovitev v <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> izbrana možnost <guilabel
>Tudi med delovnim časom</guilabel
>.</para>

<itemizedlist>
<listitem
><para
>Preverite vsak dan, ki je delovni dan.</para>
</listitem>

<listitem
><para
><guilabel
>Začetni čas dneva</guilabel
>: vnesite čas, ob katerem začnete delati vsak dan.</para>
</listitem>

<listitem
><para
><guilabel
>Končni čas dneva</guilabel
>: vnesite čas, ob katerem vsak dan zaključite delo.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Trajanje dogodka za KOrganizer</guilabel
>: Vnesite trajanje dogodka, ki ga nastavite v &korganizer; za alarme, ki se kopirajo v &korganizer;. Privzeto trajanje je nič.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-storage">
<title
>Shranjevanje</title>

<para
>V razdelku <guilabel
>Shranjevanje</guilabel
> lahko izberete možnosti za shranjevanje in arhiviranje alarmov:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Novi alarmi &amp; predloge</guilabel
>: Določite, v katerem koledarju se shranijo novi alarmi in predloge za alarme, če uporabljate več koledarjev za alarme:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Shrani v privzeti koledar</guilabel
>: Novi alarmi in predloge alarmov se samodejno dodajo v privzeti koledar alarmov brez poziva za potrditev.</para>
</listitem>

<listitem>
<para
><guilabel
>Vprašaj, po koledarju za shranjevanje</guilabel
>: Ko ustvarite nov alarm ali predlogo za alarm in obstaja več kot en koledar za zapisovanje alarmov, boste pozvani, da izberete, v kateri koledar naj se shrani. Upoštevajte, da so alarmi, shranjeni ob izteku veljavnosti, brez poziva vedno shranjeni v privzeti arhivirani koledar za alarme.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Arhivirani alarmi</guilabel
>: Te možnosti nadzorujejo shranjevanje arhiviranih alarmov v privzetem koledarju arhiviranih alarmov.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Ohrani alarme po preteku</guilabel
>: Izberite to možnost, če želite arhivirati pretečene in izbrisane alarme. Izberite jo, če želite, da se alarmi ne beležijo več, ko prenehajo biti aktivni. Upoštevajte, da se izbrisani alarmi arhivirajo le, če so bili predhodno sproženi. Če alarm izbrišete, preden se sploh sproži, se zavrže.</para>
</listitem>

<listitem
><para
><guilabel
>Zavrzi arhivirane alarme po</guilabel
>: Nastavite število dni za shranjevanje pretečenih in izbrisanih alarmov v arhivu, nato pa se trajno izbrišejo.</para>
</listitem>

<listitem
><para
><guibutton
>Počisti arhivirane alarme</guibutton
>: Ta gumb izbriše vse trenutno arhivirane alarme iz privzetega koledarja arhiviranih alarmov. (Drugi arhivirani koledarji budilke ostanejo nespremenjeni, če jih delite z drugimi osebami.) To ne vpliva na alarme, ki jim pozneje poteče veljavnost ali so izbrisani; še naprej se bodo arhivirali v skladu z izbranimi možnostmi.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-email">
<title
>E-pošta</title>

<para
>Razdelek <guilabel
>E-pošta</guilabel
> vam omogoča izbiro možnosti za pošiljanje in naslavljanje e-poštnih alarmov:</para>

<note
><para
>Možnosti, odvisne od &kmail; so na voljo le, če je &kalarm; <link linkend="akonadi-plugin"
>vtičnik Akonadi</link
> nameščen in omogočen.</para>
</note>

<itemizedlist>
<listitem>
<para
><guilabel
>Odjemalec E-pošte</guilabel
>: Določite e-poštni odjemalec, ki bo uporabljen za pošiljanje e-poštnih alarmov:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: Ko se sproži e-poštni alarm, se e-pošta samodejno pošlje z &kmail;.</para>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: Ko se sproži e-poštni alarm, se e-pošta samodejno pošlje s &Sendmail;. Ta možnost bo delovala samo, če je vaš sistem konfiguriran za uporabo &Sendmail; ali &Sendmail; združljiv posrednik za prenos pošte, kot je <application
>postfix</application
> ali <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Skopiraj poslana e-pošto sporočila v &kmail;ovo mapo »poslano«</guilabel
>: izberite to možnost, če želite, da se kopija poslanega e-poštnega sporočila shrani v &kmail;' s mapo <filename
>poslano</filename
>.</para>

<note
><para
>Ta možnost ni na voljo, ko &kmail; je izbran kot e-poštni odjemalec, saj &kmail; samodejno naredi to.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Obvesti, ko so oddaljena e-poštna sporočila postavljena v vrsto</guilabel
>: izberite to možnost, če želite prikazati obvestilo vsakič, ko e-poštni alarm postavi e-pošto v čakalno vrsto za pošiljanje v oddaljeni sistem. To je lahko uporabno, če imate na primer klicno povezavo ali je e-pošta v čakalni vrsti v &kmail; mapi <filename
>odhajajoče</filename
>, tako da lahko zagotovite, da naredite vse, kar je potrebno za dejansko pošiljanje e-pošta.</para>
</listitem>

<listitem>
<para
>Izberite svoj e-poštni naslov, ki bo uporabljen kot naslov pošiljatelja v e-poštnih alarmih:</para>

<itemizedlist>
<listitem
><para
>Izberite <guilabel
>Od</guilabel
>, da vnesete e-poštni naslov.</para>
</listitem>

<listitem
><para
>Izberite <guilabel
>Uporabi privzeto istovetnosti KMail</guilabel
>, da uporabite svoj privzeti e-poštni naslov, ki je nastavljen v &kmail;.</para>
</listitem>

<listitem
><para
>Izberite <guilabel
>Uporabi istovetnosti &kmail;a</guilabel
>, da lahko med konfiguracijo e-poštnega alarma izberete, katero e-poštno identiteto &kmail; želite uporabiti. Privzeta identiteta &kmail; bo uporabljena za alarme, ki so bili že nastavljeni, preden ste izbrali to možnost.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Izberite svoj e-poštni naslov, ki bo uporabljen za pošiljanje slepih kopij e-poštnih alarmov sebi, ko je izbrana možnost <guilabel
>Kopiraj e-pošto sebi</guilabel
>:</para>

<itemizedlist>
<listitem
><para
>Izberite <guilabel
>Skp</guilabel
>, da vnesete e-poštni naslov. Če naj bodo slepe kopije poslane na vaš račun v računalniku, ki ga &kalarm; deluje, lahko tukaj preprosto vnesete svoje uporabniško ime za prijavo.</para>
</listitem>

<listitem
><para
>Izberite <guilabel
>Uporabi privzeto istovetnosti KMail</guilabel
>, da uporabite svoj privzeti e-poštni naslov, ki je nastavljen v &kmail;.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-view">
<title
>Pogled</title>

<para
>Razdelek <guilabel
>Pogled</guilabel
> vam omogoča nadzor nekaterih vidikov videza &kalarm;. Na zavihku <guilabel
>Splošno</guilabel
>:</para>
<itemizedlist>

<listitem>
<para
>Skupinsko polje <guilabel
>Pokaži v sistemskem pladnju</guilabel
>: Ko je izbrano, je prikazana ikona sistemske vrstice, medtem ko &kalarm; teče glede na izbrano možnost:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Vedno prikaži</guilabel
>: Ikona sistemske vrstice je vedno prikazana.</para>
</listitem>

<listitem>
<para
><guilabel
>Samodejno skrij, če ni aktivnih alarmov</guilabel
>: ikona v sistemski vrstici je skrita, če ni aktivnih alarmov.</para>
</listitem>

<listitem>
<para
><guilabel
>Samodejno skrij, če v določenem časovnem obdobju ni alarma</guilabel
>: ikona v sistemski vrstici je skrita, če v vnesenem časovnem obdobju ni alarma, od zdaj naprej.</para>
</listitem>
</itemizedlist>

<para
>Ko je ikona sistemske vrstice samodejno skrita, jo lahko naredite vidno z možnostjo sistemske vrstice za prikaz skritih ikon.</para>

<para
>Ko je izbrana možnost <guilabel
>Pokaži v sistemski vrstici</guilabel
>, zapiranje ikone sistemske vrstice zapre vse &kalarm; glavna okna, in če ni vidnih oken s sporočili, zapre aplikacijo.</para>
</listitem>

<listitem>
<para
>Skupinsko okno <guilabel
>Orodni namig v sistemski vrstici</guilabel
>: Te možnosti nadzirajo, katere informacije so prikazane v orodni vrstici, ki se pojavi, ko miškin kazalec premaknete nad ikono sistemske vrstice &kalarm;.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Pokaži alarme v naslednjih 24 urah</guilabel
>: Ko izberete, se prikaže povzetek prvih nekaj alarmov v naslednjih 24 urah.</para>
</listitem>

<listitem>
<para
><guilabel
>Največje število alarmov, ki naj bodo prikazani</guilabel
>: Odznačite to možnost, če želite prikazati vse alarme za naslednjih 24 ur. Izberite ga, da nastavite največje število alarmov, ki bodo prikazani.</para>
</listitem>

<listitem>
<para
><guilabel
>Pokaži čas alarma</guilabel
>: izberite to možnost, če želite prikazati čas, ob katerem je načrtovan vsak alarm.</para>
</listitem>

<listitem>
<para
><guilabel
>Pokaži čas do alarma</guilabel
>: izberite to možnost, če želite prikazati preostali čas do naslednjega načrtovanega pojava vsakega alarma. Dolžina časa je prikazana v urah in minutah.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Predpona</guilabel
>: Določite simbol ali besedilo, ki naj bo prikazano pred časom do alarma, da ga ločite od ure, na katero je alarm načrtovan.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Polje skupine <guilabel
>Seznam alarmov</guilabel
> omogoča izbiro barv, uporabljenih na seznamu alarmov v glavnem oknu &kalarm;, za prikaz onemogočenih in arhiviranih alarmov.</para>
</listitem>
</itemizedlist>

<para
>Zavihek <guilabel
>Alarmna okna</guilabel
> vsebuje možnosti za nadzor videza oken z alarmnimi sporočili. Razpoložljive možnosti so odvisne od uporabljenega okenskega sistema.</para>

<itemizedlist>
<listitem>
<para
><application
>X11 okenski sistem</application
></para>

<itemizedlist>
<listitem>
<para
><guilabel
>Postavi okna čim dlje od miškine kazalke</guilabel
>: Izberite to možnost, če želite prikazati okna alarmnih sporočil čim dlje od trenutnega položaja miškine kazalke. To zmanjša možnost nenamerne potrditve alarma z nenamernim klikom na gumb, ravno ko se prikaže okno s sporočilom.</para>
</listitem>

<listitem>
<para
><guilabel
>Usredini okna, zakasni omogočanje gumbov v oknih</guilabel
>: izberite to možnost, če želite okna z alarmnimi sporočili prikazati na sredini zaslona. Da bi zmanjšali možnost nenamerne potrditve alarma, so gumbi okna na začetku onemogočeni. Zakasnitev v sekundah, preden postanejo aktivni, je nastavljena v <guilabel
>Zakasnitev omogočanja gumbov (sekunde)</guilabel
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Sporočilna okna imajo nazivno vrstico in prevzamejo žarišče tipkovnice</guilabel
>: Ta možnost nadzoruje, ali so okna z alarmnimi sporočili modalna ali ne, &ie;. ali zgrabijo fokus tipkovnice, ko se pojavijo. Za podrobnosti glejte razdelek <link linkend="message-display"
>Prikaz alarmnih sporočil</link
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><application
>Wayland okenski sistem</application
></para>

<itemizedlist>
<listitem>
<para
>Da bi zmanjšali možnost nenamerne potrditve alarma, so gumbi okna na začetku onemogočeni. Zakasnitev v sekundah, preden postanejo aktivni, je nastavljena v <guilabel
>Zakasnitev aktiviranja gumba (sekunde)</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="preferences-edit">
<title
>Uredi</title>

<para
>V razdelku <guilabel
>Uredi</guilabel
> lahko izberete privzete vrednosti za možnosti v <link linkend="alarm-edit-dlg"
>pogovornem oknu za urejanje alarma</link
>:</para>

<itemizedlist>
<listitem
><para
>Zavihek <guilabel
>Splošno</guilabel
> vsebuje možnosti, ki veljajo za vse vrste alarmov.</para>

<itemizedlist>
<listitem
><para
>Nastavite privzeti način za prikaz alarmnih sporočil.</para>
</listitem>

<listitem
><para
>Nastavite privzeta stanja za potrditveni polji <guilabel
>Pokaži v KOrganizerju</guilabel
> in <guilabel
>Prekliči, če zamuja</guilabel
>.</para>
</listitem>

<listitem
><para
>Nastavi privzeto vrsto ponavljanja.</para>
</listitem>

<listitem
><para
>Izberite privzeto obravnavanje v neprestopnih letih letnih ponovitev, načrtovanih za 29. februar.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Zavihek <guilabel
>Vrste alarmov</guilabel
> vsebuje možnosti, ki veljajo za določene vrste alarmov.</para>

<itemizedlist>
<listitem>
<para
>Za prikazne alarme:</para>

<itemizedlist>
<listitem
><para
>Nastavite privzeta stanja za potrditveni polji <guilabel
>Samodejno zapri okno po tem času</guilabel
> in <guilabel
>Potrdi seznanjenost</guilabel
>.</para>
</listitem>

<listitem
><para
>Nastavite privzete enote obdobja opomina.</para>
</listitem>

<listitem
><para
>Nastavite privzeta posebna dejanja alarma zaslona.</para>
</listitem>

<listitem
><para
>Nastavite privzete možnosti zvoka. Upoštevajte, da je lahko določena privzeta zvočna datoteka, tudi če vrsta zvoka ni nastavljena na <guilabel
>Zvočna datoteka</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Za ukazne alarme:</para>

<itemizedlist>
<listitem
><para
>Nastavite privzeta stanja za potrditveni polji <guilabel
>Vnesi skript</guilabel
> in <guilabel
>Izvedi v terminalskem oknu</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Za e-poštne alarme:</para>

<itemizedlist>
<listitem
><para
>Nastavite privzeto stanje za potrditveno polje <guilabel
>Pošlji kopijo e-pošte sebi</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Pisava &amp; Zavihek Barva</guilabel
> omogoča nastavitev privzetega videza alarmnih sporočil. Izberite njihovo privzeto pisavo ter barve ospredja in ozadja.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Delovanje ukazne vrstice</title>

<para
>Ko so podani parametri ukazne vrstice, &kalarm; ne prikaže seznama načrtovanih alarmov, kot je opisano v <link linkend="using-kalarm"
>Uporaba &kalarm;</link
> zgoraj. Možnosti ukazne vrstice, specifične za &kalarm; se lahko uporablja za izvajanje naslednjih operacij:</para>

<itemizedlist>
<listitem
><para
>načrtuj nov alarm</para>
</listitem>
<listitem
><para
>nadzor &kalarm; načina prikaza</para>
</listitem>
<listitem
><para
>pridobi pomoč</para>
</listitem>
</itemizedlist>

<para
>Dodatne možnosti ukazne vrstice so na voljo predvsem zato, da drugim programom omogočijo vmesnik do &kalarm;. Opisani so v poglavju <link linkend="cmdline-interface"
>Razvijalski vodnik za &kalarm;</link
>.</para>

<para
>Ukazna vrstica mora vsebovati samo možnosti, ki veljajo za en &kalarm; delovanje. Če želite izvesti več operacij, morate priklicati &kalarm; večkrat z enim naborom možnosti vsakič.</para>

<sect1 id="cmdline-schedule">
<title
>Načrtuj nov alarm</title>

<para
>Za načrtovanje novega alarma se uporabljajo naslednje možnosti:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Možnost</entry>
  <entry
>Opis</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry>
  <entry
>Poziv za potrditev, ko je alarmno sporočilo potrjeno.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Navedite pot ali &URL; datoteke, ki bo priložena e-pošti. To možnost lahko po potrebi ponovite. <option
>--mail</option
> mora biti določena s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>--auto-close</option
></entry>
  <entry
>Samodejno zapre okno alarma po poteku obdobja <option
>--late-cancel</option
>. <option
>--late-cancel</option
> mora biti določena s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Ob prikazu sporočila se oglasi zvočni signal. <option
>--speak</option
>, <option
>--play</option
> in <option
>--play-repeat</option
> ni mogoče določiti s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Slepo kopirajte e-pošto sebi. <option
>--mail</option
> mora biti določena s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>color</replaceable
></option
></entry>
  <entry
>Nastavite barvo ozadja sporočila na določeno ime barve &Qt; ali šestnajstiško kodo 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>color</replaceable
></option
></entry>
  <entry
>Nastavi barvo sporočila v ospredju na določeno &Qt; ime barve ali šestnajstiško kodo 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>Onemogočite alarm. Ne bo se sprožila, dokler ne bo ročno omogočena.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Onemogočite spremljanje alarma. To prepreči sprožitev vseh alarmov, dokler ob naslednji prijavi ponovno ne omogočite alarmov ali ponovno zaženete &kalarm;, &eg;. <option
>--sprožiDogodek</option
> ni mogoče določiti s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>commandline</replaceable
></option
></entry>
  <entry
>Navedite ukaz lupine, ki se izvede. Če je ta možnost določena, mora biti zadnja možnost &kalarm; v ukazni vrstici programa &kalarm;. Vsi naslednji parametri in možnosti ukaza se interpretirajo, kot da tvorijo ukazno vrstico za izvedbo. <option
>--file</option
> in <option
>--exec-display</option
> ter <option
>--mail</option
> ni mogoče določiti s to možnostjo. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> in <option
>--colorfg</option
> se pri tej možnosti ne upoštevajo.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>commandline</replaceable
></option
></entry>
  <entry
>Navedite ukaz lupine, ki se izvede za ustvarjanje besedila alarmnega sporočila. Če je ta možnost določena, mora biti zadnja možnost &kalarm; v ukazni vrstici programa &kalarm;. Vsi naslednji parametri in možnosti ukaza se interpretirajo kot ukazna vrstica za izvedbo. <option
>--exec</option
>, <option
>--file</option
> in <option
>--mail</option
> ni mogoče določiti s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Navedite pot ali &URL; besedilne ali slikovne datoteke, katere vsebina bo tvorila alarmno sporočilo. <option
>--exec</option
>, <option
>--exec-display</option
> in <option
>--mail</option
> ni mogoče navesti, možnost <replaceable
>sporočilo</replaceable
> pa ne sme biti prisotna s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Kot pošiljatelja e-pošte uporabite določeno identiteto &kmail;. <option
>--mail</option
> mora biti določena s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>period</replaceable
></option
></entry>
  <entry
>Nastavite interval med ponovitvami alarma. Ure/minute so navedene v obliki <replaceable
>nHnM</replaceable
>, kjer je <replaceable
>n</replaceable
> številka, npr. 3H30M. Druga časovna obdobja so navedena v obliki <replaceable
>nX</replaceable
>, kjer je <replaceable
>n</replaceable
> številka, <replaceable
>X</replaceable
> pa ena od naslednjih črk: L (leta), M (meseci), T (tedni), D (dnevi). Če je navedena tudi možnost <option
>--recurrence</option
>, L (leta) in M (meseci) nista dovoljena. Obvezno, če je določena možnost <option
>--repeat</option
> ali <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Prikažite alarm kot dogodek v aktivnem koledarju naprave &korganizer;.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>period</replaceable
></option
></entry>
  <entry
>Prekličite alarm, če ga ni mogoče sprožiti v določenem <replaceable
>obdobju</replaceable
> po pravem času. Ure/minute so navedene v obliki <replaceable
>nHnM</replaceable
>, kjer je <replaceable
>n</replaceable
> številka, npr. 3H30M. Druga časovna obdobja so navedena v obliki <replaceable
>nX</replaceable
>, kjer je <replaceable
>n</replaceable
> številka, <replaceable
>X</replaceable
> pa ena od naslednjih črk: T (tedni), D (dnevi). Privzeta vrednost <replaceable
>obdobje</replaceable
> je 1 minuta.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Alarm se sproži ob vsaki prijavi. <option
>--interval</option
>, <option
>--repeat</option
> in <option
>--until</option
> s to možnostjo ni mogoče določiti.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>address</replaceable
></option
></entry>
  <entry
>Pošljite e-poštno sporočilo na določen naslov. Ta možnost se lahko po potrebi ponovi. <option
>--exec</option
>, <option
>--exec-display</option
> in <option
>--file</option
> s to možnostjo ni mogoče določiti. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> in <option
>--colorfg</option
> se s to možnostjo ne upoštevajo.</entry>
</row>
<row>
  <entry
><option
>-n</option
>, <option
>--name <replaceable
>name</replaceable
></option
></entry>
  <entry
>Določite ime, ki vam bo pomagalo prepoznati alarm.</entry>
</row>
<row>
  <entry
><option
>-N</option
>, <option
>--notify</option
></entry>
  <entry
>Alarm se prikaže kot obvestilo in ne v oknu. <option
>--color</option
>, <option
>--colorfg</option
>, <option
>--play</option
>, <option
>--ack-confirm</option
> in <option
>--auto-close</option
> s to možnostjo ni mogoče določiti.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Določite pot ali &URL; do zvočne datoteke, ki se enkrat predvaja kot zvočni alarm ali ob prikazu alarmnega sporočila. <option
>--play-repeat</option
>, <option
>--beep</option
> in <option
>--speak</option
> ni mogoče določiti s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Navedite pot ali &URL; do zvočne datoteke, ki se bo večkrat predvajala, dokler ne uporabite <guilabel
>Ustavi predvajanje</guilabel
> ali dokler je prikazano alarmno sporočilo. <option
>--play</option
>, <option
>--beep</option
> in <option
>--speak</option
> ni mogoče določiti s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Nastavite alarm na ponavljanje. Navedite ponavljanje s sintakso iCalendar (opredeljeno v <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>), &eg; <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. <option
>--until</option
> s to možnostjo ni mogoče določiti.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>count</replaceable
></option
></entry>
  <entry
>Nastavite število ponovitev sprožitve alarma ali, če je z možnostjo <option
>--recurrence</option
> določeno ponavljanje, število ponovitev sprožitve alarma vsakič, ko ga aktivira <option
>--recurrence</option
> (&ie; ponovitev znotraj ponavljanja). Če možnosti <option
>--recurrence</option
> ni, določite -1, da se alarm ponavlja za nedoločen čas. <option
>--interval</option
> mora biti, <option
>--until</option
> pa ne more biti določen s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>period</replaceable
></option
></entry>
  <entry
>Izpiše opozorilni alarm v določenem časovnem obdobju pred ali po glavnem alarmu in vsakem od njegovih ponovitev (če obstajajo). <replaceable
>obdobje</replaceable
> je določeno v enaki obliki, kot je opisano za <option
>--late-cancel</option
>. Privzeto se opomnik prikaže pred alarmom. Če želite določiti opomnik po alarmu, uporabite predpono <replaceable
>obdobje</replaceable
> z <replaceable
>+</replaceable
>, &eg; +3D. Te možnosti ni mogoče določiti z možnostmi <option
>--exec</option
>, <option
>--mail</option
> ali <option
>--reminder-once</option
>.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>period</replaceable
></option
></entry>
  <entry
>Enkrat sproži alarm za opomnik v določenem časovnem obdobju pred ali po prvi ponovitvi alarma. Pred naslednjimi ponovitvami (če obstajajo) ali po njih se ne prikaže noben opomnik. <replaceable
>obdobje</replaceable
> je določeno v enaki obliki, kot je opisana za <option
>--option
>-reminder</option
>. Te možnosti ni mogoče določiti z možnostmi <option
>--exec</option
>, <option
>--mail</option
> ali <option
>--reminder</option
>.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Izgovori sporočilo, ko se prikaže. Ta možnost zahteva, da je bil program &kalarm; zgrajen z omogočenim govorom in da je modul &Qt; Speech nameščen in deluje. <option
>--beep</option
>, <option
>--play</option
> in <option
>--play-repeat</option
> ni mogoče določiti s to možnostjo.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>zadeva</replaceable
></option
></entry>
  <entry
>Vsebinska vrstica e-pošte. <option
>--mail</option
> mora biti določena s to možnostjo.</entry>
</row>
<!-- test-set-time time (debug mode)-->
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>date/time</replaceable
></option
></entry>
  <entry
>Sprožite alarm na določen datum ali ob določenem datumu/času. Navedite datum brez časa v obliki <replaceable
>llll-mm-dd[ TZ]</replaceable
>; navedite datum in čas z <replaceable
>[[[llll-]mm-]dd-]hh:mm[ TZ]</replaceable
> (če je izpuščen, so v datumskih poljih privzete vrednosti za danes). Če časovni pas ni določen, se predpostavlja lokalni sistemski časovni pas. Če je prisoten določevalec časovnega pasu <replaceable
>TZ</replaceable
>, je to lahko ime sistemskega časovnega pasu (&eg; <userinput
>Evropa/London</userinput
>) ali <userinput
>UTC</userinput
>, ki predstavlja časovni pas UTC.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>percentage</replaceable
></option
></entry>
  <entry
>Nastavite glasnost zvoka za predvajanje zvočne datoteke. To možnost lahko uporabite le, če je določena možnost <option
>--play</option
> ali <option
>--play-repeat</option
>.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>date/time</replaceable
></option
></entry>
  <entry
>Ponavlja alarm do določenega datuma ali datuma/časa. Določite datum ali datum/čas z isto sintakso kot za <option
>--time</option
>. Upoštevajte, da če je podan <option
>--time</option
>, bo časovni pas vzet iz njegove vrednosti in noben časovni pas ne sme biti vključen v vrednost <option
>--until</option
>. <option
>--interval</option
> mora biti, in <option
>--repeat</option
> in <option
>--recurrence</option
> ni mogoče določiti s to možnostjo.</entry>
</row>
<row>
  <entry
><replaceable
>sporočilo</replaceable
></entry>
  <entry
>Besedilo sporočila za prikaz ali, če je podana <option
>--mail</option
>, telo e-poštnega sporočila.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Bodisi besedilo sporočila, <option
>--file</option
>, <option
>--exec</option
>, <option
>--exec-display</option
>, <option
>--play</option
> ali <option
>--play-repeat</option
> je treba določiti; razen kot je navedeno zgoraj, so vse možnosti neobvezne.</para>

<para
>Dva alternativna primera, ki prikazujeta večvrstično sporočilo z rdečim ozadjem ob 22. uri. 27. tega meseca so:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>red</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Spomni se \nUSTAVITI"</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>0xFF0000</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Spomni se \nUSTAVITI"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>

<sect1 id="cmdline-other">
<title
>Druge možnosti</title>

<para
>Naslednje možnosti se uporabljajo za izvajanje različnih funkcij, vključno s prikazom <link linkend="alarm-edit-dlg"
>pogovornega okna za urejanje alarma</link
>.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Možnost</entry>
  <entry
>Opis</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--edit <replaceable
>dogodekID</replaceable
></option
></entry>
  <entry
>Prikaže pogovorno okno za urejanje alarma, da uredite alarm z navedenim ID-jem dogodka. ID dogodka je enoličen ID dogodka, ki mu je neobvezno predpona ime konfiguracije ali številčni ID vira, ki vsebuje dogodek, v obliki <replaceable
>[resourceID:]eventUID</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Prikaže pogovorno okno za urejanje alarma, da uredite nov zvočni alarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>Prikaže pogovorno okno Urejanje alarma, da uredite nov ukazni alarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Prikaže pogovorno okno za urejanje alarma, če želite urediti nov prikaz alarma.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Prikaže pogovorno okno za urejanje alarma, da uredite nov e-poštni alarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>imePredloge</replaceable
></option
></entry>
  <entry
>Prikaže pogovorno okno za urejanje alarma, prednastavljeno s predlogo alarma z določenim namenom, da uredite nov alarm.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Oddaj seznam načrtovanih alarmov v <filename
>stdout</filename
>. Seznam prikazuje kratke podrobnosti vsakega čakajočega alarma: njegov identifikator vira, UID, naslednji načrtovani čas in besedilo ali datoteko sporočila.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Prikaže &kalarm; kot ikono v sistemski vrstici.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Onemogoči spremljanje vseh alarmov.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Poglejte tudi:</para>
<simplelist>
<member
>kf6options(7)</member>
<member
>qt6options(7)</member>
</simplelist>

</sect1>

</chapter>

<chapter id="developers">
<title
>Vodnik za razvijalce za &kalarm;</title>

<para
>&kalarm; nudi vmesnik, ki omogoča drugim aplikacijam, da zahtevajo naslednje funkcije:</para>

<itemizedlist>
<listitem
><para
>načrtuj nov alarm</para
></listitem>
<listitem
><para
>preklic že načrtovanega alarma</para
></listitem>
<listitem
><para
>sprožitev že načrtovanega alarma</para
></listitem>
<listitem
><para
>prikaz pogovornega okna za urejanje alarma</para
></listitem>
<listitem
><para
>naštetje načrtovanih alarmov</para
></listitem>
</itemizedlist>

<para
>Vsaka od zgornjih funkcij je implementirana z &DBus; klic in z ukazno vrstico. &DBus; klice je treba uporabiti prednostno, če &kalarm; že teče.</para>

<sect1 id="dbus-interface">
<title
>&DBus; Vmesnik</title>

<para
>Vsi klici &DBus;, opisani v tem dokumentu, se izvajajo v &kalarm; <constant
>/kalarm</constant
> &DBus; objektni poti. Vmesnik je opredeljen v datotekah <filename
>org.kde.kalarm.kalarm.xml</filename
> in <filename
>kalarmiface.h</filename
>.</para>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>preklic že načrtovanega alarma.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>dogodekID</parameter
></term>
<listitem>
<para
>Določa edinstven ID dogodka, ki ga je treba preklicati, po želji s predpono namena konfiguracije ali številčnega ID vira, ki vsebuje dogodek, v obliki <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>cancelEvent()</function
> je klic &DBus; za preklic določenega alarma. &kalarm; izbriše alarm iz koledarja, ne da bi ga prikazal ali izvedel.</para>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>sproži že načrtovani alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void sprožiDogodek(const QString&amp; <replaceable
>dogodekID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>dogodekID</parameter
></term>
<listitem>
<para
>Določa edinstven ID dogodka, ki se sproži, po želji s predpono namena konfiguracije ali številčnega ID vira, ki vsebuje dogodek, v obliki <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>sprožiDogodek()</function
> je klic &DBus; za sprožitev takojšnjega prikaza ali izvedbe določenega alarma (ne glede na to, za kateri čas je načrtovan). &kalarm; pridobi alarm iz koledarja in ga nato prikaže ali izvede.</para>

<para
>Če je alarm že zapadel, se s funkcijo &kalarm; izbrišejo vse načrtovane ponovitve alarma do trenutnega časa, in če ni več ponovitev alarma, se alarm izbriše iz koledarja. Če alarm še ni zapadel, se njegovi načrtovani dogodki ne spremenijo.</para>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>načrtovanje novega alarmnega sporočila.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>ime</replaceable
>,
                     const QString&amp; <replaceable
>sporočilo</replaceable
>,
                     const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                     int <replaceable
>pozenZaključek</replaceable
>,
                     unsigned <replaceable
>zastavice</replaceable
>, 
                     const QString&amp; <replaceable
>bgBarva</replaceable
>, 
                     const QString&amp; <replaceable
>fgBarva</replaceable
>, 
                     const QString&amp; <replaceable
>pisava</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>opomnikMins</replaceable
>, 
                     const QString&amp; <replaceable
>ponovitev</replaceable
>,
                     int <replaceable
>podIntervalPonovitve</replaceable
>, 
                     int <replaceable
>podŠteviloPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>ime</replaceable
>,
                     const QString&amp; <replaceable
>sporočilo</replaceable
>,
                     const QString&amp; <replaceable
>začetekDatumČas</replaceable
>, 
                     int <replaceable
>pozenZaključek</replaceable
>,
                     unsigned <replaceable
>zastavice</replaceable
>, 
                     const QString&amp; <replaceable
>bgBarva</replaceable
>, 
                     const QString&amp; <replaceable
>fgBarva</replaceable
>, 
                     const QString&amp; <replaceable
>pisava</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>opomnikMins</replaceable
>, 
                     int <replaceable
>vrstaPonovitve</replaceable
>, 
                     int <replaceable
>intervalPonovitve</replaceable
>, 
                     int <replaceable
>številoPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>ime</replaceable
>,
                     const QString&amp; <replaceable
>sporočilo</replaceable
>,
                     const QString&amp; <replaceable
>začetekDatumČas</replaceable
>, 
                     int <replaceable
>pozenZaključek</replaceable
>, 
                     unsigned <replaceable
>zastavice</replaceable
>, 
                     const QString&amp; <replaceable
>bgBarva</replaceable
>, 
                     const QString&amp; <replaceable
>fgBarva</replaceable
>, 
                     const QString&amp; <replaceable
>pisava</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>opomnikMins</replaceable
>, 
                     int <replaceable
>vrstaPonovitve</replaceable
>, 
                     int <replaceable
>intervalPonovitve</replaceable
>, 
                     const QString&amp; <replaceable
>konecDatumČas</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>ime</parameter
></term>
<listitem>
<para
>Določa neobvezno ime za alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>sporočilo</parameter
></term>
<listitem>
<para
>Določa besedilo sporočila, ki ga je treba načrtovati, ali, če je pri <parameter
>zastavice</parameter
> nastavljen bit <userinput
>DISPLAY_COMMAND</userinput
>, določa ukazno vrstico, ki se izvede za ustvarjanje besedila sporočila.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>začetekDatumČas</parameter
></term>
<listitem>
<para
>Določa načrtovani datum ali datum in čas, ko naj se sporočilo prikaže. Za alarm samo z datumom mora biti niz v obliki <replaceable
>RRRR-MM-DD[ TZ]</replaceable
> (kot ga vrne <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Za alarm z datumom in časom mora biti niz v obliki <replaceable
>LLLL-MM-DDTHH:MM[:SS][ TZ]</replaceable
> (kot ga vrne <methodname
>QDateTname::toString(Qt::ISODate)</methodname
>) ali <replaceable
>HH:MM[:SS]</replaceable
> (kot ga vrne <methodname
>QTname::toString(Qt::ISODate)</methodname
>). Če datum ni naveden, se uporabi današnji datum. Upoštevajte, da se vse vrednosti sekund ne upoštevajo.</para>

<para
>Če časovni pas ni določen, se predpostavlja lokalni sistemski časovni pas. Če je prisoten določevalec časovnega pasu <replaceable
>TZ</replaceable
>, je to lahko ime sistemskega časovnega pasu (&eg; <userinput
>Evropa/London</userinput
>) ali <userinput
>UTC</userinput
>, ki predstavlja časovni pas UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>pozenZaključek</parameter
></term>
<listitem>
<para
>Povzroči preklic alarma, če ga ni mogoče sprožiti v določenem številu minut po načrtovanem času alarma. Če je vrednost 0, alarm ne bo preklican ne glede na to, kako pozno je bil sprožen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zastavice</parameter
></term>
<listitem>
<para
>Določa logično ALI želenih alarmnih zastavic. Biti zastavic so tisti, ki so opredeljeni v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Upoštevajte, da se vsi biti zastavic ne uporabljajo za alarmna sporočila.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgBarva</parameter
></term>
<listitem>
<para
>Določa barvo ozadja za prikaz sporočila. Niz je lahko v obliki <quote
>#RRGGBB</quote
> (kot ga vrne <methodname
>QColor::name()</methodname
>), kjer so RR, GG in BB dvomestne šestnajstmestne vrednosti za rdečo, zeleno in modro. Alternativno je lahko niz v kateri koli drugi obliki, ki jo sprejme <methodname
>QColor::setNamedColor()</methodname
>, na primer name iz baze barv X (&eg; <quote
>rdeča</quote
> ali <quote
>modra</quote
>). Nastavite niz na nič, da določite trenutno privzeto barvo ozadja.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fgBarva</parameter
></term>
<listitem>
<para
>Določa barvo ospredja za prikaz sporočila. Oblika niza je enaka kot za <parameter
>bgBarva</parameter
>, lahko pa niz nastavite na nič, da določite trenutno privzeto barvo ospredja.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>pisava</parameter
></term>
<listitem>
<para
>Določa pisavo za prikaz sporočila. Oblika niza je takšna, kot jo izpiše <methodname
>QFont::toString()</methodname
>. Niz nastavite na nič, če želite uporabiti privzeto pisavo sporočila, ki je aktualna v času, ko je sporočilo prikazano.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zvočniURL</parameter
></term>
<listitem>
<para
>Določa zvočno datoteko, ki se bo predvajala ob prikazu sporočila. Vrednost nastavite na nič, če ne želite predvajati nobene zvočne datoteke.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>opomnikMins</parameter
></term>
<listitem>
<para
>Določa število minut pred glavnim alarmom in vsako njegovo ponovitvijo (če obstaja), ko naj se prikaže opozorilni alarm. Določite negativno vrednost za opomnik, ki se prikaže po glavnem alarmu. Navedite 0, če opomnik ni potreben.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ponovitev</parameter
></term>
<listitem>
<para
>Določa redno ponavljanje za alarm z uporabo sintakse iCalendar, kot je opredeljena v <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na primer, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> bi določil 4 ponovitve v trnamesečnih intervalih na zadnji ponedeljek v mesecu. Za alarm, ki se ne ponavlja, določite prazen niz.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vrstaPonovitve</parameter
></term>
<listitem>
<para
>Določa vrsto ponovitve za alarm. Dovoljene vrednosti so MINUTNO, DNEVNO, TEDNSKO, MESEČNO, LETNO. Opredeljeni so v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Mesečna ponavljanja so tipa dan v mesecu, letna ponavljanja pa tipa datum v letu, pri čemer je datum v obeh primerih vzet iz parametra <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število obdobij (minut/dni/teden/mesec/leto, kot je določeno s parametrom <parameter
>recurType</parameter
>) med ponovitvami alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>številoPonovitev</parameter
></term>
<listitem>
<para
>Določa, kolikokrat naj se alarm ponovi. Če želite alarm ponavljati za nedoločen čas, navedite -1.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>konecDatumČas</parameter
></term>
<listitem>
<para
>Določa končni datum ali datum in uro za ponovitve alarma. Če <parameter
>startDateTname</parameter
> vsebuje čas, mora tudi ta parameter vsebovati čas; če <parameter
>startDateTname</parameter
> vsebuje samo datum, mora tudi ta parameter vsebovati samo datum. Ne sme vsebovati označevalca časovnega pasu; za interpretacijo vrednosti tega parametra se uporabi isti časovni pas kot za <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podIntervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število minut med posameznimi ponovitvami alarma. Navedite 0, če želite, da ni ponovitev. Ne upošteva se, če ponovitev ni določena.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podŠteviloPonovitev</parameter
></term>
<listitem>
<para
>Določa število ponovitev alarma, vključno z začetnim pojavom.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Opis</title>
<para
><function
>scheduleMessage()</function
> je klic &DBus; za načrtovanje prikazovanja določenega alarmnega sporočila ob določenem datumu in času. Ima tri oblike. Najsplošnejša oblika omogoča določitev poljubnega ponavljanja; uporabite jo tudi za alarme, ki se ne ponavljajo. Drugi obrazci omogočajo priročen dostop do omejenega nabora vrst ponovitev alarma, pri čemer ena določa število ponovitev, druga pa končni čas.</para>

<para
>Če je načrtovani čas (vključno z morebitnimi ponovitvami) že potekel, &kalarm; takoj prikaže sporočilo (razen če vrednost <parameter
>lateCancel</parameter
> kaže, da je za prikaz alarma že prepozno; v tem primeru &kalarm; ignorira zahtevo). Če je načrtovani čas (ali ponovitev) v prihodnosti, funkcija &kalarm; doda alarmno sporočilo v privzeti aktivni koledar alarmov za poznejši prikaz.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>načrtovanje novega alarma, ki prikaže vsebino besedilne ali slikovne datoteke.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>ime</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                  int <replaceable
>pozenZaključek</replaceable
>,
                  unsigned <replaceable
>zastavice</replaceable
>,
                  const QString&amp; <replaceable
>bgBarva</replaceable
>,
                  const QString&amp; <replaceable
>zvočniURL</replaceable
>,
                  int <replaceable
>opomnikMins</replaceable
>,
                  const QString&amp; <replaceable
>ponovitev</replaceable
>,
                  int <replaceable
>podIntervalPonovitve</replaceable
>, 
                  int <replaceable
>podŠteviloPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>ime</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                  int <replaceable
>pozenZaključek</replaceable
>,
                  unsigned <replaceable
>zastavice</replaceable
>,
                  const QString&amp; <replaceable
>bgBarva</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>opomnikMins</replaceable
>,
                  int <replaceable
>vrstaPonovitve</replaceable
>,
                  int <replaceable
>intervalPonovitve</replaceable
>,
                  int <replaceable
>številoPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>ime</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                  int <replaceable
>pozenZaključek</replaceable
>,
                  unsigned <replaceable
>zastavice</replaceable
>,
                  const QString&amp; <replaceable
>bgBarva</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>opomnikMins</replaceable
>,
                  int <replaceable
>vrstaPonovitve</replaceable
>,
                  int <replaceable
>intervalPonovitve</replaceable
>,
                  int <replaceable
>številoPonovitev</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>ime</parameter
></term>
<listitem>
<para
>Določa neobvezno ime za alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>URL</parameter
></term>
<listitem>
<para
><parameter
>URL</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>začetekDatumČas</parameter
></term>
<listitem>
<para
>Določa načrtovani datum ali datum in čas, ko naj se sporočilo prikaže. Za alarm samo z datumom mora biti niz v obliki <replaceable
>RRRR-MM-DD[ TZ]</replaceable
> (kot ga vrne <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Za alarm z datumom in časom mora biti niz v obliki <replaceable
>LLLL-MM-DDTHH:MM[:SS][ TZ]</replaceable
> (kot ga vrne <methodname
>QDateTname::toString(Qt::ISODate)</methodname
>) ali <replaceable
>HH:MM[:SS]</replaceable
> (kot ga vrne <methodname
>QTname::toString(Qt::ISODate)</methodname
>). Če datum ni naveden, se uporabi današnji datum. Upoštevajte, da se vse vrednosti sekund ne upoštevajo.</para>

<para
>Če časovni pas ni določen, se predpostavlja lokalni sistemski časovni pas. Če je prisoten določevalec časovnega pasu <replaceable
>TZ</replaceable
>, je to lahko ime sistemskega časovnega pasu (&eg; <userinput
>Evropa/London</userinput
>) ali <userinput
>UTC</userinput
>, ki predstavlja časovni pas UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>pozenZaključek</parameter
></term>
<listitem>
<para
>Povzroči preklic alarma, če ga ni mogoče sprožiti v določenem številu minut po načrtovanem času alarma. Če je vrednost 0, alarm ne bo preklican ne glede na to, kako pozno je bil sprožen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zastavice</parameter
></term>
<listitem>
<para
>Določa logično ALI želenih alarmnih zastavic. Biti zastavic so tisti, ki so opredeljeni v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Upoštevajte, da za datotečne alarme ne veljajo vsi biti zastavic.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgBarva</parameter
></term>
<listitem>
<para
>Določa barvo ozadja za prikaz datoteke. Niz je lahko v obliki <quote
>#RRGGBB</quote
> (kot ga vrne <methodname
>QColor::name()</methodname
>), kjer so RR, GG in BB dvomestne šestnajstmestne vrednosti za rdečo, zeleno in modro. Alternativno je lahko niz v kateri koli drugi obliki, ki jo sprejme <methodname
>QColor::setNamedColor()</methodname
>, na primer name iz baze barv X (&eg; <quote
>rdeča</quote
> ali <quote
>modra</quote
>). Nastavite niz na nič, da določite trenutno privzeto barvo ozadja.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zvočniURL</parameter
></term>
<listitem>
<para
>Določa zvočno datoteko, ki se bo predvajala ob prikazu sporočila. Vrednost nastavite na nič, če ne želite predvajati nobene zvočne datoteke.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>opomnikMins</parameter
></term>
<listitem>
<para
>Določa število minut pred glavnim alarmom in vsako njegovo ponovitvijo (če obstaja), ko naj se prikaže opozorilni alarm. Določite negativno vrednost za opomnik, ki se prikaže po glavnem alarmu. Navedite 0, če opomnik ni potreben.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ponovitev</parameter
></term>
<listitem>
<para
>Določa redno ponavljanje za alarm z uporabo sintakse iCalendar, kot je opredeljena v <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na primer, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> bi določil 4 ponovitve v trnamesečnih intervalih na zadnji ponedeljek v mesecu. Za alarm, ki se ne ponavlja, določite prazen niz.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vrstaPonovitve</parameter
></term>
<listitem>
<para
>Določa vrsto ponovitve za alarm. Dovoljene vrednosti so MINUTNO, DNEVNO, TEDNSKO, MESEČNO, LETNO. Opredeljeni so v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Mesečna ponavljanja so tipa dan v mesecu, letna ponavljanja pa tipa datum v letu, pri čemer je datum v obeh primerih vzet iz parametra <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število obdobij (minut/dni/teden/mesec/leto, kot je določeno s parametrom <parameter
>recurType</parameter
>) med ponovitvami alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>številoPonovitev</parameter
></term>
<listitem>
<para
>Določa, kolikokrat naj se alarm ponovi. Če želite alarm ponavljati za nedoločen čas, navedite -1.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>konecDatumČas</parameter
></term>
<listitem>
<para
>Določa končni datum ali datum in uro za ponovitve alarma. Če <parameter
>startDateTname</parameter
> vsebuje čas, mora tudi ta parameter vsebovati čas; če <parameter
>startDateTname</parameter
> vsebuje samo datum, mora tudi ta parameter vsebovati samo datum. Ne sme vsebovati označevalca časovnega pasu; za interpretacijo vrednosti tega parametra se uporabi isti časovni pas kot za <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podIntervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število minut med posameznimi ponovitvami alarma. Navedite 0, če želite, da ni ponovitev. Ne upošteva se, če ponovitev ni določena.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podŠteviloPonovitev</parameter
></term>
<listitem>
<para
>Določa število ponovitev alarma, vključno z začetnim pojavom.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>
<para
><function
>scheduleFile()</function
> je klic &DBus; za načrtovanje prikaza določene besedilne ali slikovne datoteke ob določenem datumu in času. Razen navedbe poti do datoteke ali &URL; ter opustitve barve in pisave v ospredju je njena uporaba enaka uporabi <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - za več podrobnosti glej opis te funkcije.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>načrtovanje novega alarma, ki izvede ukaz lupine.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>ime</replaceable
>,
                     const QString&amp; <replaceable
>ukaznaVrstica</replaceable
>,
                     const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                     int <replaceable
>pozenZaključek</replaceable
>,
                     unsigned <replaceable
>zastavice</replaceable
>,
                     const QString&amp; <replaceable
>ponovitev</replaceable
>,
                     int <replaceable
>podIntervalPonovitve</replaceable
>, 
                     int <replaceable
>podŠteviloPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>ime</replaceable
>,
                     const QString&amp; <replaceable
>ukaznaVrstica</replaceable
>,
                     const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                     int <replaceable
>pozenZaključek</replaceable
>,
                     unsigned <replaceable
>zastavice</replaceable
>,
                     int <replaceable
>vrstaPonovitve</replaceable
>,
                     int <replaceable
>intervalPonovitve</replaceable
>,
                     int <replaceable
>številoPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>ime</replaceable
>,
                     const QString&amp; <replaceable
>ukaznaVrstica</replaceable
>,
                     const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                     int <replaceable
>pozenZaključek</replaceable
>,
                     unsigned <replaceable
>zastavice</replaceable
>,
                     int <replaceable
>vrstaPonovitve</replaceable
>,
                     int <replaceable
>intervalPonovitve</replaceable
>,
                     const QString&amp; <replaceable
>konecDatumČas</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>ime</parameter
></term>
<listitem>
<para
>Določa neobvezno ime za alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ukaznaVrstica</parameter
></term>
<listitem>
<para
>Določa ukaz, katerega izvajanje je treba načrtovati. Parameter <parameter
>flags</parameter
> označuje, ali ta parameter vsebuje ukazno vrstico lupine ali ukazno skripto.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>začetekDatumČas</parameter
></term>
<listitem>
<para
>Določa načrtovani datum ali datum in čas, ko naj se sporočilo prikaže. Za alarm samo z datumom mora biti niz v obliki <replaceable
>RRRR-MM-DD[ TZ]</replaceable
> (kot ga vrne <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Za alarm z datumom in časom mora biti niz v obliki <replaceable
>LLLL-MM-DDTHH:MM[:SS][ TZ]</replaceable
> (kot ga vrne <methodname
>QDateTname::toString(Qt::ISODate)</methodname
>) ali <replaceable
>HH:MM[:SS]</replaceable
> (kot ga vrne <methodname
>QTname::toString(Qt::ISODate)</methodname
>). Če datum ni naveden, se uporabi današnji datum. Upoštevajte, da se vse vrednosti sekund ne upoštevajo.</para>

<para
>Če časovni pas ni določen, se predpostavlja lokalni sistemski časovni pas. Če je prisoten določevalec časovnega pasu <replaceable
>TZ</replaceable
>, je to lahko ime sistemskega časovnega pasu (&eg; <userinput
>Evropa/London</userinput
>) ali <userinput
>UTC</userinput
>, ki predstavlja časovni pas UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>pozenZaključek</parameter
></term>
<listitem>
<para
>Povzroči preklic alarma, če ga ni mogoče sprožiti v določenem številu minut po načrtovanem času alarma. Če je vrednost 0, alarm ne bo preklican ne glede na to, kako pozno je bil sprožen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zastavice</parameter
></term>
<listitem>
<para
>Določa logično ALI želenih alarmnih zastavic. Biti zastavic so tisti, ki so opredeljeni v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Upoštevajte, da se za alarmne ukaze ne uporabljajo vsi biti zastavic.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ponovitev</parameter
></term>
<listitem>
<para
>Določa redno ponavljanje za alarm z uporabo sintakse iCalendar, kot je opredeljena v <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na primer, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> bi določil 4 ponovitve v trnamesečnih intervalih na zadnji ponedeljek v mesecu. Za alarm, ki se ne ponavlja, določite prazen niz.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vrstaPonovitve</parameter
></term>
<listitem>
<para
>Določa vrsto ponovitve za alarm. Dovoljene vrednosti so MINUTNO, DNEVNO, TEDNSKO, MESEČNO, LETNO. Opredeljeni so v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Mesečna ponavljanja so tipa dan v mesecu, letna ponavljanja pa tipa datum v letu, pri čemer je datum v obeh primerih vzet iz parametra <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število obdobij (minut/dni/teden/mesec/leto, kot je določeno s parametrom <parameter
>recurType</parameter
>) med ponovitvami alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>številoPonovitev</parameter
></term>
<listitem>
<para
>Določa, kolikokrat naj se alarm ponovi. Če želite alarm ponavljati za nedoločen čas, navedite -1.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>konecDatumČas</parameter
></term>
<listitem>
<para
>Določa končni datum ali datum in uro za ponovitve alarma. Če <parameter
>startDateTname</parameter
> vsebuje čas, mora tudi ta parameter vsebovati čas; če <parameter
>startDateTname</parameter
> vsebuje samo datum, mora tudi ta parameter vsebovati samo datum. Ne sme vsebovati označevalca časovnega pasu; za interpretacijo vrednosti tega parametra se uporabi isti časovni pas kot za <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podIntervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število minut med posameznimi ponovitvami alarma. Navedite 0, če želite, da ni ponovitev. Ne upošteva se, če ponovitev ni določena.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podŠteviloPonovitev</parameter
></term>
<listitem>
<para
>Določa število ponovitev alarma, vključno z začetnim pojavom.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>
<para
><function
>scheduleCommand()</function
> je klic &DBus; za načrtovanje izvajanja določene ukazne vrstice lupine ali ukazne skripte ob določenem datumu in času. Razen določitve ukaza in izpustitve parametrov barve sporočila, pisave in zvočne datoteke je njegova uporaba enaka kot pri <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - za več podrobnosti glej opis te funkcije.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>načrtovanje novega alarma, ki pošlje e-poštno sporočilo.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>ime</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>naslovi</replaceable
>,
                   const QString&amp; <replaceable
>zadeva</replaceable
>,
                   const QString&amp; <replaceable
>sporočilo</replaceable
>,
                   const QString&amp; <replaceable
>priloge</replaceable
>,
                   const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                   int <replaceable
>pozenZaključek</replaceable
>,
                   unsigned <replaceable
>zastavice</replaceable
>,
                   const QString&amp; <replaceable
>ponovitev</replaceable
>,
                   int <replaceable
>podIntervalPonovitve</replaceable
>, 
                   int <replaceable
>podŠteviloPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>ime</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>naslovi</replaceable
>,
                   const QString&amp; <replaceable
>zadeva</replaceable
>,
                   const QString&amp; <replaceable
>sporočilo</replaceable
>,
                   const QString&amp; <replaceable
>priloge</replaceable
>,
                   const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                   int <replaceable
>pozenZaključek</replaceable
>,
                   unsigned <replaceable
>zastavice</replaceable
>,
                   int <replaceable
>vrstaPonovitve</replaceable
>,
                   int <replaceable
>intervalPonovitve</replaceable
>,
                   int <replaceable
>številoPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>ime</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>naslovi</replaceable
>,
                   const QString&amp; <replaceable
>zadeva</replaceable
>,
                   const QString&amp; <replaceable
>sporočilo</replaceable
>,
                   const QString&amp; <replaceable
>priloge</replaceable
>,
                   const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                   int <replaceable
>pozenZaključek</replaceable
>, 
                   unsigned <replaceable
>zastavice</replaceable
>,
                   int <replaceable
>vrstaPonovitve</replaceable
>,
                   int <replaceable
>intervalPonovitve</replaceable
>,
                   const QString&amp; <replaceable
>endTname</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>ime</parameter
></term>
<listitem>
<para
>Določa neobvezno ime za alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>odID</parameter
></term>
<listitem>
<para
>Identiteta &kmail;, ki se uporabi kot pošiljatelj e-pošte. Če je prazen, bo e-poštni naslov pošiljatelja tisti, ki je nastavljen v <link linkend="preferences-email"
>Email konfiguracija</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>naslovi</parameter
></term>
<listitem>
<para
>Seznam e-poštnih naslovov prejemnikov, ločenih z vejico.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zadeva</parameter
></term>
<listitem>
<para
>Določa naslovno vrstico e-poštnega sporočila.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>sporočilo</parameter
></term>
<listitem>
<para
>Določa vsebino e-poštnega sporočila.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>priloge</parameter
></term>
<listitem>
<para
>Z vejico ločen seznam poti ali naslovov &URL; za datoteke, ki jih želite poslati kot priponke e-pošte.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>začetekDatumČas</parameter
></term>
<listitem>
<para
>Določa načrtovani datum ali datum in čas, ko naj se sporočilo prikaže. Za alarm samo z datumom mora biti niz v obliki <replaceable
>RRRR-MM-DD[ TZ]</replaceable
> (kot ga vrne <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Za alarm z datumom in časom mora biti niz v obliki <replaceable
>LLLL-MM-DDTHH:MM[:SS][ TZ]</replaceable
> (kot ga vrne <methodname
>QDateTname::toString(Qt::ISODate)</methodname
>) ali <replaceable
>HH:MM[:SS]</replaceable
> (kot ga vrne <methodname
>QTname::toString(Qt::ISODate)</methodname
>). Če datum ni naveden, se uporabi današnji datum. Upoštevajte, da se vse vrednosti sekund ne upoštevajo.</para>

<para
>Če časovni pas ni določen, se predpostavlja lokalni sistemski časovni pas. Če je prisoten določevalec časovnega pasu <replaceable
>TZ</replaceable
>, je to lahko ime sistemskega časovnega pasu (&eg; <userinput
>Evropa/London</userinput
>) ali <userinput
>UTC</userinput
>, ki predstavlja časovni pas UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>pozenZaključek</parameter
></term>
<listitem>
<para
>Povzroči preklic alarma, če ga ni mogoče sprožiti v določenem številu minut po načrtovanem času alarma. Če je vrednost 0, alarm ne bo preklican ne glede na to, kako pozno je bil sprožen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zastavice</parameter
></term>
<listitem>
<para
>Določa logično ALI želenih alarmnih zastavic. Biti zastavic so tisti, ki so opredeljeni v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Upoštevajte, da se vsi biti zastavic ne uporabljajo za alarme elektronske pošte.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ponovitev</parameter
></term>
<listitem>
<para
>Določa redno ponavljanje za alarm z uporabo sintakse iCalendar, kot je opredeljena v <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na primer, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> bi določil 4 ponovitve v trnamesečnih intervalih na zadnji ponedeljek v mesecu. Za alarm, ki se ne ponavlja, določite prazen niz.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vrstaPonovitve</parameter
></term>
<listitem>
<para
>Določa vrsto ponovitve za alarm. Dovoljene vrednosti so MINUTNO, DNEVNO, TEDNSKO, MESEČNO, LETNO. Opredeljeni so v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Mesečna ponavljanja so tipa dan v mesecu, letna ponavljanja pa tipa datum v letu, pri čemer je datum v obeh primerih vzet iz parametra <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število obdobij (minut/dni/teden/mesec/leto, kot je določeno s parametrom <parameter
>recurType</parameter
>) med ponovitvami alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>številoPonovitev</parameter
></term>
<listitem>
<para
>Določa, kolikokrat naj se alarm ponovi. Če želite alarm ponavljati za nedoločen čas, navedite -1.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>konecDatumČas</parameter
></term>
<listitem>
<para
>Določa končni datum ali datum in uro za ponovitve alarma. Če <parameter
>startDateTname</parameter
> vsebuje čas, mora tudi ta parameter vsebovati čas; če <parameter
>startDateTname</parameter
> vsebuje samo datum, mora tudi ta parameter vsebovati samo datum. Ne sme vsebovati označevalca časovnega pasu; za interpretacijo vrednosti tega parametra se uporabi isti časovni pas kot za <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podIntervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število minut med posameznimi ponovitvami alarma. Navedite 0, če želite, da ni ponovitev. Ne upošteva se, če ponovitev ni določena.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podŠteviloPonovitev</parameter
></term>
<listitem>
<para
>Določa število ponovitev alarma, vključno z začetnim pojavom.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>
<para
><function
>scheduleEmail()</function
> je klic &DBus; za načrtovanje pošiljanja določenega e-poštnega sporočila na določen datum in ob določeni uri. Razen določitve glave in vsebine e-pošte ter izpustitve parametrov barve sporočila, pisave in zvočne datoteke je njena uporaba enaka kot pri <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - za več podrobnosti glejte opis te funkcije.</para>
</refsect1>
</refentry>


<refentry id="scheduleAudio">
<refmeta>
<refentrytitle
>scheduleAudio</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleAudio</refname>
<refpurpose
>načrtovanje novega alarma, ki izvede ukaz lupine.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>ime</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>odstotekGlasnosti</replaceable
>,
                   const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                   int <replaceable
>pozenZaključek</replaceable
>,
                   unsigned <replaceable
>zastavice</replaceable
>,
                   const QString&amp; <replaceable
>ponovitev</replaceable
>,
                   int <replaceable
>podIntervalPonovitve</replaceable
>, 
                   int <replaceable
>podŠteviloPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>ime</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>odstotekGlasnosti</replaceable
>,
                   const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                   int <replaceable
>pozenZaključek</replaceable
>,
                   unsigned <replaceable
>zastavice</replaceable
>,
                   int <replaceable
>vrstaPonovitve</replaceable
>,
                   int <replaceable
>intervalPonovitve</replaceable
>,
                   int <replaceable
>številoPonovitev</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>ime</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>odstotekGlasnosti</replaceable
>,
                   const QString&amp; <replaceable
>začetekDatumČas</replaceable
>,
                   int <replaceable
>pozenZaključek</replaceable
>,
                   unsigned <replaceable
>zastavice</replaceable
>,
                   int <replaceable
>vrstaPonovitve</replaceable
>,
                   int <replaceable
>intervalPonovitve</replaceable
>,
                   const QString&amp; <replaceable
>konecDatumČas</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>ime</parameter
></term>
<listitem>
<para
>Določa neobvezno ime za alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zvočniURL</parameter
></term>
<listitem>
<para
>Določi zvočno datoteko, ki bo predvajana.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>odstotekGlasnosti</parameter
></term>
<listitem>
<para
>Določa raven glasnosti, ki se uporabi, kot odstotek polne glasnosti. Navedite -1, če želite uporabiti privzeti zvezek.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>začetekDatumČas</parameter
></term>
<listitem>
<para
>Določa načrtovani datum ali datum in čas, ko naj se sporočilo prikaže. Za alarm samo z datumom mora biti niz v obliki <replaceable
>RRRR-MM-DD[ TZ]</replaceable
> (kot ga vrne <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Za alarm z datumom in časom mora biti niz v obliki <replaceable
>LLLL-MM-DDTHH:MM[:SS][ TZ]</replaceable
> (kot ga vrne <methodname
>QDateTname::toString(Qt::ISODate)</methodname
>) ali <replaceable
>HH:MM[:SS]</replaceable
> (kot ga vrne <methodname
>QTname::toString(Qt::ISODate)</methodname
>). Če datum ni naveden, se uporabi današnji datum. Upoštevajte, da se vse vrednosti sekund ne upoštevajo.</para>

<para
>Če časovni pas ni določen, se predpostavlja lokalni sistemski časovni pas. Če je prisoten določevalec časovnega pasu <replaceable
>TZ</replaceable
>, je to lahko ime sistemskega časovnega pasu (&eg; <userinput
>Evropa/London</userinput
>) ali <userinput
>UTC</userinput
>, ki predstavlja časovni pas UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>pozenZaključek</parameter
></term>
<listitem>
<para
>Povzroči preklic alarma, če ga ni mogoče sprožiti v določenem številu minut po načrtovanem času alarma. Če je vrednost 0, alarm ne bo preklican ne glede na to, kako pozno je bil sprožen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>zastavice</parameter
></term>
<listitem>
<para
>Določa logično ALI želenih alarmnih zastavic. Biti zastavic so tisti, ki so opredeljeni v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Upoštevajte, da se za alarmne ukaze ne uporabljajo vsi biti zastavic.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ponovitev</parameter
></term>
<listitem>
<para
>Določa redno ponavljanje za alarm z uporabo sintakse iCalendar, kot je opredeljena v <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na primer, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> bi določil 4 ponovitve v trnamesečnih intervalih na zadnji ponedeljek v mesecu. Za alarm, ki se ne ponavlja, določite prazen niz.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vrstaPonovitve</parameter
></term>
<listitem>
<para
>Določa vrsto ponovitve za alarm. Dovoljene vrednosti so MINUTNO, DNEVNO, TEDNSKO, MESEČNO, LETNO. Opredeljeni so v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>. Mesečna ponavljanja so tipa dan v mesecu, letna ponavljanja pa tipa datum v letu, pri čemer je datum v obeh primerih vzet iz parametra <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število obdobij (minut/dni/teden/mesec/leto, kot je določeno s parametrom <parameter
>recurType</parameter
>) med ponovitvami alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>številoPonovitev</parameter
></term>
<listitem>
<para
>Določa, kolikokrat naj se alarm ponovi. Če želite alarm ponavljati za nedoločen čas, navedite -1.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>konecDatumČas</parameter
></term>
<listitem>
<para
>Določa končni datum ali datum in uro za ponovitve alarma. Če <parameter
>startDateTname</parameter
> vsebuje čas, mora tudi ta parameter vsebovati čas; če <parameter
>startDateTname</parameter
> vsebuje samo datum, mora tudi ta parameter vsebovati samo datum. Ne sme vsebovati označevalca časovnega pasu; za interpretacijo vrednosti tega parametra se uporabi isti časovni pas kot za <parameter
>startDateTname</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podIntervalPonovitve</parameter
></term>
<listitem>
<para
>Določa število minut med posameznimi ponovitvami alarma. Navedite 0, če želite, da ni ponovitev. Ne upošteva se, če ponovitev ni določena.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>podŠteviloPonovitev</parameter
></term>
<listitem>
<para
>Določa število ponovitev alarma, vključno z začetnim pojavom.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>
<para
><function
>scheduleAudio()</function
> je klic &DBus; za načrtovanje predvajanja določene zvočne datoteke ob določenem datumu in času. Razen določitve glasnosti in izpustitve parametrov barve sporočila in pisave je njena uporaba enaka kot pri <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - za več podrobnosti glejte opis te funkcije.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>uredi</refentrytitle>
</refmeta>
<refnamediv>
<refname
>uredi</refname>
<refpurpose
>Prikažite <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> za urejanje alarma.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool edit(const QString&amp; <replaceable
>dogodekID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>dogodekID</parameter
></term>
<listitem>
<para
>Določa edinstven ID dogodka, ki ga je treba urediti, po želji s predpono namena konfiguracije ali številčnega ID vira, ki vsebuje dogodek, v obliki <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Return value</title>
<para
><returnvalue
>false</returnvalue
>, če določenega alarma ni bilo mogoče najti ali je namenjen samo branju, <returnvalue
>true</returnvalue
> v nasprotnem primeru.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>edit()</function
> je klic &DBus; za prikaz <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarma</link
> za urejanje določenega alarma.</para>

</refsect1>
</refentry>

<refentry id="dbus_editnew">
<refmeta>
<refentrytitle
>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname
>editNew</refname>
<refpurpose
>Prikažite <link linkend="alarm-edit-dlg"
>Pogovorno okno Uredi alarm</link
> za urejanje novega alarma.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool editNew(int <replaceable
>tip</replaceable
>)
</synopsis>
<synopsis
>bool editNew(const QString&amp; <replaceable
>templateName</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametri</title>
<variablelist>
<varlistentry>
<term
><parameter
>vrsta</parameter
></term>
<listitem>
<para
>Določa vrsto alarma. Dovoljene vrednosti so DISPLAY, COMMAND, EMAIL, AUDIO. Opredeljeni so v razredu <classname
>KAlarmIface</classname
> v <filename
>kalarmiface.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>imePredloge</parameter
></term>
<listitem>
<para
>Določa ime predloge alarma, na kateri temelji nov alarm.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Return value</title>
<para
><returnvalue
>false</returnvalue
>, če ima <parameter
>vrsta</parameter
> neveljavno vrednost ali če ni mogoče najti nobene predloge z namenom <parameter
>templateName</parameter
>; <returnvalue
>true</returnvalue
> sicer.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>editNew()</function
> je klic &DBus; za prikaz <link linkend="alarm-edit-dlg"
>Pogovorno okno za urejanje alarma</link
> za urejanje novega alarma. Če je kot parameter določena vrsta alarma, se prikaže prazno pogovorno okno. Če je kot parameter navedeno ime predloge alarma, je pogovorno okno prednastavljeno s podrobnostmi iz predloge.</para>

</refsect1>
</refentry>

<refentry id="dbus_list">
<refmeta>
<refentrytitle
>list</refentrytitle>
</refmeta>
<refnamediv>
<refname
>list</refname>
<refpurpose
>Vračanje seznama načrtovanih alarmov.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString list()
</synopsis>

<refsect2>
<title
>Return value</title>
<para
>Seznam alarmov, ločenih z novimi vrsticami, vsak v obliki <returnvalue
><replaceable
>resource_id</replaceable
>:<replaceable
>UID</replaceable
> <replaceable
>čas</replaceable
> <replaceable
>besedilo</replaceable
></returnvalue
></para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>list()</function
> je klic &DBus; za vrnitev niza, ki vsebuje povzetek načrtovanih alarmov. Na seznamu so prikazane kratke podrobnosti o vsakem čakajočem alarmu: identifikator vira, UID, naslednji načrtovani čas in besedilo sporočila ali datoteka.</para>

</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Vmesnik ukazne vrstice</title>

<para
>Na voljo so možnosti ukazne vrstice, ki drugim programom omogočajo zagon programa &kalarm;, če ta še ni zagnan, da sprožijo ali prekličejo načrtovane alarme ali načrtujejo nove alarme. Razlog za uporabo možnosti ukazne vrstice v ta namen je, da če bi se program &kalarm; zagnal brez parametrov ukazne vrstice in nato pošiljal zahteve &DBus;, bi se zagnal v privzetem grafičnem načinu, kar je za medprogramsko zahtevo očitno nezaželeno.</para>

<note
><para
>Programi morajo najprej preveriti, ali je program &kalarm; že zagnan; če je, morajo za zahtevo teh operacij namesto tega uporabiti klice &DBus;.</para
></note>

<para
>Možnosti ukazne vrstice za načrtovanje novega alarma so opisane v poglavju <link linkend="cmdline-operation"
>Operacije ukazne vrstice</link
>. Možnosti za sprožitev in preklic načrtovanih alarmov so naslednje:</para>

<note
><para
>Če želijo, lahko te možnosti ukazne vrstice uporabijo tudi običajni uporabniki (če lahko zagotovijo potrebne podatke o parametrih).</para
></note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Možnost</entry>
  <entry
>Opis</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--cancelEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Prekliči alarm z navedenim ID dogodka. ID dogodka je edinstven ID dogodka, po želji s predpono ID vira, ki vsebuje dogodek, v obliki <replaceable
>[resourceID:]eventUID</replaceable
>. Izvedeno dejanje je enako kot pri klicu <link linkend="cancelEvent"
>cancelEvent()</link
> &DBus;. <option
>--triggerEvent</option
> s to možnostjo ni mogoče določiti.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Sprožite alarm z določenim ID dogodka. ID dogodka je edinstven ID dogodka, po želji s predpono ID vira, ki vsebuje dogodek, v obliki <replaceable
>[resourceID:]eventUID</replaceable
>. Izvedeno dejanje je enako kot pri klicu <link linkend="triggerEvent"
>triggerEvent()</link
> &DBus;. <option
>--cancelEvent</option
> s to možnostjo ni mogoče določiti.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Primeri so:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--triggerEvent <replaceable
>&kalarm;-387486299.702</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--cancelEvent <replaceable
>&kalarm;-388886299.793</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>
</chapter>


<chapter id="faq">
<title
>Vprašanja in odgovori</title>

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Katere konfiguracijske datoteke uporablja &kalarm;?</para>
</question>
<answer>
<para
>konfiguracija &kalarm; je shranjena v naslednjih datotekah v mapi <command
>qtpaths --paths GenericConfigLocation</command
> :</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarmrc</filename
> hrani vaše nastavitve &kalarm;.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarmresources</filename
> vsebuje seznam koledarjev alarmov, ki jih trenutno uporablja &kalarm;.</simpara>
</listitem>
</itemizedlist>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Kje &kalarm; shranjuje svoje alarme?</para>
</question>
<answer>

<para
>Ko je &kalarm; prvič zagnan, ustvari naslednje koledarje alarmov v mapi <command
>qtpaths --paths GenericDataLocation</command
>:</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarm/calendar.ics</filename
>, ki vsebuje aktivne alarme.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/expired.ics</filename
>, ki vsebuje arhivirane alarme.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/template.ics</filename
>, ki vsebuje predloge alarmov.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/displaying.ics</filename
>, ki je posebna koledarska datoteka za podrobnosti o trenutno prikazanih alarmih, ki &kalarm;u ob ponovnem zagonu omogoča, da znova prikaže alarme, ki so bili prikazani, ko se je nazadnje zaustavil.</simpara>
</listitem>
</itemizedlist>

<para
>Te koledarje lahko naknadno zamenjate, razen <filename
>displaying.ics</filename
>, ali ustvarite dodatne koledarje alarmov na kateri koli lokaciji, ki jo izberete. Katere koledarske datoteke so trenutno v uporabi, lahko ugotovite tako, da si ogledate podrobnosti vsakega koledarja na seznamu alarmnih koledarjev.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>V kakšnem tipu datoteke so shranjeni alarmi?</para>
</question>
<answer>
<para
>Koledarske datoteke, v katerih je &kalarm; shranjuje svoje alarme, so besedilne datoteke, katerih tip je določen z dokumentom <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 - Specifikacija jedrnega objekta internetnega koledarja in razporejanja (iCalendar )</ulink
>. To je standardni format, ki ga uporabljajo vse aplikacije kdepim. &kalarm; uporablja določene nestandardne lastnosti v skladu z RFC2445. Ti so dokumentirani v datoteki <filename
>DESIGN-kalarmcalendar.html</filename
>, ki se distribuira skupaj z &kalarm;.</para>
</answer>
</qandaentry>

<qandaentry id="akonadi-plugin">
<question>
<para
>Kakšna je funkcija &kalarm;ovega vtičnika Akonadi?</para>
</question>
<answer>
<para
>&kalarm; uporablja svoj vtičnik Akonadi za zagotavljanje vseh funkcij, ki so odvisne od &akonadi; (storitev za shranjevanje &kde; &PIM; med namizji). Če ta vtičnik ni nameščen in omogočen, &kalarm; ne bo imel naslednjih funkcij: <itemizedlist>
<listitem>
<simpara
>Pošiljanje e-pošte prek &kmail;, zapustitev &Sendmail; kot edina možnost za pošiljanje e-pošte (glejte <link linkend="preferences-email"
>E-poštne nastavitve</link
>).</simpara>
</listitem>
<listitem>
<simpara
>Vlek in spuščanje e-pošte.</simpara>
</listitem>
<listitem>
<simpara
>Izbira e-poštnih naslovov iz &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Uvoz rojstnih dni iz &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Selitev &akonadi; virov koledarja alarmov ob prvem zagonu nove različice &kalarm;.</simpara>
</listitem>
</itemizedlist>
</para>
<para
>Če je vtičnik nameščen, ga lahko omogočite ali onemogočite na zavihku <link linkend="preferences-general"
>Splošno</link
> v pogovornem oknu za konfiguracijo.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Kaj je program <application
>kalarmautostart</application
>?</para>
</question>
<answer>
<para
><application
>kalarmautostart</application
> je majhen pomožni program, katerega funkcija je samodejni zagon &kalarm; ob prijavi.</para>

<para
>&kalarm; običajno obnovi upravljalnik seje ob prijavi (da znova prikaže svoja okna v enakem stanju, kot so bila, ko ste se odjavili). Če pa se ne bi izvajal, ko ste se odjavili, ga upravljalnik seje ne bi zagnal, zato ga je treba samodejno zagnati. Težava je v tem, da ko je aplikacija upravljana seja in se samodejno zažene, ni zagotovila, kaj se bo zgodilo prej. Če se samodejno zažene prvi, bo upravitelju seje preprečil obnovitev stanja aplikacije.</para>

<para
>Da bi se izognili tej težavi, se <application
>kalarmautostart</application
> samodejno zažene ob prijavi namesto &kalarm;. Vse, kar naredi, je, da počaka kratek čas (da zagotovi, da ima upravitelj seje čas za opravljanje svojega dela), preden zažene &kalarm;, na kateri točki se zaključi.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Kako lahko uporabljam &kalarm; na napravi, ki ni &plasma; namizje?</para>
</question>
<answer>
<para
>Za zagon &kalarm; na napravi, ki ni &plasma; namizju, je glavna zahteva zagotoviti, da &kalarm; se samodejno zažene vsakič, ko se prijavite. Podrobnejša navodila so v datoteki <filename
>INSTALL</filename
>, ki je priložena &kalarm;.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Zasluge in licenca</title>

<para
>&kalarm; </para>
<para
>Avtorske pravice za program 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 , 2021, 2022, 2023, 2024 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Dokumentacija avtorsko zaščitena 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2016, 2018, 2019, 2020, 2021, 2022, 2023, 2024 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Prevod: Luka Puhar<email
>puhar.luka@gmail.com</email
></para
> &underFDL; &underGPL; <para
>Zahvala gre avtorju &kde; 1 aplikacija KAlarm, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, ki se je prijazno strinjal, da dovoli ime &kalarm; za uporabo s to aplikacijo, ki je bila na voljo za &kde; 2 naprej. </para>

</chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->

