2,186
edits
Changes
→Dictionaries
== Before installation ==
'''Mac OS X MacOS versions''' The current version of the application (3Gramps 5.3.1) should run on 0 requires Mac OS X 10.5 9 (LeopardMavericks) on both Intel and PPC computers, later. Gramps 5.1 requires at least Mac OS X 10.6 (Snow Leopard) and 10.7 (LionYosemite).
;'''Back up your databasesNew Version Notice:''' : If you're using Time Machine, that's already taken care ofare upgrading from the pre-built Gramps Application version 3.2. 3 or earlier (You do test or a build from source version) and you want to keep your Time Machine backups periodicallyold database and settings, right?) But it doesnyou't hurt ll need to have create a spare copy set aside before starting up a new version<code>Library/Application Support/gramps</code> folder with your existing data in it. If Unless you've been using changed the Gtk-OSX buildlocation in Preferences, version 3the data is in a hidden folder in your home directory called "<code>.gramps</code>".2Select a Finder window and select Go>Go to Folder from the menu.4 or later, just copy LibraryType "<code>/Users/Application Supportyourname/.gramps</grampsdbcode>" in the dialog box that opens up, and click on "Go". (Right click/option click and select Yes, substitute your userid for "Make a copyyourname" from the menu. It ) The hidden folder will be named grampsdbappear, highlighted and open. Option-drag the whole thing to <code>Library/Application Support</code> (2the one in your home folder, not the one in your boot drive's "root" directory). Slow-double-click on the new copy so that you can edit the name and delete the '.' at the beginning to unhide it.
{{man note|'''New Version NoticeMigrating to [https:''' If you are upgrading from the pre-built Gramps Application version 3//en.2wikipedia.3 or earlier (or a build from source version) and you want to keep your old database and settings, you'll need to create a Libraryorg/Application Supportwiki/gramps folder with Mac_transition_to_Apple_silicon Apple Silicon]?''|Make an XML backup of your existing data in it. Unless you've changed the location in Preferences, the data is in a hidden folder in databases on your home directory called ".gramps". Select a Finder window Intel Mac and select Go>Go copy them to Folder from the menu. Type "/Users/yourname/.gramps" in the dialog box that opens up, and click on "Go". (Yes, subsitute your userid for "yourname".) The hidden folder will appear, highlighted Apple Silicon Mac and openrestore them there after installing Gramps. Option-drag the whole thing There seems to Library/Application Support (the one be a binary object incompatibility in your home folderSQLite3 databases, not the one in your boot drive's "root" directory). Slow-double-click on the new copy so that you can edit the name and delete the '.' at the beginning to unhide iteven when running an Intel binary using Rosetta2. }}
== Installing Gramps ==
From the '''[[Download:'#Mac_OS_X]]'' Select one of [http://sourceforge.net/projects/gramps/files/Stable/ Intel] or [http://sourceforge.net/projects/gramps/files/Stable/ PPC]. You'll get a page download windowthe dmg. Once it's downloaded, you can open the dmg file (just double click on it in Finder if your browser doesn't open it automatically) and drag the Gramps application wherever you like. Once installed on your computer, it opens like any other application.
'''Links with other programs:''' Double clicking an image in the media reference editor should bring up Apple Preview, (or a similar whatever program, you've set as the default to edit that kind of image) to view the image. Clicking the view button in an internet reference should bring up the URL in the default browser. Clicking the Google Maps button in the Places display should bring up the map in the browser.
== What goes where ==
'''File structure:''' GRAMPS Gramps database and settings files can be found at the following places in the Mac file system (GRAMPS Gramps Version 3.2.5 and later):<br>* The GRAMPS Gramps database with the user's genealogical information is stored under <code>/Users/<username>/Library/Application Support/gramps/grampsdb.<br/code>* Setting files (ini-files) are found here: <code>/Users/<username>/Library/Application Support/gramps/gramps32gramps51<br/code>* Start-up settings for GRAMPS Gramps (for e. g. the environment variable LANG) can be accessed through Gramps.app (generally in /Applications): Right click on "Gramps.app", select "Show Package Content" from the menu, the start-up settings are found in the file <code>Contents/MacOS/Gramps</code>.
== Advanced setup ==
To remove the special settings
defaults delete -app Gramps AppleLanguages (or AppleLocale or AppleCollation).
Note that you will need to run Gramps at least once before the defaults system will recognize its existence; before that trying to use defaults will produce an error about there being no Gramps application.
[[Howto:Change the language of reports]] has more information on language features in Gramps. When reading it, remember that AppleLanguages (which corresponds to the language list on the Languages & Text system preference pane) sets the LANGUAGE environment variable and AppleLocale (Formats in the Languages & Test pane) sets the LANG variable.
== Bugs ==
=== If something seems to go wrong ===
You'll find error messages in the console log, which you can view with <code>/Applications/Utilities/Console.app</code>
All of the known bugs in 3.1.2 previous version have been corrected in 3.2.4 Gramps {{Version_Mac}} and later. There will no doubt be new ones; report them in the usual way on [httphttps://www.gramps-project.org/bugs/my_view_page.php Mantis] ([[Using the bug tracker]] instructions). When reporting what you're sure is an OSX specific bug, please set the Platform field to "mac" (no quotes, caps, or spaces!) so that I can find it easily. The Previous Gramps version 3.12.2 4, bugs are described at [[Mac OS X:Build from source:gtk-osx:bugs]].
== Updates ==