Руководство KonsoleKalendar

# Руководство KonsoleKalendar

Tuukka Pasanen `<illuusio@mailcity.com>`

Allen Winter `<winterz@kde.org>`

Рецензент: Malcolm Hunter
: Nick
: Олег Баталов
Издание 1.1.1 (15 апреля 2004 г.)

Авторские права © 2002, 2004 Tuukka Pasanen

Авторские права © 2003, 2007 Allen Winter

Юридическое уведомление

KonsoleKalendar - это интерфейс командной строки для работы с календарями KDE

Глава 1. Введение
Введение

# Глава 1. Введение

KonsoleKalendar — это интерфейс командной строки для работы с календарями KDE. Он позволяет просматривать, создавать, удалять и изменять записи в календаре из командной строки или с помощью языка сценариев. Также KonsoleKalendar может экспортировать календарь KDE в различные форматы и импортировать его.

В режиме работы по умолчанию KonsoleKalendar выводит список событий текущего дня (с 7:00 до 17:00)

Возможности KonsoleKalendar

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

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

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

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

- Создание календаря

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

- Импорт существующего календаря KDE

KonsoleKalendar это не очередной графический интерфейс для календаря KDE (как, например, KOrganizer). KonsoleKalendar предназначен для тех случаев, когда графический интерфейс недоступен или нежелателен.

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

Глава 2. Дополнительные возможности
Дополнительные возможности

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

В этой главе вы узнаете о полезных функциях KonsoleKalendar, об опциях командной строки (помните, что KonsoleKalendar — это не графический интерфейс, а программа командной строки).

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

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

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

Для просмотра событий текущего дня (с 7:00 до 17:00), просто выполните:

    % konsolekalendar

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

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

Показать будущие события календаря:

    % konsolekalendar --next

Для просмотра событий следующих 5 дней выполните:

    % konsolekalendar --show-next 5

Добавление событий
Добавление событий

## Добавление событий

KonsoleKalendar может вносить новые события в календарь KDE или ресурс календаря с помощью опции командной строки `--add`. Успешно добавленные события немедленно появляются в приложениях календаря KDE (KOrganizer).

В следующем примере событие, начинающееся 2003-06-04 (4 июня 2003) в 10 часов и заканчивающееся в 12, с названием "Посещение врача" вставляется в календарь пользователя по умолчанию:

    % konsolekalendar --add --date 2003-06-04 --time 10:00 \
    --end-time 12:00 --summary "Посещение врача"

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

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

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

    % konsolekalendar --add --file vacation.ics --date 2003-08-01 \
    --end-date 2003-08-07 --summary "Выходной" --description "Ни кто меня не нейдёт!"

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

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

KonsoleKalendar поддерживает удаление элементов из файла календаря или ресурса с помощью опции командной строки `--delete`. Элементы календаря для удаления указываются по их уникальному строковому идентификатору (UID) с помощью опции `--uid`. UID может быть найден при просмотре события с помощью опции `--view`.

События немедленно удаляются из приложений календаря KDE (KOrganizer).

### Предупреждение

После того как вы удаляете что-либо из календаря, вы не сможете вернуть это! Другими словами, когда вы удаляете запись, вы не сможете восстановить её. Она удаляется навсегда.

Здесь мы удаляем элемент календаря с UID `KonsoleKalendar-1887551750.196`:

    % konsolekalendar --delete --uid KonsoleKalendar-1887551750.196

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

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

KonsoleKalendar поддерживает изменения существующих элементов в файле календаря или его ресурсе с помощью опции командной строки `--change`. Элементы календаря для изменения указываются их уникальным строковым идентификатором (UID) с помощью опции `--uid`. UID может быть найден при просмотре события с помощью опции `--view`.

Замена ведёт себя так же как и вставка: вы можете изменить дату и время начала события, дату и время окончания, название и описание. Изменённые события немедленно становятся доступными в приложениях календаря KDE (KOrganizer).

Пример: Здесь мы изменяем название и описание элемента календаря с UID `KonsoleKalendar-1887551750.196`:

`%``konsolekalendar `--change` `--uid `KonsoleKalendar-1887551750.196`` `--summary `"Проверить мою голову"`` `--description `"никогда не ходите к такому доктору!"```

Создание нового файла календаря
Создание нового файла календаря

## Создание нового файла календаря

KonsoleKalendar может использоваться для создания нового файла календаря KDE. Поскольку вы не можете добавлять элементы в несуществующий календарь, вы сначала должны создать его с помощью опций командной строки `--create` и `--file`.

Создать файл календаря с именем ``/data/share/calendars/vacation.ics``:

    % konsolekalendar --create --file /data/share/calendars/vacation.ics

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

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

KonsoleKalendar может экспортировать календарь KDE в широко распространённые форматы. Экспорт является специальной формой просмотра. По умолчанию, события показываются в формате «текста KonsoleKalendar». Для изменения формата просмотра используйте опцию командной строки`--export-type`.

Чтобы увидеть список всех поддерживаемых форматов экспорта, используйте опцию `--export-list`

    % konsolekalendar --export-list

Форматы экспорта
Форматы экспорта

## Форматы экспорта

Некоторые (но не все) поддерживаемые форматы экспорта описаны в этом разделе.

### Формат текста KonsoleKalendar

Формат текста KonsoleKalendar является родным форматом KonsoleKalendar. Он разработан для удобной обработки в сценариях.

Текстовый формат KonsoleKalendar это:

    Date:\t<Дата>(dddd yyyy-MM-dd)
    [\t<Время начала>(hh:mm) - <Время окончания>(hh:mm)]
    Summary:
    \t<Название | "(без названия)">
    Location:
    \t<Место  | "(нет места)">
    Description:
    \t<Описание| "(нет описания)">
    UID:
    \t<UID>
    --------------------------------------------------

Например:

    Date:   Tuesday 2003-11-01
            08:00 - 09:00
    Summary:
            Общая встреча
    Location:
            Конференц зал
    Description:
            Встреча со всеми участниками проекта для его обсуждения.
    UID:
            KonsoleKalendar-1128954167.1013
    --------------------------------------------------

### Краткий текстовый формат KonsoleKalendar

Краткий текстовый формат более компактен чем формат KonsoleKalendar по умолчанию.

Короткий текстовый формат KonsoleKalendar это:

    [--------------------------------------------------]
    {<Дата>(dddd yyyy-MM-dd)]
    [<Время начала>(hh:mm) - <Время окончания>(hh:mm) | "\t"]
    \t<Краткое описание | \t>[, <Место>]
    \t\t<Описание | "\t">

Например:

    --------------------------------------------------
    Tuesday 2003-11-01
    08:00 - 09:00   Общая встреча, Конференц зал
                    Встреча со всеми участниками проекта для его обсуждения.

### Формат значений, разделённых запятыми (CSV)

Формат значений, разделённых запятыми, показывает значения событий в том же порядке, что формат текста KonsoleKalendar. Единственное отличие состоит в том, что вся информация помещается в одну строку в виде полей, которые разделены запятыми. Экспортированные файлы могут быть импортированы непосредственно в программы электронных таблиц типа KSpread, OpenOffice.org Calc и Microsoft® Excel. Формат CSV также прост для обработки в сценариях.

Формат значений, разделённых запятыми (CSV) это:

    YYYY-MM-DD,HH:MM,YYYY-MM-DD,HH:MM,Summary,Location,Description,UID

Например:

    2003-11-01,08:00,2003-11-01,09:00,Общая встреча,Встреча со всеми \
    участниками проекта KonsoleKalendar в конференц зале.,-1128954167.1013

### Формат HTML

Формат экспорта HTML создаёт корректный файл HTML, который может быть опубликован в WWW. Этот формат экспорта не подходит для последующего синтаксического анализа в сценариях, но очень удобен для публикации календарей и лёгкого их просмотра.

TODO: Вставить сюда снимок экрана

### Формат HTMLmonth

Этот формат создаёт файл HTML, в котором содержатся все собрания по месяцам в заданном диапазоне дат. Этот формат экспорта не подходит для последующего синтаксического анализа в сценариях, но очень удобен для публикации календарей и лёгкого их просмотра.

TODO: Вставить сюда снимок экрана

Импорт календарей
Импорт календарей

## Импорт календарей

KonsoleKalendar может импортировать в календарь KDE файлы форматов iCal и vCal. Все события импортируемого календаря будут вставлены, включая идентичные события. В следующей версии KonsoleKalendar идентичные события вставляться не будут.

Для импорта файла календаря``another.ics`` в календарь``current.ics`` выполните:

    % konsolekalendar --import another.ics --file current.ics

Глава 3. Опции командной строки
Опции командной строки

# Глава 3. Опции командной строки

KonsoleKalendar поддерживает следующие опции командной строки:

Опция | Описание
--- | ---
`--help, --help-all` | Показать справку о опциях программы.
`--author` | Показать информацию об авторе программы.
`-v, --version` | Показать информацию о версии программы.
`--license` | Показать информацию о лицензии.
`--verbose` | Показать подробные отладочные сообщения.
`--dry-run` | Показывает, что могло бы быть сделано, не изменяя записи, не добавляя и не удаляя их из календаря. Не изменяются и не создаются новые файлы.
`--allow-gui` | Разрешить использование ресурсов, использующих интерактивный интерфейс пользователя. Обычно используются только ресурсы, которые никогда не требуют участия пользователя (например, календари, хранящиеся в файлах).
`--file` `calendar-file` | Указывает файл календаря, который будет использоваться. Если не указан, будет использоваться ваш ресурс KOrganizer по умолчанию.
Некоторые режимы операций: |
`--view` | Вывести события календаря в указанном формате.
`--add` | Добавить событие в календарь.
`--change` | Изменить в календаре существующее событие.
`--delete` | Удалить из календаря существующее событие.
`--create` | Создать новый файл календаря, если он не существует.
`--import` `import-file` | Импорт указанного календаря в основной календарь.
Модификаторы операций |
`--all` | Показать все записи календаря.
`--next` | Показать следующее событие календаря.
`--show-next` `days` | Показать следующее количество дней начиная с указанного.
`--uid` `UID` | Показать, удалить или изменить событие с указанным идентификатором.
`--date` `date` | Начать с указанного дня (ГГГГ-ММ-ДД). По умолчанию - сегодня.
`--time` `time` | Начать с этого времени (ЧЧ:ММ). По умолчанию 7:00. Для создания или изменения неточного события, используйте опции `--time float` или `--end-time float`.
`--end-date` `end-date` | Закончить указанной датой (ГГГГ-ММ-ДД). По умолчанию устанавливается `--date`.
`--end-time` `end-time` | Закончить указанным временем(ЧЧ:ММ). По умолчанию - 17:00 Для создания или изменения неточного события, используйте опции `--time float` или `--end-time float`.
`--epoch-start` `epoch-time` | Начать с указанного времени [секунды с начала эпохи].
`--epoch-end` `epoch-time` | Закончить на указанном времени [секунды с начала эпохи].
`--summary` `summary` | Добавить название к событию (работает с add и change).
`--description` `description` | Добавить описание к событию (работает с add и change).
`--location` `место` | Добавить место события (работает с add и change).
Опции экспорта: |
`--export-type` `export-type` | Тип файла для экспорта. По умолчанию тип "Текст".
`--export-file` `export-file` | Экспорт в файл. По умолчанию осуществляется на стандартный вывод.
`--export-list` | Вывести доступные форматы для экспортирования.

Глава 4. Вопросы и ответы
Вопросы и ответы

# Глава 4. Вопросы и ответы

Возможно, была выпущена обновлённая версия этого документа. С последней версией документа можно ознакомиться по адресу http://docs.kde.org/.

4.1. Какие файлы настроек использует KonsoleKalendar?
4.2. Какие имена у приложения KonsoleKalendar?
4.3. Какова спецификация формата даты?
4.4. Какова спецификация формата времени?
4.5. Будет ли KonsoleKalendar вставлять новое событие, идентичное существующему в календарю?
4.6. Как KonsoleKalendar определяет идентичность события с хранящимся в календаре?
4.7. Как точные события изменить на не точные?
4.8. Почему UID событий выводятся в большинстве форматов экспорта?
4.9. Как я могу добавить вопрос в этот FAQ?

4.1. | Какие файлы настроек использует KonsoleKalendar?
| Никаких.
4.2. | Какие имена у приложения KonsoleKalendar?
| Название приложения KonsoleKalendar - это konsolekalendar.
4.3. | Какова спецификация формата даты?
| KonsoleKalendar отклоняет даты, указанные в командной строке, если они даны не в соответствии со стандартом ISO 8601 (а именно ГГГГ-ММ-ДД). ГГГГ — четырёхразрядный год (типа 2003), ММ — двухразрядный месяц (01,02,..,12), и ДД — двухразрядный день (01,02,...,31). KonsoleKalendar всегда экспортирует даты в соответствии с форматом ISO 8601.
4.4. | Какова спецификация формата времени?
| KonsoleKalendar отклоняет время, указанное в командной строке, если оно дано не в соответствии со стандартом ISO 8601 (а именно ЧЧ:ММ:СС). ЧЧ — двухразрядный час (01,02,...,24), ММ — двухразрядные минуты (01,02,..,60), и СС — двухразрядные секунды (01,02,...,60). KonsoleKalendar всегда экспортирует время в соответствии с форматом ISO 8601.
4.5. | Будет ли KonsoleKalendar вставлять новое событие, идентичное существующему в календарю?
| Нет. Смотрите следующий вопрос.
4.6. | Как KonsoleKalendar определяет идентичность события с хранящимся в календаре?
| KonsoleKalendar проверяет дату и время начала и окончания, и название всех событий в календаре. Соответствие происходит тогда, когда все три значения совпадают с соответствующими значениями существующего события.
4.7. | Как точные события изменить на не точные?
| Да. Используйте параметр `--time float` совместно с`--change`.
4.8. | Почему UID событий выводятся в большинстве форматов экспорта?
| Поскольку для удаления и изменения событий вы должны указать их UID. Если вы не хотите видеть UID события, используйте краткий формат экспорта (`--export-type short`).
4.9. | Как я могу добавить вопрос в этот FAQ?
| Пошлите его по адресу `(winter AT kde.org)`.

Глава 5. Авторские права и лицензия
Авторские права и лицензия

# Глава 5. Авторские права и лицензия

KonsoleKalendar Авторские права на программу 2002-2007:

- Tuukka Pasanen `(illuusio AT mailcity.com)`

- Allen Winter `(winter AT kde.org)`

Авторские права на документацию 2003:

- Allen Winter `(winter AT kde.org)`

- Tuukka Pasanen `(illuusio AT mailcity.com)`

Перевод на русский язык: Олег Баталов`(olegbatalov AT mail.ru)`

Этот документ распространяется на условиях GNU Free Documentation License.

Программа распространяется на условиях лицензии GNU General Public License.

Приложение A. Установка
Установка

# Приложение A. Установка

## Как получить KonsoleKalendar

KonsoleKalendar — часть проекта KDE http://www.kde.org/.

KonsoleKalendar можно загрузить с файлового сервера проекта KDE.

KonsoleKalendar поставляется с KDE4 и недоступен отдельно.

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

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

Для KonsoleKalendar необходимы установленные стандартные библиотеки KDE (пакеты `kdelibs` и `kdepimlibs`). Для компиляции из исходных текстов необходимы пакеты для разработчиков Qt™ и `kdelibs` и `kdepimlibs`.

Вы можете найти список изменений в файле `ChangeLog`.

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

## Настройка

Никакой настройки KonsoleKalendar не требуется.