Difference between revisions of "De:Gramps 3.1 Wiki Handbuch - Gramplets"

From Gramps
Jump to: navigation, search
m (1 revision(s))
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
{{grampsmanualcopyright}}
 
{{grampsmanualcopyright}}
  
{{man index/de|De:Gramps 3.1 Wiki Handbuch - Navigation|De:Gramps 3.1 Wiki Handbuch - Berichte}}
+
{{man index/de|De:Gramps 3.1 Wiki Handbuch - Navigation|De:Gramps 3.1 Wiki Handbuch - Berichte|3.1}}
  
 
{{languages|Gramps_3.1_Wiki_Manual_-_Gramplets}}
 
{{languages|Gramps_3.1_Wiki_Manual_-_Gramplets}}
  
This page details the functionality of the Gramplets. If you would like to read more technical details about writing your own Gramplet, please see [[Gramplets]].
+
This page details the functionality of the Gramplets. If you would like to read more technical details about writing your own Gramplet, please see [[Gramplets]]. For more Gramplets that you can extend your Gramps functionality with, see [[Third-party Plugins]].
  
 
= Gramplets =
 
= Gramplets =
[[Image:GrampletAnsicht.png|thumb|right|200px|Fig. 4.1 Gramplets View]]
+
[[Image:Mygramps.png|thumb|right|250px|Fig. 7.1 Gramplets View]]
  
 
A GRAMPS Gramplet is a view of data that either changes dynamically during the running of GRAMPS, or provides interactivity to your genealogical data. What is the difference between gramplets, reports, quick views, and tools?
 
A GRAMPS Gramplet is a view of data that either changes dynamically during the running of GRAMPS, or provides interactivity to your genealogical data. What is the difference between gramplets, reports, quick views, and tools?
  
*Reports provide a static output format of your data, typically for printing
+
*Reports provide a static output format of your data, typically for presentation
 
*Quick View provides a typically short, interactive listing derived from your data
 
*Quick View provides a typically short, interactive listing derived from your data
 
*Tools provide a method of processing your data
 
*Tools provide a method of processing your data
Line 20: Line 20:
  
 
When you first start the View you will see the '''Welcome Message Gramplet''' and the '''Top Surnames Gramplet'''.
 
When you first start the View you will see the '''Welcome Message Gramplet''' and the '''Top Surnames Gramplet'''.
 
+
<br clear="all"/>
[[Image:Detached.png|thumb|right|200px|Fig. 4.2 Detached Gramplets View]]
+
[[Image:Detached.png|thumb|right|250px|Fig. 7.2 Detached Gramplets View]]
  
 
You can drag the Properties button (top left) of each gramplet to move it around the screen. Clicking the Properties will detach the gramplet from Gramplet View and place it in its own window. The window will stay open regardless of page (relationship, pedigree, etc). Closing the detached view will put it back onto the Gramplets view. If you quit Gramps with a open gramplet, when you start gramps again, it will open automatically.
 
You can drag the Properties button (top left) of each gramplet to move it around the screen. Clicking the Properties will detach the gramplet from Gramplet View and place it in its own window. The window will stay open regardless of page (relationship, pedigree, etc). Closing the detached view will put it back onto the Gramplets view. If you quit Gramps with a open gramplet, when you start gramps again, it will open automatically.
Line 30: Line 30:
 
You can add new gramplets by right clicking on an open space on Gramplets. You can also change the number of columns by right-clicking an open area on the Gramplets page.
 
You can add new gramplets by right clicking on an open space on Gramplets. You can also change the number of columns by right-clicking an open area on the Gramplets page.
  
These are the currently available gramplets:
+
These are 18 default gramplets:
*Welcome Gramplet
+
 
*Top Surnames Gramplet
+
# Age on Date Gramplet - see the people alive and their ages on a particular date
*Surname Cloud Gramplet
+
# Age Stats Gramplet - see age span graphs
*TODO Gramplet
+
# Attributes Gramplets - see active person's attributes
*Statistics Gramplet  
+
# Calendar Gramplet - see people's events on a particular date, or in a month in the past
*Pedigree Gramplet
+
# Descendants Gramplet - see the active person's descendants
*Python Gramplet
+
# Fan Chart Gramplet - see the active person's pedigree, in a circular fan chart
*News Gramplet
+
# Given Name Cloud Gramplet - most popular given names
*Session Log Gramplet
+
# Pedigree Gramplet - see a complete pedigree in compressed text
*Calendar Gramplet
+
# Quick View - run a Quick View on the current person
*Relatives Gramplet
+
# Records Gramplet - see world's records of your data
*Age on Date Gramplet
+
# Relatives Gramplet - see the relatives of the active person
*Records Gramplet
+
# Session Log Gramplet - keep track of what you have done, and what records you have visted
*What's Next Gramplet
+
# Statistics Gramplet  - see stats on the database
 +
# Surname Cloud Gramplet - most popular surnames as a "text cloud"
 +
# TODO Gramplet - a notepad to keep tabs on your research
 +
# Top Surnames Gramplet - top 10 most popular surnames
 +
# Welcome Gramplet - a GRAMPS welcome message
 +
# What's Next Gramplet - what needs to be done next
 +
 
 +
There are other gramplets available through [[Third-party Plugins]], including:
 +
 
 +
*Data Entry Gramplet - edit active person's name, birth date and place, death date and place, and add people
 +
*Note Gramplet - see and edit active person's primary Person Note
 +
*Headline News Gramplet - current, breaking news from GRAMPS
 +
*FAQ Gramplet - frequently asked questions
 +
*Python Gramplet - a Python shell
  
 
If a link in a Gramplet is to a specific person, then clicking the link will change the Active Person. Double-clicking such any link to a specific GRAMPS item (such as person or family) will bring up the Editor for that item. To edit a linked person without changing the Active Person, right-click on the person link. Depending on the type of entry, double-clicking any row in a Quick View table will either select more specific data (drill down) or bring up the editor.
 
If a link in a Gramplet is to a specific person, then clicking the link will change the Active Person. Double-clicking such any link to a specific GRAMPS item (such as person or family) will bring up the Editor for that item. To edit a linked person without changing the Active Person, right-click on the person link. Depending on the type of entry, double-clicking any row in a Quick View table will either select more specific data (drill down) or bring up the editor.
Line 52: Line 65:
 
{{man note|Changing settings|You can change the settings of the Gramplets by editing your '''~/.gramps/gramplets.ini''' file. But you can only do that when GRAMPS is not running. Just bring up the ''gramplets.ini'' file in a text editor and make the desired changes. You can change the title of the Gramplet by changing the section name (surrounded by square brackets). These options will be able to be changed via the Gramplet View in the next version of GRAMPS. If you have an idea for additional Gramplets, please let us know!}}
 
{{man note|Changing settings|You can change the settings of the Gramplets by editing your '''~/.gramps/gramplets.ini''' file. But you can only do that when GRAMPS is not running. Just bring up the ''gramplets.ini'' file in a text editor and make the desired changes. You can change the title of the Gramplet by changing the section name (surrounded by square brackets). These options will be able to be changed via the Gramplet View in the next version of GRAMPS. If you have an idea for additional Gramplets, please let us know!}}
  
 +
== Age on Date Gramplet ==
  
== Data Entry Gramplet ==
+
[[Image:AgeOnDateGramplet.png|left|thumb|250px|Fig. 7.3 Age On Date Gramplet]]
 +
[[Image:AgeOnReport.png|right|thumb|250px|Fig. 7.3a Age On Date Quick Report]]
 +
This Gramplet gives you the possibility of entering a date in an entry field. If you click {{man button|Run}} the Gramplet will compute the ages for everyone in your Family Tree on that Date. The date must be entered in a format that GRAMPS accepts.
  
[[Image:DataEntryGramplet.png|thumb|right|150px|Fig. Data Entry Gramplet]]
 
  
''New in GRAMPS 3.1''
 
  
The Data Entry gramplet allows an easy method of editing previously added people, and adding new and related people in your family tree.
+
You can then sort by the age column, and double-click the row to view or edit.
  
The '''Surname, Given''' entry is a combined entry for just the surname and given names, separated by a comma. If you need more fine grained editing on the name, you can use the Edit icon once a person has been selected as the active person.
+
<br clear="all"/>
  
 +
== Age Stats Gramplet ==
  
 +
[[Image:AgeStatsGramplet.png|right|thumb|250px|Fig. 7.4 Age Stats Gramplet]]
  
The '''Death''' and '''Birth''' lines for both the ''Active person'' and ''New person'' are also a combined entry, allowing you to enter a date and place. The date (if one) is entered first in any format available to your GRAMPS installation, followed by the word "in" (in your language) and the location (if one). For example, the following are all valid entries for the birth or death entries:
+
[[Image:AgeStatsGrampletOptions.png|left|thumb|250px|Fig.7.5 Age Stats Gramplet showing options]]
  
Jan 1, 1867 in Kingsport, TN
+
The Age Stats gramplet shows graphs of the breakdown of particular age spans. Clicking on a row will bring up the associated people.
about 1822 in Sweden
+
<br clear="all"/>
in London, England, UK
+
You can change the gramplet's options by detaching, and selection the options drop-down area, and pressing {{man button|Save}}.
1756/12/31
 
  
If a location has been previously used, then it will share that location with the others. If it is new, it will be created.
+
<br clear="all"/>
  
A new person can be automatically added as a relation to the active person. You can add the new person as a parent, spouse, sibling, or child. The gramplet will guess at the best place to add the person. For example, it will add the new person to the first family available. The gramplet will also try to discern gender where needed, guessing that the "father" spouse of a family is male, and the "mother" spouse is female. If these guesses are incorrect, you should add your new person via the normal GRAMPS data entry method.
+
== Attributes Gramplet ==
  
If you would like to bring up the standard Edit Person window for the active person, simply click on the Edit button to the right of the Active person's name. If you would like to bring up the standard Edit Family window for the active person, click the Edit button to the right of the word "Family:" on the top row. This will bring up the first family (if the active person is the spouse in a family) or will bring up the active person's parents family, if known.
+
[[Image:AttributesGramplet.png|right|thumb|250px|Fig. 7.6 Attributes Gramplet]]
If you begin an edit of the active person, then the active person data won't change until you either '''Save''' or '''Abandon''' your changes.
 
  
The '''Copy Active Data''' will copy the entries of the active person to the entries for the new person.
+
[[Image:AttributesQV.png|left|thumb|250px|Fig. 7.7 Attributes Quick View]]
 +
<br clear="all"/>
 +
The Attributes gramplet shows all of the attributes for the current, active person. Double click on the name of the attribute, and you will run a Quick View that shows all of the people that have that attribute, and the values for it. You can sort the Quick View by the attribute value by clicking on the column name.
  
+
In the Quick View, highlight the entry to change the active person (which will then change the Attributes Gramplet), and double-click the Quick View entry to bring up the Edit Person dialog window.
== Descendant Gramplet ==
 
  
[[Image:DescendantGramplet.png|thumb|right|150px|Fig. Descendant Gramplet]]
+
<br clear="all"/>
  
''New in GRAMPS 3.1''
+
== Calendar Gramplet ==
 +
[[Image:Calendargadget.png|right|thumb|250px|Fig. 7.8 Calendar]]
  
The Descendent gramplet shows the direct descendants of the active person.
+
The Calendar gramplet shows a monthly calendar. Double-click a day to run the {{man label|On This Day}} Quick View.
 +
<br clear="all"/>
 +
With the {{man button|<}} and {{man button|>}} buttons top left corner (month) you can change to the previous and next month.
  
The order of the spouses and children is that given in the GRAMPS editor. To change the order of spouses, click on ''Order'' on the Relationship view. To change the order of children, drag and drop them in the correct order in the Family edit window.
+
With the {{man button|<}} and {{man button|>}} buttons top right corner (year) you can change to the previous and next year.
  
This gramplet is based on the Descendant Report, available from the Textual Reports.
+
The Quick View window shows you the '''Events of''' the selected day: Events on this exact date and Other events on this Month/day in history as well as Other events in that year.
  
The Descendant gramplet will update when you change the active person, or change family trees. It does not update automatically for edits or additions because this report is time-consuming to run.
+
The information is presented in a table showing:
 +
*Date
 +
*Type
 +
*Place
 +
*Reference
  
Minimizing a gramplet will prevent it from updating.
+
You can also drag a date to the date field of the [[Gramps_3.1_Wiki_Manual_-_Gramplets#Age on Date Gramplet|Age on Date Gramplet]] to enter that date.
  
== Welcome Gramplet ==
+
<br clear="all"/>
[[Image:Welcomegadget.png|thumb|right|150px|Fig. 4.3 Welcome Gramplet]]
 
  
The welcome gramplet gives an introductory message to new users, and some basic instructions.
+
== Descendant Gramplet ==
  
 +
[[Image:DescendantGramplet.png|thumb|right|250px|Fig. 7.9 Descendant Gramplet]]
  
 +
The Descendent gramplet shows the direct descendants of the active person.
  
 +
The order of the spouses and children is that given in the GRAMPS editor. To change the order of spouses, click on ''Order'' on the Relationship view. To change the order of children, [http://en.wikipedia.org/wiki/Drag-and-drop drag and drop] them in the correct order in the Family edit window.
  
 +
This gramplet is based on the Descendant Report, available from the Textual Reports.
  
 +
The Descendant gramplet will update when you change the active person, or change family trees. It does not update automatically for edits or additions because this report is time-consuming to run.
  
 +
Minimizing a gramplet will prevent it from updating.
  
 +
<br clear="all"/>
  
 +
== Fan Chart Gramplet ==
  
 +
[[Image:FanChartGramplet.png|thumb|right|250px|Fig. 7.10 Fan Chart Gramplet]]
  
 +
The Fan Chart gramplet shows the direct ancestors of the active person in a circular format. It is similar to the Pedigree View, but shown around the center/active person, and further generations spiralling out.
  
 +
Click on a parent in the chart and they will expand or contract above their child. Right-click on a person and you can:
  
 +
* select that person to be the active person
 +
* edit the person
 +
* select from among the person's relatives to be the active person
  
 +
Clicking in an open area (non-person) and dragging the mouse will allow you to rotate the chart about the center. ''In Gramps 3.2, you may also left-click and drag in the center to reposition the fan chart.''
  
 +
A white edge on the outer radius of the chart indicates more parents for that person. A black circle in the center indicates that the center person has children.
  
The welcome message describes what GRAMPS is, that the program is OSS and how you start a [[Gramps_3.1_Wiki_Manual_-_Manage_Family_Trees|Family Tree]].
+
The Fan Chart gramplet will update when you change the active person, or change family trees.  
  
This information can also be found on the [[Main_Page|start page of GRAMPS]]
+
Minimizing a gramplet will prevent it from updating.
  
== Top Surnames Gramplet ==
+
<br clear="all">
[[Image:Topgadget.png|thumb|right|200px|Fig. 4.4 Top 10 Surnames]]
 
  
The top surnames gramplet shows the top 10 (by default) used surnames.
+
== Given Name Cloud Gramplet ==
  
The top ten is presented as follows:
+
[[Image:GivenNameCloudGramplet.png|thumb|right|250px|Fig. 7.11 Given Name Cloud Gramplet]]
*Surname
 
*percentage
 
*occurences
 
  
The list gives you also the Total unique surnames in the database as well as the total number of people in your database.
+
Like the [[#Surname Cloud Gramplet|Surname Cloud Gramplet]], the Given Name Cloud gramplet shows the top most popular given names in your family tree. The size of the name indicates how popular it is. Mouse over the name to see the exact count, and the percent of people in the family tree that have that name.
  
+
The gramplet splits up given names into words (broken up by spaces). For example "Sarah Elizabeth" would appear under both "Sarah" and "Elizabeth".
Double-click a surname to run the {{man label|Same Surnames Quick View}}. This opens the {{man label|Quick View}} window, which gives the people with the surname you double-clicked.
 
  
A table is presented which shows all people with a matching name or alternate name. Person's name, birth date and name type is given.  
+
Double-click on the given name to bring up a Quick View of all of the matching people.
  
 +
<br clear="all">
  
 +
== Pedigree Gramplet ==
  
Change the number of names displayed by editing this section in ~/.gramps/gramplets.ini
+
[[Image:PedigreeGramplet.png|thumb|right|250px|Fig. 7.12 Pedigree Gramplet]]
  
 +
The Pedigree gramplet shows a compressed view of the active person's direct ancestors. It defaults to going back 100 generations. The names can be clicked to change the active person, double-clicked (or right-click) to edit the person. This Gramplet also shows at the bottom of the gramplet the number of people per generation. Double-click the Generation number to see the matching individuals.
  
== Surname Cloud Gramplet ==
+
In GRAMPS 3.1, you can now see birth and death dates next to a person's name.
[[Image:Surnamecloud.png|thumb|right|150px|Fig. 4.5 Surname Cloud]]
 
  
The surname cloud gramplet shows the top 100 (by default) used surnames. The name font size is proportional to the amount of people with the same name.
+
<br clear="all"/>
  
 +
== Quick View Gramplet ==
  
 +
[[Image:Quickviewgramplet.png|thumb|right|250px|Fig. 7.13 Quick View Gramplet]]
  
 +
The Quick View gramplet allows you to run a Quick View, but it updates as you move from person to person. (Currently, only People Quick Views can be run).
  
 +
You can run any of the [[Quick Views]] for a person.
  
Double-click a surname to run the {{man label|Same Surnames Quick View}}. This will open the {{man label|Quick View}} window where you can find all people with a matching or alternate name. Person, birth date and name type are given.  
+
You can change the options by clicking the Option button (top, left hand button of the Gramplet) which will detach the gramplet and bring it up an a window. Select {{man label|Options}} on the top row, and a list of options will appear. Press {{man button|Save}} to apply the changes to the Quick View. You may then close the window to reattach the gramplet.
  
 +
Currently, the Quick View Gramplet doesn't remember which Quick View between GRAMPS sessions, so you'll have to reselect it when you restart GRAMPS. This will be fixed in an upcoming version of GRAMPS.
  
 +
<br clear="all"/>
  
 +
== Records Gramplet ==
  
If you mouse over the name you see the percentage of occurence and total counts.
+
[[Image:RecordsGramplet.png|right|thumb|250px|Fig 7.14 Records Gramplet]]
 
 
 
 
 
 
  
 +
The Records Gramplet shows a number of interesting records (mostly age related) in your database. The list shows the top three for each element. 
  
 +
* Youngest living person
 +
* Oldest living person
 +
* Person died at youngest age
 +
* Person died at oldest age
 +
* Person married at youngest age
 +
* Person married at oldest age
 +
* Person divorced at youngest age
 +
* Person divorced at oldest age
 +
* Youngest father
 +
* Youngest mother
 +
* Oldest father
 +
* Oldest mother
 +
* Couple with most children
 +
* Living couple married most recently
 +
* Living couple married most long ago
 +
* Shortest past marriage
 +
* Longest past marriage
 +
<br clear="all"/>
  
 +
The list is not only interesting on its own, it is also a good sanity check of the data. For some items you have to fill in some additional information.
  
  
  
 +
Living couple married most long ago
 +
  1. van Dosselaere, Egidius and Rechters, Petronella (382 years, 1 month)
 +
  2. de Richter, Petrus and Asscericx, Catharina (379 years, 9 months)
  
 +
This example shows that there was a marriage event (thus calculation of the offset) but none of the persons had a death event. Even if the date is not known, just enter a death event for one of the partners and the list will be corrected.
  
 +
== Relatives Gramplet ==
 +
[[Image:RelativesGramplet.png|right|thumb|250px|Fig 7.15 Relatives Gramplet]]
  
 +
This Gramplet shows all direct relatives of the active person. It's intended use is as a navigation help, an alternative way to move through your GRAMPS database. If you detach the gramplet, and place it next to GRAMPS, it will allow you to use it to easily change the content of the current "person view".
  
 +
If you are working in the pedigree view, the active person is the left-most person. By clicking a name in the relatives gramplet, you can easily change the active person, and all person view in the other window will update. As the relatives gramplet shows all spouses, all children and all parents, this offers an alternative way of navigating your data.
  
 +
The names in this gramplet also allow you to call up the person editor directly, by right-clicking on any of the names.
  
 +
<br clear="all"/>
  
 +
== Session Log Gramplet ==
 +
[[Image:Loggadget.png|thumb|right|250px|Fig. 7.16 Session Log Gramplet]]
  
 +
The session log keeps track of activity in this session. It lists selected and edited objects.
  
 +
Click a name once to make this person the active person. Double-click on a name or family brings up the {{man label|edit}} page for that object. In addition, if you want to edit a person, but don't want to change the active person, you can right-click on the person's name.
  
 +
This gramplet is handy because you can very quickly change the active person, or edit the object, from the session list. 
  
 
+
<br clear="all"/>
 
 
Change the number of names displayed by editing this section in ~/.gramps/gramplets.ini
 
 
 
== TODO Gramplet ==
 
[[Image:Todogadget.png|right|thumb|200px|Fig. 4.6 TODO Gramplet]]
 
 
 
The TODO gramplet is free form text area. You can use this area to put some notes, remarks, things you should to get your research going. There are several other TODO programs (e.g. Tomboy e.a.) but this Gramplet is useful as the information stays within GRAMPS. In future versions, you will be able to save links to GRAMPS items (like people, events, and familes. This will allow you to keep a group of links that you are working on together.
 
 
 
The text is persistent between sessions. The data is saved to disk when you exit GRAMPS.
 
 
 
You can open more TODO lists to save different kinds of topics or organize your info.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Change the title of the gramplet by editing the section name in ~/.gramps/gramplets.ini
 
  
 
== Statistics Gramplet ==
 
== Statistics Gramplet ==
[[Image:Statgadget.png|right|thumb|200px|Fig. 4.7 Statistics Gramplet]]
+
[[Image:Statgadget.png|right|thumb|250px|Fig. 7.17 Statistics Gramplet]]
  
 
The Statistics gramplet runs a Statistics report. Double-click the phrases to bring up the matching items.
 
The Statistics gramplet runs a Statistics report. Double-click the phrases to bring up the matching items.
Line 230: Line 279:
 
As with all Gramplets if you click on the left hand side {{man button|Tool}} button you detach the window and if you add persons to your family tree, you will see the amount of individuals change dynamically.
 
As with all Gramplets if you click on the left hand side {{man button|Tool}} button you detach the window and if you add persons to your family tree, you will see the amount of individuals change dynamically.
  
== Pedigree Gramplet ==
+
<br clear="all"/>
  
[[Image:PedigreeGramplet.png|thumb|right|200px|Figure: Pedigree Gramplet]]
+
== Surname Cloud Gramplet ==
 +
[[Image:Surnamecloud.png|thumb|right|250px|Fig. 7.18 Surname Cloud]]
  
The Pedigree gramplet shows a compressed view of the active person's direct ancestors. It defaults to going back 100 generations. The names can be clicked to change the active person, double-clicked (or right-click) to edit the person. This Gramplet also shows at the bottom of the gramplet the number of people per generation. Double-click the Generation number to see the matching individuals.
+
The surname cloud gramplet shows the top 100 (by default) used surnames. The name font size is proportional to the amount of people with the same name.
  
 +
Double-click a surname to run the {{man label|Same Surnames Quick View}}. This will open the {{man label|Quick View}} window where you can find all people with a matching or alternate name. Person, birth date and name type are given.
  
 +
If you mouse over the name you see the percentage of occurrence and total counts.
  
 +
Change the number of names displayed by editing this section in ~/.gramps/gramplets.ini
  
 +
<br clear="all"/>
  
 +
== TODO Gramplet ==
 +
[[Image:Todogadget.png|right|thumb|250px|Fig. 7.19 TODO Gramplet]]
  
 +
The TODO gramplet is free form text area. You can use this area to put some notes, remarks, things you should to get your research going. There are several other TODO programs (e.g. Tomboy e.a.) but this Gramplet is useful as the information stays within GRAMPS. In future versions, you will be able to save links to GRAMPS items (like people, events, and families. This will allow you to keep a group of links that you are working on together.
  
 +
The text is persistent between sessions. The data is saved to disk when you exit GRAMPS.
  
 +
You can open more TODO lists to save different kinds of topics or organize your info.
  
 +
Change the title of the gramplet by editing the section name in ~/.gramps/gramplets.ini
  
 +
<br clear="all"/>
  
 +
== Top Surnames Gramplet ==
 +
[[Image:Topgadget.png|thumb|right|250px|Fig. 7.20 Top 10 Surnames]]
  
 +
The top surnames gramplet shows the top 10 (by default) used surnames.
  
 +
The top ten is presented as follows:
 +
*Surname
 +
*percentage
 +
*occurrences
  
In the next version of GRAMPS, you can optionally see birth and death dates.
+
The list gives you also the Total unique surnames in the database as well as the total number of people in your database.
  
== Python Gramplet ==
+
Double-click a surname to run the {{man label|Same Surnames Quick View}}. This opens the {{man label|Quick View}} window, which gives the people with the surname you double-clicked.
[[Image:Pythongadget.png|thumb|right|200px|Fig. 4.8 Python Shell]]
 
  
The Python gramplet brings up a Python Shell for interpreting python expressions.  
+
A table is presented which shows all people with a matching name or alternate name. Person's name, birth date and name type is given.  
  
You can type most any (single line) Python expression.  
+
Change the number of names displayed by editing this section in ~/.gramps/gramplets.ini
  
In addition, the environment has been populated with some useful variables, including '''self''' (this Python gramplet), '''Date''', '''uistate''' and '''dbstate'''.
+
<br clear="all"/>
  
Note that the name '''Date''' will be translated into your language, if a translations is available.
+
== Welcome Gramplet ==
 
+
[[Image:Welcomegadget.png|thumb|right|250px|Fig. 7.21 Welcome Gramplet]]
 
 
The '''Date''' entry is a date object constructor, and can be used for date arithmetic. For example, you might be interested in questions like:
 
 
 
What was the date 56 years before a given date:
 
 
 
> Date(2007, 12, 31) - 56
 
1951-12-31
 
 
 
How old was someone on Sept 3, 1955 who was born on June 7, 1922:
 
 
 
> Date(1955, 9, 3) - Date(1922, 5, 7)
 
(33, 3, 27)
 
 
 
(About 33 years, 3 months, and 27 days). When did they turn 21 years old?
 
 
 
> Date(1922, 5, 7) + 21
 
1943-05-07
 
 
 
You can also add years, months, and days:
 
 
 
> Date(1980) + (0, 0, 25)
 
1980-01-26
 
 
 
You can also use the same formats as you use in data entry:
 
 
 
> Date("Jan 15, 1962")
 
1962-15-01
 
> Date("15 Jan, 1962")
 
1962-15-01
 
> Date("1962-15-01")
 
1962-15-01
 
 
 
There are two ways to use different calendars:
 
 
 
> Date("Jan 15, 1532 (Julian)")
 
1532-15-01 (Julian)
 
> Date(1671, 12, 31, calendar="julian")
 
1671-12-31
 
 
 
and a method to convert one date into another calendar, which returns a new date object:
 
 
 
> Date(1703, 6, 1).to_calendar("hebrew")
 
5463-10-17 (Hebrew)
 
 
 
 
Another use for this Gramplet is for debugging. This gramplet makes a nice interface to the running GRAMPS system. You can inspect, and alter the system by entering Python commands. As a simple example, you can:
 
 
 
> self.clear_text() # clear the text in this window
 
> self.set_wrap(False) # new in GRAMPS 3.1: turn word wrap off
 
> self.set_wrap(True) # new in GRAMPS 3.1: turn word wrap on
 
 
 
== Quick View Gramplet ==
 
 
 
[[Image:Quickviewgramplet.png|thumb|right|150px|Fig. Quick View Gramplet]]
 
 
 
''New for version 3.1''
 
 
 
The Quick View gramplet allows you to run a Quick View, but it updates as you move from person to person. (Currently, only People Quick Views can be run).
 
 
 
 
 
You can run any of the [[Quick Views]] for a person.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
You can change the options by clicking the Option button (top, left hand button of the Gramplet). Select '''Options''' and a list of options will appear. Press '''Save''' to apply the changes to the Quick View.
 
 
 
 
 
== Quick View Gramplet ==
 
 
 
[[Image:Quickviewgramplet.png|thumb|right|150px|Fig. Quick View Gramplet]]
 
 
 
''New for version 3.1''
 
 
 
The Quick View gramplet allows you to run a Quick View, but it updates as you move from person to person. (Currently, only People Quick Views can be run).
 
 
 
 
 
You can run any of the [[Quick Views]] for a person.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
You can change the options by clicking the Option button (top, left hand button of the Gramplet). Select '''Options''' and a list of options will appear. Press '''Save''' to apply the changes to the Quick View.
 
== News Gramplet ==
 
[[Image:Newsgadget.png|thumb|right|150px|Fig. 4.9 News Gramplet]]
 
 
 
The News gramplet reads the wiki [[Main_Page|news]] page.
 
 
 
Because the News gramplet gets its information from the GRAMPS wiki (at http://gramps-project.org) you need to have a internet connection for this to work. If you don't have an internet connection, then the News gramplet won't show any news.
 
  
 +
The welcome gramplet gives an introductory message to new users, and some basic instructions.
  
 +
The welcome message describes what GRAMPS is, that the program is OSS and how you start a [[Gramps_3.1_Wiki_Manual_-_Manage_Family_Trees|Family Tree]].
  
 +
This information can also be found on the [[Main_Page|start page of GRAMPS]]
  
 
 
 
 
 
 
 
 
 
 
 
When you do have an internet connection, the News gramplet will show you the latest news about GRAMPS.
 
 
== Session Log Gramplet ==
 
[[Image:Loggadget.png|right|thumb|160px|Fig. 4.10 Session Log Gramplet]]
 
 
The session log keeps track of activity in this session.
 
 
By default, it only shows each entry once. If you change some information on person '''a''' and person '''b''' both selections will be listed in the Log.
 
 
You will get this sort of list:
 
*Selected:person a
 
*Selected:person b
 
 
Click a name to change the active person. This is very handy because you can very quickly change the active person from the list. 
 
 
Double-click on a name brings up the {{man label|edit}} page for that person. In addition, if you want to edit a person, but don't want to change the active person, you can right-click on the person's name.
 
 
 
 
 
 
 
 
 
 
Change this behavior by editing this section in ~/.gramps/gramplets.ini.
 
 
== Calendar Gramplet ==
 
[[Image:Calendargadget.png|right|thumb|200px|Fig 4.11 Calendar]]
 
 
The Calendar gramplet shows a monthly calendar, with current active person's events marked (in bold day numbers).
 
 
The actual date is highlighted.
 
 
With the {{man button|<}} and {{man button|>}} buttons top left corner (month) you can change to the previous and next month.
 
 
With the {{man button|<}} and {{man button|>}} buttons top right corner (year) you can change to the previous and next year.
 
 
 
Double-click a day to run the {{man label|On This Day}} Quick Report.
 
 
The window shows you the '''Events of''' the selected day: Events on this exact date and Other events on this Month/day in history as well as Other events in that year.
 
 
The information is presented in a table showing:
 
*Date
 
*Type
 
*Place
 
*Reference
 
 
You can also drag a date to the date field of the [[Gramps_3.1_Wiki_Manual_-_Gramplets#Age on Date Gramplet|Age on Date Gramplet]] to enter that date.
 
 
== Age on Date Gramplet ==
 
 
[[Image:AgeOnDateGramplet.png|right|thumb|200px|Fig 4.13a Age On Date Gramplet]]
 
This Gramplet gives you the possibility of entering a date in an entry field. If you click {{man button|Run}} the Gramplet will compute the ages for everyone in your Family Tree on that Date. The date must be entered in a format that GRAMPS accepts.
 
 
[[Image:AgeOnReport.png|right|thumb|200px|Fig 4.13b Age On Date Quick Report]]
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
You can then sort by the age column, and double-click the row to view or edit.
 
 
== Relatives Gramplet ==
 
[[Image:RelativesGramplet.png|right|thumb|200px|Fig 4.12 Relatives Gramplet]]
 
 
This Gramplet shows all direct relatives of the active person. It's intended use is as a navigation help, an alternative way to move through your GRAMPS database. If you detach the gramplet, and place it next to GRAMPS, it will allow you to use it to easily change the content of the current "person view".
 
 
 
If you are working in the pedigree view, the active person is the left-most person. By clicking a name in the relatives gramplet, you can easily change the active person, and all person view in the other window will update. As the relatives gramplet shows all spouses, all children and all parents, this offers an alternative way of navigating your data.
 
 
The names in this gramplet also allow you to call up the person editor directly, by right-clicking on any of the names.
 
 
== Records Gramplet ==
 
[[Image:RecordsGramplet.png|right|thumb|200px|Fig 4.16 Records Gramplet]]
 
 
''Will appear only in the future in version GRAMPS 3.1.x''
 
 
The Records Gramplet shows a number of interesting records (mostly age related) in your database, like oldest living person, youngest mother, etc.
 
 
 
<br clear="all"/>
 
<br clear="all"/>
  
 
== What's Next Gramplet ==
 
== What's Next Gramplet ==
  
[[Image:WhatsNextGramplet.png|right|thumb|200px|Fig 4.17 What's Next Gramplet]]
+
[[Image:WhatsNextGramplet.png|right|thumb|250px|Fig 7.22 What's Next Gramplet]]
 
 
''Will appear only in the future in version GRAMPS 3.1.x''
 
  
 
The What's Next Gramplet displays a list of the "most urgent" information gaps in your family tree. It is based on the following assumptions:
 
The What's Next Gramplet displays a list of the "most urgent" information gaps in your family tree. It is based on the following assumptions:
Line 506: Line 353:
 
<br clear="all"/>
 
<br clear="all"/>
  
 
+
{{man index/de|De:Gramps 3.1 Wiki Handbuch - Navigation|De:Gramps 3.1 Wiki Handbuch - Berichte|3.1}}
{{man index/de|De:Gramps 3.1 Wiki Handbuch - Navigation|De:Gramps 3.1 Wiki Handbuch - Berichte}}
 
  
  

Revision as of 17:27, 11 January 2010

Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known Typographical conventions


Zurück Index Nächste


This page details the functionality of the Gramplets. If you would like to read more technical details about writing your own Gramplet, please see Gramplets. For more Gramplets that you can extend your Gramps functionality with, see Third-party Plugins.

Gramplets

Fig. 7.1 Gramplets View

A GRAMPS Gramplet is a view of data that either changes dynamically during the running of GRAMPS, or provides interactivity to your genealogical data. What is the difference between gramplets, reports, quick views, and tools?

  • Reports provide a static output format of your data, typically for presentation
  • Quick View provides a typically short, interactive listing derived from your data
  • Tools provide a method of processing your data
  • Gramplets provide a dynamic view and interface to your data

Gramplets are the widgets that are part of GRAMPS and can be seen in the Gramplet View. The widgets provide all kind of functionality that can be useful for the researcher.

When you first start the View you will see the Welcome Message Gramplet and the Top Surnames Gramplet.

Fig. 7.2 Detached Gramplets View

You can drag the Properties button (top left) of each gramplet to move it around the screen. Clicking the Properties will detach the gramplet from Gramplet View and place it in its own window. The window will stay open regardless of page (relationship, pedigree, etc). Closing the detached view will put it back onto the Gramplets view. If you quit Gramps with a open gramplet, when you start gramps again, it will open automatically.

When one or more Gramplets are undocked from the Gramplet View, you can change to a different view (such as the People or Pedigree View). In this way, you can use these gramplets to supplement a particular view with additional details and functionality provided by the gramplet.


You can add new gramplets by right clicking on an open space on Gramplets. You can also change the number of columns by right-clicking an open area on the Gramplets page.

These are 18 default gramplets:

  1. Age on Date Gramplet - see the people alive and their ages on a particular date
  2. Age Stats Gramplet - see age span graphs
  3. Attributes Gramplets - see active person's attributes
  4. Calendar Gramplet - see people's events on a particular date, or in a month in the past
  5. Descendants Gramplet - see the active person's descendants
  6. Fan Chart Gramplet - see the active person's pedigree, in a circular fan chart
  7. Given Name Cloud Gramplet - most popular given names
  8. Pedigree Gramplet - see a complete pedigree in compressed text
  9. Quick View - run a Quick View on the current person
  10. Records Gramplet - see world's records of your data
  11. Relatives Gramplet - see the relatives of the active person
  12. Session Log Gramplet - keep track of what you have done, and what records you have visted
  13. Statistics Gramplet - see stats on the database
  14. Surname Cloud Gramplet - most popular surnames as a "text cloud"
  15. TODO Gramplet - a notepad to keep tabs on your research
  16. Top Surnames Gramplet - top 10 most popular surnames
  17. Welcome Gramplet - a GRAMPS welcome message
  18. What's Next Gramplet - what needs to be done next

There are other gramplets available through Third-party Plugins, including:

  • Data Entry Gramplet - edit active person's name, birth date and place, death date and place, and add people
  • Note Gramplet - see and edit active person's primary Person Note
  • Headline News Gramplet - current, breaking news from GRAMPS
  • FAQ Gramplet - frequently asked questions
  • Python Gramplet - a Python shell

If a link in a Gramplet is to a specific person, then clicking the link will change the Active Person. Double-clicking such any link to a specific GRAMPS item (such as person or family) will bring up the Editor for that item. To edit a linked person without changing the Active Person, right-click on the person link. Depending on the type of entry, double-clicking any row in a Quick View table will either select more specific data (drill down) or bring up the editor.

This section will describe each gramplet and its basic functionality.

Gramps-notes.png
Changing settings

You can change the settings of the Gramplets by editing your ~/.gramps/gramplets.ini file. But you can only do that when GRAMPS is not running. Just bring up the gramplets.ini file in a text editor and make the desired changes. You can change the title of the Gramplet by changing the section name (surrounded by square brackets). These options will be able to be changed via the Gramplet View in the next version of GRAMPS. If you have an idea for additional Gramplets, please let us know!

Age on Date Gramplet

Fig. 7.3 Age On Date Gramplet
Fig. 7.3a Age On Date Quick Report

This Gramplet gives you the possibility of entering a date in an entry field. If you click Run the Gramplet will compute the ages for everyone in your Family Tree on that Date. The date must be entered in a format that GRAMPS accepts.


You can then sort by the age column, and double-click the row to view or edit.


Age Stats Gramplet

Fig. 7.4 Age Stats Gramplet
Fig.7.5 Age Stats Gramplet showing options

The Age Stats gramplet shows graphs of the breakdown of particular age spans. Clicking on a row will bring up the associated people.
You can change the gramplet's options by detaching, and selection the options drop-down area, and pressing Save.


Attributes Gramplet

Fig. 7.6 Attributes Gramplet
Fig. 7.7 Attributes Quick View


The Attributes gramplet shows all of the attributes for the current, active person. Double click on the name of the attribute, and you will run a Quick View that shows all of the people that have that attribute, and the values for it. You can sort the Quick View by the attribute value by clicking on the column name.

In the Quick View, highlight the entry to change the active person (which will then change the Attributes Gramplet), and double-click the Quick View entry to bring up the Edit Person dialog window.


Calendar Gramplet

Fig. 7.8 Calendar

The Calendar gramplet shows a monthly calendar. Double-click a day to run the On This Day Quick View.
With the < and > buttons top left corner (month) you can change to the previous and next month.

With the < and > buttons top right corner (year) you can change to the previous and next year.

The Quick View window shows you the Events of the selected day: Events on this exact date and Other events on this Month/day in history as well as Other events in that year.

The information is presented in a table showing:

  • Date
  • Type
  • Place
  • Reference

You can also drag a date to the date field of the Age on Date Gramplet to enter that date.


Descendant Gramplet

Fig. 7.9 Descendant Gramplet

The Descendent gramplet shows the direct descendants of the active person.

The order of the spouses and children is that given in the GRAMPS editor. To change the order of spouses, click on Order on the Relationship view. To change the order of children, drag and drop them in the correct order in the Family edit window.

This gramplet is based on the Descendant Report, available from the Textual Reports.

The Descendant gramplet will update when you change the active person, or change family trees. It does not update automatically for edits or additions because this report is time-consuming to run.

Minimizing a gramplet will prevent it from updating.


Fan Chart Gramplet

Fig. 7.10 Fan Chart Gramplet

The Fan Chart gramplet shows the direct ancestors of the active person in a circular format. It is similar to the Pedigree View, but shown around the center/active person, and further generations spiralling out.

Click on a parent in the chart and they will expand or contract above their child. Right-click on a person and you can:

  • select that person to be the active person
  • edit the person
  • select from among the person's relatives to be the active person

Clicking in an open area (non-person) and dragging the mouse will allow you to rotate the chart about the center. In Gramps 3.2, you may also left-click and drag in the center to reposition the fan chart.

A white edge on the outer radius of the chart indicates more parents for that person. A black circle in the center indicates that the center person has children.

The Fan Chart gramplet will update when you change the active person, or change family trees.

Minimizing a gramplet will prevent it from updating.


Given Name Cloud Gramplet

Fig. 7.11 Given Name Cloud Gramplet

Like the Surname Cloud Gramplet, the Given Name Cloud gramplet shows the top most popular given names in your family tree. The size of the name indicates how popular it is. Mouse over the name to see the exact count, and the percent of people in the family tree that have that name.

The gramplet splits up given names into words (broken up by spaces). For example "Sarah Elizabeth" would appear under both "Sarah" and "Elizabeth".

Double-click on the given name to bring up a Quick View of all of the matching people.


Pedigree Gramplet

Fig. 7.12 Pedigree Gramplet

The Pedigree gramplet shows a compressed view of the active person's direct ancestors. It defaults to going back 100 generations. The names can be clicked to change the active person, double-clicked (or right-click) to edit the person. This Gramplet also shows at the bottom of the gramplet the number of people per generation. Double-click the Generation number to see the matching individuals.

In GRAMPS 3.1, you can now see birth and death dates next to a person's name.


Quick View Gramplet

Fig. 7.13 Quick View Gramplet

The Quick View gramplet allows you to run a Quick View, but it updates as you move from person to person. (Currently, only People Quick Views can be run).

You can run any of the Quick Views for a person.

You can change the options by clicking the Option button (top, left hand button of the Gramplet) which will detach the gramplet and bring it up an a window. Select Options on the top row, and a list of options will appear. Press Save to apply the changes to the Quick View. You may then close the window to reattach the gramplet.

Currently, the Quick View Gramplet doesn't remember which Quick View between GRAMPS sessions, so you'll have to reselect it when you restart GRAMPS. This will be fixed in an upcoming version of GRAMPS.


Records Gramplet

Fig 7.14 Records Gramplet

The Records Gramplet shows a number of interesting records (mostly age related) in your database. The list shows the top three for each element.

  • Youngest living person
  • Oldest living person
  • Person died at youngest age
  • Person died at oldest age
  • Person married at youngest age
  • Person married at oldest age
  • Person divorced at youngest age
  • Person divorced at oldest age
  • Youngest father
  • Youngest mother
  • Oldest father
  • Oldest mother
  • Couple with most children
  • Living couple married most recently
  • Living couple married most long ago
  • Shortest past marriage
  • Longest past marriage


The list is not only interesting on its own, it is also a good sanity check of the data. For some items you have to fill in some additional information.


Living couple married most long ago

 1. van Dosselaere, Egidius and Rechters, Petronella (382 years, 1 month)
 2. de Richter, Petrus and Asscericx, Catharina (379 years, 9 months)

This example shows that there was a marriage event (thus calculation of the offset) but none of the persons had a death event. Even if the date is not known, just enter a death event for one of the partners and the list will be corrected.

Relatives Gramplet

Fig 7.15 Relatives Gramplet

This Gramplet shows all direct relatives of the active person. It's intended use is as a navigation help, an alternative way to move through your GRAMPS database. If you detach the gramplet, and place it next to GRAMPS, it will allow you to use it to easily change the content of the current "person view".

If you are working in the pedigree view, the active person is the left-most person. By clicking a name in the relatives gramplet, you can easily change the active person, and all person view in the other window will update. As the relatives gramplet shows all spouses, all children and all parents, this offers an alternative way of navigating your data.

The names in this gramplet also allow you to call up the person editor directly, by right-clicking on any of the names.


Session Log Gramplet

Fig. 7.16 Session Log Gramplet

The session log keeps track of activity in this session. It lists selected and edited objects.

Click a name once to make this person the active person. Double-click on a name or family brings up the edit page for that object. In addition, if you want to edit a person, but don't want to change the active person, you can right-click on the person's name.

This gramplet is handy because you can very quickly change the active person, or edit the object, from the session list.


Statistics Gramplet

Fig. 7.17 Statistics Gramplet

The Statistics gramplet runs a Statistics report. Double-click the phrases to bring up the matching items.

Following information is provided to you in this Gramplet:

  • Individuals
    • Number of individuals
    • Males
    • Females
    • Individuals with unknown gender
    • Individuals with incomplete names
    • Individuals with missing birth dates
    • Disconnected individuals
  • Family information
    • Number of families
    • Unique surnames
  • Media objects
    • Individuals with media objects
    • Total numbers of media object references
    • Number of unique media objects
    • Total size of media objects
    • Missing Media Objects

As with all Gramplets if you click on the left hand side Tool button you detach the window and if you add persons to your family tree, you will see the amount of individuals change dynamically.


Surname Cloud Gramplet

Fig. 7.18 Surname Cloud

The surname cloud gramplet shows the top 100 (by default) used surnames. The name font size is proportional to the amount of people with the same name.

Double-click a surname to run the Same Surnames Quick View. This will open the Quick View window where you can find all people with a matching or alternate name. Person, birth date and name type are given.

If you mouse over the name you see the percentage of occurrence and total counts.

Change the number of names displayed by editing this section in ~/.gramps/gramplets.ini


TODO Gramplet

Fig. 7.19 TODO Gramplet

The TODO gramplet is free form text area. You can use this area to put some notes, remarks, things you should to get your research going. There are several other TODO programs (e.g. Tomboy e.a.) but this Gramplet is useful as the information stays within GRAMPS. In future versions, you will be able to save links to GRAMPS items (like people, events, and families. This will allow you to keep a group of links that you are working on together.

The text is persistent between sessions. The data is saved to disk when you exit GRAMPS.

You can open more TODO lists to save different kinds of topics or organize your info.

Change the title of the gramplet by editing the section name in ~/.gramps/gramplets.ini


Top Surnames Gramplet

Fig. 7.20 Top 10 Surnames

The top surnames gramplet shows the top 10 (by default) used surnames.

The top ten is presented as follows:

  • Surname
  • percentage
  • occurrences

The list gives you also the Total unique surnames in the database as well as the total number of people in your database.

Double-click a surname to run the Same Surnames Quick View. This opens the Quick View window, which gives the people with the surname you double-clicked.

A table is presented which shows all people with a matching name or alternate name. Person's name, birth date and name type is given.

Change the number of names displayed by editing this section in ~/.gramps/gramplets.ini


Welcome Gramplet

Fig. 7.21 Welcome Gramplet

The welcome gramplet gives an introductory message to new users, and some basic instructions.

The welcome message describes what GRAMPS is, that the program is OSS and how you start a Family Tree.

This information can also be found on the start page of GRAMPS


What's Next Gramplet

Fig 7.22 What's Next Gramplet

The What's Next Gramplet displays a list of the "most urgent" information gaps in your family tree. It is based on the following assumptions:

  • You want to know first and last name, birth date and place, and death date and place of each person
  • You want to know father, mother, marriage date and place, and - if divorced - divorce date and place of each family with married parents
  • You want to know at least the mother of each family with unmarried parents
  • The closer the relationship to the main person, the more "urgent" the information gap is.
  • The closer the common ancestor is from the main person, the more "urgent" the information is (e.g. nephews are considered more "urgent" than uncles, even though both have a distance of 3, because for nephews the common ancestor is father/mother, while for uncles, the common ancestor is grandfather/grandmother)
  • Marriage data and personal data of the spouse is slightly less "urgent" than personal data of the directly related person
  • Half brothers are less "urgent" than brothers


Zurück Index Nächste