16,602
edits
Changes
→warning : privacy filters
{{man index|Gramps 3.0 Wiki Manual - Main Window|Gramps 3.0 Wiki Manual - Entering and Editing Data: Brief|3.0}} {{languages|Gramps_3.0_Wiki_Manual_-_Manage_Family_Trees}}
== Starting a New Family Tree ==
[[Image:Dbmanager01.png|right|thumb|250px|Fig. 3.1. Starting Family Trees ]]
To start a new Family Tree, choose ''' Family Trees ->Manage Family Trees ''' or select the {{man button|Family Trees}} button from the toolbar. This will open the Family Tree Manager.
Select the {{man button|New}} button and GRAMPS will add a new Family Tree entry to the list of Family Trees. To change its name from the default ''Family Tree 1'', click on the name and type in a new name.
Now select {{man button|Load Family Tree}} to open the new, empty Family Tree.
== Opening a Family Tree ==
If you do not have "write permissions" for the selected Family Tree, it will be opened in a Read Only mode. In this mode, the data may be viewed, but no changes will be made to the Tree. To indicate this mode, the title of the main window will be appended with '''(Read Only)''' text.
== Opening a GEDCOM or XML database ==
GRAMPS allows you to open certain databases that have not been saved in GRAMPS' own file format from the command line. '''TODO link to page explaining how.''' These include XML and GEDCOM databases. But you should be aware that if the XML or GEDCOM database is relatively large, you will encounter performance problems, and in the event of a crash your data can be corrupted. Hence, it is best normally better to always create a new family tree by creating a new GRAMPS family tree (database) and importing import your XML/GEDCOM data into it.
{{man note| Opening databases |XML and GEDCOM databases require all data to be held in memory and don't contain indexes. GRAMPS' native format is a database that only reads the data needed. Thus, for a large family tree the data can be accessed quicker and more efficiently by not using XML or GEDCOM.}}
In either case, you just type in the new name to have it take effect.
== Backing up a Family Tree ==
The safest way to backup your GRAMPS Family Tree is to export to '''GRAMPS XML''' format (or '''GRAMPS Package''' to include items from your Gallery) and copy the resultant file to a safe place, preferably in a different building.
You can use the Archive feature to store snapshots of your tree. These snapshots can be used as simple backups, very useful if you want to try something that you might later want to undo. However this method should not be used for standard backups, as it will not survive a hard disk crash or most of the other disasters that can befall a computer.
''For advanced users:'' each database is stored in its own subdirectory under ~/.gramps. A manual backup can be made by backing up this directory.
== Archiving a Family Tree ==
You can easily archive and timestamp family trees with GRAMPS built-in use of [http://www.gnu.org/software/rcs/ GNU Revision Control System] or ''RCS''. For this to be possible this utility must be installed on your computer.
To make an archive, first make sure the tree you wish to archive is open. Then select the open family tree, and click the {{man button|Archive}} button. The archive will be listed under the tree from which it was created. Archives can be deleted and renamed.
== Restoring a Family Tree Archive ==
[[Image:Dbmanager04.png|thumb|left|200px|Fig. 3.2 Selecting a version to restore]]
Simply highlight the archive you want to restore, and select the {{man button|Restore}} button.
[[Image:Dbmanager05.png|thumb|right|200px|Fig. 3.3 Restored version]]
GRAMPS will transfer the archive into a new Family Tree. The Family Tree name is based on the original name and the archive name.
== Unlocking a Family Tree ==
If you could open the same Family Tree in two GRAMPS at once, it is likely your data would be damaged.
In the unlikely event of a crash of GRAMPS, the family tree will be left in a locked state. To unlock the tree, select the locked family tree, and click the {{man button|Unlock}} button that will be available. Only do this if you are sure no other copy of GRAMPS is using this family tree. == Repairing a Damaged Family Tree ==[[Image:Dbmanager07.png|thumb|right|250px|Fig. 3.4 Repairing a Family Tree]]
To tell GRAMPS will transfer to attempt to repair the damage, select the archive into a new Family Tree. The Family Tree name is based on the original name and then click the archive name{{man button|Repair}} button.
== Saving Changes to Your Family Tree ==
You can undo changes you've made by selecting ''' Edit ->Undo '''. If you select this command repeatedly, your most recent changes will be undone one at a time. To roll back multiple commands at a time, you can using the {{man label|Undo History}} dialog available from the {{man label|Edit}} menu.
If you want to return your Family Tree to the way it was when you opened it, select ''' File Family Trees ->Abandon changes and quit ''' . (This is just like quitting without saving in other programs.)
If you would like to save a copy of your Family Tree under a different name, you will need to export it and then import it into a new Family Tree. The ''GRAMPS XML database'' format is recommended for this purpose.
Importing allows you to bring data from other genealogy programs into a GRAMPS database. Currently, GRAMPS can import data from the following formats:
GRAMPS V2.x database (having the ''.grdb'' file extension), GEDCOM (.ged file extension)
GRAMPS XMLpackage (.gpkg file extension)
{{man note| Importing vs. opening |Please recognize that importing a database is different from opening a database. When you import, you are actually bringing data from one database into a GRAMPS database. When you open a file, you are editing your original file.}}
To import data, select ''' File Family Trees ->Import ''' . The '''Import database''' dialog will open, asking you to specify the file you wish to import.Note that you can only import data into an existing database so if you are transferring all your data from another program or from an olderversion of GRAMPS, then first create a new empty database and then import the data into it.
{{man warn| Data loss with some formats |It is important to note that the importing process is not perfect for GEDCOM and GeneWeb databases. There is a chance that some of the data in these databases will not be imported into GRAMPS.}}
If you import information from another GRAMPS database or GRAMPS XML database, you will see the progress of the operation in the progress bar of GRAMPS' main window.
The GRAMPS CSV Spreadsheet format allows importing and exporting of a subset of your GRAMPS data in a simple spreadsheet format. See [[Gramps 3.0 Wiki Manual - Manage Family Trees: CSV Import and Export|CSV Import and Export]] for more information.
== Exporting Data ==
[[Image:Export-druid.png|right|thumb|200px|Fig.3.4 Export assistant: format selection]]
'''Wait to update manual:''' The exporter is undergoing a major rewrite.
Exporting allows you to share any portion of your GRAMPS database with other researchers as well as to enable you to transfer your data to another computer. Currently, GRAMPS can export data to the following formats: GRAMPS database (grdb), GRAMPS XML, GEDCOM, GRAMPS package, Web Family Tree, GeneWeb, and GeneWebGRAMPS CSV Spreadsheet formats.
{{man note| Export is saving a copy |When you export, you are saving a copy of the currently opened database. Exporting creates another file with a copy of your data. Note that the database that remains opened in your GRAMPS window is NOT the file saved by your export. Additional editing of the currently opened database will not alter the copy produced by the export.}}
To export data, choose ''' File Family Trees ->Export ''' . This will bring up the '''Export''' assistant. Its pages will guide you through the format selection (see ''export-druid-figFig. 3.4'' ), file selection, and format specific export options (see ''gedcom-export-fig'' ). After a final confirmation page, the export will be performed according to the choices you have made. At any time, you can click the {{man button|Back}} button and revise any selection, and then go forward to redo the export.
=== Export into GRAMPS formats === {{man warn|Privacy Filters |It is important to verify your privacy options on Exporter. Do not enable filters or privacy options for GRAMPS XML backups.}} *GRAMPS XML database export (.gramps): This format is the standard format for data-exchange and backups (see the related .gpkg format below for full portability including media objects). Exporting into GRAMPS XML format will produce a portable database. As XML is a text-based human-readable format, you may also use it to take a look at your data. This format is compatible with the previous versions of GRAMPS. *GRAMPS package export (.gpkg): Exporting to the GEDCOM GRAMPS package format ===will create a compressed file that contains the GRAMPS XML database and copies of all associated media files. This is useful if you want to move your database to another computer or to share it with someone. *Export to CD: Exporting to CD will prepare your database and copies of all media object files for recording onto a CD. To actually burn the CD, you will need to go to the GNOME '''burn:///''' location, which can be accessed by navigating through Nautilus: After exporting to CD, select ''' Go ->CD Creator ''' in the Nautilus menu. Your database directory will show up. To burn it to the CD, click the CD icon on the Nautilus toolbar, or select ''' File ->Write to CD ''' in the Nautilus menu.
*Filter: The filter allows you to export a limited amount of data, based on the criteria you select.
*Target: While GEDCOM is a standard, not every program implements it in the same way. This can lead to data loss. GRAMPS can reduce the data loss in some cases. You can tell GRAMPS what program is the target, and GRAMPS will customize the exported file for that program. If your program is not listed, choose the "GEDCOM 5.5 Standard".
*Do not include records marked private: Check this box to prevent private records from being included in the exported file.
This option allows specify where your image files are located. This is useful when you are transferring your GEDCOM file from one computer to another. It tells the program that is importing the data where your images are.
*GRAMPS database (grdb) exportGeneWeb: Exporting to the GRAMPS native format GeneWeb will simply make save a copy of your data under another nameinto a popular web genealogy format. Exporting to this To find out more about GeneWeb and its format can also be useful if you have directly opened an XML or GEDCOM file and would like to save it as the grdb file, visit http://cristal.inria.fr/~ddr/GeneWeb/en/.
*GRAMPS XML database export: Exporting into GRAMPS XML format will produce a database compatible with the previous versions of GRAMPS. As XML is a text-based human-readable format, you may also use it to take a look at your data. *GRAMPS package exportvCalendar and vCard: Exporting to the GRAMPS package format will create a compressed file that contains the database and copies of all associated media files. This is useful if you want to move your database to another computer vCalendar or to share it with someone. *Export to CD: Exporting to CD vCard will prepare your database and copies of all media object files for recording onto save information in a CD. To actually burn the CD, you will need to go to the GNOME '''burn:///''' location, which can be accessed by navigating through Nautilus: After exporting to CD, select ''' Go ->CD Creator ''' format used in the Nautilus menu. Your database directory will show up. To burn it to the CDmany calendaring and addressbook applications, click the CD icon on the Nautilus toolbar, or select ''' File ->Write to CD ''' in the Nautilus menusometimes called PIM for Personal Information Manager.
=== Export into other formats =Moving 2.2 databases to Gramps 3 ==
*GeneWebImport 2.2 grdb file: Exporting to GeneWeb will save In a copy of Gramps 2.2 database, your data into is stored in a popular web genealogy formatgrdb file along with one or more log files that are kept in directories found in the .gramps/env directory. To find out more about GeneWeb import your 2.2 data directly into Gramps 3, create a new database and its format, visit http:select the option to import a Gramps 2.2 database. You need to make sure that you are running Gramps 3 from the same user you used to run Gramps 2.2 so that it has access to the same .gramps//cristalenv directory containing the log files that supplement your database.inriaIf you are running Gramps 3 from a different user or on another machine you need to make provisions to make the same .frgramps/~ddrenv directory and log files available. If you get an error saying "/GeneWeb/entmp/tmpDkI5pO could not be opened" or something similar when attempt to import your database then it means that Gramps 3 cannot see all of the files that constitute your database.
*vCalendar Gramps XML: With this approach firstly start up Gramps 2.2 and vCard: Exporting export your database to vCalendar or vCard will save information the Gramps XML format. The XML file is actually compressed and contained in a format used in many calendaring .gramps file. This file is portable, has no other dependent files and addressbook applicationscan be moved to wherever you have Gramps 3 installed. Next, sometimes called PIM for Personal Information start Gramps 3 and create an empty database using the Family Tree Managerand import the .gramps file.
{{languages|Gramps_3.0_Wiki_Manual_-_Manage_Family_Trees}}
{{man index|Gramps 3.0 Wiki Manual - Main Window|Gramps 3.0 Wiki Manual - Entering and Editing Data: Brief|3.0}}
[[Category:Documentation]]
