Difference between revisions of "Gramps 5.1 Wiki Manual"

From Gramps
Jump to: navigation, search
m (Abstract: don't use version template in user manual)
 
(29 intermediate revisions by 7 users not shown)
Line 8: Line 8:
 
==Abstract==
 
==Abstract==
  
This '''Gramps [[Gramps_Glossary#wiki|Wiki]] Manual''' for version {{man version}} is the online user's guide, detailing most aspects of the Gramps application, a database for the collection of genealogical information. As of {{CURRENTDAYNAME}}, {{CURRENTDAY}} {{CURRENTMONTHNAMEGEN}} {{CURRENTYEAR}}, the [[Download|most current Gramps release]] is the {{TEMPLATE:version}} version.  Both Gramps and the accompanying Wiki Manual [[User_manual_translations|have been translated into multiple languages]].
+
This '''Gramps [[Gramps_Glossary#wiki|Wiki]] Manual''' for version 5.1 is the online user's guide, detailing most aspects of the Gramps application, a database for the collection of genealogical information. As of {{CURRENTDAYNAME}}, {{CURRENTDAY}} {{CURRENTMONTHNAMEGEN}} {{CURRENTYEAR}}, the [[Download|most current Gramps release]] is the {{TEMPLATE:version}} version.  Both Gramps and the accompanying Wiki Manual [[User_manual_translations|have been translated into multiple languages]].
  
For older Wiki Manuals, see the [[User_manual_translations#superseded|archival versions]] made for [[Previous_releases_of_Gramps|previous releases of Gramps]]. The last '''''downloadable manual''''' (for offline use) was in 2012 for the [[User_manual_translations#Gramps_3.3.x_Manual|version 3.3.x of Gramps]].  
+
You can also download the [[Media:Gramps5.1UserManual.pdf|Complete English 5.1 Offline Manual]] (20 MiB) last updated 27 Aug 2023.
 +
 
 +
For older Wiki Manuals, see the [[User_manual_translations#superseded|archival versions]] made for [[Previous_releases_of_Gramps|previous releases of Gramps]].
  
 
To explore other sources of information about using Gramps, see the [[:Portal:Using_Gramps|Information Portal]].
 
To explore other sources of information about using Gramps, see the [[:Portal:Using_Gramps|Information Portal]].
Line 26: Line 28:
 
:[[Gramps 5.1 Wiki Manual - Preface|Preface]]
 
:[[Gramps 5.1 Wiki Manual - Preface|Preface]]
 
::[[Gramps 5.1 Wiki Manual - Preface#Why use Gramps.3F|Why use Gramps?]]
 
::[[Gramps 5.1 Wiki Manual - Preface#Why use Gramps.3F|Why use Gramps?]]
::[[Gramps 5.1 Wiki Manual - Preface#Typographical conventions|Typographical conventions in the Gramps Wiki Manual]]
+
::[[Gramps 5.1 Wiki Manual - Preface#Typographical_conventions_in_the_Gramps_Wiki_Manual|Typographical conventions in the Gramps Wiki Manual]]
 
<hr>
 
<hr>
 
:[[Gramps 5.1 Wiki Manual - Main Window|A Visual Guide to the Gramps Interface]]
 
:[[Gramps 5.1 Wiki Manual - Main Window|A Visual Guide to the Gramps Interface]]
Line 153: Line 155:
  
 
     START CHAPTER 4 : Categories
 
     START CHAPTER 4 : Categories
 +
  
  
Line 202: Line 205:
 
         6.2 Fan Chart View
 
         6.2 Fan Chart View
 
             6.2.1 Configure the active view
 
             6.2.1 Configure the active view
 +
            6.2.2 See also
 
         6.3 Descendant Fan View
 
         6.3 Descendant Fan View
 
             6.3.1 Configure the active view
 
             6.3.1 Configure the active view
 +
            6.3.2 See also
 
         6.4 2-Way Fan View
 
         6.4 2-Way Fan View
 
             6.4.1 Configure the active view
 
             6.4.1 Configure the active view
 +
            6.4.2 See also
 
         6.5 Charts Category Bottombar tabs
 
         6.5 Charts Category Bottombar tabs
 
         6.6 Charts Category Sidebar tabs
 
         6.6 Charts Category Sidebar tabs
Line 211: Line 217:
 
     7 Events Category
 
     7 Events Category
 
         7.1 Events View
 
         7.1 Events View
 +
            7.1.1 ⚙ Configuration Options
 
         7.2 Events Category Bottombar tabs
 
         7.2 Events Category Bottombar tabs
 
             7.2.1 Gallery
 
             7.2.1 Gallery
Line 235: Line 242:
 
             8.6.1 Filter
 
             8.6.1 Filter
 
     9 Geography Category
 
     9 Geography Category
         9.1 The different views
+
         9.1 Prerequisites
            9.1.1 All known places
+
            9.1.1 The different views
            9.1.2 All known places for one Family
+
                9.1.1.1 All known places
            9.1.3 Have they been able to meet ?
+
                9.1.1.2 All known places for one Family
            9.1.4 All places related to Events
+
                9.1.1.3 Have they been able to meet ?
            9.1.5 All known places for one Person
+
                9.1.1.4 All places related to Events
                9.1.5.1 All known places for one person with graphical information (KML files)
+
                9.1.1.5 All known places for one Person
            9.1.6 Every residence or move for a person and any descendants
+
                    9.1.1.5.1 All known places for one person with graphical information (KML files)
            9.1.7 Have these two families been able to meet ?
+
                9.1.1.6 Every residence or move for a person and any descendants
 +
                9.1.1.7 Have these two families been able to meet ?
 
         9.2 Usage
 
         9.2 Usage
 
             9.2.1 The configuration
 
             9.2.1 The configuration
 
                 9.2.1.1 All views
 
                 9.2.1.1 All views
 
                 9.2.1.2 Specific views
 
                 9.2.1.2 Specific views
             9.2.2 How to zoom and move around the map ?
+
             9.2.2 Print or save the Map
                 9.2.2.1 Zoom in and Zoom out the map
+
            9.2.3 How to zoom and move around the map ?
                 9.2.2.2 Move around the map
+
                 9.2.3.1 Zoom in and Zoom out the map
             9.2.3 The mouse actions on the map
+
                 9.2.3.2 Move around the map
                 9.2.3.1 button 1 ( left button )
+
             9.2.4 The mouse actions on the map
                 9.2.3.2 button 2 ( middle button )
+
                 9.2.4.1 button 1 ( left button )
                 9.2.3.3 button 3 ( right button )
+
                 9.2.4.2 button 2 ( middle button )
                 9.2.3.4 The mouse over a marker
+
                 9.2.4.3 button 3 ( right button )
             9.2.4 The menu popup
+
                 9.2.4.4 The mouse over a marker
             9.2.5 Click on a marker
+
             9.2.5 The menu popup
             9.2.6 Adding or Linking to a place
+
             9.2.6 Click on a marker
             9.2.7 Adding places from KML files
+
             9.2.7 Adding or Linking to a place
             9.2.8 How to change the map provider ?
+
             9.2.8 Adding places from KML files
             9.2.9 Can we change the marker's color ?
+
             9.2.9 How to change the map provider ?
             9.2.10 How to get/remove the crosshair ?
+
             9.2.10 Can we change the marker's color ?
             9.2.11 How to lock/unlock the map ?
+
             9.2.11 How to get/remove the crosshair ?
 +
             9.2.12 How to lock/unlock the map ?
 
         9.3 Prerequisites to see the geography view
 
         9.3 Prerequisites to see the geography view
 
         9.4 Possible problems
 
         9.4 Possible problems
Line 311: Line 320:
 
         14.3 Notes Category Sidebar tabs
 
         14.3 Notes Category Sidebar tabs
 
             14.3.1 Filter
 
             14.3.1 Filter
 +
  
 
-->
 
-->
Line 406: Line 416:
 
#####[[Gramps_5.1_Wiki_Manual_-_Categories#All views|All views]]
 
#####[[Gramps_5.1_Wiki_Manual_-_Categories#All views|All views]]
 
#####[[Gramps_5.1_Wiki_Manual_-_Categories#Specific views|Specific views]]
 
#####[[Gramps_5.1_Wiki_Manual_-_Categories#Specific views|Specific views]]
 +
####[[Gramps_5.1_Wiki_Manual_-_Categories#Print_or_save_the_Map|Print or save the Map]]
 
####[[Gramps_5.1_Wiki_Manual_-_Categories#How to zoom and move around the map ?|How to zoom and move around the map ?]]
 
####[[Gramps_5.1_Wiki_Manual_-_Categories#How to zoom and move around the map ?|How to zoom and move around the map ?]]
 
#####[[Gramps_5.1_Wiki_Manual_-_Categories#Zoom in and Zoom out the map|Zoom in and Zoom out the map]]
 
#####[[Gramps_5.1_Wiki_Manual_-_Categories#Zoom in and Zoom out the map|Zoom in and Zoom out the map]]
Line 1,114: Line 1,125:
  
  
     1 What is a Gramplet
+
     1 What is a Gramplet?
         1.1 General Usage and Configuration
+
         1.1 Aren't all Plugins also Gramplets?
        1.2 Summary of Gramplets
+
        1.2 Starting with Gramplets
     2 Gramplets
+
        1.3 General Usage and Configuration
         2.1 2-Way Fan Chart
+
            1.3.1 The Dashboard Category View
         2.2 Age on Date
+
                1.3.1.1 ⚙ Configurable Options
         2.3 Age Stats
+
            1.3.2 The split-screen Sidebar & Bottombar
         2.4 Ancestors
+
                1.3.2.1 ⚙ Configurable Options
         2.5 Attributes
+
    2 Summary of Gramplets
             2.5.1 Person Attributes
+
        2.1 Gramplet List
             2.5.2 Family Attributes
+
     3 Gramplets
             2.5.3 Event Attributes
+
         3.1 2-Way Fan Chart
             2.5.4 Source Attributes
+
         3.2 Age on Date
             2.5.5 Citation Attributes
+
         3.3 Age Stats
             2.5.6 Media Attributes
+
            3.3.1 ⚙ Configurable Options
         2.6 Calendar
+
            3.3.2 See also
         2.7 Children
+
         3.4 Ancestors
             2.7.1 Person Children
+
         3.5 Attributes
             2.7.2 Family Children
+
             3.5.1 Person Attributes
         2.8 Citations
+
             3.5.2 Family Attributes
             2.8.1 Person Citations
+
             3.5.3 Event Attributes
             2.8.2 Family Citations
+
             3.5.4 Source Attributes
             2.8.3 Event Citations
+
             3.5.5 Citation Attributes
             2.8.4 Place Citations
+
             3.5.6 Media Attributes
             2.8.5 Media Citations
+
         3.6 Calendar
         2.9 Descendant Fan Chart
+
         3.7 Children
         2.10 Descendants
+
             3.7.1 Person Children
         2.11 Details
+
             3.7.2 Family Children
             2.11.1 Person Details
+
         3.8 Citations
             2.11.2 Place Details
+
             3.8.1 Person Citations
             2.11.3 Repository Details
+
             3.8.2 Family Citations
         2.12 Events
+
             3.8.3 Event Citations
             2.12.1 Person Events
+
             3.8.4 Place Citations
             2.12.2 Family Events
+
             3.8.5 Media Citations
         2.13 Fan Chart
+
         3.9 Descendant Fan Chart
         2.14 FAQ
+
         3.10 Descendants
         2.15 Filter
+
         3.11 Details
             2.15.1 Person Filter
+
             3.11.1 Person Details
             2.15.2 Family Filter
+
             3.11.2 Place Details
             2.15.3 Event Filter
+
             3.11.3 Repository Details
             2.15.4 Place Filter
+
         3.12 Encloses
             2.15.5 Source Filter
+
            3.12.1 Encloses Place Locations
             2.15.6 Citation Filter
+
        3.13 Enclosed By
             2.15.7 Repository Filter
+
            3.13.1 Enclosed By Place Locations
             2.15.8 Media Filter
+
        3.14 Events
             2.15.9 Notes Filter
+
             3.14.1 Person Events
         2.16 Gallery
+
             3.14.2 Family Events
             2.16.1 Person Gallery
+
         3.15 Events Coordinates
             2.16.2 Family Gallery
+
        3.16 Fan Chart
             2.16.3 Event Gallery
+
         3.17 FAQ
             2.16.4 Place Gallery
+
            3.17.1 See Also
             2.16.5 Source Gallery
+
         3.18 Filter
             2.16.6 Citation Gallery
+
             3.18.1 Person Filter
         2.17 Given Name Cloud
+
             3.18.2 Family Filter
         2.18 Image Metadata
+
             3.18.3 Event Filter
             2.18.1 Prerequisites
+
             3.18.4 Place Filter
             2.18.2 Usage scenario
+
             3.18.5 Source Filter
         2.19 Locations
+
             3.18.6 Citation Filter
            2.19.1 Place Locations
+
             3.18.7 Repository Filter
         2.20 Notes
+
             3.18.8 Media Filter
             2.20.1 Person Notes
+
             3.18.9 Notes Filter
             2.20.2 Family Notes
+
         3.19 Gallery
             2.20.3 Event Notes
+
             3.19.1 Person Gallery
             2.20.4 Place Notes
+
             3.19.2 Family Gallery
             2.20.5 Source Notes
+
             3.19.3 Event Gallery
             2.20.6 Citation Notes
+
             3.19.4 Place Gallery
             2.20.7 Repository Notes
+
             3.19.5 Source Gallery
             2.20.8 Media Notes
+
             3.19.6 Citation Gallery
         2.21 Pedigree
+
         3.20 Given Name Cloud
        2.22 Preview
+
         3.21 Image Metadata
         2.23 Quick View
+
             3.21.1 Prerequisites
         2.24 Records
+
             3.21.2 Usage scenario
         2.25 References
+
         3.22 Media Preview
             2.25.1 Person References
+
         3.23 Notes
             2.25.2 Family References
+
             3.23.1 Person Notes
             2.25.3 Event References
+
             3.23.2 Family Notes
             2.25.4 Place References
+
             3.23.3 Event Notes
             2.25.5 Source References
+
             3.23.4 Place Notes
             2.25.6 Citation References
+
             3.23.5 Source Notes
             2.25.7 Repository References
+
             3.23.6 Citation Notes
             2.25.8 Media References
+
             3.23.7 Repository Notes
             2.25.9 Note References
+
             3.23.8 Media Notes
         2.26 Relatives
+
         3.24 Pedigree
         2.27 Residence
+
            3.24.1 ⚙ Configurable Options
             2.27.1 Person Residence
+
         3.25 Quick View
         2.28 Session Log
+
         3.26 Records
         2.29 SoundEx
+
         3.27 References
             2.29.1 Soundex what is this?
+
             3.27.1 Person References
         2.30 Statistics
+
             3.27.2 Family References
         2.31 Surname Cloud
+
             3.27.3 Event References
         2.32 To Do
+
             3.27.4 Place References
             2.32.1 Person To Do
+
             3.27.5 Source References
             2.32.2 Family To Do
+
             3.27.6 Citation References
             2.32.3 Event To Do
+
             3.27.7 Repository References
             2.32.4 Place To Do
+
             3.27.8 Media References
             2.32.5 Source To Do
+
             3.27.9 Note References
             2.32.6 Citation To Do
+
         3.28 Relatives
             2.32.7 Repository To Do
+
         3.29 Residence
             2.32.8 Media To Do
+
             3.29.1 Person Residence
         2.33 Top Surnames
+
         3.30 Session Log
         2.34 Uncollected Objects
+
         3.31 SoundEx
         2.35 Welcome
+
             3.31.1 Soundex what is this?
         2.36 What's Next
+
         3.32 Statistics
 
+
         3.33 Surname Cloud
 +
         3.34 To Do
 +
             3.34.1 Person To Do
 +
             3.34.2 Family To Do
 +
             3.34.3 Event To Do
 +
             3.34.4 Place To Do
 +
             3.34.5 Source To Do
 +
             3.34.6 Citation To Do
 +
             3.34.7 Repository To Do
 +
             3.34.8 Media To Do
 +
         3.35 Top Surnames
 +
         3.36 Uncollected Objects
 +
         3.37 Welcome
 +
         3.38 What's Next
  
 
-->
 
-->
Line 1,224: Line 1,248:
 
###[[Gramps_5.1_Wiki_Manual_-_Gramplets#General_Usage_and_Configuration|General Usage and Configuration]]
 
###[[Gramps_5.1_Wiki_Manual_-_Gramplets#General_Usage_and_Configuration|General Usage and Configuration]]
 
###[[Gramps_5.1_Wiki_Manual_-_Gramplets#Summary_of_Gramplets|Summary of Gramplets]]
 
###[[Gramps_5.1_Wiki_Manual_-_Gramplets#Summary_of_Gramplets|Summary of Gramplets]]
 +
####[[Gramps_5.1_Wiki_Manual_-_Gramplets#Gramplet_List|Gramplet List]]
 
##[[Gramps_5.1_Wiki_Manual_-_Gramplets#Gramplets|Gramplets]]
 
##[[Gramps_5.1_Wiki_Manual_-_Gramplets#Gramplets|Gramplets]]
 
###[[Gramps_5.1_Wiki_Manual_-_Gramplets#2-Way_Fan_Chart|2-Way Fan Chart]]
 
###[[Gramps_5.1_Wiki_Manual_-_Gramplets#2-Way_Fan_Chart|2-Way Fan Chart]]
Line 1,695: Line 1,720:
 
####[[Gramps 5.1 Wiki Manual - Reports_-_part_7#Example Web Site output|Example Web Site output]]<hr>
 
####[[Gramps 5.1 Wiki Manual - Reports_-_part_7#Example Web Site output|Example Web Site output]]<hr>
 
<!--
 
<!--
     Quick Views
+
 
         1 Making your own Quick view
+
     1 Quick Views
 +
         1.1 All Events
 +
        1.2 All Family Events
 +
        1.3 On This Day
 +
        1.4 Father linage
 +
        1.5 Mother linage
 +
        1.6 Siblings
 +
        1.7 Relation to Home Person
 +
        1.8 Same Given Names
 +
        1.9 Same Surnames
 +
        1.10 Person References
 +
        1.11 Family References
 +
        1.12 Event References
 +
        1.13 Place References
 +
        1.14 Source References
 +
        1.15 Citation References
 +
        1.16 Repository References
 +
        1.17 Media References
 +
        1.18 Link References
 +
        1.19 Note References
 +
    2 Quick View Gramplet
 +
    3 Making your own Quick view
 
-->
 
-->
 
##[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quick Views]]
 
##[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quick Views]]
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Making your own Quick view|Making your own Quick view]]<hr>
+
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#All_Events|All Events]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#All_Family_Events|All Family Events]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#On_This_Day|On This Day]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Father_linage|Father linage]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Mother_linage|Mother linage]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Siblings|Siblings]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Relation_to_Home_Person|Relation to Home Person]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Same_Given_Names|Same Given Names]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Same_Surnames|Same Surnames]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Person_References|Person References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Family_References|Family References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Event_References|Event References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Place_References|Place References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Source_References|Source References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Citation_References|Citation References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Repository_References|Repository References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Media_References|Media References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Link_References|Link References]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Note_References|Note References]]
 +
##[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Quick_View_Gramplet|Quick View Gramplet]]
 +
##[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Making your own Quick view|Making your own Quick view]]<hr>
 
<!--  
 
<!--  
 
         START CHAPTER 12 : Tools
 
         START CHAPTER 12 : Tools
 +
  
  
Line 1,721: Line 1,788:
 
         1.4 Family Tree Repair
 
         1.4 Family Tree Repair
 
             1.4.1 Check and Repair Database
 
             1.4.1 Check and Repair Database
 +
                1.4.1.1 Gramps had a problem the last time it was run - dialog
 
             1.4.2 Rebuild Gender Statistics
 
             1.4.2 Rebuild Gender Statistics
 
             1.4.3 Rebuild Reference Maps
 
             1.4.3 Rebuild Reference Maps
 +
                1.4.3.1 See also
 
             1.4.4 Rebuild Secondary Indexes
 
             1.4.4 Rebuild Secondary Indexes
 +
                1.4.4.1 See also
 
             1.4.5 Remove Unused Objects
 
             1.4.5 Remove Unused Objects
 
         1.5 Utilities
 
         1.5 Utilities
             1.5.1 Find database loop
+
             1.5.1 Clean input data
             1.5.2 Media Manager
+
                1.5.1.1 Remove leading and trailing spaces
                 1.5.2.1 Replace substrings in the path
+
            1.5.2 Find database loop
                 1.5.2.2 Convert paths from relative to absolute
+
             1.5.3 Media Manager
                 1.5.2.3 Convert paths from absolute to relative
+
                 1.5.3.1 Replace substrings in the path
                 1.5.2.4 Add images not included in database
+
                 1.5.3.2 Convert paths from relative to absolute
             1.5.3 Not Related
+
                 1.5.3.3 Convert paths from absolute to relative
             1.5.4 Relationship Calculator
+
                 1.5.3.4 Add images not included in database
             1.5.5 Verify the Data
+
             1.5.4 Not Related
                 1.5.5.1 Verify the Data tab pages
+
             1.5.5 Relationship Calculator
                     1.5.5.1.1 General
+
                1.5.5.1 See also:
                     1.5.5.1.2 Women
+
             1.5.6 Verify the Data
                     1.5.5.1.3 Men
+
                 1.5.6.1 Verify the Data tab pages
                     1.5.5.1.4 Families
+
                     1.5.6.1.1 General
                 1.5.5.2 Data Verification Results window
+
                     1.5.6.1.2 Women
                 1.5.5.3 Examples
+
                     1.5.6.1.3 Men
 +
                     1.5.6.1.4 Families
 +
                 1.5.6.2 Data Verification Results window
 +
                 1.5.6.3 Examples
 
         1.6 Debug
 
         1.6 Debug
 
             1.6.1 Check Localized Date Displayer and Parser
 
             1.6.1 Check Localized Date Displayer and Parser
Line 1,747: Line 1,820:
 
             1.6.3 Generate Testcases for Persons and Families
 
             1.6.3 Generate Testcases for Persons and Families
 
             1.6.4 Populate Sources and Citations
 
             1.6.4 Populate Sources and Citations
 +
  
  
Line 1,767: Line 1,841:
 
##[[Gramps 5.1 Wiki Manual - Tools#Family Tree Repair|Family Tree Repair]]
 
##[[Gramps 5.1 Wiki Manual - Tools#Family Tree Repair|Family Tree Repair]]
 
###[[Gramps 5.1 Wiki Manual - Tools#Check and Repair Database|Check and Repair Database]]
 
###[[Gramps 5.1 Wiki Manual - Tools#Check and Repair Database|Check and Repair Database]]
 +
####[[Gramps_5.1_Wiki_Manual_-_Tools#Gramps_had_a_problem_the_last_time_it_was_run_-_dialog|Gramps had a problem the last time it was run - dialog]]
 
###[[Gramps_5.1_Wiki_Manual_-_Tools#Rebuild Gender Statistics|Rebuild Gender Statistics]]
 
###[[Gramps_5.1_Wiki_Manual_-_Tools#Rebuild Gender Statistics|Rebuild Gender Statistics]]
 
###[[Gramps 5.1 Wiki Manual - Tools#Rebuild Reference Maps|Rebuild Reference Maps]]
 
###[[Gramps 5.1 Wiki Manual - Tools#Rebuild Reference Maps|Rebuild Reference Maps]]
Line 1,795: Line 1,870:
 
<!--
 
<!--
 
     START CHAPTER 13 : Settings
 
     START CHAPTER 13 : Settings
 
 
  
  
Line 1,855: Line 1,928:
 
##[[Gramps_5.1_Wiki_Manual_-_Settings#Preferences|Preferences]]
 
##[[Gramps_5.1_Wiki_Manual_-_Settings#Preferences|Preferences]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#General|General]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#General|General]]
####[[Gramps_5.1_Wiki_Manual_-_Settings#Available Gramps Updates for Addons|Available Gramps Updates for Addons]]
+
####[[Gramps_5.1_Wiki_Manual_-_Settings#General_Gramps_settings|General Gramps settings]]
 +
####[[Gramps_5.1_Wiki_Manual_-_Settings#Third_party_addons_management|Third party addons management]]
 +
#####[[Gramps_5.1_Wiki_Manual_-_Settings#Available Gramps Updates for Addons|Available Gramps Updates for Addons]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Tip of the Day dialog|Tip of the Day dialog]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Tip of the Day dialog|Tip of the Day dialog]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]
Line 1,861: Line 1,936:
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Display Name Editor|Display Name Editor]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Display Name Editor|Display Name Editor]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]
###[[Gramps_5.1_Wiki_Manual_-_Settings#Places|Places]]
 
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#Text|Text]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#Text|Text]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]
Line 1,870: Line 1,944:
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Pick a Color selector|Pick a Color selector]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Pick a Color selector|Pick a Color selector]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#Genealogical_Symbols|Genealogical Symbols]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#Genealogical_Symbols|Genealogical Symbols]]
 +
####[[Gramps_5.1_Wiki_Manual_-_Settings#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]]
 +
#####[[Gramps_5.1_Wiki_Manual_-_Settings#Initial_setup|Initial setup]]
 +
#####[[Gramps_5.1_Wiki_Manual_-_Settings#Prerequisite|Prerequisite]]
 
##[[Gramps_5.1_Wiki_Manual_-_Settings#Other_settings|Other settings]]
 
##[[Gramps_5.1_Wiki_Manual_-_Settings#Other_settings|Other settings]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#Column_Editor|Column Editor]]
 
###[[Gramps_5.1_Wiki_Manual_-_Settings#Column_Editor|Column Editor]]
Line 1,892: Line 1,969:
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Mac OS X|Mac OS X]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#Mac OS X|Mac OS X]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#MS Windows|MS Windows]]
 
####[[Gramps_5.1_Wiki_Manual_-_Settings#MS Windows|MS Windows]]
###[[Gramps_5.1_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings|Advanced manipulation of settings]]<hr>
+
###[[Gramps_5.1_Wiki_Manual_-_Settings#Add_Windows_OS_Menu_Item|Add Windows OS Menu Item]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Settings#Change_the_windows_LANG_variables|Change the windows LANG variables]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Settings#Language_codes|Language codes]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings|Advanced manipulation of settings]]
 +
####[[Gramps_5.1_Wiki_Manual_-_Settings#Example_gramps.ini_file|Example gramps.ini file]]
 +
####[[Gramps_5.1_Wiki_Manual_-_Settings#Advanced_backup_filename_setting|Advanced backup filename setting]]
 +
###[[Gramps_5.1_Wiki_Manual_-_Settings#Theme|Theme]]<hr>
 
<!--
 
<!--
 
     START CHAPTER 14 : Filters
 
     START CHAPTER 14 : Filters
Line 2,254: Line 2,337:
 
         6.5 What does "portable" mean?
 
         6.5 What does "portable" mean?
 
         6.6 Why is the database format (GRDB) not portable?
 
         6.6 Why is the database format (GRDB) not portable?
 +
        6.7 Does Gramps have an Example Tree?
 
     7 Bugs and requests
 
     7 Bugs and requests
 
         7.1 What do I do if I have found a bug?
 
         7.1 What do I do if I have found a bug?
Line 2,306: Line 2,390:
 
::::[[Gramps_5.1_Wiki_Manual_-_FAQ#What_does_.22portable.22_mean.3F|What does "portable" mean?]]
 
::::[[Gramps_5.1_Wiki_Manual_-_FAQ#What_does_.22portable.22_mean.3F|What does "portable" mean?]]
 
::::[[Gramps_5.1_Wiki_Manual_-_FAQ#Why_is_the_database_format_.28GRDB.29_not_portable.3F|Why is the database format (GRDB) not portable?]]
 
::::[[Gramps_5.1_Wiki_Manual_-_FAQ#Why_is_the_database_format_.28GRDB.29_not_portable.3F|Why is the database format (GRDB) not portable?]]
 +
::::[[Gramps_5.1_Wiki_Manual_-_FAQ#Does_Gramps_have_an_Example_Tree.3F|Does Gramps have an Example Tree?]]
 
:::[[Gramps_5.1_Wiki_Manual_-_FAQ#Bugs_and_requests|Bugs and requests]]
 
:::[[Gramps_5.1_Wiki_Manual_-_FAQ#Bugs_and_requests|Bugs and requests]]
 
::::[[Gramps_5.1_Wiki_Manual_-_FAQ#What_do_I_do_if_I_have_found_a_bug.3F|What do I do if I have found a bug?]]
 
::::[[Gramps_5.1_Wiki_Manual_-_FAQ#What_do_I_do_if_I_have_found_a_bug.3F|What do I do if I have found a bug?]]
Line 2,409: Line 2,494:
  
 
  Appendix E: Error and Warning Reference
 
  Appendix E: Error and Warning Reference
 
  
 
     1 When something goes wrong
 
     1 When something goes wrong
Line 2,424: Line 2,508:
 
         3.4 Other warnings
 
         3.4 Other warnings
 
             3.4.1 Cannot save person
 
             3.4.1 Cannot save person
             3.4.2 Duplicate Family warning dialog
+
             3.4.2 Cannot merge <object>
             3.4.3 Suppress warning when adding parents to a child
+
            3.4.3 Duplicate Family warning dialog
             3.4.4 Suppress warning when cancelling with changed data
+
             3.4.4 Suppress warning when adding parents to a child
                 3.4.4.1 Save Changes? dialog
+
                3.4.4.1 Adding parents to a person dialog
             3.4.5 Suppress warning about missing researcher when exporting to GEDCOM
+
             3.4.5 Suppress warning when cancelling with changed data
             3.4.6 Undo history warning
+
                 3.4.5.1 Save Changes? dialog
 +
             3.4.6 Suppress warning about missing researcher when exporting to GEDCOM
 +
             3.4.7 Undo history warning
 
     4 Errors
 
     4 Errors
 
         4.1 Error Report
 
         4.1 Error Report
Line 2,446: Line 2,532:
 
         5.2 MS Windows
 
         5.2 MS Windows
 
         5.3 Mac OS X
 
         5.3 Mac OS X
 +
            5.3.1 Console application
  
 
-->
 
-->
Line 2,462: Line 2,549:
 
::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Other warnings|Other warnings]]
 
::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Other warnings|Other warnings]]
 
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Cannot_save_person|Cannot save person]]
 
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Cannot_save_person|Cannot save person]]
 +
:::::[[Gramps_5.1_Wiki_Manual_-_Error_and_Warning_Reference#Cannot_merge_.3Cobject.3E|Cannot merge <object>]]
 
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Duplicate Family warning dialog|Duplicate Family warning dialog]]
 
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Duplicate Family warning dialog|Duplicate Family warning dialog]]
 
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Suppress_warning_when_adding_parents_to_a_child|Suppress warning when adding parents to a child]]
 
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Suppress_warning_when_adding_parents_to_a_child|Suppress warning when adding parents to a child]]
Line 2,482: Line 2,570:
 
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Report_could_not_be_created|Report could not be created]]
 
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Report_could_not_be_created|Report could not be created]]
 
:::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Seeing all the error messages|Seeing all the error messages]]
 
:::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Seeing all the error messages|Seeing all the error messages]]
 +
::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Linux|Linux]]
 +
::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#MS_Windows|MS Windows]]
 +
::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Mac_OS_X|Mac OS X]]
 +
:::::[[Gramps 5.1 Wiki Manual - Error and Warning Reference#Console_application|Console application]]
 
<hr>
 
<hr>
 
<!--
 
<!--
Line 2,506: Line 2,598:
  
 
-->
 
-->
 +
{{man index|Gramps 5.1 Wiki Manual|Gramps 5.1 Wiki Manual - Preface|5.1}}
 
{{languages|Gramps 5.1 Wiki Manual}}
 
{{languages|Gramps 5.1 Wiki Manual}}
{{man index|Gramps 5.1 Wiki Manual|Gramps 5.1 Wiki Manual - Preface|5.1}}
+
 
  
 
{{grampsmanualcopyright}}
 
{{grampsmanualcopyright}}
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 09:55, 3 September 2023

This is the Wiki Manual for Gramps version 5.1. All users are encouraged to edit this manual to help improve its readability and usability.

Previous Index Next
Gramp-Small-background-wiki-2020.jpg

Research, organize and share your family tree with Gramps.

Gramps is a free software project and community. We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, developed and governed by genealogists.

Abstract

This Gramps Wiki Manual for version 5.1 is the online user's guide, detailing most aspects of the Gramps application, a database for the collection of genealogical information. As of Thursday, 28 March 2024, the most current Gramps release is the 5.2.1 version. Both Gramps and the accompanying Wiki Manual have been translated into multiple languages.

You can also download the Complete English 5.1 Offline Manual (20 MiB) last updated 27 Aug 2023.

For older Wiki Manuals, see the archival versions made for previous releases of Gramps.

To explore other sources of information about using Gramps, see the Information Portal.

Table of Contents

Preface
Why use Gramps?
Typographical conventions in the Gramps Wiki Manual

A Visual Guide to the Gramps Interface

  1. What's new?
    1. Before you upgrade
    2. Visible changes to the core
      1. Data Model
      2. Primary changes
      3. GUI
      4. Place
      5. Reports, Tools, Gramplets
      6. Import/Export
      7. New Addons
    3. Under the hood changes
      1. Dependencies
    4. Further information
      1. Miscellaneous
      2. Localization
      3. Roadmap
      4. Changelog
  2. Getting started
    1. Overview
      1. Connections
      2. Privacy
      3. GEDCOM
    2. Start Gramps
      1. Linux
      2. MS Windows
      3. Mac OS X
    3. Choosing a Family Tree
    4. Tell me how to start right now!
    5. Obtaining Help
  3. Main Window
    1. Main Window
      1. Window Title Bar
      2. Menubar
        1. Pull-down menus
        2. Pop-up menus
      3. Toolbar
      4. Navigator
      5. Display area
      6. Status Bar and Progress Bar
      7. Bottombar and Sidebar
        1. Gramplet Bar Menu
          1. Restore to defaults? dialog
        2. Search Bar
    2. Switching Navigator modes
      1. Category navigator mode (default)
      2. Expander navigator mode
      3. Drop-Down navigator mode
    3. Switching Categories
    4. Switching Views
    5. Filters
  4. Categories
    1. Categories of the Navigator
    2. Dashboard Category
      1. Gramplet Layout
    3. People Category
      1. Tree View - Grouped People
      2. People List View
      3. People Category Bottombar tabs
        1. Details
        2. Gallery
        3. Events
        4. Children
        5. Citations
        6. Notes
        7. Attributes
        8. References
      4. People Category Sidebar tabs
        1. Filter
    4. Relationships Category
      1. Relationships Category view
        1. Active Person
        2. Parents
          1. Select Family selector
          2. Siblings
        3. Family
          1. Reorder Relationships dialog
          2. Children
        4. Configuration
      2. Relationships Category Bottombar tabs
      3. Relationships Category Sidebar tabs
    5. Families Category
      1. Families Category Bottombar tabs
        1. Details
        2. Gallery
        3. Events
        4. Children
        5. Citations
        6. Notes
        7. Attributes
        8. References
      2. Families Category Sidebar tabs
        1. Filter
    6. Charts Category
      1. Pedigree View
        1. Configure the active view
      2. Fan Chart View
        1. Configure the active view
      3. Descendant Fan View
        1. Configure the active view
      4. 2-Way Fan View
        1. Configure the active view
      5. Charts Category Bottombar tabs
      6. Charts Category Sidebar tabs
        1. Filter
    7. Events Category
      1. Events View
      2. Events Category Bottombar tabs
        1. Gallery
        2. Citations
        3. Notes
        4. Attributes
        5. References
      3. Events Category Sidebar tabs
        1. Filter
    8. Places Category
      1. ⚙ Configuration Options
      2. Places List View
      3. Places Tree View
      4. Map Service
      5. Places Category Bottombar tabs
        1. Details
        2. Location
        3. Gallery
        4. Events
        5. Citations
        6. Notes
        7. References
      6. Places Category Sidebar tabs
        1. Filter
    9. Geography Category
      1. The different views
        1. All known places
        2. All known places for one Family
        3. Have they been able to meet ?
        4. All places related to Events
        5. All known places for one person
          1. All known places for one person with graphical information (KML files)
        6. Every residence or move for a person and any descendants
        7. Have these two families been able to meet ?
      2. Usage
        1. The configuration
          1. All views
          2. Specific views
        2. Print or save the Map
        3. How to zoom and move around the map ?
          1. Zoom in and Zoom out the map
          2. Move around the map
        4. The mouse actions on the map
          1. button 1 ( left button )
          2. button 2 ( middle button )
          3. button 3 ( right button )
          4. The mouse over a marker
        5. The menu popup
        6. Click on a marker
        7. Adding or Linking to a place
        8. Adding places from KML files
        9. How to change the map provider ?
        10. Can we change the marker's color ?
        11. How to get/remove the crosshair ?
        12. How to lock/unlock the map ?
      3. Prerequisites to see the geography view
      4. Possible problems
      5. Geography Category Bottombar tabs
      6. Geography Category Sidebar tabs
      7. Filter
    10. Sources Category
      1. Citation Tree View
      2. Sources List View
      3. Sources Category Bottombar tabs
        1. Gallery
        2. Notes
        3. References
      4. Sources Category Sidebar tabs
        1. Filter
    11. Citations Category
      1. Citations List View
      2. Citations Category Bottombar tabs
        1. Gallery
        2. Notes
        3. References
      3. Citations Category Sidebar tabs
        1. Filter
    12. Repositories Category
      1. Repository List View
      2. Repository Category Bottombar tabs
        1. Details
        2. Notes
        3. References
      3. Repository Category Sidebar tabs
        1. Filter
    13. Media Category
      1. Media List View
      2. Media Category Bottombar tabs
        1. Preview
        2. Citations
        3. Notes
        4. Attributes
        5. Image Metadata
        6. References
      3. Media Category Sidebar tabs
        1. Filter
    14. Notes Category
      1. Notes List View
      2. Notes Category Bottombar tabs
        1. References
      3. Notes Category Sidebar tabs
        1. Filter
  5. Manage Family Trees
    1. Starting a new Family Tree
      1. Family Trees manager window
    2. Opening a Family Tree
      1. Read Only Mode
    3. Saving changes to your Family Tree
    4. Opening a GEDCOM or XML database
    5. Deleting a Family Tree
    6. Renaming a Family Tree
    7. Backing up a Family Tree
      1. Backup dialog
    8. Archiving a Family Tree
    9. Extracting a Family Tree Archive
    10. Unlocking a Family Tree
      1. Break the lock on the "Family Tree name" database? dialog
    11. Repairing a damaged Family Tree
    12. Converting a BSDDB Family Tree to SQLite
    13. Importing data
      1. Import Family Tree dialog
      2. GRAMPS V2.x database import
        1. Moving a Gramps 2.2 databases to Gramps 3.x
      3. Gramps XML and XML Package import
      4. Gramps CSV import
      5. GEDCOM import
        1. GEDCOM Encoding dialog
        2. Import Statistics dialog
        3. GEDCOM import report dialog
          1. Reading the report
        4. GEDCOM import limitations
          1. HEADer, SUBMitter and SUBmissioN
          2. INDIvidual
          3. FAM_RECORD
          4. SOURCE_RECORD
          5. REPOSITORY_RECORD
          6. MULTIMEDIA_RECORD
          7. NOTE_RECORD
    14. Exporting data
      1. Export Assistant dialog
        1. Saving your data
        2. Choose the output format
        3. Export options
          1. Filters and privacy
            1. Privacy Filter:
            2. Living Filter:
            3. Person Filter:
            4. Note Filter:
            5. Reference Filter:
          2. File format specific export options
        4. Select save file
        5. Final confirmation
        6. Summary
        7. Comma Separated Values Spreadsheet(CSV) export
      2. GEDCOM export
      3. GeneWeb export
      4. Gramps XML (family tree) export
      5. Gramps XML Package (family tree and media) export
      6. Web Family Tree export
      7. vCalendar export
      8. vCard export
  6. CSV Import and Export
    1. Gramps Spreadsheet Import/Export
    2. Export
    3. Import
      1. People
      2. Marriage
      3. Family
      4. Place
    4. Details
      1. Example CSV with multiple areas
      2. Example CSV from Spreadsheet
  7. Probably Alive
    1. How does Gramps determine if someone is alive?
    2. Probably Alive Proxy
    3. Probably Alive Filter
    4. Calendar Gramplet
  8. Entering and editing data: brief
    1. To add or edit a person
      1. Add a new person
      2. Edit an existing person
    2. To specify a relationship
      1. Specifying a relationship using the Relationship View
      2. Specifying a relationship using the Family List View
    3. To specify parents
    4. To specify children
    5. Adding photos and other media objects
    6. To edit events, sources, places, and repositories
  9. Entering and editing data: detailed
    1. Entering and editing data: detailed - part 1
      1. Editing information about people
        1. Edit Person dialog
        2. Preferred name section
        3. Multiple Surnames
        4. General section
        5. Preferred image
        6. Edit Person tab pages
          1. Events
            1. Select Event selector
          2. Names
          3. Source Citations
          4. Attributes
          5. Addresses
          6. Notes
            1. Select Note selector
          7. Gallery
            1. Select Media Object selector
          8. Internet
          9. Associations
            1. Person Reference Editor
              1. Select Person selector
          10. LDS
          11. References
      2. Editing information about relationships
        1. Family Editor dialog
          1. Select Father selector
          2. Select Mother selector
        2. Family Editor tab pages
          1. Children
            1. Select Child selector
            2. Child Reference Editor
              1. Source Citations tab
              2. Notes tab
          2. Events
          3. Source Citations
          4. Attributes
          5. Notes
          6. Gallery
          7. LDS
            1. LDS Ordinance Editor
      3. Editing dates
        1. Date selection dialog
        2. Date validity indicators
        3. Date Quality
        4. Date formats and parsing rules
        5. Calendars
          1. Swedish calendar
        6. Dual-dated dates
          1. Alternate new year day
    2. Entering and editing data: detailed - part 2
      1. Editing information about events
        1. New Event dialog
        2. New Event tab pages
          1. Source Citations
          2. Notes
          3. Gallery
          4. Attributes
          5. References
      2. Editing event references
        1. Event Reference Editor dialog
          1. Reference Information
            1. Reference Information tab pages
              1. General
              2. Notes
              3. Attributes
          2. Shared Information
            1. General
            2. Source Citations
            3. Attributes
            4. Notes_3
            5. Gallery
            6. References
      3. Editing information about media objects
        1. New Media dialog
        2. New Media tab pages
          1. Source Citations
          2. Attributes
          3. Notes
          4. References
      4. Editing media object references
        1. Select a media object selector
        2. Media Reference Editor dialog
          1. Top section
            1. Top section tab pages
              1. General
              2. Source Citations
              3. Attributes
              4. Notes
          2. Shared Information
            1. Shared Information tab pages
              1. General
              2. References
              3. Source Citations
              4. Attributes
              5. Notes
      5. Editing information about places
        1. Place Editor dialog
        2. Place editor tab pages
          1. Enclosed By
            1. Select Place selector
            2. Place Reference Editor
          2. Alternative Names
          3. Source Citations
          4. Notes
          5. Gallery
          6. Internet
          7. References
        3. Place Name Editor dialog
        4. Supported longitude/latitude formats
      6. Editing information about sources
        1. New Source dialog
        2. New Source tab pages
          1. Notes
          2. Gallery
          3. Attributes
          4. Repositories
            1. Select Repository selector
          5. References
      7. Editing source citations
        1. Select Source or Citation selector
        2. New Citation dialog
          1. Citation information
            1. Select Source selector
            2. Citation information section tab pages
          2. Shared source information
      8. Editing information about repositories
        1. New Repository dialog
        2. New Repository tab pages
          1. Addresses
          2. Internet
          3. Notes
          4. References
      9. Editing information about notes
        1. New Note editor dialog
          1. Note tab
          2. References tab
          3. Link Editor
        2. Note markup and preformat in reports
    3. Entering and editing data: detailed - part 3
      1. Name Editor
        1. Name Editor dialog
          1. Type
          2. Given Name(s) Section
          3. Family Names Section
        2. Name Editor tab pages
          1. General
          2. Source Citations
          3. Notes
      2. Attributes
        1. Attribute Editor dialog
        2. Attribute Editor tab pages
          1. Source Citations
          2. Notes
      3. Addresses
        1. Address Editor dialog
        2. Address Editor tab pages
          1. Source Citations
          2. Notes
      4. Merging records
        1. Merge People
        2. Merge Families
        3. Merge Events
        4. Merge Sources
        5. Merge Citations
        6. Merge Places
        7. Merge Media Objects
        8. Merge Repositories
        9. Merge Notes
  10. Navigation
    1. Using the People Category
    2. Using the Relationships Category
    3. Using the Families Category
    4. Using the Charts Category
    5. Using Gramplets
    6. Setting the Home Person
    7. Setting the Active Person
    8. Using history-based tools
    9. Bookmarks
    10. Finding records
    11. Using the Clipboard
    12. Main Menus
      1. Family Trees
      2. Add
      3. Edit
      4. View
      5. Go
      6. Bookmarks
      7. Reports
      8. Tools
      9. Windows
      10. Help
  11. Plugin Manager
    1. Plugin types
    2. Registration and loading
    3. Hide/Unhide
    4. Actions
      1. Registered Plugins
      2. Loaded Plugins
    5. Detailed Info dialog
  12. Gramplets
    1. What is a Gramplet
      1. General Usage and Configuration
      2. Summary of Gramplets
        1. Gramplet List
    2. Gramplets
      1. 2-Way Fan Chart
      2. Age on Date
      3. Age Stats
      4. Ancestors
      5. Attributes
      6. Calendar
      7. Children
      8. Citations
      9. Descendant Fan Chart
      10. Descendants
      11. Details
      12. Events
      13. Fan Chart
      14. FAQ
      15. Filter
      16. Gallery
      17. Given Name Cloud
      18. Image Metadata
        1. The interface
          1. Data Fields
          2. Buttons
        2. Prerequisites
        3. Usage scenario
      19. Locations
      20. Notes
      21. Pedigree
      22. Preview
      23. Quick View
      24. Records
      25. References
      26. Relatives
      27. Residence
      28. Session Log
      29. SoundEx
        1. Soundex what is this?
      30. Statistics
      31. Surname Cloud
      32. To Do
      33. Top Surnames
      34. Uncollected Objects
      35. Welcome
      36. What's Next
  13. Reports - Index and Summary.
    1. Generating Reports
      1. Report Settings
      2. Report Format Style
    2. Substitution Values
      1. The Substitution Keys
        1. Other Substitution Keys
        2. Default displayed formats
        3. Deprecated variables
      2. Format Strings
        1. Formatting names
        2. Formatting Dates
        3. Formatting Places
        4. Rules for format strings
      3. Control Variables
      4. Grouping
        1. Rules for groups
        2. Examples
      5. Attributes
      6. Events
        1. Event format strings
        2. Notes for attributes and events
      7. Separators
    3. Books
      1. Manage Books dialog
        1. Book name
          1. Book name toolbar
        2. Available items
        3. Available items selections
          1. Alphabetical Index
          2. Custom Text
          3. Table of contents
          4. Title Page
        4. Current book
          1. Current book toolbar
      2. Generate Book dialog
        1. Paper Options
        2. Document Options
    4. Graphical Reports
      1. Common options
        1. Paper Options
        2. Document Options
      2. Ancestor Tree
        1. Tree Options
        2. Display
        3. Size
        4. Include
      3. Calendar
        1. Report Options
        2. Content Options
        3. Text Options
      4. Descendant Tree
        1. Tree Options
        2. Display
        3. Replace
        4. Size
        5. Include
      5. Family Descendant Tree
        1. Tree Options
        2. Display
        3. Replace
        4. Size
        5. Include
      6. Fan Chart
        1. Report Options
      7. Statistics Charts
        1. Report Options
        2. Charts 1
        3. Charts 2
      8. Timeline Chart
        1. Report Options
      9. Scale and Resize options
        1. Scale tree to fit:
        2. Resize Page to Fit Tree size
        3. inter-box Y scale factor
        4. box shadow scale factor
        5. Know what you want to print on
    5. Graphs
      1. Common Options
        1. Graphviz Layout
        2. Graphviz Options
        3. Note
      2. Family Lines Graph
        1. Report Options
        2. Report Options (2)
        3. People of Interest
        4. Include
        5. Family Colours
        6. Individuals
      3. Hourglass Graph
        1. Report Options
        2. Report Options (2)
        3. Graph Style
      4. Relationship Graph
        1. Report Options
        2. Report Options (2)
        3. Include
        4. Graph Style
        5. Example
    6. Text Reports
      1. Common options
        1. Paper Options
        2. Document Options
      2. Ahnentafel Report
        1. Report Options
      3. Birthday and Anniversary Report
        1. Report Options
        2. Text Options
      4. Complete Individual Report
        1. Report Options
        2. Include
        3. Sections
      5. Database Summary Report
        1. Report Options
      6. Descendant Report
        1. Report Options
      7. Detailed Ancestral Report
        1. Report Options
        2. Content
        3. Include
        4. Missing information
      8. Detailed Descendant Report
        1. Report Options
        2. Content
        3. Include
        4. Missing information
      9. End of Line Report
        1. Report Options
      10. Family Group Report
        1. Report Options
        2. Include
        3. Missing information
      11. Kinship Report
        1. Report Options
      12. Note Link Report
      13. Number of Ancestors Report
        1. Report Options
      14. Place Report
        1. Report Options
      15. Records Report
        1. Report Options
        2. Person Records
        3. Family Records
      16. Tag Report
        1. Report Options
    7. Web Pages
      1. Narrated Web Site
        1. Dialog tabs
          1. Report Options
          2. Page Generation
          3. Privacy
          4. Download
          5. Advanced Options
          6. Place Map Options
        2. Example Web Site output
          1. Home
          2. Introduction
          3. Individuals
          4. Surnames
          5. Families
          6. Events
          7. Places
          8. Sources
          9. Repositories
          10. Media
          11. Thumbnails
          12. Download
          13. Address Book
          14. Contact
      2. Web Calendar
        1. Dialog tabs
          1. Report Options
          2. Content Options
          3. Jan - Jun Notes
          4. Jul - Dec Notes
          5. Advanced Options
        2. Example Web Site output
    8. Quick Views
      1. All Events
      2. All Family Events
      3. On This Day
      4. Father linage
      5. Mother linage
      6. Siblings
      7. Relation to Home Person
      8. Same Given Names
      9. Same Surnames
      10. Person References
      11. Family References
      12. Event References
      13. Place References
      14. Source References
      15. Citation References
      16. Repository References
      17. Media References
      18. Link References
      19. Note References
    9. Quick View Gramplet
    10. Making your own Quick view
  14. Tools
    1. Tool Selection dialog
    2. Analysis and Exploration
      1. Compare Individual Events
    3. Family Tree Processing
      1. Database Owner Information
      2. Extract Event Description
      3. Extract Information from Names
      4. Extract Place Data from a Place Title
      5. Find Possible Duplicate People
      6. Fix Capitalization of Family Names
      7. Merge citations
      8. Rename Event Types
      9. Reorder Gramps ID
      10. Sort Events
    4. Family Tree Repair
      1. Check and Repair Database
        1. Gramps had a problem the last time it was run - dialog
      2. Rebuild Gender Statistics
      3. Rebuild Reference Maps
      4. Rebuild Secondary Indices
      5. Remove Unused Objects
    5. Utilities
      1. Media Manager
        1. Replace substrings in the path
        2. Convert paths from relative to absolute
        3. Convert paths from absolute to relative
        4. Add images not included in database
      2. Not Related
      3. Relationship Calculator
      4. Verify the Data
        1. Verify the Data tab pages
          1. General
          2. Women
          3. Men
          4. Families
        2. Data Verification Results window
        3. Examples
      5. Find database loop
    6. Debug
      1. Check Localized Date Displayer and Parser
      2. Dump Gender Statistics
      3. Generate Testcases for Persons and Families
      4. Populate Sources and Citations
  15. Settings
    1. Preferences
      1. General
        1. General Gramps settings
        2. Third party addons management
          1. Available Gramps Updates for Addons
        3. Tip of the Day dialog
      2. Family Tree
      3. Display
        1. Display Name Editor
        2. Place Format Editor
      4. Text
      5. ID Formats
      6. Dates
      7. Researcher
      8. Warnings
      9. Colors
        1. Pick a Color selector
      10. Genealogical Symbols
        1. Prerequisite to use Genealogical Symbols
          1. Initial setup
          2. Prerequisite
    2. Other settings
      1. Column Editor
      2. Sorting columns
      3. Setting Home person
      4. Adjusting viewing controls
      5. Export View
        1. Export View as Spreadsheet dialog
      6. Modularity and plugins
      7. Customize report output formats
        1. Document Styles dialog
        2. Style editor dialog
          1. Style editor dialog tabs
            1. Description
            2. Font options
            3. Paragraph options
      8. Context menu
    3. Customizing
      1. Preferences
      2. Language
        1. Linux
        2. Mac OS X
        3. MS Windows
      3. Add Windows OS Menu Item
      4. Change the windows LANG variables
      5. Language codes
      6. Advanced manipulation of settings
        1. Example gramps.ini file
        2. Advanced backup filename setting
      7. Theme
  16. Filters
    1. Filter vs. Search
    2. Regular Expressions
      1. Groups and Sets
      2. Examples
        1. Common variations of a surname
        2. testing regular expressions
    3. Custom Filters
    4. Which filters in which Category?
    5. Ancestral filters
    6. Child filters
    7. Citation/sources filters
      1. Persons-, and Relationship Category
      2. Families Category
      3. Events Category
      4. Places Category
      5. Media Category
    8. Descendant filters
    9. Event filters
      1. Persons-, and Relationship Category
      2. Families Category
    10. Family filters
    11. Father filters
    12. General filters
      1. Persons-, and Relationship Category
      2. Families Category
      3. Events Category
      4. Places Category
      5. Sources Category
      6. Citations Category
      7. Repositories Category
      8. Media Category
      9. Notes Category
    13. Mother filters
    14. Position filters
    15. Source filters
    16. Relationship filters
    17. Tagging
      1. Concept
      2. Differences with markers
      3. Tags and Filters
      4. Operations with tags
        1. Filtering
        2. Tagging a selection of objects
      5. Tags Column

Appendix A: Frequently Asked Questions
General
What is Gramps?
Where do I get it and how much does it cost?
Do I need to register as a user to use Gramps, I am not a programmer?
Does Gramps exist in other languages?
How do I keep backups?
Does Gramps support Unicode fonts?
Installation
What is needed to install Gramps under Linux, Solaris, or FreeBSD?
Does Gramps work on Windows?
Does Gramps work on the Mac?
Does Gramps work on my mobile device?
Does Gramps work on my Google Chromebook?
What are the Minimum Specs to run Gramps?
How do I upgrade Gramps?
Preferences
Can I change the dates in reports to 'day month year'?
Collaboration-Portability
Is Gramps compatible with other genealogical software?
Can Gramps read files created by other genealogy programs?
Can Gramps write files readable by other genealogy programs?
What standards does Gramps support?
How do I import data from another genealogy program into Gramps?
Can I install Gramps on a Linux Web Server and use it via a web browser?
Reports
Can Gramps print a genealogical tree for my family?
In what formats can Gramps output its reports?
How can I change the default language in reports?
Is Gramps compatible with the Internet?
Can I create custom reports/filters/whatever?
Why are non-Latin characters displayed as garbage in PDF/PS reports?
I would like to contribute to Gramps by writing my favorite report. How do I do that?
Database - Gramps file formats
What is the maximum database size (bytes) Gramps can handle?
How many people can Gramps database handle?
My database is really big. Is there a way around loading all the data into memory?
Can I run Gramps from a database on a NFS share?
What does "portable" mean?
Why is the database format (GRDB) not portable?
Does Gramps have an Example Tree?
Bugs and requests
What do I do if I have found a bug?
Requests
Adding to and editing my database
What is the difference between a residence and an address?
How do I change the order of children?
How do I change the order of spouses?

Appendix B: Keybindings reference
List Views
Common bindings
All List Views bindings
People View bindings
Editors
Editor Tab bindings
Editor bindings
Handy Shortcuts
See also

Appendix C: Command line reference
Available options
Format options
Opening options
Import options
Export options
Action options
List options
Operation
Examples
Environment variables
GRAMPSHOME
LANG, LANGUAGE, LC_MESSAGE, LC_TIME
GRAMPSI18N
GRAMPSDIR
GRAMPS_RESOURCES

Appendix D: User Directory
POSIX - style systems
Mac OS X
MS Windows

Appendix E: Error and Warning Reference
When something goes wrong
Alerts
Are you sure you want to upgrade this Family Tree?
Cannot open database
Low level database corruption detected
Error detected in database
Warnings
Locale warnings
Module not loaded warnings
Show plugin status dialog on plugin load error.
Configuration warnings
Other warnings
Cannot save person
Cannot merge <object>
Duplicate Family warning dialog
Suppress warning when adding parents to a child
Suppress warning when cancelling with changed data
Save Changes? dialog
Suppress warning about missing researcher when exporting to GEDCOM
Undo history warning
Errors
Error Report
Error Reporting Assistant dialog
Report a bug page
Error Details page
System Information page
Further Information page
Bug Report Summary page
Send Bug Report page
Complete page
Other Errors
Report could not be created
Seeing all the error messages
Linux
MS Windows
Mac OS X
Console application

Appendix F: About Gramps
About
Original author
Contributors
Have an issue or idea?
License

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