14
edits
Changes
From Gramps
Simplify how username is discussed and referred to. Consolidate some duplication in the first section.
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix provides the reference for finding documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. The That directory, or folder/directory , is stored at different locations due to the requirements of Gramps forks for various operating systems or special purposes.
__TOC__
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:
/HOMEhome/'''''<code>username</code>'''''/.gramps
which can also be entered as
This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris], [https://wikipedia.org/wiki/Unix Unix] and [https://wikipedia.org/wiki/Mac_OS_X Mac OS-X] when using [[Build_from_source#Mac_OS_X|Mac OS X Build from source]].
Alternately, you can leverage use a tilde or the '''$HOME''' [http://www.linfo.org/home_directory.html Home directory equivalent'''$HOME''' environment variable] to avoid dealing referring to the complications of active user namesusername. Although Gramps will not recognize directory equivalents for a tilde or environment variables in paths internally, you can use them within Linux to find Gramps user files. The '''Gramps user directory''' path above is can be simplified to either:
~/.gramps
or
=== macOS ===
====macOS Application Package====
The [[Mac OS X:Application package]] uses a different, more macOS-standard default location for the directory:
/Users/'''''<~code>username</code>'''''/Library/Application Support/gramps
== MS Windows ==
The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is
C:\Users\'''''%<code>username%'''''</code>\AppData\Local\gramps The '''''%username%''''' in the above filepath is a placeholder for the particular user name chosen when logging into Windows.
Alternately, you can leverage use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid dealing referring to the complications of active user namesusername. (We've chosen to use the username Environment Variable environment variable in the documentation for Windows rather than '''''<~username>''''' used for documenting other OSes.) Although Gramps will not recognize Environment Variables environment variables for paths internally, you can use them within Windows to find Gramps user files. The '''Gramps user directory''' path above is can be simplified to:
%LocalAppData%\gramps
{{man note|User Directory relocated {{new|5.2.0}}|'''The User Directory has relocated in version 5.2'''<br />The default '''User Directory''' location for the 5.2 version of Gramps user data on a Windows 7 (and newer) system is: <br /> <code> C:\Users\'''''%username%'''''\AppData\Local\gramps</code><br /> <code> %LocalAppData%\gramps</code><br />The default '''User Directory''' location for any 5.1.x and earlier version of Gramps user data on a Windows 7 (and newer) system is: <br /> <code> C:\Users\'''''%username%'''''\AppData\Roaming\gramps</code><br /> <code> %AppData%\gramps</code>}}
