~rosco2/ubuntu/wily/gramps/bug-1492304

« back to all changes in this revision

Viewing changes to debian/README.test

  • Committer: Package Import Robot
  • Author(s): Ross Gammon
  • Date: 2015-08-11 23:03:11 UTC
  • mfrom: (1.4.3)
  • mto: This revision was merged to the branch mainline in revision 58.
  • Revision ID: package-import@ubuntu.com-20150811230311-acjr8gcfe8isx7ij
* New upstream release
* Drop patches applied upstream or cherry-picked from there
* Add version constraints for gtk and pygobject
* Add goocanvas dependency - available soon
* Drop webkit dpendency as HTML view has been removed
* Force removal of upstream packages when installing Debian one
  (LP: #1464845)
* Drop fixperm override as permissions fixed upstream
* Fix spelling error in changelog
* Switch to nose for unit tests
* Add build dependencies for the nose tests
* Update copyright file
* Add uversionmangle to watch file to deal with alpha/beta versions
* Add manual test cases
* Drop FAQ URL from upstream metadata - changes every release
* Add patch to fix transparent windows in Ubuntu.
  Thanks to Lance Orner (LP: #1451259)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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
 
8
 
 
9
Open Gramps, create an empty Family Tree, and check the Gramps version, credits & license:
 
10
- Run gramps
 
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
 
18
- Click on "Credits"
 
19
        - A list of Authors and Contributors to Gramps is displayed
 
20
- Click on "License"
 
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
 
24
 
 
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"
 
32
- Click on "Close"
 
33
        - The GEDCOM import report window displays "No errors detected"
 
34
- CLick on "Close"
 
35
        - The Top Surnames gramplet displays the surnames of the people imported into the Tree
 
36
 
 
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
 
44
- Click on Cancel
 
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)
 
57
- Click on OK
 
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
 
62
 
 
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
 
72
- Click OK
 
73
        - The "Select Child" window closes and you can see the new person listed as a child in Hjalmar's family
 
74
 
 
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
 
86
 
 
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
 
90
- Click on the pin
 
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
 
96
- Click on Cancel
 
97
- Click on the pin
 
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
 
101
- Click on Cancel
 
102
 
 
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.
 
116
- Click on "Close"
 
117
        - The Import Statistics window closes.
 
118
 
 
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
 
129
- Click Close
 
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).
 
148
- Click on "OK".
 
149
        - The "New Media" window opens.
 
150
- Click on "OK".
 
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.
 
155
        - Gramps closes.
 
156
 
 
157
TODO: Tagging & Filtering