1
Run gramps -v from the commandline and check dependencies:
2
- From the commandline type $ gramps -v
3
- The gramps version and versions of library dependencies are output
4
- Check that all dependencies have been installed, show their versions, and that there are no error messages
5
- If required, install the dependencies that have not been found (typically icu, osmgpsmap & gexiv)
6
- Type $ gramps -v again
7
- Check that all dependencies have been installed, show their versions, and that there are no error messages
9
Open Gramps, create an empty Family Tree, and check the Gramps version, credits & license:
11
- Family Trees window opens
12
- Click "New" to create an empty Family Tree
13
- Type a name for your family tree (e.g. Sample), and press "Enter"
14
- Click "Load Family Tree"
15
- Gramps displays the "Welcome to Gramps!" start screen
16
- Choose Help > About from the menu
17
- The "About gramps" window is displayed with Version information
19
- A list of Authors and Contributors to Gramps is displayed
21
- The GNU General Public License is displayed
22
- Click on the "X" to close the "About gramps" window
23
- Gramps closes the "About gramps" window and returns to the "Welcome to Gramps!" start screen
25
Import a GEDCOM file into Gramps
26
If you do not have one to hand, the provided example can be extracted to your home directory and imported from there.
27
/usr/share/doc/gramps/example/gedcom/sample.ged.gz
28
- From your open and empty Family Tree, choose Family Trees > Import from the menu
29
- The Gramps: Import Family Tree window opens
30
- Locate your GEDCOM file, select it and click on "Import"
31
- The Import Statistics window displays "Results: done"
33
- The GEDCOM import report window displays "No errors detected"
35
- The Top Surnames gramplet displays the surnames of the people imported into the Tree
37
Test aspects of the People View
38
- Click on the People View
39
- A list of people in "Group View" mode are shown
40
- Click on the arrow for a surname (e.g. Hansdotter)
41
- The people with this surname are revealed
42
- Select a person and click in the "Edit selcted person" icon (or just double click on the person)
43
- The "Person" window opens showing the details of this person
45
- The "Person" window closes
46
- Choose the person list view (not grouped) by clicking on the "People" icon
47
- The people are now listed without any grouping by surname
48
- Click on the "+" icon to create a new person
49
- An empty "Person" window opens
50
- Enter some details about the person (e.g. given name, surname, and gender)
51
- Click on the "+" button to create a new event for this person
52
- The "Event Reference Editor" window opens
53
- Create an event (e.g. birth) by entering a date
54
- Click on the "+" button to add a new place
55
- The "New Place" window opens
56
- Type in some details about the place (Name, Type, Latitude & Longitude)
58
- The "New Place" window closes
59
- In the "Event Reference Editor" click OK
60
- In the "Person" window click OK
61
- The "Person" window closes and you can find the person just created in the list of people
63
Test aspects of the Relationships View
64
- Click on Anna Hansdotter to select her
65
- Click on the Relationships View
66
- Details of Anna and her family are displayed
67
- Click on one of her children, Hjalmar Smith
68
- Details of Hjalmar and his family are displayed
69
- Click on the "Add existing Child to family" icon just above Halmar's children
70
- The "Select Child" window opens
71
- Find the person you entered previously and select it
73
- The "Select Child" window closes and you can see the new person listed as a child in Hjalmar's family
75
Test aspects of the Charts View
76
- Click on the Charts View
77
- The Pedigree View is shown
78
- Click somewhere in the Pedigree View and drag the chart around
79
- The mouse pointer changes to a hand and the chart can be move around
80
- Click on the left and right arrows (when going left you need to choose the child to move to)
81
- The chart will move to reveal the next generation in the family
82
- Make sure there are several families in view, then Click on the "Fan Chart" icon
83
- A fan chart showing the ancesters of the main person is shown
84
- Click on the Descendant Fan icon
85
- A fan chart showing the descendants of the same person is shown
87
Test aspects of the Geography View
88
- Click on the Geography View
89
- The map may take some time to load, then a pin for the person you entered early should be shown on the map at the coordinates you entered
91
- A choice of the place, or the person will be offered
92
- Hover over the place name, and choose "Edit Place"
93
- The "Place Selection in a region" opens
94
- Double click on the place
95
- The "Place:" editor opens
98
- A choice of the place, or the person will be offered
99
- Hover over the persons name, and choose "Edit Event"
100
- The "Event:" window opens
103
Import a Gramps Xml file (*.gramps) into Gramps
104
An existing Gramps *.gramps file with links to media will be needed for this and the next test. If you do not have one to hand, the provided example can be extracted to your home directory and imported from there.
105
/usr/share/doc/gramps/example/gramps/example.gramps.gz
106
- From the "Family Trees" menu, choose "Manage Family Trees"
107
- The Family Trees window opens
108
- Click "New" to create an empty Family Tree
109
- Type a name for your family tree (e.g. Example), and press "Enter"
110
- Click "Load Family Tree"
111
- Gramps opens an empty database
112
- From your open and empty Family Tree, choose Family Trees > Import from the menu
113
- The Gramps: Import Family Tree window opens
114
- Locate your *.gramps file, select it and click on "Import"
115
- The import may take some minutes, then the Import Statistics window displays the number of objects imported.
117
- The Import Statistics window closes.
119
View Media for a person, and add new media
120
The media for the example file you may have used in the previous test can be found in /usr/share/doc/gramps/example/gramps/. Create a folder in your home directory to store Gramps media, and then copy the media there.
121
You will also need a photo to add to Gramps. Any photo will do (e.g. *.jpg file - but you can use the ones provided with Gramps).
122
You also need to set the base media patch for Gramps.
123
- In the "Edit" menu, choose "Preferences".
124
- The Preferences window opens on the "General" tab.
125
- Click the "Folder" icon to set the "Base path for relative media paths".
126
- The "Select media directory" window opens
127
- Choose the directory where your media is stored and then click "Apply"
128
- The "Select media directory" window closes
130
- The "Preferences" window closes
131
- In the "People" View, find a person with media associated (e.g. Eugene Stanley Garner, Jr. in the example database) and select him/her.
132
- Below the Detials tab, a thumbnail image of the person should appear (in the case of Eugene Stanley Garner, Jr. you should see him yawning). It may be necessary to restart Gramps to see the Thumbnail.
133
- Double click on the person's name in the People View.
134
- The "Person:" window opens, and the image is dispayed for the person in the Image square in the top left corner of the "Person:" window.
135
- Double click on the image.
136
- The Media Reference Editor opens showing details about the image.
137
- Double click in the bottom image Preview.
138
- An external viewer opens giving details of the image metadata and allowing some basic manipulation of the image.
139
- Click on the "X" to close the external viewer
140
- Click "Cancel" on the Media Reference Editor
141
- Click "Cancel" on the "Person:" window.
142
- All three windows close.
143
- Click on the "Media View".
144
- A list of available media is shown.
145
- Click on the "+" icon.
146
- The "Select a media object" window opens.
147
- Move to the folder where the media is and select the new photo (if you are using the examples provided with Gramps, I can recommend choosing O3.jpg).
149
- The "New Media" window opens.
151
- The media is added to the list of media.
152
- Select the new media.
153
- A preview (thumbnail) image is shown.
154
- Close Gramps by choosing "Quit" from the "Family Trees" menu.
157
TODO: Tagging & Filtering