66 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			66 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
Please read the COPYING file first.
 | 
						|
If building from source, also read the INSTALL file (at least through the
 | 
						|
"SUPER-SHORT VERSION") before going further.
 | 
						|
 | 
						|
Requirements
 | 
						|
--------------------------------
 | 
						|
Python 1.5.2 or greater
 | 
						|
Gnome 1.2 or greater
 | 
						|
PyGnome 1.0.53 or greater
 | 
						|
 | 
						|
If you are using python 1.5.2, you may also need PyXML 0.6.2 or
 | 
						|
greater. Many distributions already provide this, but if your
 | 
						|
installation does not have it, you can get it from
 | 
						|
http://sourceforge.net/project/showfiles.php?group_id=6473
 | 
						|
 | 
						|
Documentation
 | 
						|
---------------------------------
 | 
						|
Gramps documentation is supplied in the form of SGML files, which will be
 | 
						|
installed in the GNOME help path(*).  Recent versions of Nautilus and Galeon
 | 
						|
can generate HTML on-the-fly documents from these.  For more information on
 | 
						|
building HTML files (including info about packages that do and do not work
 | 
						|
with the documentation) see the INSTALL file.  To generate HTML
 | 
						|
documentation the following packages *MUST* installed:
 | 
						|
* db2html >= 0.6.9  (jw >= 1.1)  to convert the SGML -> HTML
 | 
						|
* gnome-doc-tools-2-1            for the GNOME documentation style sheets
 | 
						|
The former is part of the docbook-utils package, the latter can be found
 | 
						|
from the developer section at gnome.org. (note that docbook-utils 0.6.10 is
 | 
						|
buggy)
 | 
						|
 | 
						|
One also needs png support for sgml, which should be a part of the
 | 
						|
gnome-doc-tools package. The /etc/sgml/catalog file should
 | 
						|
contain an entry pointing to PNG support. If configured properly, your
 | 
						|
db2html should automatically look up and use the /etc/sgml/catalog file.
 | 
						|
 | 
						|
Of course, current HTML documentation can also be found on the gramps website,
 | 
						|
http://gramps.sourceforge.net/help.html
 | 
						|
 | 
						|
(*) More precisely, they are installed in ${prefix}/share/gnome/help, where
 | 
						|
${prefix} is given by the --prefix= option to configure.  If this is
 | 
						|
different from where your standard GNOME installation looks for help files
 | 
						|
and documentation, then set your GNOMEDIR environment variable to the
 | 
						|
${prefix} path before starting gramps. For example, if you are installing
 | 
						|
gramps in /usr/local/, then type the following:
 | 
						|
in tcsh: setenv GNOMEDIR /usr/local/
 | 
						|
in bash: GNOMEDIR=/usr/local/ ; export GNOMEDIR
 | 
						|
 | 
						|
 | 
						|
Building on non-Linux systems: i18n support and GNU make
 | 
						|
--------------------------------------------------------
 | 
						|
 | 
						|
Linux has libintl (GNU gettext) built-in the C library. Other systems
 | 
						|
are likely to have libintl as a separate or optional library. Also,
 | 
						|
other systems may have a different make utility.
 | 
						|
 | 
						|
On those systems, like FreeBSD, you must tell configure where to find
 | 
						|
the libintl library and the libintl.h include file:
 | 
						|
 | 
						|
CPPFLAGS="-I/usr/local/include -L/usr/local/lib" ./configure --prefix=/usr/local
 | 
						|
 | 
						|
Once you have done this, if make fails, use gmake (the name FreeBSD
 | 
						|
gives to GNU make) instead.
 | 
						|
 | 
						|
--------------------------------
 | 
						|
Donald Allingham
 | 
						|
dallingham@users.sourceforge.net
 |