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

From Gramps
Jump to: navigation, search
(Surname Cloud Gramplet)
(TODO Gramplet)
Line 132: Line 132:
 
[[Image:Todogadget.png|right|thumb|200px|Fig. 4.6 TODO Gramplet]]
 
[[Image:Todogadget.png|right|thumb|200px|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
+
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 great because the TODO info stays within GRAMPS.
 +
 
 +
This is persistent between sessions.
 +
 
 +
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 ==

Revision as of 08:32, 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.

The top ten is presented as follows:

  • 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.


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.


<----- check 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. 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 occurence and total 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 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 great because the TODO info stays within GRAMPS.

This is persistent between sessions.

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

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