Mac OS X:Application package - Revision history

Kulath: location of plist

2013-01-10T17:14:58Z

location of plist

Kulath: Reading defaults

2013-01-10T17:12:05Z

Reading defaults

Romjerome: /* Before installation */

2012-08-25T06:38:09Z

‎Before installation

Kulath: /* Advanced setup */

2012-05-05T22:25:56Z

‎Advanced setup

Kulath: Update names in the preference pane (for Leopard at least!)

2012-04-07T00:00:24Z

Update names in the preference pane (for Leopard at least!)

Romjerome at 17:42, 1 April 2012

2012-04-01T17:42:42Z

Romjerome at 17:41, 1 April 2012

2012-04-01T17:41:39Z

Kulath: Restructure to clarify before during and after installation

2012-03-15T23:05:39Z

Restructure to clarify before during and after installation

Kulath at 12:59, 24 February 2012

2012-02-24T12:59:38Z

Kulath: Structure the Mac OS pages

2012-02-24T11:57:45Z

Structure the Mac OS pages

@@ Line 47: / Line 47: @@
     defaults read  org.gramps-project.gramps
-The settings are stored in ~/Library/Preferences/org.gramps-project.gramps
+The settings are stored in ~/Library/Preferences/org.gramps-project.gramps.plist
 To remove the special settings

@@ Line 41: / Line 41: @@
     defaults write -app Gramps AppleCollationOrder "de"
 AppleLanguages corresponds to the language list, AppleLocale to the Format country/Region, and AppleCollationOrder selects the way that lists are sorted. You need not set them all.
 To remove the special settings

@@ Line 3: / Line 3: @@
 == Before installation ==
-'''Mac OS X versions''' The current version of the application (3.3.1) should run on Mac OS X 10.5 (Leopard) on both Intel and PPC computers, Mac OS X 10.6 (Snow Leopard) and 10.7 (Lion).
+'''Mac OS X versions''' The current version of the application ({{Version_Mac}}) should run on Mac OS X 10.5 (Leopard) on both Intel and PPC computers, Mac OS X 10.6 (Snow Leopard) and 10.7 (Lion).
-The pre-built Gramps application doesn't work on earlier versions of Mac OS X, because it needs WebKitGtk, and that doesn't work on earlier operating systems. Versions of Gramps before 3.3.1 didn't work on Lion, except for a special beta package provided as an interim measure. All Lion users should upgrade to 3.3.1 as soon as practical.
+The pre-built Gramps application doesn't work on earlier versions of Mac OS X, because it needs WebKitGtk, and that doesn't work on earlier operating systems. Versions of Gramps before 3.3.1 didn't work on Lion, except for a special beta package provided as an interim measure. All Lion users should upgrade to {{Version_Mac}} as soon as practical.
 '''Back up your databases:''' If you're using Time Machine, that's already taken care of. (You do test your Time Machine backups periodically, right?) But it doesn't hurt to have a spare copy set aside before starting up a new version. If you've been using the Gtk-OSX build, version 3.2.4 or later, just copy Library/Application Support/gramps/grampsdb. (Right click/option click and select "Make a copy" from the menu. It will be named grampsdb(2).
 '''New Version Notice:''' If you are upgrading from the pre-built Gramps Application version 3.2.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 Library/Application Support/gramps folder with your existing data in it. Unless you've changed the location in Preferences, the data is in a hidden folder in your home directory called ".gramps". Select a Finder window and select Go>Go 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 and open. Option-drag the whole thing to Library/Application Support (the 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.
 == Installing Gramps ==

@@ Line 31: / Line 31: @@
 Usually, the default settings will be correct, but occasionally you may need to set things up differently.
-'''Language:''' Normally, GRAMPS sets up languages and formats from system preferences (Language and Text on Snow Leopard and Lion; International on Leopard). There are three main settings: On the first pane (Language(s)) is a list of languages. GRAMPS will go down the list and select the first one for which it has a translation to select the language in which all menus, labels, and messages are presented. On the right side of that pane at the bottom is an "Order for sorted lists" listbox which sets the way that lists are alphabetically sorted. Finally, in the third pane (second pane in Leopard) (Formats) one can select a country/Region which determines things like month and day names, whether a comma, dot, or space is used to separate thousands or decimal fractions, and so on.
+'''Language:''' Normally, GRAMPS sets up languages and formats from system preferences (Language and Text on Snow Leopard and Lion; International on Leopard). There are three main settings:
 If you want to run GRAMPS with different language or locale settings than you use for your system settings, you can use the "defaults" program from Terminal.app (Applications:Utilities:Terminal.app):

@@ Line 31: / Line 31: @@
 Usually, the default settings will be correct, but occasionally you may need to set things up differently.
-'''Language:''' Normally, GRAMPS sets up languages and formats from system preferences (Language and Text on Snow Leopard and Lion; Internationalization on Leopard). There are three main settings: On the first pane (Languages) is a list of languages. GRAMPS will go down the list and select the first one for which it has a translation to select the language in which all menus, labels, and messages are presented. On the right side of that pane at the bottom is an "Order for Sorted Lists" listbox which sets the way that lists are alphabetically sorted. Finally, in the third pane (Formats) one can select a country which determines things like month and day names, whether a comma, dot, or space is used to separate thousands or decimal fractions, and so on.
+'''Language:''' Normally, GRAMPS sets up languages and formats from system preferences (Language and Text on Snow Leopard and Lion; International on Leopard). There are three main settings: On the first pane (Language(s)) is a list of languages. GRAMPS will go down the list and select the first one for which it has a translation to select the language in which all menus, labels, and messages are presented. On the right side of that pane at the bottom is an "Order for sorted lists" listbox which sets the way that lists are alphabetically sorted. Finally, in the third pane (second pane in Leopard) (Formats) one can select a country/Region which determines things like month and day names, whether a comma, dot, or space is used to separate thousands or decimal fractions, and so on.
 If you want to run GRAMPS with different language or locale settings than you use for your system settings, you can use the "defaults" program from Terminal.app (Applications:Utilities:Terminal.app):
@@ Line 37: / Line 37: @@
     defaults write -app Gramps AppleLocale "de_DE"
     defaults write -app Gramps AppleCollationOrder "de"
-AppleLanguages corresponds to the language list, AppleLocale to the Format country, and AppleCollationOrder selects the way that lists are sorted. You need not set them all.
+AppleLanguages corresponds to the language list, AppleLocale to the Format country/Region, and AppleCollationOrder selects the way that lists are sorted. You need not set them all.
 To remove the special settings

← Older revision		Revision as of 17:42, 1 April 2012
Line 60:		Line 60:

	[[Category:Developers/Packaging]]		[[Category:Developers/Packaging]]
		+	[[Category:Documentation]]

← Older revision		Revision as of 17:41, 1 April 2012
Line 58:		Line 58:

	GRAMPS stores all its internal data in ~/Library/Application Support. So, to upgrade a Gramps application bundle to a newer version, just throw the old application in the Trash. Make a backup copy of your data, just in case, then download the new version of the application and just use it. If you don't like the new version and want the old one back, throw the new version in the Trash and fetch the old one back from the Trash. The Gramps version is shown in Finder if you use column view; otherwise right click on it and select Get Info.		GRAMPS stores all its internal data in ~/Library/Application Support. So, to upgrade a Gramps application bundle to a newer version, just throw the old application in the Trash. Make a backup copy of your data, just in case, then download the new version of the application and just use it. If you don't like the new version and want the old one back, throw the new version in the Trash and fetch the old one back from the Trash. The Gramps version is shown in Finder if you use column view; otherwise right click on it and select Get Info.
		+
		+	[[Category:Developers/Packaging]]

@@ Line 1: / Line 1: @@
-The GTK-OSX port of GRAMPS for Mac is a single, stand-alone bundle which uses the native quartz windowing system instead of X11.
+This page describes the installation of the ready-to-run Gramps application for Mac OS X. This is also known as the GTK-OSX port of GRAMPS for Mac. It is a single, stand-alone bundle which uses the native quartz windowing system of Mac OS X instead of X11.
-Mac GRAMPS is available for both Intel and PPC Macs.  OS X 10.5 (Leopard) is presently required; WebKitGtk doesn't presently work on earlier versions. The [[Download]] page carries both Intel and PPC binary applications that should work as soon as it is downloaded.
+== Before installation ==
-=== OSX 10.7 Lion ===
+'''Mac OS X versions''' The current version of the application (3.3.1) should run on Mac OS X 10.5 (Leopard) on both Intel and PPC computers, Mac OS X 10.6 (Snow Leopard) and 10.7 (Lion).
-Gramps 3.3.1 runs correctly on Lion. Earlier versions do not, except for a special beta package provided as an interim measure. All Lion users should upgrade to 3.3.1 as soon as pracical.
+The pre-built Gramps application doesn't work on earlier versions of Mac OS X, because it needs WebKitGtk, and that doesn't work on earlier operating systems. Versions of Gramps before 3.3.1 didn't work on Lion, except for a special beta package provided as an interim measure. All Lion users should upgrade to 3.3.1 as soon as practical.
-== How to Download and run the binary GRAMPS application for Mac ==
+'''Back up your databases:''' If you're using Time Machine, that's already taken care of. (You do test your Time Machine backups periodically, right?) But it doesn't hurt to have a spare copy set aside before starting up a new version. If you've been using the Gtk-OSX build, version 3.2.4 or later, just copy Library/Application Support/gramps/grampsdb. (Right click/option click and select "Make a copy" from the menu. It will be named grampsdb(2).
 '''File structure:''' GRAMPS database and settings files can be found at the following places in the Mac file system (GRAMPS Version 3.2.5 and later):<br>
@@ Line 14: / Line 27: @@
 * Start-up settings for 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 Contents/MacOS/Gramps.
-'''Download:''' Select one of [http://sourceforge.net/projects/gramps/files/Stable/ Intel] or
+== Advanced setup ==
-[http://sourceforge.net/projects/gramps/files/Stable/ PPC]. You'll get a download window. Once it's downloaded, you can open the dmg (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.
-'''Back up your databases:''' If you're using Time Machine, that's already taken care of. (You do test your Time Machine backups periodically, right?) But it doesn't hurt to have a spare copy set aside before starting up a new version. If you've been using the Gtk-OSX build, version 3.2.4 or later, just copy Library/Application Support/gramps/grampsdb. (Right click/option click and select "Make a copy" from the menu. It will be named grampsdb(2).
+Usually, the default settings will be correct, but occasionally you may need to set things up differently.
-−
-'''New Version Notice:''' The new (3.2.4 and later) builds will default to using your Library/Application Support/gramps folder, which, if you want to keep your old database and settings, you'll need to create. Unless you've changed the location in Preferences, they're in a hidden folder in your home directory called ".gramps". Select a Finder window and select Go>Go 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 and open. Option-drag the whole thing to Library/Application Support (the 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.
 '''Language:''' Normally, GRAMPS sets up languages and formats from system preferences (Language and Text on Snow Leopard and Lion; Internationalization on Leopard). There are three main settings: On the first pane (Languages) is a list of languages. GRAMPS will go down the list and select the first one for which it has a translation to select the language in which all menus, labels, and messages are presented. On the right side of that pane at the bottom is an "Order for Sorted Lists" listbox which sets the way that lists are alphabetically sorted. Finally, in the third pane (Formats) one can select a country which determines things like month and day names, whether a comma, dot, or space is used to separate thousands or decimal fractions, and so on.
@@ Line 32: / Line 42: @@
     defaults delete -app Gramps AppleLanguages (or AppleLocale or AppleCollation).
-[[Howto:Change the language of reports]] has more information on language features in Gramps. When reading it, remember that AppleLanugages (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.
+[[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.
-−
-'''Links with other programs:''' Double clicking an image in the media reference editor should bring up Apple Preview, or a similar program, 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.
-−
-GRAMPS doesn't use the X11 Mac package. It's useful to install [http://www.documentfoundation.org/download/ LibreOffice], [http://www.calligra-suite.org/ Calligra] (or [http://www.neooffice.org/ NeoOffice], a more mac-friendly version) to work on your reports after saving them from Gramps.
 '''Dictionaries:''' The spelling checker uses  MySpell dictionaries -- the same ones that [http://www.documentfoundation.org/download/ LibreOffice] and NeoOffice use. Unfortunately, they bury them in their application bundles, so you can download them [http://wiki.services.openoffice.org/wiki/Dictionaries here]. You need to install them in /Library/Dictionaries, and you'll need to authenticate as an administrator to do so. If you have one of them installed and know how to make symbolic links from the command line, you'll find them in Contents/share/uno_packages/cache/uno_packages, scattered about in the hash-named directories. You'll need to link both the aff and dic files (e.g., en_US.aff and en_US.dic).
 === If something seems to go wrong ===
 You'll find error messages in the console log, which you can view with /Applications/Utilities/Console.app
 All of the known bugs in 3.1.2 have been corrected in 3.2.4 and later. There will no doubt be new ones; report them in the usual way on [http://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 3.1.2 bugs are described at [[Mac OS X:Build from source:gtk-osx:bugs]].
-==Updates==
+== Updates ==
 GRAMPS stores all its internal data in ~/Library/Application Support. So, to upgrade a Gramps application bundle to a newer version, just throw the old application in the Trash. Make a backup copy of your data, just in case, then download the new version of the application and just use it.  If you don't like the new version and want the old one back, throw the new version in the Trash and fetch the old one back from the Trash. The Gramps version is shown in Finder if you use column view; otherwise right click on it and select Get Info.