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

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

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

<bookinfo id="kalarminfo">
<title
>Руководство пользователя &kalarm;</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
>Разработчик</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Олег</firstname
> <surname
>Баталов</surname
> <affiliation
><address
> <email
>olegbatalov@mail.ru</email
> </address
></affiliation
> <contrib
>Перевод на русский язык</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Олеся</firstname
><surname
>Герасименко</surname
><affiliation
><address
><email
>translation-team@basealt.ru</email
></address
></affiliation
><contrib
>Перевод на русский язык</contrib
></othercredit
><othercredit role="translator"
><firstname
>Мария</firstname
><surname
>Шикунова</surname
><affiliation
><address
><email
>translation-team@basealt.ru</email
></address
></affiliation
><contrib
>Перевод на русский язык</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>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2 мая 2022 г.</date>
<releaseinfo
>3.5.0 (KDE Gear 22.08)</releaseinfo>

<abstract>
<para
>&kalarm; — это персональный планировщик показа напоминаний, выполнения команд и отправки писем, разработанный &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim </keyword>
<keyword
>kalarm </keyword>
<keyword
>напоминание</keyword>
<keyword
>напоминание</keyword>
<keyword
>планировщик</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title
>Введение</title>

<para
>&kalarm; позволяет запланировать показ персональных напоминаний, воспроизведение звуковых файлов, выполнение команд и отправку писем.</para>

<para
>В &kalarm; отображается список ожидающих напоминаний с указанием их времени срабатывания и параметров. Возможно создавать новые напоминания или выбирать существующие для изменения или удаления. Также возможно просмотреть список устаревших напоминаний.</para>

<para
>При настройке параметров напоминания возможно выбрать, должно ли оно повторяться и следует ли отменить его в случае невозможности запуска в намеченное время. Для текстовых напоминаний возможно набрать текст сообщения, указать текстовый файл или изображение для отображения, а также команду, вывод которой следует показать. Кроме того, возможно выбрать цвет напоминания, воспроизведение звука или произнесение сообщения.</para>

<para
>Напоминания также возможно запланировать из командной строки или с помощью вызовов &DBus;; из других программ.</para>

<para
>Когда напоминание срабатывает, оно появляется на всех рабочих столах, чтобы пользователь точно заметил его. В окне сообщения показано время, на которое было запланировано напоминание. Обычно в этом окне имеется кнопка, которая позволяет отложить напоминание. Пример напоминания:</para>

<screenshot>
<screeninfo
>Окно напоминания &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Сообщение напоминания</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Возможно отображать сообщение напоминания не в окне, а как системное уведомление.</para>

<para
>Когда в напоминании указана команда для выполнения или реквизиты для отправки письма, &kalarm; ничего не выводит на экран.</para>

<para
>Значок &kalarm; обычно показан в системном лотке (но его возможно скрыть с помощью соответствующего параметра настройки программы).</para>

</chapter>

<chapter id="using-kalarm">
<title
>Использование &kalarm;</title>

<para
>Когда программа &kalarm; запускается без параметров командной строки, она использует графический режим и отображает текущий список ожидающих напоминаний.</para>

<tip
><para
>Все числовые параметры в &kalarm; имеют возможность ускоренного перебора. Для изменения значения большими интервалами удерживайте клавишу <keycap
>Shift</keycap
> при нажатии кнопок со стрелками у полей ввода.</para>

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

<sect1 id="alarm-types">
<title
>Типы напоминаний</title>

<para
>Различные типы напоминаний, которые доступны в &kalarm;, предоставляют следующие базовые возможности:</para>

<itemizedlist>
<listitem>
<para
>Текстовые напоминания показывают либо текстовое сообщение, заданное пользователем, либо содержимое текстового файла или файла изображения, либо текстовый вывод команды, которая выполняется при срабатывании напоминания. Помимо показа одного из этих элементов, текстовые напоминания поддерживают озвучивание текста, воспроизведение звуковых файлов или простого звукового сигнала. Также возможно указать команды, которые должны выполняться до и после показа напоминания.</para>
</listitem>

<listitem>
<para
>Командные напоминания выполняют команду или сценарий оболочки, заданные пользователем. При этом на экране ничего не будет показано (за исключением сообщения об ошибке, если она произойдёт).</para>
</listitem>

<listitem>
<para
>Почтовые напоминания отправляют электронные письма. При этом на экране ничего не будет показано (за исключением сообщения об ошибке, если она произойдёт).</para>
</listitem>

<listitem>
<para
>Звуковые напоминания воспроизводят звуковые файлы. При этом на экране ничего не будет показано (за исключением сообщения об ошибке, если она произойдёт).</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Обработка ошибок</title>

<para
>Если при срабатывании напоминания происходит ошибка, будет показано соответствующее сообщение (если повторный показ таких сообщений не был запрещён пользователем ранее).</para>

<para
>Если при последнем срабатывании командного напоминания произошла ошибка выполнения команды, в столбце цвета напоминания будет показан белый восклицательный знак на красном фоне. Для просмотра подробных сведений об ошибке следует навести указатель мыши на соответствующую строку в списке напоминаний. Если при срабатывании текстовых напоминаний произойдёт ошибка выполнения заданной в диалоге «Специальные действия...» команды, которая должна выполняться до или после показа напоминания, это будет обозначено таким же образом, но фон столбца цвета не станет красным.</para>

</sect2>
</sect1>

<sect1 id="alarm-list">
<title
>Список напоминаний</title>

<para
>В главном окне &kalarm; представлен текущий список ожидающих напоминаний. Для них показаны время срабатывания, интервалы повторения, цвета, названия и тексты сообщений, имена файлов для воспроизведения или отображения, команды для выполнения и темы писем. (Для повторяющихся напоминаний отображается время следующего запланированного показа. Для напоминаний с предварительным сообщением отображается время показа основного напоминания, а не предварительного сообщения.) Значок, расположенный слева от каждого текста, файла, команды или темы письма, указывает тип напоминания.</para>

<para
>Обратите внимание, что столбец <guilabel
>Название</guilabel
> будет существовать только в том случае, если на вкладке <link linkend="preferences-general"
>Главное</link
> диалога настройки включено использование названий напоминаний.</para>

<screenshot>
<screeninfo
>Главное окно &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Главное окно</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Для повторяющихся напоминаний в списке отображается время следующего срабатывания и интервал повторения (например, <quote
>1 день</quote
> для ежедневных повторений, <quote
>3 недели</quote
> для повторений по понедельникам и средам каждой третьей недели, <quote
>При входе в систему</quote
> для напоминания при входе в систему).</para>

<para
>Ошибка выполнения команды командного напоминания или команды текстового напоминания, которая должна выполняться до или после его показа, будет обозначена в столбце цвета, как описано в разделе <link linkend="errors"
>Обработка ошибок</link
> выше.</para>

<sect2 id="listappear">
<title
>Изменение внешнего вида списка напоминаний</title>

<para
>Чтобы упорядочить напоминания по дате/времени, интервалу повторения, цвету, типу, названию или тексту, щёлкните по заголовку соответствующего столбца. Для изменения порядка сортировки на обратный щёлкните по заголовку столбца ещё раз.</para>

<para
>Возможно настроить отображение времени, оставшегося до срабатывания каждого напоминания (как вместе со временем запланированного срабатывания, так и вместо него).</para>

<para
>Чтобы выбрать столбец для показа или скрытия, щёлкните по его заголовку <mousebutton
>правой</mousebutton
> кнопкой мыши и выберите в контекстном меню соответствующий пункт. Обратите внимание, что хотя бы один из столбцов <guilabel
>Название</guilabel
> и <guilabel
>Сообщение, файл или команда</guilabel
> и хотя бы один из столбцов <guilabel
>Время</guilabel
> и <guilabel
>Время до</guilabel
> будут показаны всегда.</para>

<para
>Если используется несколько календарей напоминаний, возможно маркировать напоминания цветом в соответствии с календарём, к которому они относятся. Чтобы это сделать, для каждого календаря следует выбрать свой цвет фона (смотрите раздел <link linkend="using-calendars"
>Использование календарей</link
>).</para>

</sect2>

<sect2 id="expired">
<title
>Устаревшие напоминания</title>

<para
>Программа &kalarm; по умолчанию в течение ограниченного периода времени хранит устаревшие или удалённые напоминания. Обратите внимание, что удалённые пользователем напоминания сохраняются только в том случае, если они хотя бы однократно срабатывали. <link linkend="preferences-storage"
>Диалог настройки</link
> &kalarm; позволяет включить или отключить хранение устаревших напоминаний и настроить срок такого хранения.</para>

<para
>Устаревшие напоминания могут быть отображены выбором пункта меню <menuchoice
><guimenu
>Вид</guimenu
><guimenuitem
>Показать устаревшие напоминания</guimenuitem
></menuchoice
>. Чтобы скрыть их снова, повторите это действие.</para>

</sect2>

<sect2 id="datepicker">
<title
>Фильтрация списка напоминаний по дате</title>

<para
>Возможно ограничить список напоминаний, чтобы отображались только те напоминания, которые запланированы на выбранную дату. Чтобы сделать это, воспользуйтесь полем выбора даты напоминания, которое может отображаться или скрываться с помощью меню <menuchoice
><guimenu
>Вид</guimenu
> <guimenuitem
>Показать поле выбора даты</guimenuitem
> </menuchoice
>. Чтобы выбрать дату, щёлкните по ней левой кнопкой мыши, а чтобы снять выделение, щёлкните по ней ещё раз. В поле выбора дат отображается один месяц. Чтобы отобразить другой месяц, используйте кнопки со стрелками в поле выбора даты.</para>

</sect2>

<sect2 id="search">
<title
>Поиск по списку напоминаний</title>

<para
>В списке напоминаний возможно найти те, которые содержат заданный текст. Чтобы ввести текст для поиска, выберите пункт меню <menuchoice
> <guimenu
>Правка</guimenu
><guimenuitem
>Найти...</guimenuitem
></menuchoice
>. Выберите в диалоге поиска типы напоминаний, поиск которых следует выполнить. Чтобы продолжить поиск напоминаний, соответствующих заданным условиям, используйте пункты меню <menuchoice
> <guimenu
>Правка</guimenu
><guimenuitem
>Продолжить поиск</guimenuitem
></menuchoice
> или <menuchoice
> <guimenu
>Правка</guimenu
><guimenuitem
>Найти предыдущее</guimenuitem
> </menuchoice
>.</para>

<para
>Поиск выполняется следующим образом:</para>

<itemizedlist>
<listitem>
<para
>Напоминания с текстовыми сообщениями: выполняется поиск текста сообщения.</para>
</listitem>

<listitem>
<para
>Напоминания с показом файлов: выполняется поиск пути к файлу/&URL;.</para>
</listitem>

<listitem>
<para
>Командные напоминания: выполняется поиск команды или сценария.</para>
</listitem>

<listitem>
<para
>Почтовые напоминания: выполняется поиск по теме и телу письма, а также по получателям и URL-адресам вложений.</para>
</listitem>

<listitem>
<para
>Звуковые напоминания: выполняется поиск пути к файлу/&URL;.</para>
</listitem>
</itemizedlist>

<note
><para
>Поиск возможно выполнять только по тем напоминаниям, которые показаны в списке напоминаний. Следовательно, для поиска по устаревшим напоминаниям необходимо сначала включить их показ, как описано в разделе выше.</para
></note>
</sect2>
</sect1>

<sect1 id="create-edit">
<title
>Создание и управление напоминаниями</title>

<sect2>
<title
>Создание напоминания</title>

<para
>Чтобы создать напоминание, выполните одно из следующих действий, а затем выберите тип напоминания в появившемся списке. Будет показан <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>.</para>

<itemizedlist>
<listitem>
<para
>Выберите пункт меню <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Создать</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по значку в системном лотке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Создать напоминание</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по записи напоминания в списке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Создать</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

<para
>Кроме того, возможно создавать напоминания, которые уже будут настроены, на основе различных источников:</para>

<itemizedlist>
<listitem>
<para
>Чтобы задать дату напоминания в <link linkend="alarm-edit-dlg"
>диалоге редактирования напоминания</link
>, щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по желаемой дате в поле выбора даты (смотрите раздел <link linkend="datepicker"
>Фильтрация списка напоминаний по дате</link
>) и в открывшемся контекстном меню выберите соответствующий тип напоминания.</para>
</listitem>

<listitem>
<para
>Для создания напоминания на основе шаблона следуйте указаниям в разделе <link linkend="templates"
>Шаблоны напоминаний</link
>.</para>
</listitem>

<listitem>
<para
>Для создания напоминания на основе уже существующего выделите его и выберите пункт меню <menuchoice
> <guimenu
>Файл</guimenu
> <guimenuitem
>Копировать...</guimenuitem
></menuchoice
>. Будет открыт <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>, заполненный параметрами исходного напоминания.</para>
</listitem>

<listitem>
<para
>Для создания напоминания, отображающего существующее письмо, перетащите это письмо из &kmail; в главное окно &kalarm;. Выберите вариант <guilabel
>Текстовое напоминание</guilabel
>. Будет открыт <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>, содержащий письмо целиком (включая отправителя, получателя и так далее) в качестве текста напоминания.</para>
</listitem>

<listitem>
<para
>Для создания напоминания, которое позволяет отправить копию существующего письма, перетащите это письмо из &kmail; в главное окно &kalarm;. Выберите вариант <guilabel
>Почтовое напоминание</guilabel
>. Будет открыт <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>, содержащий письмо целиком (без отправителя).</para>
</listitem>

<listitem>
<para
>Для создания напоминания, отображающего существующую задачу, перетащите эту задачу из &kmail; в главное окно &kalarm;. Будет открыт <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>, содержащий задачу целиком в качестве текста напоминания.</para>
</listitem>

<listitem>
<para
>Для создания напоминания, запускающего выполнение команд, перетащите текст сценария, начинающийся символами <quote
>#!</quote
>, в главное окно &kalarm;. Будет открыт <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>, содержащий текст сценария.</para>
</listitem>

<listitem>
<para
>Для создания напоминания, показывающего файл, перетащите &URL;-адрес текстового файла или файла изображения в главное окно &kalarm;. Будет открыт <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
> для вывода файла с указанным именем.</para>
</listitem>

<listitem>
<para
>Для создания звукового напоминания перетащите &URL;-адрес звукового файла в главное окно &kalarm;. Будет открыт <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
> для воспроизведения файла с указанным именем.</para>
</listitem>

<listitem>
<para
>Для создания напоминания с текстовым сообщением перетащите любой текст в главное окно &kalarm;. Если будет предложено выбрать один из нескольких вариантов, выберите <guilabel
>Текстовое напоминание</guilabel
>. Будет открыт <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>, содержащий текст напоминания.</para>
</listitem>

<listitem>
<para
>Возможно автоматически создать напоминания о днях рождения людей, контакты которых содержатся в &kaddressbook;. Создание таких напоминаний описано в разделе <link linkend="birthdays"
>Импорт дней рождения из &kaddressbook;</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Изменение существующего напоминания</title>

<para
>Чтобы изменить существующее ожидающее напоминание (устаревшие напоминания нельзя изменять), выполните одно из следующих действий:</para>

<itemizedlist>
<listitem>
<para
>Выполните двойной щелчок по его записи в списке напоминаний.</para>
</listitem>

<listitem>
<para
>Выберите напоминание, щёлкнув по его записи в списке напоминаний. Затем выберите пункт меню <menuchoice
><guimenu
>Правка</guimenu
> <guimenuitem
>Изменить...</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по нужной записи в списке напоминаний и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Изменить...</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

<para
>Будет показан <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>.</para>

</sect2>

<sect2>
<title
>Удаление или возобновление напоминания</title>

<para
>Чтобы удалить существующие напоминания, выберите их щелчками по нужным записям в списке. Затем выполните одно из следующих действий:</para>

<itemizedlist>
<listitem>
<para
>Выберите пункт меню <menuchoice
><guimenu
>Правка</guimenu
> <guimenuitem
>Удалить</guimenuitem
></menuchoice
>.</para>
</listitem>
<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по выбранным записям и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Удалить</guimenuitem
></menuchoice
>.</para>
</listitem>
<listitem>
<para
>Чтобы удалить записи без вывода запроса на подтверждение, используйте комбинацию клавиш &Shift;+<keycap
>Delete</keycap
>.</para>
</listitem>
</itemizedlist>

<para
>Удалённые пользователем активные напоминания сохраняются в архиве, если до удаления они хотя бы однократно срабатывали и включено сохранение устаревших напоминаний. (<link linkend="preferences-storage"
>Диалог настройки</link
> позволяет включать и отключать хранение напоминаний, а также задавать срок хранения.) При удалении устаревшего напоминания или активного напоминания, которое ещё не срабатывало, сохранение в архиве выполнено не будет — такие напоминания удаляются безвозвратно.</para>

<para
>Удалённое напоминание возможно восстановить из списка устаревших напоминаний, если срок его действия ещё не истёк. Чтобы это сделать, сначала включите показ устаревших напоминаний, как описано в разделе <link linkend="expired"
>Устаревшие напоминания</link
>. Затем:</para>

<itemizedlist>
<listitem>
<para
>Выделите одно или несколько устаревших напоминаний, щёлкнув по соответствующим записям в списке. Далее выберите пункт меню <menuchoice
> <guimenu
>Действия</guimenu
><guimenuitem
>Активизировать</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по нужным записям напоминаний в списке устаревших напоминаний и выберите в контекстном меню пункт<menuchoice
><guimenuitem
>Активизировать</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Включение и отключение напоминаний</title>

<para
>Сведения о включении и отключении напоминаний (как по отдельности, так и всех вместе) доступны в разделе <link linkend="enable-disable"
>Включение и отключение напоминаний</link
>.</para>

</sect2>

<sect2>
<title
>Установка напоминания для пробуждения системы</title>

<para
>Сведения о настройке напоминания для вывода системы из ждущего или спящего режима доступны в разделе <link linkend="wake-suspend"
>Пробуждение системы</link
>.</para>

</sect2>

<sect2>
<title
>Принятие напоминания</title>

<para
>Сведения о подтверждении прочтения напоминаний доступны в разделе <link linkend="message-display"
>Показ напоминаний</link
>.</para>

</sect2>

<sect2 id="templates">
<title
>Шаблоны напоминаний</title>

<para
>Возможно создать шаблон напоминания для облегчения установки похожих напоминаний — благодаря шаблону не потребуется каждый раз задавать все параметры заново. В шаблоне могут быть заданы все параметры напоминания, за исключением даты начала.</para>

<para
>Например, возможно установить напоминание о телепередаче, время выхода которой изменяется каждую неделю. Шаблон содержал бы все параметры (текст сообщения, воспроизводить ли звук и так далее), за исключением времени и даты. Чтобы создать напоминание, необходимо открыть <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
> с этим шаблоном и ввести время и дату.</para>

<para
>Чтобы добавить напоминание на основе шаблона, откройте <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>, содержащий параметры шаблона:</para>

<itemizedlist>
<listitem>
<para
>Выберите пункт меню <menuchoice
><guimenu
>Файл</guimenu
><guimenuitem
>Создать</guimenuitem
> <guimenuitem
>Новое напоминание из шаблона</guimenuitem
> </menuchoice
>, а затем выберите нужный шаблон.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по значку в системном лотке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Создать напоминание</guimenuitem
> <guimenuitem
>Новое напоминание из шаблона</guimenuitem
></menuchoice
>. Затем выберите нужный шаблон.</para>
</listitem>

<listitem>
<para
>Откройте <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
> обычным способом и нажмите кнопку <guibutton
>Загрузить шаблон...</guibutton
> для выбора шаблона, параметры которого следует отразить в диалоге.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Настройка шаблонов</title>

<para
>С помощью диалога «Шаблоны напоминаний» возможно создавать, изменять или удалять шаблоны. Также возможно создать новый шаблон на основе существующего напоминания.</para>

<para
>Для создания шаблона напоминания следует выполнить одно из следующих действий:</para>

<itemizedlist>
<listitem>
<para
>Откройте диалог «Шаблоны напоминаний»: выберите пункт меню <menuchoice
> <guimenu
>Файл</guimenu
><guimenuitem
>Шаблоны...</guimenuitem
> </menuchoice
>. Нажмите кнопку <guibutton
>Создать</guibutton
> и выберите тип напоминания в появившемся списке. Будет показан пустой диалог изменения шаблона.</para>
</listitem>

<listitem>
<para
>Откройте диалог «Шаблоны напоминаний»: выберите пункт меню <menuchoice
> <guimenu
>Файл</guimenu
><guimenuitem
>Шаблоны...</guimenuitem
> </menuchoice
>. Выберите в списке существующий шаблон и нажмите кнопку <guibutton
>Копировать</guibutton
>. Будет показан диалог изменения шаблона, содержащий параметры существующего шаблона.</para>
</listitem>

<listitem>
<para
>Выделите напоминание в списке и выберите пункт меню <menuchoice
> <guimenu
>Файл</guimenu
><guimenuitem
>Создать шаблон...</guimenuitem
> </menuchoice
>. Будет показан откроет диалог изменения шаблона, содержащий параметры выбранного напоминания.</para>
</listitem>
</itemizedlist>

<para
>Чтобы изменить существующий шаблон, откройте диалог «Шаблоны напоминаний»: выберите пункт меню <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Шаблоны...</guimenuitem
> </menuchoice
>. Нажмите кнопку <guibutton
>Изменить...</guibutton
>. Будет показан диалог изменения напоминания, описание которого приводится далее.</para>

<para
>Чтобы удалить существующий шаблон, откройте диалог «Шаблоны напоминаний»: выберите пункт меню <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Шаблоны...</guimenuitem
> </menuchoice
>. Выделите один или несколько шаблонов и нажмите кнопку <guibutton
>Удалить</guibutton
>. Появится запрос на подтверждение, предотвращающий случайное удаление.</para>

</sect3>

<sect3>
<title
>Диалог изменения шаблона</title>

<para
>Диалог изменения шаблона аналогичен <link linkend="alarm-edit-dlg"
>диалогу изменения напоминания</link
>. Отличаются только следующие параметры:</para>

<itemizedlist>
<listitem>
<para
>В поле <guilabel
>Имя шаблона</guilabel
> вводится имя шаблона. Оно отображается в списке при выборе шаблона, поэтому рекомендуется выбрать имя, которое описывает его функциональность. Имя каждого шаблона должно быть уникальным.</para>
</listitem>

<listitem>
<para
>В блоке <guilabel
>Время</guilabel
> доступны следующие варианты:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Время по умолчанию</guilabel
> — выберите этот вариант, если не требуется указывать время срабатывания напоминания. Основывающиеся на этом шаблоне напоминания будут использовать для новых напоминаний обычное время срабатывания.</para>
</listitem>

<listitem>
<para
><guilabel
>Время</guilabel
> — позволяет указать время срабатывания напоминания.</para>
</listitem>

<listitem>
<para
><guilabel
>Только дата</guilabel
> — позволяет указать, что напоминание должно иметь только дату, но не время.</para>
</listitem>

<listitem>
<para
><guilabel
>Через</guilabel
> — позволяет указать время (в часах и минутах), через которое должно сработать созданное напоминание.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>На вкладке <guilabel
>Повторение</guilabel
> в блоке <guilabel
>Правило повторения</guilabel
> для еженедельных или ежегодных повторений не требуется указывать дни или месяцы.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="calendars">
<title
>Календари напоминаний</title>

<para
>Если используется только один компьютер и не ведётся совместная работа с другими пользователями, скорее всего, не имеет значения, где программа &kalarm; хранит напоминания. Но если доступ к напоминаниям необходимо осуществлять с нескольких компьютеров или из нескольких расположений на локальном компьютере, возможно задать <quote
>календари напоминаний</quote
> для использования в дополнение к стандартным календарям &kalarm; или вместо них.</para>

<para
>Список календарей (если его показ включён, он отображается рядом со списком напоминаний в главном окне &kalarm;) позволяет просматривать и изменять календари. В списке напоминаний показаны вместе напоминания из всех календарей. При сохранении нового напоминания возможно указать параметр настройки, который определяет, следует ли автоматически сохранить это напоминание в календарь по умолчанию или вывести запрос на выбор календаря. Отредактированное существующее напоминание автоматически сохраняется в соответствующий исходный календарь напоминаний.</para>

<screenshot>
<screeninfo
>Главное окно &kalarm; со списком календарей</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow-calendars.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Главное окно со списком календарей</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3>
<title
>Типы и параметры календарей</title>

<para
>Календари напоминаний подразделяются по типу напоминаний и типу хранения. Они могут быть отключены, доступны только для чтения или установлены в качестве календаря по умолчанию для соответствующего типа напоминаний.</para>

<variablelist>
<varlistentry>
<term
>Тип напоминания</term>
<listitem>
<para
>Три типа напоминаний — активные напоминания, устаревшие напоминания и шаблоны напоминаний — хранятся в отдельных календарях напоминаний. Следовательно, в программе &kalarm; предусмотрены три стандартных календаря по умолчанию, по одному для каждого типа (подробные сведения доступны в разделе <link linkend="faq"
>Вопросы и ответы</link
>). Эти календари возможно изменять.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Тип хранения</term>
<listitem>
<para
>Программа &kalarm; поддерживает два типа хранения календарей напоминаний:</para>

<itemizedlist>
<listitem
><para
>Локальный файл: напоминания хранятся в локальном файле в формате iCalendar. По умолчанию в программе&kalarm; используются календари в локальных файлах (подробные сведения доступны в разделе <link linkend="faq"
>Вопросы и ответы</link
>). К <quote
>локальным файлам</quote
>, помимо файлов на локальном компьютере, относятся и расположенные в локальной сети календари напоминаний, если их расположение может быть представлено в виде пути, начинающегося символом <literal
>/</literal
>.</para>
</listitem>

<listitem
><para
>Локальный каталог: напоминания хранятся в локальной папке, каждое — в отдельном файле в формате iCalendar. Преимущество этого способа хранения заключается в том, что при повреждении файла будет потеряно только одно напоминание, а не весь календарь.</para>
</listitem>
<!--FIXME not in kf5?
<listitem
><para
>Remote file: Alarms are stored in a single remote
file in iCalendar format. This storage method allows you to access
your alarm data remotely no matter where you are, or enables alarm
calendars to be viewed by other people. When using remote files,
&kalarm; works with a local cache of the data.</para>

<warning
><para
>If a remote alarm calendar is shared between users,
changes made by one person may not be automatically made available to
another user, or there could be a time delay before the other user
sees it. So one user could make a change which is then overwritten by
another user without either person noticing what has happened. The
technical reason for this is that a change made by person A will only
be available to person B after person A's cached copy has first been
saved to the remote file, and then person B's cached copy
of the remote file has been reloaded. When and if the calendar is
saved and reloaded depends on the calendar configuration parameters
which each user has set for that alarm calendar.</para>

<para
>Ways to avoid this problem include adjusting the calendar save
and reload configuration parameters, or adopting a policy that users
other than the alarm calendar's owner should open it in read-only
mode.</para
></warning>
</listitem>
-->
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Состояние «включён» или «отключён»</term>
<listitem>
<para
>Отключение календаря аналогично его удалению, за исключением того, что он продолжает отображаться в списке календарей и может быть снова включён. При отключении календаря соответствующие напоминания игнорируются и не отображаются в списке напоминаний и списке шаблонов. При повторном включении календаря эти напоминания будут показаны снова (и активированы, если это календарь для активных напоминаний).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Состояние «только для чтения»</term>
<listitem>
<para
>Если календарь доступен только для чтения, нельзя изменить существующие в нём напоминания или добавить новые. Кроме того, будет невозможно отложить напоминания, так как для этого необходимо сохранить в напоминании время откладывания.</para>

<para
>Диалог настройки календаря позволяет установить его в состояние «только для чтения». Обратите внимание, что некоторые календари по ряду причин нельзя сделать доступными для записи:</para>

<itemizedlist>
<listitem
><para
>Если календарь был создан с помощью другого приложения, небезопасно обновлять его с помощью &kalarm;; изменение формата данных может привести к тому, что календарь будет невозможно использовать в исходном приложении.</para>
</listitem>

<listitem
><para
>Если календарь был создан с помощью более поздней версии &kalarm;, при обновлении с помощью установленной версии &kalarm; могут быть потеряны данные.</para>
</listitem>

<listitem
><para
>Если календарь был создан с помощью предыдущей версии &kalarm;, после его обновления с помощью установленной версии &kalarm; могут быть потеряны данные или возможность использования в такой предыдущей версии &kalarm;. Будет предложено выбрать, следует ли преобразовать формат календаря, чтобы сделать его доступным для записи, несмотря на возможные проблемы совместимости с предыдущей версией &kalarm;.</para>
</listitem>

<listitem
><para
>Если у пользователя недостаточно прав для записи в файл или папку календаря.</para>
</listitem>
</itemizedlist>

<para
>Если пользователю требуется доступ для записи к напоминаниям, которые находятся в недоступном для записи календаре, эти напоминания возможно скопировать путём импорта в доступный для записи календарь. Для этого необходимо выбрать в контекстном меню доступного для записи календаря пункт <menuchoice
><guimenuitem
>Импорт...</guimenuitem
></menuchoice
> (смотрите раздел <link linkend="import"
>Импорт напоминаний из внешних календарей</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Состояние календаря по умолчанию</term>
<listitem>
<para
>Для каждого типа напоминаний возможно установить один календарь, который будет использоваться по умолчанию. Новые напоминания автоматически сохраняются в соответствующий календарь по умолчанию, если в <link linkend="preferences-storage"
>диалоге настройки</link
> не включена опция запроса выбора календаря при сохранении новых напоминаний и шаблонов.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="using-calendars">
<title
>Использование календарей</title>

<para
>Список календарей позволяет просматривать и изменять календари. Чтобы показать или скрыть этот список, выберите пункт меню <menuchoice
> <guimenu
>Вид</guimenu
><guimenuitem
>Показать календари</guimenuitem
> </menuchoice
>. При работе со списком календарей следует сначала выбрать тип напоминаний в поле, расположенном над списком. Затем либо нажмите одну из кнопок, расположенных под списком, либо щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по нужному календарю в списке и выберите один из пунктов контекстного меню. Доступны следующие действия:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Добавить...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Добавить календарь выбранного типа в список. Будет предложено выбрать тип хранения, после чего появится диалог настройки календаря, в котором возможно указать расположение календаря и его характеристики. Если в указанном расположении нет существующего календаря напоминаний, будет создан новый календарь.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Удалить</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Удалить выбранный календарь из списка. Сам календарь не будет удалён; он просто не будет больше отображаться в списке — позднее его будет возможно восстановить, чтобы он снова там появился.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Изменить...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Изменить выбранный календарь. Будет показан соответствующий диалог настройки.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Обновить</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Обновить выбранный календарь. Выполняется повторное чтение календаря в его расположении — это обеспечивает отсутствие расхождений между отображаемыми в программе &kalarm; данными и текущим содержимым календаря. Если календарь используется совместно с другими пользователями, в &kalarm; будут показаны внесённые ими изменения.</para>

<warning
><para
>При обновлении сетевого календаря будут потеряны все изменения, внесённые пользователем с момента последнего сохранения этого календаря. Кроме того, напоминания, устаревшие после последнего сохранения, могут сработать повторно.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Импорт...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Импортировать напоминания из файлов внешних календарей в выбранный календарь. Описание импорта доступно в разделе <link linkend="import"
>Импорт напоминаний из внешних календарей</link
>. Этот параметр недоступен для отключённых или находящихся в режиме «только для чтения» календарей.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Экспорт...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Экспортировать все напоминания из выбранного календаря в файл внешнего календаря. Описание экспорта доступно в разделе <link linkend="import"
>Экспорт напоминаний во внешние календари</link
>. Этот параметр недоступен для отключённых календарей.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Дополнительные параметры</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Показать подробные сведения о выбранном календаре. Будут показаны сведения о расположении, типе хранения и состоянии календаря. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Использовать по умолчанию</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Установить выбранный календарь в качестве календаря по умолчанию для выбранного типа напоминаний. Этот параметр недоступен для отключённых или находящихся в режиме «только для чтения» календарей.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Выбор цвета...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Выбрать фоновый цвет, которым в списке напоминаний будут выделяться напоминания из этого календаря. Маркировка цветом позволяет сразу увидеть, какие напоминания относятся к определённому календарю.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Сбросить цвет</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Сбросить выделение цветом в списке для напоминаний из этого календаря. Этот параметр доступен только в том случае, если к этому календарю был применён параметр <guimenuitem
>Выбор цвета...</guimenuitem
>.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="import">
<title
>Импорт напоминаний из внешних календарей</title>

<para
>В &kalarm; возможно импортировать напоминания из файлов других календарей. Функция импорта выполняет поиск событий, содержащих напоминания, в файлах выбранных календарей и копирует их (с новыми уникальными идентификаторами) в календарь &kalarm;. События без напоминаний и прочие записи календаря игнорируются. Существует два способа импорта напоминаний:</para>

<itemizedlist>
<listitem>
<para
>Чтобы импортировать из файлов календарей напоминания всех типов (активные, устаревшие и шаблоны), выберите пункт меню <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Импорт напоминаний...</guimenuitem
></menuchoice
>.</para>

<para
>Если настроены <link linkend="calendars"
>календари напоминаний</link
>, напоминания каждого типа будут добавляться в соответствующий календарь по умолчанию. Если в <link linkend="preferences-storage"
>диалоге настройки</link
> включена опция запроса выбора календаря для новых напоминаний и шаблонов, будет предложено выбрать календарь.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по календарю в списке календарей и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Импорт...</guimenuitem
></menuchoice
>. В этот календарь будут импортированы напоминания выбранного типа. Например, если выбран календарь с шаблонами напоминаний, в него будут импортированы шаблоны напоминаний (но не активные напоминания или устаревшие напоминания).</para>
</listitem>
</itemizedlist>

<warning
><para
>Если выполняется импорт напоминаний из файлов календарей, созданных не с помощью &kalarm;, напоминания могут измениться в процессе импорта — может измениться даже их время. Это зависит от параметров хранения данных, которые используются внешним приложением; если данные хранятся в формате, отличном от формата &kalarm;, такие изменения обязательно произойдут. Всегда проверяйте импортированные напоминания на наличие незапланированных изменений и при необходимости редактируйте их.</para
></warning>

</sect2>

<sect2 id="export">
<title
>Экспорт напоминаний во внешние календари</title>

<para
>Из &kalarm; возможно экспортировать напоминания в другие файлы календарей (либо текущие выбранные в списке напоминания, либо все напоминания из календаря). Описание способов экспорта приводится далее. Независимо от способа, возможно либо создать файл с новым календарём, либо добавить экспортированные напоминания в файл с существующим календарём. Чтобы добавить напоминания, установите в диалоге выбора файла флажок <guilabel
>Дописать к существующему файлу</guilabel
>; если этот флажок не установлен, существующий файл будет перезаписан.</para>

<itemizedlist>
<listitem>
<para
>Чтобы экспортировать текущие выбранные в списке напоминания, щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по выделению и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Экспорт...</guimenuitem
></menuchoice
>. Также возможно выбрать в главном меню пункт <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Экспорт выбранных напоминаний...</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Чтобы экспортировать все напоминания из календаря, щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по календарю в списке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Экспорт...</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="birthdays">
<title
>Импорт дней рождения из &kaddressbook;</title>

<note
><para
>Эта возможность доступна только в том случае, если <link linkend="akonadi-plugin"
>подключаемый модуль Akonadi</link
> &kalarm; установлен и включён.</para>
</note>

<para
>Возможно настроить показ напоминаний о днях рождения из &kaddressbook;, выбрав пункт меню <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Импорт дней рождения...</guimenuitem
></menuchoice
>. Открывшийся диалог позволяет выбрать дни рождения, для которых следует создать напоминания.</para>

<itemizedlist>
<listitem>
<para
>В блоке <guilabel
>Текст напоминания</guilabel
> возможно указать текст, который будет показан в напоминании о дне рождения. Текст сообщения состоит из текста <guilabel
>Префикса</guilabel
>, имени человека и текста <guilabel
>Суффикса</guilabel
>. При этом в объединённый текст не будут автоматически вставлены пробелы, поэтому их следует добавить в конце <guilabel
>Префикса</guilabel
> и начале <guilabel
>Суффикса</guilabel
>.</para>

<note
><para
>Если изменить текст напоминания, список выбора дней рождения будет обработан повторно.</para
></note>
</listitem>

<listitem>
<para
>Выберите дни рождения, для которых следует создать напоминания, в списке <guilabel
>Выбор дней рождения</guilabel
>. Обратите внимание, что в списке присутствуют только те записи &kaddressbook;, которые содержат дни рождения и не имеют напоминаний о них в текущем определённом в блоке <guilabel
>Текст напоминания</guilabel
> формате.</para>
</listitem>

<listitem>
<para
>Остальные параметры аналогичны параметрам <guilabel
>текстовых</guilabel
> напоминаний в <link linkend="alarm-edit-dlg"
>диалоге изменения напоминания</link
>.</para>
</listitem>
</itemizedlist>

<para
>Если настроены <link linkend="calendars"
>календари напоминаний</link
>, напоминания будут добавляться в календарь по умолчанию для активных напоминаний. Если в <link linkend="preferences-storage"
>диалоге настройки</link
> включена опция запроса выбора календаря для новых напоминаний и шаблонов, будет предложено выбрать календарь.</para>
</sect2>

<sect2 id="undo">
<title
>Отмена и повтор</title>

<para
>Большинство последних действий, выполненных в текущем сеансе &kalarm;, возможно отменять и повторять. Например, возможно отменять создание, изменение и удаление напоминаний и шаблонов напоминаний, а также активацию напоминаний. Для экономии ресурсов, используемых для хранения журнала последних действий, их количество ограничено 12.</para>

<para
>Для отмены последнего изменения выберите пункт меню <menuchoice
> <guimenu
>Правка</guimenu
><guimenuitem
>Отменить</guimenuitem
></menuchoice
>. Для повтора последнего отменённого действия выберите пункт меню <menuchoice
> <guimenu
>Правка</guimenu
><guimenuitem
>Повторить</guimenuitem
> </menuchoice
>.</para>

<para
>Если требуется отменить не последнее, а какое-либо другое изменение, нажмите на панели инструментов кнопку <guibutton
>Отменить</guibutton
> и удерживайте кнопку мыши. Появится список действий, в котором возможно выбрать действие для отмены. Если в списке нет нужного действия, возможно, сначала следует отменить более поздние изменения, от которых зависит это действие. Например, если было выполнено редактирование и затем удаление напоминания, отменить внесённые в напоминание изменения будет возможно только после отмены его удаления.</para>

<para
>Повтор действия, отличного от последнего, выполняется аналогичным образом — для этого используется кнопка <guibutton
>Повторить</guibutton
> на панели инструментов.</para>

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<title
>Диалог изменения напоминания</title>

<para
>Диалог изменения напоминания позволяет просматривать и редактировать напоминание. При первом запуске &kalarm; показывается упрощённый вариант этого диалога с небольшим количеством параметров. Для просмотра всех параметров нажмите кнопку<guibutton
>Показать подробности</guibutton
>; для возврата к упрощённому варианту диалога — кнопку <guibutton
>Скрыть подробности</guibutton
>. Программа &kalarm; всегда запоминает последний выбранный вариант отображения и применяет его при повторном открытии диалога изменения напоминания.</para>

<para
>Для многих параметров диалога изменения напоминания возможно задать значения по умолчанию: это выполняется с помощью <link linkend="preferences-edit"
>диалога настройки (на вкладке «Правка»)</link
>.</para>

<screenshot>
<screeninfo
>Упрощённый диалог изменения напоминания</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Упрощённый диалог изменения текстового напоминания</phrase>
</textobject>
<caption
><para
>Упрощённый диалог изменения текстового напоминания</para
></caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Диалог изменения напоминания со всеми параметрами</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Диалог изменения текстового напоминания со всеми параметрами</phrase>
</textobject>
<caption
><para
>Диалог изменения текстового напоминания со всеми параметрами</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Название напоминания</title>

<para
>Чтобы присвоить напоминанию название, введите его в поле <guilabel
>Название напоминания</guilabel
>. Это упростит дальнейшую идентификацию напоминания. Вводить название необязательно. Возможно использовать неуникальное название.</para>

<para
>Обратите внимание, что это поле будет показано только в том случае, если на вкладке <link linkend="preferences-general"
>Главное</link
> диалога настройки включено использование названий напоминаний.</para>

</sect2>

<sect2>
<title
>Действие напоминания</title>

<para
>Параметры, которые доступны в блоке <guilabel
>Действие</guilabel
>, зависят от типа изменяемого напоминания.</para>

<sect3>
<title
>Текстовые напоминания</title>

<para
>Текстовые напоминания при срабатывании выводят на экран окно. Выберите способ создания содержимого этого окна в поле со списком, которое расположено в верхней части диалога:</para>

<itemizedlist>
<listitem>
<para
>Вариант <guilabel
>Текстовое сообщение</guilabel
> позволяет ввести текст напоминания (он может содержать несколько строк) в поле редактирования.</para>
</listitem>

<listitem>
<para
>Вариант <guilabel
>Содержимое файла</guilabel
> позволяет ввести путь или &URL;-адрес текстового файла или файла изображения, содержимое которого будет отображено в напоминании. Чтобы открыть диалог выбора файла, нажмите кнопку, расположенную рядом с полем редактирования. Для напоминаний этого типа недоступен параметр <guilabel
>Зачитать напоминание</guilabel
>.</para>
</listitem>

<listitem>
<para
>Вариант <guilabel
>Вывод команды</guilabel
> позволяет указать, что текст напоминания будет создан с помощью команды, которая выполняется при срабатывании напоминания. Подробное описание процесса ввода команды или сценария для выполнения доступно в приведённом далее разделе <link linkend="command-alarm"
>Командные напоминания</link
>.</para>
</listitem>
</itemizedlist>

<para
>Для текстовых напоминаний доступны следующие параметры:</para>

<itemizedlist>
<listitem>
<para
>Параметр <guilabel
>Звук</guilabel
> позволяет выбрать, следует ли воспроизводить звук при показе напоминания. Доступные варианты:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Нет</guilabel
> для показа напоминания без звука.</para>
</listitem>

<listitem>
<para
><guilabel
>Сигнал</guilabel
> для воспроизведения звукового сигнала.</para>
</listitem>

<listitem>
<para
><guilabel
>Зачитать напоминание</guilabel
> для озвучивания напоминания при показе. Этот вариант доступен только в том случае, если модуль речи &Qt; установлен и работает.</para>
</listitem>

<listitem>
<para
><guilabel
>Звуковой файл</guilabel
> для воспроизведения звукового файла. Чтобы открыть диалог выбора звукового файла и настроить параметры громкости и повторения, нажмите кнопку, расположенную справа. При наведении указателя мыши на поле выбора будет показана всплывающая подсказка с именем текущего выбранного звукового файла.</para>

<para
>В диалоге «Звуковой файл»:</para>

<itemizedlist>
<listitem>
<para
>Введите путь к звуковому файлу или откройте диалог выбора файла путём нажатия кнопки, расположенной рядом с полем редактирования. Чтобы прослушать выбранный файл, нажмите кнопку воспроизведения, расположенную слева от поля редактирования. Чтобы остановить воспроизведение, нажмите эту кнопку ещё раз.</para>
</listitem>

<listitem>
<para
>Если звуковой файл следует непрерывно повторять в течение показа напоминания, включите параметр <guilabel
>Повтор</guilabel
>. (В окне напоминания имеется кнопка, с помощью которой при необходимости возможно остановить воспроизведение звука, не закрывая при этом окно напоминания.)</para>
</listitem>

<listitem>
<para
>Чтобы отрегулировать громкость воспроизведения звукового файла с помощью ползунка, включите параметр <guilabel
>Установить громкость</guilabel
>.</para>
</listitem>

<listitem>
<para
>Если используемая внутренняя служба &phonon; поддерживает затихание, возможно настроить его. Это означает, что при воспроизведении звукового файла громкость будет постепенно снижаться в течение заданного временного интервала, пока не достигнет итогового значения. Итоговая громкость задаётся с помощью расположенного выше ползунка <guilabel
>Громкость</guilabel
>. Для включения затихания следует установить флажок <guilabel
>Затихание</guilabel
>, а затем ввести временной интервал затихания (в секундах) в поле <guilabel
>Период затихания</guilabel
> и отрегулировать положение ползунка <guilabel
>Начальная громкость</guilabel
>.</para>
</listitem>
</itemizedlist>

<tip
><para
>Кнопка <guibutton
>Опробовать</guibutton
> позволяет протестировать выбранные параметры громкости.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Используйте кнопку <guibutton
>Шрифт и цвета...</guibutton
> для выбора шрифта, цвета текста или фона сообщения. В диалоге <guilabel
>Выбор шрифта и цвета напоминания</guilabel
> установите флажок <guilabel
>Использовать шрифт по умолчанию</guilabel
> для отображения сообщения шрифтом, настроенным по умолчанию. Чтобы выбрать другой шрифт, снимите флажок <guilabel
>Использовать шрифт по умолчанию</guilabel
>. (Шрифт по умолчанию возможно установить в <link linkend="preferences-edit"
>диалоге настройки</link
>.)</para>

<para
>Выбранные цвета будут показаны в поле ввода текста напоминания.</para>
</listitem>

<listitem>
<para
>Параметр <guilabel
>Способ показа</guilabel
> позволяет выбрать способ показа напоминания. Доступные варианты:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Окно</guilabel
> для показа напоминания в окне. При выборе этого варианта будет доступны все параметры настройки напоминания.</para>
</listitem>

<listitem>
<para
><guilabel
>Уведомление</guilabel
> для показа напоминания с помощью стандартной системы уведомлений. При выборе этого варианта будут недоступны следующие параметры настройки напоминания (так как они не поддерживаются системой уведомлений): указание шрифта и цвета; указание звукового файла для воспроизведения при показе напоминания; подтверждение прочтения; автоматическое закрытие напоминания после истечения периода опоздания.</para>
</listitem>
</itemizedlist>

<para
>Более подробные сведения о показе напоминаний доступны в разделе <link linkend="message-display"
>Показ напоминаний</link
>.</para>
</listitem>

<listitem>
<para
>Используйте кнопку <guibutton
>Специальные действия...</guibutton
> для указания команд оболочки, которые следует выполнить до или после показа напоминания. В диалоге <guilabel
>Специальные действия напоминания</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
>В поле <guilabel
>Предварительное действие</guilabel
> возможно ввести команду оболочки, которая будет выполнена до показа напоминания. Обратите внимание, что приложение &kalarm; отобразит напоминание только после завершения команды.</para>

<para
>Предварительное действие выполняется только один раз, при первом показе напоминания, в том числе и при смене предварительного сообщения на основное. Команда <emphasis
>не</emphasis
> выполняется в следующих случаях:</para>

<itemizedlist>
<listitem
><para
>При показе предварительного сообщения.</para
></listitem>
<listitem
><para
>При повторном показе отложенного напоминания (если флажок <guilabel
>Выполнить для отложенных напоминаний</guilabel
> не установлен).</para
></listitem>
<listitem
><para
>При восстановлении сообщения (которое отображалось при выходе пользователя из сеанса) после возобновления сеанса пользователя.</para
></listitem>
<listitem
><para
>При срабатывании повторяющегося напоминания, если на экране всё ещё отображается сообщение напоминания (или сообщение отложенного напоминания), связанное с предыдущим повтором; иными словами, когда напоминание не было принято при предыдущем повторе.</para
></listitem>
</itemizedlist>

<para
>Предварительное действие возможно использовать для управления отображением напоминания:</para>

<itemizedlist>
<listitem
><para
>Установите флажок <guilabel
>Не показывать напоминание при ошибке</guilabel
> для отмены напоминания в том случае, если предварительная команда возвращает ошибку. Напоминание не будет показано, и действие после напоминания не будет выполнено.</para
></listitem>

<listitem
><para
>Когда предварительная команда возвращает ошибку, обычно показывается сообщение об ошибке и в списке напоминаний появляется соответствующее обозначение. Чтобы такие сообщения об ошибках не отображались, установите флажок <guilabel
>Не уведомлять об ошибках</guilabel
>.</para
></listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>В поле <guilabel
>Действие после напоминания</guilabel
> возможно ввести команду оболочки, которая будет выполнена после принятия напоминания (либо нажатием кнопки <guibutton
>Закрыть</guibutton
>, либо нажатием кнопки закрытия в заголовке окна). Команда <emphasis
>не</emphasis
> выполняется в следующих случаях:</para>

<itemizedlist>
<listitem
><para
>При закрытии предварительного сообщения.</para
></listitem>
<listitem
><para
>При откладывании напоминания (но не в том случае, когда выполняется принятие отложенного напоминания).</para
></listitem>
<listitem
><para
>При закрытии напоминания из-за прекращения сеанса пользователя.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Подробные сведения о выполнении команд оболочки доступны в разделе <link linkend="command-alarm"
>Командные напоминания</link
>.</para>

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

<sect3 id="command-alarm">
<title
>Командные напоминания</title>

<para
>При срабатывании командного напоминания выполняется команда, при этом на экран не выводятся какие-либо сообщения.</para>

<note
><para
>Этот тип напоминания недоступен, если &kde; выполняется в режиме киоска.</para
></note>

<para
>Во время выполнения команды переменная среды <envar
>KALARM_UID</envar
> содержит UID события, активировавшего напоминание. Обратите внимание: когда команда выполняется по нажатию кнопки <guibutton
>Опробовать</guibutton
> в диалоге изменения напоминания, переменная среды <envar
>KALARM_UID</envar
> будет пустой, если это новое напоминание или если напоминание было изменено в диалоге, так как напоминание получает UID только после сохранения в календаре напоминаний.</para>

<para
>Для командных напоминаний доступны следующие параметры:</para>

<itemizedlist>
<listitem>
<para
>Флажок <guilabel
>Указать сценарий</guilabel
> позволяет ввести команду оболочки или сценарий.</para>

<para
>Если этот флажок не установлен, возможно ввести команду оболочки. Она будет передана оболочке по умолчанию (определённой в переменной среды <envar
>SHELL</envar
>) и может включать любые опции, параметры, команды обработки каналов и другие разрешённые оболочкой в одной строке команды.</para>

<para
>Если этот флажок установлен, возможно ввести текст сценария для исполнения. Сценарий должен начинаться с <literal
>#!/bin/bash</literal
> (это обеспечит вызов правильного интерпретатора команд).</para>
</listitem>

<listitem
><para
>Когда команда возвращает ошибку, обычно показывается сообщение об ошибке и в списке напоминаний появляется соответствующее обозначение. Чтобы это сообщение об ошибке не отображалось, установите флажок <guilabel
>Не уведомлять об ошибках</guilabel
>.</para
></listitem>

<listitem>
<para
>Блок <guilabel
>Вывод команды</guilabel
> позволяет указать, как следует обрабатывать вывод команды, который появляется в терминале при её выполнении.</para>

<itemizedlist>
<listitem>
<para
>Для выполнения команды в окне терминала установите флажок <guilabel
>Выполнить в окне терминала</guilabel
>. Тип окна терминала возможно выбрать в <link linkend="preferences-general"
>диалоге настройки</link
>.</para>
</listitem>

<listitem>
<para
>Для записи вывода команды в файл установите флажок <guilabel
>Записать в журнал</guilabel
>. Вывод, предваряемый заголовком, в котором указано запланированное время выполнения команды, будет добавлен к существующему содержимому файла. Введите имя файла в поле редактирования или нажмите кнопку, расположенную рядом с полем редактирования, чтобы открыть диалог выбора файла.</para>
</listitem>

<listitem>
<para
>Для игнорирования вывода команды установите флажок <guilabel
>Игнорировать</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect3>

<sect3>
<title
>Почтовые напоминания</title>

<para
>При срабатывании почтового напоминания отправляется письмо, при этом на экран не выводятся какие-либо сообщения.</para>

<para
>Заполните в соответствующих полях адреса получателей, тему письма и тело сообщения. Используйте кнопку справа от поля адреса для вызова адресной книги &kde;, в которой возможно выбрать получателей. (Обратите внимание, что эта кнопка будет показана только в том случае, если <link linkend="akonadi-plugin"
>подключаемый модуль Akonadi</link
> &kalarm; установлен и включён.)  Вложения могут быть добавлены с помощью кнопки <guibutton
>Добавить...</guibutton
>. Обратите внимание, что файлы вложений должны существовать при срабатывании напоминания, так как при создании напоминания их копии не сохраняются. Для удаления вложения выберите его в раскрывающемся списке и нажмите кнопку <guibutton
>Удалить</guibutton
>.</para>

<para
>Задайте следующие параметры:</para>

<itemizedlist>
<listitem>
<para
>В поле со списком <guilabel
>Отправитель</guilabel
> возможно выбрать профиль &kmail;, адрес электронной почты которого будет использован при отправке письма. Этот параметр доступен только в том случае, если в <link linkend="preferences-email"
>диалоге настройки</link
> параметр <guilabel
>Отправитель</guilabel
> установлен в значение<guilabel
>Использовать профиль &kmail;</guilabel
>. Если это не так, то будет использован адрес электронной почты, предустановленный в <link linkend="preferences-email"
>диалоге настройки</link
>.</para>
</listitem>

<listitem>
<para
>Флажок <guilabel
>Отправить копию письма самому себе</guilabel
> позволяет отправить самому себе скрытую копию письма при срабатывании напоминания. Адрес, на который будет отправлена копия, указывается в <link linkend="preferences-email"
>диалоге настройки</link
>. По умолчанию используется адрес электронной почты, установленный в &kmail;.</para>
</listitem>
</itemizedlist>

</sect3>

<sect3>
<title
>Звуковые напоминания</title>

<para
>При срабатывании звукового напоминания воспроизводится звуковой файл, при этом на экран не выводятся какие-либо сообщения.</para>

<para
>Задайте следующие параметры:</para>

<itemizedlist>
<listitem>
<para
>Введите путь к звуковому файлу или используйте кнопку, расположенную рядом с полем редактирования, чтобы открыть диалог выбора файла.</para>
</listitem>

<listitem>
<para
>Установите флажок <guilabel
>Повтор</guilabel
> для непрерывного повторения звукового файла вплоть до выбора параметра <guilabel
>Остановить воспроизведение</guilabel
>. Чтобы остановить воспроизведение файла, выберите пункт меню <menuchoice
><guimenu
>Действия</guimenu
> <guimenuitem
>Остановить воспроизведение</guimenuitem
></menuchoice
> или щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по значку в системном лотке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Остановить воспроизведение</guimenuitem
></menuchoice
>. При необходимости для этого действия возможно настроить глобальную комбинацию клавиш.</para>
</listitem>

<listitem>
<para
>Чтобы отрегулировать громкость воспроизведения звукового файла с помощью ползунка, включите параметр <guilabel
>Установить громкость</guilabel
>.</para>
</listitem>

<listitem>
<para
>Если используемая внутренняя служба &phonon; поддерживает затихание, возможно настроить его. Это означает, что при воспроизведении звукового файла громкость будет постепенно снижаться в течение заданного временного интервала, пока не достигнет итогового значения. Итоговая громкость задаётся с помощью расположенного выше ползунка <guilabel
>Громкость</guilabel
>. Для включения затихания следует установить флажок <guilabel
>Затихание</guilabel
>, а затем ввести временной интервал затихания (в секундах) в поле <guilabel
>Период затихания</guilabel
> и отрегулировать положение ползунка <guilabel
>Начальная громкость</guilabel
>.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>

<sect2>
<title
>Отсрочка</title>

<para
>Если напоминание является повторяющимся и было отложено после последнего показа, в блоке <guilabel
>Отсроченное напоминание</guilabel
> будет показано время, на которое перенесено напоминание. При нажатии кнопки <guibutton
>Изменить...</guibutton
> будет открыт диалог, который позволяет изменить это время или отменить отсрочку.</para>

</sect2>

<sect2>
<title
>Время</title>

<para
>В блоке <guilabel
>Время</guilabel
> возможно выбрать один из двух вариантов:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>В указанную дату/время</guilabel
> — позволяет ввести дату и время срабатывания напоминания. Если требуется указать только дату напоминания, установите флажок <guilabel
>Время не указано</guilabel
>: напоминание будет показано при первой возможности в настроенное время начала дня или после него, в указанную дату (описание установки времени начала дня доступно в разделе <link linkend="preferences-general"
>Настройка &kalarm;</link
>).</para>

<para
>Если напоминание не является повторяющимся, вводимые дата и время должны находиться в будущем (если вводится только дата, она должна быть текущим или одним из будущих дней). Для повторяющихся напоминаний нет таких ограничений, так как дата и время начала будут автоматически настроены по ближайшему предстоящему повторению.</para>
</listitem>

<listitem>
<para
><guilabel
>Через</guilabel
> — позволяет указать время (в часах и минутах), через которое должно сработать напоминание.</para>
</listitem>
</itemizedlist>

<para
>При необходимости возможно выбрать часовой пояс, который будет применён к напоминанию. Выбранный часовой пояс используется для всех параметров даты и времени, связанных с напоминанием, включая дату и время повторов и отсутствия напоминания. Обычно заданные в программе параметры часового пояса не требуется изменять.</para>

<para
>Элементы управления часовым поясом отображаются только по нажатию кнопки <guibutton
>Часовой пояс...</guibutton
> или в том случае, если выбранный часовой пояс отличается от часового пояса по умолчанию, который задан в <link linkend="preferences-time"
>диалоге настройки</link
>.</para>

<itemizedlist>
<listitem>
<para
>Выберите в поле со списком часовой пояс, который следует использовать для этого напоминания. При создании нового напоминания в списке автоматически выбирается часовой пояс, заданный в <link linkend="preferences-time"
>диалоге настройки</link
>, — этот часовой пояс будет использоваться на компьютере (если его не изменить).</para>
</listitem>

<listitem>
<para
>Чтобы использовать часовой пояс компьютера (на котором работает программа &kalarm;), установите флажок <guilabel
>Системный часовой пояс</guilabel
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Предварительное напоминание</title>

<para
>Для текстового напоминания возможно установить флажок <guilabel
>Напомнить за</guilabel
>, если требуется показать дополнительное напоминание до или после показа основного напоминания или любого из его повторений (если они имеются). Введите время дополнительного напоминания с помощью элементов управления, расположенных рядом с флажком. Обратите внимание: если напоминание повторяется, интервал дополнительного напоминания обычно не может превышать интервал повторения или дополнительного повторения.</para>

<note
><para
>Напоминания будут показаны только для основного повторения, но не для дополнительных повторений (то есть повторений внутри повторения).</para
></note>

<para
>Для повторяющегося напоминания возможно установить флажок <guilabel
>Предварительное напоминание только для первого повторения</guilabel
>, если требуется показать дополнительное напоминание только перед первым повторением. Если этот флажок установлен и дополнительное напоминание будет сделано заранее, интервал дополнительного напоминания не ограничен интервалом повторения или дополнительного повторения.</para>


</sect2>

<sect2>
<title
>Отмена</title>

<para
>Параметры отмены просроченных напоминаний позволяют управлять обработкой напоминаний, запланированное время срабатывания которых прошло:</para>

<itemizedlist>
<listitem>
<para
>Флажок <guilabel
>Отмена при невозможности показа</guilabel
> позволяет указать действие, которое следует выполнить в случае невозможности срабатывания напоминания в запланированное время.</para>

<para
>Установите этот флажок, чтобы отменить напоминание, если оно не сработает по прошествии заданного периода после изначально установленного времени срабатывания. Чтобы задать период времени, используйте соответствующие элементы управления (они станут доступны после установки флажка). Например, если ввести период времени длительностью 1 час, напоминание должно сработать при первой возможности в течение часа с момента наступления времени срабатывания, но если за это время оно не сработает, его активация будет отменена.</para>

<note
><para
>Просрочка напоминаний, для которых задана только дата (тех, для которых был установлен флажок <guilabel
>Время не указано</guilabel
>), считается от времени начала дня запланированной даты срабатывания.</para
></note>

<para
>Если требуется, чтобы напоминание сработало при первой возможности, начиная с запланированного времени, независимо от того, насколько оно просрочено, не устанавливайте этот флажок.</para>

<note
><para
>Напоминание может сработать только во время сеанса пользователя (при условии, что запущены как графическая подсистема, так и &kalarm;).</para
></note>
</listitem>

<listitem>
<para
>Флажок <guilabel
>Автоматически закрыть напоминание</guilabel
> позволяет автоматически закрыть окно напоминания, если оно продолжает отображаться по истечении заданного периода времени.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Повторение</title>

<para
>На вкладке <guilabel
>Повторение</guilabel
> возможно указать, следует ли повторять напоминание, и настроить параметры повторения.</para>

<note
><para
>Для удобства основные характеристики повторения представлены в заголовке вкладки <guilabel
>Повторение</guilabel
>. Сначала показан интервал повторения, далее — интервал дополнительного повторения (для его настройки предназначена кнопка <guibutton
>Дополнительное повторение</guibutton
>).</para
></note>

<para
>В блоке <guilabel
>Правило повторения</guilabel
> возможно указать тип повторения или период времени следующим образом:</para>

<itemizedlist>
<listitem
><para
>Чтобы напоминание сработало только один раз, выберите вариант <guilabel
>Без повторения</guilabel
>.</para
></listitem>

<listitem
><para
>Чтобы напоминание срабатывало при входе в систему вплоть до наступления запланированного времени его окончания, выберите вариант <guilabel
>При входе в систему</guilabel
>. Последнее срабатывание напоминания произойдёт в запланированное время его окончания. (Обратите внимание, что напоминание, которое повторяется при входе в систему, будет срабатывать и при каждом перезапуске &kalarm;.)</para
></listitem>

<listitem>
<para
>Чтобы сделать напоминание регулярно повторяющимся, выберите нужный тип периода и введите в поле <guilabel
>Повторять каждые</guilabel
> количество периодов между повторениями. Например, чтобы напоминание повторялось каждые две недели, следует выбрать <guilabel
>Ежедневно</guilabel
> и ввести значение 14 или выбрать <guilabel
>Еженедельно</guilabel
> и ввести значение 2. В зависимости от выбранного типа периода, могут быть доступны дополнительные параметры:</para>

<itemizedlist>
<listitem>
<para
>При выборе еженедельного повторения возможно указать те дни недели, в которые должно срабатывать напоминание.</para>
</listitem>

<listitem>
<para
>При выборе ежемесячного повторения возможно выбрать либо фиксированную дату, либо позицию (например, второй вторник).</para>
</listitem>

<listitem>
<para
>При выборе ежегодного повторения возможно выбрать либо фиксированный день месяца, либо позицию в месяце (например, последнюю субботу мая). Отметьте те месяцы года, в которые должно срабатывать напоминание.</para>

<para
>Если заданы ежегодные повторения на 29 февраля, возможно определить, как их следует обрабатывать в невисокосные годы. Для этого предназначен параметр <guilabel
>Показывать напоминания на 29 февраля в невисокосные годы</guilabel
>. Доступны следующие варианты:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Нет</guilabel
>: напоминание повторится 29 февраля в високосный год и не повторится в обычный.</para>
</listitem>

<listitem
><para
><guilabel
>28 февраля</guilabel
>: напоминание повторится 29 февраля в високосный год и 28 февраля в обычный.</para>
</listitem>

<listitem
><para
><guilabel
>1 марта</guilabel
>: напоминание повторится 29 февраля в високосный год и 1 марта в обычный.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<tip
><para
>Чтобы напоминание повторялось только в будние дни, используйте еженедельные повторения и выберите все будние дни.</para
></tip>

</listitem>
</itemizedlist>

<para
>В блоке <guilabel
>Окончание повторения</guilabel
> возможно установить общую длительность времени повторения следующим образом:</para>

<itemizedlist>
<listitem
><para
>Выберите <guilabel
>Период не ограничен</guilabel
> для бесконечного продолжения повторений.</para
></listitem>

<listitem
><para
>Выберите <guilabel
>Закончить повтор после</guilabel
> для указания общего количества повторений напоминания.</para
></listitem>

<listitem
><para
>Выберите <guilabel
>Закончить к</guilabel
> для определения даты и времени, до наступления которых будет повторяться напоминание. Обратите внимание, что в этом параметре используется тот же часовой пояс, что и для времени начала напоминания.</para>

<note
><para
>Дата и время окончания определяют, когда произойдёт последнее повторение основного напоминания, но не ограничивают дополнительные повторения. Если эти повторения настроены, они будут срабатывать как обычно после последнего повторения основного напоминания независимо от даты и времени окончания.</para
></note>
</listitem>
</itemizedlist>

<para
>В блоке <guilabel
>Исключения</guilabel
> возможно настроить пропуск повторов в определённые даты и время. Обратите внимание, что эти элементы управления не отображаются в упрощённом диалоге изменения напоминания: для их показа следует нажать кнопку <guibutton
>Показать подробности</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>Список исключений (то есть тех дат и времени, в которые не будет срабатывать напоминание) показан в левой части блока. Чтобы добавить новое исключение, введите дату в поле, расположенном справа от списка, и нажмите кнопку <guibutton
>Добавить</guibutton
>. Для изменения исключения выделите его в списке, введите новую дату и нажмите кнопку <guibutton
>Изменить</guibutton
>. Для удаления исключения выделите его в списке и нажмите кнопку <guibutton
>Удалить</guibutton
>.</para>
</listitem>

<listitem>
<para
>Чтобы напоминание не повторялось в праздничные дни, установите флажок <guilabel
>Исключить праздничные дни</guilabel
>. Это не повлияет на запланированное время срабатывания напоминания; оно просто будет подавлено при срабатывании в праздничный день. Профиль праздников для страны или региона пользователя возможно выбрать в <link linkend="preferences-time"
>диалоге настройки</link
>.</para>
</listitem>

<listitem>
<para
>Чтобы напоминание повторялось только в рабочее время, установите флажок <guilabel
>Только в рабочее время</guilabel
>. Это не повлияет на запланированное время срабатывания напоминания; оно просто будет подавлено при срабатывании в нерабочее время. Рабочие дни и рабочие часы возможно задать в <link linkend="preferences-time"
>диалоге настройки</link
>.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Дополнительное повторение</title>

<para
>С помощью кнопки <guibutton
>Дополнительное повторение</guibutton
> возможно настроить повторение внутри повторения. В этом случае при наступлении основного времени срабатывания напоминание будет срабатывать не один раз, а несколько, в соответствии с заданным расписанием дополнительных повторений. Например, чтобы напоминание повторялось каждый час с полудня до 6 часов вечера по четвергам, следует установить еженедельное повторение по четвергам в 12 часов и задать в диалоге повтора дополнительных напоминаний часовой интервал, а также либо равное 6 количество дополнительных напоминаний, либо равную 6 часам продолжительность.</para>

<para
>В диалоге повтора дополнительных напоминаний (открывается по нажатию кнопки <guibutton
>Дополнительное повторение</guibutton
>) установите флажок <guilabel
>Повторять каждые</guilabel
> для настройки повторения или снимите его для удаления повторения. Если флажок <guilabel
>Повторять каждые</guilabel
> установлен, настройте повторение следующим образом:</para>

<itemizedlist>
<listitem
><para
>Задайте временной интервал между повторениями с помощью элементов управления, расположенных рядом с флажком <guilabel
>Повторять каждые</guilabel
>. Выберите нужные единицы измерения времени (например,<guilabel
>дни</guilabel
>) и введите количество времени.</para>
</listitem>

<listitem
><para
>Укажите либо количество повторений, либо продолжительность повторения:</para>

<itemizedlist>
<listitem
><para
>Параметр <guilabel
>Количество дополнительных напоминаний</guilabel
> позволяет ввести количество срабатываний напоминания после основного повторения. Например, чтобы при каждом основном повторении напоминание срабатывало 4 раза, то есть 3 раза срабатывало дополнительно, в этом поле следует указать значение 3.</para>
</listitem>

<listitem
><para
>Параметр <guilabel
>Продолжительность</guilabel
> позволяет указать общий период времени, в течение которого следует повторять напоминание. Нет необходимости рассчитывать его кратным интервалу повторения; период будет автоматически округлён при нажатии кнопки <guibutton
>OK</guibutton
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note
><para
>Чтобы дополнительные повторения одного и того же напоминания не накладывались друг на друга, для продолжительности дополнительных напоминаний установлено ограничение — она должна быть короче самого длинного интервала между основными повторениями. При каждом срабатывании напоминания согласно расписанию основного повторения отменяются все запущенные при предыдущем срабатывании дополнительные напоминания, которые ещё активны.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Другие параметры</title>

<para
>Для текстовых напоминаний доступен флажок <guilabel
>Запросить подтверждение о прочтении напоминания</guilabel
>, который позволяет указать, следует ли запрашивать подтверждение при закрытии окна напоминания. Это возможно использовать для предотвращения случайного закрытия напоминаний.</para>

<para
>Флажок <guilabel
>Показывать в &korganizer;</guilabel
> позволяет добавить напоминание в активный календарь &korganizer; — оно будет показано как событие без напоминания. Благодаря этому параметру возможно отслеживать напоминания в &korganizer;, продолжая использовать функционал &kalarm;.</para>

<note
><para
>Если в дальнейшем изменить или удалить напоминание в &kalarm;, соответствующее событие в &korganizer; также будет изменено или удалено. Но если изменить событие в &korganizer;, это не повлияет на соответствующее напоминание в &kalarm;.</para
></note>

<para
>Кнопка <guibutton
>Загрузить шаблон...</guibutton
> позволяет выбрать шаблон, параметры которого будут показаны в диалоге (подробные сведения доступны в разделе <link linkend="create-edit"
>Создание и управление напоминаниями</link
>). </para>

<para
>Кнопка <guibutton
>Опробовать</guibutton
> позволяет протестировать напоминание, чтобы убедиться в правильности его работы. Напоминание выполняется точно так же, как и при обычном запланированном срабатывании. При проверке звукового напоминания для остановки воспроизведения звукового файла следует нажать кнопку <guibutton
>Опробовать</guibutton
> ещё раз.</para>

<para
>По завершении настройки напоминания нажмите кнопку <guibutton
>OK</guibutton
>, чтобы добавить напоминание в список. Обратите внимание, что при редактировании существующего напоминания кнопка <guibutton
>OK</guibutton
> станет доступна только после внесения каких-либо изменений.</para>

</sect2>
</sect1>

<sect1 id="message-display">
<title
>Показ напоминаний</title>

<para
>В <link linkend="alarm-edit-dlg"
>диалоге изменения напоминания</link
> возможно выбрать, каким образом следует показывать напоминание: в окне или как системное уведомление. Далее приводится описание этих двух вариантов показа.</para>

<para
>Если показ уведомлений на рабочем столе запрещён, текстовые напоминания (независимо от того, показываются ли они в окнах или как уведомления) не будут отображаться до тех пор, пока он не будет снова разрешён.</para>

<sect2 id="message-window">
<title
>Окно напоминания</title>

<para
>Напоминания, которые отображаются в окнах, обеспечивают наибольшую функциональность.</para>

<para
>Когда напоминание срабатывает, оно появляется на всех рабочих столах поверх обычных окон, чтобы пользователь точно заметил его. В окне сообщения показано время, на которое было запланировано напоминание — пользователь узнает, когда оно появилось, даже если не был за компьютером во время его появления. Если запланированное время срабатывания напоминания относится к часовому поясу, отличному от используемого на локальном компьютере, он также будет показан. (Если напоминание является дополнительным, в заголовке окна будет текст <quote
>Предварительное напоминание</quote
>, при этом отображаемые дата и время относятся к основному напоминанию или его повторению, а не к дополнительному напоминанию.)</para>

<para
>Если в <link linkend="alarm-edit-dlg"
>диалоге изменения напоминания</link
> не установлен флажок <guilabel
>Закрыть напоминание после истечения периода опоздания</guilabel
>, окна напоминаний остаются на экране до тех пор, пока пользователь не закроет их. Если напоминание повторяется и на экране осталось незакрытое пользователем окно сообщения от предыдущего срабатывания, то при очередном срабатывании напоминания это окно просто будет поднято. Благодаря этому не потребуется закрывать несколько окон с одним и тем же напоминанием, если пользователь по какой-либо причине не закрыл окно напоминания при его срабатывании.</para>

<para
>При выводе окна напоминания в зависимости от типа напоминания могут быть доступны следующие действия:</para>

<itemizedlist>
<listitem>
<para
>Принять напоминание путём нажатия кнопки <guibutton
>Закрыть</guibutton
>. Окно напоминания будет закрыто (после подтверждения, если установлен параметр <guilabel
>Запросить подтверждение о прочтении напоминания</guilabel
>).</para>
</listitem>

<listitem>
<para
>Изменить напоминание путём нажатия кнопки <guibutton
>Изменить...</guibutton
>. Будет показан <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>.</para>
</listitem>

<listitem>
<para
>Показать параметры отсрочки напоминания путём нажатия кнопки <guibutton
>Отложить...</guibutton
>. Выберите параметр <guilabel
>Отложить на дату/время</guilabel
> и введите дату и время повторного показа напоминания или выберите параметр <guilabel
>Отложить на определённый срок</guilabel
> и укажите время (в часах и минутах), на которое следует отложить показ напоминания. Затем нажмите кнопку <guibutton
>ОК</guibutton
>, чтобы отложить напоминание и закрыть его окно.</para>

<note
><para
>Время, на которое откладывается напоминание, должно предшествовать времени его следующего запланированного повторения или следующего предварительного напоминания. Поэтому кнопка <guibutton
>Отложить...</guibutton
> в окне напоминания и кнопка <guibutton
>OK</guibutton
> в диалоге отсрочки становятся недоступными за минуту до следующего повторения или предварительного напоминания.</para>
<para
>Обратите внимание, что если дополнительное напоминание было настроено на срабатывание <emphasis
>после</emphasis
> основного напоминания, основное напоминание <emphasis
>возможно</emphasis
> перенести на более отдалённое время, чем время этого дополнительного напоминания. В этом случае дополнительное напоминание будет подавлено.</para
></note>

<note
><para
>Для напоминаний, которые показываются при входе в систему, кнопка <guibutton
>Отложить...</guibutton
> недоступна из-за включённого параметра <guilabel
>При входе в систему</guilabel
>.</para
></note>
</listitem>

<listitem>
<para
>Остановить воспроизведение звукового файла напоминания нажатием кнопки с символом <quote
>остановки воспроизведения</quote
>.</para>
</listitem>

<listitem>
<para
>Если сообщение напоминания было создано путём перетаскивания письма из &kmail;, возможно перейти непосредственно к этому письму в &kmail; по нажатию кнопки со значком &kmail;. При этом письмо будет показано, а содержащая его папка — выделена в списке папок &kmail;.</para>

<warning
><para
>Если индексные файлы &kmail; будут созданы заново, ссылка на письмо в &kmail; перестанет работать.</para
></warning>
</listitem>

<listitem>
<para
>Кнопка со значком <guiicon
>&kalarm;</guiicon
> позволяет вызвать главное окно приложения &kalarm;, в котором это напоминание будет выделено цветом.</para>
</listitem>
</itemizedlist>

<para
>В <link linkend="preferences-view"
>диалоге настройки</link
> возможно выбрать один из двух режимов показа окон напоминаний:</para>

<itemizedlist>
<listitem>
<para
>Как обычное окно. В этом режиме фокус клавиатуры захватывается окном напоминания, когда оно появляется. Если пользователь что-либо печатает в это время, нажатия клавиш будут переданы этому окну, а не первоначальному приложению.</para>
</listitem>

<listitem>
<para
>Как немодальное окно. В этом режиме фокус клавиатуры не будет перехвачен появившимся окном напоминания, соответственно, оно не помешает пользователю печатать. Однако в этом режиме окно отображается без заголовка и рамки, поэтому будет нельзя переместить его или изменить его размер.</para>
</listitem>
</itemizedlist>

<note
><para
>Независимо от выбранного значения этого параметра настройки, напоминание будет находиться в режиме немодального окна при показе поверх полноэкранного приложения. Это следствие ограничений оконной системы.</para
></note>

<sect3>
<title
>Положение окон напоминаний</title>

<para
>В <link linkend="preferences-view"
>диалоге настройки</link
> возможно выбрать одну из двух схем размещения окон напоминаний:</para>

<itemizedlist>
<listitem>
<para
>Окна будут показаны на максимально возможном расстоянии от указателя мыши. В этом режиме их появление меньше отвлекает от работы, а также снижается вероятность случайного закрытия напоминания.</para>
</listitem>

<listitem>
<para
>Окна будут показаны по центру экрана. Для снижения вероятности случайного закрытия напоминания кнопки управления окном становятся активными не сразу, а только после настраиваемой задержки.</para>
</listitem>
</itemizedlist>

<para
>Если показано несколько окон напоминаний или сообщений об ошибках, с помощью параметра меню <menuchoice
> <guimenu
>Вид</guimenu
><guimenuitem
>Разбрасывать окна</guimenuitem
> </menuchoice
> возможно распределить окна по экрану, чтобы сделать видимыми их все, или снова сгруппировать их в левом верхнем углу экрана. При необходимости для этого действия возможно настроить глобальную комбинацию клавиш.</para>

</sect3>
</sect2>

<sect2>
<title
>Уведомление с напоминанием</title>

<para
>Для напоминаний, которые отображаются в виде системных уведомлений, возможно настроить меньшее количество параметров, чем для отображаемых в окнах напоминаний.</para>

<para
>Когда напоминание срабатывает, оно появляется в виде уведомления. В уведомлении показано время, на которое было запланировано напоминание. Если запланированное время срабатывания напоминания относится к часовому поясу, отличному от используемого на локальном компьютере, он также будет показан. (Если напоминание является дополнительным, в заголовке окна будет текст «Предварительное напоминание», при этом отображаемые дата и время относятся к основному напоминанию или его повторению, а не к дополнительному напоминанию.)</para>

<para
>Уведомление автоматически закрывается по истечении непродолжительного времени ожидания. (Обратите внимание, что для всех приложений используется одно и то же значение времени ожидания, которое возможно изменить в параметрах системы.) Когда время ожидания уведомления истекает, оно продолжает отображаться в журнале уведомлений до тех пор, пока не будет удалено пользователем или пока пользователь не завершит сеанс. Так как приложения не имеют доступа к журналу уведомлений, &kalarm; не позволяет удалить или заменить уведомления в журнале. Поэтому в журнале может содержаться несколько уведомлений для одного и того же напоминания, включая предварительные напоминания и повторы.</para>

<para
>Уведомление, содержащее напоминание, предоставляет следующие варианты действий. Обратите внимание, что при выборе любого из них уведомление сразу же будет закрыто и не будет показано в журнале уведомлений. Также следует учитывать, что эти варианты доступны только для активных уведомлений, время ожидания которых ещё не истекло. Если в дальнейшем открыть уведомление в журнале уведомлений, будет возможно выполнить только одно действие — удалить его из журнала (какие-либо другие действия не поддерживаются системой уведомлений).</para>

<itemizedlist>
<listitem>
<para
>Принять напоминание, нажав кнопку <guibutton
>Закрыть</guibutton
>. Уведомление будет закрыто.</para>
</listitem>

<listitem>
<para
>Изменить напоминание, нажав кнопку <guibutton
>Изменить</guibutton
>. Будет показан <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
>.</para>
</listitem>

<listitem>
<para
>Просмотреть параметры откладывания напоминания, нажав кнопку <guibutton
>Отложить</guibutton
>. Эта кнопка будет показана только в том случае, если напоминание возможно отложить. Более подробные сведения доступны в описании опции откладывания, которое приводится в разделе <link linkend="message-window"
>Окно напоминания</link
>.</para>
</listitem>

<listitem>
<para
>При щелчке по любому месту уведомления, отличному от кнопки, будет открыто главное окно приложения &kalarm;, в котором это напоминание будет выделено цветом.</para>
</listitem>

</itemizedlist>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Работа с системным лотком</title>

<para
>&kalarm; по умолчанию отображает значок в системном лотке. Этот значок позволяет как управлять программой, так и получать информацию о состоянии отслеживания напоминаний. Обычный значок &kalarm; означает, что напоминания отслеживаются, а два других значка — что не отслеживаются некоторые или все напоминания. Внешний вид двух других значков зависит от используемой темы значков.</para>

<para
>Значок &kalarm; в системном лотке по умолчанию будет автоматически скрыт, если в течение следующих 24 часов не предвидится напоминаний. <link linkend="preferences-view"
>Диалог настройки</link
> позволяет изменить ограничение по времени для автоматического скрытия или задать постоянный показ значка в системном лотке. Чтобы показать значок, который был автоматически скрыт, щёлкните по стрелке в системном лотке — скрытые значки будут показаны.</para>

<para
>Если навести указатель мыши на значок в системном лотке, появится всплывающая подсказка с первыми несколькими напоминаниями, которые запланированы на следующие 24 часа. <link linkend="preferences-view"
>Диалог настройки</link
> позволяет отключить эту возможность или настроить количество и формат напоминаний для отображения в подсказке.</para>

<para
>Щелчок <mousebutton
>левой</mousebutton
> кнопки мыши по значку в системном лотке позволяет показать или скрыть главное окно &kalarm;.</para>

<para
>Щелчок <mousebutton
>правой</mousebutton
> кнопки мыши по значку в системном лотке позволяет вызвать контекстное меню программы:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Активировать напоминания</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Включить или отключить отслеживание напоминаний.</action
></para>
<para
>Более подробные сведения доступны в разделе <link linkend="enable-disable"
>Включение и отключение напоминаний</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Создать напоминание</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>После выбора типа напоминания в появившемся списке будет открыт диалог изменения напоминания, который позволяет создать новое напоминание.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Остановить воспроизведение</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Остановить воспроизведение текущего воспроизводимого звукового файла.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Разбрасывать окна</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Распределить окна напоминаний и сообщений об ошибках по экрану или снова сгруппировать их.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Настроить &kalarm;...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Показать диалог настройки &kalarm;.</action
></para>
<para
>Описание диалога настройки доступно в разделе <link linkend="preferences"
>Настройка &kalarm;</link
>. Этот диалог также содержит параметры, связанные со значком &kalarm; в системном лотке.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Восстановить / Свернуть</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Восстановить или свернуть главное окно &kalarm;.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Выход</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Убрать значок &kalarm; из системного лотка и закрыть главные окна программы.</action
></para>
<para
>Выйти из &kalarm;, если отсутствуют окна напоминаний.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title
>Отображение &kalarm; в системном лотке</title>

<para
>Для отображения &kalarm; в системном лотке должен быть запущен рабочий стол &plasma; или другой подходящий диспетчер окон.</para>

<para
>Чтобы отобразить &kalarm; в системном лотке в соответствии с параметрами, заданными на вкладке <link linkend="preferences-view"
>Вид</link
> диалога настройки, выберите пункт меню <menuchoice
><guimenu
>Вид</guimenu
> <guimenuitem
>Показать в системном лотке</guimenuitem
></menuchoice
>.</para>

<para
>Чтобы убрать &kalarm; из системного лотка, снимите флажок <menuchoice
> <guimenu
>Вид</guimenu
><guimenuitem
>Показать в системном лотке</guimenuitem
></menuchoice
>.</para>

<para
>На вкладке <link linkend="preferences-view"
>Вид</link
> диалога настройки возможно задать, следует ли показывать &kalarm; в системном лотке при запуске.</para>
</sect2>
</sect1>

<sect1 id="refreshing">
<title
>Обновление напоминаний</title>

<para
>Если напоминание не сработало в запланированное время (что маловероятно), возможно обновить список напоминаний и вызвать срабатывание таких напоминаний. Для этого выберите пункт меню <menuchoice
> <guimenu
>Действия</guimenu
><guimenuitem
>Обновить</guimenuitem
> </menuchoice
>. Все календари напоминаний будут перезагружены.</para>

<para
>Чтобы перезагрузить отдельный календарь и обновить содержащиеся в нём напоминания, щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по календарю в списке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Обновить</guimenuitem
></menuchoice
>. Подробные сведения доступны в разделе <link linkend="calendars"
>Календари напоминаний</link
>.</para>

</sect1>

<sect1 id="enable-disable">
<title
>Включение и отключение напоминаний</title>

<para
>Напоминания возможно включать и отключать как все вместе, так и по отдельности:</para>

<itemizedlist>
<listitem>
<para
><quote
>Отслеживание напоминаний</quote
> применяется сразу ко всем напоминаниям. Когда отслеживание напоминаний отключено, они не будут срабатывать. Когда отслеживание напоминаний включено (обычный режим), в надлежащее время будут срабатывать все напоминания, за исключением тех, которые были отключены отдельно.</para>

<para
>При повторном включении отслеживания напоминаний сработают те напоминания, которые должны были сработать в период отключения отслеживания (если этому не препятствуют какие-либо параметры обработки просроченных напоминаний). Иными словами, отключение отслеживания напоминаний действует так же, как и остановка программы &kalarm; — напоминания откладываются до повторного включения.</para>
</listitem>

<listitem>
<para
>Напоминания возможно включать и отключать по отдельности, независимо от состояния отслеживания напоминаний. Поэтому состояние «включено» или «отключено» отдельных напоминаний не изменится при отключении и последующем повторном включении отслеживания напоминаний. Отключение отслеживания отдельных напоминаний возможно выполнить только с помощью команд меню (в отличие от отключения отслеживания всех напоминаний, которое происходит, если программа &kalarm; не запущена).</para>

<para
>Когда отдельное напоминание снова включается, оно не сработает, если срабатывание было запланировано на период отключения. Иными словами, отключение отдельного напоминания отменяет все его повторы вплоть до повторного включения.</para>

<para
>В списке напоминаний состояние «включено» или «отключено» отдельного напоминания обозначается цветом (этот цвет возможно настроить на вкладке <link linkend="preferences-view"
>Вид</link
> диалога настройки).</para>
</listitem>
</itemizedlist>

<para
>Чтобы напоминание сработало, необходимо отдельно включить его, а также включить отслеживание напоминаний.</para>

<sect2>
<title
>Включение отслеживания напоминаний</title>

<para
>Для выполнения отслеживания напоминаний программа &kalarm; должна быть запущена. После запуска пользователем программа в дальнейшем будет автоматически запускаться при входе в систему (это поведение возможно отключить на вкладке <link linkend="preferences-general"
>Главное</link
> диалога настройки).</para>

<para
>Если отслеживание напоминаний отключено, выполните одно из следующих действий для включения напоминаний:</para>

<itemizedlist>
<listitem>
<para
>Выберите пункт меню <menuchoice
><guimenu
>Действия</guimenu
> <guimenuitem
>Активировать напоминания</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по значку в системном лотке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Активировать напоминания</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Отключение отслеживания напоминаний</title>

<para
>Существует несколько способов отключить отслеживание напоминаний. Если оно отключено, &kalarm; не будет показывать напоминания, пока пользователь не включит отслеживание снова или — если программа &kalarm; настроена на запуск при входе в систему — не выполнит следующий вход в систему.</para>

<itemizedlist>
<listitem>
<para
>Снимите флажок <menuchoice
><guimenu
>Действия</guimenu
> <guimenuitem
>Активировать напоминания ...</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по значку в системном лотке и снимите в контекстном меню флажок <menuchoice
><guimenuitem
>Активировать напоминания</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Запустите &kalarm; с параметром командной строки <option
>--disable-all</option
>.</para>
</listitem>

<listitem>
<para
>Завершите работу &kalarm;, как описано в разделе <link linkend="quitting"
>Выход из &kalarm;</link
>.</para>
</listitem>
</itemizedlist>

<para
>Напоминания возможно отключить на постоянной основе. Для этого на вкладке <link linkend="preferences-general"
>Главное</link
> диалога настройки следует запретить запуск &kalarm; при входе в систему.</para>

</sect2>

<sect2>
<title
>Включение и отключение отдельных напоминаний</title>

<para
>Для включения отдельных напоминаний выполните одно из следующих действий:</para>

<itemizedlist>
<listitem>
<para
>Выделите одно или несколько напоминаний, щёлкнув по соответствующим записям в списке. Затем выберите пункт меню <menuchoice
> <guimenu
>Действия</guimenu
><guimenuitem
>Включить</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по нужным записям напоминаний в списке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Включить</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

<para
>Для отключения отдельных напоминаний выполните одно из следующих действий:</para>

<itemizedlist>
<listitem>
<para
>Выделите одно или несколько напоминаний, щёлкнув по соответствующим записям в списке. Затем выберите пункт меню<menuchoice
> <guimenu
>Действия</guimenu
><guimenuitem
>Отключить</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши по нужным записям напоминаний в списке и выберите в контекстном меню пункт <menuchoice
><guimenuitem
>Отключить</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="wake-suspend">
<title
>Пробуждение системы</title>

<para
>Выбранное напоминание возможно настроить таким образом, чтобы оно при срабатывании выводило компьютер из спящего или ждущего режима, то есть позволяло выполнить заданное действие даже тогда, когда система не активна. Чтобы настроить эту возможность, выберите пункт меню <menuchoice
><guimenu
>Действия</guimenu
> <guimenuitem
>Разбудить систему...</guimenuitem
></menuchoice
>. Будет открыто диалоговое окно, в котором возможно задать, отменить или показать напоминание, содержащее сигнал пробуждения системы.</para>

<para
>Для использования функции пробуждения системы необходимы права администратора. При установке или отмене напоминания, содержащего сигнал пробуждения системы, будет предложено ввести пароль пользователя «root».</para>

<note
><para
>Поддержка функции пробуждения системы имеется не на всех компьютерах (её отсутствие особенно вероятно на устаревших компьютерах), и некоторые компьютеры ограничивают устанавливаемое время пробуждения следующими 24 часами. Кроме того, возможность пробуждения системы может зависеть от конкретного режима приостановки работы. Поэтому рекомендуется сначала проверить работу функции пробуждения системы с помощью тестовых напоминаний.</para
></note>

<warning
><para
>Для компьютера возможно запланировать только один сигнал пробуждения системы. Если эта функция используется в &kalarm;, необходимо убедиться в отсутствии конфликтов с другими приложениями, которые также используют её. Когда в приложении задаётся или отменяется сигнал пробуждения системы, это действие отменяет любой установленный ранее сигнал, независимо от того, где он был установлен — в &kalarm; или в любом другом приложении.</para
></warning>

<para
>Диалог пробуждения системы используется совместно со списком напоминаний в главном окне &kalarm;.</para>

<itemizedlist>
<listitem>
<para
><guibutton
>Использовать выделенное напоминание</guibutton
>: в качестве напоминания, содержащего сигнал пробуждения системы, будет использовано текущее выделенное в списке напоминание. Существующий сигнал пробуждения системы (если он имеется) будет отменён, как поясняется выше. Эта кнопка активна только в том случае, если выделено всего одно напоминание.</para>
</listitem>

<listitem>
<para
><guibutton
>Отменить сигнал «разбудить систему»</guibutton
>: существующий сигнал пробуждения системы будет отменён (независимо от того, был ли он задан в &kalarm; или в любом другом приложении — смотрите выше). Обратите внимание, что будет отменена только функция пробуждения, связанная с напоминанием; само напоминание не будет удалено и продолжит работать в обычном режиме.</para>
</listitem>

<listitem>
<para
><guibutton
>Показать текущее напоминание</guibutton
>: текущее напоминание, содержащее сигнал пробуждения системы, будет выделено в списке напоминаний. Если такое напоминание отсутствует, эта кнопка недоступна.</para>
</listitem>

<listitem>
<para
>В поле со счётчиком <guilabel
>Количество минут до сигнала «разбудить систему»</guilabel
> возможно указать время, которое позволит системе полностью восстановиться перед срабатыванием напоминания и, соответственно, предоставить ему возможность сработать в правильное время.</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="quitting">
<title
>Выход из &kalarm;</title>

<para
>Чтобы выйти из программы &kalarm;, выберите пункт меню <menuchoice
> <guimenu
>Файл</guimenu
><guimenuitem
>Выход</guimenuitem
></menuchoice
> или пункт <menuchoice
><guimenuitem
>Выход</guimenuitem
></menuchoice
> в контекстном меню значка в системном лотке. В том случае, если значок не отображается в системном лотке, закройте все окна &kalarm;.</para>

</sect1>
</chapter>

<chapter id="preferences">
<title
>Настройка &kalarm;</title>

<para
>Диалог настройки (<menuchoice
><guimenu
>Настройка</guimenu
> <guimenuitem
>Настроить &kalarm;...</guimenuitem
></menuchoice
>) позволяет настроить работу &kalarm; в соответствии с параметрами установленной системы и предпочтениями пользователя.</para>

<sect1 id="preferences-general">
<title
>Главное</title>

<para
>Раздел <guilabel
>Главное</guilabel
> позволяет настроить поведение &kalarm;:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Запускать при входе в систему</guilabel
>: &kalarm; будет запускаться при входе в систему, что обеспечивает постоянную работу &kalarm; вплоть до выполнения выхода из программы вручную.</para>

<warning
><para
>Этот параметр всегда должен быть включён (если только не планируется прекратить использование &kalarm;).</para
></warning>

<note
><para
>Этот флажок автоматически устанавливается при каждом запуске &kalarm;. Поэтому его будет необходимо каждый раз вручную снимать после запуска &kalarm;, если требуется, чтобы программа &kalarm; не запускалась при входе в систему.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Предупреждение перед выходом</guilabel
>: если этот флажок установлен, при попытке завершения работы &kalarm; с помощью пункта <menuchoice
><guimenu
>Выход</guimenu
></menuchoice
> контекстного меню значка в системном лотке будет запрошено подтверждение. Это предотвращает случайное отключение напоминаний. В целях безопасности этот параметр автоматически включается при каждой смене режима выполнения.</para>
</listitem>

<listitem
><para
><guilabel
>Включить названия напоминаний</guilabel
>: укажите, возможно ли назначать напоминаниям названия для облегчения их последующей идентификации. Этот параметр определяет, будет ли столбец <guilabel
>Название</guilabel
> показан в <link linkend="alarm-list"
>списке напоминаний</link
> и появится ли поле <guilabel
>Название напоминания</guilabel
> в <link linkend="alarm-edit-dlg"
>диалоге изменения напоминания</link
>.</para>
</listitem>

<listitem
><para
><guilabel
>Подтвердить удаление напоминаний</guilabel
>: определяет, будет ли запрошено подтверждение удаления каждого напоминания.</para>
</listitem>

<listitem
><para
><guilabel
>По умолчанию отложить на заданный интервал</guilabel
>: введите временной интервал по умолчанию (в часах и минутах), который будет показан при открытии диалога отсрочки напоминания. Обратите внимание, что если напоминание откладывалось ранее, то показанный при открытии диалога отсрочки напоминания интервал будет равен последнему использованному интервалу отсрочки.</para>
</listitem>

<listitem
><para
><guilabel
>Терминал для выполнения команд напоминаний</guilabel
>: этот блок параметров позволяет задать тип окна терминала для команд напоминаний. Предварительно настроены некоторые из наиболее распространённых приложений терминала, например <application
>xterm</application
> и &konsole; (но будут показаны только те приложения, которые установлены в системе). Чтобы просмотреть фактические параметры команды, которые используются для каждого приложения, следует воспользоваться контекстной справкой для соответствующего переключателя.</para>

<para
>Если требуется использовать другое приложение (или одно из перечисленных в диалоге, но с другими параметрами команды), выберите параметр <guilabel
>Дополнительно</guilabel
> и введите команду для вызова окна терминала. По умолчанию к этой введённой команде будет добавлена строка команды напоминания. Другой возможный вариант — указать место вставки строки команды напоминания с помощью следующих кодов:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>Будет заменена строка команды напоминания.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>Будет заменена строка команды напоминания, с добавлением <literal
>sleep</literal
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%C</term>
<listitem>
<para
>Будет создан временный файл команды, содержащий строку команды напоминания, и заменена команда исполнения файла.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%W</term>
<listitem>
<para
>Будет создан временный файл команды, содержащий строку команды напоминания, с добавлением <literal
>sleep</literal
>, и заменена команда исполнения файла.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%t</term>
<listitem>
<para
>Будет заменено название &kalarm; на текущем языке.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>При срабатывании командного напоминания строка команды заключается в кавычки перед вставкой в команду окна терминала.</para>
</listitem>

<listitem
><para
><guilabel
>Включить Akonadi</guilabel
>: укажите, следует ли использовать &akonadi; для предоставления возможностей, зависящих от этого механизма. Подробнее: <link linkend="akonadi-plugin"
>Подключаемый модуль Akonadi</link
>. Обратите внимание, что этот параметр будет показан только в том случае, если подключаемый модуль Akonadi установлен.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Дата и время</title>

<para
>Раздел <guilabel
>Дата и время</guilabel
> позволяет настроить параметры даты и времени:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Часовой пояс</guilabel
>: выберите часовой пояс. Он будет использован для всех напоминаний &kalarm; (при необходимости его возможно изменить для отдельных напоминаний).</para>
</listitem>

<listitem
><para
><guilabel
>Профиль праздников</guilabel
>: выберите праздники страны или региона, которые следует использовать. Выбранное значение этого параметра применяется к повторяющимся напоминаниям, для которых включено исключение праздников.</para>
</listitem>

<listitem
><para
><guilabel
>Время показа напоминаний без указанного времени</guilabel
>: установите время начала дня для показа напоминаний, у которых установлена только дата (то есть напоминаний, для которых установлен параметр <guilabel
>Время не указано</guilabel
>). В день, когда напоминание должно сработать, оно будет показано при первой же возможности в течение 24 часов со времени начала дня.</para>
</listitem>

<listitem
><para
>Блок <guilabel
>Рабочие часы</guilabel
>: эти параметры позволяют задать рабочие часы (это необходимо, когда для повторения в <link linkend="alarm-edit-dlg"
>диалоге изменения напоминания</link
> включён параметр <guilabel
>Только в рабочее время</guilabel
>).</para>

<itemizedlist>
<listitem
><para
>Отметьте флажками все те дни, которые являются рабочими.</para>
</listitem>

<listitem
><para
><guilabel
>Время начала рабочего дня</guilabel
>: введите время ежедневного начала работы.</para>
</listitem>

<listitem
><para
><guilabel
>Время окончания рабочего дня</guilabel
>: введите время ежедневного окончания работы.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Длительность события KOrganizer</guilabel
>: введите длительность события, которая будет использоваться &korganizer; для скопированных в программу напоминаний. По умолчанию длительность равна нулю.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-storage">
<title
>Хранение</title>

<para
>Раздел <guilabel
>Хранение</guilabel
> позволяет настроить параметры сохранения и архивирования напоминаний:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Новые напоминания и шаблоны</guilabel
>: укажите календарь, в котором следует сохранять новые напоминания и шаблоны напоминаний при использовании нескольких календарей напоминаний:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Сохранять в календаре по умолчанию</guilabel
>: новые напоминания и шаблоны напоминаний будут автоматически добавляться в календарь по умолчанию без запроса подтверждения.</para>
</listitem>

<listitem>
<para
><guilabel
>Выдавать запрос на сохранение</guilabel
>: если имеется несколько доступных для записи календарей, в которые могут быть сохранены новое напоминание или шаблон напоминания, пользователю будет предложено выбрать календарь. Обратите внимание, что напоминания с истекшим сроком действия всегда сохраняются в используемом по умолчанию календаре устаревших напоминаний без вывода запроса.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Блок <guilabel
>Устаревшие напоминания</guilabel
>: эти параметры определяют правила хранения устаревших напоминаний в используемом по умолчанию календаре устаревших напоминаний.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Сохранять напоминания после показа</guilabel
>: включите этот параметр, если следует хранить устаревшие и удалённые напоминания. Если флажок не установлен, напоминания будут удаляться, как только станут неактивными. Обратите внимание, что удалённые напоминания сохраняются только в том случае, если они срабатывали ранее. Если удалить напоминание до первого срабатывания, оно не будет сохранено.</para>
</listitem>

<listitem
><para
><guilabel
>Удалять устаревшие напоминания через</guilabel
>: установите количество дней хранения устаревших и удалённых напоминаний в архиве. По истечении указанного времени эти напоминания будут удалены безвозвратно.</para>
</listitem>

<listitem
><para
><guibutton
>Удалить устаревшие напоминания</guibutton
>: эта кнопка позволяет удалить из используемого по умолчанию календаря устаревших напоминаний все хранящиеся в нём напоминания. (При этом не будут изменены другие календари устаревших напоминаний, используемые совместно с другими пользователями.) Это не повлияет на напоминания, которые устареют или будут удалены в дальнейшем; они будут сохранены согласно установленным параметрам.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-email">
<title
>Отправка писем</title>

<para
>Раздел <guilabel
>Отправка писем</guilabel
> позволяет настроить параметры отправки и адресации почтовых напоминаний:</para>

<note
><para
>Параметры, зависящие от &kmail;, доступны только в том случае, если <link linkend="akonadi-plugin"
>подключаемый модуль Akonadi</link
> &kalarm; установлен и включён.</para>
</note>

<itemizedlist>
<listitem>
<para
><guilabel
>Почтовый клиент</guilabel
>: определяет почтовый клиент, который будет использоваться для отправки напоминаний по электронной почте:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: когда почтовое напоминание срабатывает, письмо автоматически отправляется с помощью программы &kmail;.</para>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: когда почтовое напоминание срабатывает, письмо автоматически отправляется с помощью программы <application
>&Sendmail;</application
>. Эта опция будет работать только в том случае, если система настроена на использование <application
>&Sendmail;</application
> или совместимого с &Sendmail; агента пересылки сообщений, такого как <application
>postfix</application
> или <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Копировать отправленные письма в папку &kmail; «Отправленные»</guilabel
>: установите этот параметр, если при срабатывании почтового напоминания следует сохранять копию отправленного письма в папке &kmail;'s <filename
>Отправленные</filename
>.</para>

<note
><para
>Этот параметр недоступен, если в качестве почтового клиента выбрана программа &kmail;, так как &kmail; выполняет это действие автоматически.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Уведомлять при постановке в очередь внешних писем</guilabel
>: установите этот параметр, если следует показывать уведомление, когда почтовое напоминание направляет письмо в очередь на отправку. Такое уведомление о необходимости отправить почту может быть полезно пользователю, когда используется модемное подключение к Интернету или когда письмо добавляется в очередь писем папки <filename
>Исходящие</filename
> &kmail;.</para>
</listitem>

<listitem>
<para
>Выберите адрес электронной почты, который будет использоваться в качестве адреса отправителя в почтовых напоминаниях:</para>

<itemizedlist>
<listitem
><para
>Чтобы ввести адрес электронной почты, выберите параметр <guilabel
>Отправитель</guilabel
>.</para>
</listitem>

<listitem
><para
>Выберите параметр <guilabel
>Использовать профиль KMail по умолчанию</guilabel
> для использования своего стандартного адреса электронной почты, настроенного в &kmail;.</para>
</listitem>

<listitem
><para
>Чтобы получить возможность выбирать профиль &kmail; при настройке почтового напоминания, выберите параметр <guilabel
>Использовать профиль &kmail;</guilabel
>. Для напоминаний, которые были настроены до выбора этого параметра, будет использоваться профиль &kmail; по умолчанию.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Укажите адрес электронной почты, на который пользователь отправляет самому себе скрытые копии почтовых напоминаний (такая отправка выполняется, если включён параметр <guilabel
>Отправить копию письма самому себе</guilabel
>):</para>

<itemizedlist>
<listitem
><para
>Чтобы указать адрес электронной почты, выберите параметр <guilabel
>Скрытая копия</guilabel
>. Если скрытые копии следует направлять по адресу учётной записи пользователя на компьютере, на котором работает &kalarm;, возможно просто ввести в этом поле логин пользователя.</para>
</listitem>

<listitem
><para
>Выберите параметр <guilabel
>Использовать профиль KMail по умолчанию</guilabel
> для использования своего стандартного адреса электронной почты, настроенного в &kmail;.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-view">
<title
>Вид</title>

<para
>Раздел <guilabel
>Вид</guilabel
> позволяет настроить некоторые аспекты внешнего вида &kalarm;. На вкладке <guilabel
>Главное</guilabel
>:</para>
<itemizedlist>

<listitem>
<para
>Группа параметров <guilabel
>Показывать в системном лотке</guilabel
>: когда главный параметр включён, во время работы &kalarm; в системном лотке отображается значок. Возможные варианты:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Показывать всегда</guilabel
>: значок в системном лотке будет отображаться всегда.</para>
</listitem>

<listitem>
<para
><guilabel
>Скрывать автоматически, если нет активных напоминаний</guilabel
>: значок в системном лотке будет скрыт при отсутствии активных напоминаний.</para>
</listitem>

<listitem>
<para
><guilabel
>Автоматически скрывать значок в системном лотке, если напоминания не предвидятся в течение указанного временного периода</guilabel
>: значок в системном лотке будет скрыт, если отсутствуют напоминания, срабатывание которых запланировано на указанный период времени (исчисляется с текущего момента).</para>
</listitem>
</itemizedlist>

<para
>Чтобы показать значок, который был автоматически скрыт, щёлкните по стрелке в системном лотке — скрытые значки будут показаны.</para>

<para
>Если параметр <guilabel
>Показывать в системном лотке</guilabel
> включён, при закрытии программы с помощью контекстного меню значка в системном лотке будут также закрыты и все главные окна &kalarm; и — если нет окон напоминаний — выполнен выход из приложения.</para>
</listitem>

<listitem>
<para
>Блок <guilabel
>Подсказка у значка в системном лотке</guilabel
>: этот блок параметров позволяет настроить отображение информации во всплывающей подсказке, которая появляется при наведении указателя мыши на значок &kalarm; в системном лотке.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Напоминания в следующие 24 часа</guilabel
>: если этот параметр включён, будут показаны сведения о первых нескольких напоминаниях, которые запланированы на следующие 24 часа.</para>
</listitem>

<listitem>
<para
><guilabel
>Максимальное количество напоминаний</guilabel
>: если этот параметр отключён, будут показаны все напоминания, запланированные на следующие 24 часа. Чтобы ограничить максимальное количество отображаемых напоминаний, включите этот параметр.</para>
</listitem>

<listitem>
<para
><guilabel
>Показывать время напоминания</guilabel
>: если этот параметр включён, для каждого напоминания будет показано время, на которое оно запланировано.</para>
</listitem>

<listitem>
<para
><guilabel
>Показывать время до напоминания</guilabel
>: если этот параметр включён, будет показано время, оставшееся до запланированного срабатывания каждого напоминания. Этот промежуток отображается в часах и минутах.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Префикс</guilabel
>: укажите символ или текст для отображения перед временем до напоминания — это позволит отличить его от времени, на которое напоминание запланировано.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Блок <guilabel
>Список напоминаний</guilabel
> позволяет выбрать цвета, которыми отключённые и устаревшие напоминания обозначаются в списке напоминаний в главном окне &kalarm;.</para>
</listitem>
</itemizedlist>

<para
>Вкладка <guilabel
>Окна напоминаний</guilabel
> содержит параметры, которые позволяют настроить внешний вид окон напоминаний.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Как можно дальше от курсора мыши</guilabel
>: если этот параметр включён, окна напоминаний будут расположены на максимально возможном расстоянии от указателя мыши. Это снижает вероятность непреднамеренного закрытия появившегося напоминания случайным нажатием соответствующей кнопки его окна.</para>
</listitem>

<listitem>
<para
><guilabel
>По центру экрана, но отключить на время кнопки управления</guilabel
>: если этот параметр включён, окна напоминаний будут расположены в центре экрана. Чтобы снизить риск случайного закрытия напоминания, кнопки управления его окном становятся активными не сразу. Время задержки (в секундах) возможно задать с помощью параметра <guilabel
>Задержка недоступности кнопок (с)</guilabel
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Окна напоминаний имеют заголовок и переводят на себя фокус</guilabel
>: этот параметр определяет, является ли окно напоминания модальным, то есть переводит ли оно на себя фокус при появлении. Подробные сведения доступны в разделе <link linkend="message-display"
>Показ напоминаний</link
>.</para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-edit">
<title
>Правка</title>

<para
>Раздел <guilabel
>Правка</guilabel
> позволяет задать значения параметров по умолчанию, которые используются в <link linkend="alarm-edit-dlg"
>диалоге изменения напоминания</link
>:</para>

<itemizedlist>
<listitem
><para
>Вкладка <guilabel
>Главное</guilabel
> содержит параметры, которые применяются ко всем типам напоминаний.</para>

<itemizedlist>
<listitem
><para
>Укажите способ показа напоминаний по умолчанию.</para>
</listitem>

<listitem
><para
>Укажите значения по умолчанию для параметров <guilabel
>Показывать в KOrganizer</guilabel
> и <guilabel
>Отмена при невозможности показа</guilabel
>.</para>
</listitem>

<listitem
><para
>Установите тип повторения напоминания по умолчанию.</para>
</listitem>

<listitem
><para
>Выберите способ обработки ежегодных повторений напоминаний, запланированных на 29 февраля, в невисокосные годы.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Вкладка <guilabel
>Типы напоминаний</guilabel
> содержит параметры, которые применяются к определённым типам напоминаний.</para>

<itemizedlist>
<listitem>
<para
>Для текстовых напоминаний:</para>

<itemizedlist>
<listitem
><para
>Укажите значения по умолчанию для параметров <guilabel
>Закрыть напоминание после истечения периода опоздания</guilabel
> и <guilabel
>Запросить подтверждение о прочтении напоминания</guilabel
>.</para>
</listitem>

<listitem
><para
>Установите единицы периода напоминания по умолчанию.</para>
</listitem>

<listitem
><para
>Укажите специальные действия для текстовых напоминаний по умолчанию.</para>
</listitem>

<listitem
><para
>Укажите звуковые параметры по умолчанию. Обратите внимание, что звуковой файл по умолчанию возможно указать даже в том случае, если в качестве типа звука не выбран <guilabel
>Звуковой файл</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Для командных напоминаний:</para>

<itemizedlist>
<listitem
><para
>Укажите значения по умолчанию для параметров <guilabel
>Указать сценарий</guilabel
> и <guilabel
>Выполнить в окне терминала</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Для почтовых напоминаний:</para>

<itemizedlist>
<listitem
><para
>Укажите значение по умолчанию для параметра <guilabel
>Отправить копию письма самому себе</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>На вкладке <guilabel
>Шрифт и цвета</guilabel
> возможно настроить внешний вид напоминаний по умолчанию. Выберите шрифт, а также цвета текста и фона, которые будут использоваться по умолчанию.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Работа с командной строкой</title>

<para
>Если указаны параметры командной строки, &kalarm; не отображает список запланированных напоминаний, описание которого приведено выше в разделе <link linkend="using-kalarm"
>Использование &kalarm;</link
>. Параметры командной строки &kalarm; используются для следующих операций:</para>

<itemizedlist>
<listitem
><para
>планирование нового напоминания</para>
</listitem>
<listitem
><para
>управление режимом отображения &kalarm;</para>
</listitem>
<listitem
><para
>получение помощи</para>
</listitem>
</itemizedlist>

<para
>Дополнительные параметры командной строки предназначены главным образом для предоставления другим программам интерфейса к &kalarm;. Их описание приводится в разделе <link linkend="cmdline-interface"
>Руководство разработчика &kalarm;</link
>.</para>

<para
>Командная строка должна содержать параметры, соответствующие одной операции &kalarm;. Если требуется выполнить несколько операций, следует вызвать &kalarm; несколько раз, каждый раз используя набор параметров для отдельной операции.</para>

<sect1 id="cmdline-schedule">
<title
>Планирование нового напоминания</title>

<para
>Для планирования нового напоминания используются следующие параметры:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Параметр</entry>
  <entry
>Описание</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
> </entry>
  <entry
>Запрашивать подтверждения прочтения при закрытии окна напоминания.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Указать путь или &URL;-адрес файла, который должен быть вложен в письмо. Этот параметр можно использовать несколько раз. Указание параметра <option
>--mail</option
> обязательно.</entry>
</row>
<row>
  <entry
><option
>--auto-close</option
></entry>
  <entry
>Автоматически закрывать окно напоминания по истечении интервала <option
>--late-cancel</option
>. Указание параметра <option
>--late-cancel</option
> обязательно.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
> </entry>
  <entry
>Издавать звуковой сигнал при показе сообщения. Указание параметров <option
>--speak</option
>, <option
>--play</option
> и <option
>--play-repeat</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>--bcc </option
></entry>
  <entry
>Направить скрытую копию письма самому себе. Указание параметра <option
>--mail</option
> обязательно.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>цвет</replaceable
></option
></entry>
  <entry
>Установить цвет фона сообщения, указав имя цвета &Qt; или его шестнадцатеричный код 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>цвет</replaceable
></option
></entry>
  <entry
>Установить цвет текста сообщения, указав имя цвета &Qt; или его шестнадцатеричный код 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>Отключить напоминание. Оно не сработает до тех пор, пока не будет включено вручную.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Отключить отслеживание напоминаний. Это предотвращает срабатывание всех напоминаний до повторного включения отслеживания напоминаний или перезапуска &kalarm; пользователем (например, при следующем входе в систему). Указание параметра <option
>--triggerEvent</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>commandline</replaceable
></option
></entry>
  <entry
>Указать команду оболочки для выполнения. Если команда указана, этот параметр должен быть последним в командной строке &kalarm;. Все последующие параметры команды и опции интерпретируются как часть команды для выполнения. Указание параметров <option
>--file</option
>, <option
>--exec-display</option
> и <option
>--mail</option
> запрещено, а параметры <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> и <option
>--colorfg</option
> будут проигнорированы.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>commandline</replaceable
></option
></entry>
  <entry
>Указать команду оболочки для создания текста напоминания. Если команда указана, этот параметр должен быть последним в командной строке &kalarm; Все последующие параметры команды и опции интерпретируются как часть команды для выполнения. Указание параметров <option
>--exec</option
>, <option
>--file</option
> и <option
>--mail</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Указать путь или &URL;-адрес текстового файла или файла изображения, содержимое которого будет формировать напоминание. Указание параметров <option
>--exec</option
>, <option
>--exec-display</option
> и <option
>--mail</option
> запрещено, как и указание <replaceable
>сообщения</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Использовать данные указанного профиля &kmail; в качестве реквизитов отправителя письма. Указание параметра <option
>--mail</option
> обязательно.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>период</replaceable
></option
></entry>
  <entry
>Интервал между (простыми) повторениями напоминания. Часы/минуты указываются в формате <replaceable
>nHnM</replaceable
>, где <replaceable
>n</replaceable
> — это число, например, 3H30M. Другие интервалы указываются в формате <replaceable
>nX</replaceable
>, где <replaceable
>n</replaceable
> — это число, а <replaceable
>X</replaceable
> — одна из следующих букв: Y (годы), M (месяцы), W (недели), D (дни). Если также указывается параметр <option
>--recurrence</option
>, указание Y и M запрещено. Является обязательным, если указан параметр <option
>--repeat</option
> или <option
>--until</option
>. </entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Показывать напоминание как событие в активном календаре &korganizer;.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>период</replaceable
></option
></entry>
  <entry
>Отменить напоминание, если оно не сработает в течение указанного <replaceable
>периода</replaceable
> после наступления запланированного времени. Часы/минуты указываются в формате <replaceable
>nHnM</replaceable
>, где <replaceable
>n</replaceable
> — это число, например, 3H30M. Другие интервалы указываются в формате <replaceable
>nX</replaceable
>, где <replaceable
>n</replaceable
> — это число, а <replaceable
>X</replaceable
> — одна из следующих букв: W (недели), D (дни). По умолчанию <replaceable
>период</replaceable
> равен 1 минуте.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Вызывать напоминание при каждом входе в систему. Указание параметров <option
>--interval</option
>, <option
>--repeat</option
> и <option
>--until</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>адрес</replaceable
></option
></entry>
  <entry
>Направить письмо по указанному адресу. При необходимости этот параметр возможно указать несколько раз. Указание параметров <option
>--exec</option
>, <option
>--exec-display</option
> и <option
>--file</option
> запрещено, а параметры <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> и <option
>--colorfg</option
> будут проигнорированы.</entry>
</row>
<row>
  <entry
><option
>-n</option
>, <option
>--name</option
></entry>
  <entry
>Указать название для облегчения идентификации напоминания.</entry>
</row>
<row>
  <entry
><option
>-N</option
>, <option
>--notify</option
></entry>
  <entry
>Показывать напоминание как системное уведомление, а не в окне. Указание параметров <option
>--color</option
>, <option
>--colorfg</option
>, <option
>--play</option
>, <option
>--ack-confirm</option
> и <option
>--auto-close</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Указать путь или &URL;-адрес звукового файла, который будет однократно воспроизведён при срабатывании звукового напоминания или показе сообщения напоминания. Указание параметров <option
>--play-repeat</option
>, <option
>--beep</option
> и <option
>--speak</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Указать путь или &URL;-адрес звукового файла, который будет повторяться вплоть до использования функции <guilabel
>Остановить воспроизведение</guilabel
> или закрытия окна напоминания. Указание параметров <option
>--play</option
>, <option
>--beep</option
> и <option
>--speak</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Установить напоминание как многоразовое. Алгоритм повторения указывается с использованием синтаксиса iCalendar (определён в <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>), например: <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. Указание параметра <option
>--until</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>количество</replaceable
></option
></entry>
  <entry
>Указать количество срабатываний напоминания или, если с помощью параметра <option
>--recurrence</option
> задано повторение, срабатываний напоминания при каждом повторении (то есть повторение внутри повторения). Если параметр <option
>--recurrence</option
> отсутствует, укажите -1 to для повторения напоминания в течение неограниченного периода времени. Указание параметра <option
>--interval</option
> обязательно, а указание параметра <option
>--until</option
> — запрещено.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>период</replaceable
></option
></entry>
  <entry
>Вывод дополнительного напоминания за указанное время до или после основного напоминания и каждого из его повторений (если они имеются). <replaceable
>Период</replaceable
> указывается в том же формате, что и для параметра <option
>--late-cancel</option
>. По умолчанию дополнительное напоминание срабатывает до основного напоминания. Чтобы задать срабатывание дополнительное напоминание после основного, добавьте перед <replaceable
>периодом</replaceable
> символ <replaceable
>+</replaceable
>, например: +3D. Указание параметров <option
>--exec</option
>, <option
>--mail</option
> и <option
>--reminder-once</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>период</replaceable
></option
></entry>
  <entry
>Однократный вывод дополнительного напоминания за указанное время до или после первого повторения основного напоминания. Дополнительное напоминание не будет показано до или после остальных повторений основного напоминания (если они имеются). <replaceable
>Период</replaceable
> указывается в том же формате, что и для параметра <option
>--reminder</option
>. Указание параметров <option
>--exec</option
>, <option
>--mail</option
> и <option
>--reminder</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Озвучить сообщение при его показе. Для работы этого параметра необходимо включить поддержку речи при сборке &kalarm;, а также установить модуль речи &Qt;. Указание параметров <option
>--beep</option
>, <option
>--play</option
> и <option
>--play-repeat</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>тема</replaceable
></option
></entry>
  <entry
>Тема письма. Указание параметра <option
>--mail</option
> обязательно.</entry>
</row>
<!-- test-set-time time (debug mode)-->
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>дата/время</replaceable
></option
></entry>
  <entry
>Вызвать напоминание в указанную дату или дату и время. Дата без времени указывается в формате <replaceable
>гггг-мм-дд[ часовой пояс]</replaceable
>; дата и время указываются в формате <replaceable
>[[[гггг-]мм-]дд-]чч:мм[ часовой пояс]</replaceable
> (если не указано, значением даты по умолчанию является текущая дата). Если часовой пояс не указан, используется часовой пояс локальной системы. <replaceable
>Часовой пояс</replaceable
> может быть системным часовым поясом (например, <userinput
>Европа/Лондон</userinput
>) или значением <userinput
>UTC</userinput
>, представляющим соответствующий часовой пояс UTC.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>проценты</replaceable
></option
></entry>
  <entry
>Громкость звука при воспроизведении звукового файла. Указание параметра <option
>--play</option
> или <option
>--play-repeat</option
> обязательно.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>дата/время</replaceable
></option
></entry>
  <entry
>Повторять напоминание до указанной даты или даты и времени. Дата без времени или дата и время указываются с использованием того же синтаксиса, что и для параметра <option
>--time</option
>. Обратите внимание: если параметр <option
>--time</option
> указан, будет использовано заданное им значение часового пояса, а в параметр <option
>--until</option
> нельзя включить часовой пояс. Указание параметра <option
>--interval</option
> обязательно, а параметров <option
>--repeat</option
> и <option
>--recurrence</option
> — запрещено.</entry>
</row>
<row>
  <entry
><replaceable
>сообщение</replaceable
></entry>
  <entry
>Текст сообщения для отображения или — если указан параметр <option
>--mail</option
> — тело письма.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Необходимо указать одно из следующих: текст сообщения, параметры <option
>--file</option
>, <option
>--exec</option
>, <option
>--exec-display</option
>, <option
>--play</option
> или <option
>--play-repeat</option
>; все остальные параметры являются необязательными.</para>

<para
>Два альтернативных примера, отображающие сообщение из нескольких строк на красном фоне в 10 часов утра 27 числа текущего месяца:</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
>"Напоминание\nОСТАНОВИТЬСЯ"</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
>"Напоминание\nОСТАНОВИТЬСЯ"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>

<sect1 id="cmdline-other">
<title
>Другие параметры</title>

<para
>Следующие параметры используются для выполнения различных операций, в том числе вызова <link linkend="alarm-edit-dlg"
>диалога изменения напоминания</link
>.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Параметр</entry>
  <entry
>Описание</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--edit <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Открыть диалог изменения напоминания для редактирования напоминания с указанным идентификатором события. Идентификатор события — это уникальный идентификатор события, который может предваряться названием конфигурации или числовым идентификатором ресурса, содержащего это событие, и записывается в формате <replaceable
>[идентификатор_ресурса:]уникальный_идентификатор_события</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Открыть диалог изменения напоминания для редактирования нового звукового напоминания.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>Открыть диалог изменения напоминания для редактирования нового командного напоминания.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Открыть диалог изменения напоминания для редактирования нового текстового напоминания.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Открыть диалог изменения напоминания для редактирования нового почтового напоминания.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>templateName</replaceable
></option
></entry>
  <entry
>Открыть диалог изменения напоминания, содержащий указанный шаблон напоминания, для редактирования нового напоминания.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Вывести список запланированных напоминаний в <filename
>stdout</filename
>. В списке показаны краткие сведения о каждом ожидающем напоминании: идентификатор ресурса, UID, время следующего срабатывания и текст сообщения или файл.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>Отобразить &kalarm; как значок в системном лотке.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Отключить отслеживание всех напоминаний.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Смотрите также:</para>
<simplelist>
<member
>kf5options(7)</member>
<member
>qt5options(7)</member>
</simplelist>

</sect1>

</chapter>

<chapter id="developers">
<title
>Руководство разработчика &kalarm;</title>

<para
>&kalarm; предоставляет интерфейс, позволяющий другим приложениям запрашивать следующие функции:</para>

<itemizedlist>
<listitem
><para
>планирование нового напоминания</para
></listitem>
<listitem
><para
>отменить запланированное напоминание</para
></listitem>
<listitem
><para
>вызвать срабатывание запланированного напоминания</para
></listitem>
<listitem
><para
>открыть диалог изменения напоминания</para
></listitem>
<listitem
><para
>вывести список запланированных напоминаний</para
></listitem>
</itemizedlist>

<para
>Каждая из вышеупомянутых функций реализована как вызовами &DBus;, так и параметрами командной строки. Если программа &kalarm; уже работает, рекомендуется использовать вызовы &DBus;.</para>

<sect1 id="dbus-interface">
<title
>Интерфейс &DBus;</title>

<para
>Вызовы &DBus;, описание которых приводится в этом документе, все реализованы в пути объекта &DBus; &kalarm; <constant
>/kalarm</constant
>. Интерфейс определён в файлах <filename
>org.kde.kalarm.kalarm.xml</filename
> и <filename
>kalarmiface.h</filename
>.</para>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>отменить запланированное напоминание.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Уникальный идентификатор события, которое следует отменить. Может предваряться названием конфигурации или числовым идентификатором ресурса, содержащего это событие, и записывается в формате <replaceable
>[идентификатор_ресурса:]уникальный_идентификатор_события</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>

<para
><function
>cancelEvent()</function
> — это вызов &DBus; для отмены указанного напоминания. &kalarm; удаляет напоминание из файла календаря без отображения или выполнения.</para>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>вызвать срабатывание запланированного напоминания.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void triggerEvent(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Уникальный идентификатор события, срабатывание которого следует вызвать. Может предваряться названием конфигурации или числовым идентификатором ресурса, содержащего это событие, и записывается в формате <replaceable
>[идентификатор_ресурса:]уникальный_идентификатор_события</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>

<para
><function
>triggerEvent()</function
> — вызов &DBus; для немедленного показа или выполнения указанного напоминания (независимо от его запланированного времени). &kalarm; получает напоминание из файла календаря и отображает или выполняет его.</para>

<para
>Если срок срабатывания напоминания уже наступил, &kalarm; удаляет все запланированные повторения напоминания до текущего времени, и если напоминание больше не должно повторяться, то оно удаляется из файла календаря. Если срок срабатывания напоминания ещё не наступил, все его намеченные повторения остаются неизменными.</para>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>запланировать новое напоминание.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>message</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     const QString&amp; <replaceable
>recurrence</replaceable
>,
                     int <replaceable
>subRepeatInterval</replaceable
>, 
                     int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>message</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>, 
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     int <replaceable
>recurType</replaceable
>, 
                     int <replaceable
>recurInterval</replaceable
>, 
                     int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>message</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>, 
                     int <replaceable
>lateCancel</replaceable
>, 
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     int <replaceable
>recurType</replaceable
>, 
                     int <replaceable
>recurInterval</replaceable
>, 
                     const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Необязательное название напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>message</parameter
></term>
<listitem>
<para
>Текст планируемого сообщения или, если в параметре <parameter
>flags</parameter
> указана часть <userinput
>DISPLAY_COMMAND</userinput
>, команда для создания текста сообщения.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Намеченная дата или дата и время показа сообщения. Если для напоминания задана только дата, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДД[ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Если для напоминания заданы дата и время, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДДTЧЧ:ММ[:СС][ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) или <replaceable
>ЧЧ:ММ[:СС]</replaceable
> (согласно значению, возвращённому <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Если дата не задана, используется текущая дата. Обратите внимание, что значение секунд игнорируется.</para>

<para
>Если часовой пояс не указан, используется часовой пояс локальной системы. <replaceable
>Часовой пояс</replaceable
> может быть системным часовым поясом (например, <userinput
>Европа/Лондон</userinput
>) или значением <userinput
>UTC</userinput
>, представляющим соответствующий часовой пояс UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Отмена напоминания при невозможности срабатывания в течение указанного количества минут после наступления заданного времени срабатывания. Если значение равно нулю, напоминание не будет отменено.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Логическое ИЛИ желаемых флагов напоминания. Биты флагов определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Обратите внимание, что к напоминаниям применимы не все биты флагов.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Цвет фона сообщения. Строка может быть в формате <quote
>#RRGGBB</quote
> (согласно значению, возвращённому <methodname
>QColor::name()</methodname
>), где RR, GG и BB — состоящие из двух цифр шестнадцатеричные значения, соответствующие красному, зелёному и синему цветам. Кроме того, строка может быть в любом другом формате, который принимается методом <methodname
>QColor::setNamedColor()</methodname
>, таком как имя из базы данных цветов X (например, <quote
>red</quote
> или <quote
>steelblue</quote
>). Если значением строки является NULL, используется цвет фона по умолчанию.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fgColor</parameter
></term>
<listitem>
<para
>Цвет текста сообщения. Формат строки совпадает с форматом для параметра <parameter
>bgColor</parameter
>. Также возможно установить значение NULL — в этом случае будет использоваться цвет текста по умолчанию.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>font</parameter
></term>
<listitem>
<para
>Шрифт сообщения. Формат строки соответствует выводу метода <methodname
>QFont::toString()</methodname
>. При установке значения NULL будет использоваться шрифт по умолчанию на момент показа сообщения.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Звуковой файл, который необходимо воспроизвести при показе напоминания. Если это не требуется, установите значение NULL.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Число минут до показа основного напоминания и каждого из его повторений (если они имеются), за которое должно быть показано предварительное напоминание. Если указано отрицательное значение, предварительное напоминание будет показано после основного. Если значение равно нулю, предварительное напоминание не будет показано.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Правило регулярного повторения напоминания. Используется синтаксис iCalendar, определённый в <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Например, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> определяет 4 повторения с 3-месячным интервалом в последний понедельник месяца. Для однократных напоминаний указывается пустая строка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Тип повторения напоминания. Допустимые значения: MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Они определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Ежемесячные повторения соответствуют дню типа месяца, а ежегодные — дате типа года. И в том, и в другом случае дата берётся из параметра <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Количество периодов (минут/дней/недель/месяцев/лет — согласно параметру <parameter
>recurType</parameter
>) между повторениями напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Количество повторов напоминания. Если указано значение -1, напоминание будет повторяться бесконечно.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Дата (или дата и время) окончания повторения напоминания. Если параметр <parameter
>startDateTime</parameter
> включает время, то этот параметр также должен включать время; если параметр <parameter
>startDateTime</parameter
> содержит только дату, то этот параметр также должен содержать только дату. Идентификатор часового пояса не следует указывать, так как для обработки значения этого параметра используется тот же часовой пояс, что и для <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Количество минут между дополнительнымиповторениями напоминания. Если указано нулевое значение, дополнительных повторений напоминания не будет. Если повторение не задано, значение этого параметра игнорируется.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Количество дополнительных повторений напоминания, включая первое напоминание.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Описание</title>
<para
><function
>scheduleMessage()</function
> — это вызов &DBus; для планирования показауказанного напоминания в указанные дату и время. Он имеет три формы. Наиболее общая форма позволяет указать произвольное повторение напоминания — её также возможно использовать для неповторяющихся напоминаний. Другие формы обеспечивают удобный доступ к ограниченному набору типов повторения напоминаний: одна определяет количество повторений, а другая — время окончания.</para>

<para
>Если запланированное время (включая любые повторения) уже прошло, &kalarm; немедленно отобразит напоминание (при условии, что параметр <parameter
>lateCancel</parameter
> не установлен в значение, которое указывает, что напоминание не должно быть отображено). Если запланированное время (или повторение) находится в будущем, &kalarm; добавит напоминание в файл активного календаря по умолчанию для отображения в будущем.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>планирует новое напоминание, отображающее содержимое текстового файла или файла изображения.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>name</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  const QString&amp; <replaceable
>recurrence</replaceable
>,
                  int <replaceable
>subRepeatInterval</replaceable
>, 
                  int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>name</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  int <replaceable
>recurType</replaceable
>,
                  int <replaceable
>recurInterval</replaceable
>,
                  int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>name</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  int <replaceable
>recurType</replaceable
>,
                  int <replaceable
>recurInterval</replaceable
>,
                  const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Необязательное название напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>URL</parameter
></term>
<listitem>
<para
>Текстовый файл или файл изображения, содержимое которого должно быть отображено в планируемом сообщении.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Намеченная дата или дата и время показа сообщения. Если для напоминания задана только дата, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДД[ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Если для напоминания заданы дата и время, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДДTЧЧ:ММ[:СС][ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) или <replaceable
>ЧЧ:ММ[:СС]</replaceable
> (согласно значению, возвращённому <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Если дата не задана, используется текущая дата. Обратите внимание, что значение секунд игнорируется.</para>

<para
>Если часовой пояс не указан, используется часовой пояс локальной системы. <replaceable
>Часовой пояс</replaceable
> может быть системным часовым поясом (например, <userinput
>Европа/Лондон</userinput
>) или значением <userinput
>UTC</userinput
>, представляющим соответствующий часовой пояс UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Отмена напоминания при невозможности срабатывания в течение указанного количества минут после наступления заданного времени срабатывания. Если значение равно нулю, напоминание не будет отменено.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Логическое ИЛИ желаемых флагов напоминания. Биты флагов определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Обратите внимание, что к напоминаниям с показом файлов применимы не все биты флагов.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Цвет фона файла. Строка может быть в формате <quote
>#RRGGBB</quote
> (согласно значению, возвращённому <methodname
>QColor::name()</methodname
>), где RR, GG и BB — состоящие из двух цифр шестнадцатеричные значения, соответствующие красному, зелёному и синему цветам. Кроме того, строка может быть в любом другом формате, который принимается методом <methodname
>QColor::setNamedColor()</methodname
>, таком как имя из базы данных цветов X (например, <quote
>red</quote
> или <quote
>steelblue</quote
>). Если значением строки является NULL, используется цвет фона по умолчанию.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Звуковой файл, который необходимо воспроизвести при показе напоминания. Если это не требуется, установите значение NULL.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Число минут до показа основного напоминания и каждого из его повторений (если они имеются), за которое должно быть показано предварительное напоминание. Если указано отрицательное значение, предварительное напоминание будет показано после основного. Если значение равно нулю, предварительное напоминание не будет показано.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Правило регулярного повторения напоминания. Используется синтаксис iCalendar, определённый в <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Например, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> определяет 4 повторения с 3-месячным интервалом в последний понедельник месяца. Для однократных напоминаний указывается пустая строка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Тип повторения напоминания. Допустимые значения: MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Они определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Ежемесячные повторения соответствуют дню типа месяца, а ежегодные — дате типа года. И в том, и в другом случае дата берётся из параметра <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Количество периодов (минут/дней/недель/месяцев/лет — согласно параметру <parameter
>recurType</parameter
>) между повторениями напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Количество повторов напоминания. Если указано значение -1, напоминание будет повторяться бесконечно.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Дата (или дата и время) окончания повторения напоминания. Если параметр <parameter
>startDateTime</parameter
> включает время, то этот параметр также должен включать время; если параметр <parameter
>startDateTime</parameter
> содержит только дату, то этот параметр также должен содержать только дату. Идентификатор часового пояса не следует указывать, так как для обработки значения этого параметра используется тот же часовой пояс, что и для <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Количество минут между дополнительнымиповторениями напоминания. Если указано нулевое значение, дополнительных повторений напоминания не будет. Если повторение не задано, значение этого параметра игнорируется.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Количество дополнительных повторений напоминания, включая первое напоминание.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>
<para
><function
>scheduleFile()</function
> — это вызов &DBus; для планирования показа определённого текстового файла или файла изображения в указанные дату и время. За исключением указания пути к файлу или его &URL;-адреса и опускания цвета и шрифта текста, использование данной функции идентично <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> — подробные сведения доступны в описании этой функции.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>планирует новое напоминание, которое выполняет команду оболочки.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     const QString&amp; <replaceable
>recurrence</replaceable
>,
                     int <replaceable
>subRepeatInterval</replaceable
>, 
                     int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     int <replaceable
>recurType</replaceable
>,
                     int <replaceable
>recurInterval</replaceable
>,
                     int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     int <replaceable
>recurType</replaceable
>,
                     int <replaceable
>recurInterval</replaceable
>,
                     const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Необязательное название напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>commandLine</parameter
></term>
<listitem>
<para
>Команда, выполнение которой планируется. Параметр <parameter
>flags</parameter
> указывает, содержит ли этот параметр команду или сценарий.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Намеченная дата или дата и время показа сообщения. Если для напоминания задана только дата, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДД[ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Если для напоминания заданы дата и время, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДДTЧЧ:ММ[:СС][ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) или <replaceable
>ЧЧ:ММ[:СС]</replaceable
> (согласно значению, возвращённому <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Если дата не задана, используется текущая дата. Обратите внимание, что значение секунд игнорируется.</para>

<para
>Если часовой пояс не указан, используется часовой пояс локальной системы. <replaceable
>Часовой пояс</replaceable
> может быть системным часовым поясом (например, <userinput
>Европа/Лондон</userinput
>) или значением <userinput
>UTC</userinput
>, представляющим соответствующий часовой пояс UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Отмена напоминания при невозможности срабатывания в течение указанного количества минут после наступления заданного времени срабатывания. Если значение равно нулю, напоминание не будет отменено.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Логическое ИЛИ желаемых флагов напоминания. Биты флагов определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Обратите внимание, что к командным напоминаниям применимы не все биты флагов.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Правило регулярного повторения напоминания. Используется синтаксис iCalendar, определённый в <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Например, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> определяет 4 повторения с 3-месячным интервалом в последний понедельник месяца. Для однократных напоминаний указывается пустая строка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Тип повторения напоминания. Допустимые значения: MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Они определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Ежемесячные повторения соответствуют дню типа месяца, а ежегодные — дате типа года. И в том, и в другом случае дата берётся из параметра <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Количество периодов (минут/дней/недель/месяцев/лет — согласно параметру <parameter
>recurType</parameter
>) между повторениями напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Количество повторов напоминания. Если указано значение -1, напоминание будет повторяться бесконечно.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Дата (или дата и время) окончания повторения напоминания. Если параметр <parameter
>startDateTime</parameter
> включает время, то этот параметр также должен включать время; если параметр <parameter
>startDateTime</parameter
> содержит только дату, то этот параметр также должен содержать только дату. Идентификатор часового пояса не следует указывать, так как для обработки значения этого параметра используется тот же часовой пояс, что и для <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Количество минут между дополнительнымиповторениями напоминания. Если указано нулевое значение, дополнительных повторений напоминания не будет. Если повторение не задано, значение этого параметра игнорируется.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Количество дополнительных повторений напоминания, включая первое напоминание.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>
<para
><function
>scheduleCommand()</function
> — это вызов &DBus; для планирования запуска указанной команды или сценария в указанные дату и время. За исключением указания команды и опускания цвета и шрифта сообщения и параметров звукового файла, использование данной функции идентично <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> — подробные сведения доступны в описании этой функции.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>планирует новое напоминание, которое отправляет электронную почту.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   const QString&amp; <replaceable
>recurrence</replaceable
>,
                   int <replaceable
>subRepeatInterval</replaceable
>, 
                   int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>, 
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   const QString&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Необязательное название напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fromID</parameter
></term>
<listitem>
<para
>Профиль &kmail;, который используется в качестве реквизитов отправителя письма. Если он не указан, будет использоваться адрес отправителя, заданный в разделе настройки <link linkend="preferences-email"
>Отправка писем</link
> &kalarm;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>addresses</parameter
></term>
<listitem>
<para
>Разделённый запятыми список адресов электронной почты получателей.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subject</parameter
></term>
<listitem>
<para
>Тема письма.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>message</parameter
></term>
<listitem>
<para
>Текст письма.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>attachments</parameter
></term>
<listitem>
<para
>Разделённый запятыми список путей или &URL;-адресов файлов для отправки в качестве вложений.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Намеченная дата или дата и время показа сообщения. Если для напоминания задана только дата, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДД[ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Если для напоминания заданы дата и время, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДДTЧЧ:ММ[:СС][ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) или <replaceable
>ЧЧ:ММ[:СС]</replaceable
> (согласно значению, возвращённому <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Если дата не задана, используется текущая дата. Обратите внимание, что значение секунд игнорируется.</para>

<para
>Если часовой пояс не указан, используется часовой пояс локальной системы. <replaceable
>Часовой пояс</replaceable
> может быть системным часовым поясом (например, <userinput
>Европа/Лондон</userinput
>) или значением <userinput
>UTC</userinput
>, представляющим соответствующий часовой пояс UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Отмена напоминания при невозможности срабатывания в течение указанного количества минут после наступления заданного времени срабатывания. Если значение равно нулю, напоминание не будет отменено.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Логическое ИЛИ желаемых флагов напоминания. Биты флагов определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Обратите внимание, что к почтовым напоминаниям применимы не все биты флагов.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Правило регулярного повторения напоминания. Используется синтаксис iCalendar, определённый в <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Например, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> определяет 4 повторения с 3-месячным интервалом в последний понедельник месяца. Для однократных напоминаний указывается пустая строка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Тип повторения напоминания. Допустимые значения: MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Они определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Ежемесячные повторения соответствуют дню типа месяца, а ежегодные — дате типа года. И в том, и в другом случае дата берётся из параметра <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Количество периодов (минут/дней/недель/месяцев/лет — согласно параметру <parameter
>recurType</parameter
>) между повторениями напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Количество повторов напоминания. Если указано значение -1, напоминание будет повторяться бесконечно.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Дата (или дата и время) окончания повторения напоминания. Если параметр <parameter
>startDateTime</parameter
> включает время, то этот параметр также должен включать время; если параметр <parameter
>startDateTime</parameter
> содержит только дату, то этот параметр также должен содержать только дату. Идентификатор часового пояса не следует указывать, так как для обработки значения этого параметра используется тот же часовой пояс, что и для <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Количество минут между дополнительнымиповторениями напоминания. Если указано нулевое значение, дополнительных повторений напоминания не будет. Если повторение не задано, значение этого параметра игнорируется.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Количество дополнительных повторений напоминания, включая первое напоминание.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>
<para
><function
>scheduleEmail()</function
> — это вызов &DBus; для планирования отправки указанного письма в указанные дату и время. За исключением указаниязаголовка письма и его тела и опускания цвета и шрифта сообщения и параметров звукового файла, использование данной функции идентично <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> — подробные сведения доступны в описании этой функции.</para>
</refsect1>
</refentry>


<refentry id="scheduleAudio">
<refmeta>
<refentrytitle
>scheduleAudio</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleAudio</refname>
<refpurpose
>планирует новое напоминание, которое выполняет команду оболочки.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   const QString&amp; <replaceable
>recurrence</replaceable
>,
                   int <replaceable
>subRepeatInterval</replaceable
>, 
                   int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Необязательное название напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Звуковой файл для воспроизведения.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>volumePercent</parameter
></term>
<listitem>
<para
>Уровень громкости для использования, в процентах от полной громкости. Если указано значение -1, используется громкость по умолчанию.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Намеченная дата или дата и время показа сообщения. Если для напоминания задана только дата, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДД[ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Если для напоминания заданы дата и время, эта строка должна быть указана в формате <replaceable
>ГГГГ-ММ-ДДTЧЧ:ММ[:СС][ часовой_пояс]</replaceable
> (согласно значению, возвращённому <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) или <replaceable
>ЧЧ:ММ[:СС]</replaceable
> (согласно значению, возвращённому <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Если дата не задана, используется текущая дата. Обратите внимание, что значение секунд игнорируется.</para>

<para
>Если часовой пояс не указан, используется часовой пояс локальной системы. <replaceable
>Часовой пояс</replaceable
> может быть системным часовым поясом (например, <userinput
>Европа/Лондон</userinput
>) или значением <userinput
>UTC</userinput
>, представляющим соответствующий часовой пояс UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Отмена напоминания при невозможности срабатывания в течение указанного количества минут после наступления заданного времени срабатывания. Если значение равно нулю, напоминание не будет отменено.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Логическое ИЛИ желаемых флагов напоминания. Биты флагов определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Обратите внимание, что к командным напоминаниям применимы не все биты флагов.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Правило регулярного повторения напоминания. Используется синтаксис iCalendar, определённый в <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Например, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> определяет 4 повторения с 3-месячным интервалом в последний понедельник месяца. Для однократных напоминаний указывается пустая строка.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Тип повторения напоминания. Допустимые значения: MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Они определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>. Ежемесячные повторения соответствуют дню типа месяца, а ежегодные — дате типа года. И в том, и в другом случае дата берётся из параметра <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Количество периодов (минут/дней/недель/месяцев/лет — согласно параметру <parameter
>recurType</parameter
>) между повторениями напоминания.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Количество повторов напоминания. Если указано значение -1, напоминание будет повторяться бесконечно.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Дата (или дата и время) окончания повторения напоминания. Если параметр <parameter
>startDateTime</parameter
> включает время, то этот параметр также должен включать время; если параметр <parameter
>startDateTime</parameter
> содержит только дату, то этот параметр также должен содержать только дату. Идентификатор часового пояса не следует указывать, так как для обработки значения этого параметра используется тот же часовой пояс, что и для <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Количество минут между дополнительнымиповторениями напоминания. Если указано нулевое значение, дополнительных повторений напоминания не будет. Если повторение не задано, значение этого параметра игнорируется.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Количество дополнительных повторений напоминания, включая первое напоминание.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>
<para
><function
>scheduleAudio()</function
> — это вызов &DBus; для планирования воспроизведения указанного звукового файла в указанные дату и время. За исключением указаниягромкости и опускания параметров цвета и шрифта сообщения, использование данной функции идентично <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> — подробные сведения доступны в описании этой функции.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>edit</refentrytitle>
</refmeta>
<refnamediv>
<refname
>edit</refname>
<refpurpose
>открывает <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
> для редактирования напоминания.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool edit(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Уникальный идентификатор события, которое следует отредактировать. Может предваряться названием конфигурации или числовым идентификатором ресурса, содержащего это событие, и записывается в формате <replaceable
>[идентификатор_ресурса:]уникальный_идентификатор_события</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Возвращаемое значение</title>
<para
><returnvalue
>false</returnvalue
>, если указанное напоминание не может быть найдено или доступно только для чтения. В ином случае — <returnvalue
>true</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>

<para
><function
>edit()</function
> — вызов &DBus; для показа <link linkend="alarm-edit-dlg"
>диалога изменения напоминания</link
>, который позволяет отредактировать указанное напоминание.</para>

</refsect1>
</refentry>

<refentry id="dbus_editnew">
<refmeta>
<refentrytitle
>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname
>editNew</refname>
<refpurpose
>открывает <link linkend="alarm-edit-dlg"
>диалог изменения напоминания</link
> для редактирования нового напоминания.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool editNew(int <replaceable
>type</replaceable
>)
</synopsis>
<synopsis
>bool editNew(const QString&amp; <replaceable
>templateName</replaceable
>)
</synopsis>

<refsect2>
<title
>Параметры</title>
<variablelist>
<varlistentry>
<term
><parameter
>type</parameter
></term>
<listitem>
<para
>Тип напоминания. Допустимые значения: DISPLAY, COMMAND, EMAIL, AUDIO. Они определены в классе <classname
>KAlarmIface</classname
> в файле <filename
>kalarmiface.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>templateName</parameter
></term>
<listitem>
<para
>Имя шаблона напоминания, на основе которого будет создано новое напоминание.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Возвращаемое значение</title>
<para
><returnvalue
>false</returnvalue
>, если значение параметра <parameter
>type</parameter
> недействительно или если не удалось найти шаблон с указанным в параметре <parameter
>templateName</parameter
> именем. В ином случае — <returnvalue
>true</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>

<para
><function
>editNew()</function
> — вызов &DBus; для показа <link linkend="alarm-edit-dlg"
>диалога изменения напоминания</link
>, который позволяет отредактировать новое напоминание. Если в качестве параметра указан тип напоминания, будет показан пустой диалог. Если в качестве параметра указано имя шаблона, диалог будет содержать параметры шаблона.</para>

</refsect1>
</refentry>

<refentry id="dbus_list">
<refmeta>
<refentrytitle
>list</refentrytitle>
</refmeta>
<refnamediv>
<refname
>list</refname>
<refpurpose
>возвращает список запланированных напоминаний.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString list()
</synopsis>

<refsect2>
<title
>Возвращаемое значение</title>
<para
>Разделённый переносами строк список напоминаний. Каждое напоминание записывается в формате <returnvalue
><replaceable
>идентификатор_ресурса</replaceable
>:<replaceable
>уникальный_идентификатор_ресурса</replaceable
> <replaceable
>время</replaceable
> <replaceable
>текст</replaceable
></returnvalue
></para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Описание</title>

<para
><function
>list()</function
> — вызов &DBus; для возврата строки, содержащей перечень запланированных напоминаний. В списке приводятся краткие сведения о каждом ожидающем напоминании: идентификатор ресурса, уникальный идентификатор ресурса, запланированное время следующего срабатывания и текст сообщения или файл.</para>

</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Интерфейс командной строки</title>

<para
>Параметры командной строки позволяют другим программам выполнять запуск программы &kalarm;, если она ещё не выполняется, для вызова срабатывания или отмены запланированных напоминаний или планирования новых напоминаний. Параметры командной строки используются, так как при запуске &kalarm; без параметров командной строки и последующей отправке запросов &DBus; программа запускается в графическом режиме по умолчанию, что явно нежелательно для межпрограммных запросов.</para>

<note
><para
>Программы сначала должны проверить, выполняется ли &kalarm;; если это так, то для запроса операций они должны использовать вызовы &DBus;.</para
></note>

<para
>Описание параметров командной строки для планирования нового напоминания приводится в разделе <link linkend="cmdline-operation"
>Работа с командной строкой</link
>. Параметры для вызова срабатывания и отмены запланированных напоминаний следующие:</para>

<note
><para
>Обычные пользователи также могут использовать параметры командной строки (предполагается, что они могут указать необходимую для работы параметров информацию).</para
></note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Параметр</entry>
  <entry
>Описание</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--cancelEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Отмена напоминания с указанным идентификатором события. Идентификатор события — это уникальный идентификатор события, который может предваряться идентификатором ресурса, содержащего это событие, и записывается в формате <replaceable
>[идентификатор_ресурса:]уникальный_идентификатор_события</replaceable
>. Выполняется то же действие, что и для вызова &DBus; <link linkend="cancelEvent"
>cancelEvent()</link
>. Указание параметра <option
>--triggerEvent</option
> запрещено.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Вызов срабатывания напоминания с указанным идентификатором события. Идентификатор события — это уникальный идентификатор события, который может предваряться идентификатором ресурса, содержащего это событие, и записывается в формате <replaceable
>[идентификатор_ресурса:]уникальный_идентификатор_события</replaceable
>. Выполняется то же действие, что и для вызова &DBus; <link linkend="triggerEvent"
>triggerEvent()</link
> &DBus; call. Указание параметра <option
>--cancelEvent</option
> запрещено.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Примеры:</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
>Вопросы и ответы</title>

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Какие файлы конфигурации используются &kalarm;?</para>
</question>
<answer>
<para
>Параметры &kalarm; хранятся в следующих файлах, которые находятся в папке <command
>qtpaths --paths GenericConfigLocation</command
>:</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarmrc</filename
> — содержит параметры &kalarm;.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarmresources</filename
> — содержит список календарей напоминаний, которые используются &kalarm;.</simpara>
</listitem>
</itemizedlist>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Где хранятся напоминания &kalarm;?</para>
</question>
<answer>

<para
>При первом запуске приложение &kalarm; создаёт в папке <command
>qtpaths --paths GenericDataLocation</command
> следующие календари напоминаний:</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarm/calendar.ics</filename
> — содержит активные напоминания.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/expired.ics</filename
> — содержит устаревшие напоминания.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/template.ics</filename
> — содержит шаблоны напоминаний.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/displaying.ics</filename
> — этот особый файл календаря содержит сведения о текущих отображаемых напоминаниях, что позволяет повторно показать эти напоминания после перезапуска приложения &kalarm;.</simpara>
</listitem>
</itemizedlist>

<para
>В дальнейшем эти календари возможно заменить (за исключением <filename
>displaying.ics</filename
>) или создать дополнительные календари напоминаний в любом необходимом расположении. Чтобы узнать, какие файлы календарей сейчас используются, просмотрите описание каждого из календарей в списке календарей напоминаний.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>В каком формате хранятся напоминания?</para>
</question>
<answer>
<para
>Напоминания программы &kalarm; хранятся в текстовых файлах календарей, формат которых определяется стандартом <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 — Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
>. Этот стандартный формат используется всеми приложениями диспетчера личных сведений KDE (kdepim). Программа &kalarm; использует некоторые нестандартные свойства, соответствующие RFC2445. Они приводятся в файле <filename
>DESIGN-kalarmcalendar.html</filename
>, который распространяется вместе с программой &kalarm;.</para>
</answer>
</qandaentry>

<qandaentry id="akonadi-plugin">
<question>
<para
>Зачем нужен подключаемый модуль Akonadi &kalarm;?</para>
</question>
<answer>
<para
>&kalarm; использует подключаемый модуль Akonadi для предоставления всех возможностей, которые зависят от &akonadi; (служба хранения данных на разных компьютерах &kde; &PIM;). Если этот модуль не будет установлен и включён, в &kalarm; не будет следующих возможностей: <itemizedlist>
<listitem>
<simpara
>Отправка писем с помощью &kmail;; единственным доступным способом отправки писем будет &Sendmail; (смотрите раздел настройки <link linkend="preferences-email"
>Отправка писем</link
>).</simpara>
</listitem>
<listitem>
<simpara
>Перетаскивание писем.</simpara>
</listitem>
<listitem>
<simpara
>Выбор адресов электронной почты из &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Импорт дней рождения из &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Перенос календарей напоминаний &akonadi; при первом запуске новой версии &kalarm;.</simpara>
</listitem>
</itemizedlist>
</para>
<para
>Если этот подключаемый модуль установлен, его возможно включить или отключить на вкладке <link linkend="preferences-general"
>Главное</link
> диалога настройки.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Для чего предназначена программа <application
>kalarmautostart</application
>?</para>
</question>
<answer>
<para
><application
>kalarmautostart</application
> — это небольшая вспомогательная программа, которая предназначена для автоматического запуска &kalarm; при входе в систему.</para>

<para
>&kalarm; обычно восстанавливается диспетчером сеансов при входе в систему (для показа окон программы в том же виде, в котором они находились при выходе пользователя из сеанса). Но если на момент выхода из сеанса программа не выполнялась, она не будет запущена диспетчером сеансов; следовательно, требуется её автозапуск. Проблема заключается в том, что когда приложение одновременно как управляется диспетчером сеансов, так и запускается автоматически, нельзя определить очерёдность. Если сначала будет выполнен автозапуск, то состояние приложения не удастся восстановить с помощью диспетчера сеансов.</para>

<para
>Эта проблема решается запуском вспомогательной программы <application
>kalarmautostart</application
> вместо &kalarm; при входе в систему. Эта программа некоторое время ожидает (чтобы предоставить диспетчеру сеансов возможность восстановить окна &kalarm;), затем выполняет запуск &kalarm; и завершает свою работу.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Как использовать &kalarm; на рабочем столе, отличном от &plasma;?</para>
</question>
<answer>
<para
>Основное требование для запуска &kalarm; на рабочем столе, отличном от &plasma; — обеспечить автоматический запуск &kalarm; при каждом входе в систему. Более подробные инструкции содержатся в файле <filename
> INSTALL</filename
>, который распространяется вместе с программой &kalarm;.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Авторские права и лицензия</title>

<para
>&kalarm;  </para>
<para
>Авторское право на программу: &David.Jarvie; &David.Jarvie.mail;, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 </para>

<para
>Авторское право на документацию: &David.Jarvie; &David.Jarvie.mail;, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2016, 2018, 2019, 2020 </para>

<para
>Перевод на русский язык — Олег Баталов <email
>olegbatalov@mail.ru</email
></para
><para
>Редакция и обновление перевода — Николай Шафоростов <email
>shafff@ukr.net</email
></para
><para
>Обновление перевода на русский язык — Олеся Герасименко<email
>translation-team@basealt.ru</email
></para
> &underFDL; &underGPL; <para
>Выражаем благодарность автору приложению KAlarm для &kde; 1, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, который разрешил использование названия &kalarm; для приложений для &kde; 2 и последующих версий. </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:
-->

