Difference between revisions of "Installation alternatives"

From Gramps
Jump to: navigation, search
(conversion of UseTheSource)
 
m (Get the source)
Line 12: Line 12:
 
== Get the source ==
 
== Get the source ==
  
Read [[Brief_introduction_to_SVNBriefIntroductionToSVN]], and abtain the source code of the stable branch. At the moment, this is '''gramps2''' and is downloaded to a directory ''gramps2''
+
Read [[Brief_introduction_to_SVN]], and abtain the source code of the stable branch. At the moment, this is '''gramps2''' and is downloaded to a directory ''gramps2''
  
 
== Configuration ==
 
== Configuration ==

Revision as of 23:09, 5 March 2007

These are the steps necessary to use GRAMPS from source.

Local versus Global install

GRAMPS can be installed so it is available for all users, this is called a global install. However, you can also download GRAMPS to your home directory, and run it from there, which is a local install.

Why Local?

There might be many reasons you want to run GRAMPS from source. You might have heard about a new feature you want to try that hasn't been released yet. You might be interested in adding a new feature. You might be interested in getting under the hood to take a look around. Whatever reason you are here, these are the steps necessary to run GRAMPS from source.

My advice is that you start with a good installation of a stable GRAMPS release, so you do a global install of whatever GRAMPS version your distribution packages, see Installation. The reason this is useful is that you can let your distribution worry about having all the dependencies properly installed, and it also set's up all the mime types, which must be done globally or GRAMPS will not be able to use them.

Get the source

Read Brief_introduction_to_SVN, and abtain the source code of the stable branch. At the moment, this is gramps2 and is downloaded to a directory gramps2

Configuration

Change to the "gramps2" directory:

cd gramps2

Execute the autogen script. This needs to be done the first time and any time files are added.

./autogen.sh

Run make. This needs to be done once for GRAMPS to work.

make install

Execution

You can now start GRAMPS locally, by typing on the command line:

python gramps.py

Now you can edit files and run "python gramps.py" without mucking with your official installation of GRAMPS.

Note: You should NOT do make install with the SVN version, as this will install the unstable version globally. If you want a more recent version of GRAMPS globally, download a stable release from sourceforge following the Installation instructions.