Akonadi and AddressBook/ru: Difference between revisions

From KDE Wiki Sandbox
(Updating to match new version of source page)
(Created page with ";Реальные данные :Под ''реальными'' мы понимаем данные, такие как контакты и события. Эти данные х...")
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
<languages />
<languages />


''This information was provided by Tobias Koenig, '''KDE-PIM''' developer.''
{{Note|Информацию из этой статьи можно применить и к другим приложениям, использующим  [[Special:myLanguage/Akonadi|Akonadi]], например, KMail и KOrganizer.}}


==Some Definitions==
''Эта информация была предоставлена Тобиасом Кенигом ( Tobias Koenig ), разработчиком '''KDE-PIM''' .''


By ''real data'' we mean the data, like the contacts or events. These data are stored either on a groupware server or in local files. Where exactly depends on the resource you are using. E.g. the ''Personal Contacts'' resource stores its data under $HOME/.local/share/contacts while the ''VCard File'' resource (which is not recommended to use anyway [[Image:Face-smile.png|16px]]) stores its data under $HOME/.kde/share/apps/kabc/std.vcf.
==Некоторые определения==


The ''cached data'' are copies of the real data that are kept in the database for faster access and offline caching. The database also keeps the ''meta data'' which are management data needed by '''Akonadi''' to work correctly.
;Реальные данные
:Под ''реальными'' мы понимаем данные, такие как контакты и события. Эти данные хранятся либо на сервере, либо в локальных файлах. Где именно - зависит от ресурса, который вы используете. Такой ресурс, как ''Личные  Контакты'' хранит свои данные в $HOME/.local/share/contacts , в то время, как ресурс ''VCard File'' (который все равно не рекомендуется использовать[[Image:Face-smile.png|10px]]) по умолчанию, хранит свои данные в $HOME/.kde/share/apps/kabc/std.vcf.


The ''configuration data'' are the data that configure the '''Akonadi''' server and the individual resources. The configuration data for the server can be found under $HOME/.config/akonadi, the configuration for the resources are mostly stored under $HOME/.kde/share/config/akonadi_xyz_resourcerc# ('''''xyz''''' is name of resource and '''''#''''' its instance number).
;Кэшированные данные
:''Кэшированные данные'' - это копии реальных данных, которые хранятся в базе данных для быстрого доступа к ним, а также оффлайн кэширования. База данных также хранит ''мета-данные'' которые являются управляющими и требуются '''Akonadi''' для корректной работы.


The '''Akonadi''' server configuration is a couple of files in ''$HOME/.config/akonadi'' - this can be changed through environment variables, $XDG_DATA_HOME and $XDG_CONFIG_HOME, defaulting to ''$HOME/.local/share'' and ''$HOME/.config'' respectively if not set.  It contains which data sources and helper programs are active and will be started and watched (so they can be restarted on crashes) by one of '''Akonadi's''' server processes '''(akonadi_control)'''.  KDE's local base directory can be changed using $KDEHOME environment variable, defaulting to $HOME/.kde when not set (or to $HOME/.kde4 if the distributor changed the default by patching the code).
;Данные конфигурации
See {{Input|1=kde4-config --path data}}
:''Данные конфигурации'' - это данные конфигурации сервера '''Akonadi''' и индивидуальных ресурсов. Главные конфигурационные данные для сервера могут быть найдены в $HOME/.config/akonadi. Конфигурационные данные для каждого индивидуального ресурса хранятся в $HOME/.kde/share/config/akonadi_xyz_resourcerc# ('''''xyz''''' имя ресурса '''''#''''' номер его экземпляра) или, возможно, в $HOME/.config/akonadi.


Each data source handler (called resources) or helper program (called agents)
:Конфигурация сервера '''Akonadi'''- это пара файлов, расположенных в ''$HOME/.config/akonadi'' - конфигурация может быть изменена через редактирование переменных окружения, $XDG_DATA_HOME и $XDG_CONFIG_HOME, содержащих, по умолчанию, значения ''$HOME/.local/share'' и ''$HOME/.config'' соответственно, если еще не определеныОни содержат информацию о том, какие источники данных и вспомогательные программы активны и будут запущены или перезапущены ( например, при аварийном завершении) одним из процессов сервера '''Akonadi''' '''(akonadi_control)'''.  Директория локальной базы данных KDE's может быть изменена при помощи переменной окружения $KDEHOME, по умолчанию ссылающийся на $HOME/.kde  (или на $HOME/.kde4 если ее изменил дистрибьютор ).
can have its own configuration although some agents or resources don't require configuration.  The general rule is that for every entry in $HOME/.config/akonadi/agentsrc there is a corresponding configuration file in $HOME/.kde/share/config.  For example, if the [Instances] section in agentrc contains an entry for akonadi_ical_resource_2, there is also a config file called akonadi_ical_resource_2rc in the KDE config directory.
:Эти пути можно увидеть используя  {{Input|1=kde4-config --path data}} и {{Input|1=kde4-config --path config}}


Depending on the type of data, such config files for resources will have
:Каждый обработчик источника данных (называемый ресурсом) или вспомогательная программа (называемая агентом) может иметь свою собственную конфигурацию, хотя некоторые агенты или ресурсы не нуждаются в конфигурированииОсновное правило заключается в том, что для каждого элемента в $HOME/.config/akonadi/agentsrc есть соответствующий конфигурационный файл в $HOME/.kde/share/config. Например, если секция [Instances] в agentrc содержит элемент akonadi_ical_resource_2, значит также есть конфигурационный файл, называющийся akonadi_ical_resource_2rc, в директории конфигураций KDE.
filenames or directory names of where the data is storedCommon locations are KDE's legacy default files, e.g. $HOME/.kde/share/apps/korganizer/std.ics.  New default locations are files and directories in $HOME/.local/share,
e.g. $HOME/.local/share/contacts.


For now (as in actually released versions) the database is merely used for
:Подобные файлы конфигураций ( или директории с файлами конфигураций ) для ресурсов будут иметь названия зависящие от конкретного типа данных. Обычно эти файлы можно найти по пути из устаревших версий KDE такому как  $HOME/.kde/share/apps/korganizer/std.icsВ новых версиях  KDE они находятся в $HOME/.local/share, и $HOME/.local/share/contacts.
caching and keeping structural information (e.g. which addressbook a contact
belongs to)This will change when Akonadi is being used for email, since state information like read/unread is also stored there (unless the backend is also capable of doing this, e.g. IMAP).


==Organising Backups==
: На данный момент (в выпущенных релизах) база данных используется только для кэширования и хранения структурной информации (например, к какой адресной книге принадлежит контакт). Эта ситуация изменится, когда Akonadi будет использоваться для электронной почты, поскольку там, помимо всего прочего, хранится информация о статусе письма, такая как прочитано/непрочитано (конечно, если серверная часть также способна это делать, например, IMAP).


So now we need to decide what to back up.  If you want to backup the "real data", then it depends on the resources you have configured... if you use a groupware server, then the backup should be done there. For contacts, the files under $HOME/.local/share/contacts will normally be what you need.
==Организация резервного копирования==


The '''Akonadi''' tray icon offers you a backup and restore function. That backs up the "cache data" which might not include all of your data! It can be helpful if you want to clone a system 1:1, then you can copy the cached data together with the real data and the configuration, so you don't have to load the data again from the sources (e.g. groupware server).
Если вы хотите сделать резервное копирование "реальных данных", тогда оно будет зависеть от ресурсов, которые в сконфигурировали... Если вы используете сервер в сети, тогда резервное копирование должно быть выполнено на нем. А если вы хотите выполнить резервное копирование  контактов, тогда файлы по адресу $HOME/.local/share/contacts будут, как раз тем, что вам нужно.
 
Иконка '''Akonadi''' в системном трее предлагает  функционал резервного копирования  и восстановления данных из резервных копий. Здесь подразумевается резервное копирование только данных, находящихся в "кэше", и не обязательно будет включать все ваши данные. Это может быть полезным в случае, когда вы хотите сделать точную копию всей системы 1:1, в этом случае вы можете скопировать данные из кэша вместе с "реальными данными" и настройками конфигурации.
<span id="Examining your Resources"></span>
<span id="Examining your Resources"></span>
==Examining your Resources==
==Изучение Ресурсов==


'''KRunner''' offers you '''Akonadi Resource Configuration''', or you can access this through the <menuchoice>Akonadi tray icon -> Configure</menuchoice>.  From KDE 4.6 you will find it in <menuchoice>System Settings -> Personal Information</menuchoice>  You may find several resources set up.  You may find one labelled
'''KRunner''' offers you '''Akonadi Resource Configuration''', or you can access this through the <menuchoice>Akonadi tray icon -> Configure</menuchoice>.  From KDE 4.6 you will find it in <menuchoice>System Settings -> Personal Information</menuchoice>  You may find several resources set up.  You may find one labelled
Line 58: Line 58:
==Troubleshooting==
==Troubleshooting==


''Problem'':  You update to 4.6 and your addressbook is suddenly completely blank
''Problem'':  Your update to 4.6 and your addressbook is suddenly completely blank


''Solution'':  This is new behaviour in 4.6 - you can choose whether to display specific addressbooks or all of them.  In front of each addressbook name there is a checkbox.  Use that to enable the addressbooks you want to use.
''Solution'':  This is new behaviour in 4.6 - you can choose whether to display specific addressbooks or all of them.  In front of each addressbook name there is a checkbox.  Use that to enable the addressbooks you want to use.
Line 64: Line 64:
== Related pages ==
== Related pages ==


:[[Special:myLanguage/Akonadi|Akonadi]]<br />
*[[Special:myLanguage/Akonadi|Akonadi]]<br />
:[[Special:myLanguage/KAddressBook/index|KAddressBook]]
*[[Special:myLanguage/KAddressBook/index|KAddressBook]]


[[Category:System]]
[[Category:System]]

Latest revision as of 22:58, 23 September 2022

Note
Информацию из этой статьи можно применить и к другим приложениям, использующим Akonadi, например, KMail и KOrganizer.


Эта информация была предоставлена Тобиасом Кенигом ( Tobias Koenig ), разработчиком KDE-PIM .

Некоторые определения

Реальные данные
Под реальными мы понимаем данные, такие как контакты и события. Эти данные хранятся либо на сервере, либо в локальных файлах. Где именно - зависит от ресурса, который вы используете. Такой ресурс, как Личные Контакты хранит свои данные в $HOME/.local/share/contacts , в то время, как ресурс VCard File (который все равно не рекомендуется использовать) по умолчанию, хранит свои данные в $HOME/.kde/share/apps/kabc/std.vcf.
Кэшированные данные
Кэшированные данные - это копии реальных данных, которые хранятся в базе данных для быстрого доступа к ним, а также оффлайн кэширования. База данных также хранит мета-данные которые являются управляющими и требуются Akonadi для корректной работы.
Данные конфигурации
Данные конфигурации - это данные конфигурации сервера Akonadi и индивидуальных ресурсов. Главные конфигурационные данные для сервера могут быть найдены в $HOME/.config/akonadi. Конфигурационные данные для каждого индивидуального ресурса хранятся в $HOME/.kde/share/config/akonadi_xyz_resourcerc# (xyz имя ресурса # номер его экземпляра) или, возможно, в $HOME/.config/akonadi.
Конфигурация сервера Akonadi- это пара файлов, расположенных в $HOME/.config/akonadi - конфигурация может быть изменена через редактирование переменных окружения, $XDG_DATA_HOME и $XDG_CONFIG_HOME, содержащих, по умолчанию, значения $HOME/.local/share и $HOME/.config соответственно, если еще не определены. Они содержат информацию о том, какие источники данных и вспомогательные программы активны и будут запущены или перезапущены ( например, при аварийном завершении) одним из процессов сервера Akonadi (akonadi_control). Директория локальной базы данных KDE's может быть изменена при помощи переменной окружения $KDEHOME, по умолчанию ссылающийся на $HOME/.kde (или на $HOME/.kde4 если ее изменил дистрибьютор ).
Эти пути можно увидеть используя
kde4-config --path data
и
kde4-config --path config
Каждый обработчик источника данных (называемый ресурсом) или вспомогательная программа (называемая агентом) может иметь свою собственную конфигурацию, хотя некоторые агенты или ресурсы не нуждаются в конфигурировании. Основное правило заключается в том, что для каждого элемента в $HOME/.config/akonadi/agentsrc есть соответствующий конфигурационный файл в $HOME/.kde/share/config. Например, если секция [Instances] в agentrc содержит элемент akonadi_ical_resource_2, значит также есть конфигурационный файл, называющийся akonadi_ical_resource_2rc, в директории конфигураций KDE.
Подобные файлы конфигураций ( или директории с файлами конфигураций ) для ресурсов будут иметь названия зависящие от конкретного типа данных. Обычно эти файлы можно найти по пути из устаревших версий KDE такому как $HOME/.kde/share/apps/korganizer/std.ics. В новых версиях KDE они находятся в $HOME/.local/share, и $HOME/.local/share/contacts.
На данный момент (в выпущенных релизах) база данных используется только для кэширования и хранения структурной информации (например, к какой адресной книге принадлежит контакт). Эта ситуация изменится, когда Akonadi будет использоваться для электронной почты, поскольку там, помимо всего прочего, хранится информация о статусе письма, такая как прочитано/непрочитано (конечно, если серверная часть также способна это делать, например, IMAP).

Организация резервного копирования

Если вы хотите сделать резервное копирование "реальных данных", тогда оно будет зависеть от ресурсов, которые в сконфигурировали... Если вы используете сервер в сети, тогда резервное копирование должно быть выполнено на нем. А если вы хотите выполнить резервное копирование контактов, тогда файлы по адресу $HOME/.local/share/contacts будут, как раз тем, что вам нужно.

Иконка Akonadi в системном трее предлагает функционал резервного копирования и восстановления данных из резервных копий. Здесь подразумевается резервное копирование только данных, находящихся в "кэше", и не обязательно будет включать все ваши данные. Это может быть полезным в случае, когда вы хотите сделать точную копию всей системы 1:1, в этом случае вы можете скопировать данные из кэша вместе с "реальными данными" и настройками конфигурации.

Изучение Ресурсов

KRunner offers you Akonadi Resource Configuration, or you can access this through the Akonadi tray icon -> Configure. From KDE 4.6 you will find it in System Settings -> Personal Information You may find several resources set up. You may find one labelled

Address Book - No KDE address book plugin configured yet.

That's the old compatibility bridge (possibly created by the migrator tool). You should remove this one!

std.vcf - Ready

This is the VCard File Resource which points to $HOME/.kde/share/apps/kabc/std.vcf per default. It is not recommended that you use that one, as it doesn't share the benefit of Akonadi.

Personal Contacts - Offline

That's the preferred resource for your local contacts which points to

$HOME/.local/share/contacts

Note that this may say "Offline" when in fact you are using it. This is a display bug, and can safely be ignored.

And when more components use Akonadi?

When the rest of the components move to Akonadi, will all the data be under ~/.local/share? That should make backup easy. Well, contacts and mails are stored there now, I don't know what the plan for events/todos is, but it would make sense to store them there as well. We'll keep it in mind when discussion pops up!

Troubleshooting

Problem: Your update to 4.6 and your addressbook is suddenly completely blank

Solution: This is new behaviour in 4.6 - you can choose whether to display specific addressbooks or all of them. In front of each addressbook name there is a checkbox. Use that to enable the addressbooks you want to use.

Related pages