e584704e7b
So this was a lot of work... Updated to use lxml, steep learning curve for someone who never examined XML before... The merge test code needed some updates because it was last used with an older version of the Gramps XML. Found another bug in the mergefamilyquery code when test started running; another nonetype issue. Found another bug in the mergepersonquery code when test started running; another nonetype issue. Couldn't get the subprocess stuff to work right, so changed code to just call Gramps with capture, similar to export_tests. This in turn required that importxml and exportxml be slightly changed to support StringIO redirection of stdin and stdout. And test_util needed a change to allow stdout to accept an unencoded stream, so I added an option to use BytesIO for this test as well. Added some code to save input, result, and expected data to files in Gramps temp directory for debugging whenever an error occurred. Easier to use my editor in diff mode than look at the outputs.
The Gramps Project ( https://gramps-project.org ) 
We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists.
Please read the COPYING file first.
Please read the INSTALL file if you intend to build from source.
Requirements
The following packages MUST be installed in order for Gramps to work:
- Python 3.2 or greater - The programming language used by Gramps. https://www.python.org/
- GTK 3.10 or greater - A cross-platform widget toolkit for creating graphical user interfaces. http://www.gtk.org/
- pygobject 3.12 or greater - Python Bindings for GLib/GObject/GIO/GTK+ https://wiki.gnome.org/Projects/PyGObject
The following three packages with GObject Introspection bindings (the gi packages)
-
cairo - a 2D graphics library with support for multiple output devices. http://cairographics.org/
-
pango - a library for laying out and rendering of text, with an emphasis on internationalization. http://www.pango.org/
-
pangocairo - Allows you to use Pango with Cairo http://www.pango.org/
-
librsvg2 - (SVG icon view) a library to render SVG files using cairo. http://live.gnome.org/LibRsvg
-
xdg-utils - Desktop integration utilities from freedesktop.org
-
bsddb3 - Python bindings for Oracle Berkeley DB https://pypi.python.org/pypi/bsddb3/
The following package is needed for full translation of the interface to your language:
- language-pack-gnome-xx
Translation of GTK elements to your language, with xx your language code; e.g. for Dutch you need language-pack-gnome-nl. The translation of the Gramps strings is included with the gramps source.
The following packages are STRONGLY RECOMMENDED to be installed:
- osmgpsmap
Used to show maps in the geography view. It may be osmgpsmap, osm-gps-map, or python-osmgpsmap, but the Python bindings for this must also be present. Without this the GeoView will not be active, see https://gramps-project.org/wiki/index.php?title=Gramps_4.2_Wiki_Manual_-_Categories#Geography_Category
-
Graphviz
Enable creation of graphs using Graphviz engine. Without this, three reports cannot be run. Obtain it from: http://www.graphviz.org
-
PyICU
Improves localised sorting in Gramps. In particular, this applies to sorting in the various views and in the Narrative Web output. It is particularly helpful for non-Latin characters, for non-English locales and on MS Windows and Mac OS X platforms. If it is not available, sorting is done through built-in libraries. PyICU is fairly widely available through the package managers of distributions. See http://pyicu.osafoundation.org/ (These are Python bindings for the ICU package. https://pypi.python.org/pypi/PyICU/)
The following packages are optional:
- gtkspell
Enable spell checking in the notes. Gtkspell depends on enchant. A version of gtkspell with gobject introspection is needed, so minimally version 3.0.0
- rcs
The GNU Revision Control System (RCS) can be used to manage multiple revisions of your family trees. See info at https://gramps-project.org/wiki/index.php?title=Gramps_4.2_Wiki_Manual_-_Manage_Family_Trees#Archiving_a_Family_Tree Only rcs is needed, NO python bindings are required
- PIL
Python Image Library is needed to crop images and also to convert non-JPG images to JPG so as to include them in LaTeX output. (For Python3 a different source may be needed, python-imaging or python-pillow or python3-pillow)
- GExiv2
Enables Gramps to manage Exif metadata embedded in your media. Gramps needs version 0.5 or greater. See https://www.gramps-project.org/wiki/index.php?title=GEPS_029:_GTK3-GObject_introspection_Conversion#GExiv2_for_Image_metadata
- ttf-freefont
More font support in the reports
Optional packages required by Third-party Addons
Third-party Addons are written by users and developers and unless stated are not officially part of Gramps. For more information about Addons see: https://gramps-project.org/wiki/index.php?title=Third-party_Plugins
Prerequistes required for the following Addons to work:
-
Family Sheet - Requires: PIL (Python Imaging Library) or PILLOW. ( https://gramps-project.org/wiki/index.php?title=Family_Sheet )
-
Graph View - Requires: PyGoocanvas and Goocanvas. ( https://gramps-project.org/wiki/index.php?title=Graph_View )
-
PedigreeChart - Can optionally use - numpy if installed ( https://gramps-project.org/wiki/index.php?title=PedigreeChart )
No longer needed:
-
Since Gramps 4.2: gir-webkit
-
Since Gramps 4.0: pygoocanvas, pygtk, pyexiv2
-
Since Gramps 3.3: python-enchant Enchant
-
Since Gramps 3.2: python glade bindings
-
Since Gramps 3.1: yelp - Gnome help browser. No offline help is shipped see Gramps website for User manual
Documentation
The User Manual is maintained on the Gramps website: