Addon:Handle.bash

From Gramps
Revision as of 00:15, 28 December 2014 by Sam888 (talk | contribs) (Use procedure)
Jump to: navigation, search
Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.


The script handle.bash (downloadable here) can be used to replace all database handles in a .gramps file. This makes it possible to work with multiple databases in Gramps, merging select branches manually at will. Without this tool, manual merging of databases derived from one another, or with a common base-database, would not be possible because of handle collision.

Usage

In order to use this script, you must create a directory and copy the script file to it. Then you export the database you wish to import into a colliding database to a .gramps file inside this directory. Then you run

$ bash handle.bash filename.gramps

where filename.gramps is the name of the file you exported into the new directory.

The script will create the files file.gramps.zcat, handle.old, handle.new and file.gramps. The file "file.gramps" is the final output, the original "filename.gramps" with all handles replaced.

This script is released under the GNU GPLv2, author: lcc.