Akonadi and AddressBook/ru: Difference between revisions

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


{{Note|This article also apply to other applications that are using [[Special:myLanguage/Akonadi|Akonadi]] for example KMail and KOrganizer.}}
{{Note|Информацию из этой статьи можно применить и к другим приложениям, использующим  [[Special:myLanguage/Akonadi|Akonadi]], например, KMail и KOrganizer.}}


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


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


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.
;Реальные данные
:Под ''реальными'' мы понимаем данные, такие как контакты и события. Эти данные хранятся либо на сервере, либо в локальных файлах. Где именно - зависит от ресурса, который вы используете. Такой ресурс, как ''Личные  Контакты'' хранит свои данные в $HOME/.local/share/contacts , в то время, как ресурс ''VCard File'' (который все равно не рекомендуется использовать[[Image:Face-smile.png|10px]]) по умолчанию, хранит свои данные в $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.
;Кэшированные данные
:''Кэшированные данные'' - это копии реальных данных, которые хранятся в базе данных для быстрого доступа к ним, а также оффлайн кэширования. База данных также хранит ''мета-данные'' которые являются управляющими и требуются '''Akonadi''' для корректной работы.


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''' и индивидуальных ресурсов. Главные конфигурационные данные для сервера могут быть найдены в $HOME/.config/akonadi. Конфигурационные данные для каждого индивидуального ресурса хранятся в $HOME/.kde/share/config/akonadi_xyz_resourcerc# ('''''xyz''''' имя ресурса '''''#''''' номер его экземпляра) или, возможно, в $HOME/.config/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 setIt 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).
:Конфигурация сервера '''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 если ее изменил дистрибьютор ).
See {{Input|1=kde4-config --path data}}
:Эти пути можно увидеть используя  {{Input|1=kde4-config --path data}} и {{Input|1=kde4-config --path config}}


Each data source handler (called resources) or helper program (called agents)  
:Каждый обработчик источника данных (называемый ресурсом) или вспомогательная программа (называемая агентом) может иметь свою собственную конфигурацию, хотя некоторые агенты или ресурсы не нуждаются в конфигурированииОсновное правило заключается в том, что для каждого элемента в $HOME/.config/akonadi/agentsrc есть соответствующий конфигурационный файл в $HOME/.kde/share/config. Например, если секция [Instances] в agentrc содержит элемент akonadi_ical_resource_2, значит также есть конфигурационный файл, называющийся akonadi_ical_resource_2rc, в директории конфигураций KDE.
can have its own configuration although some agents or resources don't require configurationThe 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.


Depending on the type of data, such config files for resources will have
:Подобные файлы конфигураций ( или директории с файлами конфигураций ) для ресурсов будут иметь названия зависящие от конкретного типа данных. Обычно эти файлы можно найти по пути из устаревших версий KDE такому как $HOME/.kde/share/apps/korganizer/std.ics.  В новых версиях  KDE они находятся в $HOME/.local/share, и $HOME/.local/share/contacts.
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
: На данный момент (в выпущенных релизах) база данных используется только для кэширования и хранения структурной информации (например, к какой адресной книге принадлежит контакт). Эта ситуация изменится, когда Akonadi будет использоваться для электронной почты, поскольку там, помимо всего прочего, хранится информация о статусе письма, такая как прочитано/непрочитано (конечно, если серверная часть также способна это делать, например, IMAP).
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==
==Организация резервного копирования==


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


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).
Иконка '''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 60: 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 66: 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