Difference between revisions of "Addon:Handle.bash"
m |
|||
| (8 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{Third-party addon}} | |
| − | == | + | The script <code>handle.bash</code> ([[Media:Handle.bash.tar.gz|downloadable here]]) can be used to replace all database handles in a <code>.gramps</code> 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. |
| − | In order to use this script, you must create a directory and copy the script file to it. | + | |
| + | == Usage == | ||
| + | === Linux=== | ||
| + | In order to use this script, you must: | ||
| + | * create a directory and copy the <code>handle.bash</code> script file to it. | ||
| + | * In Gramps export the database you wish to import into a colliding database to a <code>.gramps</code> file | ||
| + | ** Copy that <code>.gramps</code> file inside this directory. | ||
| + | * Then you run | ||
$ bash handle.bash filename.gramps | $ bash handle.bash filename.gramps | ||
| − | where filename.gramps is the name of the file you exported into the new directory. | + | where <code>filename.gramps</code> 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 | ||
| + | * file.gramps | ||
| − | + | The file <code>file.gramps</code> is the final output, of the original <code>filename.gramps</code> with all handles replaced. | |
| − | This script is released under the GNU GPLv2, author: lcc. | + | This script is released under the GNU GPLv2, author: [[User:Lcc|lcc]]. |
| + | [[Category:Addons]] | ||
[[Category:Plugins]] | [[Category:Plugins]] | ||
[[Category:Developers/General]] | [[Category:Developers/General]] | ||
| + | [[Category:Tools]] | ||
Latest revision as of 04:15, 25 September 2025
|
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager. Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker. |
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
handle.bashscript file to it. - In Gramps export the database you wish to import into a colliding database to a
.grampsfile- Copy that
.grampsfile inside this directory.
- Copy that
- 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
- file.gramps
The file file.gramps is the final output, of the original filename.gramps with all handles replaced.
This script is released under the GNU GPLv2, author: lcc.
