Difference between revisions of "Gramps 3.0 Wiki Manual - Gramplets"

From Gramps
Jump to: navigation, search
(Gramplets)
(Welcome Gramplet)
Line 40: Line 40:
  
 
== Welcome Gramplet ==
 
== Welcome Gramplet ==
[[Image:Welcomegadget.png|thumb|right|250px|Fig. 4.3 Welcome Gramplet]]
+
[[Image:Welcomegadget.png|thumb|right|200px|Fig. 4.3 Welcome Gramplet]]
  
 
The welcome gramplet gives an introductory message to new users, and some basic instructions.
 
The welcome gramplet gives an introductory message to new users, and some basic instructions.
  
TODO: add links to parts of manual, links to bring up windows.
+
The welcome message describes what GRAMPS is, that the program is OSS and how you start a [[Gramps_3.0_Wiki_Manual:_Getting_Started|Family Tree]]
  
 
== Top Surnames Gramplet ==
 
== Top Surnames Gramplet ==

Revision as of 08:05, 24 February 2008

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


Gramplets

Fig. 4.1 Gramplets View

What is a GRAMPS gramplet? 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
  • 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 a Welcome Message Gramplet and a Stats Gramplet.

Fig. 4.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 (currently) detach the gramplet from My Gramps 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 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:

  • Welcome Gramplet
  • Top Surnames Gramplet
  • Surname Cloud Gramplet
  • TODO Gramplet
  • Statistics Gramplet
  • Python Gramplet
  • News Gramplet
  • Session Log Gramplet
  • Calendar Gramplet

This section will describe each gramplet and its basic functionality

Welcome Gramplet

Fig. 4.3 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

Top Surnames Gramplet

Fig. 4.4 Top 10 Surnames

The top surnames gramplet shows the top 10 (by default) used surnames. Double-click a surname to run the Same Surnames Quick View.

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

Surname Cloud Gramplet

Fig. 4.5 Surname Cloud

The surname cloud gramplet shows the top 100 (by default) used surnames. Double-click a surname to run the Same Surnames Quick View. Mouse over the name to see percentage and counts.

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

TODO Gramplet

Fig. 4.6 TODO Gramplet

The TODO gramplet is free form text. This is persistent between sessions. Open more than one to save different info. Change the title of the gramplet by editing the section name in ~/.gramps/gramplets.ini

Statistics Gramplet

Fig. 4.7 Statistics Gramplet

The Statistics gramplet runs a copy of the code from the Statistics report.

Python Gramplet

Fig. 4.8 Python Shell

The Python gramplet brings up a Python Shell for interpreting python expressions. You can type most any (single line) Python expression. In addition, the environment has been populated with some useful variables, including self (this Python gramplet), Date, uistate and dbstate. The Date entry is a date object constructor, and can be used for date arithmetic. For example, you might be interested in answering these questions:

What was the date 56 years ago:

> 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

News Gramplet

Fig. 4.9 News Gramplet

The News gramplet reads the wiki news page. TODO: add links and formatting.

Session Log Gramplet

Fig. 4.10 Session Log Gramplet

The session log keeps track of activity in this session. By default, it only shows each entry once. Change this behavior by editing this section in ~/.gramps/gramplets.ini. Click a name to change the active person; double-click to bring up the edit page for that person.

Calendar Gramplet

Fig 4.11 Calendar

The Calendar gramplet shows a monthly calendar, with events marked (in bold day numbers). Double-click a day to run the "On This Day" Quick Report.


Relatives Gramplet

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.


Previous [[Gramps {{{3}}} Wiki Manual| Index]] Next