Руководство KonsoleKalendar
Copyright © 2002, 2004 Tuukka Pasanen
Copyright © 2003, 2005 Allen Winter
Разрешается копировать, распространять и/или изменять этот документ на условиях лицензии GNU для свободной документации, версии 1.1 или более поздней, опубликованной Фондом Free Software Foundation; без неизменямых разделов, без текста на первой странице, без текста на последней странице. Копия лицензии находится здесь the section entitled "GNU Free Documentation License".
KonsoleKalendar - это интерфейс командной строки для работы с календарями KDE
Содержание
KonsoleKalendar — это интерфейс командной строки для работы с календарями KDE. Он позволяет просматривать, создавать, удалять и изменять записи в календаре из командной строки или с помощью языка сценариев. Также KonsoleKalendar может экспортировать календарь KDE в различные форматы и импортировать его.
В режиме работы по умолчанию KonsoleKalendar выводит список событий текущего дня (с 7:00 до 17:00)
Возможности KonsoleKalendar
Показ записей календаря, начиная с указанной даты/времени и заканчивая указанной датой/временем
Добавление записей в календарь
Удаление записей
Изменение записей
Создание календаря
Экспорт записей календаря в другие форматы
Импорт существующего календаря KDE
KonsoleKalendar это не очередной графический интерфейс для календаря KDE (как, например, KOrganizer). KonsoleKalendar предназначен для тех случаев, когда графический интерфейс недоступен или нежелателен.
KonsoleKalendar не предоставляет полноценный язык для создания запросов к календарю, впрочем, это и не являлось целью авторов. Предоставляются лишь простейшие опции для доступа к календарю из командной строки в пределах заданных времени и даты.
В этой главе вы узнаете о полезных функциях KonsoleKalendar, об опциях командной строки (помните, что KonsoleKalendar — это не графический интерфейс, а программа командной строки).
Вы также узнаете о добавлении, удалении и редактировании событий в календаре, а также о преобразовании их в другие форматы. Создание и импорт календарей KDE также описан в этом разделе.
В режиме работы по умолчанию, или при использовании ключа --view KonsoleKalendar выведет на экран все записи, соответствующие указанным времени и дате.
Для просмотра событий текущего дня (с 7:00 до 17:00), просто выполните:
%konsolekalendar
В следующем примере мы увидим, все записи, для недели с 18 по 22 августа:
%konsolekalendar--view--date2003-08-18--end-date2003-08-22
Показать будущие события календаря:
%konsolekalendar--next
Для просмотра событий следующих 5 дней выполните:
%konsolekalendar--show-next5
KonsoleKalendar может вносить новые события в календарь KDE или ресурс календаря с помощью опции командной строки --add. Успешно добавленные события немедленно появляются в приложениях календаря KDE (KOrganizer).
В следующем примере событие, начинающееся 2003-06-04 (4 июня 2003) в 10 часов и заканчивающееся в 12, с названием "Посещение врача" вставляется в календарь пользователя по умолчанию:
%konsolekalendar--add--date2003-06-04--time\10:00--end-time12:00--summary"Посещение врача"
В этом примере мы добавим день рождения в ресурс календаря пользователя по умолчанию:
%konsolekalendar--add--date2003-06-06--summary\"Мой день рождения"--description"Время праздника"
В этом примере в календарь пользователя вносится выходной:
%konsolekalendar--add--filevacation.ics--date\2003-08-01--end-date2003-08-07--summary"Выходной"--description"Ни кто меня не нейдёт!"
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar поддерживает удаление элементов из файла календаря или ресурса с помощью опции командной строки --delete. Элементы календаря для удаления указываются по их уникальному строковому идентификатору (UID) с помощью опции --uid. UID может быть найден при просмотре события с помощью опции --view.
События немедленно удаляются из приложений календаря KDE (KOrganizer).
После того как вы удаляете что-либо из календаря, вы не сможете вернуть это! Другими словами, когда вы удаляете запись, вы не сможете восстановить её. Она удаляется навсегда.
Здесь мы удаляем элемент календаря с UID KonsoleKalendar-1887551750.196:
%konsolekalendar--delete--uidKonsoleKalendar-1887551750.196
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar поддерживает изменения существующих элементов в файле календаря или его ресурсе с помощью опции командной строки --change. Элементы календаря для изменения указываются их уникальным строковым идентификатором (UID) с помощью опции --uid. UID может быть найден при просмотре события с помощью опции --view.
Замена ведёт себя так же как и вставка: вы можете изменить дату и время начала события, дату и время окончания, название и описание. Изменённые события немедленно становятся доступными в приложениях календаря KDE (KOrganizer).
Пример: Здесь мы изменяем название и описание элемента календаря с UID KonsoleKalendar-1887551750.196:
% konsolekalendar --change --uid KonsoleKalendar-1887551750.196--summary "Проверить мою голову" --description "никогда не ходите к такому доктору!"
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar может использоваться для создания нового файла календаря KDE. Поскольку вы не можете добавлять элементы в несуществующий календарь, вы сначала должны создать его с помощью опций командной строки --create и --file.
Создать файл календаря с именем /data/share/calendars/vacation.ics
%konsolekalendar--create--file/data/share/calendars/vacation.ics
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar может экспортировать календарь KDE в широко распространённые форматы. Экспорт является специальной формой просмотра. По умолчанию, события показываются в формате «текста KonsoleKalendar». Для изменения формата просмотра используйте опцию командной строки--export-type.
Чтобы увидеть список всех поддерживаемых форматов экспорта, используйте опцию --export-list
%konsolekalendar--export-list
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Некоторые (но не все) поддерживаемые форматы экспорта описаны в этом разделе.
Формат текста 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 это:
[--------------------------------------------------]
{<Дата>(dddd yyyy-MM-dd)]
[<Время начала>(hh:mm) - <Время окончания>(hh:mm) | "\t"]
\t<Краткое описание | \t>[, <Место>]
\t\t<Описание | "\t">
Например:
--------------------------------------------------
Tuesday 2003-11-01
08:00 - 09:00 Общая встреча, Конференц зал
Встреча со всеми участниками проекта для его обсуждения.
Формат значений, разделённых запятыми, показывает значения событий в том же порядке, что формат текста 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, который может быть опубликован в WWW. Этот формат экспорта не подходит для последующего синтаксического анализа в сценариях, но очень удобен для публикации календарей и лёгкого их просмотра.
TODO: Вставить сюда снимок экрана
Этот формат создаёт файл HTML, в котором содержатся все собрания по месяцам в заданном диапазоне дат. Этот формат экспорта не подходит для последующего синтаксического анализа в сценариях, но очень удобен для публикации календарей и лёгкого их просмотра.
TODO: Вставить сюда снимок экрана
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar может импортировать в календарь KDE файлы формата ICS. Все события импортируемого календаря будут вставлены, включая идентичные события. В следующей версии KonsoleKalendar идентичные события вставляться не будут.
Для импорта файла календаряanother.icscurrent.ics
%konsolekalendar--importanother.ics--filecurrent.ics
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar поддерживает следующие опции командной строки:
| Опция | Описание |
|---|---|
--help, --help-all | Показать справку о опциях программы. |
--author | Показать информацию об авторе программы. |
-v, --version | Показать информацию о версии программы. |
--license | Показать информацию о лицензии. |
--verbose | Показать подробные отладочные сообщения. |
--dry-run | Показывает, что могло бы быть сделано, не изменяя записи, не добавляя и не удаляя их из календаря. Не изменяются и не создаются новые файлы. |
--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. Для создания или изменения неточного события, используйте опции |
--end-date end-date | Закончить указанной датой (ГГГГ-ММ-ДД). По умолчанию устанавливается --date. |
--end-time end-time | Закончить указанным временем(ЧЧ:ММ). По умолчанию - 17:00 Для создания или изменения неточного события, используйте опции |
--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 | Вывести доступные форматы для экспортирования. |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar Авторские права на программу 2002,2003:
Tuukka Pasanen (illuusio AT mailcity.com)
Allen Winter (awinterz AT users.sourceforge.net)
Авторские права на документацию 2003:
Allen Winter (awinterz AT users.sourceforge.net)
Tuukka Pasanen(illuusio AT mailcity.com)
Перевод на русский язык: Олег Баталов(olegbatalov AT mail.ru)
Этот документ распространяется на условиях GNU Free Documentation License.
Программа распространяется на условиях лицензии GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KonsoleKalendar - это часть проекта KDE http://www.kde.org/.
KonsoleKalendar входит в пакет kdepim на ftp://ftp.kde.org/pub/kde/, основном FTP-сервере KDE.
KonsoleKalendar поставляется с KDE3 и недоступен отдельно.
Для KonsoleKalendar необходимы установленные стандартные библиотеки KDE (пакет kdelibs). Для компиляции из исходных текстов, вам необходимы пакеты для разработчиков Qt™ и kdelibs.
Вы можете найти список изменений в файле ChangeLog.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Этот раздел содержит краткий обзор процесса компиляции. Подробные инструкции по компиляции смотрите вКомпиляция KDE 3.2.x.
Если вы не нашли подходящий собранный пакет, вам необходимо скомпилировать KonsoleKalendar из исходных файлов. Скачайте файл kdepim-x.x.tar.bz2. Распакуйте его командой tar и перейдите в созданный каталог.xvfj kdepim-x.x.tar.bz2
Чтобы собрать и установить KonsoleKalendar, введите следующие команды в каталоге дистрибутива KonsoleKalendar:
%./configure%make%make install
Поскольку KonsoleKalendar использует autoconf и automake, у вас не должно возникнуть никаких проблем. Если же у вас возникли ошибки, сообщите о них в списки рассылки KDE.
Если у вас установлено несколько версий KDE (например KDE2 и KDE3), вы можете установить KonsoleKalendar не в тот каталог KDE. Если необходимо, вы можете задать каталог KDE как параметр. Например, если KDE установлен в /opt/kde3:
./configure --prefix=/opt/kde3
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team