From 761af392aebef588e63897d072de47be7a98721e Mon Sep 17 00:00:00 2001 From: Alex Roitman Date: Thu, 20 Mar 2003 20:53:29 +0000 Subject: [PATCH] Finished navigation svn: r1368 --- doc/gramps-manual/C/gramps.html | 597 ++++++++++++++++++++------------ doc/gramps-manual/C/gramps.xml | 183 ++++++++-- 2 files changed, 526 insertions(+), 254 deletions(-) diff --git a/doc/gramps-manual/C/gramps.html b/doc/gramps-manual/C/gramps.html index 40e1eab45..c30170e58 100644 --- a/doc/gramps-manual/C/gramps.html +++ b/doc/gramps-manual/C/gramps.html @@ -5,7 +5,7 @@ >GRAMPS Manual V2.0GRAMPS Manual V2.0 Manual V2.0

   

   

4.9.1. Setting Default PersonUsing People View
4.9.2. Bookmarking People
4.9.3. Using Family View
4.9.4. 4.9.3. Using Pedigree View
4.9.4. Setting Default Person
4.9.5. Bookmarking People
1. Introduction1. Introduction

The is a genealogical application. GRAMPS is an acronym for the Genealogical Research and Analysis Management Programming System. To put it shortly, it allows you to store, edit, and research genealogical data @@ -602,11 +604,11 @@ CLASS="sect2" CLASS="sect2" >1.1. Why GRAMPS??

2. Getting Started2. Getting Started

2.1. To Start GRAMPS

You can start gramps filename.gedfilename.ged

where where filename.gedfilename.ged is the name of the file you want to open/import.

2.2. Running GRAMPS for the first time for the first time

[ FIXME: NEED TO RUN Getting Started DRUID to document this section ] @@ -795,8 +793,8 @@ CLASS="sect3" CLASS="sect3" >2.2.1. Choosing a database on startup2.2.1. Choosing a database on startup

If 2.2.2. Optional ZODB support2.2.2. Optional ZODB support

If either StandaloneZODB or Zope is installed on your system, 3. Main Window3. Main Window

When you open a database (either existing or brand new), the following window is displayed.

The progress bar is located in the lower left corner of the GRAMPS window. It displays the progress of time consuming operations, such as opening and saving large data bases, importing and exporting to other formats, generating @@ -967,10 +962,7 @@ CLASS="application" >The statusbar is located to the right of the progress bar, on the very bottom of the GRAMPS window. It displays information about current Display area.

The largest are in the center of the +>The largest area in the center of the GRAMPS window is the display area. It shows certain aspects of genealogical information, depending on the currently selected View. There are six Views available @@ -1037,8 +1026,8 @@ CLASS="sect2" CLASS="sect2" >3.1. Views3.1. Views

Views are the various ways to display different aspects of genealogical information, as described below. Since the relevant @@ -1054,8 +1043,8 @@ CLASS="sect3" CLASS="sect3" >3.1.1. Switching Views and Viewing Modes3.1.1. Switching Views and Viewing Modes

Depending on the state of the 3.1.2. People View3.1.2. People View

When Names, GRAMPS - ID numbers, numbers, + Gender, and @@ -1188,8 +1174,8 @@ CLASS="sect4" CLASS="sect4" >3.1.2.1. Filters3.1.2.1. Filters

Genealogical databases may contain huge numbers of people. Since the long lists are hard for humans to handle, @@ -1311,8 +1297,8 @@ CLASS="sect4" CLASS="sect4" >3.1.2.2. Alphabetical Tabs3.1.2.2. Alphabetical Tabs

GRAMPS window. The last tab, 3.1.3. Family View3.1.3. Family View

Family View displays the Family information of a currently selected (or Active) person. Specifically, this view shows the @@ -1467,8 +1450,8 @@ CLASS="sect3" CLASS="sect3" >3.1.4. Pedigree View3.1.4. Pedigree View

3.1.5. Sources View3.1.5. Sources View
3.1.6. Places View3.1.6. Places View
3.1.7. Media View3.1.7. Media View
4. Usage4. Usage

As commonly encountered in everyday life, in 4.1. Opening Database4.1. Opening Database

To open a database, either choose 4.2. Starting New Database4.2. Starting New Database

To start a new database, choose 4.3. Saving Database4.3. Saving Database

To save changes made to your database, choose on the Toolbar. The Status line will then display Saving Saving filenamefilename... message, and the progress bar will advance as the saving progresses.

4.4. Importing GEDCOM Data4.4. Importing GEDCOM Data

Importing GEDCOM data allows you to incorporate the data created in - other genealogical programs into your currently - open GRAMPS database. File->Import->4.5. Exporting GEDCOM Data4.5. Exporting GEDCOM Data

Exporting GEDCOM data allows you to share any portion of you +>Exporting GEDCOM data allows you to share any portion of your GRAMPS database with other researchers by way of standard GEDCOM files. To export into GEDCOM file, choose File->Export->4.6. Importing and Exporting GRAMPS Packages Packages

provides a way to make your GRAMPS database completely portable. This might prove useful, for instance, when you need to move your database to another machine or to share it with somebody, while retaining all the @@ -2030,7 +2001,7 @@ CLASS="application" CLASS="guimenu" >File->Export->

To import data from such a package into your - To import data from such a package into your GRAMPS database, choose File->Import->4.7. Editing Data: Quick Start4.7. Editing Data: Quick Start

Editing any portion of data allows you to amend and/or modify information stored in the database. The available editing @@ -2100,8 +2067,8 @@ CLASS="sect3" CLASS="sect3" >4.7.1. To Add a Person4.7.1. To Add a Person

To add a person to the database, switch to the People View (4.7.2. To Specify a Relationship4.7.2. To Specify a Relationship

To specify a relationship, first switch to the Family View (4.7.3. To Specify Parents4.7.3. To Specify Parents

To specify parents of an active person, first switch to the Family View (4.7.4. To Specify Children4.7.4. To Specify Children

To specify children of an active person, switch to the Family View (4.7.5. To Add Images4.7.5. To Add Images

You can add images (as well as other media objects) to individual people, events, sources, places, as well as images @@ -2382,8 +2349,8 @@ CLASS="sect3" CLASS="sect3" >4.7.6. To Edit Sources and Places4.7.6. To Edit Sources and Places

To add a source or a place to the database, switch to the appropriate Sources or Places View (4.8. Editing Data: Complete Description4.8. Editing Data: Complete Description

This section provides a complete description of all editing + options for all pieces of data in the GRAMPS database.

4.8.1. Edit Personal Information

4.8.1. Edit Personal Information

Editing of personal data can be performed in the following ways.

4.8.2. Edit Relationship Data4.8.2. Edit Relationship Data

Editing of relationship data is performed in the following 4.8.3. Edit Source Data4.8.3. Edit Source Data

To edit source data, switch to the Sources View and select the desired entry in the list of sources. Double-click on that entry or @@ -3535,8 +3508,8 @@ CLASS="sect3" CLASS="sect3" >4.8.4. Edit Place Data4.8.4. Edit Place Data

To edit place data, switch to the Places View and select the desired entry in the list of places. Double-click on that entry or @@ -3869,8 +3842,8 @@ CLASS="sect3" CLASS="sect3" >4.8.5. Edit Media Data4.8.5. Edit Media Data

To edit media data, switch to the Media View and select the desired entry in the list of sources. Double-click on that entry or @@ -4087,8 +4060,8 @@ CLASS="sect3" CLASS="sect3" >4.8.6. Edit Events4.8.6. Edit Events

Events are edited through the following 4.8.7. Edit Source Information4.8.7. Edit Source Information

When adding source references to events, places, etc., the following dialog appears:

4.8.8. Edit Alternate Names4.8.8. Edit Alternate Names

Alternate names are edited through the following 4.8.9. Edit Attributes4.8.9. Edit Attributes

Attributes are edited through the following 4.8.10. Edit Addresses4.8.10. Edit Addresses

Addresses are edited through the following 4.8.11. Edit Witnesses4.8.11. Edit Witnesses

Witnesses are edited through the following 4.9. Navigation4.9. Navigation

As long as any database is open, + GRAMPS is focused on a + single person usually referred to as an Active person. This + allows you to view or modify the data concerning this person, + his or her immediate family, etc. Navigating in the databse (i.e. + moving from person to person) is in fact nothing else but changing + the Active person. This section describes many alternative ways + to navigate through the database using complex and convenient + interface GRAMPS provides. All these ways + eventually accomplish the same thing, but some are more convenient + than others, depending what you are doing in + GRAMPS at the moment.

4.9.1. Setting Default Person

4.9.1. Using People View

4.9.2. Bookmarking People

The most intuitive way to select an active person is + to use the People View. When in the People View, just select the + name of the desired person from the list by clicking that list + entry. The person you have selected becomes active. The statusbar + updates to reflect the change of the active person.

4.9.3. Using Family View4.9.2. Using Family View

When in the Family View, you can easily navigate between the + members of the displayed family as follows:

  • To make currently selected spouse the active person, + click double-arrow button to the right of the active person box. +

  • To make currently selected parents the active family + (thereby making father the active person and mother the selected + spouse), click right-arrow button to the right of the active person's + parents box.

  • To make currently selected spouse's parents + the active family (thereby making father the active person and mother + the selected spouse), click right-arrow button to the right of the + spouse's parents box.

  • To make currently selected child the active person, + click left-arrow button to the right of the children box. +

4.9.4. Using Pedigree View4.9.3. Using Pedigree View

Pedigree View also allows you to move along the family tree. + The benefits of this method is that you can see more than one + generation of the family tree. Also, you can jump directly from a + great-grandson to a great-grandfather without going through the + intermediate generations.

Note that after changing the active person in the Pedigree + View, the display is re-adjusted to show four generations, starting + from a newly selected Active person. When in the Pedigree View, you + can easily navigate between the members of the displayed family tree + as follows:

  • To make any displayed person the active person, + double click the line that connects to the left side of the + corresponding box.

  • To make a child of currently active person (if any) + the active person, click the left arrow button to the left of the + corresponding box. If there is more than one child, the button expands + to the menu listing the children to choose from.

  • To move the whole family tree one generation back, + click on the corresponding right arrow button on the right-hand side + of the display area. Clicking the upper button will move the tree + along the paternal line. Clicking the lower button will move the + tree along the maternal line.

    Clicking either of these buttons is completely equivalent to + double-clicking the lines connecting to the left of the corresponding + boxes for father and mother.

4.9.4. Setting Default Person

One and only one person in the databse can be selected as the + default person. Once the default person is selected, moving to that + person becomes a matter of a signle click, regardless of which view + you are using at the moment.

To set the default person, first navigate to that person using + any method you like. Then choose + Settings->Default Person. Once this is + done, you can move to the default person from anywhere in the + database by simply clicking Home on the + toolbar.

4.9.5. Bookmarking People

Similarly to the default person, you can bookmark other people + from the database to simplify further navigation. To bookmark a person, + first navigate to that person, then choose + Bookmarks->Add bookmark. To move to that + person from anywhere in the database, choose + Bookmarks->Go to bookmark->Person's name.

You can manage your bookmarks by choosing + Bookmarks->Edit bookmarks. This opens + the followingEdit Bookmarks dialog with the + list of bookmarks and the controls to modify this list.

Figure 26. Edit Bookmarks dialog

4.10. Generating Reports4.10. Generating Reports

4.11. Running Tools4.11. Running Tools

5. Settings5. Settings

To configure 5.1. Usage5.1. Usage

5.1.1. Find5.1.1. Find

5.1.2. Report Preferences5.1.2. Report Preferences

5.1.3. Researcher Information5.1.3. Researcher Information

5.1.4. Data Guessing5.1.4. Data Guessing

5.2. Display5.2. Display

5.2.1. General5.2.1. General

5.2.2. Dates and Calendar5.2.2. Dates and Calendar

5.2.3. Tool and Status Bars5.2.3. Tool and Status Bars

5.3. Database5.3. Database

5.3.1. General5.3.1. General

5.3.2. Media Objects5.3.2. Media Objects

5.3.3. GRAMPS internal IDs internal IDs

5.3.4. Revision Control5.3.4. Revision Control

6. About GRAMPS

GRAMPS was written by Donald N. Allingham - (>). To find more information about Introduction The &app; is a genealogical - application. &app; is an acronym for the + application. &app; is an acronym for the Genealogical Research and Analysis Management Programming System. To put it shortly, it allows you to store, edit, and research genealogical data using your computer. Its functionality is somewhat common to other @@ -328,22 +328,22 @@ Progress bar. The progress bar is located in the lower left corner - of the &app; window. It displays the + of the &app; window. It displays the progress of time consuming operations, such as opening and saving large data bases, importing and exporting to other formats, generating web-sites, etc. Statusbar. The statusbar is located to the right of the progress - bar, on the very bottom of the &app; window. + bar, on the very bottom of the &app; window. It displays information about current &app; activity and contextual information about the menu items. The behavior of the Status line can be adjusted in Preferences dialog. Display area. - The largest are in the center of the - &app; window is the display area. + The largest area in the center of the + &app; window is the display area. It shows certain aspects of genealogical information, depending on the currently selected View. There are six Views available in &app;: , @@ -417,8 +417,8 @@ When &app; opens a database, the View is set to the People View. People View lists individuals whose data is stored in the database. People View displays people's - Names, &app; - ID numbers, Gender, and + Names, &app; ID numbers, + Gender, and their Birth and Death dates. The list can be ordered by any field. @@ -487,7 +487,7 @@ database, &app; checks for the stored Family names and breaks the people list into sublists based on the first letter of their name. The alphabetical tabs are displayed in - the bottom part of the &app; window. + the bottom part of the &app; window. The last tab, Other, stands for unidentified characters -- all the entries not assigned to any other tab end up in Other. In particular, people with no family @@ -740,12 +740,11 @@ Importing GEDCOM Data Importing GEDCOM data allows you to incorporate the data created in - other genealogical programs into your currently - open &app; database. + other genealogical programs into your currently open &app; database. &app; can import GEDCOM data files from a number of software packages, as long as they comply with GEDCOM standards. To import GEDCOM file, choose File - ImportImport from + ImportImport from GEDCOM. You will then be prompted with the Open File dialog asking to specify the GEDCOM file name. @@ -768,11 +767,11 @@ Exporting GEDCOM Data - Exporting GEDCOM data allows you to share any portion of you - &app; database with other researchers + Exporting GEDCOM data allows you to share any portion of your + &app; database with other researchers by way of standard GEDCOM files. To export into GEDCOM file, choose File - Export + Export Export to GEDCOM. The following Export GEDCOM file dialog will appear. @@ -820,12 +819,12 @@ Importing and Exporting &app; Packages &app; provides a way to make your - &app; database completely portable. This might + &app; database completely portable. This might prove useful, for instance, when you need to move your database to another machine or to share it with somebody, while retaining all the features provided by &app;. To accomplish this, choose File - Export + Export Export to GRAMPS Package. The GRAMPS Package Export window will appear. Type the desired package name into the text entry area or click @@ -835,9 +834,8 @@ gramps database, all local media objects, and copies of all external media objects. - To import data from such a package into your - &app; database, choose - FileImport + To import data from such a package into your &app; database, choose + FileImport Import from GRAMPS, then select a package to be imported from the Import from GRAMPS dialog. @@ -1001,7 +999,9 @@ Editing Data: Complete Description - + This section provides a complete description of all editing + options for all pieces of data in the &app; database. + Edit Personal Information @@ -2145,40 +2145,153 @@ - Navigation - + As long as any database is open, + &app; is focused on a + single person usually referred to as an Active person. This + allows you to view or modify the data concerning this person, + his or her immediate family, etc. Navigating in the databse (i.e. + moving from person to person) is in fact nothing else but changing + the Active person. This section describes many alternative ways + to navigate through the database using complex and convenient + interface &app; provides. All these ways + eventually accomplish the same thing, but some are more convenient + than others, depending what you are doing in + &app; at the moment. - - Setting Default Person - - - - - - Bookmarking People - + + Using People View + The most intuitive way to select an active person is + to use the People View. When in the People View, just select the + name of the desired person from the list by clicking that list + entry. The person you have selected becomes active. The statusbar + updates to reflect the change of the active person. Using Family View - + When in the Family View, you can easily navigate between the + members of the displayed family as follows: + + + To make currently selected spouse the active person, + click double-arrow button to the right of the active person box. + + + To make currently selected parents the active family + (thereby making father the active person and mother the selected + spouse), click right-arrow button to the right of the active person's + parents box. + + To make currently selected spouse's parents + the active family (thereby making father the active person and mother + the selected spouse), click right-arrow button to the right of the + spouse's parents box. + + To make currently selected child the active person, + click left-arrow button to the right of the children box. + + + Using Pedigree View - + Pedigree View also allows you to move along the family tree. + The benefits of this method is that you can see more than one + generation of the family tree. Also, you can jump directly from a + great-grandson to a great-grandfather without going through the + intermediate generations. + + Note that after changing the active person in the Pedigree + View, the display is re-adjusted to show four generations, starting + from a newly selected Active person. When in the Pedigree View, you + can easily navigate between the members of the displayed family tree + as follows: + + + To make any displayed person the active person, + double click the line that connects to the left side of the + corresponding box. + + To make a child of currently active person (if any) + the active person, click the left arrow button to the left of the + corresponding box. If there is more than one child, the button expands + to the menu listing the children to choose from. + + To move the whole family tree one generation back, + click on the corresponding right arrow button on the right-hand side + of the display area. Clicking the upper button will move the tree + along the paternal line. Clicking the lower button will move the + tree along the maternal line. + + Clicking either of these buttons is completely equivalent to + double-clicking the lines connecting to the left of the corresponding + boxes for father and mother. + + + + + + + Setting Default Person + One and only one person in the databse can be selected as the + default person. Once the default person is selected, moving to that + person becomes a matter of a signle click, regardless of which view + you are using at the moment. + + To set the default person, first navigate to that person using + any method you like. Then choose + Settings + Default Person. Once this is + done, you can move to the default person from anywhere in the + database by simply clicking Home on the + toolbar. + + + + + + Bookmarking People + Similarly to the default person, you can bookmark other people + from the database to simplify further navigation. To bookmark a person, + first navigate to that person, then choose + Bookmarks + Add bookmark. To move to that + person from anywhere in the database, choose + Bookmarks + Go to bookmark + Person's name + . + + You can manage your bookmarks by choosing + Bookmarks + Edit bookmarks. This opens + the followingEdit Bookmarks dialog with the + list of bookmarks and the controls to modify this list. + + +

+ Edit Bookmarks dialog + + + Shows Edit Bookmarks dialog. +
+ + + Generating Reports