# Руководство пользователя &kontact;

## Введение

&kontact; — это интегрированное решение по управлению персональной информацией пользователя. Программа объединяет известные приложения &kde; для работы с электронной почтой, планированием, адресными книгами и заметками (&kmail;, &korganizer;, &kaddressbook; и &knotes;) в единый комплекс. Основанная на компонентной структуре, программа &kontact; предоставляет те же функциональные возможности, что и отдельные приложения, а также добавляет дополнительные функции, используя интеграцию. &kontact; запускает приложения как компоненты. Пользователи могут выбрать, как запускать приложения: в составе &kontact;, или автономно.

В дополнение к функциональным возможностям отдельных приложений &kontact; показывает дайджест информации и предоставляет возможность перетаскивания (drag & drop) объектов между компонентами.

## Компоненты &kontact;

&kontact; интегрирует следующие приложения. Сведения об их использовании доступны в соответствующих руководствах (и применимы как к запуску в составе &kontact;, так и в качестве автономных).

&kmail;

- Почтовый клиент &kde;.

&korganizer;

- Программа с функциями календаря и планировщика &kde;.

&kaddressbook;

- Диспетчер контактов &kde;.

&knotes;

- Программа для работы с заметками &kde;.

&akregator;

- Программа чтения лент новостей в формате RSS &kde;.

## Главное окно &kontact;

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

### Боковая панель

Боковая панель имеет несколько функций. Она позволяет переключаться между компонентами, отображает активный компонент и служит областью для перетаскивания объектов между приложениями.

Боковая панель &kontact; Боковая панель &kontact;

Боковая панель &kontact;

Для переключения между компонентами просто нажмите соответствующий значок. При этом в главной панели будет показано основное окно компонента, его меню, панель инструментов и строка состояния. При активации компонента в первый раз может возникнуть небольшая задержка, поскольку компоненты загружаются по запросу. Это значит, что неиспользуемые компоненты не будут занимать память.

Значки на боковой панели возможно использовать как область для перетаскивания. Например, возможно перенести письмо из почтового компонента на значок списка задач или календаря для создания задачи или события, связанного с этим письмом.

Также возможно менять размер значков на боковой панели. Чтобы это сделать, щёлкните по боковой панели правой кнопкой мыши и выберите размер в появившемся контекстном меню (значки могут быть большими, обычными или маленькими). В этом меню также имеется пункт, при выборе которого вместо значков будет показан текст.

Чтобы скрыть боковую панель, просто потяните за разделитель. Альтернативная навигация обеспечивается панелью инструментов Навигация (её возможно расположить произвольно). Дополнительные сведения о панели инструментов Навигация доступны в разделе bars.

### Главная панель

Панель справа, занимающая основную часть &kontact;, — это главное окно активного компонента. Оно точно соответствует главному окну приложения, которое появляется при его запуске в качестве автономного. Подсвеченный значок на боковой панели указывает, какому приложению принадлежит главная панель. При следующем запуске &kontact; показывает компонент, который был активным при предыдущем запуске &kontact;.

Главная панель &kontact; Главная панель &kontact;

Главная панель &kontact;

Более того, существует два способа определения компонента, который по умолчанию открывается при каждом запуске &kontact;. Первый — это указание аргумента в командной строке вызова программы &kontact; (подробнее — command-line). Второй — это параметр в диалоговом окне настройки &kontact;, который позволит всегда запускать &kontact; в определённом режиме.

Чтобы получить доступ к этому параметру, откройте пункт меню Настройка Настроить Kontact… и в списке выберите Настройка Kontact.

Параметр выбора компонента, который открывается при запуске &kontact; Параметр выбора компонента, который открывается при запуске &kontact;

Параметр выбора компонента, который открывается при запуске &kontact;

### Меню, панель инструментов и строка состояния

Меню, панель инструментов и строка состояния адаптируются для активного компонента. Это значит, что в дополнение к общим функциям (например, меню «Справка»), которые присутствуют у всех компонентов, есть действия, которые меняются при смене компонента. Эти действия полностью совпадают с теми действиями, которые доступны при запуске приложения в качестве автономного.

Меню &kontact; при просмотре дайджеста, почты и календаря Меню &kontact; при просмотре дайджеста, почты и календаря Меню &kontact; при просмотре дайджеста, почты и календаря Меню &kontact; при просмотре дайджеста, почты и календаря Меню &kontact; при просмотре дайджеста, почты и календаря Меню &kontact; при просмотре дайджеста, почты и календаря

Меню &kontact; при просмотре дайджеста, почты и календаря

Кроме того, &kontact; может отображать панель инструментов Навигация, которая, как и боковая панель, позволяет получить доступ к компонентам &kontact;. Однако, в отличие от боковой панели, кнопки на панели инструментов Навигация нельзя использовать для операций перетаскивания между компонентами.

Чтобы активировать эту панель инструментов, выберите пункт меню Настройка Видимые панели инструментов Навигация.

Панель Навигация &kontact;. Панель Навигация &kontact;.

Панель Навигация &kontact;.

Действие, присутствующее во всех компонентах, — это Создать. Оно позволяет создавать новые объекты, включая письма, контакты, события и задачи, независимо от активного в текущий момент компонента. При необходимости будет запущен компонент, ответственный за обработку выбранного объекта, который и примет созданный объект.

Меню «Создать» в &kontact; Меню «Создать» в &kontact;

Меню «Создать» в &kontact;

### Перетаскивание

&kontact; предоставляет расширенные возможности перетаскивания объектов между входящими в программу компонентами. Далее следует краткое описание каждой возможной операции перетаскивания и её результат.

#### &kmail; -> список задач &korganizer;

Перенос письма из списка писем &kmail; на значок списка задач &korganizer; ( ) создаёт новую задачу с заголовком Письмо: `Тема` и содержимым От: `Отправитель` Кому: `Получатель` Тема: `Тема` (текст, который выглядит `вот так`, подставляется из самого сообщения). Кроме того, само письмо добавляется в новую задачу в виде вложения.

#### &kmail; -> календарь &korganizer;

Перенос письма из списка писем &kmail; на значок календаря &korganizer;( ) создаёт новое событие с заголовком Письмо: `Тема` и содержимым От: `Отправитель` Кому: `Получатель` Тема: `Тема письма` (текст, который выглядит `вот так`, подставляется из самого сообщения). Кроме того, само письмо добавляется в новое событие в виде вложения.

Обратите внимание, перетаскивание объекта на значок списка задач создаёт задачу, тогда как перетаскивание на значок календаря создаёт событие. Более подробная информация об этом доступна в документации &korganizer;.

#### &kmail; -> &kaddressbook;

Перенос письма из списка писем &kmail; на значок &kaddressbook; ( ) создаёт контакт с адресом электронной почты отправителя, если он ещё не существует. Диалог уведомит пользователя об этом действии.

#### &kaddressbook; -> список задач &korganizer;

Перенос любого количества записей из списка контактов &kaddressbook; на значок списка задач &korganizer; ( ) создаёт новую задачу с заголовком "Встреча" и выбранными контактами как участниками.

Обратите внимание, перетаскивание объекта на значок списка задач создаёт задачу, тогда как перетаскивание на значок календаря создаёт событие. Более подробная информация об этом доступна в документации &korganizer;.

#### &kaddressbook; -> календарь &korganizer;

Перенос любого количества записей из списка контактов &kaddressbook; на значок календаря &korganizer; ( ) создаёт новое событие с заголовком "Встреча" и и выбранными контактами как участниками.

Обратите внимание, перетаскивание объекта на значок списка задач создаёт задачу, тогда как перетаскивание на значок календаря создаёт событие. Более подробная информация об этом доступна в документации &korganizer;.

## Дайджест

При первом запуске &kontact; по умолчанию показывается дайджест — самые важные сведения из выбранных компонентов &kontact;. Это могут быть заметки, предстоящие встречи или дни рождения, выполняемые задачи, новые сообщения и прочее. Показ информации настраивается выбором соответствующих пунктов в диалоге настройки &kontact;.

Дайджест &kontact; Дайджест &kontact;

Дайджест &kontact;

### Изменение положения компонентов дайджеста

Дайджест позволяет регулировать расположение модулей в самой области просмотра. Например, чтобы модуль «Особые даты» отображался в нижнем левом углу, а модуль «Задачи» — в верхнем правом, следует изменить параметры дайджеста.

Переместить модули дайджеста несложно: достаточно просто перетащить их туда, где они должны располагаться. Зажмите клавишу &Ctrl;, щёлкните по серой области заголовка нужного модуля левой кнопкой мыши и, удерживая кнопку нажатой, перетащите этот модуль туда, куда требуется. Обратите внимание, что размещение выполняется относительно других модулей. Например, модуль «Почта» может располагаться ниже модуля «Задачи», но переместить его в любое положение не получится. Если в дайджесте подключён только один модуль, то его возможно перемещать лишь между двумя столбцами дайджеста. Два модуля могут располагаться либо в одном столбце друг под другом, либо в двух столбцах отдельно друг от друга; и так далее. При перетаскивании модуля будет отображаться небольшое окно предварительного просмотра, которое появляется в области курсора и показывает выбранный модуль.

Настройка дайджеста &kontact; Настройка дайджеста &kontact;

Настройка дайджеста &kontact;

## Настройка &kontact;

### Диалог настройки &kontact;

При выборе пункта Настроить &kontact;… в меню Настройка будет открыт диалог настройки &kontact;. Он содержит параметры настройки всех компонентов &kontact;. Щёлкните по символу > рядом с названием компонента для отображения соответствующих параметров. Выберите один из них для просмотра соответствующего раздела настройки в правой части окна.

Диалог настройки &kontact; Диалог настройки &kontact;

Диалог настройки &kontact;

Установка флажка рядом с названием какого-либо компонента приводит к его добавлению на боковую панель и в дайджест. Когда по значку компонента на боковой панели выполняется щелчок, этот компонент загружается и отображается на главной панели. Снятие флажка приводит к удалению компонента с боковой панели и дайджеста. Изменения, внесённые в этом диалоге, вступят в силу при нажатии кнопки Применить или кнопки ОК.

Также возможно настраивать отдельные компоненты, активируя их щелчком по соответствующему значку на боковой панели и выбирая пункт меню Настроить `имя приложения` в меню Настройка.

Меню параметров &kontact; с выбранным компонентом почты Меню параметров &kontact; с выбранным компонентом почты

Меню параметров &kontact; с выбранным компонентом почты

### Настройка дайджеста &kontact;

При выборе пункта Настроить дайджесты... в меню Настройка &kontact; (этот пункт меню доступен при просмотре дайджеста) появится диалог, позволяющий выбрать модули дайджеста &kontact;, данные которых будут показаны в дайджесте. Ниже приведён краткий список доступных модулей и их предназначение:

Выбор дайджеста Выбор дайджеста

Выбор дайджеста

#### Модули дайджеста &kontact;: Календарь

Модуль Календарь добавляет в представление дайджеста область Предстоящие события. Она содержит все текущие события.

Модуль дайджеста календаря в &kontact; Модуль дайджеста календаря в &kontact;

Модуль дайджеста календаря в &kontact;

#### Модули дайджеста &kontact;: Почта

Модуль Почта добавляет в представление дайджеста область с названием Новые письма. Это поле обновляется при каждом получении почты и показывает количество писем и папки, в которых они находятся.

Модуль дайджеста почты в &kontact; Модуль дайджеста почты в &kontact;

Модуль дайджеста почты в &kontact;

#### Модули дайджеста &kontact;: Заметки

Модуль Заметки добавляет в представление дайджеста область с названием Заметки. Это поле содержит заголовки всех текущих заметок (по умолчанию заголовком заметок является время/дата их создания). Щелчок по заголовку заметки приводит к открытию области просмотра «Заметки».

Модуль дайджеста заметок в &kontact; Модуль дайджеста заметок в &kontact;

Модуль дайджеста заметок в &kontact;

#### Модули дайджеста &kontact;: Задачи

Модуль Задачи добавляет в представление дайджеста область с названием Предстоящие задачи. Это поле содержит все текущие задачи, включая завершённые. Оно включает заголовок, процент выполнения и текущее состояние задачи. Обратите внимание, что возможно удалить все завершённые задачи из списка задач &kontact;. В текущей версии программы при щелчке по заголовку задачи ничего не произойдёт.

Модуль дайджеста задач в &kontact; Модуль дайджеста задач в &kontact;

Модуль дайджеста задач в &kontact;

#### Модули дайджеста &kontact;: Особые даты

Модуль Особые даты добавляет в представление дайджеста область с названием Предстоящие особые даты. Эта область содержит информацию, основанную на критериях, которые были выбраны в параметрах этого модуля при настройке дайджеста &kontact;. Модуль Особые даты очень полезен, так как он отображает дни рождения, юбилеи, праздники и особые случаи как из календаря, так и из списка контактов.

Модуль особых дат в &kontact; Модуль особых дат в &kontact;

Модуль особых дат в &kontact;

## Командная строка &kontact;

В &kontact; предусмотрено несколько аргументов командной строки для выполнения определённых действий.

Конечно же, &kontact; поддерживает общие для всех приложений &kde-frameworks;/&Qt; аргументы командной строки. Чтобы ознакомиться со списком аргументов, обратитесь к man-страницам qt6options и kf6options.

&kontact; также поддерживает несколько собственных аргументов.

### Аргументы командной строки

#### Относящиеся к модулям аргументы

Для получения списка доступных в &kontact; модулей введите:

`%` `kontact --list`

Затем, для запуска &kontact; с активацией модуля, наберите:

`%` `kontact --module `название_модуля``

Где `название_модуля` — название модуля из списка, полученного с помощью предыдущей команды.

#### Аргументы управления запуском

Чтобы запустить &kontact; в свёрнутом виде

Свёрнутый вид — это скрытие окна приложения, при котором само приложение доступно только на панели задач.

, введите:

`%` `kontact --iconify`

## Технические особенности реализации

&kontact; активно использует некоторые технологии &kde; такие как KParts и &DBus;.

Интегрирование графического пользовательского интерфейса компонентов осуществлено спомощью модулей, реализующих KParts-версии приложений. Для этого требовалась лишь незначительная прослойка между &kontact; и ужесуществующим кодом отдельных программ-компонентов.

Для связи между компонентами используется &DBus;. При этом вызов методов осуществляется прозрачно как для автономного приложения, так и для KPart в &kontact;. Когда они выполняются внутри &kontact;, используется эффективный режим работы &DBus; в пределах одного процесса.

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

&kontact;

© Разработчики &kde;, 2001—2021

Участники:

- &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

- &Daniel.Molkentin; &Daniel.Molkentin.mail;

- &Don.Sanders; &Don.Sanders.mail;

- &Tobias.Koenig; &Tobias.Koenig.mail;

- Allen Winter winter@kde.org

- Rafael Fernández López ereslibre@kde.org

- &David.Faure; &David.Faure.mail;

- &Ingo.Kloecker; &Ingo.Kloecker.mail;

- Sven Lüppken sven@kde.org

- Torgny Nyblom nyblom@kde.org

- Zack Rusin zack@kde.org

- Matthias Hölzer-Klüpfel mhk@kde.org, первоначальный автор среды &kontact;.

- Все разработчики интегрированных в &kontact; приложений. Они сделали основную работу.

Документация © 2004—2005

Участники:

- &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

- Antonio Salazar savedfastcool@gmail.com

- &Daniel.Molkentin; &Daniel.Molkentin.mail;

- Все члены списка рассылки документации &kde;, помогавшие в написании и оформлении.

Перевод на русский: Олег Баталов olegbatalov@mail.ru

Мария Шикуноваtranslation-team@basealt.ru

Олеся Герасименкоtranslation-team@basealt.ru

&underFDL; &underGPL;

## Руководство администратора

### Проблемы совместимости

В этом разделе содержится информация о том, как обеспечить эффективное взаимодействие программы &kontact; и различных решений для совместной работы.

#### Outlook и Exchange

В диалоговом окне конфигурации &kontact; в разделе Почта Прочее на вкладке Приглашения находятся следующие параметры, помогающие осуществлять обмен данными с программой Microsoft Outlook(tm), работающей в среде Kolab или в среде Microsoft Exchange(tm).

Искажать заголовки отправителя и получателя в ответах на приглашения (для Outlook)

- Включите этот параметр, чтобы программа Microsoft Outlook(tm) могла распознавать ваши ответы на приглашения.

  Программа Microsoft Outlook содержит ряд недоработок в реализации стандарта iCalendar. Этот параметр исправляет одну из них. Включите его, чтобы пользователи Outlook могли получать ваши ответы.

  Подробности: при отправке приглашения iCal заголовку «From:» присваиваются те же параметры, что и заголовку «To:». Кроме того, заголовок «X-KMail-Identity» устанавливается в значение UIOD заголовка «To:», а поле «BCC:» очищается. Outlook будет распознавать ответ только в том случае, если заголовок «From:» совпадает с заголовком «To:» в приглашении.

Отправлять приглашения в теле письма

- Приглашения обычно отправляются в формате почтовых вложений. При включении этой опции приглашения и ответы на них будут отправляться непосредственно в тексте письма, чтобы программа Microsoft Outlook могла их распознавать. Учтите, что при этом пропадает описание, которое способны читать почтовые программы, и адресаты, почтовые программы которых не поддерживают чтение приглашений, будут удивлены странным видом писем. Адресаты с почтовыми программами, поддерживающими чтение приглашений, смогут работать с ними.

  Подробности: если этот параметр включён, при отправке приглашения iCal тело сообщения создаётся из данных вложения, а заголовок «Content-Type» устанавливается в значение «text/calendar; method=something; charset="utf-8"».

  Автоматическая отправка также включена, поэтому создание сообщений не требует участия человека.

  Шифрование и самоподписывание отключены.

Именование приглашений, совместимое с Exchange

- В Microsoft Outlook при работе с сервером Microsoft Exchange(tm) есть проблемы с распознаванием отвечающих стандартам групповых сообщений. Включите этот параметр для отправки групповых приглашений в том виде, в котором они могут быть распознаны Microsoft Exchange(tm). Приглашение будет выслано в качестве вложенного файла с названием `ical.ics`.

  Подробнее: при отправке приглашения iCal сообщению присваивается тема «(Отклонено|Принято предварительно|Принято|Делегировано): тема». Приглашение будет отправлено в виде вложенного файла с именем `ical.ics`.

Имена вложений, совместимые с Outlook

- Включите этот параметр, чтобы программа Outlook(TM) распознавала имена вложений, содержащие кириллические символы.

### Проблемы с поведением

В этом разделе содержится информация о том, как сделать поведение &kontact; более похожим на поведение других клиентов совместной работы.

#### Написание сообщений

Пользователи Outlook привыкли разделять адреса в полях «Кому:», «Копия:» или «Скрытая копия:» точкой с запятой («;»), а не только запятой («,»). По умолчанию в &kontact; в качестве символа разделения адресов допускается только запятая. Чтобы разрешить также использование точки с запятой, измените значение параметра `AllowSemicolonAsAddressSeparator` с «false» на «true» в файле `share/config.kcfg/messagecomposer.kcfg`.

### Компромиссы с RFC

&kontact; предназначен для максимально эффективного взаимодействия с различными решениями для совместной работы. С этой целью авторы иногда были вынуждены идти на компромиссы в отношении опубликованных в Интернете RFC. Эти компромиссы являются основой для низкоуровневых библиотек, без которых &kontact; не сможет работать.

Авторы никогда сознательно не нарушают принципы RFC.

Далее приводится список компромиссов с RFC, которые были использованы при создании &kontact; или низкоуровневых библиотек, необходимых для работы &kontact;:

- При записи значений длительности в файлы iCalendar &kontact; никогда не записывает свойство длительности в неделях (т. е. 1*цифра "W"); вместо этого целое число недель всегда умножается на 7 и записывается в днях (т. е. 1*цифра "D").

&documentation.index;