9
edits
Changes
added a section on installing with MacPorts
== Installing Introduction == This page describes how to install Gramps on Mac OS X via OSX using X11. The process uses fink or a similar program called macports to use X11 ==install the packages that gramps depends on. Gramps does work, although there are some glitches which are described below. The author of the fink guide thanks the original author from which that part of the guide was written, and for the help of people on the Gramps list for helping them work through the stumbling blocks!
== = General Caveats ===
* As stated above, these instructions were for installing 2.2.6 on Mac OS X 10.4.8, but should work more widely.
* Production of a guide like this should really only be done after repeating the installation from a clean machine, and repeating again till the guide exactly matches the actual process - doing so would take a lot of time; I the authors have each only done the installation once, so your experience will almost certainly differ from minetheirs.
* The process is not very straightforward, and there will almost certainly be problems like unresolved dependencies, files not found on the various servers, download of files just stalls indefinitely and questions asked by scripts to which you don't know the answer. Nevertheless, installation is possible and I think gramps is worth the trouble. I suggest you have a look at the instructions for [http://www.captnswing.net/2004/02/12/nicotine.html|Installing SoulSeek] - this is a similar process, but actually ''SoulSeek'' is easier because it is fully integrated into the fink process. This might give you some idea of the requirements for perseverance. If you don't think you could install ''SoulSeek'' then you certainly won't be able to install Gramps. '''The converse is not true'''
== Installing Gramps on Mac OS X via fink to use X11 ==
* You are installing from the 'unstable' fink tree, so the versions of the packages you install may vary from day to day, and there could be problems with them.
=== Installation instructions ===
==== Install X11 ====
If you have not already installed X11, install it from the Apple OS X installation disks.
====Install Developer Tools====
If you have not already installed the Developer Tools, install them from a recent Apple OS X installation disks (there may be a CD labelled XCode Tools, or an XCode folder on the install DVD). If your installation disk is not very recent, it may be better to download the tools from the [http://developer.apple.com/tools/xcode/ Apple web-site] (free registration required to access the development tools) because some of the build process will not work with an old version of the tools.
====Install and update fink====
This was much more difficult than it should have been. From reading some of the fink mailing lists, I think there may have been some problems with updates to the fink mirrors at the time.
</pre></li></ol>
====Install the Gramps dependencies====
In Terminal, successively type in the following instructions:
sudo fink install gtkspell2-dev
====Download and install Gramps====
<ol><li>[http://sourceforge.net/project/showfiles.php?group_id=25770 Download gramps] for example to <tt>'''~/Downloads'''</tt>. On the Gramps page, you need to scroll down to find a file like '''gramps-2.2.6.tar.gz'''.
INFO_ICON = gtk.STOCK_DIALOG_INFO</pre>Somewhere after <tt>'''import gtk'''</tt> in the section labelled: Constants. Then change every reference to <pre>gtk.STOCK_INFO</pre> to <pre>INFO_ICON</pre></li></ol>
====Start Gramps====
This is how Gramps has to be started each time, because there is no tool to start X11 and Gramps together. One way to get around this is to have the system launch X11 at startup, and then forget about it. This kills one of the steps and takes up little memory (I think).
# Start X11 by double clicking on the X11 icon in Applications/Utilities (or in Applications, depending on the version of Mac OS X).
== Installing gramps for X11 using MacPorts ==
Right now, I will just get the basic information down as to the troubles I ran into and how I fixed them. I will later put in more detailed instructions on using MacPorts and the rest.
=== Starting ===
So, assuming you have MacPorts installed and updated, you might as well try:
<code>
sudo port install gramps</code>
Now, if you're like me and didn't have GNOME or anything like that installed, calling that command will attempt to go through all of the dependencies and install them all. This will take a while, and you might be at this installing gramps for a couple hours (there are a lot of dependencies)
What I did instead was run <code>
port deps gramps</code>, which listed the major dependencies that gramps has. Then, I installed each separately. They are:
<code>
shared-mime-info
py-gnome
py-bsddb</code>
I installed them in the following order:
# shared-mime-info
# py-bsddb
# py-gnome (the tough one)
=== shared-mime-info ===
In order to successfully install this, I first had to run:<code>
sudo port install p5-xml-sax
sudo port install p5-xml-sax-expat</code>
After that, things installed smoothly
=== py-bsddb ===
This actually installed smoothly on my computer.
=== py-gnome ===
For now, I merely list the libraries and what I did to fix the problem.
# py-gtk2
#* I had to make sure to upgrade expat. After that, it installed fine.
# py-orbit
#* This installed without any problems for me.
# libzvt
#* This package needs "dbus" which in turn needs "xmlto". It appears, however, that "xmlto" is not listed as a dependent of "dbus". Hence, I ran <code>sudo port install xmlto</code> by hand. This installed without any problems on my computer.
#* After installing that, and upgrading gtk2 (do this first), this seems to be installing correctly.
# gnome-desktop
#* This was the next problem for me. I installed ''p5-libxml-perl, p5-xml-simple, py-xml'' by hand, cleaned ''gnome-desktop'', and then tried the installation again. Worked fine!
# gstreamer
#* This was the next problem for me. I installed ''p5-xml-libxslt, py-libxslt by hand'', cleaned gstreamer, and then tried the installation again. Worked fine!
#liboil
#* First, I ran <code>sudo port upgrade gtk-doc</code>
#* Then, I installed the newest version of the liboil library from [http://liboil.freedesktop.org/download/] and then tried to make the liboil library again. (From the manual download). This worked. I would assume it would work for the port version as well.
# nautilus
#* This was the last problem for me. To get around the error, I had to create a soft link for the ''libintl.3.dylib'' file in my /opt/local/lib/ directory.
=== Conclusion ===
Those errors were the ones I ran into. I was able to get gramps to work after that, with some of the same glitches as described below.
==Glitches ==
There are some problems, some from the fink installation.
* Help does not work (clicking Help or FAQ etc on the Help menu does nothing).