Профиль пользователя в LibreOffice

From The Document Foundation Wiki
Jump to: navigation, search

Профиль пользователя - это каталог, в которм хранятся все данные, связанные с пользователем (расширения, пользовательские словари, шаблоны и др.). Этот каталог не удалятся во время удаления или обновления, сохраняя все пользовательские настройки.


Мы стараемся как можно быстрее перевести эту страницу!
Но, возможно, нам не хватает вашей помощи. ЧаВо по использованию wiki

Заблаговременные советы

До того как вы начнёте изменять что-либо в своём профиле, сделайте его архивную копию! Может быть, ваши изменения не принесут желаемого результата, и вы захотите вернуться к прошлой версии вашего профиля. Или, может быть разработчики LibreOffice попросят вас прислать копию вашего профиля для отладки и исправления ошибок. Во всяком случае, не удаляйте архивную копию вашего профиля поспешно.

Исправление ошибки tdf#53583 ("Helper tool collecting user configuration") может сделать сбор сведений о пользовательском профиле и создание отчетов об ошибках связанных с ним более простым для пользователя (не нужно будет лишний раз делать копию профиля).

Местонахождение пользовательского профиля

Основные пути до пользоваетльских директорий

Пути до пользовательских директорий можно посмотреть пройля в меню Сервис ▸ Параметры... ▸ LibreOffice ▸ Пути; большенство директорий отмеченых там находятся в директории пользоваетльского профиля.

Местонахождение по умолчанию

Ниже приводится местонахождение профиля пользователя по умолчанию. В зависимости от операционной системы и версии LibreOffice оно может отличаться .

Im-jabber.svg

Обратите внимание:
<user name> представляет собой имя, используемое в системе для входа в неё. Это имя из учетной записи компьютера, не связанно с самим LibreOffice.

Im-jabber.svg

Обратите внимание:
Эти папки скрыты. Для того чтобы увидеть их, вам необходимо включить опцию отображения скрытых папок в вашем файловом менеджере.

Windows

Для пользователей Windows:

  • LibreOffice 4 до Vista: \Documents and Setting\<user name>\Application Data\libreoffice\4\user
  • LibreOffice 3 до Vista: \Documents and Setting\<user name>\Application Data\libreoffice\3\user
  • LibreOffice 4 для Vista: %appdata%\libreoffice\4\user
  • LibreOffice 3 для Vista: %appdata%\libreoffice\3\user
  • LibreOffice 4 для 8: %appdata%\LibreOffice\4\user

При обычной остановке в Windows эти папки находятся на диске C:\.

Im-jabber.svg

Обратите внимание:
В зависимости от установленной версии Windows имя вериктории Application Data может быть локализовано.

GNU/Linux

Для пользователей GNU/Linux:

  • Для LibreOffice 4: /home/<user name>/.config/libreoffice/4/user
  • Начиная с LibreOffice 3.5.0: /home/<user name>/.config/libreoffice/3/user
  • До LibreOffice 3.5.0: /home/<user name>/.libreoffice/3/user
Im-jabber.svg

Обратите внимание:
Это расположение соответсвует официальным пакетам LibreOffice распространяемых The Document Foundation. Если вы используете версии пакетов предоставляемых вашит разработчиком дистрибутива Linux, местонахождение директорий может отличаться.

Mac OS X

Для пользователей Mac:

  • LibreOffice 4: /Users/<user name>/Library/Application Support/libreoffice/4/user
  • LibreOffice 3: /Users/<user name>/Library/Application Support/libreoffice/3/user

LibreOffice Portable

Для пользователей версией LibreOffice Portable:

  • LibreOfficePortable\Data\settings\

Resolving corruption in the user profile

There is always a possibility (for example, after a power cut when LibreOffice is in use) of corruption for any file inside the user profile. If you notice any strange behavior on LibreOffice, or simply it fails to start, the first thing to try is to reset the user profile. To do so, follow these steps:

  • After closing all LibreOffice instances (including the "QuickStart" on system tray) rename the folder with your user profile (changing, for example, "user" by "user-old"). There is no need to delete this folder: in fact there is a possibility to recover something (for example, your templates).
  • Restart LibreOffice: a new user profile will be generated.
  • Check if the problem is now solved.
    • If the problem persists, you can restore the previous profile because it was not the origin of the problem. To restore the previous profile, delete the new folder and give the old one its former name.
    • If the problem is solved, one or more files on your profile are corrupted... but not necessarily all. You can always replace one by one the folders inside your user profile with the old ones (restarting LibreOffice every time including the quickstart) to see which one produce the failure.

User profile content

Inside the user profile there are several highly specialized folders:

  • autocorr: the substitution table you can configure on Tools ▸ AutoCorrect Options
  • autotex: the "AutoText" (Edit ▸ AutoText) you created.
  • backup: the file backups you get when enabling the option "Always create backup copy" is enabled under Tools ▸ Options ▸ Load/Save ▸ General.
  • basic: all your macros.
  • config: some configuration files.
  • database: the databases you registered.
  • gallery: your personal gallery (Tools ▸ Gallery).
  • psprint: may contain a "driver" subfolder (which may be empty), a "fontmetric" subfolder (which may be empty), and a "pspfontcache" file (in which printer fonts are cached). The "psprint" folder may be missing entirely. If it is present, it may be deleted without ill effect. If it is deleted, it will not necessarily be recreated.
  • registry: contents the most part of the configuration files.
  • Scripts: contains the optional Folders for user-defined scripts: beanshell, java, javascript and python. (for example the scripts you find over: tools ▸ Macros ▸ Organize Macros ▸ python ▸ My Macros)
  • store: may either be empty or contain a file named ".templdir.cache" (in which templates are cached). The "store" folder may be missing entirely but is usually present. If present, it may be deleted without ill effect. If it is deleted, it is usually but not always recreated.
  • temp: may contain an "embeddedfonts" subfolder that in turn contains a "fromdocs" subfolder and a "fromsystem" subfolder. The "fromdocs" and "fromsystem" subfolders may either be empty or contain temporary files. The "temp" folder may also contain a file named "document_io_logring.txt", which is a log of executed instructions. The "temp" folder may be missing entirely. If it is present, it may be deleted without ill effect. If it is deleted, is is not always recreated.
  • template: here you can find your custom templates (File ▸ Templates ▸ Organize ▸ My templates)
  • uno_packages: the extensions installed by the user.
  • wordbook: the custom dictionaries.

Some extensions (like OOoLatex) could add other folders.

NOTE: other than the user profile, LibreOffice considers the configuration for all users you can find in the subfolders inside the main installation folder (for example, /opt/libreoffice/share on Linux for the "official" LibreOffice build, or \Program files\libreoffice\share on Windows)

Changing the location of the user profile

Above was indicated the default location for the user profile folders on different systems. This location can be changed editing a file whose name depends on the operative system considered:

  • bootstraprc on *nix like systems
  • bootstrap.ini on Windows

You can find this file on:

  • /opt/libreoffice/program/bootstraprc on Linux
  • <installation-folder>\program\bootstrap.ini on Windows

Changing the user profile folder could be useful to maintain several LibreOffice versions running simultaneously (for example, to test development versions and report bugs, or on a business environment to set several users use the same profile.

To modify the directory where the user profile is created, you need to edit the variable "UserInstallation".

The default value for that variable is

UserInstallation=$SYSUSERCONFIG/<user profile folder>

where <user profile folder> depends on the operative system (see UserProfile#User profile location):

$SYSUSERCONFIG refers to the directory where the data for the computer account user are stored, it is not a directory specific of LibreOffice. For example, it represents /home/<user name> on Linux systems or \Users\<user name> on Windows vista.

NOTE: before you can modify this folder, you need to exit all LibreOffice applications, including the QuickStarter on the system tray

For example, on Linux systems you can change

UserInstallation=$SYSUSERCONFIG/.libreoffice/3

by

UserInstallation=$SYSUSERCONFIG/.New_directory

for a "local" change, or

UserInstallation=file:///home/One_Folder/.One_Place

so the user profile is shared by all users on the system.

Same applies to drives in case of Windows:

UserInstallation=file:///D:/libreoffice/config

You can also use the following command line parameter to override the user profile directory: soffice -env:UserInstallation=file:///tmp/foobar

Reusing user profiles

A single user profile must only ever be accessed by a single LibreOffice process. (Internally, if a single user starts multiple LibreOffice processes that would all access the same user profile, only the first process does any actual work, like opening documents for editing, and the excess processes pass on their command line arguments to the first one for processing.) Especially, one must not reuse a single user profile across multiple accounts on one computer, or across computers.

Also, different versions of LibreOffice can store different sorts of data in their respective user profiles. If a new version of LibreOffice does not yet find a user profile at the default location for that version, it looks for existing user profiles from old LibreOffice or OpenOffice.org versions at well-known locations and migrates any data it can continue to use to the new location. But if you explicitly request a LibreOffice version to reuse a user profile from another version, that can cause strange effects.

User Profile Bug Tool

It would be very helpful for us to have a tool to report and identify problems/corruption in user profiles. We've got an EasyHack bug filed in Bugzilla:

  • tdf#53583 - Helper tool collecting user configuration

Tool Features

Features:

  • Find the used configuration; it is in hidden directories, so it is more complicated for normal users
    • Automation here is a big win, both for ease of use and for consistency


  • Create single zip or tar.gz archive that can be attached to the bug
    • Q: How big can the UserProfile get? Are we going to bump up against the 10M limit on TDF Bugzilla attachments?


  • Remove sensitive information if any
    • Sanitizing the profile is very important
    • HOWEVER: If we can't reproduce the bug with a sanitized profile, the output is a lot less useful to us
    • IDEA: Add step for user to test LibreOffice + sanitized profile before upload.
      • If the problem still exists, then upload
      • If the sanitization fixed the problem, then... what? => Perhaps ask the user to file a bug and contact QA for advice on how to proceed.
  • Add more information about the system if needed
    • Q: What information is not currently included in the files of the UserProfile that would be helpful to have?
  • Pack the problematic user configuration and attach it to the related bugreport.
    • IDEA: We could use the Bugzilla perl module to do the upload directly from the command-line
      • (would still need user to input their Bugzilla credentials...)