UserProfile(사용자 프로필)

TDF LibreOffice Document Liberation Project 커뮤니티 블로그 온라인 번역 도구(Weblate) Nextcloud Redmine 질문 후원

• 첫 화면
• 개발
• 디자인
• 품질 보증
• 이벤트
• 문서 작성
• 웹사이트
• 지역화
• 접근성 향상
• 홍보
• Diversity
• 도움말

• Overview
• Reporting Bugs
• How to build
• Code Overview
• Git Commands
• Debugging
• EasyHacks
• Release Plan
• FAQ
• Developers
• Extensions
• → Open Issues

What is it?

"user profile(사용자 프로필)"은 확장자, 사용자 지정 사전, 켐플릿 등 사용자와 관련된 모든 데이터를 저장하는 폴더 입니다. 이 폴더는 LibreOffice를 업데이트 하거나 삭제할 때 지워지지 않으므로 해당 사용자 지정 설정은 유지됩니다.

This folder is not removed when uninstalling or updating LibreOffice, so your customizations are kept.

There is a quick test from the command line to detect a broken profile. Check out the "Quick test for corrupted profiles" section. In any case you can follow the next steps to fix the problem.

최초 백업

사용자 프로필을 수정하기 전에, 예전 사용자 프로필로 돌아갈 수 있도록 백업파일을 만듭니다. LibreOffice 개발자는 디버그나 버그픽스를 하기 위해 사용자 파이릐 복사본을 요청할 수 있으므로 백업파일을 즉시 지우지 마십시오.

LibreOffice developers might ask for a copy of your user profile for debugging and bugfixing so please do not delete the backup file instantly.

Note: if you heavily customize LibreOffice, then making a periodic backup of the profile may help in case of problem. Even if shortcuts, user interface, etc. can be exported through single configuration files, restoring the whole profile will spare you the import of each single configuration file and the reinstallation of the extensions you could have added.

손상 해결

LibreOffice에서 많은 문제가 사용자 프로필의 손상때문에 발생합니다. LibreOffice에서 이상한 점을 발견했다면 다음의 단계를 따라 가장 먼저 사용자 프로필을 초기화 하십시오.

When noticing strange behavior in LibreOffice the first thing to do is to reset the user profile. To do so, 2 methods are available.

LibreOffice 버전 5.3과 이후 최신버전

• LibreOffice를 시작하고 Help ▸ Restart in Safe Mode를 선택합니다.
  • 'Enter Safe Mode(안전모드)' 대화상자에서 'Restart(재시작)' 선택합니다.
  • LibreOffice가 다시 시작되고 'Safe More(안전모드)'대화상자가 나올 것입니다.
• 만약 LibreOffice가 아예 시작하지 않는 것이 문제라면, 명령행에 libreoffice --safe-mode 라고 입력하거나 Windows 시작 메뉴 항목에서 "LibreOffice(안전모드)"를 사용합니다.

• Start LibreOffice and select Help ▸ Restart in Safe Mode
  • In the Enter Safe Mode dialog select Restart
  • LibreOffice will restart and display the Safe Mode dialog
• If your problem is that LibreOffice does not start at all, launch it from the command line with libreoffice --safe-mode or use the start menu entry LibreOffice (Safe Mode) on Windows

• 안전모드에서 Continue(계속하기)를 선택합니다.
• 테스트 해보고 문제가 해결되었는지 확인합니다.
  • 문제가 지속된다면 사용자 프로필이 문제의 원인이 아니었기 때문에 안전모드를 종료해도 됩니다.
  • 문제가 해결되었다면 환결설정에 문제가 있었던 것입니다. LibreOffice를 안전모드에서 다시 시작하여 안전모드 대화상자를 확인합니다. 하드웨어 가속 해제나 사용자 프로필 복원/초기화를 할 수 있습니다.

Manual procedure (all versions)

"LibreOffice 버전 5.2와 이전 버전"

• 시스템 상자의 "QuickStart(고속재시동)"을 포함하여 LibreOffice를 닫습니다..
• 사용자 프로필 폴더의 이름을 "user"에서 "user-old"로 이름을 변경합니다. 운영체제의 위치는 documented below 입니다
• LibreOffice 를 다시 시작하면 새로운 사용자 파일이 만들어질 것입니다.
• 테스트 해보고 문제가 해결되었는지 확인합니다.

• • 문제가 지속된다면 사용자 프로필이 문제의 원인이 아니었기 때문에 이전의 프로필을 복원해도 됩니다. 복원하기 위해서는 새로운 폴더를 삭제하고 예전의 폴더의 이름을 원래대로 변경합니다.
  • 문제가 해결되었다면 프로필에 있는 하나 이상의 파일이 손상됩니다.

Compare files to identify issues

To investigate what could have triggered the issue, you can compare your user profile with a new one, using the Compare Documents feature in LibreOffice. Focusing on the file registrymodifications.xcu, follow these steps:

1. Rename your user profile directory, for example from user to user_old
2. Launch LibreOffice so it creates a fresh user profile
3. Open the newly created user/registrymodifications.xcu
4. In Writer, go to Edit ▸ Track Changes ▸ Compare Documents... and choose the older file, user_old/registrymodifications.xcu

The differences between the two files will be highlighted (although note that much of it can be linked to document history and their thumbnails).

전문적인 정보

사용자 프로필의 위지를 찾습니다:Tools ▸ Options ▸ LibreOffice ▸ Paths.

기본 위치

아래 경로에 사용된 숫자는 해당 종류의 프로필을 만든 LibreOffice의 마지막 주요 버전을 가리킵니다. 형식은 LibreOffice 3에서 LibreOffice 4로 바뀌었습니다. 왜 LibreOffice 5와 함께 숫자가 증가하지 않았는지 궁금할 것입니다; 이것은 LibreOffice 4 이후 형식이 변하지 않았고 그 숫자를 변경하면 각 사용자의 개인 설정이 없어지기 때문입니다. 만약 LibreOffice가 그 숫자를 늘려야 한다면, 4에서 없어질 수도 있습니다. 그렇기 때문에 스크립트 작성에서 숫자에 의존하면 안됩니다.

Windows

• %APPDATA%\libreoffice\4\user LibreOffic 버전 4,5,6
• %APPDATA%\libreoffice\3\user (LibreOffice 3)

주의: 일반 Windows 설치 시, 적어도 영어 버전 Windows 에서 %APPDATA%의 주소는 "C:\Users\<사용자 이름>\AppData\Roaming"로 변환됩니다. 영어가 아닌 버전에서는 일부 다를 수 있습니다.

Thus, you can copy and paste %APPDATA%\libreoffice\4 in the File Explorer Address Bar and press ↵ Enter to access it directly. Or press ⊞ Win + r and write %appdata% and hit ↵ Enter.

GNU/Linux

• /home/<사용자 이름>/.config/libreoffice/4/user LibreOffice 버전 4,5,6
• /home/<사용자 이름>/.config/libreoffice/3/user LibreOffice 3.5.0 이후 3
• /home/<사용자 이름>/.libreoffice/3/user LibreOffice 3.5.0 이전

주의: 이것은 The Document Foundation가 배포한 LibreOffice 패키지 입니다. Linux 배포에서 제공하는 버전은 약간 다른 경로를 사용할 수 있습니다.

For flatpak, it is likely:

/home/<user name>/.var/app/org.libreoffice.LibreOffice/config/libreoffice/4/user/

Remember that the .config and .var folders are hidden folders in your /home.

macOS

• ~/Library/Application Support/LibreOffice/4/user LibreOffice 버전 4,5,6
• ~/Library/Application Support/libreoffice/3/user (LibreOffice 3)

For LibreOffice Vanilla provided by Collabora at the App Store check

• ~/Library/Containers/com.collabora.libreoffice-free (LibreOffice 5.4)

LibreOffice Portable

• LibreOfficePortable\Data\settings\user

사용자 프로필 내용

사용자 프로필에 매우 전문적인 몇몇의 폴더들이 있습니다.

• autocorr: the substitution table you can configure on Tools ▸ AutoCorrect ▸ AutoCorrect Options…
• autotext: the "AutoText" (Tools ▸ 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": 환경 설정 파일, 특히 각 모듈의 툴바. 사용자가 지정한 색상 팔레트도 이 파일에 저장되어 있습니다.
• "database": 등록한 데이터베이스
• "extensions": 등록된 확장파일
• "gallery": 개인적인 사진첩 (View ▸ 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. (see also this tutorial)

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)

Quick test for corrupted profiles: use a temporary, new user profile

While you can reset the default user profile LibreOffice uses, as described in the above sections, you can also start LibreOffice from a terminal / command line with a different, new user profile. The path to the user profile needs to be a proper URL; some special characters, like spaces, need to be UTF-8-percent-encoded.

For Linux:

soffice -env:UserInstallation=file:///tmp/test

For Windows:

soffice.com -env:UserInstallation=file:///c:/Folder%20Name%20With%20Spaces/my-test-profile

For MacOS:

open LibreOffice.app -env:UserInstallation=file:///tmp/test

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. Strange effects might occur, if you explicitly request a LibreOffice version to reuse a user profile from another version.

However, most of the content of the user profile can be safely copied from a machine to another to duplicate the same configuration. Especially custom dictionaries, color palettes, shortcuts, toolbars, extensions…