<para>&konsolekalendar; — это интерфейс командной строки для работы с календарями &kde;. Он позволяет просматривать, создавать, удалять и изменять записи в календаре из командной строки или с помощью языка сценариев. Также &konsolekalendar; может экспортировать календарь &kde; в различные форматы и импортировать его.</para>
<para>В режиме работы по умолчанию &konsolekalendar; выводит список событий текущего дня (с 7:00 до 17:00)</para>
<para>&konsolekalendar; это <emphasis>не</emphasis> очередной графический интерфейс для календаря &kde; (как, например, &korganizer;). &konsolekalendar; предназначен для тех случаев, когда графический интерфейс недоступен или нежелателен.</para>
<para>&konsolekalendar; не предоставляет полноценный язык для создания запросов к календарю, впрочем, это и не являлось целью авторов. Предоставляются лишь простейшие опции для доступа к календарю из командной строки в пределах заданных времени и даты. </para>
<para>В этой главе вы узнаете о полезных функциях &konsolekalendar;, об опциях командной строки (помните, что &konsolekalendar; — это не графический интерфейс, а программа командной строки).</para>
<para>Вы также узнаете о добавлении, удалении и редактировании событий в календаре, а также о преобразовании их в другие форматы. Создание и импорт календарей &kde; также описан в этом разделе. </para>
<para>В режиме работы по умолчанию, или при использовании ключа <parameter>--view</parameter> &konsolekalendar; выведет на экран все записи, соответствующие указанным времени и дате. </para>
<para>&konsolekalendar; может вносить новые события в календарь &kde; или ресурс календаря с помощью опции командной строки <parameter>--add</parameter>. Успешно добавленные события немедленно появляются в приложениях календаря &kde; (&korganizer;).</para>
<informalexample><para>В следующем примере событие, начинающееся 2003-06-04 (4 июня 2003) в 10 часов и заканчивающееся в 12, с названием "Посещение врача" вставляется в календарь пользователя по умолчанию:</para>
<option>--end-date <replaceable>2003-08-07</replaceable></option> <option>--summary <replaceable>"Выходной"</replaceable></option> <option>--description <replaceable>"Ни кто меня не нейдёт!" </replaceable></option></userinput></screen>
<para>&konsolekalendar; поддерживает удаление элементов из файла календаря или ресурсас помощью опции командной строки <parameter>--delete</parameter>. Элементы календаря для удаления указываются по их уникальному строковому идентификатору (<acronym>UID</acronym>) с помощью опции <parameter>--uid</parameter>. <acronym>UID</acronym> может быть найден при просмотре события с помощью опции <parameter>--view</parameter>.</para>
<para>События немедленно удаляются из приложений календаря &kde; (&korganizer;).</para>
<warning><para>После того как вы удаляете что-либо из календаря, вы <emphasis>не сможете</emphasis> вернуть это! Другими словами, когда вы удаляете запись, вы не сможете восстановить её. Она удаляется навсегда.</para></warning>
<para>&konsolekalendar; поддерживает изменения существующих элементов в файле календаря или егоресурсес помощью опции командной строки <parameter>--change</parameter>. Элементы календаря для изменения указываются их уникальным строковым идентификатором (<acronym>UID</acronym>) с помощью опции <parameter>--uid</parameter>. <acronym>UID</acronym> может быть найден при просмотре события с помощью опции <parameter>--view</parameter>.</para>
<para>Замена ведёт себя так же как и вставка: вы можете изменить дату и время начала события, дату и время окончания, название и описание. Изменённые события немедленно становятся доступными в приложениях календаря &kde; (&korganizer;).</para>
<para><emphasis>Пример:</emphasis> Здесь мы изменяем название и описание элемента календаря с <acronym>UID</acronym> <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>
<para>&konsolekalendar; может использоваться для создания нового файла календаря &kde;. Поскольку вы не можете добавлять элементы в несуществующий календарь, вы сначала должны создать егос помощью опций командной строки <parameter> --create</parameter> и <parameter>--file</parameter>.</para>
<para>&konsolekalendar; может экспортировать календарь &kde; в широко распространённые форматы. Экспорт является специальной формой просмотра. По умолчанию, события показываются в формате <quote>текста &konsolekalendar;</quote>. Для изменения формата просмотра используйте опцию командной строки<parameter>--export-type</parameter>.</para>
<para>Формат значений, разделённых запятыми, показывает значения событий в том же порядке, что формат текста &konsolekalendar;. Единственное отличие состоит в том, что вся информация помещается в одну строку в виде полей, которые разделены запятыми. Экспортированные файлы могут быть импортированы непосредственно в программы электронных таблиц типа &kspread;, <application>OpenOffice.org Calc</application> и <application>&Microsoft; Excel</application>. Формат <acronym>CSV</acronym> также прост для обработки в сценариях.</para>
<para>Формат экспорта <acronym>HTML</acronym> создаёт корректный файл <acronym>HTML</acronym>, который может быть опубликован в <acronym>WWW</acronym>. Этот формат экспорта не подходит для последующего синтаксического анализа в сценариях, но очень удобен для публикации календарей и лёгкого их просмотра.</para>
<para><emphasis>TODO:</emphasis> Вставить сюда снимок экрана</para>
<para>Этот формат создаёт файл <acronym>HTML</acronym>, в котором содержатся все собрания по месяцам в заданном диапазоне дат. Этот формат экспорта не подходит для последующего синтаксического анализа в сценариях, но очень удобен для публикации календарей и лёгкого их просмотра.</para>
<para>&konsolekalendar; может импортировать в календарь &kde; файлы формата <acronym>ICS</acronym>. Все события импортируемого календаря будут вставлены, включая идентичные события. В следующей версии &konsolekalendar; идентичные события вставляться не будут.</para>
<entry>Показывает, что могло бы быть сделано, не изменяя записи, не добавляя и не удаляя их из календаря. Не изменяются и не создаются новые файлы.</entry>
<entry>Указывает файл календаря, который будет использоваться. <para>Если не указан, будет использоваться ваш ресурс &korganizer; по умолчанию.</para></entry>
<entry>Начать с этого времени (ЧЧ:ММ). По умолчанию 7:00. <para>Для создания или изменения неточного события, используйте опции <option>--time float</option> или <option>--end-time float</option>.</para></entry>
<entry>Закончить указанным временем(ЧЧ:ММ). По умолчанию - 17:00 <para>Для создания или изменения неточного события, используйте опции <option>--time float</option> или <option>--end-time float</option>.</para></entry>
<para>&konsolekalendar; отклоняет даты, указанные в командной строке, если они даны не в соответствии со стандартом ISO 8601 (а именно ГГГГ-ММ-ДД). ГГГГ — четырёхразрядный год (типа 2003), ММ — двухразрядный месяц (01,02,..,12), и ДД — двухразрядный день (01,02,...,31).</para>
<para>&konsolekalendar; всегда экспортирует даты в соответствии с форматом ISO 8601.</para>
<para>&konsolekalendar; отклоняет время, указанное в командной строке, если оно дано не в соответствии со стандартом ISO 8601 (а именно ЧЧ:ММ:СС). ЧЧ — двухразрядный час (01,02,...,24), ММ — двухразрядные минуты (01,02,..,60), и СС — двухразрядные секунды (01,02,...,60).</para>
<para>&konsolekalendar; всегда экспортирует время в соответствии с форматом ISO 8601.</para>
<para>&konsolekalendar; проверяет дату и время начала и окончания, и название всех событий в календаре. Соответствие происходит тогда, когда все три значения совпадают с соответствующими значениями существующего события. </para>
<para>Поскольку для удаления и изменения событий вы должны указать их <acronym>UID</acronym>. Если вы не хотите видеть <acronym>UID</acronym> события, используйте <emphasis>краткий</emphasis> формат экспорта (<option>--export-type short</option>). </para>
<para>Для &konsolekalendar; необходимы установленные стандартные библиотеки &kde; (пакет <filename>tdelibs</filename>). Для компиляции из исходных текстов, вам необходимы пакеты для разработчиков &Qt; и <filename>tdelibs</filename>.</para>
<para>Вы можете найти список изменений в файле <filename>ChangeLog</filename>.</para>
<para>Этот раздел содержит краткий обзор процесса компиляции. Подробные инструкции по компиляции смотрите в<ulink url="http://developer.kde.org/build/compile_kde3_2.html">Компиляция &kde; 3.2.x</ulink>.</para>
<para>Если вы не нашли подходящий собранный пакет, вам необходимо скомпилировать &konsolekalendar; из исходных файлов. Скачайте файл <filename>tdepim-x.x.tar.bz2</filename>. Распакуйте его командой <userinput><command>tar</command> <option>xvfj <replaceable>tdepim-x.x.tar.bz2</replaceable></option> </userinput> и перейдите в созданный каталог.</para>
&install.compile.documentation; <note><para>Если у вас установлено несколько версий &kde; (например &kde;2 и &kde;3), вы можете установить &konsolekalendar; не в тот каталог &kde;. Если необходимо, вы можете задать каталог &kde; как параметр. Например, если &kde; установлен в <filename>/opt/kde3</filename>: </para>