Difference between revisions of "Gramps 5.1 Wiki Manual - Navigation"

From Gramps
Jump to: navigation, search
m ({{man menu|Go}})
m ({{man menu|Family Trees}})
(40 intermediate revisions by 5 users not shown)
Line 4: Line 4:
 
{{#vardefine:figure|0}}
 
{{#vardefine:figure|0}}
 
{{stub}}<!--May need to merge some of this into Gramps_5.1_Wiki_Manual_-_Main_Window#The_different_Categories or merge the whole page-->
 
{{stub}}<!--May need to merge some of this into Gramps_5.1_Wiki_Manual_-_Main_Window#The_different_Categories or merge the whole page-->
As long as any [[Gramps_Glossary#family_tree|Family Tree]] database is open, Gramps is focused on a single person usually referred to as an [[Gramps_Glossary#active_person|Active Person]]. This allows you to view or modify the data concerning this person, his or her immediate family, etc. [[Gramps_5.1_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Navigating in the Family Tree]] database (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 both the complex and the convenient interfaces Gramps provides. All these ways fundamentally accomplish the same result, but some methods of navigating will be more convenient than others... depending on what you are doing in Gramps at the moment.
+
As long as any [[Gramps_Glossary#family_tree|Family Tree]] database is open, Gramps is focused on a single person usually referred to as an [[Gramps_Glossary#active_person|Active Person]]. This allows you to view or modify the data concerning this person, his or her immediate family, etc. [[Gramps_5.1_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Navigating in the Family Tree]] database (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 both the complex and the convenient interfaces Gramps provides. All these ways fundamentally accomplish the same result, but some methods of navigating will be more convenient than others... depending on what you are doing in Gramps at the moment.
  
 
== Using the People Category ==
 
== Using the People Category ==
Line 24: Line 26:
  
 
== Using the Families Category ==
 
== Using the Families Category ==
{{stub}}
 
  
 
When in the [[Gramps_5.1_Wiki_Manual_-_Categories#Families_Category|Families Category]], you can easily navigate between the displayed families.
 
When in the [[Gramps_5.1_Wiki_Manual_-_Categories#Families_Category|Families Category]], you can easily navigate between the displayed families.
 +
 +
{{stub}}
  
 
== Using the Charts [[File:22x22-gramps-pedigree.png]] Category ==
 
== Using the Charts [[File:22x22-gramps-pedigree.png]] Category ==
Line 54: Line 57:
  
 
== Using Gramplets ==
 
== Using Gramplets ==
 
{{man warn| Image should be changed |Select a up-to-date view eg. from Person Editor's sidebar and bottonbar showing gramplets!.}}
 
  
 
[[File:DashboardCategoryView-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dashboard Category view - with example Gramplets shown]]
 
[[File:DashboardCategoryView-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dashboard Category view - with example Gramplets shown]]
  
On the [[Gramps_5.1_Wiki_Manual_-_Gramplets#Summary_of_Gramplets|Sidebar and bottombar]] you can enable some Gramplets like:
+
On the [[Gramps_5.1_Wiki_Manual_-_Gramplets#The_split-screen_Sidebar_.26_Bottombar|Sidebar and bottombar]], you can add Gramplets to expand your navigation options beyond a single generation's distance. Some examples are:
 
* [[Gramps_5.1_Wiki_Manual_-_Gramplets#Relatives|Relatives]]
 
* [[Gramps_5.1_Wiki_Manual_-_Gramplets#Relatives|Relatives]]
 
* [[Gramps_5.1_Wiki_Manual_-_Gramplets#Descendants|Descendants]]
 
* [[Gramps_5.1_Wiki_Manual_-_Gramplets#Descendants|Descendants]]
 
* [[Gramps_5.1_Wiki_Manual_-_Gramplets#Pedigree|Pedigree]]
 
* [[Gramps_5.1_Wiki_Manual_-_Gramplets#Pedigree|Pedigree]]
 
* [[Gramps_5.1_Wiki_Manual_-_Gramplets#Fan_Chart|Fan Chart]]  
 
* [[Gramps_5.1_Wiki_Manual_-_Gramplets#Fan_Chart|Fan Chart]]  
Providing the ability to navigate with the relative, descendants or ancestors of the Active Person into the View.
 
  
On the right side of bars are often seen ">" ja<!--? not sure what you are refering to--> "<" buttons which allow navigation between gramplets. Also Arrow down button is possible. By it you can add and remove gramplets and change to default gramplets of category.
+
These examples provide the ability to navigate the Active Person focus with using the perspective of familial relationship... to nearby relatives, descendants or ancestors. Future Gramplets might allow navigating by geographical proximity, [[Addon:DNASegmentMapGramplet|DNA matching]] or some other connection we haven't yet considered.  
  
To click on a link will change the Active Person.
+
The text based Gramplets tend to have names [[#Hotlink_Navigation|hotlinked for navigation]] while the graphical ones may use [[#Contextual_Menu_Navigation|contextual menus]].
 +
<!--
 +
This paragraph is redundant and convoluted. For users who are not familiar with adding Gramplets or switching between them, the introductory text is linked.  
  
 +
On the right side of bars are often seen ">" ja "<" buttons which allow navigation between gramplets. Also Arrow down button is possible. By it you can add and remove gramplets and change to default gramplets of category.
 +
-->
 
{{-}}
 
{{-}}
  
Line 79: Line 83:
  
 
* [[Gramps_5.1_Wiki_Manual_-_Settings#Setting_Home_person|Settings#Setting Home Person]]
 
* [[Gramps_5.1_Wiki_Manual_-_Settings#Setting_Home_person|Settings#Setting Home Person]]
 +
* On the [[Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person dialog]] you can select "Make Home Person" from the context menu.
  
 
== Setting the Active Person ==
 
== Setting the Active Person ==
  
The Active Person is expected to be the contextual focus of actions, reports and edits.
+
The [[Gramps_Glossary#active_person|Active Person]] is expected to be the contextual focus of actions, reports and edits.
 +
 
 +
There is a selection highlight as a visual cue of the Active Person in the People View. In the Relationship View, the Active Person is shown in a separate section at the top. All other persons shown below have an immediate (parent, sibling, spouse, child) relationship with the Active Person.
 +
 
 +
===Hotlink Navigation===
 +
Normally, simply clicking on the hotlinked name of a Person will select that person and shift this Active Person contextual focus.
  
There is a selection highlight as a visual cue of the Active Person in the People View. In the Relationship View, the Active Person is shown in a separate section at the top. All other persons shown below have an immediate (parent,sibling, spouse, child) relationship with the Active Person.  
+
[[File:Relationships-category-view-51.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view]]Each Person's name in the Person and Relationship category views is a hotlink. Changing the Active Person focus in Person view appears to merely change which record is highlighted. But this also causes Gramplets contents to be updated and the Relationship, Charts & Geography views to be re-focused on the new Active Person.  
  
Normally, simply clicking on the hotlinked name of a Person will select that person and shift this contextual focus.
+
Selecting a different hotlinked name in the Relationship category view causes a less subtle change.  The perspective of how the family data is represented changes towards that focus. Their details move to the top section and their immediate family are re-arranged below.
  
However, hotlinked names in the References tab and Notes (and in some Gramplets) will open the Person Editor window without navigating the Active Person focus to that Person. (As though you had clicked an {{icon|stock_edit}}{{man button|Edit}} button instead of a hotlinked name.) This  facilitates quickly editing Persons around the Active Person without the confusion of a shifting focus.
 
  
The Active Person focus can be set while in the Person Editor by right-clicking in the white space of the header area. A option in that pop-up menu allows the Person to be set as the Active Person focus.
+
{{-}}
 +
 
 +
===Contextual Menu Navigation===
 +
However, hotlinked names in the References tab and Notes (and in some Gramplets) will merely open the Person Editor window ''without'' navigating the Active Person focus to that Person. (These links behave as though you had clicked an {{icon|stock_edit}}{{man button|Edit}} button instead of a hotlinked name.) This  facilitates quickly editing Persons around the Active Person without the disorientation of a shifting focus.
  
 +
[[File:QuickViewReport-EditPerson-context-menu-popup-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Context menu on the Person editor]]
 +
The Active Person focus can be set while in the [[Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person dialog]] by using the context menu (right-clicking) in the empty space of the header area. The {{Man menu|Make Active Person}} option in that context menu changes the Active Person focus to the Person being edited.
 +
<!-- redundant paragraph
 
The focus can also be changed to a Recent individual (with the Forward/Back & Go menu selections), a Person who been added to the Bookmark menu, or to the Home Person.
 
The focus can also be changed to a Recent individual (with the Forward/Back & Go menu selections), a Person who been added to the Bookmark menu, or to the Home Person.
 +
--≥
 +
<!--
 +
These commented out bullet items are confusing. Are they intended as a 'See also' subsection?
 +
 +
In the 1st bullet, Active Person isn't a 'Category' by Gramps' definition nor MediaWiki's. The linked 'Active Person' section of wiki doesn't seem to be relevant to the section subject of navigating the Active Person focus. The target section header ('Active Person') appears in appropriately named. It should be renamed to disambiguate -- a part of a dialog should NOT be called 'Active Person'.
 +
The 2nd bullet is redundant given the previous paragraph & is a discontinuity. The hotlink COULD be moved to the 1st time the 'Person Editor' is mentioned in the section.
  
 
* Categories: [[Gramps_5.1_Wiki_Manual_-_Categories#Active_Person|Active Person]]
 
* Categories: [[Gramps_5.1_Wiki_Manual_-_Categories#Active_Person|Active Person]]
 +
* On the [[Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person dialog]] you can select "Make Active Person" from the context menu.
 +
-->
  
== Using history-based tools ==
+
{{-}}
 +
 
 +
=== Using history-based Navigation ===
 
{{stub}}
 
{{stub}}
 
[[File:History-based-navigation-tools-50.png|thumb|400px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example of the history based navigation tools]]
 
[[File:History-based-navigation-tools-50.png|thumb|400px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example of the history based navigation tools]]
Line 103: Line 128:
  
 
They include {{man label|Back}} and {{man label|Forward}} items available from the {{man label|Go}} menu, context menus (available in People, Family, and Pedigree Categories), and the toolbar buttons. They also include the list of the recent selections available under the {{man label|Go}} menu that allows you to jump directly to any of the recent selections. Finally, right-clicking on the {{man button|< Back}} and {{man button|Forward >}} toolbar buttons invokes the popup menu with corresponding portion of the history. Select any item from the menu to jump directly to it.
 
They include {{man label|Back}} and {{man label|Forward}} items available from the {{man label|Go}} menu, context menus (available in People, Family, and Pedigree Categories), and the toolbar buttons. They also include the list of the recent selections available under the {{man label|Go}} menu that allows you to jump directly to any of the recent selections. Finally, right-clicking on the {{man button|< Back}} and {{man button|Forward >}} toolbar buttons invokes the popup menu with corresponding portion of the history. Select any item from the menu to jump directly to it.
 +
{{-}}
  
 +
=== Bookmark Navigation ===
  
{{-}}
+
[[File:Gramps Go-Home48x48 win.png|right]]
 
+
The Home button on the toolbar is a special case bookmark. It shifts the Active Person focus to the Person currently designated as the [[Gramps_Glossary#Home_Person|Home Person]]. This is so frequently useful that this feature also has a [[Gramps_5.1_Wiki_Manual_-_Keybindings#Common_keybindings|keybinding]].
== Bookmarks ==
 
  
Similar to setting the Home person, you can bookmark other people from the database to simplify further navigation. To bookmark a person, first navigate to that person, then choose the menu {{man menu|Bookmarks ->Add Bookmark}}. To move to that person elsewhere in the database, choose the menu {{man menu|Bookmarks ->'''Person's name'''}} from the list of bookmarked names shown. The other categories have their own list of Bookmarks.
+
Similar to setting the Home Person, you can bookmark other people from the database to simplify further navigation. To bookmark a person, first navigate to that person, then choose the menu {{man menu|Bookmarks ->Add Bookmark}}. To move to that person elsewhere in the database, choose the menu {{man menu|Bookmarks ->'''Person's name'''}} from the list of bookmarked names shown. The other categories have their own list of Bookmarks.
  
 
[[File:Organizebookmarks-50.png|thumb|350px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Organize Bookmarks]]
 
[[File:Organizebookmarks-50.png|thumb|350px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Organize Bookmarks]]
Line 123: Line 149:
 
{{-}}
 
{{-}}
  
== Notes as Navigational Shortcuts ==
+
=== Notes as Navigational Shortcuts ===
 
[[File:NoteLinkingHints.png|thumb|right|235px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Notes Editor - Linking text]]
 
[[File:NoteLinkingHints.png|thumb|right|235px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Notes Editor - Linking text]]
 
There are separate Bookmarks lists in several categories.  But they are still just simple lists. Long lists of bookmarks quickly become unwieldy.   
 
There are separate Bookmarks lists in several categories.  But they are still just simple lists. Long lists of bookmarks quickly become unwieldy.   
Line 137: Line 163:
 
== Finding records ==
 
== Finding records ==
  
{{man tip|Finding People|For more complex people searches you may want to use filters. Enable filter controls by choosing menu {{man menu|View -> Sidebar}}, select the desired filter, and click {{man button|Find}}. For details, see [[Gramps_5.1_Wiki_Manual_-_Filters|Filters]].}}
+
{{man tip|Finding People|You may want to first apply search filters to reduce the size of the list. The [[Gramps_5.1_Wiki_Manual_-_Main_Window#Search_Bar|search bar]] can be used for single term searches when the gramplets sidebar is not enabled. For more complex searches, gain access to the multiple term filter controls by enabling the gramplet sidebar (by choosing the {{man menu|View -> Sidebar}} menu) and choosing the Filter gramplet tab. Select the desired filter and click {{man button|Find}}. For details, see [[Gramps_5.1_Wiki_Manual_-_Filters|Filters]].}}
  
 
[[File:Find-people-list-view-typeahead-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find people list view using Interactive search type ahead - example]]
 
[[File:Find-people-list-view-typeahead-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find people list view using Interactive search type ahead - example]]
  
To find a record in a database, first switch to the appropriate Category that provides the list of the desired records: People, Sources, Places, or Media. Then start typing the name of a person or the title of a Source, Place, or Media object that you are looking for, respectively. You may also press {{man key press|CTRL|F}} to turn on the search mode, but simply starting to type is also enough.
+
To find a record in one of the category list views, first switch to the appropriate category that provides the list of the desired records: People, Sources, Places, or Media. Select a line in the list to gain focus and then start typing the name of a person or the title of a Source, Place, or Media object that you are looking for, respectively.  
 +
 
 +
Alternatively, select a line in the list to gain focus and then you may press {{man key press|CTRL|F}} to turn on the search mode textbox. However, simply starting to type is also enough to both open the box and start entering the search term.
  
As you type, the first record in the list that is compatible with your input will be selected.
+
As you type, the first matching record in the sort column of the list will scroll to the center of the list and be selected. As you type more characters, the match will be refined. As long as the search mode text box is visible, pressing the {{man key press|&#11015;}} down arrow cursor key will move to the next match while pressing the {{man key press| &#11014;}} up arrow cursor control key will move to the previous match. The box disappears after it is idle. (When there have been no keystrokes for between 5 and 15 seconds.) Without the Find box active, the cursor control keys revert to moving the records selection up and down the list.
 +
 
 +
Changing the sort column (by clicking on the header) also changes the column being matched. 
 
{{-}}
 
{{-}}
  
Line 149: Line 179:
  
 
{{man note|Not your ordinary Clipboard|Note, that the Gramps Clipboard doesn't work anything like a standard computer clipboard. It works like a real clipboard in that you drag things onto it, and drag-copy them off.}}
 
{{man note|Not your ordinary Clipboard|Note, that the Gramps Clipboard doesn't work anything like a standard computer clipboard. It works like a real clipboard in that you drag things onto it, and drag-copy them off.}}
{{man warn|Warning|{{man label|Clipboard}} storage is persistent within a single Gramps session. Closing the {{man label|Clipboard}} window will not lose the stored records. However, exiting Gramps will.<br><br>{{man menu|If you do need to save items between sessions there is a Third-party Addon [[ClipboardGramplet|Clipboard Gramplet]] that does.}}}}
+
{{man warn|Warning|{{man label|Clipboard}} storage is persistent within a single Gramps session. Closing the {{man label|Clipboard}} window will not lose the stored records. However, exiting Gramps will.<br><br>{{man menu|If you do need to save items between sessions there is a Third-party Addon [[Collections Clipboard Gramplet]] that does.}}}}
  
 
[[File:Clipboard-dialog-example-context-menu-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clipboard - dialog - Showing Context menu (right click) example]]
 
[[File:Clipboard-dialog-example-context-menu-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clipboard - dialog - Showing Context menu (right click) example]]
Line 195: Line 225:
 
[[File:Menubar-FamilyTrees-overview-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example]]
 
[[File:Menubar-FamilyTrees-overview-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example]]
  
*{{man menu|Manage Family Trees...}} -  
+
*{{man menu|Manage Family Trees...}} - open the [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Family_Trees_manager_window|Family Tree Manager Window]]
*{{man menu|Open Recent}} -  
+
*{{man menu|Open Recent}} - a shortcut to opening a recently worked on Family Tree
*{{man menu|Close}} -  
+
*{{man menu|Close}} - backup and close the current Tree
 
<hr>
 
<hr>
*{{man menu|Import...}} - Bring in data from other [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Importing_data|formats]].
+
*{{man menu|Import...}} - Bring in data from other [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Importing_data|formats]].<br />''Make a Backup before importing! There are [[Gramps_5.1_Wiki_Manual_-_Settings#General_Gramps_settings|import Preferences]] to mark imported data with timestamped [[Gramps_Glossary#tag|Tag]] and/or [[Gramps_Glossary#source|Source]] attributes. These options dramatically slow the Import process but are helpful for the ensuing data cleanup.''
 
*{{man menu|Export...}} - [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|Exporting data]] allows you to share any portion of your Gramps Family Tree with other researchers as well as to enable you to transfer your data to another computer.  
 
*{{man menu|Export...}} - [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|Exporting data]] allows you to share any portion of your Gramps Family Tree with other researchers as well as to enable you to transfer your data to another computer.  
 
<hr>
 
<hr>
 
*{{man menu|[[Gramps_5.1_Wiki_Manual_-_Settings#Export_View|Export View...]]}} - Menu only appears on most Views, if the displayed data can be exported. Gramps will export data on screen according your choice: '''CSV''' or '''Open Document''' spreadsheet format.
 
*{{man menu|[[Gramps_5.1_Wiki_Manual_-_Settings#Export_View|Export View...]]}} - Menu only appears on most Views, if the displayed data can be exported. Gramps will export data on screen according your choice: '''CSV''' or '''Open Document''' spreadsheet format.
 
<hr>
 
<hr>
*{{man menu|Make Backup...}} - Allows you to make a [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Full Gramps XML backup]] of your currently opened Family Tree.
+
*{{man menu|Make Backup...}} - Allows you to make a [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Full Gramps XML backup]] of your currently opened Family Tree. Note [[Template:Backup_Omissions|some configuration and Media items are omitted]] from XML backups.
 
<hr>
 
<hr>
 
*{{man menu|Abandon Changes and Quit...}} -  
 
*{{man menu|Abandon Changes and Quit...}} -  
Line 214: Line 244:
 
[[File:Menubar-Add-New-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - Add Overview]]
 
[[File:Menubar-Add-New-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - Add Overview]]
  
*{{man menu|Add}} - a new object also see keybindings.
+
*{{man menu|Add}} - a new [[Gramps_Glossary#primary_object|object]]<br />also see [[Gramps_5.1_Wiki_Manual_-_Keybindings|keybindings]].
 
<hr>
 
<hr>
*{{man menu|Person}} -  
+
*{{man menu|Person}} - adds a {{icon|peop}}[[Gramps_Glossary#person|Person]] ''([[Gramps_Glossary#primary_object|prim. obj.]])''
*{{man menu|Family}} -  
+
*{{man menu|Family}} - adds a {{icon|fami}}[[Gramps_Glossary#family|Family]] ''([[Gramps_Glossary#primary_object|prim. obj.]])'' - Brings up the {{man label|[[Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor dialog]]}}
*{{man menu|Event}} -  
+
*{{man menu|Event}} - adds an {{icon|even}}[[Gramps_Glossary#event|Event]] ''([[Gramps_Glossary#primary_object|prim. obj.]])''
*{{man menu|Place}} -  
+
*{{man menu|Place}} - adds a {{icon|plac}}[[Gramps_Glossary#place|Place]] ''([[Gramps_Glossary#primary_object|prim. obj.]])''
*{{man menu|Source}} -  
+
*{{man menu|Source}} - adds a {{icon|sour}}[[Gramps_Glossary#source|Source]] ''([[Gramps_Glossary#primary_object|prim. obj.]])''
*{{man menu|Citation}} -  
+
*{{man menu|Citation}} - adds a {{icon|medi}}[[Gramps_Glossary#media|Media]] ''([[Gramps_Glossary#primary_object|prim. obj.]])''
*{{man menu|Repository}} -  
+
*{{man menu|Repository}} - adds a {{icon|repo}}[[Gramps_Glossary#repository|Repository]] ''([[Gramps_Glossary#primary_object|prim. obj.]])''
*{{man menu|Media}} -  
+
*{{man menu|Media}} - adds a {{icon|medi}}[[Gramps_Glossary#media|Media]] ''([[Gramps_Glossary#primary_object|prim. obj.]])''
*{{man menu|Note}} -  
+
*{{man menu|Note}} - adds a {{icon|note}}[[Gramps_Glossary#note|Note]] ''([[Gramps_Glossary#primary_object|prim. obj.]])''
 
<hr>
 
<hr>
 
{{-}}
 
{{-}}
Line 269: Line 299:
 
<hr>
 
<hr>
 
* Dynamic list of the most recent 10 records (People, Families, et cetera) selected, the List is dependent on the Category view being viewed.
 
* Dynamic list of the most recent 10 records (People, Families, et cetera) selected, the List is dependent on the Category view being viewed.
{{man warn|1=Known bug [https://github.com/gramps-project/gramps/pull/907 patch] for Gramps version 5.1.1|2=Fixes 'Go' menu selection scramble caused by recent UIManager upgrade<br />addresses Bug Report: {{bug|11341}} on 24 Sept 2019}}  
+
{{man warn|1=Known bug [https://github.com/gramps-project/gramps/pull/907 patch] for Gramps version 5.1.1(Fixed in Version 5.1.2)|2=Fixes 'Go' menu selection scramble caused by recent UIManager upgrade<br />addresses Bug Report: {{bug|11341}} on 24 Sept 2019}}  
A portion of the Go menu can be made to persist between restarts of Gramps with the
+
{{man tip|You can use the third party RestoreHist [[5.1_Addons|addon]]|So that a portion of the Go menu can be made to persist between restarts of Gramps. If installed then you can manually clear the stored state by finding and deleting /gramps51/plugins/RestoreHist/hist_save.ini  file from the [[Gramps_5.1_Wiki_Manual_-_User_Directory|user folder]] (the ~.gramps folder or %Appdata% folder in Windows).}}
RestoreHist [[5.1_Addons|addon]]. You can manually clear the stored state by finding and deleting /gramps51/plugins/RestoreHist/hist_save.ini  file from the [[Gramps_5.1_Wiki_Manual_-_User_Directory|user folder]] (the ~.gramps folder or %Appdata% folder in Windows).
 
  
 
{{-}}
 
{{-}}
Line 292: Line 321:
 
<hr>
 
<hr>
 
*{{man menu|Graphs...}} -  
 
*{{man menu|Graphs...}} -  
**{{man menu|Family Lines Graph...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines Graph...]]}}  
**{{man menu|Hourglass Graph...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_5#Hourglass_Graph|Hourglass Graph...]]}}
**{{man menu|Relationship Graph...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship Graph...]]}}
 
*{{man menu|Graphical Reports...}} -  
 
*{{man menu|Graphical Reports...}} -  
**{{man menu|Ancestor Tree...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Ancestor_Tree|Ancestor Tree...]]}}
**{{man menu|Calendar...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Calendar|Calendar...]]}}
**{{man menu|Descendant Tree...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Descendant_Tree|Descendant Tree...]]}}
**{{man menu|Family Descendant Tree...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Family_Descendant_Tree|Family Descendant Tree...]]}}
**{{man menu|Fan Chart...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Fan_Chart|Fan Chart...]]}}
**{{man menu|Statistics Charts...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Statistics_Charts|Statistics Charts...]]}}
**{{man menu|Timeline Chart...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Timeline_Chart|Timeline Chart...]]}}
 
*{{man menu|Text Reports...}} -  
 
*{{man menu|Text Reports...}} -  
**{{man menu|Ahnentafel Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report...]]}}
**{{man menu|Birthday and Anniversary Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Birthday_and_Anniversary_Report|Birthday and Anniversary Report...]]}}
**{{man menu|Complete Individual Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Complete_Individual_Report|Complete Individual Report...]]}}
**{{man menu|Database Summary Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Database_Summary_Report|Database Summary Report...]]}}
**{{man menu|Descendant Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Descendant_Report|Descendant Report...]]}}
**{{man menu|Detailed Ancestral Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Detailed_Ancestral_Report|Detailed Ancestral Report...]]}}
**{{man menu|Detailed Descendant Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Detailed_Descendant_Report|Detailed Descendant Report...]]}}
**{{man menu|End of Line Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#End_of_Line_Report|End of Line Report...]]}}
**{{man menu|Family Group Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Family_Group_Report|Family Group Report...]]}}
**{{man menu|Kinship Report...}} -  
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Kinship_Report|Kinship Report...]]}}
**{{man menu|Number of Ancestors Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Note_Link_Report|Note Link Report...]]}}
**{{man menu|Places Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Number_of_Ancestors_Report|Number of Ancestors Report...]]}}
**{{man menu|Records Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Place_Report|Places Report...]]}}
**{{man menu|Tag Report...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Records_Report|Records Report...]]}}
 +
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_6#Tag_Report|Tag Report...]]}}
 
*{{man menu|Web Pages...}} -  
 
*{{man menu|Web Pages...}} -  
**{{man menu|Narrated Web Site...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_7#Narrated_Web_Site|Narrated Web Site...]]}}
**{{man menu|Web Calendar...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_7#Web_Calendar|Web Calendar...]]}}
 
{{-}}
 
{{-}}
  
Line 329: Line 359:
  
 
*{{man menu|Analysis and Exploration}} -  
 
*{{man menu|Analysis and Exploration}} -  
**{{man menu|Compare Individual Events...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Compare_Individual_Events|Compare Individual Events...]]}}
 
**{{man menu|Interactive Descendant Browser...}} -  
 
**{{man menu|Interactive Descendant Browser...}} -  
 
*{{man menu|Debug}} -  
 
*{{man menu|Debug}} -  
**{{man menu|Check Localized Date Display and Parser...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Check_Localized_Date_Displayer_and_Parser|Check Localized Date Display and Parser...]]}}
**{{man menu|Dump Gender Statistics...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics...]]}}
**{{man menu|Generate Testcases for Persons and Families...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Generate_Testcases_for_Persons_and_Families|Generate Testcases for Persons and Families...]]}}
**{{man menu|Populate Sources and Citations...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Populate_Sources_and_Citations|Populate Sources and Citations...]]}}
 
**{{man menu|Python Evaluation Window...}} -  
 
**{{man menu|Python Evaluation Window...}} -  
 
**{{man menu|Show Uncollected Objects...}} -  
 
**{{man menu|Show Uncollected Objects...}} -  
 
*{{man menu|Family Tree Processing}} -  
 
*{{man menu|Family Tree Processing}} -  
**{{man menu|Edit Database Owner Information...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information...]]}}
**{{man menu|Extract Event Descriptions...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Extract_Event_Description|Extract Event Descriptions...]]}}
**{{man menu|Extract Information from Names...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Extract_Information_from_Names|Extract Information from Names...]]}}
**{{man menu|Extract Place Data from Place Title...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Extract_Place_Data_from_a_Place_Title|Extract Place Data from Place Title...]]}}
**{{man menu|Find Possible Duplicate People...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Find_Possible_Duplicate_People|Find Possible Duplicate People...]]}}
**{{man menu|Fix Capitalization of Family Names...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Fix_Capitalization_of_Family_Names|Fix Capitalization of Family Names...]]}}
**{{man menu|Merge Citations...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Merge_citations|Merge Citations...]]}}
**{{man menu|Rename Event Types...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Rename_Event_Types|Rename Event Types...]]}}
**{{man menu|Reorder Gramps IDs...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs...]]}}
**{{man menu|Sorts events...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Sort_Events|Sorts events...]]}}
 
*{{man menu|Family Tree Repair}} -  
 
*{{man menu|Family Tree Repair}} -  
**{{man menu|Check and Repair Database...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database...]]}}
**{{man menu|Rebuild Gender Statistics...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Rebuild_Gender_Statistics|Rebuild Gender Statistics...]]}}
**{{man menu|Rebuild Reference Maps...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Rebuild_Reference_Maps|Rebuild Reference Maps...]]}}
**{{man menu|Rebuild Secondary Indices...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Rebuild_Secondary_Indexes|Rebuild Secondary Indices...]]}}
**{{man menu|Remove Unused Objects...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Remove_Unused_Objects|Remove Unused Objects...]]}}
*{{man menu|Utilities}} -
+
*{{man menu|Utilities}}
**{{man menu|Media Manager...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Media_Manager|Media Manager...]]}}
**{{man menu|Not Related...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Not_Related|Not Related...]]}}
**{{man menu|Relationship Calculator...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator...]]}}  
**{{man menu|Verify the Data...}} -
+
**{{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Verify_the_Data|Verify the Data...]]}}  
 
{{-}}
 
{{-}}
  
Line 377: Line 407:
 
*{{man menu|Key Bindings}} - A link to the [[Gramps 5.1 Wiki Manual - Keybindings|Keybindings reference]] for Gramps. Also known as Keyboard shortcuts.
 
*{{man menu|Key Bindings}} - A link to the [[Gramps 5.1 Wiki Manual - Keybindings|Keybindings reference]] for Gramps. Also known as Keyboard shortcuts.
 
*{{man menu|Tip of the Day}} - Displays the "Tip of the day" dialog.
 
*{{man menu|Tip of the Day}} - Displays the "Tip of the day" dialog.
*{{man menu|Plugin Manager}} - From this menu you can manage the built in plugins as well as any [[5.1_Addons|Third-Party Addons]] you may have installed.
+
*{{man menu|[[Gramps 5.1 Wiki Manual - Plugin Manager|Plugin Manager]]}} - From this menu you can manage the built in plugins as well as any [[5.1_Addons|Third-Party Addons]] you may have installed.
 
*{{man menu|Gramps Home Page}} - This item opens your web browser and connects to the Gramps project web site.
 
*{{man menu|Gramps Home Page}} - This item opens your web browser and connects to the Gramps project web site.
 
*{{man menu|Gramps Mailing List}} - This item opens your web browser to the Gramps mailing list page. On this page, you can browse the mailing list archives and join the gramps-users mailing list so you can share your experiences with other Gramps user's.
 
*{{man menu|Gramps Mailing List}} - This item opens your web browser to the Gramps mailing list page. On this page, you can browse the mailing list archives and join the gramps-users mailing list so you can share your experiences with other Gramps user's.
*{{man menu|Report a Bug}} - Choose this item to file a [[Using_the_bug_tracker |bug report]] in the Gramps bug tracking system. (Remember, Gramps is a living project. We want to know about any problems you encounter so we can work to solve them for you and everyone elses benefit.)
+
*{{man menu|Report a Bug}} - Choose this item to file a [[Using_the_bug_tracker |bug report]] in the Gramps bug tracking system. (This requires you to have a registered account on the Gramps bug reporting system) (Remember, Gramps is a living project. We want to know about any problems you encounter so we can work to solve them for you and everyone elses benefit.)
 
*{{man menu|Extra Reports/Tools}} - A link to [[5.1_Addons |Installing Third-Party Addons in Gramps]].
 
*{{man menu|Extra Reports/Tools}} - A link to [[5.1_Addons |Installing Third-Party Addons in Gramps]].
  
 
*{{man menu|About}} - This item displays a dialog with general information about the Gramps version you are running.
 
*{{man menu|About}} - This item displays a dialog with general information about the Gramps version you are running.
 +
 +
==Toolbar==
 +
{{stub}}
 +
{{-}}
 +
[[File:ManageDatabases-icon-toolbar-51.png|right|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Manage databases - icon on toolbar (Same as using menu {{man menu|Family Trees ->Manage Family Trees...}})]]
 +
{{-}}
 +
[[File:ConnectToARecentDatabase-icon-toolbar-51.png|right|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Connect to a recent database - icon drop down on toolbar menu {{man menu|Family Trees ->Open Recent...}}]]
 +
{{-}}
 +
[[File:ToolbarIcon-OpenTheToolsDialog-50.png|right|thumb|394px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip for the Tools button of the Dashboard category toolbar]]
 +
{{-}}
  
 
{{-}}
 
{{-}}

Revision as of 01:34, 16 November 2020

Previous Index Next


Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


As long as any Family Tree 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 Family Tree database (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 both the complex and the convenient interfaces Gramps provides. All these ways fundamentally accomplish the same result, but some methods of navigating will be more convenient than others... depending on what you are doing in Gramps at the moment.

Using the People Category

The most intuitive way to select an Active Person is to use the People Category. When in the People Category, 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.

See also

Using the Relationships Category

When in the Relationships Category, you can easily navigate between the members of the displayed family as follows:

Click on the underlined name of the person you want to go to and this person will be the new active person of the Relationships Category.

The name of the currently active person is not underlined.

In addition to this, Gramps provides an extensive set of keyboard navigation options. The detailed reference to the key bindings is found in the Appendix B: Keybindings reference.

Using the Families Category

When in the Families Category, you can easily navigate between the displayed families.

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Using the Charts 22x22-gramps-pedigree.png Category

Timeline Pedigree View - 3rd Party Addon for Chart Category - context menu example

Gramps relies heavily on form-based layouts of linked list items. These imply relationships between records in your family Tree. The Charts Category provides an alternative, more visual, way of representing those relationships. The positions, shapes, and colors of containers along with their connecting lines & arrows can show an extra depth of interrelation with different factors. Containers can be simple color filled boxes, arcs, ribbons, or many other shapes.

But the Charts Category also provides an alternative way to navigate through the family tree. The benefit of this method is that you can see more than one generation of the family tree. So 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 Charts Category, the Chart View is re-adjusted to the newly selected Active Person focus. When in the Charts Category, you can easily navigate between the members of the displayed family tree as follows:

To make any displayed person the Active Person focus, left-click their corresponding container. Right-clicking the container will invoke a context menu with options appropriate to contents.

The a context menu for a Person container may contain ▶sub-menus listing all spouses, siblings, children, and parents of the corresponding Person. The first entry in the context menu will usually be the name of the Person in that container. (It could alternately be an Edit option.) Selecting the Person name will shift focus in the same way as left-clicking the container. You can also change the Active Person focus to any of the spouses, siblings, children, or parents of any displayed person.

Some charts views have an obvious navigational correlation. Moving through generations intuitively matches moving to the left, right, upwards or downwards in the chart. These may have custom directional navigation buttons to allow navigation by clicking rather than dragging.

As an example, to change the focus of the Pedigree ViewCharts to a child (if any exists) of the current Active Person, click the (Left Arrowhead) button to the left of the Active Person’s chart box. If there is only one child, the focus changes immediately. If the Active Person has more than one child, the (Left Arrowhead) button expands with a pop-up menu with a selectable list of the children. (For this particular (Left Arrowhead) button, the pop-up menu list of Children is sorted by that Parent‘s Marriage order, sub-sorted by Birth order. These orders can be changed globally in the Relationships category.)

Tango-Dialog-information.png
Advantages of using context (right-click) menus

Direct access to spouse and siblings. Complete lists of all member of all categories, not only the preferred members.

Like containers, buttons may have alternate features accessed by right-clicking and choosing from a contexual pop-up menu.

Other buttons are less obvious aids to navigating to not People but features of Gramps. Using the Pedigree ViewCharts example again, rolling over the lines between boxes shows a hint with any known basic details about the relationship and double-clicking those lines opens the editor for that Family. And double-clicking the Active Person box opens the editor for that Person. It is well worth reading the detailed documentation on each Chart View to discover these hidden shortcuts to favorite features.

The built-in Views of the Chart Category are introduced in the Categories reference section. Some are described in greater depth in articles listed at the bottom of the View’s introductory section.

The collection of Views in the Charts Category can be expanded with 3rd Party Addons using the Plug-in Manager feature of Gramps. The available 3rd Party Addon plug-ins can be found under the View column of the list of Addons table. The maintenance of a few 3rd Party Addon Views has been adopted by the Gramps volunteer team over the years. These became 'built-in' after being vetted and then included in the main Gramps distributions. Articles about using each Addon View are linked to the label Plugin/Documentation column. The quality of documentation varies dramatically for these articles.

Using Gramplets

Fig. 8.1 Dashboard Category view - with example Gramplets shown

On the Sidebar and bottombar, you can add Gramplets to expand your navigation options beyond a single generation's distance. Some examples are:

These examples provide the ability to navigate the Active Person focus with using the perspective of familial relationship... to nearby relatives, descendants or ancestors. Future Gramplets might allow navigating by geographical proximity, DNA matching or some other connection we haven't yet considered.

The text based Gramplets tend to have names hotlinked for navigation while the graphical ones may use contextual menus.

Setting the Home Person

One (and only one) person in the Family Tree database can be designated as the Home Person. Once the Home Person is designated, returning the Active Person focus to that person becomes a matter of a single click, regardless of which Category is being used at the moment.

To set the Home Person, first navigate to that person using any method you like. Then choose the People category and select the menu Edit ->Set Home Person. Once this is done, you can move to the Home Person from anywhere in the database by simply clicking the Toolbar Home icon. You can also choose the menu Go ->Home or select Home item from any context menu available on the right click or use the keyboard shortcut Alt+Home.

Setting the Active Person

The Active Person is expected to be the contextual focus of actions, reports and edits.

There is a selection highlight as a visual cue of the Active Person in the People View. In the Relationship View, the Active Person is shown in a separate section at the top. All other persons shown below have an immediate (parent, sibling, spouse, child) relationship with the Active Person.

Hotlink Navigation

Normally, simply clicking on the hotlinked name of a Person will select that person and shift this Active Person contextual focus.

Fig. 8.2 Relationships Category view

Each Person's name in the Person and Relationship category views is a hotlink. Changing the Active Person focus in Person view appears to merely change which record is highlighted. But this also causes Gramplets contents to be updated and the Relationship, Charts & Geography views to be re-focused on the new Active Person.

Selecting a different hotlinked name in the Relationship category view causes a less subtle change. The perspective of how the family data is represented changes towards that focus. Their details move to the top section and their immediate family are re-arranged below.



Contextual Menu Navigation

However, hotlinked names in the References tab and Notes (and in some Gramplets) will merely open the Person Editor window without navigating the Active Person focus to that Person. (These links behave as though you had clicked an STOCK_EDITEdit button instead of a hotlinked name.) This facilitates quickly editing Persons around the Active Person without the disorientation of a shifting focus.

Fig. 8.3 Context menu on the Person editor

The Active Person focus can be set while in the Edit Person dialog by using the context menu (right-clicking) in the empty space of the header area. The Make Active Person option in that context menu changes the Active Person focus to the Person being edited.


Using history-based Navigation

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Fig. 8.4 Example of the history based navigation tools

Gramps also features a powerful set of history-based navigation tools. These tools are similar to those commonly used in web browsers.

They include Back and Forward items available from the Go menu, context menus (available in People, Family, and Pedigree Categories), and the toolbar buttons. They also include the list of the recent selections available under the Go menu that allows you to jump directly to any of the recent selections. Finally, right-clicking on the < Back and Forward > toolbar buttons invokes the popup menu with corresponding portion of the history. Select any item from the menu to jump directly to it.

Bookmark Navigation

Gramps Go-Home48x48 win.png

The Home button on the toolbar is a special case bookmark. It shifts the Active Person focus to the Person currently designated as the Home Person. This is so frequently useful that this feature also has a keybinding.

Similar to setting the Home Person, you can bookmark other people from the database to simplify further navigation. To bookmark a person, first navigate to that person, then choose the menu Bookmarks ->Add Bookmark. To move to that person elsewhere in the database, choose the menu Bookmarks ->Person's name from the list of bookmarked names shown. The other categories have their own list of Bookmarks.

Fig. 8.5 Organize Bookmarks

You can manage your bookmarks by choosing the menu Bookmarks ->Organize bookmarks... or keybinding Shift+CTRL+D. This opens the Organize Bookmarks dialog with the list of bookmarks and the controls to modify this list.

Use the Up and Down buttons to change the list sequence. Use the Remove button to remove a Bookmark. The Help will bring you to this page, and you close the Organize Bookmarks window with the Close button.

The list of Bookmarked People can be selected through the People Category, as explained above, but is also shared with the Relationships and Charts Categories.

On a similar basis, separate lists of Bookmarks are maintained in each of the following Categories: Families, Events, Places, Sources, Citations, Repositories, Media, and Notes.


Notes as Navigational Shortcuts

Fig. 8.6 Notes Editor - Linking text

There are separate Bookmarks lists in several categories. But they are still just simple lists. Long lists of bookmarks quickly become unwieldy.

Persistent Links can be created in Notes. Use the Link Editor in Notes to organize navigation links to different types of Gramps records following to your own organization methods. Once a Note has linked text, that linked record can be used like a Bookmark. Navigate to that record by holding the CTRL key and clicking on the Linked Text. One note be used as a Linked Index to other Notes with different sets of Links.

An example of a linked note might include an obituary where all the Persons, Places or even the Events are Linked. This makes it easier to navigate to the indirectly related (or even unrelated) pallbearers, funeral officiants, or attendees.

Another note might be the transcribed bibliography for the published original research of another genealogist. As you collect digital copies of those originally cited references, the linked bibliography can be used as a Source acquisition checklist. When completely Linked, the Bibliography can be use to navigate through Sources for each citation while searching for unsupported conclusions, inaccuracies or omissions.


Finding records

Tango-Dialog-information.png
Finding People

You may want to first apply search filters to reduce the size of the list. The search bar can be used for single term searches when the gramplets sidebar is not enabled. For more complex searches, gain access to the multiple term filter controls by enabling the gramplet sidebar (by choosing the View -> Sidebar menu) and choosing the Filter gramplet tab. Select the desired filter and click Find. For details, see Filters.


Fig. 8.7 Find people list view using Interactive search type ahead - example

To find a record in one of the category list views, first switch to the appropriate category that provides the list of the desired records: People, Sources, Places, or Media. Select a line in the list to gain focus and then start typing the name of a person or the title of a Source, Place, or Media object that you are looking for, respectively.

Alternatively, select a line in the list to gain focus and then you may press CTRL+F to turn on the search mode textbox. However, simply starting to type is also enough to both open the box and start entering the search term.

As you type, the first matching record in the sort column of the list will scroll to the center of the list and be selected. As you type more characters, the match will be refined. As long as the search mode text box is visible, pressing the down arrow cursor key will move to the next match while pressing the up arrow cursor control key will move to the previous match. The box disappears after it is idle. (When there have been no keystrokes for between 5 and 15 seconds.) Without the Find box active, the cursor control keys revert to moving the records selection up and down the list.

Changing the sort column (by clicking on the header) also changes the column being matched.

Using the Clipboard

Gramps-notes.png
Not your ordinary Clipboard

Note, that the Gramps Clipboard doesn't work anything like a standard computer clipboard. It works like a real clipboard in that you drag things onto it, and drag-copy them off.

Gnome-important.png
Warning

Clipboard storage is persistent within a single Gramps session. Closing the Clipboard window will not lose the stored records. However, exiting Gramps will.

If you do need to save items between sessions there is a Third-party Addon Collections Clipboard Gramplet that does.

Fig. 8.8 Clipboard - dialog - Showing Context menu (right click) example


For an application like Gramps the Clipboard is very important as it will help reduce repetitive data entry.

The Clipboard tool provides a temporary notepad to store database records for easy reuse during a single Gramps session eg: until you exit Gramps. In short, this is a sort of the copy-and-paste functionality extended from textual objects to other types of records used in Gramps. Clipboard makes extensive use of the drag and drop technique

To invoke the Clipboard, either choose the menu Edit->Clipboard or click the Toolbar Clipboard button or use the Keyboard shortcut (accelerator key) CTRL+B.


Clipboard supports addresses, attributes (both personal and family), events (both personal and family), names, media objects references, citations, URLs, and of course textual information of notes and comments. To store any type of these records, simply drag the existing record on to the Clipboard Pad from the corresponding editor dialog. To reuse the record, drag it from the Clipboard on to the corresponding place in the editor, e.g. Address tab, Attribute tab, etc.

Tango-Dialog-information.png
Tip

Some objects show a link icon in the left column. This indicates that dragging such selection will produce a reference to an existing object, not copy the object itself. For example, the media object file will not be duplicated. Instead, the reference will be made to an existing media object, which will result in the local gallery entry.


Selecting a record using the the context menu (right click) will show the following three options for each record type:

  • See the [RECORD TYPE] details
  • Make the [RECORD TYPE] active
  • Create Filter from the [RECORD TYPE] selected


One example
You find a birth certificate of a person. In this certificate also the witnesses are mentioned. And the birth certificate also determines a source where the information was stored. The best way is to open the clipboard and drag the source you want to work with there. Then use drag and drop to use it in new items you use.

Now you can finalize the information on the person editor screen. Drag that info also to the Clipboard.

Now you add two new persons for the witnesses (assuming you do not have them already in your database). Simply drag and drop the birth info to the witness event screen. You are then presented with the screen where you can change the role of the witness to witness for this birth event. You do the same with the other witness.

This saves you a lot of typing and possible errors.

Main Menus

Fig. 8.9 Menubar - Main Menu Overview - No Family Tree Loaded
Fig. 8.10 Menubar - Main Menu Overview - Family Tree Loaded
Fig. 8.11 Menubar - Main Menu Overview - Family Tree Loaded showing "Active" and "Windows" menu entries in use

The MenuBar shows the available Gramps Menus that change and appear depending on the Category used eg: Edit / View.

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.



Family Trees

Fig. 8.12 Menubar - "Family Trees" - overview example
  • Manage Family Trees... - open the Family Tree Manager Window
  • Open Recent - a shortcut to opening a recently worked on Family Tree
  • Close - backup and close the current Tree

  • Import... - Bring in data from other formats.
    Make a Backup before importing! There are import Preferences to mark imported data with timestamped Tag and/or Source attributes. These options dramatically slow the Import process but are helpful for the ensuing data cleanup.
  • Export... - Exporting data allows you to share any portion of your Gramps Family Tree with other researchers as well as to enable you to transfer your data to another computer.

  • Export View... - Menu only appears on most Views, if the displayed data can be exported. Gramps will export data on screen according your choice: CSV or Open Document spreadsheet format.


  • Abandon Changes and Quit... -
  • Quit... -


Add

Fig. 8.13 Menubar - Add Overview



Edit

Fig. 8.14 Menubar - Edit Overview
  • Undo -
  • Redo -
  • Undo History... - Open the Undo History dialog

Additional menu options dependent on Category view will appear here.


  • Clipboard - The Clipboard tool provides a temporary notepad to store database records for easy reuse.

  • Preferences... - Shows the Preferences dialog. That allows you to change most settings in Gramps.
  • Additional menu options dependent on Category view will appear here.


View

Fig. 8.15 Menubar - "View" - overview example
  • Configure... - Allows you to configure the active view. Provides options to hide, reveal & re-arrange elements.
  • Navigator... - The Navigator is a sidebar container for the Navigator Category icons. When selected (default), the sidebar is shown on the left of the active View. Deselecting hides the Navigator sidebar. If all the Category icons cannot fit in the available vertical space, a hidden scrollbar will be created on the right of the sidebar and be revealed when rolled (hovered) over.
    Text labels for the icons can be hidden via an option in the Display tab of Preferences. Display modes can be selected from the pop-up menu at the bottom of the Navigator sidebar.
  • Toolbar - show (or hide) a split screen container for (frequently used) action icons above the Category View. The selection of action icons varies to suit the Category view.
    A Third party Addon can be installed to supplement the Preferences with a Theme tab providing an option to show Text labels for each Toolbar button.
  • Sidebar - Show (or hide) a split screen container for Gramplets to the right of the Category View.
  • Bottombar - Show (or hide) a split screen container for Gramplets at the bottom of the window, just above the Status Bar.
  • Full Screen - Expand window to use all available screen space while disabling the window dragging & resizing controls. Deselecting restores to previous size while re-enabling the window dragging & resizing controls.

  • Dependent on which view is active, other option menu items will appear here that can modify how the View organizes data.


Go

Fig. 8.16 Menubar - Go Overview
  • Back - navigates the selection of the current View backwards to the previous item in your Navigation history
  • Forward - navigates the selection of the current View forward to the next item in your Navigation history


  • Dynamic list of the most recent 10 records (People, Families, et cetera) selected, the List is dependent on the Category view being viewed.
Gnome-important.png
Known bug patch for Gramps version 5.1.1(Fixed in Version 5.1.2)

Fixes 'Go' menu selection scramble caused by recent UIManager upgrade
addresses Bug Report: 11341 on 24 Sept 2019

Tango-Dialog-information.png
You can use the third party RestoreHist addon

So that a portion of the Go menu can be made to persist between restarts of Gramps. If installed then you can manually clear the stored state by finding and deleting /gramps51/plugins/RestoreHist/hist_save.ini file from the user folder (the ~.gramps folder or %Appdata% folder in Windows).



Bookmarks

Fig. 8.17 Menubar - Bookmarks Overview
  • Add Bookmark - Create a bookmark from the currently selected item eg: Person, Family etc..
  • Organize Bookmarks... - Opens the Organize Bookmarks window.

  • Dynamic section where the bookmarks appear


Reports

Fig. 8.18 Menubar - Reports Overview
  • Books... - The Books Report allows you to create a custom genealogy book containing a collection of Gramps textual and graphical reports in a single document (i.e. a Book)


Tools

Fig. 8.19 "Tool >..." Menubar - Tools Overview


Windows

Fig. 8.20 Menubar - "Windows" - overview example
  • Windows - This menu provides quick access to opened windows you are working on.


Help

Fig. 8.21 Menubar - "Help" - overview example
  • User Manual - Direct link to the online Gramps User manual you are viewing right now. Yes, you need an internet connection to consult the Gramps User Manual.
  • FAQ - A link to the Frequently Asked Questions about Gramps.
  • Key Bindings - A link to the Keybindings reference for Gramps. Also known as Keyboard shortcuts.
  • Tip of the Day - Displays the "Tip of the day" dialog.
  • Plugin Manager - From this menu you can manage the built in plugins as well as any Third-Party Addons you may have installed.
  • Gramps Home Page - This item opens your web browser and connects to the Gramps project web site.
  • Gramps Mailing List - This item opens your web browser to the Gramps mailing list page. On this page, you can browse the mailing list archives and join the gramps-users mailing list so you can share your experiences with other Gramps user's.
  • Report a Bug - Choose this item to file a bug report in the Gramps bug tracking system. (This requires you to have a registered account on the Gramps bug reporting system) (Remember, Gramps is a living project. We want to know about any problems you encounter so we can work to solve them for you and everyone elses benefit.)
  • Extra Reports/Tools - A link to Installing Third-Party Addons in Gramps.
  • About - This item displays a dialog with general information about the Gramps version you are running.

Toolbar

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.



Fig. 8.22 Manage databases - icon on toolbar (Same as using menu Family Trees ->Manage Family Trees...)


Fig. 8.23 Connect to a recent database - icon drop down on toolbar menu Family Trees ->Open Recent...


Fig. 8.24 Tip for the Tools button of the Dashboard category toolbar



Previous Index Next
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