Difference between revisions of "Addon:Handle.bash"

From Gramps
Jump to: navigation, search
({{Third-party plugin}})
(are the statement in this true.)
(One intermediate revision by one other user not shown)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
  
The script '''handle.bash''' ([[Media:Handle.bash.tar.gz|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.
+
The script <code>handle.bash</code> ([[Media:Handle.bash.tar.gz|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.
  
== Use procedure ==
+
== Usage ==
 +
=== Linux===
 
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
 
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
 
  $ bash handle.bash filename.gramps

Revision as of 08:35, 27 April 2020

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

Linux

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.