# Справочное руководство по &konsolekalendar;

## Введение

&konsolekalendar; - это интерфейс командной строки для работы с календарями &kde;. Он позволяет просматривать, создавать, удалять и редактировать записи в календаре из командной строки или с помощью языка скриптовых сценариев. Также &konsolekalendar; может экспортировать календарь &kde; в различные форматы.

В режиме работы по умолчанию &konsolekalendar; выводит список записей на сегодня с 7:00 до 17:00

Возможности &konsolekalendar;

- Вывод записей в календаре, начиная с указанной даты/времени и заканчивая указанной датой/временем

- Добавление записей в календарь

- Удаление записей

- Изменение записей

- Экспорт календарных записей в другие форматы

&konsolekalendar; это не очередной графический интерфейс для календаря &kde; (как, например, &korganizer;). &konsolekalendar; предназначен для тех случаев, когда графический интерфейс недоступен.

&konsolekalendar; не предоставляет полноразмерный язык для создания запросов к календарю, впрочем, это и не является целью авторов. Предоставляются лишь простейшие опции для доступа к календарю из командной строки в пределах заданных времени и даты.

## Дополнительные возможности

В этой главе вы узнаете о полезных функциях &konsolekalendar;, о ключах командной строки (помните, что &konsolekalendar; - это не графический интерфейс, а программа командной строки).

Вы также узнаете о добавлении, удалении и редактировании календарных записей, а также о конвертировании записей в другие форматы.

### Просмотр записей

В режиме работы по умолчанию, или при использовании ключа `--view` &konsolekalendar; выведет на экран все записи, соответсвующие заданным времени и дате.

Вот как можно увидеть все записи, относящиеся к сегодняшнему дню:

`%```konsolekalendar``

В этом примере мы увидим, как можно вывести все записи, относящиеся к числам с 18 по 22 августа:

`%```konsolekalendar` `--view` `--date `2003-08-18`` `--end-date `2003-08-22```

### Добавление записей

С помощью &konsolekalendar; можно вносить новые записи в календарь &kde;, используя ключ `--add` командной строки.

В этом примере мы добавим событие "Поход к врачу", запланированный на 04.06.2003 с 10:00 до 12:00 с пометкой "Поход к врачу" в календарь, используемый по умолчанию:

`%```konsolekalendar` `--add` `--date `2003-06-04`` `--time `10:00`` `--end-time `12:00`` `--summary `"Поход к врачу"```

В этом примере мы добавим день рождения в календарь пользователя:

`%```konsolekalendar` `--add` `--date `2003-06-06`` `--summary `"Мой день рождения"`` `--description `"Время праздника!"```

TODO: Чтобы добавить день рождения, праздник, юбилей и т.д. в календарь как свободноесобытие (т.е. событие, которое не занимает время днем), используйте ключ `--time=free` в командной строке.

В этом примере в календарь пользователя вносится выходной:

`%```konsolekalendar` `--add` `--date `2003-08-01`` `--end-date `2003-08-20`` `--summary `"Выходной"`` `--description `"Не найдете меня!!!"```

### Удаление записей

&konsolekalendar; может удалять записи из календаря &kde;, используя ключ `--delete` командной строки.

ЭТА ФУНКЦИЯ ЕЩЕ НЕ ТЕСТИРОВАНА! ИСПОЛЬЗУЙТЕ НА СВОЙ СТРАХ И РИСК!

### Изменение записей

&konsolekalendar; может изменять существующие записи в календаре &kde;, используя ключ `--change` в командной строке.

ЭТА ФУНКЦИЯ ЕЩЕ НЕ ТЕСТИРОВАНА! ИСПОЛЬЗУЙТЕ НА СВОЙ СТРАХ И РИСК!

### Экспорт в другие форматы

&konsolekalendar; может экспортировать записи календаря &kde; в другие, широко распространенные форматы, используя ключ `--export-type` в командной строке.

## Параметры командной строки

&konsolekalendar; поддерживает следующие ключи командной строки:

Параметры | Описание: | Заметки
`--help` | Показать справку о параметрах программы | N/A
`--author` | Показывает информацию об авторе программы. | N/A
`-v`, `--version` | Показать окно с краткими сведениями о версии. | N/A
`--license` | Показать информацию о лицензии. | N/A
`--verbose` | Показать полезные отладочные сообщения. | N/A
`--dryrun` | Показывает, что могло бы быть сделано, не изменяя записи, не добавляя и не удаляя записи из календаря. Не изменяются и не создаются новые файлы. | N/A
`--file` `calendar-file` | Назначает календарь, который вы хотите использовать. По умолчанию используется календарь korganizer (Активный календарь указан в `$`HOME`/.kde/share/config/korganizerrc`) | N/A
`--view` | Вывести календарные записи в указанном формате. | N/A
`--add` | Добавить запись в календарь. | N/A
`--change` | Изменить. существующую запись. | N/A
`--delete` | Удалить существующую запись. | N/A
`--import` `import-file` | Импорт календаря в основной календарь. | N/A
`--export-type` `export-type` | Тип файла для экспорта. По умолчанию тип "Текст". | N/A
`--export-file` `export-file` | Экспорт в файл. По умолчанию осуществляется на стандартный вывод. | N/A
`--export-list` | Вывести доступные форматы для экспортирования и выйти. | N/A
`--next` | Следующая запись в календаре. | N/A
`--date` `date` | Начать с указанного дня (ГГГГ-ММ-ДД). По умолчанию - сегодня. | N/A
`--time` | Начать с указанного времени (ЧЧ:ММ). По умолчанию - с 7:00. | N/A
`--end-date` `end-date` | Закончить вывод указанным днем (ГГГГ-ММ-ДД). День по умолчанию устанавливается `--date`. | N/A
`--end-time` `end-time` | Закончить вывод на указанном времени (ЧЧ:ММ). По умолчанию - 17:00 | N/A
`--epoch-start` `epoch-time` | Начать с указанного времени (секунды с момента epoch). | N/A
`--epoch-end` `epoch-time` | Закончить на указанном времени (секунд с момента epoch). | N/A
`--description` `description` | Добавить описание к записи (работает с add и change). | N/A
`--summary` `summary` | Добавить краткое описание к записи (работает с add и change). | N/A
`--all` | Показать все календарные записи. | N/A
`--create` | Создать новый календарь, если он не существует. | N/A

## Вопросы и ответы

&reporting.bugs; &updating.documentation;

Какие файлы настроек использует &konsolekalendar;?

Никаких.

Какие имена у приложения &konsolekalendar;?

Название приложения &konsolekalendar; - это konsolekalendar.

## Благодарности и лицензия

&konsolekalendar;

Права на программу принадлежат Tuukka Pasanencopyright 2002,2003 illuusio@mailcity.com

Авторы-участники:

- Allen Winter winterz@earthlink.net

Авторские права на документацию 2003 Allen Winter winterz@earthlink.net

Nick blindguard@mtu-net.ru

&underFDL; &underGPL;

## Установка

### Откуда можно скачать &konsolekalendar;

&install.intro.documentation;

&konsolekalendar; поставляется с &kde;3 и недоступен отдельно.

### Системные требования

Для сборки и установки вам понадобится пакет `kdelibs`. Для компиляции из исходных текстов вам также необходимы Qt и `kdelibs` development

Список изменений - `ChangeLog`

### Компиляция и установка

Если вы не нашли подходящий бинарный пакет, то вам неоходимо собрать &konsolekalendar; из исходных файлов. Скачайте файл `kdepim-x.x.tar.bz2`. Распакуйте его командой ``tar` `xvfj `package.tar.bz2``` и перейдите в созданный каталог.

&install.compile.documentation;

Если у вас установлено несколько версий &kde; (например &kde;2 и &kde;3), то возможна ошибка в процессе установки &konsolekalendar;. Если необходимо, вы можете задать каталог &kde; как параметр. Например, если &kde; установлен в `/opt/kde3`:

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

### Настройки

Никакой настройки &konsolekalendar; не требуется.

&documentation.index;