Gramps - User contributions [en]

Template:Reviews/ReviewList

2026-03-19T23:56:15Z

CallMeDave: /* 2026 */

<noinclude>Changes here are visible for all languages on [[Reviews]] , where this template is used.[[Category:Templates]]</noinclude>
__NOTOC__
==2026==
* [https://kevingal.com/blog/genealogy.html My Gramps genealogy workflow (Explaining how I use the Gramps genealogy software, including a custom website generator I made for it.)] By Kevin Galligan, 2026-03-19 - (Associated code on github: [https://github.com/Kevinpgalligan/genegenie genegenie] - Website generator for Gramps.(MIT license)) [https://www.reddit.com/r/gramps/comments/1rydzqj/my_gramps_genealogy_workflow/]

==2025==
* ?

==2024==
* ?

==2023==
* ?

==2022==
* [https://gramps.discourse.group/t/computeractive-622-5-jan-2022-gramps-sharing-events/2087/1 Grow Your Family Tree]. Computeractive magazine, (622), 16–16. Peers, N., 2022-01 ''(correction in issue 641, pg.41)''

==2021==
* Youtube video [https://youtu.be/2I-kxbOgv98 Gramps video on importing a genealogy file], By uberdorf, 2021-09-09
* [https://eogn.com/page-18080/10959060?anchor=10960779#10960779 How to Install and Use Gramps, a FREE Genealogy Program for Windows, Macintosh, and Linux/UNIX], by Anonymous, Eastman's Online Genealogy Newsletter, 2021-08-26
* [https://youtu.be/H9rP9S5KHZY Youtube:Featuring GRAMPS Features! Is It Really A Genealogy Program for All?], by Ed Thompson, Genealogy Software Showcase, 2021-03-18

==2020==

* [https://blog.eogn.com/2020/08/18/gramps-5-1-3-released/ Gramps 5.1.3 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2020-08-18
* [https://blog.eogn.com/2020/01/13/gramps-5-1-2-released/ Gramps 5.1.2 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2020-01-13
* [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps], by Ana Marculescu, Softpedia editor, 2020-01-10
* [https://windowsreport.com/family-tree-software/ Best family tree software to use [2020 Guide]], by Madalina Dinita, Managing Editor of Windows Report; 2018-03, rev. 2019-11-07

==2019==
* [https://www.reddit.com/r/gramps/comments/dres4l/updated_gramps_tutorial_video_tutorials_by/ Gramps Tutorial Video Tutorials] by TechTutorials, Gramps Reddit, 2019-11-04
** [https://youtu.be/RUFULVnWqvQ Gramps Tutorial #1: Downloading, Installing, & Uninstalling on Windows 10]
** [https://youtu.be/L5fXrfETAUw Gramps Tutorial #2: Creating Backups & Updating your Software] ''If you've already installed Gramps and want to learn using the [[Example.gramps|Example tree]], skip to 17 minutes 4 seconds in Tutorial 2.''
** [https://youtu.be/K4NZksuLCBY Gramps Tutorial #3: Program Overview v 5.1]
** [https://youtu.be/5XSMIfP-T_w Gramps Tutorial #4: Creating a tree & adding people & relationships](Gramps 5.1)
** [https://youtu.be/oY6nn3Eobb4 Gramps Tutorial #5: Repositories, Sources, & Citations](Gramps 5.1)
** [https://youtu.be/S1cOWxzBoZc Gramps Tutorial #6: Creating Events (Personal & Family)](Gramps 5.1)
** [https://youtu.be/m4iWgVvjQdg Gramps Tutorial #7: Places & Addresses](Gramps 5.1)
* [https://www.macworld.co.uk/download/hobbies-home-entertainment/gramps-511-1-344/ Gramps 5.1.1-1], by Neil Bothwick, Macworld (UK), 2019-09-21
* [https://blog.eogn.com/2019/09/17/gramps-5-1-1-released/ Gramps 5.1.1 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2019-09-17
* [https://blog.eogn.com/2019/07/08/gramps-and-other-genealogy-programs-in-the-cloud/ GRAMPS and Other Genealogy Programs in the Cloud], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2019-07-08
* [https://www.linuxlinks.com/familyhistory/ 8 Best Free Linux Family History Software], by Steve Emms,LinuxLinks 2019-03-14
* [https://fire-eggs.github.io/change_gramps_font.html How to Change the Font for Gramps on Windows], By Kevin Routley(Aka:Anon Mouse), Fire-eggs.GitHub.io, 2019-01-05

==2018==
* [https://blog.eogn.com/2018/08/13/free-and-open-source-software-foss-explained/ Free and Open-Source Software (FOSS) Explained], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2018-08-13
* [http://genealogytools.com/replacing-family-tree-maker-part-8-importing-your-ftm-tree-into-gramps-4/ Replacing Family Tree Maker, Part 8: Importing Your FTM Tree into Gramps 5], By Keith Riggle, GenealogyTools.com, 2018-08-08 ''(update of 2015-12-22 edition for Gramps 4.0)'' Includes a fair and fairly deep dive into Gramps' GEDCOM import/export idiosyncrasies.
* [https://blog.eogn.com/2018/08/07/gramps-5-0-0-released/ Gramps 5.0.0 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2018-08-07

==2017==
* [https://codeyarns.com/2017/12/09/gramps-genealogy-program/ Gramps Genealogy Program], By Ashwin, Code Yarns 👨‍💻 Notes from the world of software, 2017-12-09
* [https://www.choice.com.au/electronics-and-technology/internet/using-online-services/articles/online-family-history-services Family history online], By Ros Page, CHOICE, 2017-11-02
* [https://digital-geography.com/map-family-tree-gramps-qgis-digitize-visualize-genealogy-data/ Map your family tree with Gramps and QGIS – how to digitize and visualize genealogy data], By Jakob, Digital Geography, 2017-01-03
* [https://someonepeedinmygenepool.com/genealogy-tools Genealogy Tools:Gramps], By Kris, Someone Peed in My Gene Pool!, 2017-??-??

==2016==
* [https://blog.eogn.com/2016/12/20/gramps-4-2-5-released/ Gramps 4.2.5 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2016-12-20
* Using the Form Gramplet, By Tim Graham, Photo Restorations by Tim G.
** [https://youtu.be/Y5hijkAF6eE GRAMPS: Using the Form Gramplet], on Youtube, 2016-08-04
** [https://youtu.be/Y5hijkAF6eE GRAMPS: Defining Custom Forms for the Form Gramplet], on Youtube, 2016-08-10
* [http://blog.eogn.com/2016/03/18/genealogy-software-for-the-macintosh/ Genealogy Software for the Macintosh], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2016-03-18
* [http://youtu.be/LeNw-Y0eABs Adding marriages - video tutorial for Gramps 4.2.x - aimed at new users.], Michel Vuijlsteke on Youtube, 2016-03-03

==2015==
* [http://genealogytools.com/replacing-family-tree-maker-part-8-importing-your-ftm-tree-into-gramps-4/ Replacing Family Tree Maker, Part 8: Importing Your FTM Tree into Gramps 4], By keithr, GenealogyTools.com, 2015-12-22 ([https://web.archive.org/web/20151224061141/http://genealogytools.com/replacing-family-tree-maker-part-8-importing-your-ftm-tree-into-gramps-4 Archived])
* [http://blog.eogn.com/2015/12/10/free-genealogy-software/ Free Genealogy Software], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2015-12-10
* [https://youtu.be/IDE_MFRod_8 Gramps Genealogy Software Demo, Part Two: Creating a Printable Family Tree], Clare Walker on Youtube, 2015-09-11
* [https://youtu.be/0ODQ6s0fx9Y Gramps Genealogy Software Demo: Adding Births, Marriages and Deaths], Clare Walker on Youtube, 2015-09-11
* [http://sourceforge.net/blog/project-of-the-week-august-31-2015/ Project of the Week, August 31, 2015], by Community Team, SourceForge Community Blog, 2015-08-31
* [http://www.beholdgenealogy.com/blog/?p=1560 Database Design for Genealogy Data], Louis Kessler's Behold Blog, 2015-07-14
* [http://restorationsbytim.com/2015/06/14/tutorials-upgrading-gramps-on-debian-jessie/ Tutorials: Upgrading GRAMPS on Debian Jessie], By Tim Graham, Photo Restorations by Tim G., 2015-06-14
** [https://youtu.be/icvNUN-BMdw GRAMPS Video 3: Upgrading GRAMPS], on Youtube, 2015-06-11
* [http://youtu.be/z_Svav0tV1w Gramps Genealogy - Using places in version 4.1.3], Richard Suthern on Youtube, 2015-05-11
* [http://youtu.be/CYUBZuWhjfM Gramps Genealogy - testing options], Richard Suthern on Youtube, 2015-05-11
* [http://restorationsbytim.com/2015/03/17/screencasts-how-to-install-the-free-gramps-genealogy-software/ Tutorials: How to install the free GRAMPS genealogy software.], By Tim Graham, Photo Restorations by Tim G., 2015-03-17
** [https://youtu.be/fC3ykH7YJ58 GRAMPS Video 0: Installing on Debian-based Linux], on Youtube, 2015-03-17
** [https://youtu.be/AVpKEU8m9JI GRAMPS Video 1: Installing on Windows], on Youtube, 2015-03-17
** [https://youtu.be/9mU2zBpMrO8 GRAMPS Video 2: Getting Started with Your Family Tree], on Youtube, 2015-04-09
* [http://www.abc.net.au/tv/thecheckout/episodes/s03ep03.htm Episode 3], ''[https://youtu.be/C61tKCkR8Nk WHO DO THEY THINK THEY ARE?]'' (Gramps was recommended) - The Checkout - ABC TV (Australia), Aired 8pm, 2015-04-23
* Richard Suthern's - video tutorials for Gramps 4.1.1 - aimed at new users. , Richard Suthern on Youtube, 2015-02-16
** [http://youtu.be/44EZ1Dzirwc Overview of the interface]
** [http://youtu.be/ato3n0ZQ6hY Part 1: Start a new tree]
** [http://youtu.be/irNEaIR_vak Part 2: Start a new tree]

==2014==
* [https://youtu.be/vh4UkVId35g How to install uninstall backup and import Gramps Genealogical Software on Linux Mint or Debian], Linux Review How-To's, Compulayne.com on Youtube, 2014-11-10
* [http://blog.kyliesgenes.com/2014/08/linux-in-genealogy/ Linux In Genealogy], by Kylie Willison, Kylie's Genes Blog, 2014-08-17
* [http://www.filecluster.com/reviews/082014/gramps-genealogy-made-easy/ Gramps: Genealogy made easy], by Adam Jones, FileCluster.com, 2014-08-08
* [http://www.komando.com/downloads/1946/free-program-to-organize-and-grow-your-family-tree Free program to organize and grow your family tree], by Kim Komando, Komando.com, 2014-07-30
* [http://fedoramagazine.org/document-your-family-tree-and-track-your-genealogy-research-with-gramps-on-fedora/ Document your family tree and track your genealogy research with Gramps], by Ryan Lerch, FedoraMagazine.org, 2014-07-29.
* [https://lwn.net/Articles/605409/ Genealogy research with Gramps], by Vladimir Perić ,LWN.net ,2014-07-16.
* [http://blog.bruggen.com/2014/01/the-making-of-my-genealogy-graph.html The Making of - my genealogy graph database], by Rik Van Bruggen, Bruggen Blog, 2014-01-13.
* [http://blog.bruggen.com/2014/01/leftovers-from-holidays-genealogy-graphs.html Leftovers from the holidays: Genealogy Graphs!], by Rik Van Bruggen, Bruggen Blog, 2014-01-10.
* (French)[http://www.genealogie-en-dilettante.fr/2014/01/09/une-question-de-logicie/ Une question de logiciel], By Yann Bailly, Généalogie en dilettante, 2014-01-09.
* [http://www.beholdgenealogy.com/blog/?p=1361 How Good are GenSoftReviews Ratings?], by Louis Kessler, Louis Kessler’s Behold Blog, 2014-01-04.

==2013==
* [http://baumsuche.blogspot.com.au/2013/10/genealogy-and-technology.html Genealogy and Technology], by Hans Boldt, TreeSearch Blog, 2013-10-11
* [http://baumsuche.blogspot.com.au/2013/09/cite-those-sources.html Cite Those Sources!], by Hans Boldt, TreeSearch Blog, 2013-09-26
* [http://baumsuche.blogspot.com.au/2013/09/introducing-treesearch.html Introducing TreeSearch], by Hans Boldt, TreeSearch Blog, 2013-09-25
* [http://jennyalogist.com/2013/09/03/reviews-genealogy-software-for-mac/ Reviews: Genealogy Software for Mac], by Jenny, Jennyalogist Blog, 2013-09-03.
* [http://geneva.patch.com/groups/exploring-genealogy/p/picking-out-genealogy-software--part-2-onpremise-programs Picking Out Genealogy Software - Part 2: On-premise programs], by Pam Broviak, Exploring Genealogy - Geneva, IL Patch, 2013-07-28.
* [http://blog.nozell.com/2013/07/using-gramps-for-your-genealogy-project.html Using GRAMPS for your Genealogy Project], By Marc Nozell, Nozell, rhymes with Oh Hell Blog, 2013-07-11
* [http://www.makeuseof.com/tag/gramps-lets-you-print-free-customised-family-tree-charts-cross-platform/ Gramps lets you print free customised family tree charts cross platform], by Angela Alcorn, MakeUseOf.com, 2013-06-13.
* [https://sourceforge.net/blog/projects-of-the-week-may-27-2013/ Projects of the Week, May 27, 2013], by Community Team, SourceForge Community Blog, 2013-05-27.
* [http://www.techshout.com/features/2013/22/best-free-genealogy-software/ 6 Best Free Genealogy Software], by Joanna Maria, TechShout, 2013-05-22.
* [http://edubuntu.org/news/13.04-release Gramps 3.4.0 as new default package under Edubuntu 13.04], by Edubuntu team, edubuntu.org, 2013-04-25.
* (Hungarian)[http://dirtywindows.hu/2013/03/17/gramps/ Ingyenes programok], by László, DirtyWindows, 2013-03-17.
* [http://www.linuxuser.co.uk/tutorials/open-source-genealogy-with-gramps Open source genealogy with Gramps], by Joey Bernard, linuxuser.co.uk, 2013-03-16.
* [http://blog.eogn.com/eastmans_online_genealogy/2013/03/genealogy-programs-for-macintosh.html Genealogy Programs for Macintosh], by Dick Eastman, Eastman's Online Genealogy Newsletter, 2013-03-02.
* [http://finisterra.motd.org/?p=96 Gramps 3.4 Portuguese translation], by Frederico Muñoz, Lisp & Unix & Dragons &c., 2013-02-28.
* [http://greekheraldry.org/2013/02/15/%CE%B3%CE%B5%CE%BD%CE%B5%CE%B1%CE%BB%CE%BF%CE%B3%CE%B9%CE%BA%CF%8C-%CF%80%CF%81%CF%8C%CE%B3%CF%81%CE%B1%CE%BC%CE%BC%CE%B1-gramps/ Genealogy software: Gramps], by Ζήσης Π., Greek Heraldry Society, 2013-02-15.

==2012==
* (French)[http://www.cuk.ch/articles/5234 Gramps, la généalogie simple et gratuite], by famille Cuneo (cuk), cuk.ch, 2012-12-19
* [http://www.choice.com.au/reviews-and-tests/computers-and-online/networking-and-internet/internet/family-history-online.aspx Family history research online], by Rosalyn Page, CHOICE, 2012-12-06
* (French)[http://linuxfr.org/news/la-genealogie-avec-gramps-3-4-1 La généalogie avec GRAMPS 3.4.1], by Benoît Audouard (baud123), Licence CC by-sa, linuxfr.org, 2012-09-04
* [http://mrkimi01.blogspot.com.au/2012/08/python.html Python], by Roger Parkinson, There's no place like 127.0.0.1, 2012-08-22
* [http://www.techsupportalert.com/best-free-genealogy-family-tree-software.htm Best Free Genealogy or Family Tree Software], by okrick, Gizmo's Freeware, www.techsupportalert.com, 2012-08-13 (update since 2011-01-17)
* (German) [http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2012/08/Ahnenforschung-mit-der-Genealogie-Software-Gramps/%28printView%29/true Stück für Stück Ahnenforschung mit der Genealogie-Software Gramps], by Vincze-Aron Szabo, LinuxUser 8/2012, 2012-07-19
* [https://easterfamilygenealogy.wordpress.com/2012/07/03/technology-tuesday-from-joomla-to-gramps-narrativeweb/ Technology Tuesday – from Joomla to GRAMPS NarrativeWeb], by pramclub, Easter Family Genealogy Blog, 2012-07-03
* [http://randomtechyrants.blogspot.com.au/2012/06/gramps-genealogy-system-2.html Gramps Genealogy System #2], by Nathan Salapat, Random techy Rants, 2012-06-09
* [http://randomtechyrants.blogspot.com.au/2012/06/gramps-genealogy-system.html Gramps Genealogy System], by Nathan Salapat, Random techy Rants, 2012-06-07
* [http://www.computeractive.co.uk/ca/download-review/2171759/painstaking-family-tree-assembly-gramps Painstaking family tree assembly with Gramps], by James Temperton, Computeractive downloads, 2012-05-02
* [http://www.komando.com/downloads/category.aspx?id=12302&utm_medium=nl&utm_source=csotd&utm_content=2012-04-04 Discover your family tree] - [http://en.wikipedia.org/wiki/The_Kim_Komando_Show The Kim Komando Radio Show®], 2012-04-04
* (French)[http://www.asavar.net/blog/2012/03/07/genealogie-gestion-des-lieux-dans-gramps/ Gestion des lieux dans Gramps], by Vincent Marty, asavar.net, 2012-03-07
* (French)[http://www.asavar.net/blog/2012/02/29/test-logiciel-genealogie-gramps/ Test logiciel Généalogie Gramps], by Vincent Marty, asavar.net, 2012-02-29
* (French)[http://www.genealibre.com/2012/02/gramps-mon-logiciel-de-genealogie-sous.html Gramps, mon logiciel de généalogie sous Linux], by Marc Champagne, genealibre.com, 2012-02-09
* [http://lifeofageekadmin.com/installing-gramps-genealogical-research-software/ Installing Gramps (Genealogical Research Software)], by newlife007, lifeofageekadmin.com, 2012-02-04
* [http://shdavidson.wordpress.com/2012/01/13/the-search-for-foss/ The Search for FOSS], by shdavidson, shdavidson.wordpress.com, 2012-01-13
* [http://www.brodiefamily.co.uk/tiki-index.php?page=Genealogy+Software Genealogy Software], Brodie Clan Genealogy and Wiki, 2012-01-02

==2011==
* [http://www.3alternatives.com/3-free-wikitree-alternatives 3 Free WikiTree Alternatives], by Siddhartha, www.3alternatives.com, 2011-12-17
* [http://www.genealogybeginner.com/free-genealogy-software-making-choice#more-6316 Free Genealogy Software: Making Your Choice], by Ramona, genealogybeginner.com, 2011-12-10
* [http://www.davidmayne.co.uk/GenealogyAndFamilyHistory.pdf Introduction to Genealogy and Family History - Using the internet to research your family - With special reference to Northamptonshire] (PDF, 1.7M), www.davidmayne.co.uk, 2011-12-00
* [http://genealogy-software.pikimal.com/gramps-genealogical-research-software Gramps Genealogical Research Software], Info like Tracking Tools, Publishing And Distribution Options, Price and more, Pikimal, genealogy-software.pikimal.com, 2011-11-16
* [http://genealogy-software.findthebest.com/l/28/GRAMPS GRAMPS - Genealogy and Family Tree Software. Features, reviews, ratings.] FindTheBest, findthebest.com, ca. 2011-11-05
* (French)[http://artaiclub.free.fr/articles.php?pg=art84 Gramps. Genealogical Research and Analysis Management Programming System - La généalogie en toute liberté], le Club Informatique Artai - Logiciels Libres - Gramps, artaiclub.free.fr, 2011-11-04
* [http://mac360.com/2011/10/the-free-and-easy-way-to-track-family-genes-on-a-mac/ The Free And Easy Way To Track Family Genes On A Mac], by Jeffrey Mincey, Mac360, 2011-10-06
* [http://net.lib.byu.edu/fslab/restricted/IG_November2011.pdf GENEALOGY SOFTWARE:Free, Paid and on the Web!], By Tony Brandy, Page 15, INTERNET Genealogy (Issue: October/November 2011), 2011-09-21
* [http://fullcirclemagazine.org/issue-53/ HOW-TO GRAMPS Pt. 2], by David O. Rowell, Full Circle Magazine, Issue 53, 2011-09-00
* [http://www.ghacks.net/2011/08/22/gramps-free-genealogy-software/ Gramps, Free Genealogy Software], by Mark Brinkmann, ghacks.net, 2011-08-22
* [http://www.downloadcrew.com/article/22637-gramps_portable Gramps Portable 3.3.0 - Comprehensive and flexible genealogy research tool], by Neil Bothwick, Downloadcrew.com, updated 2011-08-17
* [http://fullcirclemagazine.org/issue-52/ HOW-TO GRAMPS Pt. 1], by David O. Rowell, Full Circle Magazine, Issue 52, 2011-08-00
* [http://blog.eogn.com/eastmans_online_genealogy/2011/07/portableappscom-portable-windows-software-on-a-usb-flash-drive.html PortableApps.com: Portable Windows Software on a USB Flash Drive], - Eastman's Online Genealogy Newsletter, 2011-07-15
* [http://genealogy.about.com/u/reviews/family_tree_software/genealogy-software-reviews/GRAMPS.htm GRAMPS - Reader Reviews Genealogy Software Reviews], (rated 4/5), by Jon Morin, genealogy.about.com, 2011-07-13
* [http://fullcirclemagazine.org/issue-51/ Review -- GRAMPS.], by Dave Rowell, Full Circle Magazine, Issue 51, 2011-07-00
* [http://www.bloodandfrogs.com/2011/06/another-look-at-gramps.html Another look at GRAMPS], by Philip, Blood and Frogs: Jewish Genealogy and More, 2011-06-27
* (German)[http://www.pro-linux.de/news/1/17149 Hundelunge und Spargeltarzan: Gramps 3.3 unterstützt Spitznamen], by Falko Benthin, Pro-Linux.de, 2011-06-14
* [https://www.joachim-breitner.de/blog/archives/492-401-page-family-book-published.html 401 page family book published], by Joachim Breitner ([http://sourceforge.net/mailarchive/message.php?msg_id=27642442 (Gramps-users) 401 page family book built using gramps]), nomeata’s mind shares, 2011-06-13
* [http://www.eolfhs.org.uk/computer%20group%20docs/Free_Genealogy_Software.pdf Free Genealogy Software], A Selection by Charlie Mead (PDF, 290K), Issued for the East of London Family History Society, www.eolfhs.org.uk, 2011-06-04
* [http://genealogy.families.com/blog/gramps-can-help-you-with-your-genealogy-research Gramps Can Help You With Your Genealogy Research], by Jen Thorpe, Families.com, 2011-06-??
* [http://blog.eogn.com/eastmans_online_genealogy/2011/05/gramps-326.html Gramps 3.2.6], Eastman's Online Genealogy Newsletter, 2011-05-05
* [http://www.tamurajones.net/DVDMediaSoftGenealogyResearchSoftware.xhtml DVDMediaSoft Genealogy Research Software], by Tamura Jones, Modern Software Experience, 2011-05-03
* (French)[http://linuxfr.org/news/gramps-a-10-ans Gramps a 10 ans...], Linux french news (LinuxFr), 2011-04-22
* [http://wardje.tumblr.com/post/461037154/gramps-genealogical-research-and-analysis-management GRAMPS - Genealogical Research and Analysis Management Programming System], Ward Muylaert Blog, 2011-03-20
* [http://www.nixternal.com/export-gedcom-file-from-ancestry-com/ Export GEDCOM File From Ancestry.com], Richard A. Johnson's Blog, 2011-03-11

* [http://www.manilastandardtoday.com/insideBusop.htm?f=2011/march/1/chinwong.isx&d=2011/march/1 The other apps], by Chin Wong, Manila Standard Today, 2011-03-01
* [http://www.eolfhs.org.uk/computer%20group%20docs/EoLFHS%20Computer%20Group%20Newsletter%202011-03.pdf Software Review -- Gramps, Genealogical Research & Analysis Management Programming System] (PDF, 250K), (rated 4/5), The East of London Family History Society Computer Group Newsletter (ed. by Charlie Mead), 2011-03-00
* [http://familyhistorylab.byu.edu/sites/familyhistorylab.byu.edu/files/macprograms.pdf Family History Programs for Macintosh], Gramps 3.2 by Grampsproject.org <nowiki>(http://gramps-project.org/)</nowiki>, (PDF, 37K), by Carl Smith, familyhistorylab.byu.edu, updated 2011-02-25
* [http://ancestryinsider.blogspot.com/2011/02/rootstech-ketchup.html RootsTech Ketchup], The Ancestry Insider, 2011-02-22
* (French)[http://blogues.cyberpresse.ca/technaute/dumais/2011/02/21/genealogie-gedcom-et-gramps/ Généalogie, Gedcom et Gramps], by Nelson Dumais, La chronique de Nelson, 2011-02-21
* [http://www.luxegen.ca/genealogy/rootstech-winner-programmer-software-challenge/ Rootstech: Winner Programmer Software Challenge], by Joan Miller, Luxegen Genealogy and Family History, 2011-02-14
* [http://assorted-experience.blogspot.com/2011/02/genealogy-software-gramps.html Genealogy software: GRAMPS], Assorted Experience, 2011-02-13
* [http://teck.in/create-collective-family-history-tree-gramps-genealogy-software.html Create Collective Family History Tree – GRAMPS Genealogy Software], TECK.IN, 2011-02-02
* [http://www.huge.org/pulppdf/pulp11/PULP%20Feb%202011.pdf Ubuntu & Linux Software], by Brian K. Lewis, The PULP, Newsletter of the Hartford User Group Exchange, (PDF, 555K), 2011-02-00
* [http://www.smokycogs.com/blog/gramps-a-pretty-decent-genealogy-app/ GRAMPS – A pretty decent genealogy app], by Serge Meunier, Smoky Cogs, 2011-01-24
* [http://mac360.com/index.php/mac360/comments/4-easy-ways-to-use-gramps-to-check-family-genealogy-on-a-mac 4 Ways To Use Gramps To Check Family Genealogy], by Alexis Kayhill, Mac360, 2011-01-24
* [http://www.bloodandfrogs.com/2011/01/gramps-325-released-for-mac-but-not.html GRAMPS 3.2.5 released for Mac, but not ready for primetime], by Philip, Blood and Frogs: Jewish Genealogy and More, 2011-01-20
* [http://www.macgenealogy.org/2011/01/19/gramps-genealogy-software-on-mac-os-x/ Gramps Genealogy Software on Mac OS X], by admin, Mac Genealogy Software, 2011-01-19
* [http://www.techsupportalert.com/best-free-genealogy-family-tree-software.htm Best Free Genealogy / Family Tree Software], by okrick, Gizmo's Freeware, www.techsupportalert.com, 2011-01-17
* [http://distrowatch.com/weekly.php?issue=20110110#news Debian 6.0 nears release, Mageia prepares to launch buildsystem, Linux Mint gets the "best distro" award, Linux Genealogy live CD], Miscellaneous News (by Ladislav Bodnar), Issue 387, DistroWatch Weekly, 2011-01-10
* [http://www.ilovefreesoftware.com/07/windows/gramps-free-genealogical-research-software.html Gramps: Free Genealogical Research Software], by Siddharth, I Love Free Software, 2011-01-07
* [http://horsethieves.com/?p=94 TMG vs GRAMPS], Denis, The Genealogy Bits, 2011-01-04
* [http://tomlowshang.blogspot.com/2011/01/other-genealogy-software.html Other Genealogy Software], Tom Low-Shang Blog, 2011-01-04

==2010==
* [http://tomlowshang.blogspot.com/2010/12/gramps-web-app.html Gramps Web App], Tom Low-Shang Blog, 2010-12-29
* [http://mini-tick.com/how-to-create-your-very-own-private-family-tree-genealogy-for-free-in-just-ten-minutes/2010/12/ How to Create your very own private family tree Genealogy for free in just ten minutes.], by gobigreenwood, mini-tick.com, 2010-12
* (German)[http://www.netzwelt.de/download/7482-gramps.html GRAMPS: Ahnenforschung einfach und übersichtlich], Bürosoftware, GRAMPS Download, netzwelt.de, 2010-12-21
* [http://portableapps.com/node/25950 10 days Gramps Portable ...], on Bart.S's blog, PortableApps.com, 2010-12-20
* [http://ask.slashdot.org/story/10/12/19/2236241/Best-Open-Source-Genealogy-Software Best Open Source Genealogy Software?] - Slashdot, 2010-12-19
* [http://www.jgen.ws/jlog/tech-tips/new-portable-apps/ New Portable Apps: Gramps & Marble], JLog, 2010-12-16
* [http://blog.eogn.com/eastmans_online_genealogy/2010/12/gramps-portable-for-windows.html Gramps Portable for Windows] - Eastman's Online Genealogy Newsletter, 2010-12-11
* [http://portableapps.com/news/2010-12-10_-_gramps_portable_3.2.5 New App: Gramps Portable 3.2.5 Released], Submitted by Bart.S, PortableApps.com, 2010-12-10
* (Russian)[http://forevertogether.ru/blog/gramps_portable_3_2_5_1_ml_by_portableapps_rus/2010-12-12-3727 Gramps Portable 3.2.5-1 ML by PortableApps (Rus?)], WEB-проект "Всегда Вместе!, 2010-12-09
* [http://blog.eogn.com/eastmans_online_genealogy/2010/11/new-linux-genealogy-cd-61-released.html New Linux Genealogy CD 6.1 Released] - Eastman's Online Genealogy Newsletter, 2010-11-29
* (Spanish)[http://www.descargar.com3.es/2010/11/gramps-3-2-5-completo-editor-de-arboles-genealogicos-compatible-con-documentos-gedcom/ GRAMPS 3.2.5-Completo editor de árboles genealógicos compatible con documentos GEDCOM] descargar.com3.es, 2010-11-25
* [http://www.brighthub.com/computing/windows-platform/articles/91190.aspx The Best Genealogy Software Rated by Features - Finding the Best Genealogy Software for Windows 7], by Christian Cawley and Bill Fulks, brighthub.com, 2010-10-15
* [http://www.grey-cat.com/curious/?p=958 A variety of tools: GenealogyJ, Gramps, and MacFamilyTree], By Judith E. Bush, Curious.Judith Blog 2010-07-07
* [http://schlesinger.us/blog/2010/06/09/consult-gramps-about-your-family-tree/ Consult Gramps about your family tree], By Lee Schlesinger, 2010-06-09
* [http://www.linux-magazine.com/Issues/2010/117/Projects-on-the-Move-Gramps-and-Puppet Free Software Projects, Projects on the Move: Gramps and Puppet], by Heike Jurzik and Andrej Fink, Linux Magazine issue 116, 2010-08
* (Spanish)[http://blogdrake.net/blog/javierreta/gramps Gramps], by javierreta, BlogDRAKE, 2010-07-02
* [http://sourceforge.net/blog/consult-gramps-about-your-family-tree/ SourceForge.net: Consult Gramps about your family tree], SourceForge blog, leeschlesinger, 2010-06-09
* (Portuguese)[http://pplware.sapo.pt/windows/software/gramps-3-2-3-cria-a-tua-arvore-genealogica-no-ubuntu/ GRAMPS 3.2.3 -- Cria a tua árvore genealógica no Ubuntu], by Pedro Pinto, pplware.sapo.pt, 2010-05-27
* (German)[http://infoblog.li/opensource-ahnenforschungs-software-gramps/ OpenSource Ahnenforschungs-Software Gramps], by Jeffrey, infoblog.li, 2010-05-22
* [http://downloads.pcauthority.com.au/article/6678-gramps Gramps 3.2.2], by Neil Bothwick, PC & Tech Authority Downloads, 2010-05-01
* [http://russellyanderson.com/mac/MacSoftware.pdf Genealogy Software for the Mac] (PDF, 9.7M), by Russell Anderson, russellyanderson.com, 2010-04-28
* [http://russellyanderson.com/mac/Mac%2520Genealogy%2520Syllabus.pdf Genealogy Software for the Macintosh] (Syllabus) (PDF, 116K), by Russell Anderson, russellyanderson.com, 2010-04-28
* [http://genealogynewsbits.com/gramps-family-tree-software-and-linux GRAMPS - Family Tree Software & LINUX], by Ted Lomatski, Genealogy News Bits, 2010-04-20
* [http://many-roads.com/?s=GRAMPS GRAMPS Use], Numerous Articles on Using and Reasons for Using GRAMPS
* [http://ostatic.com/blog/research-and-organize-your-family-tree-with-gramps Research and Organize Your Family Tree With Gramps], by Lisa Hoover, OStatic.com, 2010-03-29
* [http://b.wardje.eu/post/461037154/gramps-genealogical-research-and-analysis-management GRAMPS - Genealogical Research and Analysis Management Programming System], Ward Muylaert, 2010-03-20
*(Spanish)[http://www.cibercafedoba.es/blog/?p=247 GRAMPS 3.2.0 – Software para crear tu árbol genealógico], Cibercafé DOBA, 2010-03-18
*(Spanish)[http://www.faq-mac.com/39262/gramps-software-genealogico-tu-mac Gramps: software genealógico para tu Mac], Faq-mac.com, 2010-03-06

==2009==
* [http://www.genealogyguys.com/the_genealogy_guys_podcast_192_2009_december_21 Podcast #192 - 2009 December 21], by George G. Morgan and Drew Smith, The Genealogy Guys, 2009-12-22
* [http://www.tamurajones.net/GeneaBlogAwards2009.xhtml GeneaBlog Awards 2009, Genealogy Blog Awards: Geekiest Genealogy Blog: ''Honourable mention: The Gramps Project Blog''], by Tamura Jones, Modern Software Experience, 2009-11-30
* [http://www.articlesbase.com/genealogy-articles/the-coolest-genealogy-software-for-you-1435468.html The Coolest Genealogy Software – For YOU], ArticlesBase.com, 2009-11-09
* [http://www.gensoftreviews.com/index.php?page_id=1165 2009 Award Winners:GRAMPS - Rated 4.00 out of 5, Best Liked Genealogy Software], Genealogy Software Reviews
* [http://alternativeto.net/software/gramps/ GRAMPS Alternatives and Similar Software] and [http://alternativeto.net/software/gramps/about GRAMPS Information], AnternativeTo.net, 2009-09-28
* [http://genealogy-software.no1reviews.com/gramps.html GRAMPS Genealogy Software Review], No1Reviews.com, 2009-09-12
* [http://www.genealogywise.com/group/macgenealogist/forum/topics/gramps-on-the-mac GRAMPS on the Mac], by Doug Tallman in MacGenealogist, Genealogy Wise, 2009-09-07
* [http://www.linuxformat.co.uk/archives?issue=122 GRAMPS] (Coverdisc)HotPicks Issue:122, Linux Format, 2009-09
* [http://blog.eogn.com/eastmans_online_genealogy/2009/07/netbook-computers-for-12999-to-21999.html Netbook Computers for $129.99 to $219.99], Eastman's Online Genealogy Newsletter, 2009-07-12
* [http://blog.eogn.com/eastmans_online_genealogy/2009/06/genealogy-programs-for-the-macintosh.html Genealogy Programs for the Macintosh], Eastman's Online Genealogy Newsletter, 2009-06-30
* GRAMPS Genealogy Program (listed in [http://casdgs.org/cpage.php?pt=27 SDGS Newsletter Articles March 2004 - Current - Index to SDGS Newsletter]), San Diego Genealogical Society Newsletter, 2009-05
* [http://www.linuxformat.co.uk/archives?issue=117 GRAMPS Tutorial] by Andy Channelle, (Page ?)Issue:117, Linux Format, 2009-04
* [http://www.prodigitaltips.com/create-family-tree-with-free-genealogy-software-download-professional-genealogy-program-gramps-free/ Create Family Tree with Free Genealogy Software – Download Professional Genealogy Program GRAMPS Free] by Ranjay Mitra,Pro Digital Tips 2009-03-30
* [http://www.ormus.info/archives/278-Portable-Gramps-Genealogy-in-your-Pocket.html Portable Gramps – Genealogy in your Pocket] Ormus.info, 2009-03-28
*(Spanish)[http://www.visualbeta.es/8530/software-libre/gramps-crea-tus-propios-arboles-genealogicos/ GRAMPS, crea tus propios árboles genealógicos], By: Rafael Piñero, Visual Beta, 2009-03-08
*(Italian)[http://www.linuxfreedomforlive.blogspot.com/2009/01/gramps-creare-il-propio-albero.html Gramps creare il propio albero genealogico con Ubuntu] - LinuX Freedom for Live, 2009-01-24

==2008==
*(French)[http://www.brunocallens.com/dotclear/index.php?post/2008/12/16/Les-insuffisances-du-GEDCOM Les insuffisances du GEDCOM 5.5], Par Bruno Callens le Dimanche, Bruno Callens Recherches Généalogiques, 2008-12-21
* [http://portal.hrpr.com/2008/12/09/gramps GRAMPS], by PropHead's Blog - HR's Industrial Strength Portal, 2008-12-09
* [http://www.linuxlinks.com/article/20080403135952698/GRAMPS.html GRAMPS], LinuxLinks Portal Site, 2008-12-06, updated 2012-02-06
* [http://www.murrayc.com/blog/permalink/2008/11/13/gramps-for-geneology Gramps for Geneology], by Murray Cumming, 2008-11-13
* [http://ostatic.com/blog/trace-your-roots-with-gramps Trace Your Roots With GRAMPS] by Kristin Shoemaker,OStatic, 2008-11-13
*(German)[http://www.netzwelt.de/news/78137-freeware-woche-ahnenforschung-leichtgemacht.html Der Genealogie auf der Spur mit GRAMPS], NETZWELT, 2008-07-10
* [http://cheerfulcurmudgeon.com/2008/09/28/1-for-open-source-genealogy-software/ +1 for Open Source Genealogy Software] by Art Zemon, Cheerful Curmudgeon, 2008-09-28
* [http://bmcage.blogspot.com/2008/09/gramps-client-server-sql-django.html GRAMPS, client-server, SQL: Django?] by B. Malengier - Observations from the castle Blog 2008-09-10
*[https://wiki.edubuntu.org/UbuntuMagazine/MonthlyReviews/GRAMPS UbuntuMagazine/MonthlyReviews/GRAMPS version 2.2.6], Reviewer – Adrian Rea, Ubuntu Wiki, 2008-08-06
*(Italian)[http://www.danielesemeraro.it/2008/07/08/gramps-un-interessante-progetto-di-genealogia-open-source/ Gramps, un interessante progetto di genealogia open-source] - Daniele Semeraro , 2008-07-08
* [http://news.cnet.com/8301-13505_3-9984967-16.html Open sourcing genealogy for Linux first? Bad move]by Matt Asay,The Open Road - CNET News, 2008-07-07
* [http://www.makeuseof.com/tag/gramps-open-source-genealogy/ GRAMPS: Open Source Genealogy] - by Mackenzie Morgan - MakeUseOf.com 2008-07-05
* [http://www.tamurajones.net/SomeThoughtsonGRAMPSForWindows.xhtml Some Thoughts on GRAMPS for Windows], by Tamura Jones 2008-05-19
* [http://www.kenpardue.com/blog/2008/04/28/treefrog-user-interface-part-2/ Treefrog: User Interface, Part 2]:The Family Group Screen - Paradise Road: Ken’s Blog, 2008-04-28
*(German)[http://www.vonhaeftens-blog.de/node/144?q=node/45 Installation von gramps], Vonhaeftens Blog, 2008-04-28
*(Polish)[http://linuxnews.pl/gramps-300/ GRAMPS 3.0.0], Linux News, 2008-03-26
* [http://www.bohemianalps.com/blog/2008/03/gramps-30-coming-soon/ GRAMPS 3.0 Coming Soon!], by Jason Simanek, Bohemian Blog, 2008-03-15
*(French)[http://blog.fedora-fr.org/paquet-fedora-du-jour/post/Divertissement-du-Vendredi:-Gramps-Logiciel-de-genealogie Divertissement du Vendredi: Gramps - Logiciel de généalogie] - Paquet Fedora du jour, 2008-02-15
*(Italian)[http://fripp.wordpress.com/2008/02/04/gramps/ GRAMPS] Calogero Sanfilippo, frammenti di razionalità, 2008-02-04
* [http://www.ilovetux.com/2008/01/howto-create-and-manage-genealogy.html HowTo: Create and Manage Genealogy Family Tree via Gramps] - ILoveTux.com 2008-01-31

==2007==
* [http://www.linuxformat.co.uk/archives?issue=94 GRAMPS](Page ?) HotPicks Issue:94, Linux Format, 2007-07
* [http://www.periapsis.org/archives/2007/07/06/tellico_and_gramps.html Tellico and GRAMPS] by Robby Stephenson - periapsis.org 2007-07-06
* [http://www.fullcirclemagazine.com Interview: GRAMPS Developer],(Starts on page 24) ''Interviewed Don Allingham'' by Adrian Rea for Full Circle Magazine, 2007-06 (Go to Downloads, Issue 2, and download the pdf).
* [http://www.fullcirclemagazine.com Review: GRAMPS genealogy software],(Starts on page 29) Written by Adrian Rea for Full Circle Magazine, 2007-06 (Go to Downloads, Issue 1, and download the pdf)([https://wiki.edubuntu.org/UbuntuMagazine/MonthlyReviews/GRAMPS HTML]).
* [http://jeltsch.org/gramps GRAMPS and Suse Linux 9], By jeltsch, Michael's Domain, 2007-05-23
* [https://dilettante.wordpress.com/2007/02/22/roots-n-all/ roots ‘n all], by Jacqueline McNally, dilettante, 2007-02-22
* [http://www.linux.com/article.pl?sid=07/01/30/1938242 Track your ancestors with GRAMPS], by Alex Roitman, Linux.com, 2007-02-2
* [http://www.requisitesystems.com/article.php?story=20070105123556883 Software Review - GRAMPS], by Tom Clark, Requisite Systems, 2007-01
* [http://www.pcauthority.com.au/Download/72322,gramps-linux-family-tree-software.aspx Gramps Linux: Family tree software] - Australian PC Authority, 2007

==2006==
* [http://www.freesoftwaremagazine.com/articles/genealogy_with_gramps Genealogy with GRAMPS], by Ryan Cartwright, Free Software Magazine, 2006-12-22
* (German) [http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2006/07/Ahnenforschung-mit-Gramps Von der Wurzel bis zum Blatt Ahnenforschung mit Gramps] by Vincze-Aron Szabo, LinuxUser 7/2006, 2006-07-01
*(Italian)[http://www.tuttogenealogia.it/index.php?name=PNphpBB2&file=printview&t=371 Programmi di Genealogia - Provate questi eccellenti programmi, liberamente disponibili]("Linux Genealogy Live CD"), by Odoardo Zecca, TuttoGenealogia.it, 2006-04-19

==2005==
* [http://www.linux-mag.com/content/view/2383/ Family Trees with GRAMPS], by Scott Granneman, Linux Magazine, 2005-12-7
* [http://www.linux-magazine.com/issue/59/Gramps_Genealogy.pdf Bloodlines - Managing your family tree with GRAMPS], by Kevin Donnelly, Linux Magazine, 2005-10
* [http://www.linuxformat.co.uk/includes/download.php?PDF=LXF70.hot.pdf GRAMPS](Page 47) HotPicks Issue:70, Linux Format, 2005-09
* [http://www.redhat.com/magazine/010aug05/features/extras/ GRAMPS: A family tree research tool] - Focus on Fedora Extras - Issue #10, by Tim Waugh, redhat.com, 2005-08
* [http://www.svpafug.org/gramps_talk.htm GRAMPS for Silicon Valley Computer Genealogy Club], by Robert B. White, Silicon Valley Computer Genealogy Club, 2005-08
* [http://distrowatch.com/weekly.php?issue=20050516#tth Genealogical software - GRAMPS] - Tips, tricks & hints (by Robert Storey) - DistroWatch Weekly, Issue 100, 2005-05-16
* [http://eogn.typepad.com/eastmans_online_genealogy/2005/03/gramps_for_linu.html GRAMPS for Linux, UNIX and Macintosh OS X], by Dick Eastman, Eastman's Online Genealogy Newsletter, 2005-03-15
* [http://software.newsforge.com/software/05/01/27/0237203.shtml?tid=130&tid=2 Tracking your GRAMPS], by Joe Barr, Newsforge, 2005-01
* [http://wiki.cs.brynmawr.edu/?page=Gramps-tk Gramps-tk] - This project is currently inactive, by [[User:Dsblank|Doug Blank]], 2005
* [http://www.novell.com/coolsolutions/tools/15573.html Novell's Cool Tools] - submission by Kory Sonnier, 2005

==2004==
* [http://www.eogen.com/SoftwareLinux GRAMPS 1.0.0, a Genealogy Program for Linux], by Dick Eastman, Eastman's Online Genealogy Newsletter, 2004-12-17
* [http://www.lockergnome.com/linux/2004/07/31/gramps-and-the-family-tree/ GRAMPS And The Family Tree], by Jack Carlson, Linux Fanatics, Saturday, 2004-07-31
* [http://tech2.nytimes.com/mem/technology/techreview.html?res=9807E3D8163AF931A15757C0A9629C8B63 From Shared Resources, Your Personal History], by Peter Wayner, The New York Times, 2004-04
* [http://mamchenkov.net/wordpress/2004/03/11/gramps-and-graphviz-speak-russian/ Gramps and GraphViz speak Russian], Blog of Leonid Mamchenkov, 2004-03-11
* [http://mamchenkov.net/wordpress/2004/03/06/patching-gramps/ Patching Gramps], Blog of Leonid Mamchenkov, 2004-03-06
* [http://mamchenkov.net/wordpress/2004/03/03/more-on-gramps/ More on Gramps], Blog of Leonid Mamchenkov, 2004-03-03
* [http://mamchenkov.net/wordpress/2004/02/29/gramps-genealogical-research-and-analysis-management-programming-system/ Gramps – Genealogical Research and Analysis Management Programming System], Blog of Leonid Mamchenkov, 2004-02-29
* (French)[http://linuxfr.org/news/gramps-10 Gramps 1.0], by Linux french news (LinuxFr), 2004-02-12

==2002==
*[http://web.archive.org/web/20040215002817/http://www.linuxandmain.com/modules.php?name=News&file=article&sid=237 Climbing the family tree: Linux genealogy applications][http://www.linuxtoday.com/news_story.php3?ltsn=2002-09-25-002-26-RV-SW&tbovrmode=0], Linux and Main, 2002-09-25
* 2002-10-03: [http://media.g4tv.com/video/ttv/thescreensavers/2002/ss021003a_165_0.asf The ScreenSavers]. In 2002 GRAMPS was featured on the TechTV show, "The ScreenSavers". The video is no longer available on line from G4TV. episode of The Screen Savers available for viewing online [http://www.g4tv.com/videos/5931/Gramps_Free_Genealogy_Software_on_Screen_Savers_1032002/ (link gone)][https://web.archive.org/web/20130310120651/http://www.g4tv.com/videos/5931/gramps-free-genealogy-software-on-screen-savers-1032002/]. Open-source expert Joe Arruda demonstrates Gramps, a free genealogy program.
** See also [https://gramps-project.org/blog/2011/03/gramps-on-screen-savers-2002/ Gramps on The Screen Savers in 2002] - Gramps Blog

==General==
* [https://www.openhub.net/p/gramps Gramps], on Open hub (was Oloh.net) (Admin: bmcage )
* [https://twitter.com/grampsproject Gramps project], on Twitter (Admin: webmaster@gramps-project.org )
* [http://pypi.python.org/pypi/Gramps/ Gramps], entry on the Python Package Index (pypi) (Admin: ?? / Package Index Owner: grampsproject) [https://www.gramps-project.org/bugs/view.php?id=2621#c23504 Who Admins this?]
* [https://www.facebook.com/groups/370692133138445 GRAMPS for Genealogists], on Facebook (Admins:Tom Shaw, Dan Garnitz, Byron Howes)
* <s>[https://www.facebook.com/groups/21123310825 I use GRAMPS], on Facebook (Admin:Dan Garnitz)</s> ''[rolled into GRAMPS for Genealogists group in 2022]''
* [https://www.facebook.com/groups/363213654297545/ Dansk gramps brugergruppe(''Danish Gramps users.'')] on Facebook (Admin: [[User:Kajmikkelsen|Kaj Mikkelsen]] ) [http://gramps.1791082.n4.nabble.com/Danish-gramps-users-group-td4685245.html]
* [http://www.genealogywise.com/group/grampsfans Gramps Fans] on Genealogy Wise (Admin:Dan Garnitz)
* [http://freecode.com/projects/gramps Gramps], on freecode.com that from 2014-06-18 the site is no longer being updated(was freshmeat.net) (Admin: dallingham)
* [http://download.cnet.com/windows/gramps-project/3260-20_4-10120741.html Gramps Project] - Software Publisher Profile on Download.com (Admin: sam@gramps-project.org ) (Use https://upload.cnet.com/ to manage account)
* [https://en.wikipedia.org/wiki/Gramps_(software) Gramps(software)] article, on Wikipedia (Available in 22 languages)
* [http://www.reddit.com/r/gramps/ The Gramps Project] - Reddit (MODERATORS: mvuijlst, [[User:Dm1407|dm1407]], gumr89s0, Sam888)
* The [[Contact#IRC_.28Internet_Relay_Chat.29|IRC]]([http://en.wikipedia.org/wiki/Internet_Relay_Chat Internet relay chat]) channel for Gramps is #gramps on [https://libera.chat/ Libera Chat] (Channel Operators: Nick Hall(active)) (Moved to Libra.chat 2021-05-27)
** <s>The [[Contact#IRC_.28Internet_Relay_Chat.29|IRC]]([http://en.wikipedia.org/wiki/Internet_Relay_Chat Internet relay chat]) channel for Gramps is #gramps on [https://freenode.net/ freenode] (Channel Operators: Luigi Toscano "tosky" (active) / FuzzyTheBear (inactive) / freenode-staff (contact only for admin stuff) )[http://gramps.1791082.n4.nabble.com/irc-channel-ownership-td2989965.html][http://gramps.1791082.n4.nabble.com/irc-channel-problems-td1802850.html]</s>
* [https://groups.google.com/forum/#!forum/gramps-finland https://groups.google.com/forum/#!forum/gramps-finland] - "Gramps Finland" is a Google Group for information exchange between Finnish users of Gramps. Used for rapid delivery of Finnish translations.
* [http://www.cafepress.com/gramps_project cafepress T-Shirts gramps project], (Admin: [http://gramps.1791082.n4.nabble.com/Show-Your-Support-for-Gramps-td1797984.html#a1797990 Brian Matherly])
;Gramps Project on Sourceforge
* [http://sourceforge.net/projects/gramps/ Gramps], project page on SourceForge (Project Admins: bmcage, nick-h, dallingham, pez4brian, simanek, Sam888)
* [http://sourceforge.net/projects/gramps/files/Stable/stats/timeline Download Statistics for Gramps] on SourceForge
;Gramps Project on Github (Gramps 4.2+)
* [https://github.com/gramps-project gramps-project] project page on Github (Admin: Nick Hall)
** [https://github.com/gramps-project/gramps gramps] source
** [https://github.com/gramps-project/addons addons]
** [https://github.com/gramps-project/addons-source addons-source]

;Gramps Project Hosting etc...
* Sam Manzi is our server administrator.

** Brian Matherly and Nick Hall (also know all of the server details)
* Hosted on [https://www.a2hosting.com/ A2 Hosting] in the United States.
;Runs the following web applications
* [https://www.mediawiki.org/wiki/MediaWiki MediaWiki wiki]
* [https://wordpress.org/ Wordpress Blog]
* [https://www.mantisbt.org/ Mantis bugtracker]

Handling [[Website application upgrades]] for mediawiki/wordpress/mantisbt

;Gramps project owned domain names
* '''gramps-project.org''' - Managed by Brian Matherly [http://whois.domaintools.com/gramps-project.org]

;Other Gramps Controlled Projects on Sourceforge
*[http://sourceforge.net/projects/gramps-addons/ gramps-addons], project page on SourceForge (Project Admins: bmcage, nick-h, dsblank, gburto01, romjerome, Sam888)
*[http://sourceforge.net/projects/gramps-cd/ gramps-cd], project page on SourceForge (Project Admins: dsblank, nick-h, Sam888)
*[http://sourceforge.net/projects/gramps4win/ gramps4win], project page on SourceForge (Project Admins: fuzzyfonzy, ormus7577)

;Alternate Packagers
* [https://chocolatey.org/packages/gramps/ Chocolatey NuGet Machine Package Manager for Windows](Maintainer: [https://chocolatey.org/profiles/tunisiano tunisiano])

;Gramps Portable
* [http://portableapps.com/apps/education/gramps_portable Gramps Portable] PortableApps.com (Program page only)
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline Download Statistics for Gramps Portable] on portableapps, SourceForge
* (German)[http://www.pcwelt.de/downloads/Stammbaum-Programm-Gramps-3378588.html Gramps Portable Download - Stammbaum-Programm - PC-WELT], www.pcwelt.de

;Other
* [http://www.gensoftreviews.com/?p=286 Gramps for Linux Reviews by Users] - Genealogy Software Reviews.
** [http://www.gensoftreviews.com/?p=1648 Gramps for Windows Reviews by Users] - Genealogy Software Reviews.
** [http://www.gensoftreviews.com/?p=1649 Gramps for the Mac Reviews by Users] - Genealogy Software Reviews.
* [http://download.cnet.com/Gramps-AIO/3000-2127_4-75329870.html?tag=bc Gramps AIO - Free software downloads and software reviews - CNET Download.com], download.cnet.com
* [http://gramps.en.softonic.com/ GRAMPS page at en.softonic.com]
* (Spanish) [http://gramps.softonic.com/ GRAMPS page at softonic.com]
* (French) [http://gramps.softonic.fr/ GRAMPS page at softonic.fr]
* (German) [http://gramps.softonic.de/ Gramps page at softonic.de]
* [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps(Desktop) page at softpedia.com]
** [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps(Portable) page at softpedia.com]
* [https://en.opensuse.org/Gramps Gramps page at en.opensuse.org]
* (German)[http://www.heise.de/software/download/gramps/42382 Gramps download page at heise.de]
* (German)[http://www.chip.de/downloads/Gramps_105764449.html Gramps download page at chip.de]
* (Portuguese)[http://www.baixaki.com.br/linux/download/gramps.htm Gramps for Linux download page] and [http://www.baixaki.com.br/download/gramps.htm GRAMPS for Windows download page] at www.baixaki.com.br
* (Portuguese)[http://www.superdownloads.com.br/download/94/gramps/ Gramps Linux download page] and [http://www.superdownloads.com.br/download/163/gramps-portable/ Gramps Portable Linux download page] at www.superdownloads.com.br
* Questions marked '''gramps''' on [http://genealogy.stackexchange.com/questions/tagged/gramps genealogy.stackexchange.com/questions/tagged/gramps]
** Also to open up a question directly with the gramps tag use [http://genealogy.stackexchange.com/questions/ask?tags=gramps this.]

Template:Reviews/ReviewList

2026-03-19T23:55:02Z

CallMeDave: mentioned on reddit

<noinclude>Changes here are visible for all languages on [[Reviews]] , where this template is used.[[Category:Templates]]</noinclude>
__NOTOC__
==2026==
* [https://kevingal.com/blog/genealogy.html My Gramps genealogy workflow (Explaining how I use the Gramps genealogy software, including a custom website generator I made for it.)] By Kevin Galligan, 2026-03-19 - (Associated code on github: [https://github.com/Kevinpgalligan/genegenie genegenie] - Website generator for Gramps.(MIT license) [https://www.reddit.com/r/gramps/comments/1rydzqj/my_gramps_genealogy_workflow/]

==2025==
* ?

==2024==
* ?

==2023==
* ?

==2022==
* [https://gramps.discourse.group/t/computeractive-622-5-jan-2022-gramps-sharing-events/2087/1 Grow Your Family Tree]. Computeractive magazine, (622), 16–16. Peers, N., 2022-01 ''(correction in issue 641, pg.41)''

==2021==
* Youtube video [https://youtu.be/2I-kxbOgv98 Gramps video on importing a genealogy file], By uberdorf, 2021-09-09
* [https://eogn.com/page-18080/10959060?anchor=10960779#10960779 How to Install and Use Gramps, a FREE Genealogy Program for Windows, Macintosh, and Linux/UNIX], by Anonymous, Eastman's Online Genealogy Newsletter, 2021-08-26
* [https://youtu.be/H9rP9S5KHZY Youtube:Featuring GRAMPS Features! Is It Really A Genealogy Program for All?], by Ed Thompson, Genealogy Software Showcase, 2021-03-18

==2020==

* [https://blog.eogn.com/2020/08/18/gramps-5-1-3-released/ Gramps 5.1.3 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2020-08-18
* [https://blog.eogn.com/2020/01/13/gramps-5-1-2-released/ Gramps 5.1.2 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2020-01-13
* [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps], by Ana Marculescu, Softpedia editor, 2020-01-10
* [https://windowsreport.com/family-tree-software/ Best family tree software to use [2020 Guide]], by Madalina Dinita, Managing Editor of Windows Report; 2018-03, rev. 2019-11-07

==2019==
* [https://www.reddit.com/r/gramps/comments/dres4l/updated_gramps_tutorial_video_tutorials_by/ Gramps Tutorial Video Tutorials] by TechTutorials, Gramps Reddit, 2019-11-04
** [https://youtu.be/RUFULVnWqvQ Gramps Tutorial #1: Downloading, Installing, & Uninstalling on Windows 10]
** [https://youtu.be/L5fXrfETAUw Gramps Tutorial #2: Creating Backups & Updating your Software] ''If you've already installed Gramps and want to learn using the [[Example.gramps|Example tree]], skip to 17 minutes 4 seconds in Tutorial 2.''
** [https://youtu.be/K4NZksuLCBY Gramps Tutorial #3: Program Overview v 5.1]
** [https://youtu.be/5XSMIfP-T_w Gramps Tutorial #4: Creating a tree & adding people & relationships](Gramps 5.1)
** [https://youtu.be/oY6nn3Eobb4 Gramps Tutorial #5: Repositories, Sources, & Citations](Gramps 5.1)
** [https://youtu.be/S1cOWxzBoZc Gramps Tutorial #6: Creating Events (Personal & Family)](Gramps 5.1)
** [https://youtu.be/m4iWgVvjQdg Gramps Tutorial #7: Places & Addresses](Gramps 5.1)
* [https://www.macworld.co.uk/download/hobbies-home-entertainment/gramps-511-1-344/ Gramps 5.1.1-1], by Neil Bothwick, Macworld (UK), 2019-09-21
* [https://blog.eogn.com/2019/09/17/gramps-5-1-1-released/ Gramps 5.1.1 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2019-09-17
* [https://blog.eogn.com/2019/07/08/gramps-and-other-genealogy-programs-in-the-cloud/ GRAMPS and Other Genealogy Programs in the Cloud], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2019-07-08
* [https://www.linuxlinks.com/familyhistory/ 8 Best Free Linux Family History Software], by Steve Emms,LinuxLinks 2019-03-14
* [https://fire-eggs.github.io/change_gramps_font.html How to Change the Font for Gramps on Windows], By Kevin Routley(Aka:Anon Mouse), Fire-eggs.GitHub.io, 2019-01-05

==2018==
* [https://blog.eogn.com/2018/08/13/free-and-open-source-software-foss-explained/ Free and Open-Source Software (FOSS) Explained], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2018-08-13
* [http://genealogytools.com/replacing-family-tree-maker-part-8-importing-your-ftm-tree-into-gramps-4/ Replacing Family Tree Maker, Part 8: Importing Your FTM Tree into Gramps 5], By Keith Riggle, GenealogyTools.com, 2018-08-08 ''(update of 2015-12-22 edition for Gramps 4.0)'' Includes a fair and fairly deep dive into Gramps' GEDCOM import/export idiosyncrasies.
* [https://blog.eogn.com/2018/08/07/gramps-5-0-0-released/ Gramps 5.0.0 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2018-08-07

==2017==
* [https://codeyarns.com/2017/12/09/gramps-genealogy-program/ Gramps Genealogy Program], By Ashwin, Code Yarns 👨‍💻 Notes from the world of software, 2017-12-09
* [https://www.choice.com.au/electronics-and-technology/internet/using-online-services/articles/online-family-history-services Family history online], By Ros Page, CHOICE, 2017-11-02
* [https://digital-geography.com/map-family-tree-gramps-qgis-digitize-visualize-genealogy-data/ Map your family tree with Gramps and QGIS – how to digitize and visualize genealogy data], By Jakob, Digital Geography, 2017-01-03
* [https://someonepeedinmygenepool.com/genealogy-tools Genealogy Tools:Gramps], By Kris, Someone Peed in My Gene Pool!, 2017-??-??

==2016==
* [https://blog.eogn.com/2016/12/20/gramps-4-2-5-released/ Gramps 4.2.5 Released], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2016-12-20
* Using the Form Gramplet, By Tim Graham, Photo Restorations by Tim G.
** [https://youtu.be/Y5hijkAF6eE GRAMPS: Using the Form Gramplet], on Youtube, 2016-08-04
** [https://youtu.be/Y5hijkAF6eE GRAMPS: Defining Custom Forms for the Form Gramplet], on Youtube, 2016-08-10
* [http://blog.eogn.com/2016/03/18/genealogy-software-for-the-macintosh/ Genealogy Software for the Macintosh], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2016-03-18
* [http://youtu.be/LeNw-Y0eABs Adding marriages - video tutorial for Gramps 4.2.x - aimed at new users.], Michel Vuijlsteke on Youtube, 2016-03-03

==2015==
* [http://genealogytools.com/replacing-family-tree-maker-part-8-importing-your-ftm-tree-into-gramps-4/ Replacing Family Tree Maker, Part 8: Importing Your FTM Tree into Gramps 4], By keithr, GenealogyTools.com, 2015-12-22 ([https://web.archive.org/web/20151224061141/http://genealogytools.com/replacing-family-tree-maker-part-8-importing-your-ftm-tree-into-gramps-4 Archived])
* [http://blog.eogn.com/2015/12/10/free-genealogy-software/ Free Genealogy Software], By Dick Eastman, Eastman's Online Genealogy Newsletter, 2015-12-10
* [https://youtu.be/IDE_MFRod_8 Gramps Genealogy Software Demo, Part Two: Creating a Printable Family Tree], Clare Walker on Youtube, 2015-09-11
* [https://youtu.be/0ODQ6s0fx9Y Gramps Genealogy Software Demo: Adding Births, Marriages and Deaths], Clare Walker on Youtube, 2015-09-11
* [http://sourceforge.net/blog/project-of-the-week-august-31-2015/ Project of the Week, August 31, 2015], by Community Team, SourceForge Community Blog, 2015-08-31
* [http://www.beholdgenealogy.com/blog/?p=1560 Database Design for Genealogy Data], Louis Kessler's Behold Blog, 2015-07-14
* [http://restorationsbytim.com/2015/06/14/tutorials-upgrading-gramps-on-debian-jessie/ Tutorials: Upgrading GRAMPS on Debian Jessie], By Tim Graham, Photo Restorations by Tim G., 2015-06-14
** [https://youtu.be/icvNUN-BMdw GRAMPS Video 3: Upgrading GRAMPS], on Youtube, 2015-06-11
* [http://youtu.be/z_Svav0tV1w Gramps Genealogy - Using places in version 4.1.3], Richard Suthern on Youtube, 2015-05-11
* [http://youtu.be/CYUBZuWhjfM Gramps Genealogy - testing options], Richard Suthern on Youtube, 2015-05-11
* [http://restorationsbytim.com/2015/03/17/screencasts-how-to-install-the-free-gramps-genealogy-software/ Tutorials: How to install the free GRAMPS genealogy software.], By Tim Graham, Photo Restorations by Tim G., 2015-03-17
** [https://youtu.be/fC3ykH7YJ58 GRAMPS Video 0: Installing on Debian-based Linux], on Youtube, 2015-03-17
** [https://youtu.be/AVpKEU8m9JI GRAMPS Video 1: Installing on Windows], on Youtube, 2015-03-17
** [https://youtu.be/9mU2zBpMrO8 GRAMPS Video 2: Getting Started with Your Family Tree], on Youtube, 2015-04-09
* [http://www.abc.net.au/tv/thecheckout/episodes/s03ep03.htm Episode 3], ''[https://youtu.be/C61tKCkR8Nk WHO DO THEY THINK THEY ARE?]'' (Gramps was recommended) - The Checkout - ABC TV (Australia), Aired 8pm, 2015-04-23
* Richard Suthern's - video tutorials for Gramps 4.1.1 - aimed at new users. , Richard Suthern on Youtube, 2015-02-16
** [http://youtu.be/44EZ1Dzirwc Overview of the interface]
** [http://youtu.be/ato3n0ZQ6hY Part 1: Start a new tree]
** [http://youtu.be/irNEaIR_vak Part 2: Start a new tree]

==2014==
* [https://youtu.be/vh4UkVId35g How to install uninstall backup and import Gramps Genealogical Software on Linux Mint or Debian], Linux Review How-To's, Compulayne.com on Youtube, 2014-11-10
* [http://blog.kyliesgenes.com/2014/08/linux-in-genealogy/ Linux In Genealogy], by Kylie Willison, Kylie's Genes Blog, 2014-08-17
* [http://www.filecluster.com/reviews/082014/gramps-genealogy-made-easy/ Gramps: Genealogy made easy], by Adam Jones, FileCluster.com, 2014-08-08
* [http://www.komando.com/downloads/1946/free-program-to-organize-and-grow-your-family-tree Free program to organize and grow your family tree], by Kim Komando, Komando.com, 2014-07-30
* [http://fedoramagazine.org/document-your-family-tree-and-track-your-genealogy-research-with-gramps-on-fedora/ Document your family tree and track your genealogy research with Gramps], by Ryan Lerch, FedoraMagazine.org, 2014-07-29.
* [https://lwn.net/Articles/605409/ Genealogy research with Gramps], by Vladimir Perić ,LWN.net ,2014-07-16.
* [http://blog.bruggen.com/2014/01/the-making-of-my-genealogy-graph.html The Making of - my genealogy graph database], by Rik Van Bruggen, Bruggen Blog, 2014-01-13.
* [http://blog.bruggen.com/2014/01/leftovers-from-holidays-genealogy-graphs.html Leftovers from the holidays: Genealogy Graphs!], by Rik Van Bruggen, Bruggen Blog, 2014-01-10.
* (French)[http://www.genealogie-en-dilettante.fr/2014/01/09/une-question-de-logicie/ Une question de logiciel], By Yann Bailly, Généalogie en dilettante, 2014-01-09.
* [http://www.beholdgenealogy.com/blog/?p=1361 How Good are GenSoftReviews Ratings?], by Louis Kessler, Louis Kessler’s Behold Blog, 2014-01-04.

==2013==
* [http://baumsuche.blogspot.com.au/2013/10/genealogy-and-technology.html Genealogy and Technology], by Hans Boldt, TreeSearch Blog, 2013-10-11
* [http://baumsuche.blogspot.com.au/2013/09/cite-those-sources.html Cite Those Sources!], by Hans Boldt, TreeSearch Blog, 2013-09-26
* [http://baumsuche.blogspot.com.au/2013/09/introducing-treesearch.html Introducing TreeSearch], by Hans Boldt, TreeSearch Blog, 2013-09-25
* [http://jennyalogist.com/2013/09/03/reviews-genealogy-software-for-mac/ Reviews: Genealogy Software for Mac], by Jenny, Jennyalogist Blog, 2013-09-03.
* [http://geneva.patch.com/groups/exploring-genealogy/p/picking-out-genealogy-software--part-2-onpremise-programs Picking Out Genealogy Software - Part 2: On-premise programs], by Pam Broviak, Exploring Genealogy - Geneva, IL Patch, 2013-07-28.
* [http://blog.nozell.com/2013/07/using-gramps-for-your-genealogy-project.html Using GRAMPS for your Genealogy Project], By Marc Nozell, Nozell, rhymes with Oh Hell Blog, 2013-07-11
* [http://www.makeuseof.com/tag/gramps-lets-you-print-free-customised-family-tree-charts-cross-platform/ Gramps lets you print free customised family tree charts cross platform], by Angela Alcorn, MakeUseOf.com, 2013-06-13.
* [https://sourceforge.net/blog/projects-of-the-week-may-27-2013/ Projects of the Week, May 27, 2013], by Community Team, SourceForge Community Blog, 2013-05-27.
* [http://www.techshout.com/features/2013/22/best-free-genealogy-software/ 6 Best Free Genealogy Software], by Joanna Maria, TechShout, 2013-05-22.
* [http://edubuntu.org/news/13.04-release Gramps 3.4.0 as new default package under Edubuntu 13.04], by Edubuntu team, edubuntu.org, 2013-04-25.
* (Hungarian)[http://dirtywindows.hu/2013/03/17/gramps/ Ingyenes programok], by László, DirtyWindows, 2013-03-17.
* [http://www.linuxuser.co.uk/tutorials/open-source-genealogy-with-gramps Open source genealogy with Gramps], by Joey Bernard, linuxuser.co.uk, 2013-03-16.
* [http://blog.eogn.com/eastmans_online_genealogy/2013/03/genealogy-programs-for-macintosh.html Genealogy Programs for Macintosh], by Dick Eastman, Eastman's Online Genealogy Newsletter, 2013-03-02.
* [http://finisterra.motd.org/?p=96 Gramps 3.4 Portuguese translation], by Frederico Muñoz, Lisp & Unix & Dragons &c., 2013-02-28.
* [http://greekheraldry.org/2013/02/15/%CE%B3%CE%B5%CE%BD%CE%B5%CE%B1%CE%BB%CE%BF%CE%B3%CE%B9%CE%BA%CF%8C-%CF%80%CF%81%CF%8C%CE%B3%CF%81%CE%B1%CE%BC%CE%BC%CE%B1-gramps/ Genealogy software: Gramps], by Ζήσης Π., Greek Heraldry Society, 2013-02-15.

==2012==
* (French)[http://www.cuk.ch/articles/5234 Gramps, la généalogie simple et gratuite], by famille Cuneo (cuk), cuk.ch, 2012-12-19
* [http://www.choice.com.au/reviews-and-tests/computers-and-online/networking-and-internet/internet/family-history-online.aspx Family history research online], by Rosalyn Page, CHOICE, 2012-12-06
* (French)[http://linuxfr.org/news/la-genealogie-avec-gramps-3-4-1 La généalogie avec GRAMPS 3.4.1], by Benoît Audouard (baud123), Licence CC by-sa, linuxfr.org, 2012-09-04
* [http://mrkimi01.blogspot.com.au/2012/08/python.html Python], by Roger Parkinson, There's no place like 127.0.0.1, 2012-08-22
* [http://www.techsupportalert.com/best-free-genealogy-family-tree-software.htm Best Free Genealogy or Family Tree Software], by okrick, Gizmo's Freeware, www.techsupportalert.com, 2012-08-13 (update since 2011-01-17)
* (German) [http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2012/08/Ahnenforschung-mit-der-Genealogie-Software-Gramps/%28printView%29/true Stück für Stück Ahnenforschung mit der Genealogie-Software Gramps], by Vincze-Aron Szabo, LinuxUser 8/2012, 2012-07-19
* [https://easterfamilygenealogy.wordpress.com/2012/07/03/technology-tuesday-from-joomla-to-gramps-narrativeweb/ Technology Tuesday – from Joomla to GRAMPS NarrativeWeb], by pramclub, Easter Family Genealogy Blog, 2012-07-03
* [http://randomtechyrants.blogspot.com.au/2012/06/gramps-genealogy-system-2.html Gramps Genealogy System #2], by Nathan Salapat, Random techy Rants, 2012-06-09
* [http://randomtechyrants.blogspot.com.au/2012/06/gramps-genealogy-system.html Gramps Genealogy System], by Nathan Salapat, Random techy Rants, 2012-06-07
* [http://www.computeractive.co.uk/ca/download-review/2171759/painstaking-family-tree-assembly-gramps Painstaking family tree assembly with Gramps], by James Temperton, Computeractive downloads, 2012-05-02
* [http://www.komando.com/downloads/category.aspx?id=12302&utm_medium=nl&utm_source=csotd&utm_content=2012-04-04 Discover your family tree] - [http://en.wikipedia.org/wiki/The_Kim_Komando_Show The Kim Komando Radio Show®], 2012-04-04
* (French)[http://www.asavar.net/blog/2012/03/07/genealogie-gestion-des-lieux-dans-gramps/ Gestion des lieux dans Gramps], by Vincent Marty, asavar.net, 2012-03-07
* (French)[http://www.asavar.net/blog/2012/02/29/test-logiciel-genealogie-gramps/ Test logiciel Généalogie Gramps], by Vincent Marty, asavar.net, 2012-02-29
* (French)[http://www.genealibre.com/2012/02/gramps-mon-logiciel-de-genealogie-sous.html Gramps, mon logiciel de généalogie sous Linux], by Marc Champagne, genealibre.com, 2012-02-09
* [http://lifeofageekadmin.com/installing-gramps-genealogical-research-software/ Installing Gramps (Genealogical Research Software)], by newlife007, lifeofageekadmin.com, 2012-02-04
* [http://shdavidson.wordpress.com/2012/01/13/the-search-for-foss/ The Search for FOSS], by shdavidson, shdavidson.wordpress.com, 2012-01-13
* [http://www.brodiefamily.co.uk/tiki-index.php?page=Genealogy+Software Genealogy Software], Brodie Clan Genealogy and Wiki, 2012-01-02

==2011==
* [http://www.3alternatives.com/3-free-wikitree-alternatives 3 Free WikiTree Alternatives], by Siddhartha, www.3alternatives.com, 2011-12-17
* [http://www.genealogybeginner.com/free-genealogy-software-making-choice#more-6316 Free Genealogy Software: Making Your Choice], by Ramona, genealogybeginner.com, 2011-12-10
* [http://www.davidmayne.co.uk/GenealogyAndFamilyHistory.pdf Introduction to Genealogy and Family History - Using the internet to research your family - With special reference to Northamptonshire] (PDF, 1.7M), www.davidmayne.co.uk, 2011-12-00
* [http://genealogy-software.pikimal.com/gramps-genealogical-research-software Gramps Genealogical Research Software], Info like Tracking Tools, Publishing And Distribution Options, Price and more, Pikimal, genealogy-software.pikimal.com, 2011-11-16
* [http://genealogy-software.findthebest.com/l/28/GRAMPS GRAMPS - Genealogy and Family Tree Software. Features, reviews, ratings.] FindTheBest, findthebest.com, ca. 2011-11-05
* (French)[http://artaiclub.free.fr/articles.php?pg=art84 Gramps. Genealogical Research and Analysis Management Programming System - La généalogie en toute liberté], le Club Informatique Artai - Logiciels Libres - Gramps, artaiclub.free.fr, 2011-11-04
* [http://mac360.com/2011/10/the-free-and-easy-way-to-track-family-genes-on-a-mac/ The Free And Easy Way To Track Family Genes On A Mac], by Jeffrey Mincey, Mac360, 2011-10-06
* [http://net.lib.byu.edu/fslab/restricted/IG_November2011.pdf GENEALOGY SOFTWARE:Free, Paid and on the Web!], By Tony Brandy, Page 15, INTERNET Genealogy (Issue: October/November 2011), 2011-09-21
* [http://fullcirclemagazine.org/issue-53/ HOW-TO GRAMPS Pt. 2], by David O. Rowell, Full Circle Magazine, Issue 53, 2011-09-00
* [http://www.ghacks.net/2011/08/22/gramps-free-genealogy-software/ Gramps, Free Genealogy Software], by Mark Brinkmann, ghacks.net, 2011-08-22
* [http://www.downloadcrew.com/article/22637-gramps_portable Gramps Portable 3.3.0 - Comprehensive and flexible genealogy research tool], by Neil Bothwick, Downloadcrew.com, updated 2011-08-17
* [http://fullcirclemagazine.org/issue-52/ HOW-TO GRAMPS Pt. 1], by David O. Rowell, Full Circle Magazine, Issue 52, 2011-08-00
* [http://blog.eogn.com/eastmans_online_genealogy/2011/07/portableappscom-portable-windows-software-on-a-usb-flash-drive.html PortableApps.com: Portable Windows Software on a USB Flash Drive], - Eastman's Online Genealogy Newsletter, 2011-07-15
* [http://genealogy.about.com/u/reviews/family_tree_software/genealogy-software-reviews/GRAMPS.htm GRAMPS - Reader Reviews Genealogy Software Reviews], (rated 4/5), by Jon Morin, genealogy.about.com, 2011-07-13
* [http://fullcirclemagazine.org/issue-51/ Review -- GRAMPS.], by Dave Rowell, Full Circle Magazine, Issue 51, 2011-07-00
* [http://www.bloodandfrogs.com/2011/06/another-look-at-gramps.html Another look at GRAMPS], by Philip, Blood and Frogs: Jewish Genealogy and More, 2011-06-27
* (German)[http://www.pro-linux.de/news/1/17149 Hundelunge und Spargeltarzan: Gramps 3.3 unterstützt Spitznamen], by Falko Benthin, Pro-Linux.de, 2011-06-14
* [https://www.joachim-breitner.de/blog/archives/492-401-page-family-book-published.html 401 page family book published], by Joachim Breitner ([http://sourceforge.net/mailarchive/message.php?msg_id=27642442 (Gramps-users) 401 page family book built using gramps]), nomeata’s mind shares, 2011-06-13
* [http://www.eolfhs.org.uk/computer%20group%20docs/Free_Genealogy_Software.pdf Free Genealogy Software], A Selection by Charlie Mead (PDF, 290K), Issued for the East of London Family History Society, www.eolfhs.org.uk, 2011-06-04
* [http://genealogy.families.com/blog/gramps-can-help-you-with-your-genealogy-research Gramps Can Help You With Your Genealogy Research], by Jen Thorpe, Families.com, 2011-06-??
* [http://blog.eogn.com/eastmans_online_genealogy/2011/05/gramps-326.html Gramps 3.2.6], Eastman's Online Genealogy Newsletter, 2011-05-05
* [http://www.tamurajones.net/DVDMediaSoftGenealogyResearchSoftware.xhtml DVDMediaSoft Genealogy Research Software], by Tamura Jones, Modern Software Experience, 2011-05-03
* (French)[http://linuxfr.org/news/gramps-a-10-ans Gramps a 10 ans...], Linux french news (LinuxFr), 2011-04-22
* [http://wardje.tumblr.com/post/461037154/gramps-genealogical-research-and-analysis-management GRAMPS - Genealogical Research and Analysis Management Programming System], Ward Muylaert Blog, 2011-03-20
* [http://www.nixternal.com/export-gedcom-file-from-ancestry-com/ Export GEDCOM File From Ancestry.com], Richard A. Johnson's Blog, 2011-03-11

* [http://www.manilastandardtoday.com/insideBusop.htm?f=2011/march/1/chinwong.isx&d=2011/march/1 The other apps], by Chin Wong, Manila Standard Today, 2011-03-01
* [http://www.eolfhs.org.uk/computer%20group%20docs/EoLFHS%20Computer%20Group%20Newsletter%202011-03.pdf Software Review -- Gramps, Genealogical Research & Analysis Management Programming System] (PDF, 250K), (rated 4/5), The East of London Family History Society Computer Group Newsletter (ed. by Charlie Mead), 2011-03-00
* [http://familyhistorylab.byu.edu/sites/familyhistorylab.byu.edu/files/macprograms.pdf Family History Programs for Macintosh], Gramps 3.2 by Grampsproject.org <nowiki>(http://gramps-project.org/)</nowiki>, (PDF, 37K), by Carl Smith, familyhistorylab.byu.edu, updated 2011-02-25
* [http://ancestryinsider.blogspot.com/2011/02/rootstech-ketchup.html RootsTech Ketchup], The Ancestry Insider, 2011-02-22
* (French)[http://blogues.cyberpresse.ca/technaute/dumais/2011/02/21/genealogie-gedcom-et-gramps/ Généalogie, Gedcom et Gramps], by Nelson Dumais, La chronique de Nelson, 2011-02-21
* [http://www.luxegen.ca/genealogy/rootstech-winner-programmer-software-challenge/ Rootstech: Winner Programmer Software Challenge], by Joan Miller, Luxegen Genealogy and Family History, 2011-02-14
* [http://assorted-experience.blogspot.com/2011/02/genealogy-software-gramps.html Genealogy software: GRAMPS], Assorted Experience, 2011-02-13
* [http://teck.in/create-collective-family-history-tree-gramps-genealogy-software.html Create Collective Family History Tree – GRAMPS Genealogy Software], TECK.IN, 2011-02-02
* [http://www.huge.org/pulppdf/pulp11/PULP%20Feb%202011.pdf Ubuntu & Linux Software], by Brian K. Lewis, The PULP, Newsletter of the Hartford User Group Exchange, (PDF, 555K), 2011-02-00
* [http://www.smokycogs.com/blog/gramps-a-pretty-decent-genealogy-app/ GRAMPS – A pretty decent genealogy app], by Serge Meunier, Smoky Cogs, 2011-01-24
* [http://mac360.com/index.php/mac360/comments/4-easy-ways-to-use-gramps-to-check-family-genealogy-on-a-mac 4 Ways To Use Gramps To Check Family Genealogy], by Alexis Kayhill, Mac360, 2011-01-24
* [http://www.bloodandfrogs.com/2011/01/gramps-325-released-for-mac-but-not.html GRAMPS 3.2.5 released for Mac, but not ready for primetime], by Philip, Blood and Frogs: Jewish Genealogy and More, 2011-01-20
* [http://www.macgenealogy.org/2011/01/19/gramps-genealogy-software-on-mac-os-x/ Gramps Genealogy Software on Mac OS X], by admin, Mac Genealogy Software, 2011-01-19
* [http://www.techsupportalert.com/best-free-genealogy-family-tree-software.htm Best Free Genealogy / Family Tree Software], by okrick, Gizmo's Freeware, www.techsupportalert.com, 2011-01-17
* [http://distrowatch.com/weekly.php?issue=20110110#news Debian 6.0 nears release, Mageia prepares to launch buildsystem, Linux Mint gets the "best distro" award, Linux Genealogy live CD], Miscellaneous News (by Ladislav Bodnar), Issue 387, DistroWatch Weekly, 2011-01-10
* [http://www.ilovefreesoftware.com/07/windows/gramps-free-genealogical-research-software.html Gramps: Free Genealogical Research Software], by Siddharth, I Love Free Software, 2011-01-07
* [http://horsethieves.com/?p=94 TMG vs GRAMPS], Denis, The Genealogy Bits, 2011-01-04
* [http://tomlowshang.blogspot.com/2011/01/other-genealogy-software.html Other Genealogy Software], Tom Low-Shang Blog, 2011-01-04

==2010==
* [http://tomlowshang.blogspot.com/2010/12/gramps-web-app.html Gramps Web App], Tom Low-Shang Blog, 2010-12-29
* [http://mini-tick.com/how-to-create-your-very-own-private-family-tree-genealogy-for-free-in-just-ten-minutes/2010/12/ How to Create your very own private family tree Genealogy for free in just ten minutes.], by gobigreenwood, mini-tick.com, 2010-12
* (German)[http://www.netzwelt.de/download/7482-gramps.html GRAMPS: Ahnenforschung einfach und übersichtlich], Bürosoftware, GRAMPS Download, netzwelt.de, 2010-12-21
* [http://portableapps.com/node/25950 10 days Gramps Portable ...], on Bart.S's blog, PortableApps.com, 2010-12-20
* [http://ask.slashdot.org/story/10/12/19/2236241/Best-Open-Source-Genealogy-Software Best Open Source Genealogy Software?] - Slashdot, 2010-12-19
* [http://www.jgen.ws/jlog/tech-tips/new-portable-apps/ New Portable Apps: Gramps & Marble], JLog, 2010-12-16
* [http://blog.eogn.com/eastmans_online_genealogy/2010/12/gramps-portable-for-windows.html Gramps Portable for Windows] - Eastman's Online Genealogy Newsletter, 2010-12-11
* [http://portableapps.com/news/2010-12-10_-_gramps_portable_3.2.5 New App: Gramps Portable 3.2.5 Released], Submitted by Bart.S, PortableApps.com, 2010-12-10
* (Russian)[http://forevertogether.ru/blog/gramps_portable_3_2_5_1_ml_by_portableapps_rus/2010-12-12-3727 Gramps Portable 3.2.5-1 ML by PortableApps (Rus?)], WEB-проект "Всегда Вместе!, 2010-12-09
* [http://blog.eogn.com/eastmans_online_genealogy/2010/11/new-linux-genealogy-cd-61-released.html New Linux Genealogy CD 6.1 Released] - Eastman's Online Genealogy Newsletter, 2010-11-29
* (Spanish)[http://www.descargar.com3.es/2010/11/gramps-3-2-5-completo-editor-de-arboles-genealogicos-compatible-con-documentos-gedcom/ GRAMPS 3.2.5-Completo editor de árboles genealógicos compatible con documentos GEDCOM] descargar.com3.es, 2010-11-25
* [http://www.brighthub.com/computing/windows-platform/articles/91190.aspx The Best Genealogy Software Rated by Features - Finding the Best Genealogy Software for Windows 7], by Christian Cawley and Bill Fulks, brighthub.com, 2010-10-15
* [http://www.grey-cat.com/curious/?p=958 A variety of tools: GenealogyJ, Gramps, and MacFamilyTree], By Judith E. Bush, Curious.Judith Blog 2010-07-07
* [http://schlesinger.us/blog/2010/06/09/consult-gramps-about-your-family-tree/ Consult Gramps about your family tree], By Lee Schlesinger, 2010-06-09
* [http://www.linux-magazine.com/Issues/2010/117/Projects-on-the-Move-Gramps-and-Puppet Free Software Projects, Projects on the Move: Gramps and Puppet], by Heike Jurzik and Andrej Fink, Linux Magazine issue 116, 2010-08
* (Spanish)[http://blogdrake.net/blog/javierreta/gramps Gramps], by javierreta, BlogDRAKE, 2010-07-02
* [http://sourceforge.net/blog/consult-gramps-about-your-family-tree/ SourceForge.net: Consult Gramps about your family tree], SourceForge blog, leeschlesinger, 2010-06-09
* (Portuguese)[http://pplware.sapo.pt/windows/software/gramps-3-2-3-cria-a-tua-arvore-genealogica-no-ubuntu/ GRAMPS 3.2.3 -- Cria a tua árvore genealógica no Ubuntu], by Pedro Pinto, pplware.sapo.pt, 2010-05-27
* (German)[http://infoblog.li/opensource-ahnenforschungs-software-gramps/ OpenSource Ahnenforschungs-Software Gramps], by Jeffrey, infoblog.li, 2010-05-22
* [http://downloads.pcauthority.com.au/article/6678-gramps Gramps 3.2.2], by Neil Bothwick, PC & Tech Authority Downloads, 2010-05-01
* [http://russellyanderson.com/mac/MacSoftware.pdf Genealogy Software for the Mac] (PDF, 9.7M), by Russell Anderson, russellyanderson.com, 2010-04-28
* [http://russellyanderson.com/mac/Mac%2520Genealogy%2520Syllabus.pdf Genealogy Software for the Macintosh] (Syllabus) (PDF, 116K), by Russell Anderson, russellyanderson.com, 2010-04-28
* [http://genealogynewsbits.com/gramps-family-tree-software-and-linux GRAMPS - Family Tree Software & LINUX], by Ted Lomatski, Genealogy News Bits, 2010-04-20
* [http://many-roads.com/?s=GRAMPS GRAMPS Use], Numerous Articles on Using and Reasons for Using GRAMPS
* [http://ostatic.com/blog/research-and-organize-your-family-tree-with-gramps Research and Organize Your Family Tree With Gramps], by Lisa Hoover, OStatic.com, 2010-03-29
* [http://b.wardje.eu/post/461037154/gramps-genealogical-research-and-analysis-management GRAMPS - Genealogical Research and Analysis Management Programming System], Ward Muylaert, 2010-03-20
*(Spanish)[http://www.cibercafedoba.es/blog/?p=247 GRAMPS 3.2.0 – Software para crear tu árbol genealógico], Cibercafé DOBA, 2010-03-18
*(Spanish)[http://www.faq-mac.com/39262/gramps-software-genealogico-tu-mac Gramps: software genealógico para tu Mac], Faq-mac.com, 2010-03-06

==2009==
* [http://www.genealogyguys.com/the_genealogy_guys_podcast_192_2009_december_21 Podcast #192 - 2009 December 21], by George G. Morgan and Drew Smith, The Genealogy Guys, 2009-12-22
* [http://www.tamurajones.net/GeneaBlogAwards2009.xhtml GeneaBlog Awards 2009, Genealogy Blog Awards: Geekiest Genealogy Blog: ''Honourable mention: The Gramps Project Blog''], by Tamura Jones, Modern Software Experience, 2009-11-30
* [http://www.articlesbase.com/genealogy-articles/the-coolest-genealogy-software-for-you-1435468.html The Coolest Genealogy Software – For YOU], ArticlesBase.com, 2009-11-09
* [http://www.gensoftreviews.com/index.php?page_id=1165 2009 Award Winners:GRAMPS - Rated 4.00 out of 5, Best Liked Genealogy Software], Genealogy Software Reviews
* [http://alternativeto.net/software/gramps/ GRAMPS Alternatives and Similar Software] and [http://alternativeto.net/software/gramps/about GRAMPS Information], AnternativeTo.net, 2009-09-28
* [http://genealogy-software.no1reviews.com/gramps.html GRAMPS Genealogy Software Review], No1Reviews.com, 2009-09-12
* [http://www.genealogywise.com/group/macgenealogist/forum/topics/gramps-on-the-mac GRAMPS on the Mac], by Doug Tallman in MacGenealogist, Genealogy Wise, 2009-09-07
* [http://www.linuxformat.co.uk/archives?issue=122 GRAMPS] (Coverdisc)HotPicks Issue:122, Linux Format, 2009-09
* [http://blog.eogn.com/eastmans_online_genealogy/2009/07/netbook-computers-for-12999-to-21999.html Netbook Computers for $129.99 to $219.99], Eastman's Online Genealogy Newsletter, 2009-07-12
* [http://blog.eogn.com/eastmans_online_genealogy/2009/06/genealogy-programs-for-the-macintosh.html Genealogy Programs for the Macintosh], Eastman's Online Genealogy Newsletter, 2009-06-30
* GRAMPS Genealogy Program (listed in [http://casdgs.org/cpage.php?pt=27 SDGS Newsletter Articles March 2004 - Current - Index to SDGS Newsletter]), San Diego Genealogical Society Newsletter, 2009-05
* [http://www.linuxformat.co.uk/archives?issue=117 GRAMPS Tutorial] by Andy Channelle, (Page ?)Issue:117, Linux Format, 2009-04
* [http://www.prodigitaltips.com/create-family-tree-with-free-genealogy-software-download-professional-genealogy-program-gramps-free/ Create Family Tree with Free Genealogy Software – Download Professional Genealogy Program GRAMPS Free] by Ranjay Mitra,Pro Digital Tips 2009-03-30
* [http://www.ormus.info/archives/278-Portable-Gramps-Genealogy-in-your-Pocket.html Portable Gramps – Genealogy in your Pocket] Ormus.info, 2009-03-28
*(Spanish)[http://www.visualbeta.es/8530/software-libre/gramps-crea-tus-propios-arboles-genealogicos/ GRAMPS, crea tus propios árboles genealógicos], By: Rafael Piñero, Visual Beta, 2009-03-08
*(Italian)[http://www.linuxfreedomforlive.blogspot.com/2009/01/gramps-creare-il-propio-albero.html Gramps creare il propio albero genealogico con Ubuntu] - LinuX Freedom for Live, 2009-01-24

==2008==
*(French)[http://www.brunocallens.com/dotclear/index.php?post/2008/12/16/Les-insuffisances-du-GEDCOM Les insuffisances du GEDCOM 5.5], Par Bruno Callens le Dimanche, Bruno Callens Recherches Généalogiques, 2008-12-21
* [http://portal.hrpr.com/2008/12/09/gramps GRAMPS], by PropHead's Blog - HR's Industrial Strength Portal, 2008-12-09
* [http://www.linuxlinks.com/article/20080403135952698/GRAMPS.html GRAMPS], LinuxLinks Portal Site, 2008-12-06, updated 2012-02-06
* [http://www.murrayc.com/blog/permalink/2008/11/13/gramps-for-geneology Gramps for Geneology], by Murray Cumming, 2008-11-13
* [http://ostatic.com/blog/trace-your-roots-with-gramps Trace Your Roots With GRAMPS] by Kristin Shoemaker,OStatic, 2008-11-13
*(German)[http://www.netzwelt.de/news/78137-freeware-woche-ahnenforschung-leichtgemacht.html Der Genealogie auf der Spur mit GRAMPS], NETZWELT, 2008-07-10
* [http://cheerfulcurmudgeon.com/2008/09/28/1-for-open-source-genealogy-software/ +1 for Open Source Genealogy Software] by Art Zemon, Cheerful Curmudgeon, 2008-09-28
* [http://bmcage.blogspot.com/2008/09/gramps-client-server-sql-django.html GRAMPS, client-server, SQL: Django?] by B. Malengier - Observations from the castle Blog 2008-09-10
*[https://wiki.edubuntu.org/UbuntuMagazine/MonthlyReviews/GRAMPS UbuntuMagazine/MonthlyReviews/GRAMPS version 2.2.6], Reviewer – Adrian Rea, Ubuntu Wiki, 2008-08-06
*(Italian)[http://www.danielesemeraro.it/2008/07/08/gramps-un-interessante-progetto-di-genealogia-open-source/ Gramps, un interessante progetto di genealogia open-source] - Daniele Semeraro , 2008-07-08
* [http://news.cnet.com/8301-13505_3-9984967-16.html Open sourcing genealogy for Linux first? Bad move]by Matt Asay,The Open Road - CNET News, 2008-07-07
* [http://www.makeuseof.com/tag/gramps-open-source-genealogy/ GRAMPS: Open Source Genealogy] - by Mackenzie Morgan - MakeUseOf.com 2008-07-05
* [http://www.tamurajones.net/SomeThoughtsonGRAMPSForWindows.xhtml Some Thoughts on GRAMPS for Windows], by Tamura Jones 2008-05-19
* [http://www.kenpardue.com/blog/2008/04/28/treefrog-user-interface-part-2/ Treefrog: User Interface, Part 2]:The Family Group Screen - Paradise Road: Ken’s Blog, 2008-04-28
*(German)[http://www.vonhaeftens-blog.de/node/144?q=node/45 Installation von gramps], Vonhaeftens Blog, 2008-04-28
*(Polish)[http://linuxnews.pl/gramps-300/ GRAMPS 3.0.0], Linux News, 2008-03-26
* [http://www.bohemianalps.com/blog/2008/03/gramps-30-coming-soon/ GRAMPS 3.0 Coming Soon!], by Jason Simanek, Bohemian Blog, 2008-03-15
*(French)[http://blog.fedora-fr.org/paquet-fedora-du-jour/post/Divertissement-du-Vendredi:-Gramps-Logiciel-de-genealogie Divertissement du Vendredi: Gramps - Logiciel de généalogie] - Paquet Fedora du jour, 2008-02-15
*(Italian)[http://fripp.wordpress.com/2008/02/04/gramps/ GRAMPS] Calogero Sanfilippo, frammenti di razionalità, 2008-02-04
* [http://www.ilovetux.com/2008/01/howto-create-and-manage-genealogy.html HowTo: Create and Manage Genealogy Family Tree via Gramps] - ILoveTux.com 2008-01-31

==2007==
* [http://www.linuxformat.co.uk/archives?issue=94 GRAMPS](Page ?) HotPicks Issue:94, Linux Format, 2007-07
* [http://www.periapsis.org/archives/2007/07/06/tellico_and_gramps.html Tellico and GRAMPS] by Robby Stephenson - periapsis.org 2007-07-06
* [http://www.fullcirclemagazine.com Interview: GRAMPS Developer],(Starts on page 24) ''Interviewed Don Allingham'' by Adrian Rea for Full Circle Magazine, 2007-06 (Go to Downloads, Issue 2, and download the pdf).
* [http://www.fullcirclemagazine.com Review: GRAMPS genealogy software],(Starts on page 29) Written by Adrian Rea for Full Circle Magazine, 2007-06 (Go to Downloads, Issue 1, and download the pdf)([https://wiki.edubuntu.org/UbuntuMagazine/MonthlyReviews/GRAMPS HTML]).
* [http://jeltsch.org/gramps GRAMPS and Suse Linux 9], By jeltsch, Michael's Domain, 2007-05-23
* [https://dilettante.wordpress.com/2007/02/22/roots-n-all/ roots ‘n all], by Jacqueline McNally, dilettante, 2007-02-22
* [http://www.linux.com/article.pl?sid=07/01/30/1938242 Track your ancestors with GRAMPS], by Alex Roitman, Linux.com, 2007-02-2
* [http://www.requisitesystems.com/article.php?story=20070105123556883 Software Review - GRAMPS], by Tom Clark, Requisite Systems, 2007-01
* [http://www.pcauthority.com.au/Download/72322,gramps-linux-family-tree-software.aspx Gramps Linux: Family tree software] - Australian PC Authority, 2007

==2006==
* [http://www.freesoftwaremagazine.com/articles/genealogy_with_gramps Genealogy with GRAMPS], by Ryan Cartwright, Free Software Magazine, 2006-12-22
* (German) [http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2006/07/Ahnenforschung-mit-Gramps Von der Wurzel bis zum Blatt Ahnenforschung mit Gramps] by Vincze-Aron Szabo, LinuxUser 7/2006, 2006-07-01
*(Italian)[http://www.tuttogenealogia.it/index.php?name=PNphpBB2&file=printview&t=371 Programmi di Genealogia - Provate questi eccellenti programmi, liberamente disponibili]("Linux Genealogy Live CD"), by Odoardo Zecca, TuttoGenealogia.it, 2006-04-19

==2005==
* [http://www.linux-mag.com/content/view/2383/ Family Trees with GRAMPS], by Scott Granneman, Linux Magazine, 2005-12-7
* [http://www.linux-magazine.com/issue/59/Gramps_Genealogy.pdf Bloodlines - Managing your family tree with GRAMPS], by Kevin Donnelly, Linux Magazine, 2005-10
* [http://www.linuxformat.co.uk/includes/download.php?PDF=LXF70.hot.pdf GRAMPS](Page 47) HotPicks Issue:70, Linux Format, 2005-09
* [http://www.redhat.com/magazine/010aug05/features/extras/ GRAMPS: A family tree research tool] - Focus on Fedora Extras - Issue #10, by Tim Waugh, redhat.com, 2005-08
* [http://www.svpafug.org/gramps_talk.htm GRAMPS for Silicon Valley Computer Genealogy Club], by Robert B. White, Silicon Valley Computer Genealogy Club, 2005-08
* [http://distrowatch.com/weekly.php?issue=20050516#tth Genealogical software - GRAMPS] - Tips, tricks & hints (by Robert Storey) - DistroWatch Weekly, Issue 100, 2005-05-16
* [http://eogn.typepad.com/eastmans_online_genealogy/2005/03/gramps_for_linu.html GRAMPS for Linux, UNIX and Macintosh OS X], by Dick Eastman, Eastman's Online Genealogy Newsletter, 2005-03-15
* [http://software.newsforge.com/software/05/01/27/0237203.shtml?tid=130&tid=2 Tracking your GRAMPS], by Joe Barr, Newsforge, 2005-01
* [http://wiki.cs.brynmawr.edu/?page=Gramps-tk Gramps-tk] - This project is currently inactive, by [[User:Dsblank|Doug Blank]], 2005
* [http://www.novell.com/coolsolutions/tools/15573.html Novell's Cool Tools] - submission by Kory Sonnier, 2005

==2004==
* [http://www.eogen.com/SoftwareLinux GRAMPS 1.0.0, a Genealogy Program for Linux], by Dick Eastman, Eastman's Online Genealogy Newsletter, 2004-12-17
* [http://www.lockergnome.com/linux/2004/07/31/gramps-and-the-family-tree/ GRAMPS And The Family Tree], by Jack Carlson, Linux Fanatics, Saturday, 2004-07-31
* [http://tech2.nytimes.com/mem/technology/techreview.html?res=9807E3D8163AF931A15757C0A9629C8B63 From Shared Resources, Your Personal History], by Peter Wayner, The New York Times, 2004-04
* [http://mamchenkov.net/wordpress/2004/03/11/gramps-and-graphviz-speak-russian/ Gramps and GraphViz speak Russian], Blog of Leonid Mamchenkov, 2004-03-11
* [http://mamchenkov.net/wordpress/2004/03/06/patching-gramps/ Patching Gramps], Blog of Leonid Mamchenkov, 2004-03-06
* [http://mamchenkov.net/wordpress/2004/03/03/more-on-gramps/ More on Gramps], Blog of Leonid Mamchenkov, 2004-03-03
* [http://mamchenkov.net/wordpress/2004/02/29/gramps-genealogical-research-and-analysis-management-programming-system/ Gramps – Genealogical Research and Analysis Management Programming System], Blog of Leonid Mamchenkov, 2004-02-29
* (French)[http://linuxfr.org/news/gramps-10 Gramps 1.0], by Linux french news (LinuxFr), 2004-02-12

==2002==
*[http://web.archive.org/web/20040215002817/http://www.linuxandmain.com/modules.php?name=News&file=article&sid=237 Climbing the family tree: Linux genealogy applications][http://www.linuxtoday.com/news_story.php3?ltsn=2002-09-25-002-26-RV-SW&tbovrmode=0], Linux and Main, 2002-09-25
* 2002-10-03: [http://media.g4tv.com/video/ttv/thescreensavers/2002/ss021003a_165_0.asf The ScreenSavers]. In 2002 GRAMPS was featured on the TechTV show, "The ScreenSavers". The video is no longer available on line from G4TV. episode of The Screen Savers available for viewing online [http://www.g4tv.com/videos/5931/Gramps_Free_Genealogy_Software_on_Screen_Savers_1032002/ (link gone)][https://web.archive.org/web/20130310120651/http://www.g4tv.com/videos/5931/gramps-free-genealogy-software-on-screen-savers-1032002/]. Open-source expert Joe Arruda demonstrates Gramps, a free genealogy program.
** See also [https://gramps-project.org/blog/2011/03/gramps-on-screen-savers-2002/ Gramps on The Screen Savers in 2002] - Gramps Blog

==General==
* [https://www.openhub.net/p/gramps Gramps], on Open hub (was Oloh.net) (Admin: bmcage )
* [https://twitter.com/grampsproject Gramps project], on Twitter (Admin: webmaster@gramps-project.org )
* [http://pypi.python.org/pypi/Gramps/ Gramps], entry on the Python Package Index (pypi) (Admin: ?? / Package Index Owner: grampsproject) [https://www.gramps-project.org/bugs/view.php?id=2621#c23504 Who Admins this?]
* [https://www.facebook.com/groups/370692133138445 GRAMPS for Genealogists], on Facebook (Admins:Tom Shaw, Dan Garnitz, Byron Howes)
* <s>[https://www.facebook.com/groups/21123310825 I use GRAMPS], on Facebook (Admin:Dan Garnitz)</s> ''[rolled into GRAMPS for Genealogists group in 2022]''
* [https://www.facebook.com/groups/363213654297545/ Dansk gramps brugergruppe(''Danish Gramps users.'')] on Facebook (Admin: [[User:Kajmikkelsen|Kaj Mikkelsen]] ) [http://gramps.1791082.n4.nabble.com/Danish-gramps-users-group-td4685245.html]
* [http://www.genealogywise.com/group/grampsfans Gramps Fans] on Genealogy Wise (Admin:Dan Garnitz)
* [http://freecode.com/projects/gramps Gramps], on freecode.com that from 2014-06-18 the site is no longer being updated(was freshmeat.net) (Admin: dallingham)
* [http://download.cnet.com/windows/gramps-project/3260-20_4-10120741.html Gramps Project] - Software Publisher Profile on Download.com (Admin: sam@gramps-project.org ) (Use https://upload.cnet.com/ to manage account)
* [https://en.wikipedia.org/wiki/Gramps_(software) Gramps(software)] article, on Wikipedia (Available in 22 languages)
* [http://www.reddit.com/r/gramps/ The Gramps Project] - Reddit (MODERATORS: mvuijlst, [[User:Dm1407|dm1407]], gumr89s0, Sam888)
* The [[Contact#IRC_.28Internet_Relay_Chat.29|IRC]]([http://en.wikipedia.org/wiki/Internet_Relay_Chat Internet relay chat]) channel for Gramps is #gramps on [https://libera.chat/ Libera Chat] (Channel Operators: Nick Hall(active)) (Moved to Libra.chat 2021-05-27)
** <s>The [[Contact#IRC_.28Internet_Relay_Chat.29|IRC]]([http://en.wikipedia.org/wiki/Internet_Relay_Chat Internet relay chat]) channel for Gramps is #gramps on [https://freenode.net/ freenode] (Channel Operators: Luigi Toscano "tosky" (active) / FuzzyTheBear (inactive) / freenode-staff (contact only for admin stuff) )[http://gramps.1791082.n4.nabble.com/irc-channel-ownership-td2989965.html][http://gramps.1791082.n4.nabble.com/irc-channel-problems-td1802850.html]</s>
* [https://groups.google.com/forum/#!forum/gramps-finland https://groups.google.com/forum/#!forum/gramps-finland] - "Gramps Finland" is a Google Group for information exchange between Finnish users of Gramps. Used for rapid delivery of Finnish translations.
* [http://www.cafepress.com/gramps_project cafepress T-Shirts gramps project], (Admin: [http://gramps.1791082.n4.nabble.com/Show-Your-Support-for-Gramps-td1797984.html#a1797990 Brian Matherly])
;Gramps Project on Sourceforge
* [http://sourceforge.net/projects/gramps/ Gramps], project page on SourceForge (Project Admins: bmcage, nick-h, dallingham, pez4brian, simanek, Sam888)
* [http://sourceforge.net/projects/gramps/files/Stable/stats/timeline Download Statistics for Gramps] on SourceForge
;Gramps Project on Github (Gramps 4.2+)
* [https://github.com/gramps-project gramps-project] project page on Github (Admin: Nick Hall)
** [https://github.com/gramps-project/gramps gramps] source
** [https://github.com/gramps-project/addons addons]
** [https://github.com/gramps-project/addons-source addons-source]

;Gramps Project Hosting etc...
* Sam Manzi is our server administrator.

** Brian Matherly and Nick Hall (also know all of the server details)
* Hosted on [https://www.a2hosting.com/ A2 Hosting] in the United States.
;Runs the following web applications
* [https://www.mediawiki.org/wiki/MediaWiki MediaWiki wiki]
* [https://wordpress.org/ Wordpress Blog]
* [https://www.mantisbt.org/ Mantis bugtracker]

Handling [[Website application upgrades]] for mediawiki/wordpress/mantisbt

;Gramps project owned domain names
* '''gramps-project.org''' - Managed by Brian Matherly [http://whois.domaintools.com/gramps-project.org]

;Other Gramps Controlled Projects on Sourceforge
*[http://sourceforge.net/projects/gramps-addons/ gramps-addons], project page on SourceForge (Project Admins: bmcage, nick-h, dsblank, gburto01, romjerome, Sam888)
*[http://sourceforge.net/projects/gramps-cd/ gramps-cd], project page on SourceForge (Project Admins: dsblank, nick-h, Sam888)
*[http://sourceforge.net/projects/gramps4win/ gramps4win], project page on SourceForge (Project Admins: fuzzyfonzy, ormus7577)

;Alternate Packagers
* [https://chocolatey.org/packages/gramps/ Chocolatey NuGet Machine Package Manager for Windows](Maintainer: [https://chocolatey.org/profiles/tunisiano tunisiano])

;Gramps Portable
* [http://portableapps.com/apps/education/gramps_portable Gramps Portable] PortableApps.com (Program page only)
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline Download Statistics for Gramps Portable] on portableapps, SourceForge
* (German)[http://www.pcwelt.de/downloads/Stammbaum-Programm-Gramps-3378588.html Gramps Portable Download - Stammbaum-Programm - PC-WELT], www.pcwelt.de

;Other
* [http://www.gensoftreviews.com/?p=286 Gramps for Linux Reviews by Users] - Genealogy Software Reviews.
** [http://www.gensoftreviews.com/?p=1648 Gramps for Windows Reviews by Users] - Genealogy Software Reviews.
** [http://www.gensoftreviews.com/?p=1649 Gramps for the Mac Reviews by Users] - Genealogy Software Reviews.
* [http://download.cnet.com/Gramps-AIO/3000-2127_4-75329870.html?tag=bc Gramps AIO - Free software downloads and software reviews - CNET Download.com], download.cnet.com
* [http://gramps.en.softonic.com/ GRAMPS page at en.softonic.com]
* (Spanish) [http://gramps.softonic.com/ GRAMPS page at softonic.com]
* (French) [http://gramps.softonic.fr/ GRAMPS page at softonic.fr]
* (German) [http://gramps.softonic.de/ Gramps page at softonic.de]
* [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps(Desktop) page at softpedia.com]
** [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps(Portable) page at softpedia.com]
* [https://en.opensuse.org/Gramps Gramps page at en.opensuse.org]
* (German)[http://www.heise.de/software/download/gramps/42382 Gramps download page at heise.de]
* (German)[http://www.chip.de/downloads/Gramps_105764449.html Gramps download page at chip.de]
* (Portuguese)[http://www.baixaki.com.br/linux/download/gramps.htm Gramps for Linux download page] and [http://www.baixaki.com.br/download/gramps.htm GRAMPS for Windows download page] at www.baixaki.com.br
* (Portuguese)[http://www.superdownloads.com.br/download/94/gramps/ Gramps Linux download page] and [http://www.superdownloads.com.br/download/163/gramps-portable/ Gramps Portable Linux download page] at www.superdownloads.com.br
* Questions marked '''gramps''' on [http://genealogy.stackexchange.com/questions/tagged/gramps genealogy.stackexchange.com/questions/tagged/gramps]
** Also to open up a question directly with the gramps tag use [http://genealogy.stackexchange.com/questions/ask?tags=gramps this.]

Translating the Gramps User manual

2026-03-08T04:01:30Z

CallMeDave: /* Anchors and Links */

{{languages|Translating the Gramps User manual}}

{{man note|The user manual|is also available from within Gramps using the {{man key press|F1}} key (which opens this manual in a browser window), or from the help menu.}}
An explanation of how you can translate the [[User manual|Gramps User manual]].

==Getting started==

Translating Gramps' documentation into a new language is a worthwhile process and the Gramps team thanks you.

Documentation was moved completely to this wiki starting with Gramps version 3.0. So for translation you do not need to use or even install any fancy applications to help us. You can use your browser and start immediately. Just go to the [[User manual]] page, select the current manual and then click on your language. You should could keep the English manual open to check if there is a help page missing.

The general [[Help:Contents|wiki help page]] will help you with editing wiki pages. This wiki uses the [https://www.mediawiki.org/ MediaWiki] software, which is the same that is used by [https://wikipedia.org/wiki/Wikipedia Wikipedia], so it could feel familiar.

==Translating==

===Recommendations===
We recommend that before updating any of the user manuals:

* You have identified what your Languages two letter code is.
* You are familiar with Mediawiki [https://www.mediawiki.org/wiki/Wikitext wikitext/wiki markup/wiki code] and templates and have practiced editing on Wikipedia for a little while at least.

====Where to begin...?====

=====Practice=====
Let's practice by creating and translating a version of this page to learn what needs to be done for the user manual.

Start by initially creating a new page in your language for the translation:
* Start with the English version of the page name and add add a fowardslash <code>/</code> and then your Languages two letter lowercased code <code>xx</code> to end of the URL '''<code>/xx</code>''' eg:
<nowiki>https://gramps-project.org/wiki/index.php/Translating_the_Gramps_User_manual</nowiki>
becomes
<nowiki>https://gramps-project.org/wiki/index.php/Translating_the_Gramps_User_manual</nowiki>'''/de'''
Then press {{man button|Enter}} and wiki will show the following message:
<hr>
'''There is currently no text in this page. You can search for this page title in other pages, search the related logs, or create this page. '''
<hr>
Select the last link '''create this page.''' in the message for the page editor to open a blank page ready for the initial text.
* where you can then copy the contents of this English page by using the "edit" button at the top wiki page to access the raw wiki contents.

{{stub}}

=====Prepare the templates=====
Using what you learned above create translated versions of the first three [[#Important_re-usable_Templates|User manual templates]] - as they will used on each of the user manual pages.

Then on your languages version this page that you previously created update the Languages Template to your languages version.

=====Start with the User manual index=====
Let's begin with the user manuals index page.

Follow the steps you practiced above
* Start with the English version of the page name and add your Language code.
* Copy the contents raw contents of the English version wiki page to your Languages page.
* Change the pages English templates to use your language code
* Translate the contents of the page.

=====Continue with the rest of User manual=====
Repeat this for the rest of user manual pages.

Optional final steps
* Create screenshots in your Language ....
* Use the wiki pages '''move''' option at top of the page to rename and move your English Languages version of the page name to your language as then it will leave behind a redirection from the English page that is used by the Gramps programs Help function (as the builtin in help only adds the two letter Language code to the English version of the page name)
* links for non English user manuals don't always work because of translated title and redirection! use <code><nowiki></nowiki></code> wrapped around the relevant section title. eg:
* Request that Links to wiki manual in the Gramps program be Enabled for your Language. F1 & help menu.

{{stub}}




=====Important re-usable Templates=====
Translate the following re-usable templates/Annotations used in the user manual and few used in general on the wiki:

* User manual templates:
** [[Template:Languages|label for the Languages bar]]
** [[Template:Man index|Produces the index page in the user manual]]
** [[Template:Grampsmanualcopyright|Copyright template]]

* Important templates used in general on the wiki:
** [[Template:Third-party_addon|Third-party addon notice]] and the associated [[Third-party Addons]] page.
** [[Template:Stub|Stub template]]


* Beyond the user manual
** [[Gramps:Using_Gramps_templates|the 8 subsections of the Using Gramps portal]]


====Tools and Configuration====
[[File:WeblateSearch.png|353px|thumb|right|[https://hosted.weblate.org/projects/gramps-project/gramps/#search Weblate Search form]]]
* Use Gramps localized in that language as a reference and do not simply guess the words. Verify your translated text actually matches what the user will see in the standard localized Gramps installation. You can [https://hosted.weblate.org/projects/gramps-project/gramps/#search search the Weblate translations]. (i.e., searching for the phrase <code>source:"Relationship Information" AND language:fr</code> finds French translation: "Information sur la relation". Clicking that translation says that that phrase was found that phrase in the <code>editfamily</code> code and lists the other nearby translated text. This includes Tips as well as labels.)
* If the localized interface has a typo or incorrect translation, document the '''''EXISTING''''' interface. Do not mislead the user into expecting something else. They might waste time searching for an non-existent update.
* Do not have any third party addons loaded. Use a vanilla version of Gramps unless documenting that particular addon.
* Also, preferably use a fresh copy of the [[Example.gramps]] family tree for any screenshots in your preferred language.

=== Anchors and Links ===
Each heading line - no matter how many equal signs it contains - creates an anchor, which can be linked to.
There are reasons to keep the English heading text together with the translated heading text. For example when using the Help button in a Gramps dialog window, it usually links to a specific section in a chapter in the manual. This link will typically refer to the English header text, but when running Gramps in another language, the link might not be available in the translated manual.

An example
The User Manual chapter [[Gramps_6.0_Wiki_Manual_-_Navigation|Navigation]] contains the section [[Gramps_6.0_Wiki_Manual_-_Navigation#Using Gramplets|Using Gramplets]].
When translating the '<code>=== Using Gramplets ===</code>' section e.g. to Danish, the section header becomes '<code>=== Brug af Gramplets ===</code>'.
To keep the English anchor together with the translated anchor, the English header text can be included in a span tag:

: <pre>=== Brug af Gramplets ===</pre>

The span tag will not be shown, when reading the manual page.

When keeping the English anchor, the page section can be referred to in different ways:

: [[Da:Gramps_6.0_brugsanvisning_-_Navigation#Brug_af_Gramplets|Da:Gramps_6.0_brugsanvisning_-_Navigation#Brug_af_Gramplets]] 
: [[Gramps_6.0_Wiki_Manual_-_Navigation/da#Using Gramplets|Gramps_6.0_Wiki_Manual_-_Navigation/da#Using Gramplets]]

==== Shorthand links ====
When linking to a section on the '''same page''' you can use a short form of the link.

Both the full link [[Translating_the_Gramps_User_manual#Translating|<nowiki>[[Translating_the_Gramps_User_manual#Translating]]</nowiki>]] and the shorthand link [[#Translating|<nowiki>[[#Translating]]</nowiki>]] links to the same section on this page.

Using the shorthand link makes the text more readable, when editing the manual page.

===Handling of Translations Errors===
Translation errors, typos and revisions are inevitable.

It is important that documentation describe software as it currently exists... not as it ''should be'' in a perfect world.

That acknowledgment of a localization problem in the wiki doesn't mean that the problem cannot or will not be fixed. Rather than patch the problem in documentation, file a translation bug report, see [[Using the bug tracker|How to report bugs]]. A good bug report will also include a link to the wiki page that will need to be revised. The wiki page link gives the developer a second viewpoint of the nature of the problem. This helps if the bug report accidentally omits key information.

There is no requirement to pretend a problem doesn't exist while waiting for a fix. It is reasonable to annotate that the translation has the problem in the wiki without misleading the user into expecting something else.

You can make this annotation easier to eliminate after the bug fix. An English version Warning box like below can be inserted with the wiki code snippet that follows it. You might notice that the snippet has a chunk commented out:
<pre></pre>
By moving the comment markers, you can re-cycle this same warning and easily update to inform that a Bug has been filed and when a correction was released. When the manual is rolled over for the corrected release, you can update the main text and any affected screenshots before removing the warning entirely.
{{man warn|1=[https://omniglot.com/language/phrases/hovercraft.htm My hovercraft is full of eels]|2=An unfortunate translation in the Gramps 4.1.0 interface is documented above. A "localization" Gramps bug report {{bug|7854}} has been filed... so any corrections ''(version 4.1.1)'' might make this warning obsolete.

{{WikiContributorRecruiting}} Or join [[Portal:Translators|our volunteers]] translating the interface.
}}
<pre>{{man warn|1=[https://omniglot.com/language/phrases/hovercraft.htm My hovercraft is full of eels]|2=An unfortunate translation in the Gramps 4.1.0 interface is documented above. A "localization" Gramps bug report {{bug|7854}} has been filed... so any corrections ''(version 4.1.1)'' might make this warning obsolete.

{{WikiContributorRecruiting}} Or join [[Portal:Translators|our volunteers]] translating the interface.
}}</pre>

===Screenshots===
Localized screenshots (aka: figures ) are useful for the localized manual.

====Create the screenshots====
If you can provide screenshots that would be great as fortunately, one does not have to speak the language to make screenshots :-)

If you need help, ask on the Gramps forum and somebody will help you.

Use the following file naming convention/scheme:
* '''{<code>filename</code>}-{<code>gramps version number</code>}-{<code>locale</code>}.png''' eg: <code>Mainwin-{{Stable branch}}-fr.png</code>
** Where <code>filename</code> is always exactly the English filename
** <code>gramps version number</code> - Is the current two digit release number eg: Currently version {{Stable branch}}
** <code>locale</code> is your two letter language code. Use the [https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements Language code table] on Wikipedia, the free encyclopedia.
** <code>.png</code> - always use this file type to save the images as.
* If the screenshot/figure is language independent (such as an unlabeled icon) then just call it <code>figure_name-{{Stable branch}}.png</code>.

;Screenshot advice:You can use the Linux tool called imagemagick for taking Gramps screenshots for this wiki. (imagemagick should be installed with every Linux distribution. If not with your installation, get it!) Invoke the preferred command options by using : <pre>import -quality 100 -trim -delay 200 -resize 500 -density 100x100 -frame -channel RGB -depth 8 screenshot.png </pre>This creates a fully compressed (<code>-quality 100</code>), timed screenshot after 2 seconds (<code>-delay 200</code>) of size 500 pixels wide (<code>-resize 500</code>), with resolution 100 (<code>-density 100x100</code>), with the window frame attached (<code>-frame</code>) in RGB mode (<code>-channel RGB</code>) and bbp 24 (<code>-depth 8</code>). This creates images of 5 inches wide, which fit nicely on a book page, as well as on a HTML page.

Also see:
* [[Screenshots]] - gallery of available references for screenshots in different languages and past versions.

====Upload the screenshots====
You can learn to upload files to this wiki by following the advice on:
* [https://www.mediawiki.org/wiki/Help:Managing_files Help:Managing files] '''Upload a file''' section - on the Mediawiki website

Make sure to complete the "Summary" before uploading the file to wiki.

==Links to wiki manual==

Your recently translated manual can be made available from within Gramps. When the localized wiki pages pages appear from clicking the {{man button|Help}} button in Gramps dialogs or pressing the {{Man key press|F1}} key, the manual is considered [[User_manual#Enabled|enabled]] or activated.

You activate the manual by editing the following file: '''[https://github.com/gramps-project/gramps/blob/master/gramps/gui/display.py gramps/gui/display.py]''' to contain your language code, you may also contact the developers of Gramps by opening a ''Feature request'' for the new language on the [[Using_the_bug_tracker |Bug tracker]].

In that file, you see:

<pre>
MANUALS = {
'nl' : '/nl',
}
</pre>

This maps a language code to the extension used on the wiki, so to add french, change this to:

<pre>
MANUALS = {
'nl' : '/nl',
'fr' : '/fr',
}
</pre>

*Every '<code>manual|...</code>' entry in the gramp.pot file refers to a section in the manual, so make sure to use good section headings so this does not change too much over time.

Note that reports/tools link to a section in the page with the same name as the report name in Gramps.

*You should be able to edit directly on wiki or using tools like [https://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/txt2po.html#mediawiki txt2po] and [https://weblate.org/ Weblate].

Also previous gettext file for the manual and [https://wikipedia.org/wiki/Translation_memory Translation Memory] may help you to upgrade deprecated/old gettext files.

==Possible improvement==

A project like [https://www.gnucash.org/ GnuCash] provides a complete web site environment by using gettext files, see [https://github.com/Gnucash/gnucash/blob/master/README README file] and current [https://github.com/Gnucash/gnucash environment].

[[Category:Translators/Categories]]
[[Category:Developers/General]]
[[Category:WikiContributors|Translators/enabled manual]]

Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 2

2026-03-08T03:56:50Z

CallMeDave: /* Note properties */ letter missing

{{man index|Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 1|Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 3|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 2}}
{{#vardefine:chapter|9.2}}
{{#vardefine:figure|0}}
'''Entering and editing data: detailed Events, Media, Places, Source Citations, Notes''' 

The previous section offered you a detailed overview of how to enter and edit data for people, relationships and dates. This section continues with other objects you encounter in Gramps.

== Editing information about events ==
[[File:EventsCategory-EventsListView-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events Category - Events (List) View - example]]

Adding an Event to a person allows you to record information you have found.

When adding an event to the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Events_Category|Events Category]]}}, the {{man label|[[#New_Event_dialog|New Event]]}} dialog appears.

To add or edit event data, switch to the {{man label|Event}} Category View and select the desired entry in the list of events. Double-click on that entry or click {{man button|Edit}} on the toolbar to invoke the following {{man label|[[#New_Event_dialog|New Event]]}} dialog.
{{-}}
===New Event dialog===
[[File:EditEvent-dialog-example-60.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit Event - dialog - example]]
When Events are edited through the {{man label|Event Editor}} dialog. This dialog can be accessed by: double-clicking a row in the Event category view. Events can also be edited in the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|{{man label|Events}} tab]] of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog, or the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events_2|{{man label|Events}} tab]] of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor]]}} dialog. When editing events via the Person Editor or the Family Editor the [[#Event Reference Editor dialog|Event Reference Editor dialog]] is used.

The top part lets you view and edit basic information about the event:
* The {{man label|Event type:}} can be selected from the available types listed in the Event type drop-down menu. e.g., '''Birth''' (''default''), Baptism, Death, Burial, etc. Gramps You can enter you own Event [[Gramps_Glossary#custom|Custom Types]] by typing directly into the textbox portion of the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Selector_Combo_Boxes|selector combo box]].
* The {{man label|Date:}} of the event can be an exact date, a range (''from ... to ..., between ...''), or an inexact date (''about ...'').
** [[File:22x22-gramps-date.png]]{{man button|Invoke date editor}} button starts the {{man label|Date selection}} dialog.
* The {{man label|Description:}} field gives you the opportunity to give a longer description what this event is.
** {{man button|Record is Public}} - Toggle the Privacy lock to mark the event record as private which allows it to be omitted from reports.
* The {{man label|Place:}} can be selected from a list of previously entered place using the {{man button|Select an existing place}} button or entered anew using the {{man button|Add a new place}} button. Additionally, you can drag and drop a place entry into this field.
* The {{man label|ID:}} is a unique identifier for the event. Leave this field blank to allow Gramps to generate this value automatically for new events.
* The {{man label|Tags:}} allow you to select an existing tag using the {{man button|Edit the tag list}} button.

At the bottom of the window are the {{man button|OK}} and {{man button|Cancel}} buttons. Clicking {{man button|OK}} will apply all the changes made in all tabs and close the dialog window, unless you have not entered data then you will be shown the {{man label|[[#Cannot_save_event_warning dialog|Cannot save event]]}} warning. Clicking the {{man button|Cancel}} button will close the window without applying any changes. Selecting {{man button|Help}} will bring you here.

====New Event tab pages====
The central part of the window displays tabs containing different categories of information. Click on a tab to view or edit its contents. The tabs provide the following information categories of the event data:

{{man tip|Interface Indicator Tip|If a tab label has an icon and is in '''boldface''' type, this indicates that the tab contains data. If not, it has no data. This saves having to flip through empty tabs in sequence. It also helps when skimming for missing data.}}
=====Source Citations=====

:The {{man label|Sources Citations}} tab lets you view and edit sources relevant to an event. The central part of the window lists all such source references stored in the database. The buttons {{man button|+}}, {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a source reference associated with an event. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.

=====Notes=====

:The {{man label|Notes}} tab provides a place to record notes or comments about the event. To add a note or modify existing notes simply edit the text in the text entry field.

=====Gallery=====

:The {{man label|Gallery}} tab

=====Attributes=====

:The {{man label|Attributes}} tab

=====References=====

:The {{man label|References}} tab
{{-}}
====Cannot save event warning dialog====
[[File:Cannot-save-event-warning-dialog-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Cannot save event - warning dialog]]

{{man label|Cannot save event}} warning dialog. No data exist for this event. Please enter data or cancel the edit. Press {{man button|Close}} to return to the {{man label|[[#New_Event_dialog|New Event Editor]]}}.
{{-}}

== Editing event references ==

Event references connect a Event to a person and allow you to provide additional information about the event.

When adding event references to a {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Edit Person]]'s Events}} tab, the {{man label|[[#Event_Reference_Editor_dialog|Event Reference Editor]]}} dialog appears.

{{-}}
===Event Reference Editor dialog===

{{man tip| Reference versus Shared Information Tip |'''References Information''' in the top of this dialog is specific to the particular reference from a Primary Object. A single object (such as an Event) can be referenced many times, and all such references will have in common the '''Shared Information'''. This expanded [[Gramps_Glossary#object_editor|object editor]] dialog lets you provide both the reference-specific data (such as relevant role), attribute to further specify and document the reference.}}

Accessing the [[Gramps_Glossary#reference_object_editor|reference object editor]] .

[[File:EventReferenceEditor-dialog-default-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Event Reference Editor - dialog]]

The {{man label|New Citation}} dialog includes two sections, {{man label|Reference Information}} and {{man label|Shared Information}}.
* The {{man label|Reference Information}} section indicates the details associated with the particular reference to this Event: {{man label|General}}, {{man label|Source Citations}}, {{man label|Attributes}}, {{man label|Notes}}.
* The {{man label|Shared Information}} displays : {{man label|General}}, {{man label|Source Citations}}, {{man label|Attributes}}, {{man label|Notes}}, {{man label|Gallery}}, {{man label|References}}.

{{-}}
====Reference Information ====

=====Reference Information tab pages =====

======General======
For the {{man label|Role:}} of the person in this event, use the Role [[Gramps_Glossary#selector_combo_box|selector combo box]]. Select '''[[Gramps_Glossary#primary|Primary]]''' (which is the ''default'' during an Add Event) option for the main beneficiary. Select a descriptive Event Role (e.g., [[Gramps_Glossary#aide|Aide]], [[Gramps_Glossary#bride|Bride]], [[Gramps_Glossary#celebrant|Celebrant]], [[Gramps_Glossary#clergy|Clergy]], [[Gramps_Glossary#family_role|Family]], [[Gramps_Glossary#godparent|Godparent]], [[Gramps_Glossary#groom|Groom]], [[Gramps_Glossary#informant|Informant]], [[Gramps_Glossary#witness|Witness]]) for a Events where the Person is not the Primary participant.

Events added to a Person via the Share or by drag'n'drop will be assigned the '''[[Gramps_Glossary#unknown|Unknown]]''' Event Role by default. If the Person holds an equal Role, set their Role to Primary as well.

If none of the pre-defined Roles are appropriate, add a Role ''[[Gramps_Glossary#custom|Custom Types]]'' in text box portion of the [[Gramps_Glossary#selector_combo_box|selector combo box]]. Keyboarding in the new, unique Role name (rather than selecting one from the pull-down menu) creates a new Role custom type. New Role custom types will be added to the pull-down menu list. It remains there until the Tree is exported & re-imported or cleaned via a [[Third-party_Addons|Third party addon]] Utility like [[Addon:Types_Cleanup_Tool|Type Cleanup]].

Some example Custom Types for Event Roles are suggested in the [[Roles,_Relationships_%26_Associations|Roles, Relationships and Associations]] article.
{{-}}

======Source Citations======

{{-}}
======Attributes======

======Notes======

{{-}}{{-}}
====Shared Information ====
{{stub}}
{{-}}
======General======
{{man note|Any changes in the shared event information|will be reflected in the event itself, for all participants in the event.}}
{{-}}

======Source Citations======
{{-}}
======Attributes======
{{-}}
======Notes======
{{-}}
======Gallery======
{{-}}
======References======
{{-}}

== Editing information about media objects ==

To add or edit media data objects, switch to the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Media_Category|Media]]}} Category View and for existing media object select the desired entry in the media list. Double-click on that entry or click {{man button|Edit}} on the toolbar to open the {{man label|[[#New_Media_dialog|New Media]]}} editor dialog to edit existing information. Or select the {{man button|+ Add a new media object}} button on the toolbar to see both the {{man label|New Media}} editor dialog and the {{man label|[[#Select_a_media_object_selector|Select a media object selector]]}} dialog to select and then modify the media objects details before adding it.

===New Media dialog===
[[File:NewMediaEditor-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} New Media Editor - dialog - example showing Media properties]]

The top section presents a thumbnail {{man label|Preview}} of the media object if available, along with a summary of its properties (ID, Date, Path and ''object type'') that you can view and edit. You can type this information directly into the corresponding fields.

* A descriptive {{man label|Title:}} for this media object. Either generated based on the media objects filename automatically or entered manually.
* The {{man label|ID:}} is an unique record to identify the media object, leave blank to have it generated by Gramps.
** Privacy toggle for this media object {{man label|Record is public}}(default) or {{man label|Record is private}}
* {{man label|Date:}} type a date associated with the media object (eg: for a picture it could be the date it was taken.) You can also use the:
** [[File:22x22-gramps-date.png]]{{man button|Invoke date editor}} button to invoke the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date_selection_dialog|Date selection]]}} dialog.
* {{man label|Path:}} of the media object on your computer. Gramps does not store the media internally, it only stores the path! Set the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Base media path:]]}} in the {{man menu|Preferences > Family Tree}}'s {{man label|Base media path:}} entry to avoid retyping the common base directory where all your media is stored. The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|Gramps Media Manager]]}} tool can help managing paths of a collection of media objects.
** {{man button|Open File Browser to select a media file on your computer.}} button.
* {{man button|Edit the Tag list}} button button brings up the {{man label|[[Gramps_6.0_Wiki_Manual_-_Filters#Tag_selection_dialog|Tag selection]]}} dialog list that lets you remove or assign existing custom tags.

The bottom section of the window displays four notebook tabs containing different categories of information. Click on a tab to view or edit its contents. The bottom part of the window has the {{man button|Help}} button to bring you here, the {{man button|Cancel}} button will close the window without applying any changes and the {{man button|OK}} button will apply all the changes made in all tabs and close the dialog window.

Double clicking on the {{man label|Preview}} thumbnail will open the media object in an external viewer if available.

{{man note|Every media object is referred to by its Path.|The user is responsible for keeping track of the object files. Gramps will only reference and display the contents, not manage the files themselves.}}

{{man note|Clicking {{man button|OK}} will immediately save changes to the Family Tree (write on disk).|All changes are immediate.}}

====Cannot save media object warning dialog====
[[File:Cannot-save-media-object-warning-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Cannot save media object - warning dialog]]

The {{man label|Cannot save media object}} warning dialog is shown when you have not entered enough information about the new media object. Please enter data or cancel the edit.
{{-}}

===New Media tab pages ===
The tabs represent the following categories of media data:
* {{man label|[[#Source_Citations_4|Source Citations]]}}
* {{man label|[[#Attributes_4|Attributes]]}}
* {{man label|[[#Notes_4|Notes]]}}
* {{man label|[[#References_3|References]]}}

{{man tip|If a tab label is in '''boldface''' type, this means it contains data.|If not, it has no data.}}
====Source Citations====
The {{man label|Source Citations}} tab lets you....
{{stub}}

====Attributes====

The {{man label|Attributes}} tab lets you view and edit particular information about the media object that can be expressed as Attributes. The bottom part displays the list of all such attributes stored in the database. The top part shows the details of the currently selected attribute in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, or remove an attribute. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when an attribute is selected from the list.

====Notes====

The {{man label|Notes}} tab provides a place to record various information about the source that does not fit neatly into other categories. This area is particularly useful for recording information that does not naturally fit into the "Parameter/Value" pairs available to Attributes. To add a note or modify existing notes simply edit the text in the text entry field.

====References====

The {{man label|References}} tab indicates any database records that refer to a given media object. The list can be ordered according to any of its column headings: <code>Type</code>, <code>ID</code>, or <code>Name</code>. Double-clicking an entry allows you to view and edit the corresponding record.

{{man note|Only primary objects can be shown in the {{man label|References}} tab: Person, Family, Event, Source, or Place.|The secondary objects such as Names and Attributes, although able to refer the media object, will only show up through their primary objects to which they belong.}}

{{-}}

== Editing media object references ==

When Media Object references connect a Media Object to another object on a {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Edit Person]]'s Gallery}} tab, the {{man button|Share}} button will bring up the {{man label|[[#Select_a_media_object_file_chooser|Select Media Object]]}} file chooser and once you select a Media Object the {{man label|[[#Media_Reference_Editor_dialog|Media Reference Editor]]}} dialog appears.

{{stub}}
{{-}}
===Select a media object file chooser===

[[File:SelectAMediaObject-file-selector-dialog-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select a media object - (File) chooser Dialog - example]]

The {{man label|Select a media object}} [[Gramps_6.0_Wiki_Manual_-_Settings#File_Chooser|file chooser]] allow you to preview and select a media file you want to attach, and at the same time you may edit the shown {{man label|Title:}} (Defaults to the filename without the file extension).
*{{checkbox|0}}{{man label|Convert to a relative path}} (checkbox unchecked by default until checked for the first time and remembered for each subsequent image selection.)

See also:
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Media_Object_selector|Select Media Object selector]]
* [[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path > Base media path:]]

*[[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|{{man label|Gramps Media Manager}}]] a group of four separate tools two of which allow you to:
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}
{{-}}

===Media Reference Editor dialog===
[[File:MediaReferenceEditor-dialog-collapsed-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media Reference Editor - dialog - collapsed default example]]

The {{man label|Media Reference Editor}} dialog.

See also [[How to create image reference regions]]
{{stub}}
{{-}}
[[File:MediaReferenceEditor-dialog-expanded-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media Reference Editor - dialog - "Shared Information" section expanded example]]

You may also expand the '''Shared Information''' section.

{{stub}}
{{-}}
====Top section ====
{{stub}}
=====Top section tab pages =====

======General======

* Region corners : x1, x2, y1, y2.
The {{man label|region}} part allows to select a specific region on the Media Object.
You can use the mouse cursor on the picture to select a region, or use these spinbuttons to set the top left, and bottom right corner of the referenced region. Point (0,0) is the top left corner of the picture, and (100,100) the bottom right corner.

* Privacy
The {{man button|Privacy}} button lets you mark whether or not the record is considered private.
Check the {{man label|Private}} record box to mark this {{man label|record as private}}.

See also the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_7#Page_Generation|Narrated Web Site]] Gallery tab supports output of these referenced regions.

{{-}}
======Source Citations======

{{-}}
======Attributes======

{{-}}
======Notes======

{{-}}
====Shared Information ====

=====Shared Information tab pages =====

======General======

{{-}}
======References======

{{-}}
======Source Citations======

{{-}}
======Attributes======

{{-}}
======Notes======

{{-}}

== Editing information about places ==

To edit information about places, switch to the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Places_Category|Places Category]]}} and select the desired entry from the list of places. Double-click that entry or click the {{man button|Edit}} button on the toolbar to bring up the {{man label|[[#Place_Editor_dialog|Place Editor]]}} dialog:

{{-}}
===Place Editor dialog===
{{stub}} 
[[File:PlaceEditor-dialog-example-60.png|right|thumb|right|450px| Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place editor - dialog - existing place example]]



To add a new place or edit information about existing places, switch to the Places Category and select the desired entry from the list of places. Double-click that entry or click the {{man button|Edit}} button on the toolbar to bring up the following {{man label|Place Editor}} dialog:

The following fields are available:
* Title area at top displays the description of this place to be used in reports. Gramps will construct this for you. See {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Preferences > Display > Display Options]]}} section > {{man label|[x] Automate Place Format}} generation option.
*{{man label|Name:}} {{man tooltip|The name of this place.}}
** {{man button|{{icon|stock_edit}}{{man tooltip|Invoke place name editor}}}} button opens the {{man label|[[#Place_Name_Editor_dialog|Place Name Editor]]}} dialog where you can add/edit additional information.
*{{man label|Type:}} {{man tooltip|What type of place this is. Eg 'Country', 'City', ...}}. All '''[[Gramps_Glossary#custom|Custom Types]]''' are shown at the bottom of the list. Choose from the following default available place '''Types''':
** ''Building''
** ''Borough''
** ''Country''
** ''County''
** ''City''
** ''Department''
** ''District''
** ''Farm''
** ''Hamlet''
** ''Locality''
** ''Municipality''
** ''Neighborhood''
** ''Number'' - See the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor|Street format:]]}} option for the {{man label|Place Format Editor}}
** ''Parish''
** ''Province''
** ''Region''
** ''State''
** ''Street''
** ''Town''
** '''Unknown''' (''default'')
** ''Village''
<hr>
{{man label|Either use the two fields below to enter coordinates(latitude and longitude),}}
*{{man label|Latitude:}} the position above equation of the place in decimal or degree notation. Eg, valid values are 12.0154, 50°52'21.92\"N, N50º52'21.92\" or 50:52:21.92. You can set these values via the Geography View by searching the place, or via a map service in the Place view. See: [[#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]] See: [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Coordinates format:]] in preferences Display as this option controls the display of Coordinates.

*{{man label|Longitude:}} the position relative to the Prime, or Greenwich, Meridian of the place in decimal or degree notation. Eg, valid values are -124.3647, 124°52'21.92\"E, E124º52'21.92\" or 124:52:21.92. You can set these values via the Geography View by searching the place, or via a map service in the Place view. See: [[#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]] See: [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Coordinates format:]] in preferences Display as this option controls the display of Coordinates.

{{man label|or use copy/paste from your favorite map provider (format: latitude,longitude) in the following field:}}
* {{man label|               }} {{man tooltip|Field used to paste info from a web page like Google, OpenStreetMap...}}  See: [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Coordinates format:]] in preferences Display as this option controls the display of Coordinates.
<hr>

* {{man button|Record is public/private}} - public is the default
*{{man label|ID:}} an unique record to identify the place. Leave generated by Gramps.
*{{man label|Code:}} a code for this place. For example, an area code or postal code.
*{{man label|Tags:}}
** {{man button|Edit the tag list}}
{{-}}

===Place editor tab pages===
The tabs represent the following categories of place data:

*{{man label|[[#Enclosed_By|Enclosed By]]}}
*{{man label|[[#Alternative_Names|Alternative Names]]}}
*{{man label|[[#Source_Citations_7|Source Citations]]}}
*{{man label|[[#Notes_7|Notes]]}}
*{{man label|[[#Gallery_3|Gallery]]}}
*{{man label|[[#Internet|Internet]]}}
*{{man label|[[#References_5|References]]}}

{{man tip|If a tab label is in boldface type and displays an icon, this means it contains data.|If not, it has no data.}}

====Enclosed By====
[[File:PlaceEditor-EnclosedBy-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Enclosed By" tab from "Place Editor" - dialog - example]]

Places in Gramps are stored in a hierarchy. The {{man label|Enclosed By}} tab allows you to link this place to other places, higher in the hierarchy, which enclose it. Each link consists of a place and an optional date range.

To enclose with an existing place, use the use the {{icon|share}} {{man button|Share}} button to choose a Place from the [[#Select Place selector|Place Selector]]. Alternately, drag a place (from the Clipboard, Places Category view, or an Event Editor) into bottom of the {{man label|Enclosed By}} tab.

{{man note|1=Editing a hierarchy of Enclosing Places spawns a hierarchy of dialogs|2=Sharing, adding or Editing an enclosure spawns an additional Place Editor dialog. It looks just like the parent dialog but is focused on the enclosing Place. This allows further qualification of that place's enclosing characteristics. e.g., the enclosure date range -- for shifting borders.}}

The buttons {{icon|stock_add}} {{man button|add}} , {{icon|stock_edit}} {{man button|Edit}} , and {{icon|stock_remove}} {{man button|Remove}} let you add a new Place as an enclosing hierarchical level, modify the selected enclosing Place, and remove a selected link to an enclosing Place.

Note that the {{man button|Edit}}, {{man button|Remove}} and re-ordering (up, down) buttons become available only when a link exists and is selected from the list. In general, a country will be a top level place, and will not be linked to any other place.

'''See also:'''
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Enclosed_By|Enclosed By]] Gramplet
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Clipboard|Using the clipboard]]
=====Select Place selector=====
{{stub}}
[[File:SelectPlace-SelectorDialog-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Place - Selector Dialog - example]]

The {{man label|Select Place}} selector dialog allows you to link to an already existing place and once selected it will be opened in the {{man label|Place Reference Editor}}

You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
* '''Name contains''' (default)
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Settings#Selector_dialogs|Selector dialogs]]

=====Place Reference Editor=====
[[File:PlaceReferenceEditor-dialog-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Reference Editor - Dialog - example]]

{{man label|Place Reference Editor}}
{{stub}}

The second part of the window displays seven notebook tabs containing different categories of information. Click a tab to view or edit its contents. The bottom part of the window has {{man button|OK}} and {{man button|Cancel}} buttons. Clicking {{man button|OK}} will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button will close the window without applying any changes.

{{man note|Clicking {{man button|OK}} will immediately save changes to the Family Tree.|All changes are immediate.}}
{{-}}

====Alternative Names====

:The {{man label|Alternative Names}} tab lets you view and edit other names by which the place might be known. The tab lists all other names of the place stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a name record. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a name is selected from the list.

{{man note|Seeing a question <code>?</code> mark means that you may have a problem in the naming variants of that place.|There may be some places which have different names for the same date range and language. Overlapping date ranges are valid. The place displayer will use the first matching name.}}

====Source Citations====

:The {{man label|Source Citations}} tab lets you view and edit sources relevant to a place. The central part of the window lists all such source references stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a source reference associated with a place. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.

====Notes====

:The {{man label|Notes}} tab displays any comments or notes concerning the place. To add a note or modify existing notes simply edit the text in the text entry field.

====Gallery====

:The {{man label|Gallery}} tab lets you store and display photos and other media objects associated with a given place. The central part of the window lists all such media objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons {{man button|+}} , {{man button|Select}} , {{man button|Edit}} , and {{man button|-}} let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the place. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a media object is selected from the list.

====Internet====

:The {{man label|Internet}} tab contains Internet addresses relevant to the place. (This tab exhibits identical behavior to the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet|Internet Tab]] for the Person editor and its [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet_Address_Editor|Internet Address Editor]] is the same also.)

:The bottom part of the window lists all such Internet addresses stored in the database. The top part shows the details of the currently selected address in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove an Internet address. The {{man button|Go}} button (represented by an icon with a green arrow and yellow circle) opens your browser and takes you to the web page corresponding to the highlighted Internet address. Note that the {{man button|Edit}} , {{man button|-}} , and {{man button|Go}} buttons become available only when an address is selected from the list.

====References====

:The {{man label|References}} tab indicates any database records (events or LDS ordinances) that refer to a place. This information cannot be modified from the {{man label|Place Editor}} dialog. Instead, the corresponding event record (e.g., a birth event) has to be brought up and its place reference edited.

{{-}}

=== Place Name Editor dialog ===

[[File:PlaceNameEditor-dialog-default-60.png|right|thumb|right|450px| Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Place Name Editor" dialog - default]]

The {{man label|Place Name Editor}} dialog is accessed from the {{man label|[[#Place_Editor_dialog|Place Editor]]}} dialogs {{man button|{{icon|stock_edit}}{{man tooltip|Invoke place name editor}}}} button.

The {{man label|Place Name Editor}} dialog allows you to add/edit the following information:
* {{man label|Name:}} the name of the place
* {{man label|Date:}} Date range in which the place is valid
** [[File:22x22-gramps-date.png]]{{man button|Invoke the date editor}} button
* {{man label|Language:}} Language in which the name is written. Valid values are two character ISO codes for example: en,fr, de, nl. See Wikipedia for the full list of valid [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1] codes.
{{-}}

=== Supported longitude/latitude formats ===

When you create/modify a place, the possible formats used for longitude/latitude coordinates are :

{| class="wikitable"
!colspan="2"|Longitude & Latitude Formats
|-
! D.D4
| degree notation, 4 decimals
: eg +12.0154 , -124.3647
: 4 [https://wikipedia.org/wiki/Decimal_degrees#Precision decimals of longitude precision] allows an 11.132 meter (36.5223097 foot) approximation at the equator.
|-
! D.D8
| degree notation, 8 decimals ([https://wikipedia.org/wiki/Decimal_degrees#Precision precision] like ISO-DMS)
: eg +12.01543265 , -124.36473268
|-
! DEG
| degree, minutes, seconds notation
: eg 50°52'21.92"N , 124°52'21.92"E (° symbol has UTF-8 code c2b00a)
: or N50º52'21.92" , E124º52'21.92" (º symbol has UTF-8 code c2ba0a)
: The character for seconds can be either one double quote "
: or two single quote '
: The letters N/S/W/E can be placed before or after the digits.
|-
! DEG-
| degree, minutes, seconds notation with :
: eg -50:52:21.92 , 124:52:21.92
|-
! ISO-D
| ISO 6709 degree notation
: i.e. ±DD.DDDD±DDD.DDDD
|-
! ISO-DM
| ISO 6709 degree, minutes notation
: i.e. ±DDMM.MMM±DDDMM.MMM
|-
! ISO-DMS
| ISO 6709 degree, minutes, seconds notation
: i.e. ±DDMMSS.SS±DDDMMSS.SS
|}

{{-}}

See: [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Coordinates format:]] in preferences Display as this option controls the display of Coordinates.

== Editing information about sources ==

From either of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Sources_Category|Sources]]}} category views you can select or create a new source, or if you had chosen the {{icon|stock_add}} {{man button|+}} or {{icon|stock_edit}} {{man button|Edit}} buttons, then the {{man label|New Source}} editor dialog appears.

===New Source dialog===

[[File:NewSource-editor-dialog-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} New Source - editor dialog - example]]

For the {{man label|New Source}} editor dialog the general information in the top section of the window lets you define basic information about the source: its {{man label|Title}} , {{man label|Author}} , {{man label|Abbreviation}} , and {{man label|Publication information}} . You can type this information directly into the adjacent fields.

*{{man label|Title:}} Title of the source.
*{{man label|Authors:}} Authors of the source.
*{{man label|Pub. info.:}} Publication Information, such as city and year of publication, name of publisher, ...
*{{man label|Abbreviation:}} Provide a short title used for sorting, filing, and retrieving source records.
** {{man button|Record is public/private}} Lock icon toggle.
*{{man label|ID:}} an unique record to identify the source. Leave generated by Gramps.
*{{man label|Tags:}}
** {{man button|Edit the tag list}}
{{-}}

===New Source tab pages===
The tabs provide the following information categories of source data:

====Notes====

:The {{man label|Notes}} tab provides a place to record notes or comments about the source. To add a note or modify existing notes simply edit the text in the text entry field. Only primary objects can be shown in the {{man label|References}} tab: Person, Family, Event, Place, or Media object. Secondary objects such as Names and Attributes can only be accessed through the primary objects to which they belong.

====Gallery====

:The {{man label|Gallery}} tab lets you store and display photos and other media objects associated with a given source (for example, a photo of a birth certificate). The central part of the window lists all such objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons {{man button|+}} , {{man button|Select}} , {{man button|Edit}} , and {{man button|-}} let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the relationship. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a media object is selected from the list.

====Attributes====

:The {{man label|Attributes}} tab displays "Key/Value" pairs that may be associated with the source. These are similar to the "Attributes" used for other types of Gramps records. The difference between these Key/Value pairs and Attributes is that Attributes may have source references and notes, while Key/Value data may not.

:The central part of the window lists all existing Key/Value pairs. The buttons {{man button|+}} and {{man button|-}} let you add and remove pairs. To modify the text of Key or Value, first select the desired entry. Then click in either the Key or Value cell of that entry and type your text. When you are done, click outside the cell to exit editing mode.

====Repositories====
[[File:NewSource-Repositories-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Repositories" tab from "New Source" - dialog - example]]

:The {{man label|Repositories}} tab displays the references to the repositories in which the source is contained. The list can be ordered by any of its column headings: {{man label|ID}} , {{man label|Title}}, {{man label|Call Number}},and {{man label|Media Type}}. Double-clicking an entry allows you to view and edit the record in the {{man label|[[#Repository_Reference_Editor|Repository Reference Editor]]}}. You may also edit the reference. The buttons on the side of the tab allow you add a new repository, link to (or share) an existing repository, edit the reference to the repository, or remove the reference.
=====Repository Reference Editor=====
[[File:Repository-Reference-Editor-example-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Repository Reference Editor - Dialog - example]]
The '''Repository Reference Editor''' dialog is opened by double-clicking a record in the {{man label|Repositories}} tab of the [[#Editing_information_about_sources|Source Editor]] dialog.

It provides the ability to log the Type and Call Numbers for a Source in a particular Repository. Since a source might exist in multiple repositories. (I might have a photocopy in my personal library. A copy of the original book might be in the holdings of the <abbr title="Allen County Public Library">ACPL</abbr> Genealogy Center in Ft. Wayne, Indiana. The microfilm might being in the FamilySearch Library in Salt Lake City, Utah. Each can be located using different Call Numbers.)
======Reference information======
The Reference Information section has {{man label|General}} and {{man label|Notes}} tabs. The General tab has a text entry field for the {{man label|Call number}} and a {{man label|Media Type}} [[Gramps_6.0_Wiki_Manual_-_Main_Window#Combo_Boxes|drop-down list combo box]].

Media Type choices: Audio, '''Book''' ''(default)'', Card, Electronic, Fiche, Film, Magazine, Manuscript, Map, Newspaper, Photo, Tombstone, Unknown, Video, [[Gramps_Glossary#custom|custom types]].

======Shared information======
The {{man label|Shared information}} section offers all the options of the [[#New_Repository_dialog|Repository Editor]] dialogs with General, Addresses, Internet, Notes and References tabs.
{{-}}

=====Select Repository selector=====
[[File:SelectRepository-SelectorDialog-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Repository - Selector Dialog - example]]

The {{man label|Select Repository}} selector dialog allows you to link to an already existing repositories and once selected it will be opened in the {{man label|[[#Repository_Reference_Editor|Repository Reference Editor]]}}

You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
* '''Title contains''' (default)
* ''Title not contain''
* ''ID contains''
* ''ID does not contain''
* ''Last Change contains''
* ''Last Change does not contain''
{{-}}

====References====

:The {{man label|References}} tab lists all the database records that refer to this source, if any. The list can be ordered by any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}}. Double-clicking an entry allows you to view and edit the record.

{{-}}

== Editing source citations ==

Citations connect a Source to another object and allow you to provide additional information about the source. Citations can be attached to a large number of objects,
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_people|People and various information about people]] (such as their name, address etc),
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_relationships|Relationships (Families) and various information about relationships]],
* [[#Editing_information_about_events|Events and various information about events]],
* [[#Editing_information_about_media_objects|Media objects and attributes of media objects]],
* [[#Editing_information_about_places|Places and various information about places]],
* [[#Editing_information_about_repositories|Addresses of repositories]].

For each object, a common set of buttons are provided:
* {{icon|stock_add}} {{man button|+}} (Create and add a new citation and a new source). This brings up an empty Citation dialog.
* {{icon|share}} {{man button|Add}} (Add an existing citation or source). This brings up the Source or Citation selection dialog box.
* {{icon|stock_edit}} {{man button|Edit}} (Edit the selected citation). This brings up the Citation dialog pre-populated with the Citation and source information.
* {{icon|stock_remove}} {{man button|-}} (Remove the existing citation). This removes the citation from the object. It does not delete the citation itself, which could then be connected to another object.

Note that the {{icon|stock_edit}} {{man button|Edit}} and {{icon|stock_remove}} {{man button|-}} buttons become available only when a citation has been selected.

{{-}}
=== Select Source or Citation selector===

[[File:SelectSourceOrCitation-SelectorDialog-example-50.png|thumb|450px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Source or Citation - Selector Dialog - example]]

When {{icon|stock_add}} {{man button|Add}} adding an existing citation or source, the {{man label|Select Source or Citation}} [[Gramps_Glossary#selector|selector]] dialog appears.

This allows either an existing source or an existing citation (along with its associated source) to be selected. Click on the disclosure triangle alongside a source to see the citations associated with that source. For example, if one of your sources were a book, then the citations would normally refer to a page (or pages) within the book. If you already have a citation that refer to the particular page of the book, then you could select that citation which would then be shared. On the other hand, if this object needs to refer to a new page, then you would select the source and in the subsequent dialog enter the new page.

You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
* '''Source: Title or Citation: Volume/Page contains'''(default)
* ''Source: Title or Citation: Volume/Page does not contain''
* ''ID contains''
* ''ID does not contain''
* ''Last Change contains''
* ''Last Change does not contain''
{{-}}

===New Citation dialog===
{{stub}}
[[File:NewCitation-editor-dialog-example-50.png|thumb|450px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} New Citation - editor Dialog - example]]

Once you have selected a citation or a source, or if you had chosen the {{icon|stock_add}} {{man button|+}} or {{icon|stock_edit}} {{man button|Edit}} buttons, then the {{man label|New Citation}} dialog appears.

The {{man label|New Citation}} dialog includes one section called {{man label|Citation information}}.
{{-}}
====Citation information====
The {{man label|Citation information}} section indicates the details associated with the particular reference to this Source: {{man label|Confidence}}, {{man label|Volume/Page}}, {{man label|Date}}, and {{man label|Notes}}. You can choose the Confidence level from the {{man label|Confidence}} drop-down menu. The remaining details can be typed in the corresponding text entry fields.

*{{man label|Date:}} Date associated with this source reference. Typically used to store the date that the data was entered into the original source document (not the date when the event occurred).
** [[File:22x22-gramps-date.png]]{{man button|Invoke date editor}} button starts the {{man label|Date selection}} dialog.
*{{man label|Volume/Page}}: Specific location with in the information referenced. For a published work, this could include the volume of a multi-volume work and the page number(s). For a periodical, it could include volume, issue, and page numbers. For a newspaper, it could include a column number and page number. For an unpublished source, this could be a sheet number, page number, frame number, etc. A census record might have a line number or dwelling and family numbers in addition to the page number.
*{{man label|Confidence}}: Level conveys the submitter's qualitative evaluation of the credibility of a piece of information, based upon its supporting evidence. It is not intended to eliminate the receiver's need to evaluate the evidence for themselves. (Shown in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Citations_List_View|Citations List View]]}} as the {{man label|Confidence}} column)
**''Very Low'' = Unreliable evidence or estimated data.
**''Low'' = Questionable reliability of evidence (interviews, census, oral genealogies, or potential for bias for example, an autobiography).
**'''Normal''' - (default) Evidence possibly has no issue or has not been assessed. Not yet validated
**''High'' = Secondary evidence, data officially recorded sometime after event.
**''Very High'' = Direct and primary evidence used, or by dominance of the evidence.
*{{man label|ID:}}
*{{man label|Tags:}}

;A warning icon {{icon|stock_warn}} is displayed if the citation is shared.

{{man tip|Information in a citation may be shared.|A single citation can be referenced many times and all such references will have in common the overall citation information. Changing the citation information will change it for all of the shared uses}}

{{-}}
=====Select Source selector=====
[[File:SelectSource-selector-dialog-example-50.PNG|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Source - Selector Dialog - example]]

The {{man label|Select Source}} selector dialog allows you to link to an already existing source.

You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
* '''Title contains''' (default)
* ''Title not contain''
* ''Author contains''
* ''Author does not contain''
* ''ID contains''
* ''ID does not contain''
* ''Last Change contains''
* ''Last Change does not contain''

{{-}}
=====Citation information section tab pages=====
The tabs provide the following information categories of citation data:

======Notes======

The {{man label|Notes}} tab provides a place to record notes or comments about the citation. The central part of the window lists all notes for this citation, and gives you a preview of the beginning of the note. The buttons {{icon|stock_add}} {{man button|+}}, {{icon|share}} {{man button|Add}}, {{icon|stock_edit}} {{man button|Edit}}, {{icon|stock_remove}} {{man button|-}}, {{icon|stock_go_up}} {{man button|Up}} and {{icon|stock_go_down}} {{man button|Down}} let you add a new note, share the selected note, edit the selected note, remove the selected note and move the selected note up or down the list of notes. Note that the {{icon|share}} {{man button|Add}}, {{icon|stock_edit}} {{man button|Edit}}, {{icon|stock_remove}} {{man button|-}}, {{icon|stock_go_up}} {{man button|Up}} and {{icon|stock_go_down}} {{man button|Down}} buttons become available only when a media object is selected from the list. Removing a note only removes the note from this citation, it does not delete the note itself. Please refer to [[#Editing_information_about_notes|details on editing notes]].

======Gallery======

The {{man label|Gallery}} tab lets you store and display photos and other media objects associated with a given citation (for example, a photo of a page of a book or a page of a census). The central part of the window lists all such objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons {{icon|stock_add}} {{man button|+}}, {{icon|share}} {{man button|Add}}, {{icon|stock_edit}} {{man button|Edit}} and {{icon|stock_remove}} {{man button|-}} let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the citation. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a media object is selected from the list. Please refer to [[#Editing_media_object_references|details on editing media references]].

======Attributes======

The {{man label|Attributes}} tab displays "Key/Value" pairs that may be associated with the citation. These are similar to the "Attributes" used for other types of Gramps records. The difference between these Key/Value pairs and Attributes is that Attributes may have source citations and notes, while Key/Value data may not.

The central part of the window lists all existing Key/Value pairs. The buttons {{icon|stock_add}} {{man button|+}} and {{icon|stock_remove}} {{man button|-}} let you add and remove pairs. To modify the text of Key or Value, first select the desired entry. Then press the {{icon|stock_edit}} {{man button|Edit}} button to select the Key, or click in either the Key or Value cell of that entry and type your text. When you are done, click outside the cell to exit editing mode.

======References======

The {{man label|References}} tab lists all the database records that refer to this source, if any. The list can be ordered by any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}}. Double-clicking an entry allows you to view and edit the record.

{{-}}

== Editing information about repositories ==

Once you have selected a source, or if you had chosen the {{icon|stock_add}} {{man button|+}} or {{icon|stock_edit}} {{man button|Edit}} buttons, then the {{man label|[[#New_Repository_dialog|New Repository]]}} dialog appears.

=== New Repository dialog ===

[[File:NewRepository-editor-dialog-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} New Repository - editor dialog - example]]

The following fields are shown:
* {{man label|Name:}} of the repository (where sources are stored).
* {{man label|Type:}} of repository can be physical or virtual structures where genealogical and family history sources are stored:
** ''Album''
** ''Archive''
** ''Bookstore''
** ''Cemetery''
** ''Church''
** ''Collection''
** '''Library''' (default)
** ''Safe''
** ''Unknown''
** ''Web site''
* {{man label|ID}}: an unique record to identify the repository. Leave empty to be generated by Gramps.
* {{man button|Record is public/private}} Lock icon toggle.
*{{man label|Tags:}}
** {{man button|Edit the tag list}}
{{-}}

=== New Repository tab pages ===
The tabs represent the following categories of repository data:
*{{man label|[[#Addresses|Addresses]]}}
*{{man label|[[#Internet_2|Internet]]}}
*{{man label|[[#Notes_10|Notes]]}}
*{{man label|[[#References_8|References]]}}

====Addresses====
The {{man label|Addresses}} tab lets you view and record the various addresses of the repository.

The bottom part of the window lists all addresses stored in the database. The top part shows the details of the currently selected address in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove an address record from the database. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when an address is selected from the list.

====Internet====
The {{man label|Internet}} tab displays Internet addresses relevant to the repository. (This tab exhibits identical behavior to the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet|Internet Tab]] for the Person editor and its [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet_Address_Editor|Internet Address Editor]] is the same also.)

The bottom part lists all such Internet addresses and accompanying descriptions. The top part shows the details of the currently selected addresses in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove an Internet address. The "Go" button (represented by an icon having a green arrow and yellow circle) opens your web browser and takes you directly to the highlighted page. Note that the {{man button|Edit}} , and {{man button|-}}buttons become available only when an address is selected from the list.

====Notes====
:The {{man label|Notes}} tab provides a place to record notes or comments about the repository. To add a note or modify existing notes simply edit the text in the text entry field.

====References====
:The {{man label|References}} tab indicates any database records that refer to a given repository. The list can be ordered according to any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}} . Double-clicking an entry allows you to view and edit the corresponding record.

{{-}}

== Editing information about notes ==

See also:
* [[Gramps_6.0_Wiki_Manual_-_Categories#Notes_Category|Notes Category]]

=== Note editor dialog ===
[[File:NewNote-editor-dialog-example-with-context-menu-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} New Note - editor dialog - example with context menu]]
When creating a new note, or when editing an existing note, the {{man label|Note Editor}} dialog appears. There are two tabs, the ''' {{man label|[[#Note_tab|Note]]}}''' tab, and the ''' {{man label|[[#References_tab|References]]}}''' tab.

==== Note tab ====

The {{man label|Note}} tab is the space where text is added. The text can be formatted using many standard text editing tools.
===== Note Toolbar =====
:* A toolbar to apply styles (or Font Decorations) to text in your notes. You can select and apply one of the toolbuttons, or set the values as you want and start typing.
::* {{man button|Italic}} : Slants text for emphasis, common in most text editors
::* {{man button|Bold}} : Darkens text for emphasis, common in most text editors
::* {{man button|Underline}} : Draws a line under text, common in most text editors
::* {{man button|Strikethrough}} : draws a line through, commonly used to indicate text to be deleted
::* {{man button|Superscript}} : Raises text slightly, commonly used for footnotes (e.g., Wikipedia2)
::* {{man button|Subscript}} : Lowers text slightly, commonly used in formulas (e.g., H2O)
::* {{man button|Font family}} : selection drop down list, a basic font selector showing all fonts installed on your operating system.
::* {{man button|Font size}} : selection drop down list, select the size of the font to use for your text.
::* {{man button|Undo}} : Undoes last action.
::* {{man button|Redo}} : Re-applies last "Undone" action.
::* {{man button|[[File:22x22-gramps-font-color.png]] Font Color}} : Select the color of your font.
::* {{man button|[[File:22x22-gramps-font-bgcolor.png]] Background Color}} : Adds a background color to the text you enter.
::* {{man button|''' ↷ ''' Link}} : Opens the {{man label|[[#Link_Editor|Link Editor]]}} allowing you to create an internal link to an item in Gramps, such as a Person, Family, Event, Note, etc. External URL links can also be created.
::* {{man button|''' ⌫ ''' Clear Markup}} : Return selected text to plain text. Removes any links made.

===== Textview context menu =====
:* Right click on the textview to show the context menu:
<hr>
::* {{man menu|Open Link}} - selected or alternatively you can press {{man button|Ctrl}} and right-click the mouse button - ''Only shown when a link is selected in the textview''
::* {{man menu|Copy Link Address}} - and you can paste the content elsewhere - ''Only shown when a link is selected in the textview''
::* {{man menu|Edit Link}} - Opens the {{man label|[[#Link_Editor|Link Editor]]}} allowing you to create an modify the selected link. - ''Only shown when a link is selected in the textview''
::* {{man menu|Spellcheck}} - The most important entry in this context menu is the spell selection. You are offered a selection of installed languages on your system with spell checking enabled. A [[Gramps_6.0_Wiki_Manual_-_Settings#Environment_Settings|spelling checker]] is available for ''English'' and your installed local language (Note in the {{man menu|Edit > Preferences > General > [[Gramps_6.0_Wiki_Manual_-_Settings#Environment_Settings|Environment Settings]]}} section enable the {{man label|[x] Enable spell checker}}option for global English by default or the language your Gramps is run in and the note context menu is per note in the selected Language of your choice)
:::* {{man menu|[ ] On}}
:::* {{man menu|[x] Off}} - (default)
::* {{man menu|Cut}} - the selected text.
::* {{man menu|Copy}} - the selected text.
::* {{man menu|Paste}} - the previously cut or copied text.
::* {{man menu|Delete}} - the selected text.
<hr>
::* {{man menu|Select All}} - the text in the textview.
::* {{man menu|Insert Emoji}} -
::* {{man menu|Search selection on web}} -
<hr>

===== Note properties =====
:* Some properties of your note
::*{{checkbox|0}} {{man label|Preformatted}} checkbox: Notes in Gramps are considered reflowable to allow the content to conform to the report's page size and formatting for the most harmonious presentation. In the default setting, newlines (linefeeds & carriage returns) and white spaces will be automatically ignored so as to form complete paragraphs, which are defined by an empty line between two textblocks. When {{man label|Preformatted}} is checked, Gramps will assume the whitespace and newlines you keyed into the notes are important. Use ''Preformatted'' for tables, literal transcripts, and so forth. Using a monospace font will help keep preformatting column widths & margins predictable. Try not to use preformatted unless absolutely necessary, the reports created will flow more naturally.
::* {{man button|Make public/private}} Privacy is the same as on the other objects. With one easy click, you can indicate a note should be considered private so Gramps can remove this note from all output created.
::* {{man label|ID:}} a unique ID for the note. If left blank, an automatic ID will be generated according to the settings in the preferences.
<div id="note_type">
::* {{man label|Type:}} (<code>General</code> default) The note type. You can add your own [[Gramps_Glossary#custom|custom Type]] by keyboarding it in directly. Adding a Note will automatically set the Type to match the object to which it is being added. (e.g. A note added to the Notes tab of the Person Editor will default to ''Person Note'' Type.)

:::::{|class="wikitable"
! style="text-align:left;"| Type
! Recognized for features in
|-
|''[[Gramps_Glossary#primary_object|<primary object>]]'' Note
|
|-
|''[[Gramps_Glossary#secondary_object|<secondary object>]]'' Note
|
|-
|Citation
|
|-
|General
|''(default)''
|-
|Html code
|[[Gramps_6.0_Wiki_Manual_-_Reports#Narrated_Web_Site|Narrated Web Site]] report inclusions; export to GEDCOM
|-
|Link
|
|-
|Report
|
|-
|Research
|
|-
|Source text
|
|-
|To Do
|[[Gramps_6.0_Wiki_Manual_-_Gramplets#To_Do|To Do]] Gramplet, [[Addon:ToDoNotesGramplet|ToDo Notes Gramplet]] Addon. ''Not to be confused with ToDo tag-based reports.''
|-
|Transcript
|
|-
|Unknown
|
|}</div>
::* {{man label|Tags:}} Select a Tag for the note: Complete, Todo etc... You can add your own Tags by typing it. Reports based on tags include: [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Tag_Report|Tag Report]], [[Addon:ToDoReport|Todo report]]
:::* The {{man button|Edit the tag list}} button brings up the {{man label|[[Gramps_6.0_Wiki_Manual_-_Filters#Tag_selection_dialog|Tag selection]]}} dialog list that lets you remove or assign existing custom tags.
{{-}}

==== References tab ====

The {{man label|References}} tab indicates any objects that refer to a given note. The list can be ordered according to any of its column headings: <code>Type</code>, <code>ID</code>, or <code>Name</code>. Double-clicking on an entry or selecting an entry and using the {{man button|Edit reference}} button allows you to view and edit the corresponding record.

=== Link Editor ===

[[File:Note-LinkEditor-dialog-default-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Note "Link Editor" - dialog - defaults to active person - example]]

To create a note link, '''a block of Note text must first be highlighted for the Link Editor to be active''' and when the [[#Note_Toolbar|Note Toolbar's]] {{man button|''' ↷ ''' Link}} button icon is selected you will be shown the {{man label|[[#Note_Link_Editor_dialog|Link Editor]]}}. There is no visual indicator when the Note Toolbar's {{man button|''' ↷ ''' Link}} button icon is inactive.

The Links created in the note will turn blue and show an underline when you hover your mouse over the Linked text. While working within the Gramps Note, you can either press {{man button|Ctrl}} + the left-click mouse button or from the right-click [[#Textview_context_menu|Textview context menu]] select {{man menu|Open Link}} allowing either the edit window for the selected object to open or to open the HTML URL link in your default internet browser.

The true power of Links are shown when a [[Gramps_6.0_Wiki_Manual_-_Reports#Narrated_Web_Site|Narrated Web Site]] or [[Addon:DynamicWeb_report|Dynamic Web]] site report is created. The created Links become true navigation links to other pages within the web report.

====Note Link Editor dialog====
[[File:Note-LinkEditor-dialog-InternetAddress-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Note "Link Editor" - dialog - showing the Link Type: Internet Address - example]]

The Note {{man label|Link Editor}} dialog shows the Active ''Person'' by default and when selected for each of the other objects the relevant active object. Or you can select the link type of ''Internet Address''.

The following options are shown:

*{{man label|Link Type:}} specify the type of link for either one of the active nine Gramps item/objects by default the active ''Person'' or an ''Internet Address'' you manually enter.
**''Internet Address'' - ([https://en.m.wikipedia.org/wiki/URL <abbr title="Uniform Resource Locator, also known as a web address">URL</abbr>]) - if selected the {{man label|Internet Address:}} field becomes available for data entry.
**''[[Events|Event]]''
**''Family''
**''Media''
**''Note''
**'''Person''' (default)
**''[[Places|Place]]''
**''Repository''
**''[[Sources|Source]]''
**''[[Citations|Citation]]''
***{{icon|share}} {{man button|Select Item}} button : opens the relevant [[Gramps_6.0_Wiki_Manual_-_Settings#Selector_dialogs|selector dialog]] for existing items in the category specified in the Link Type. '''Not applicable for Internet Address selection.'''
***{{man button|New}} button : opens a window to create a new item of the specified Gramps item. Successful creation of a new item will autofill the Gramps item box and the Internet Address box with the appropriate data.
*{{man label|Gramps item:}} shows the selected item eg: If Person is selected and then the active persons name is shown see the screenshot. '''Not applicable for Internet Address selection.'''
**This box is Auto generated by the selection of the {{icon|share}}{{man button|Select Item}} button/{{man button|New}} button/{{man button|Edit}} button.
*{{man button|Edit}} button : opens the editor dialog for the specified Gramps item. The selected item will autofill the Gramps item box and the Internet Address box with the appropriate data.
*{{man label|Internet Address:}}
**for the {{man label|Link Type:}} = Gramps type will autofill this box but the contents will be greyed out
**for the {{man label|Link Type:}} = ''Internet Address'' (defaults to: <code>https://</code> ) you delete the default provide by Gramps and enter the full Internet Address either manually or via copy and paste.

[[File:Note-showing-tooltip-for-link-example-60.png|thumb|right|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Notes Editor - Linked text with tooltip - example]]

See also:
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet_Address_Editor|Internet Address Editor]]
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Note_Link_Report|Note Link Report]]
{{-}}

=== Note markup and preformat in reports ===

Markup like '''bold''', color, underline, ... can be added to notes. A note can be preformatted or not. It depends on the output type how this markup will appear. Here an overview is given of what you can expect.

* '''PDF''' and '''direct print''' (to printer or to file) fully support the markup and the preformatted setting
* '''ascii''' print removes all markup from the notes for obvious reasons

* '''LaTeX''' supports the preformatted setting and partially supports font emphasis stylings and size markup; output does not support font family or colors markup.
* '''Narrative Web'''. Many people use the Narrative Web report as an easy way to work with their data. This report is trying to respect markup in the notes. This is an interpreted translation, it is not one-to-one.
* '''ODF''' output does not support markup.
* '''RTF''' output does not support markup.
* '''html''' output does not support markup.

{{man tip|Note markup and preformat in reports|Use markup in notes only in those cases it adds to the information stored. '''Gramps is not a text editor.'''}}

{{-}}
{{man index|Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 1|Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 3|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 2}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Talk:Gramps Glossary

2026-03-04T01:43:08Z

CallMeDave: /* Anglicisation: missing word? */ your welcome

==Active Person and French "Personne Actif"==
;Active Person: (''core concept'') - The person designated as the momentary center of focus in the open Gramps database. The perspective of this person defines the context for actions and for displaying all the surrounding information. Changing this focus is done by [[Gramps_{{man version}}_Wiki_Manual_-_Navigation#Setting_the_Active_Person|navigating the Active Person]] selection to another person.

;Personne Actif ''(Active Person)'': (''concept principal'') - La personne désignée comme le centre de concentration momentané dans la base de données Gramps ouverte. La perspective de cette personne définit le contexte des actions et de l'affichage de toutes les informations environnantes. La modification de ce focus se fait en sélectionnant [[Fr:Manuel_wiki_pour_Gramps_{{man version}}_-_Navigation#Choisir_le_de_Cujus.2C_la_souche|naviguer le Personne Actif]] vers une autre personne.

==How should Gramps ID be added?==
Under "G" or "I"? Gramps ID [[Gramps_5.1_Wiki_Manual_-_Settings#ID_Formats]] [[User:GulliblePangolin|GulliblePangolin]] ([[User talk:GulliblePangolin|talk]]) 00:12, 26 May 2020 (UTC)

Under 'ID', I would expect. The word 'Gramps' before ID was a later refinement to the Keybindings page. It was added because that page covered both Gramps and OS keyboard shortcuts. So the ambiguity of whether the ID was OS-related or Gramps-related had to be addressed.

The Gramps Glossary ought to be GRAMPS only terminology... so the ID glossary term doesn't need the additional level of disambiguation. (Some of the terms should be moved from the Gramps Glossary to the [[Genealogy_Glossary|Genealogy Glossary]]

The messy part is that there are separate ID sets for each category's objects. And that the system allows custom IDs via import or manual entry. See [[Gramps_5.1_Wiki_Manual_-_Tools#Reorder_Gramps_ID|reorder Gramps ID]] or [[Gramps_5.1_Wiki_Manual_-_Reports_-_part_5#Graphs|non-standard IDs]]

I'd probably only link the 'ID' in the Keybindings page instead of 'Gramps ID' compound term. That would implicitly reinforce that the important element is the 'ID' and the Gramps is only a disambiguation.

[[User:Bamaustin|Bamaustin]] ([[User talk:Bamaustin|talk]]) 03:45, 26 May 2020 (UTC)

==Re-order or Reorder==
[https://english.stackexchange.com/a/326501 fyi] user manual and interface in Gramps uses the correct form the glossary should be changed to match!

Reorder.

With re- words, you should use ‘re-’ (with a hyphen) if the next word begins with an ‘e’ or a ‘u’ (when not pronounced like ‘you’). Otherwise, don’t hyphenate. It’s therefore re-examine, re-urge, re-entry and re-elect, and reuse, reunion, reorder, reinforce and redevelop.

Source: http://www.proofreadinglondon.com/blog/to-hyphenate-or-not-to-hyphenate

In general, try to avoid putting hyphens into words formed of one word and a short prefix

Source: http://www.economist.com/style-guide/hyphens

hmm.. [[User:Gullible-Pangolin|Gullible-Pangolin]] ([[User talk:Gullible-Pangolin|talk]]) 22:43, 19 November 2024 (UTC)

My contention remains the same as for "plugin" vs. "plug-in". One requires adding a special purpose word to one's vocabulary or integrating another complex parsing rules. The other is easily understood as a concatenation of base words. So, better for machine translation or english as a (far distant) second language.

The Economist is an elitist magazine that caters to the idea of excluding people. Wealth and vocabulary are 2 of their favorite weapons for doing so. My brother subscribed while we were in high school. I read it for awhile until the tone became unbearable.

Language for tutorials should include, never exclude. (My inclusion of 'convey' in the Merge glossary term is worrisome because of that. But "transfer" has too much baggage when used in proximity to data handling.)
[[User:Bamaustin|Bamaustin]] ([[User talk:Bamaustin|talk]]) 03:15, 20 November 2024 (UTC)

:Yes it should be "Reorder" in keeping with the rest of Gramps ( note the previous person removed a comment voting for 'Reorder' also, so other person don't be shy all voices need to be heard, just be nicer about it please ) [[User:CallMeDave|CallMeDave]] ([[User talk:CallMeDave|talk]]) 07:30, 20 November 2024 (UTC)

::Discussion on [https://github.com/gramps-project/gramps/pull/1738#discussion_r1712640755 Github] about "addon" "add-on" etc you can see that Nick Hall mentions "As long as we are consistent I don't really mind." so in this case it means "reorder" wins the day! [[User:Gioto|Gioto]] ([[User talk:Gioto|talk]]) 20:03, 20 November 2024 (UTC)

:::Reorder it is then, do we have a volunteer to change it here and on discourse? [[User:Daleathan|Daleathan]] ([[User talk:Daleathan|talk]]) 00:35, 22 November 2024 (UTC)

== Anglicisation: missing word? ==

For the lemma '''''anglicisation''''' the last sentence ends with "...and surname variants may be grouped with the in the Name Editor." It looks like there is a word missing between 'the' and 'in'. Does anyone know what word (or words) should go there? --[[User:DomoViridi|DomoViridi]] ([[User talk:DomoViridi|talk]]) 11:16, 19 February 2026 (UTC)
: Fixed by [[User:CallMeDave|CallMeDave]] on [https://gramps-project.org/wiki/index.php?title=Gramps_Glossary&diff=129827&oldid=129816| 21:20, 19 February 2026]. It now simply ends in "... with the Name Editor." Thanks Dave! --[[User:DomoViridi|DomoViridi]] ([[User talk:DomoViridi|talk]]) 02:38, 3 March 2026 (UTC)
::I'm of the opinion that this term could be moved out of the Gramps glossary. Since Gramps does not have any anglicization automation. MAYBE it could be put in the Genealogy Glossary.
::
::[[User:Bamaustin|Bamaustin]] ([[User talk:Bamaustin|talk]])

Addon:ArchiveAssist

2026-02-21T02:21:40Z

CallMeDave:

{{Third-party plugin}}
{{man warn|Unreleased addon}}

[[File:Archiveassist.png|right|450px]]
Parses strings from Riksarkivet and ArkivDigital to create sources and citations.

== Usage ==
Paste reference strings from ArkivDigital or Riksarkivet into the textbox of the gramplet to automatically create a source and citation.

;Example string Riksarkivet:
"Åby kyrkoarkiv, Husförhörslängder, SE/VALA/00460/A I/8 (1833-1840), bildid: C0029371_00018, sida 8"

;Example string ArkivDigital:
"Högsrum (H) AI:6 (1861-1871) Bild 186 / sid 179 (AID: v22513.b186.s179, NAD: SE/VALA/00161)"

==History==
* https://github.com/gramps-project/addons-source/pull/802

[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]

Gramps Glossary

2026-02-19T20:20:31Z

CallMeDave: /* A */

{{languages|Gramps_Glossary}}
__NOTOC__
This glossary gives an overview of terms that appear in the [[features|Gramps]] genealogy software, with a short description, and a link to relevant articles. (Since knowing a feature's name is necessary for finding the corresponding glossary term, also refer to the [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Main_Window|Visual Guide to the Gramps Interface]].)

For a glossary of genealogical terms, see [[Genealogy Glossary]] and [[Latin words and expressions]].

{| border="0" align="center" style="margin-top:0.4em;"
|
[[#A|A]] -
[[#B|B]] -
[[#C|C]] -
[[#D|D]] -
[[#E|E]] -
[[#F|F]] -
[[#G|G]] -
[[#H|H]] -
[[#I|I]] -
[[#J|J]] -
[[#K|K]] -
[[#L|L]] -
[[#M|M]] -
[[#N|N]] -
[[#O|O]] -
[[#P|P]] -
[[#Q|Q]] -
[[#R|R]] -
[[#S|S]] -
[[#T|T]] -
[[#U|U]] -
[[#V|V]] -
[[#W|W]] -
[[#X|X]] -
[[#Y|Y]] -
[[#Z|Z]]
|}


==A==

;Active Person: (''core concept'') - The person designated (or 'selected') as the momentary center of focus in the open Gramps database. The perspective of this person defines the context for actions and for displaying all the surrounding information. Changing this focus is done by [[Gramps_{{man version}}_Wiki_Manual_-_Navigation#Setting_the_Active_Person|navigating the Active Person]] selection to another person.
:The Active Person's relationship to the [[#home_person|Home Person]] defines the scope of the perspective.
:<abbr title="nota bene (singular), notate bene (plural) - Latin phrase meaning 'note well'">N.B.</abbr>: There is ''always'' an Active Person selection, even when the [[#primary_object|primary object]] (<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> record) selected in the current view is not a 'Person' [[#object|object]].

;addon: (<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> [https://wikipedia.org/wiki/Plug-in_(computing) add-on])
:an optional [[{{man version}}_Addons#Addon_List|'''third-party''' expansion]] to Gramps that leverages Gramps [[#plugin|plugin]] customization framework to add and [[Addons_development#Create_a_Gramps_Plugin_Registration_file|register]] a specific feature. The [[Gramps_{{man version}}_Wiki_Manual_-_Navigation#Using_the_Addon_Manager|Addon Manager]] allows installing and updating from curated collections of Addons. (These curated collections are called "Projects" in the Addon Manager.)
:Addons may not conform to the same design or code quality standards of builtin plugin modules. Use with caution!
:Optional parts bundled with the core project are called by the more generic name: builtin plugins. After installation and being registered, both the "builtin" and "addon" plugins may be disabled or re-enabled with the [[Gramps_{{man version}}_Wiki_Manual_-_Plugin_Manager#Registered_Plugins|Plugin Manager]].

;address: (''[[#secondary_object|sec. obj.]]'') - The Gramps concept of an Address is a particular location with an associated time frame. Think of it as a mailing address. It is intended to represent where a person lived and when the person lived there. The Address consists:
:* Date
:* Street Address
:* Locality
:* City
:* County
:* State/Province
:* Postal/Zip code
:* Country
:* Phone
:Not to be confused with a [[#place|Place]] which has a fixed position (its location). [[Why_residence_event_and_not_Address%3F|Use this with care.]] For genealogical research you can also use the residence event coupled with a [[#place|Place]]. For mailing (email, postal), add an address to a [[#person|Person]] or [[#repository|Repository]].

;administrative division: a unit of a layered system subdividing a geopolitical (geographic or political) region. Such divisions are recorded as [[#place|Place]] Types in Gramps. Meanwhile the structure of a Place Tree is built by layering via the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Enclosed_By|'Enclosed by' tab in the Place Editor.]] The subdivisions are sometimes categorized as an entity, locality, area, or region. The terms of subnational entity, constituent unit, or country subdivision tend to imply divisions that are more related to political representation than administrative. See wikipedia's [https://wikipedia.org/wiki/Administrative_division Administrative division] for a conceptional definition or [https://wikipedia.org/wiki/List_of_administrative_divisions_by_country List of administrative divisions by country] for specific countries.

;Aide: (''[[#event_role|event role]]'') A term to refer to the role of an assistant.

;anglicisation:
: process of making something English. If an immigrant (or their descendant) adopts a naturalized variation of their birth name, that [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Preferred_name_section|preferred alias]] can be added with an ''Also Known As'' [[Names_in_Gramps#Name_Types|name type]] in the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Names|Names]] tab. All aliases can be categorized by type and surname variants may be [[Grouping_Surnames|grouped]] with the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]].

;Association: (''[[#secondary_object|sec. obj.]]'') - The [[#role|roles]] in [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data%3A_detailed_-_part_1#Associations|Associations]] are to explicitly define the how one person relates to another.
:Association roles are used when the relationship falls outside the implicit roles of a family relationship or the explicit roles in shared events. These custom roles convey relationships that might not readily apparent... such as a [https://wikipedia.org/wiki/Pen_pal penpal] or the [https://wikipedia.org/wiki/Eponym eponymous person] honored by a namesake. Association roles may also be used as placeholder when the actual genetic connection has not yet been discovered.
:Association roles are created and edited with the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data%3A_detailed_-_part_1#Person_Reference_Editor|Person Reference Editor]], which includes no pre-defined roles. This feature starts with a blank list of [[#custom|custom types]]) and the default "Godfather" role is only shown as a hint.

;attribute: (''[[#secondary_object|sec. obj.]]'') - [[Attributes_in_Gramps|Attributes]] are for something permanent, or at least somewhat permanent: eye color, blood type, etc. Usually you would have not more than one of each attribute type for a [[#person|Person]]/[[#family|Family]]/etc. Attributes are managed from an Attributes tab in each [[#primary_object|primary Object]] Editor. There are a few pre-defined Attributes to support GEDCOM, but [[#custom|custom types]] will tend to be needed.

==B==
;Books Report:
A [[Gramps_{{man version}}_Wiki_Manual_-_Reports|Reports menu]] feature of Gramps that allows the [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_3|design or generation of a repeatable custom genealogy ''Book'']]. A Book consists of an ordered collation of Gramps textual and graphical reports in a single document. The individual report configuration options are also stored with the Book but the Book's document pagesize and print destination configuration options override.

;Bride: (''[[#event_role|event role]]'') A term to refer to the woman a marriage ceremony who will have the role of ''wife'' in the marriage. See also: ''mother''.

;BSDDB: (''[[Database_Backends|database backend]] engine'') The [http://www.oracle.com/us/products/database/berkeley-db/overview/index.html Berkeley Software Distribution database] (also known as BSDDB) was the first ''default database engine'' used by the [[Database_Formats#Gramps_2.0|2.0]] through the [[Database_Formats#Gramps_5.0|5.0]] versions of Gramps. Originally, Gramps [[#xml|XML]] was used directly rather than as a Backup and data exchange format. The default db engine changed to [[#sqlite|SQLite]] in the 5.1 version via the [[DB-API_Database_Backend|DB-API Database Backend]]. ([[Install_latest_BSDDB|Manual updates to the BSDDB engine]] for the 5.1.3 version may be advisable.)

==C==
;Category: (''core concept'') Gramps divides and organizes the information about each [[#primary_object|Primary Object]] into a series of different descriptive schemas called Categories, each with their own [[#view|View]]. Each Category is a smaller, more digestible portion of the total information that comprises a Genealogical Tree. The View categories are: {{icon|gram}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Dashboard_Category|Dashboard]], {{icon|peop}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#People_Category|People]], {{icon|rela}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Relationships_Category|Relationships]], {{icon|fami}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Families_Category|Families]], {{icon|ance}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]], {{icon|even}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Events_Category|Events]], {{icon|plac}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Places_Category|Places]], {{icon|geog}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Geography_Category|Geography]], {{icon|sour34}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Sources_Category|Sources]], {{icon|cite}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Citations_Category|Citations]], {{icon|repo}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Repositories_Category|Repositories]], {{icon|medi}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Media_Category|Media]], {{icon|note}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Notes_Category|Notes]]

;Celebrant: (''[[#event_role|event role]]'') A term describing a role of the person who performs a rite, especially referring to a priest at the Eucharist.

;[[File:Gramps-citation.png|right]]Citation: ({{icon|cite}} ''[[#primary_object|prim. obj.]]'') - Contains the information that enables you or others to locate your source document. An isolated [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_source_citations|Citation can be created]] without first creating separate [[#source|Source]] object. But, should the same source be referenced repeatedly in a Tree, a separate Source simplifies the Citation and eliminates redundant information that must be harmonized.

;Clergy: (''[[#event_role|event role]]'') A term applied to a religious person regardless of religion. For example, a monk or priest. See also: ''[[#celebrant|celebrant]]''. Religious terminology is often subject to dispute, see the [https://www.merriam-webster.com/dictionary/clergy Merriam-Webster] for an independent definition.

;[[File:Gramps_Clipboard48x48_win.png|right]]Clipboard: ''([[#gui|graphical user interface terminology]])'' - The [[Gramps_{{man version}}_Wiki_Manual_-_Navigation#Using_the_Clipboard|Gramps Clipboard]] is a shortcut system for [[#sharing|sharing]] a [[#secondary_object|secondary]] object, navigation, and custom [[#filter|filter]] creation. '''Usage:''' The Clipboard can be opened from a icon on the [[#toolbar|Toolbar]], from the Edit -> Clipboard menu choice or by using the Copy [[Gramps_{{man version}}_Wiki_Manual_-_Keybindings#7|keybinding]] for the Active Record in the Active main view of a View category. A floating clipboard dialog that has become buried can be brought to the top of the stack by selecting '''Clipboard...''' from the Windows menu. The Clipboard can greatly improve data entry efficiency, see the "[[How_to_use_the_Gramps_Clipboard|How to use the Gramps Clipboard]]" article for more information.

;Context menu: ''([[#gui|graphical user interface terminology]])'' - a [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Pop-up_menus|contextual pop-up menu]] (<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> [https://wikipedia.org/wiki/Context_menu "context menu"]) is a menu that appears when right-clicking (or pressing the [https://wikipedia.org/wiki/Menu_key Menu keyboard key]) when the menu options directly relate to the item indicated by the mouse pointer. Thus, the indicated item provided the "context."

;''custom'' Types: This indicates a user-defined classification, as opposed to classifications that came pre-defined in Gramps. (i.e.: 'Birth' and 'Marriage' are 2 of the pre-defined 'types' of Events.)
:When none of the pre-defined Types are suitable, add a new ''[[#custom|custom]]'' Type by typewriting directly into the [[#selector_combo_box|selector combo box]]. If the value doesn't precisely match any of the existing menu items, a new ''custom'' Type will be created when the {{man button|OK}} button is clicked. Any added ''custom'' Type will remain available in that expanded menu... unless the Tree is exported and re-imported or removed via a [[Third-party_Addons|Third party addon]] Utility like [[Addon:Types_Cleanup_Tool|Type Cleanup]]. '''''custom'' Types''' can be defined for: Event [[#attribute|Attributes]], Family [[#attribute|Attributes]], media [[#attribute|Attributes]], Person [[#attribute|Attributes]], [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#General|Event Roles]], [[Custom_Event_Types|Event types]], Family [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Relationship_Information|Relationship Information]] types, [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Child_Reference_Editor|Child Reference]] Types, [[Names_in_Gramps#Origin_Attributes|Name Origin Types]], [[Names_in_Gramps#Name_Types|Names Types]], [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data%3A_detailed_-_part_2#Note_editor_dialog|Note Types]], [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data%3A_detailed_-_part_2#Place_Editor_dialog|Place Types]], [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Repository_Reference_Editor|Repository]] Types, Source [[#attribute|Attributes]], [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Repository_Reference_Editor|Repository]] Media Types, [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet_Address_Editor|Internet Address (URL)]] Types.

==D==
;date: (''[[#secondary_object|sec. obj.]]'') - Dates in Gramps are much more complex than just a month, day, and year. Dates are always in a [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Calendars|particular calendar]], can span a time frame with the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date_Type|Date Type]], the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date_Quality|Date Quality]] can be exact (or an approximation variant), and have support for many other subtleties specific to genealogy data. The approximation can be fine-tuned with the [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Limits|Limits]] preferences. The [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date_formats_and_parsing_rules|date parsing rules]] are applied whenever data is entered into a [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|date text field]] or a [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date_selection_dialog|date selection dialog]].

;DNA:
# acronym: '''d'''eoxyribo'''n'''ucleic '''a'''cid
# a [https://wikipedia.org/wiki/Nucleic_acid nucleic acid] that carries genetic information. Genetic testing compares for matching sequence lengths (measured in centimorgans, aka cMs) at various loci on specific chromosomes to determine common ancestry.

;Dock: ''([[#gui|graphical user interface terminology]])'' - a [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Pop-up_menus|dock]] is one of the multitude of containers offering controlled access and context to Gramplets. Gramplets can be added to, removed from, or undocked from a container to float free of the main window. The Dashboard was the original container and can be configured with multiple columns and stacks of Gramplets. The [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|sidebar and bottombar splitbars]] are Category-specific containers. The splitbars only show a single gramplet at a time but with tabs to quickly switch between them. Each view mode has its own set of splitbars. So the basic configuration of Gramps has the Dashboard plus 24 Category view modes... or 49 separate gramplet containers.

;DTD:
:acronym: '''D'''ocument '''T'''ype '''D'''efinition. A document that defines the tagging structure which identifies the individual components of an [https://wikipedia.org/wiki/Standard_Generalized_Markup_Language SGML] or [[#xml|XML]] document. See the [https://www.gramps-project.org/xml/ reference documentation for the versions] of Gramps [[Gramps_XML#RELAX_NG_generation|RELAX NG]] ('''RE'''gular '''LA'''nguage for '''X'''ML '''N'''ext '''G'''eneration)(<code>.rng</code>) schema [[#xml|XML]] and DTD

==E==
;[[File:Gramps-event.png|right]]Event: ({{icon|even}} ''[[#primary_object|prim. obj.]]'') - Contains the information related to an happening. [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Adding an Event record]] provides the context of an interaction of the roles of People/Families, dates & places in activities. An Event is a defining moment in a person's life. See [[events in Gramps|events]] for the use in genealogy, for predefined events in Gramps and suggested naming for [[Events_in_Gramps|common events]].

;event role: The [[#role|role]] a [[#person|Person]] plays in an [[#Event|Event]]. The focal Person(s) holds a [[#primary|'''''Primary role''''']] in personal Events and the Family holds a [[#family_role|'''''Family role''''']] in Family events. In Gramps, an Event can be linked to as many participants as desired. Each [[#person|Person]] may participate in different roles but more than one Person might play the same role. The Event Role captures this and can be changed in the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Event_Reference_Editor_dialog|Event Reference Editor]]. Some common Roles are pre-defined but the user can add other [[#custom|custom]] Roles by just typing in the appropriate new label into the [[#selector_combo_box|selector combo box]].
:Pre-defined Types of Event Role: [[#aide|Aide]], [[#bride|Bride]], [[#celebrant|Celebrant]], [[#clergy|Clergy]], [[#family_role|'''''Family''''']], [[#godparent|Godparent]], [[#groom|Groom]], [[#informant|Informant]], [[#primary|'''''Primary''''']], [[#witness|Witness]], [[#unknown|'''''Unknown''''']], ''[[#custom|custom]]''

;event type: The general denominator to which an event belongs, <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>, a christian, civil, tibetan, ... marriage, are all denoted by the event type ''marriage''. See [[events in Gramps]] for an overview.

==F==
;Fallback events:
:Certain [[#event|event]] types are definitive bookends marking the beginning or end of a life (Birth/Death) or relationship (Marriage/Divorce). Those bookend events are key factors in any kind of timeline analysis.
:If the definitive event types are missing, Gramps will look for similar event types to calculate a 'fallback' approximation. When dates are shown in italics, it indicates that the preferred bookend event was not found and one of the [[Events_in_Gramps#Fallback_Events|pre-defined Fallback events]] had to be used. Markers for some fallback events can be customized using the '''Genealogical Symbols''' tab of [[#preferences|Preferences]].

;Family:
#[[File:Gramps-family.png|right]]'''Family''' ({{icon|fami}} ''[[#primary_object|prim. obj.]]'') - Contains the information specific to relationships between people. The information may be edited directly using the {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_relationships|Edit Family]]}} dialog. This traditionally contains one or two parents and zero or more children. A family unit is created in Gramps by [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_brief#Specifying_a_relationship_using_the_Relationship_View|adding Parents to an individual]], by [[Add_a_spouse|adding a partner/spouse]] to an individual, or by adding a family first then adding the people. (A family can even consist of just the offspring.) The Family relationship is a core concept in Gramps. It depicts the basic relations between people. Commonly this will contain a father, a mother and some children, however, it can also contain only parts of this (<abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>, two brothers, a mother and child). People can be part of several families (adoption, remarried, ...)
#'''Family''' (''[[#event_role|event role]]'') An event can be coupled to a family, denoting that the both partners were equally involved in the event. Typically, the Marriage event will be coupled to a family with event role ''family''. '''Family''' is the ''default'' role when adding a new Event in the [[#edit_family|Edit Family]] dialog.

;File Chooser:
:Picking external files or folders for import, export, reports and media is done using a File Chooser dialog from [https://wikipedia.org/wiki/GTK GTK] (formerly known as "GIMP ToolKit" and "GTK+") rather than those of the native Operating System. While generally familiar, the '''[[Gramps_{{man version}}_Wiki_Manual_-_Settings#File_Chooser|GTK File Chooser]]''' has customizable features, [[#context menu|context menus]], options and keybindings that are documented in the [[Gramps_{{man version}}_Wiki_Manual_-_Settings|Settings]] section of the manual.

;File formats:
: File formats repackage the Tree database information for archiving, data exchange with other software or display.
:: '''[[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Importing_data|Import]] formats:''' GRAMPS v2.x database (obsolete) <code>.grdb</code>, Comma Separated Values <code>.csv</code>, GEDCOM (Genealogical Data Communication) <code>.ged</code>, GeneWeb <code>.gw</code>, Pro-Gen <code>.def</code>, vCard (virtual contact card) <code>.vcf</code>, JSON (JavaScript Object Notation) <code>.json</code>, SQLite <code>.sql</code>
:: '''[[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|Export]] formats:''' Gramps native XML format (compressed & uncompressed variants) <code>.gramps</code>, Gramps Package (Gramps XML plus media) <code>.gpkg</code>, GEDCOM (Genealogical Data Communication) <code>.ged</code>, GeneWeb <code>.gw</code>, Web Family Tree (a GEDCOM variant) <code>.ged</code>, vCalendar <code>.ics</code>, vCard (virtual contact card) <code>.vcf</code>
:: [[Output_formats|'''Output formats''']] including: Comma Separated Values <code>.csv</code>, Data-Driven Documents (D3) <code><code>.d3</code></code>, Graphviz graph description language <code>.dot</code>, Hypertext Markup Language <code>.html .htm</code>, LaTeX <code>.tex</code>, Open Document Text <code>.odt</code>, Portable Document Format <code>.pdf</code>, Plain Text <code>.txt</code>, PostScript <code>.ps</code>, Print (hardcopy), Rich Text Format <code>.rtf</code>, Scalable Vector Graphics <code>.svg</code>, vCard (virtual contact card) <code>.vcf</code>, Extensible Markup Language <code>.xml</code>

;Filter:
:A [[Gramps_{{man version}}_Wiki_Manual_-_Filters|filter]] (<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> query) in a database finds (or hides by 'filtering out') records, displaying only those records that match certain criteria. (The criteria are comparison or query [[#rule|rules]] describing some attribute of a record.) Layers of criteria can be applied but each layer requires additional processing and slows performance of the interface. The [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Filter_vs._Search|basic Search]] is a single criteria filter. The search value is compares only one attribute of a record that has been selected from a pop-up menu. The '''[[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Filter|Filter Gramplets]]''' will compare several predefined common attributes simultaneously with simplified access to changing the search value. The default is for exact matching but [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Regular_Expressions|Regular Expressions (RegEx)]] can be used for pattern matching. A Custom Filter may be also layered in. A [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Custom_Filters|Custom Filter]] adds richly complex [[#rule|Rules]]-based comparison with [[Example_filters|layers of intersection]] options for those rules. Custom Filters allow repeatable filters to be created with pre-defined rules and values to be matched. Beyond interactively hiding (or revealing) records in views, Custom Filters are used to set limits for exporting, setting scopes for reports, and targeting tool actions. In addition to the [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Which_filter_rules_in_which_Category.3F|builtin rules]] for filtering, [[Addon:Rule expansions]] are available for Custom Filters.

==G==
;GEDCOM:
# acronym: '''Ge'''nealogy '''D'''ata '''Com'''munication
# a format for [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|importing]] and [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|exporting]] genealogical data. The <abbr title="an open standard is a standard that is publicly available and has various rights to use associated with it, and may also have various properties of how it was designed such as 'open process.' There is no single definition and interpretations vary with usage.">open</abbr> specification for the [https://www.familysearch.org/developers/docs/guides/gedcom GEDCOM format] was developed by The Church of Jesus Christ of Latter-day Saints (LDS Church) as an aid to genealogical research. The long standing standard release was version 5.5 in 1996 with a 5.5.1 draft update presented for comment in 1999. (Belatedly, the 'draft' label was officially removed in the annotated 2019 release. After 20 years as the de facto standard format, it remained unimproved excepting for 2 tags and the copyright.)
::As an Open Standard, there are extensive and constantly changing incompatibilities between implementations and data loss when transferring GEDCOM formatted data between competing software tools is common. Gramps has implemented a variety of [[GEDCOM|GEDCOM support features]].
::GEDCOM [https://www.familysearch.org/developers/docs/guides/gedcom-x X proposed in 2012] and [https://blog.eogn.com/2019/10/04/the-proposed-gedcom-5-5-5-standard-is-a-better-gedcom/ 5.5.5 proposed in 2019] are improvements that have not gained the approval of the copyright holder. As of June 2021, these proposals have been superseded by the GEDCOM 7.0.1 version.

;Godparent: (''[[#event_role|event role]]'') A term to refer to the person who presents a child at a christening or baptism and promises to take responsibility for guiding the child emotionally, practically, and spiritually. This person will be referred to as ''godfather'' or ''godmother'' after the christening or baptism. See also: ''[[Add_a_godfather-godmother|Add a godfather-godmother]]''.

;Gramplet: a [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#definition|Gramplet]] is a plug-in (<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> [https://wikipedia.org/wiki/Software_widget widget] or [https://wikipedia.org/wiki/Applet applet]) that can be [[#dock|docked]] in the {{icon|gram}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Dashboard_Category|Dashboard]] category view. Later [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|sidebar or bottombar]] were added to the remaining [[#view|views]] to extend [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Gramplet_Bar_Menu|adding]] and [[#undock|undocking]] a Gramplet functionality of those view. Gramplets dynamically update as the different records are selected in the main display area of a view. Gramplets typically create an alternate interface to your Family Tree data. Collections of [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Summary_of_Gramplets|builtin]] and [[{{man version}}_Addons#Addon_List|"3rd party addon"]] gramplets are available for [[{{man version}}_Addons#Installing_Addons_in_Gramps|installation]] and download with the [[Gramps_{{man version}}_Wiki_Manual_-_Plugin_Manager|Plug-in Manager]]. The Plug-in Manager also regulates a [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Aren.27t_all_Plugins_also_Gramplets.3F|wide variety of other builtin and addons]] which can expand functionality unrelated to the interface.
:''See the [[Gramplets development]] for independent information.''

;Gramps for Desktops: [https://gramps-project.org/blog/features/ Gramps] is an open-source genealogy application, a free software project and community. '''Gramps''' is an affectionate nickname for a "Grandfather". Originally, the all capital letter [https://wikipedia.org/wiki/Backronym backronym] stood for "'''G'''enealogical '''R'''esearch and '''A'''nalysis '''M'''anagement '''P'''rogramming '''S'''ystem" and was coined by Larry Allingham. ([https://gramps-project.org/blog/2006/04/looking-back-over-5-years/ GRAMPS was created around 2001] by [[User:Don|Don Allingham]] for use by his father, Larry.) This backronym was phased out around March 2010 in favor of '''Gramps''' as the official name of the software. All upper-case acronym-based names have become unfashionable for software.''

;Gramps Web for Servers: [https://gramps-project.org/blog/web/ Gramps Web] is collaborative interface (frontend) and backend created by David M. Straub for running the Gramps genealogy database engine on servers. It is one of the [[Web_Solutions_for_Gramps|Web Solutions for Gramps]]. It is a multi-user system genealogical web application with different levels of options for Visitors, Members, Contributors, Editors, and Owners. Trees in [[https://www.grampsweb.org Gramps Web on a server]] can be synchronized with the more mature and feature laden [[#gramps|Gramps for Desktops]]. Single Tree or multiple Tree sites can be self-managed on a hosted service from an ISP, leased from a managed hosting ISP, or leased from an application-specific fully managed CMS provider, or installed locally for access from a local area network.

;Graphical User Interface (GUI): a visual way of indicating interactive features of a computer operating system or application/program.
:The '''Gramps for Desktops''' GUI is introduced in [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window|Visual Guide to Gramps Interface]]. It uses a "windows, icons, menus, pointer" ([https://wikipedia.org/wiki/WIMP_(computing) WIMP]) based approach with [https://wikipedia.org/wiki/Post-WIMP post-WIMP] elements like hyperlinked redirection and custom interface objects. The desktop interface is built with [https://wikipedia.org/wiki/GTK Gtk] (the Gimp Toolkit), a free and open-source cross-platform widget toolkit for creating graphical user interfaces.
:The appearance and interaction may vary by conventions dictated by the [[Download|Operating System (OS)]], installation option (such as [[Portal:Translators|language localization support]] or [[{{man version}}_Addons|addon/plug-in]]), [https://wikipedia.org/wiki/Theme_(computing) theme] (at the OS or [[Addon:ThemePreferences|internal]] levels), and/or [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Preferences|user preferences customization]].
:The specific interface elements are identified by customary name, general appearance & behavior in the [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window|Visual Guide to Gramps Interface]]. Expansion interface elements are described in the user documentation for [[{{man version}}_Addons|each specific addon]]. 
:The '''Gramps Web''' GUI (or frontend) is a platform-agnostic web browser interface built with the [https://lit.dev/ Lit] lightweight JavaScript library for building fast, interoperable web components. Although the hosting side requires a webmaster with significant skills, genealogical collaborators can use web browser on almost any device.

;Groom: (''[[#event_role|event role]]'') A term to refer to the man at a marriage who will be referred to as ''husband'' after the marriage. See also: ''[[Add_a_spouse|Add a spouse]]''.

;GUI: An acronym. ''see [[#graphical user interface|Graphical User Interface]]''.

==H==
[[File:Gramps Go-Home48x48 win.png|right]]
;Home Person: (''core concept'') - The persistently designated '''Home Person''' is the foundational [[#person|Person]] (the [[Genealogy_Glossary#proband|Proband]], [[Genealogy_Glossary#progenitor|Progenitor]], or [[Genealogy_Glossary#progenitrix|Progenitrix]]) in the Tree (the currently open Gramps database). This Person is the central target of genealogical research and family references extend from this center. Ideally, every person, event and source in the Tree will (however directly or indirectly) relate back to the '''Home Person'''. By default, the database reports describe everything else in contextual relation to this person. The [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Status_Bar_and_Progress_Bar|Status Bar]], the [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Quick_View|Quick View]] called "[[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8#Relation_to_Home_Person|Relation to Home Person]]", and the Third party addon [[#gramplet|Gramplet]] called "[[Addon:Deep_Connections_Gramplet|Deep Connections]]" all describe different aspects of the relationship of the [[#active_person|Active Person]] to the '''Home Person'''. You (or your client) are customarily designated ([[Gramps_{{man version}}_Wiki_Manual_-_Settings#Setting_Home_person|set]]) as the Home Person. And this ''Home'' designation serves as a persistent point of reference for the rest of the Tree in Reports generally and for the Active Person in detail. But a different '''Home Person''' might be temporarily [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Setting_Home_person|set]] when generating reports or when researching a complex biography or obituary. Fascinating tidbits often lure Gramps researchers into wandering off-course. When the [[#active_person|Active Person]] has become lost, the bearings can be instantly regained by navigating the [[#active_person|Active Person]] selection back to the '''Home Person'''. Navigate to '''Home Person''' - ''keyboard shortcut'' {{man key press|Alt|Home}} or press the toolbar [[File:Gramps_Go-Home48x48 win.png|text-bottom|20px]]{{man button|Home}} button. The custom filter rule for finding the '''Home Person''' is in a People category filter under the General filters and was named 'Default person' until the 5.1 version.

==I==
;Informant: (''[[#event_role|event role]]'') A term to refer to the [[#role|Role]] of Person who reports an [[#event|Event]].

==J==
;JSON: acronym: [https://wikipedia.org/wiki/JSON '''J'''ava'''S'''cript '''O'''bject '''N'''otation]. JSON is a lightweight, text-based data format designed to be easy for humans to read while still structured enough for machines to parse efficiently. It organizes data in key-value pairs, allowing information to be grouped together in a clear and straightforward way.

==K==
;Keybinding: Keyboard shortcuts (<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> hotkeys) key (or combination of keys) that can be used to navigate a Graphical User Interface (<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> [[#gui|GUI]]) as an alternative to using the mouse. A single keystroke (or combination of keys on a keyboard) executes a command.
:''see [[Gramps_{{man version}}_Wiki_Manual_-_Keybindings#toc|Gramps GUI keybindings]]''

==L==
==M==
;matronym:
:(''[[#name_origin|origin]] Name attrib.'') - personal name based on the name of one's mother

;[[File:Gramps-media.png|right]]Media: ({{icon|medi}} ''[[#primary_object|prim. obj.]]'') - Contains the information related to a media object. Media objects include images, videos, audio recordings, documents, webpages or any other type of related files. When new Media objects are edited from the Gallery tabs of Object Editors or from the Media category view, the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_media_objects|New Media editor]] allows the metadata to be modified.

;[[File:Gramps_Merge48x48_win.png|right]]Merge
:To combine the objects in two selected rows in a [[#view_category|category view]] into a single object. This reduces duplicates while consolidating references and [[#secondary_object|secondary objects]]. The [[Merging_people|merge process]] involves selecting two rows (a target row to be kept and a row to be deleted) then choosing '''Merge''' from the Toolbar or Edit menu. Choices are offered about which secondary objects take precedence when there are conflicts, but no data (except one of the descriptions in an Event merge) is lost by default. All secondary objects from both selected rows are conveyed to the surviving merged row. Only two objects may be merged at a time unless using addon tools designed for multiple object merges or batches of merges.

;Mode:
:''see [[#viewmode|View mode]]''

==N==
;Name Origin:
:An optional attribute (characteristic) identifying how a name was derived for a [[#person|Person]]. Pre-defined items of the [[Names_in_Gramps#Origin_Attributes|origin selection menu]] include: inherited, patrilineal, matrilineal, given, taken, [[#patronymic|patronymic]], [[#matronymic|matronymic]], feudal, pseudonym, occupation. The Name Origin of [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Multiple_Surnames|Multiple surnames]] and [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Names|Alternative names]] can be added from the [[#edit_person|Edit Person]] dialog. ''Available as a standard attribute of [[Names_in_Gramps|Names in Gramps]].''

;Navigator: ''([[#gui|graphical user interface terminology]])'' - the [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Navigator|Navigator]] is a Gramps-specific name for a left sidebar layout of [[#category|category]] view icons, allowing movement between (aka 'navigating') the different View categories. There are [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Switching_Navigator_modes|multiple layout modes]] and a [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Environment_Settings|text label preferences option]] for the sidebar. This sidebar may be hidden or revealed from the menu {{man menu|[[Gramps_{{man version}}_Wiki_Manual_-_Navigation#View|View ->Navigator]]}} or by using the [[Gramps_{{man version}}_Wiki_Manual_-_Keybindings#7|keybinding]]. Navigator layout modes are 'Sidebar' type [[#plugin|plugins]] that can be added, removed, hidden or revealed using the Plugin Manager. Gramps divides and organizes the information about each [[#primary_object|Primary Object]] into a series of [[#category|Categories]], each with their own View. Each of the Category Views displays a smaller, more digestible portion of the total information that comprises a Genealogical Tree. The View categories are: {{icon|gram}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Dashboard_Category|Dashboard]], {{icon|peop}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#People_Category|People]], {{icon|rela}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Relationships_Category|Relationships]], {{icon|fami}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Families_Category|Families]], {{icon|ance}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]], {{icon|even}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Events_Category|Events]], {{icon|plac}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Places_Category|Places]], {{icon|geog}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Geography_Category|Geography]], {{icon|sour34}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Sources_Category|Sources]], {{icon|cite}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Citations_Category|Citations]], {{icon|repo}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Repositories_Category|Repositories]], {{icon|medi}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Media_Category|Media]], {{icon|note}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Notes_Category|Notes]]

;[[File:Gramps-notes.png|right]]Note: ({{icon|note}} ''[[#primary_object|prim. obj.]]'') - Contains the information representing a textual brief record of facts and how it [[#reference|references]] other objects in the Tree. Notes can be added to any object at any any level of the Tree and are often used to detail the context of that record in the Tree.
:Records in the [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Notes_Category|Note Category]] contain free-form text with [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Note_markup_and_preformat_in_reports|basic formatting]] and [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Link_Editor|linking]] features. Notes can be categorized by [[#tag|Tag]] and [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#note_type|Type]] in addition to the object to which it is attached. That information is created and modified using the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_notes|Notes Editor]].

==O==

;Object: The most basic framework unit of genealogical data as structured in the Gramps [[Gramps_Data_Model|data model]].
:The most complex structures are the [[#primary_object|Primary Object]] of a [[#category|category]]. Each has an [[#object_editor|Object Editor]] that organizes entering data in that structure but also allows attaching or creating [[#secondary_object|secondary objects]].

;Object Editor ''(<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> Edit Object dialogs)'': (''core concept'') The object editor dialogs show the basic info of the [[#primary_object|Primary Object]] in the structured form of the header area where it can be directly edited. And the bottom tabbed section allows the editing of interrelationships with [[#secondary_object|secondary objects]] and provides access to the Object Editors for those secondary objects.
:Click the following links for instructions of how to open and use each type of Edit Object dialog.
:The available categories of object editor dialogs are: {{icon|peop}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_people|Edit Person]]}}, {{icon|fami}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_relationships|Edit Family]]}}, {{icon|even}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Edit Event]]}}, {{icon|plac}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_places|Edit Place]]}}, {{icon|sour34}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|Edit Source]]}}, {{icon|cite}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_source_citations|Edit Citation]]}}, {{icon|repo}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_repositories|Edit Repository]]}}, {{icon|medi}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_media_objects|Edit Media]]}}, {{icon|note}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_notes|Edit Note]]}}
:The available categories of object reference editor dialogs for [[#sharing|shared objects]] are: {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Person_Reference_Editor|Person Reference Editor]]}} ''(see [[#association|Associations]])'', {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Child_Reference_Editor|Child Reference Editor]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Event_Reference_Editor_dialog|Event Reference Editor]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Reference_Editor|Place Reference Editor]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Repository_Reference_Editor|Repository Reference Editor]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Media_Reference_Editor_dialog|Media Reference Editor]]}}

;Officiator: (''[[#event_role|event role]]'') A term to refer to the role of a person authorized to conduct an official duty or function. (Such as performing a marriage or funeral ceremony or conferring a vocational degree.) Jurisdiction may be derived from a from holding a position of civil or religious authority. Use 'OFFICIATOR' rather than 'Officiant' for [[#gedcom|GEDCOM7]] Roles compatibility.

==P==
;patronym:
:(''[[#name_origin|origin]] Name attrib.'') - personal name based on the name of one's father.

;[[File:Gramps-person.png|right]]Person: ({{icon|peop}} ''[[#primary_object|prim. obj.]]'') - Contains the information specific to an individual person in the People category. The information may be edited directly using the [[#edit_person|Edit Person]] dialog.

;[[File:Gramps-place.png|right]]Place: ({{icon|plac}} ''[[#primary_object|prim. obj.]]'') - The Gramps concept of a Place is a particular location independent of time. Over time, the same Place may have different hierarchical (or name) information due to changing borders and political situation. For example, Leningrad and St. Petersburg represent the same place, but with different names. Places in Gramps are stored in a hierarchy and are direct accessed via the [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Places_Category|Places category view]]. Places can be defined (or refined) through the Place Editor and shared with the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Place_selector|Select Place]] object selector. A Place consists of:
:* Descriptive Title
:* Name (with optional date span and language attributes)
:* A list of alternative names for the place
:* Type ([[#administrative_division|administrative divisions]] such as country, state, county ...)
:* Longitude/Latitude
:* Code (such as a country code or postal code)
:* A hierachical list of regions which enclose the place

;plugin: (<abbr title="also known as — abbreviation used to indicate another name that a person/thing has/uses">''aka''</abbr> [https://wikipedia.org/wiki/Plug-in_(computing) plug-in])
:* a type of [[Writing_a_plugin|expansion framework that allows Gramps customization]] by providing interface hooks to recognize and use external code.
:* customized module of code built to provide a specific feature or functionality that is not part of the core program.
:The [[Addon_list_legend#Type|various types]] of Gramps plugin code modules can be enabled or disabled via a [[Gramps_{{man version}}_Wiki_Manual_-_Plugin_Manager|plugin manager]]. Plugin types include: Citation formatter, [[Database_Backends|Database]], Doc creator, Exporter, [[#gramplet|Gramplet]], Gramps View ([[#view|''Category'']] or [[#viewmode|''mode'']]), Importer, [[Map_Services|Map Service]], Plugin lib, [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quickreport'''/'''Quickview]], Relationships, [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_1|Report]], [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Add_Rule_dialog|Rule]], Sidebar, Thumbnailer [[Gramps_{{man version}}_Wiki_Manual_-_Tools|Tool]].
:Plugins can be builtin (''included with the normal distribution of Gramps'') or an [[{{man version}}_Addons#Addon_List|addon]] (''installed via the [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Third_party_addons_management|Third party addons management]] in Preferences'').

;POSIX: [https://wikipedia.org/wiki/Posix Portable Operating System Interface]: a family of OS standards specified by the [https://wikipedia.org/wiki/IEEE_Computer_Society IEEE] Computer Society for maintaining compatibility with variants of Unix (such as Linux) and other operating systems. Although the MacOS is "POSIX-certified", the term is used in this manual to generically refer to just the "Mostly POSIX-compliant" Linux and BSD distributions [[Download#Linux_and_BSD_distributions|with verified Gramps downloads]] and which use the POSIX-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment].

;Preferences: The {{Man menu|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Preferences|Preferences]]}} is an option in the {{Man menu|Edit}} main menu that allows '''''global''''' customization of the appearance, defaults and behavior of Gramps. The customizations are categorized into the following tabs: {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Data|Data]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#General|General]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Import|Import]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Limits|Limits]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Colors|Colors]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Text|Text]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Warnings|Warnings]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Researcher|Researcher]]}}.
:(A {{man label|[[Addon:ThemePreferences|Theme]]}} tab is available as an addon.) (see also ''{{Man menu|Configure...}}'' option in the {{Man menu|View}} main menu is an option. Those customization are limited to the currently active view and its Gramplets. The feature may also be accessed by the {{man button|Configure...}} toolbar icon.)
:The Gramps 5.1 and older preferences are categorized into the following tabs: {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#General|General]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Display|Display]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Text|Text]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Dates|Dates]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Researcher|Researcher]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Warnings|Warnings]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Colors|Colors]]}}, {{man label|[[Gramps_5.1_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}.

;Prerequisites: Additional software required to make certain features of Gramps work and or some [[:Category:Prerequisites|addons]].

;Primary object: Primary objects are the [[Using_database_API|data structures]] at the top level of a [[Gramps_Data_Model|hierarchical collection of records]] in the Gramps [[Gramps_Data_Model|data model]]. Beside the main structure of data, they can contain a hierarchy of [[#secondary_object|secondary objects]], and can be referenced by other primary or secondary objects. In the Gramps database, primary objects and the secondary objects that they contain are stored as separate records. Each primary object type is stored in a separate table. See [[Using_database_API#Primary_Objects|Using database API, Primary Objects]] (see also ''[[#secondary_object|secondary object]]'')
: The types of [[Using_database_API#Primary_Objects|primary objects]] are: {{icon|cite}} [[#citation|Citation]], {{icon|even}} [[#event|Event]], {{icon|fami}} [[#family|Family]], {{icon|medi}} [[#media|Media]], {{icon|note}} [[#note|Note]], {{icon|peop}} [[#person|Person]], {{icon|plac}} [[#place|Place]], {{icon|repo}} [[#repository|Repository]], {{icon|sour34}} [[#source|Source]], [[File:16x16-gramps-tag.png]] [[#tag|Tag]].

;Primary role: (''[[#event_role|event role]]'') A term to refer to the [[#role|role]] of the focal participant of an [[#event|Event]]. '''Primary''' is the ''default'' role when adding a new Event in the [[#edit_person|Edit Person]] dialog.

;[[File:gramps-lock.png|right]]Private flag or tag:
: The Private option identifies sensitive information that should be redacted when sharing data or printing reports. ''(This marker should not be confused with the generic user-definable [[#tag|Tags]] used for custom filters and color highlighting.)'' Records are shown with: a [[File:22x22-gramps-lock.png]]locked padlock when private; and, an [[File:22x22-gramps-unlock.png]]unlocked padlock when public. Clicking the padlock icon toggles between Private & Public flags. This manual override supplements the automated [[Gramps_{{man version}}_Wiki_Manual_-_Probably_Alive|Probably Alive]] and custom [[Filter|Filter]] features which help Gramps to respect Personal Privacy.
:Gramps is a single user database and omits the typical security features of a multi-user system. So even "Private" data will be accessible from within Gramps. However, generating reports and exporting data default to redacting information flagged as Private.

;[[File:gramps-unlock.png|right]]Public tag or flag:
: The Public option identifies information that should be included when sharing data or printing reports. Records are shown with: a [[File:22x22-gramps-unlock.png]]unlocked padlock when public; and, an [[File:22x22-gramps-lock.png]]locked padlock when private. Clicking the padlock icon toggles between Public & Private flags. By default, all records are created as Public.

==Q==
;Quick View: On-screen [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8#Quick_Views|reports]] about information surrounding the active object that do not print or save to file. Generally the report is selected from a [[#context_menu|context menu]] for the selected category of record and will have no configurable options. The [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Quick_View|Quick View '''gramplet''']] refreshes a builtin [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8#Quick_Views|builtin]] or [[{{man version}}_Addons#Addon_List|addon]] QuickView reports as the focus of the active record is changed. The specific QuickView report is selected in a view configuration dialog opened with the {{man menu|View -> Configure...}} menu.

==R==
;Reference: the basic a system of linking relationships between objects in Gramps. When when an object is added in the Editor for record, a [[References#definition|Reference]] (link) is created in the object that was added.

;[[File:Gramps-relation.png|right]]References tab: a system of linking between objects in Gramps. When objects of Gramps are linked, the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#References|References tab]] lists the objects to link toward it.

;Regular Expressions: [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Regular_Expressions|RegEx]] is a system to specify a text string pattern for comparing and matching. Optionally used to extend a power of the Filter Gramplets and Custom Filters rules.
:Filters in [https://gramps.discourse.group/t/which-regex-syntax-does-gramps-use/2278/8 Gramps use the RegEx format specified by the installed version of Python]

;Re-order
:[[File:Stock_reorder.png|right]]To change the sequence of items within a list of [[#secondary_object|secondary objects]]. [https://gramps.discourse.group/t/re-ordering-data-in-gramps-topic-expansion-outline-for-wiki/5568 The interface for (and consequences of) re-ordering that sequence varies based on the list type.]
:The natural order of a list follows when the data was created. The first item in an ordered list is often considered the primary or preferred item of that type. The primary/preferred may be the only object considered in some charts and analyses. So when data entry of related objects was out of sequence, a re-ordering option becomes necessary.
:Re-ordering affects display order in the Tree, charts, and most reports. Note that in some contexts, dates can override the manual order, particularly for Places and Names.

;[[File:Gramps-repository.png|right]]Repository: ({{icon|repo}} ''[[#primary_object|prim. obj.]]'') - Contains the information related to a physical or virtual structure where genealogical and family history sources are stored. Once a [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_repositories|Repository is added]] to a Gramps Tree, it can used to organize [[#source|Sources]].

;role: function performed or part played by a person (or other Gramps [[#object|object]]) in a particular situation. When objects of Gramps are linked, a Reference is created where the implicit Role disambiguates the relative nature of the reference. ''For explicitly defined roles, see [[#event_role|event role]] and [[#association|association role]]''

;romanization:
: linguistic representation of a word in the Roman (Latin) alphabet

;Rule: a pre-defined abstraction that simplifies the interface for a structured query about a particular facet of your family tree. Rules allows users to choose search criteria without needing to understand the intricate details of the actual database query language. Rules are layered via the [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Custom_Filters|Custom Filters]] interface to [[#filter|filter]] with complex criteria.

==S==
;secondary object: Secondary objects are contained within other [[#object|objects]] of the structured Gramps [[Gramps_Data_Model|data model]], and cannot be referenced directly. They can contain other secondary objects. Examples include: Name, Date and Address. See [[Using_database_API#Secondary_Objects|Using database API, Secondary Objects]] (see also ''[[#primary_object|primary object]]'')

;Selector combo box: ''([[#gui|graphical user interface terminology]])'' - a [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Selector_Combo_Boxes|standard text entry box paired with pull-down list button]] is a [https://docs.gtk.org/gtk3/visual_index.html Gtk toolbox widget] (based on the standard [https://wikipedia.org/wiki/Combo_box combo box]). The combination of a drop-down list and a single-line editable textbox allows the user to: either key in a value directly; or, select a value from the list. Moreover, keying in a value that is not already in the list will add that [[#custom|custom type]] to the drop-down list.

;Shared objects: {{icon|share}}Sharing allows an Object to be linked at multiple places in the tree. Doing so establishes a relationship or maintains single set of attributes (or [[#secondary_object|secondary objects]]) that they hold in common. ([[#role|Roles]] for shared Events define the person or family participation level.)
:'''[[#object_reference_editors|Object Reference Editors]]''' allow updates to a shared object to be reflected in all instances mentioning (referencing) that shared object. Redundantly creating object with the same information should be avoided. (So, refining a Transcription Note shared by multiple Citations will show the updated transcription in all the Citations.)
:Object descriptions are grouped in two distinct sections:  • The '''Reference Information''' section contains information unique to one instance.  • The '''Shared Information''' of an object will be seen in all instances that are linked to it.

;selector: combo interface box that allows you to select an object. The [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Selector_dialogs|Select Family selector]] is one example.

;[[File:Gramps-source.png|right]]Source: ({{icon|sour34}} ''[[#primary_object|prim. obj.]]'') - Sources can be a person ''(family, friend, another researcher)'', thing ''(book, magazine newspaper, census)'', or place ''(courthouse, church, library, genealogical/historical society... although places might be better handled as Repositories)'' from which information comes, arises, or is obtained. After [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|adding a Source]] with the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Source_dialog|new source dialog]] to the [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Sources_Category|Sources category]] of a Gramps Tree, the Source can be referenced when adding a [[#citation|Citations]] and organized within [[#repository|Repositories]]. The same Source may exist in multiple Repositories and may have different Media Types (such as book, microfilm, or electronic) and Call numbers in each Repository.
:[[Sources#Definition|[more]]]

;SQLite: (''[[Database_Backends|database backend]] engine'') The [https://sqlite.org/about.html SQLite project's in-process library] (also known simply as SQLite) is the ''default database engine'' used since the [[Database_Formats#Gramps_5.1|5.1]] version of Gramps. The support was extended from [[#bsddb|BSDDB]] in the 5.0 version via the [[DB-API_Database_Backend|DB-API Database Backend]].

;Swatch: ''([[#gui|graphical user interface terminology]])'' - a [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Pick_a_Color_selector|color swatch]] is a sample square of a color or color pattern. Swatches may be dragged from the [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]] to apply that specific color to preferences.
:The word originally referred to sample pieces of cloth or fabric used for choosing or testing colors, patterns, or textures for interior or exterior design. It now means any small sample or representation of a larger whole and is commonly usage in the context of color representation and selection in software applications.

==T==
;[[File:gramps-tag.png|right]]Tag: ([[File:16x16-gramps-tag.png]] ''[[#primary_object|prim. obj.]]'') - A custom titled and color-coded label that [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Tagging|can be created with the Organize Tags dialog and attached]] to selected {{icon|cite}} [[#citation|Citation]], {{icon|even}} [[#event|Event]], {{icon|fami}} [[#family|Family]], {{icon|medi}} [[#media|Media]], {{icon|note}} [[#note|Note]], {{icon|peop}} [[#person|Person]], {{icon|plac}} [[#place|Place]], {{icon|repo}} [[#repository|Repository]] or {{icon|sour34}} [[#source|Source]] objects for the purpose of easy identification and filtering. A keyword or phrase used to group the collection to produce a report. Multiple tags may be used to label and categorize objects into multiple groups when filtering by other attributes is not viable.

;Toolbar: ''([[#gui|graphical user interface terminology]])'' - The [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is a ribbon (located below the application menubar) with button shortcuts for the most widely needed functions associated with the current view. The selection of buttons changes in response to the context of the current view. (<abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>, toolbar buttons for switching mapping [[#view_mode|view modes]] will only appear for the [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Geography_Category|Geography view]].)

;Typographical conventions: The [[Gramps_{{man version}}_Wiki_Manual_-_Preface#Typographical_conventions|customary formatting]] having special (and possibly peculiar) meaning when used throughout the MediaWiki driven [[Gramps_{{man version}}_Wiki_Manual|Gramps manual]] and documentation. The different typeface accents, highlighting and enclosures indicate specific parts of the Gramps [[#graphical user interface|Graphical User Interface]] ([[#GUI|GUI]]) or prompt a User activity.

==U==
;Unknown: (''[[#event_role|event role]]'') A placeholder for when the [[#role|role]] of a participant in an [[#event|Event]] has not yet been defined. Gramps sets an appropriate default Role as each new Event type is created. But when a new participant is associated with an existing Event via Share or drag'n'drop, the Role isn't as predictable. In such a case, an Unknown placeholder is inserted.
:Any Unknown [[#event_role|Event Role]] type causes a variety of reporting problems. [[Addon:Rule_expansions#People_with_events_with_a_selected_role|(Rule_expansions)Persons and Families with Unknown Roles]] should be found and the Roles manually replaced as soon as is practical.

;User Directory: (''core concept'') An alias for the file folder (directory) location where customizations (<abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>: preferences files, [[#addon|addons]], [[#plugin|plugins]]) are stored for the Gramps family of genealogy tools. Since this folder location varies by which Operating System and which Gramps fork has been installed, the '''User Directory''' is an 'alias' (a.k.a. placeholder) used in instructions about re-configuring Gramps. This alias allows [[Gramps_{{man version}}_Wiki_Manual_-_User_Directory|instructions for locating your specific '''User Directory''' file location]] to be consolidated in the documentation.

==V==
;View category: ''([[#gui|graphical user interface terminology]])'' - a [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window|'''View category''']] (often simply called a "'''[[Gramps_{{man version}}_Wiki_Manual_-_Main_Window|View]]'''") is a Gramps-specific name for the collection of [[#view mode|View modes]] (display layouts) presenting information in a structured and predictable manner. Different Views are selected from the [[#navigator|Navigator]] (left sidebar), Layouts are in table, outline or graphical formats; depending on the preferred way to represent how the data elements relate to on another. Gramps divides and organizes the information about each [[#primary_object|Primary Object]] into a series of [[#category|Categories]], each with their own View. Each of the Category Views displays a smaller, more digestible portion of the total information that comprises a Genealogical Tree. The View categories are: {{icon|gram}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Dashboard_Category|Dashboard]], {{icon|peop}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#People_Category|People]], {{icon|rela}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Relationships_Category|Relationships]], {{icon|fami}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Families_Category|Families]], {{icon|ance}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]], {{icon|even}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Events_Category|Events]], {{icon|plac}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Places_Category|Places]], {{icon|geog}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Geography_Category|Geography]], {{icon|sour34}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Sources_Category|Sources]], {{icon|cite}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Citations_Category|Citations]], {{icon|repo}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Repositories_Category|Repositories]], {{icon|medi}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Media_Category|Media]], {{icon|note}} [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Notes_Category|Notes]]

;View mode: ''([[#gui|graphical user interface terminology]])'' - a '''[[Gramps_{{man version}}_Wiki_Manual_-_Main_Window|View mode]]''' is a Gramps-specific name for the display layouts presenting [[#view_category|View category]] information in a structured and predictable manner. A [[#view_category|View category]] may have alternate '''view modes''' (subcategories) of display layout. (<abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>, Views with Table layouts might have flat listed or hierarchically grouped modes.) Navigating between View modes is from the [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Toolbar|toolbar]] and [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Switching_Navigator_modes|Navigator]]. Each mode of a category can be independently [[File:Gramps-config.png|22px]] configured. Each mode may maintain a separate object selection, filtering, and organization for its Gramplet bars. View data may be further subdivided with tabbed pages of layouts.

==W==
;wiki: (Hawaiian [https://wikipedia.org/wiki/Loanword loanword]) meaning 'quick'; or 'wikiwiki' meaning 'very quick'. For Gramps users, '''''[[User manual|the Wiki]]''''' (a.k.a. '''''[[User manual|Wiki Manual]]''''') refers to the collaborative website of educational material which is organized using the [https://mediawiki.org/wiki/MediaWiki MediaWiki] [https://wikipedia.org/wiki/Content_management_system content management system]. The core pages of that website being the structured reference-style [[#gramps|Gramps]] software user's operating guide. ''(Note that specific [[:Category:Tutorials|tutorial]] documents are also part of the wiki.)''
:For most internet users, the word is most often an inadvertent allusion to the 1995 [http://wiki.c2.com/?WikiWikiWeb WikiWikiWeb], the first website that builtin tools encouraging users to quickly & easily collaborate to expand the content of the site. See the term: [https://wiktionary.org/wiki/wiki 'wiki'] in [https://wiktionary.org/wiki/Wiktionary Wiktionary]

;Witness:(''[[#event_role|event role]]'') The term that applies to the people asked to be present at an event so as to be able to testify to its having taken place

==X==
;XML: acronym: [https://wikipedia.org/wiki/XML E'''x'''tensible '''M'''arkup '''L'''anguage]. A schema used to define the expected structure of data in a text format. The system annotates a document in a way that data elements are syntactically distinguishable from identifying tags. A markup language defines a set of rules for encoding documents in a fault tolerant format that is both (marginally) human-readable and machine-readable. Gramps will [[Generate_XML|generate XML]] format natively in compressed and uncompressed forms identified with a <code>.gramps</code> or <code>.gpkg</code> file extension. It is the format that definitively supports every piece of genealogical data stored by Gramps. Used as the working format until Gramps 2.0 started using a ''[[Database_Backends|database backend]]'' to improve performance, XML is now the standard Tree data backup format and recommended data exchange format. See the [https://www.gramps-project.org/xml/ reference documentation for the versions] of Gramps [[Gramps_XML#RELAX_NG_generation|RELAX NG]] ('''RE'''gular '''LA'''nguage for '''X'''ML '''N'''ext '''G'''eneration)(<code>.rng</code>) schema XML and [[#dtd|DTD]]

==Y==
==Z==

{{man tip|1=Wiki manual|2=Please enhance the {{man label|Wiki}} - create new glossary terms and add them to the wiki manual. Glossary term IDs are more memorable & predictable if kept to all lower-case and use underscores (_) for spaces. When translating the Glossary, please leave the English ID anchors but also add translated variants of the same anchor. This allows users to look up a term in either language.

inserting a "Glossary Term" into the Glossary list 
<code><nowiki>;Glossary Term: Definition of the term.</nowiki></code>

inserting the term into the Gramps wiki manual 
<code><nowiki>[[Gramps_Glossary#glossary_term|Glossary Term]]</nowiki></code>

for more information about WikiMedia sections, see: 
<code>https://meta.wikimedia.org/w/index.php?title=Help:Section#id_with_space</code>

}}

[[Category:Gramps terminology|*]]
[[Category:Translators/Categories]]
[[Category:Documentation]]

Template:Version windows portable

2026-02-16T21:20:22Z

CallMeDave: not tested but may have issue see https://gramps-project.org/bugs/view.php?id=14120

6.0.6<noinclude>

''three digit GrampsPortable for Windows version number, including fullstops''

* 6.0.6 Version Updated 2026-02-05 • Checked 2026-02-16
* 6.0.1 Version Updated 2025-04-30 • Checked 2025-05-13
* 5.2.2 Version Updated 2024-04-08 • Checked 2025-01-05
* 5.2.1 Version Updated 2024-04-03 • Checked 2024-04-05
* 5.2.0 Version Updated 2024-02-26 • Checked 2024-02-29
* 5.1.6 Version Updated 2023-08-14 • Checked 2023-08-15

The Windows7 version is relegated to legacy status as of the 5.2.0 version. The 32 bit is relegated to legacy status as of the 5.1.5 version. The current version will be installed if 64 bit OS detected. Legacy version will be installed for 32 bit detection's.

Current version of Gramps core is : {{version}}

Validate against package in [https://portableapps.com/apps/education/gramps_portable Gramps Portable page under Education at PortableApps] for current downloadable version

==Usage==
<code><nowiki>{{Version_windows_portable}}</nowiki></code>

==To request an update==
If outdated, contact the Package Maintainer:
* https://portableapps.com/development/outdated

Maintainer beginning 2021: John T. Haller
* https://portableapps.com/comment/254205#comment-254205

[[Category:Developers/Packaging ]]
[[Category:Versions]]
[[Category:Templates]]

</noinclude>

Addon:FamilyTreeView

2026-01-28T02:15:13Z

CallMeDave: /* Issues */ review

{{Third-party addon}}
{{Unreleased addon}}
{{man warn|You may install the addon manually if you are interested in helping to test and report issues.}}
{{man tip|This is a placeholder page|The {{man label|FamilyTreeView}} addon is [https://github.com/ztlxltl/FamilyTreeView/issues currently in development]. Installation instructions [https://github.com/ztlxltl/FamilyTreeView available on GitHub] for manual installation and beta testing.

* [https://gramps.discourse.group/t/new-familytreeview-addon-thread-2/7014/253 Once no more major changes are planned, draft documentation will be created] ztlxltl (developer of this addon) 2026/01/16
}}

[[File:FamilyTreeView-addon-example-60.png|450px|thumb|right|"FamilyTreeView" - addon - In action showing both ancestors and descendant trees]]
'''{{man label|FamilyTreeView}}''' is an interactive {{icon|ance}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]]}} category view addon that presents a navigable ancestors and descendant tree using the current active person as a starting point. Clicking another person in the family tree will make that person the active person and will redraw the family tree based on them.

== Issues ==
Report issues directly to https://github.com/ztlxltl/FamilyTreeView/issues

Discussion about the addon:
* [https://gramps.discourse.group/t/new-familytreeview-addon-thread-2/7014 New FamilyTreeView Addon](Thread 2), ztlxltl 2025-02-16 (Current discussion)
* [https://gramps.discourse.group/t/new-familytreeview-addon/6641 New FamilyTreeView Addon], ztlxltl 2024-12-24 (Initial announcement and discussion (332 messages))

===Review===
* [https://genealogysoftware.net/cross-platform/spotlight-gramps-add-on-familytreeview/ Spotlight: Gramps Add-on FamilyTreeView] December 24, 2024 by ChadO, GenealogySoftware.net


[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]

Gramps 6.0 Wiki Manual - Tools

2026-01-16T01:48:22Z

CallMeDave: /* Remove Unused Objects */

{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Tools}}
{{#vardefine:chapter|14}}
{{#vardefine:figure|0}}
[[File:MenuOverview-Tools-default-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}
"{{man menu|Tools >...}}" Menubar - Tools Overview - default]]
This chapter describes the various {{man label|Tools}} available in Gramps.

Gramps {{man label|Tools}} allow you to perform various types of analysis of your genealogical data. Typically, the tools do not produce output in form of printouts or files. Instead, they produce screen output immediately available for the researcher. However, when appropriate, you can save the results of running a tool into a file.

== Tools ==

[[File:ToolbarIcon-OpenTheToolsDialog-60.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Toolbar Icon for "Open the tools dialog"]]

The tools can be accessed by choosing the menu {{man menu|Tools ->''Tool Section'' ->''Particular Tool''}} .

Alternatively, you can browse the complete selection of available tools along with their brief descriptions in a {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Tool_Selection_dialog|Tool Selection]]}} dialog invoked by clicking the {{man button|Open the tools dialog}} icon on the toolbar from any of the categories.
{{-}}
{{man note|Additional Tools |Gramps allows you to install even more tools. This system is controlled by the [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|'''Plugin Manager''']]. For additional tools see [[6.0 Addons|'''Addons''']].}}

=== Tool Selection dialog ===

[[File:ToolSelection-dialog-with-debug-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - default information (and "Debug" tools selection)]]

[[File:ToolSelection-dialog-example-with-debug-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - example showing "Check and Repair Database" information (and "Debug" tools selection)]]



The {{man label|Tool Selection}} dialog allows you to browse the complete selection of available tools along with their brief descriptions when invoked by clicking the [[File:Gramps-tools.png|28px]] {{man button|Open the tools dialog}} icon on the toolbar from any of the categories and use the {{man button|▶}} arrows to expand the listings.

'''Select a tool from those available on the left'''. Use the {{man button|▶}} arrows to expand the top level listings:
* [[#Analysis_and_Exploration|Analysis and Exploration]]
* [[#Debug|Debug]]
* [[#Family_Tree_Processing|Family Tree Processing]]
* [[#Family_Tree_Repair|Family Tree Repair]]
* [[#Utilities|Utilities]]

Then select the tool you are interested in to be shown on the right hand side the following:
* Tool name
* Tool description
* Status:
* Author:
* Author's email:

You can can then use the buttons below to either find out more about the tool or open and run your tool.

* {{man button|Wiki}} opens the help page if available - needs an internet connection {{new|6.0.0}}
* {{man button|Close}} exits this dialog
* {{man button|Run}} - {{man tooltip|Run selected tool}} - opens the tools configuration page.
{{-}}
See also: [[Gramps_6.0_Wiki_Manual_-_Reports#Report_Selection_dialog|Report Selection dialog]]


=== Analysis and Exploration ===

This section contains tools which analyze and explore the database, but do not alter it. The following analysis and exploration tools are currently available in Gramps:

====Compare Individual Events====
[[File:CompareIndividualEvents-EventComparisonFilterSelection-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event comparison filter selection" - dialog]]

This tool collates all the event types discovered in a group of people. Arguably, it could be considered to be more a Report than a Tool. It generates a summary comparison table that begins with the Name and ID of each person, then adds columns for the Event types and dates. If there are multiples of the same event type, additional rows are created. The collation ignores the Roles but includes custom Event types.

The resulting table is useful for comparing of suspected duplicates and revealing inconsistencies. The table can become quite wide so the Save As (in the .ods format) will allow analysis in a spreadsheet application.

You can use this tool via menu {{man menu|Tools->Analysis and Exploration > Compare Individual Events...}} which will open the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Event_comparison_filter_selection_dialog|Event comparison filter selection]]}} dialog

=====Event comparison filter selection dialog=====

The people for this comparison can be chosen from previously created custom filters by selecting the {{man label|Filter:}} drop down list, which defaults to the ''Entire Database''. Or by selecting the {{man button|Custom Filter Editor}} button, to create custom filters in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Filters#.3Ccategory.3E_Filters_editor_dialog|Person Filters]]}} editor. To run the report select {{man button|Apply}} and the results will be displayed in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Event_Comparison_Results_dialog|Event Comparison Results]]}} dialog.

{{-}}

=====Event Comparison Results dialog=====
From the {{man label|Event Comparison Results}} dialog you can view the results or {{man button|Save As}} the resulting table as a spreadsheet (ODS format). Select {{man button|Close}} to exit the report.
{{-}}
[[File:CompareIndividualEvents-EventComparisonResults-dialog-expanded-example-60.png|center|thumb|800px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event Comparison Results" - dialog - expanded example]]

The spreadsheet (ODS format) shows the following output fields:
* <code>Person, ID, Birth Date, Birth Place, Death Date, Death Place, LVG Date, LVG Place, Burial Date, Burial Place, Marriage Date, Marriage Place</code> 

{{-}}

===Family Tree Processing===

This section contains tools which may modify your database. The tools from this section are used mostly for finding and correcting errors in the data. The following Family Tree Processing tools are currently available in Gramps:

* [[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Extract_Event_Description|Extract Event Description]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Extract_Information_from_Names|Extract Information from Names]]
* [[Addon:Extract_Place_Data_from_a_Place_Title|Extract Place Data from a Place Title]] - '''This tool was moved to [[Third-party_Addons|Third-party addons]]'''
* [[Gramps_6.0_Wiki_Manual_-_Tools#Find_Possible_Duplicate_People|Find Possible Duplicate People]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Fix_Capitalization_of_Family_Names|Fix Capitalization of Family Names]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Merge_citations|Merge citations]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rename_Event_Types|Rename Event Types]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Sort_Events|Sort Events]]

{{man note|Family Tree Processing tools will only perform modifications upon your explicit consent|Except for the automatic fixes performed by {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair Database]]}} tool in the '''Family Tree Repair''' menu.}}

====Edit Database Owner Information====

[[File:DatabaseOwnerEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Database Owner Editor" - dialog - default]]

The {{man label|Edit Database Owner Information}} tool modifies any existing [[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher Information]].

Select the menu {{man menu|Tools->Family Tree Processing->Edit Database Owner Information...}}. This brings up the {{man label|Database Owner Editor}} window, where you can fill in the needed information or use one of the buttons to retrieve existing information.

*{{man label|Name:}}
*{{man label|Street:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

This information is family tree specific and will be used when exporting your data in GEDCOM format.

Two button choices are available:
* {{man button|Copy from DB to Preferences}} - to the '''Researcher''' section.
* {{man button|Copy from Preferences to DB}} - from the '''Researcher''' section.

{{new|6.0 - [https://github.com/gramps-project/gramps/pull/1660 Use regular buttons to copy owner information from/to preferences]}}
{{-}}

====Extract Event Description====

{{man note|The name format in the Event's Description field depends on|the defined name format in {{man menu|Edit->Preferences->Data> Display Options (section) ->}}{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Name format:]]}} }}



Extracts event descriptions from the event data by using a model :

<code>{event type} of {Surname}, {Given name}</code>

If event description is missing, then tool will use this event description field model.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Event Description...}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

Once you {{man button|Proceed with the tool}} this tool will scan and modify your Family Tree and if not present show you the {{man label|No modifications made}} alert otherwise if present you with the:

=====Modifications made result window=====
[[File:ExtractEventDescription-ModificationsMade-window-example-60.png|right|thumb|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Extract Event Description's - "Modifications Made" - window - example result]]

{{man label|Modifications made}} result window listing the total number of event descriptions that have been added.
{{-}}

====Extract Information from Names====

This tool searches the entire database and attempts to extract titles and nicknames that may be embedded in a person's {{man label|Given name}} field. If any information could be extracted, the candidates for fixing will be presented in the table. You may then decide which to repair as suggested and which not to.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Information from Names....}}

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Default_prefix_and_connector_settings_dialog|Default prefix and connector settings]]}} dialog will be shown and you can modify each of the options as required and once you have finished select {{man button|OK}} to start the tool.
{{-}}

Once the tool finishes either the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#No_modifications_made_dialog|No modifications made]]}} dialog will be shown as ''No titles, nicknames or prefixes were found'' or the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Name_and_title_extraction_tool_window|Name and title extraction tool]]}} window will be shown with results of the search.
{{-}}

=====Default prefix and connector settings dialog=====
[[File:ExtractInformationFromNames-DefaultPrefixAndConnectorSettings-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Default prefix and connector settings" - dialog for the "Extract Information from Names" Tool]]

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Default_prefix_and_connector_settings_dialog|Default prefix and connector settings]]}} dialog you can modify each of the options as required:
* {{man label|Prefixes to search for:}} <code>de, van, von, di, le, du, dela, della, des, vande, ten, da, af, den, das, dello, del, en, ein, elet, les, lo, los, un, um, una, uno, der, ter, te, die</code> (default)
* {{man label|Connectors splitting surnames:}} <code>e, y</code> (default)
* {{man label|Connectors not splitting surnames:}} <code>de, van</code> (default)
{{-}}

=====No modifications made dialog=====
[[File:ExtractInformationFromNames-NoModificationsMade-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "No modifications made" - dialog for the "Extract Information from Names" Tool]]

Shown when ''No titles, nicknames or prefixes were found'' in the selected family tree.

Select {{man button|Close}} to dismiss the dialog.

{{-}}

=====Name and title extraction tool window=====
The top section shows information about the tool.
{{man note|Below is a list of the nicknames, titles, prefixes and compound surnames that Gramps can extract from the Family Tree.
If you accept the changes, Gramps will modify the entries that have been selected.

Compound surnames are shown as lists of [prefix, surname, connector].

For example, with the defaults, the name "de Mascarenhas da Silva e Lencastre" shows as:

[de, Mascarenhas]-[da, Silva, e]-[,Lencastre]

Run this tool several times to correct names that have multiple information that can be extracted.}}

[[File:ExtractInformationFromNames-NameAndTitleExtractionTool-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Name and title extraction tool" - dialog results window for the "Extract Information from Names" Tool]]

The bottom section displays the results list in a table with the following columns: <code>Select</code>, <code>ID</code>, <code>Type</code>, <code>Value</code>, <code>Current Name</code>

You can un-<code>Select</code> the results you don't want and then {{man button|Accept and close}} to apply those results to your family tree or {{man button|Cancel}} to do nothing. The {{man button|Help}} button brings you to this tools help section.
{{-}}

====Extract Place Data from a Place Title====

{{man warn|This tool was moved to [[Third-party_Addons|Third-party addons]].|When the Place Hierarchy was first added to Gramps, every user needed a tool to [[Addon:Extract Place Data from a Place Title]]. Now that that a Hierarchy of Places is well established, the tool is needed infrequently. So installation has been made optional.}}

====Find Possible Duplicate People====

[[File:FindPossibleDuplicatePeople-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find Possible Duplicate People - dialog - default]]

The '''Find Possible Duplicate People''' tool searches the entire Tree database, looking for the entries that may represent the same person.

You can access this tool via the menu {{man menu|Tool -> Family Tree Processing -> Find Possible Duplicate People...}}.

The {{man label|Find Possible Duplicate People}} dialog will be shown and you can adjust the following options:
*{{man label|Match Threshold}} : choose between '''Low''' (default), ''Medium'' and ''High'' from the drop down menu.
{{man note|How is the quality of match measured?|2=This calculates the chances (or 'odds') of matching on a quality scale labeled as low, medium and high. For each piece of information that corresponds, the quality of the match is considered to be marginally increased. The closer the particular pieces of data correlate, the larger the increase. When the chance is greater than the selected '''Match Threshold''' then a match will reported. The thresholds are Low=0.25, Medium=1.0 and High=2.0. So, with the filtering threshold set to High, fewer matches are expected.}}

{{man label|Options}}
*{{checkbox|1}} {{man label|Use [[Gramps_6.0_Wiki_Manual_-_Gramplets#SoundEx_Gramplet|soundex]] codes}} for matching possible duplicate people. (checkbox checked by default)

The following buttons are present: {{man button|Help}} brings you to this page, {{man button|Cancel}} to stop processing and an {{man button|OK}} button to start processing the data.

Select {{man button|OK}} to start the tool and the data will be processed in two passes.

*Pass 1: Building preliminary lists
*Pass 2: Calculating potential matches.

A progress bar will be shown and depending the speed of your computer and the amount of people in the database this can take some time.

{{-}}

=====Potential Merges=====
[[File:FindPossibleDuplicatePeople-PotentialMerges-result-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Potential Merges" result dialog window for "Find Possible Duplicate People" - dialog - example]]

Once the report finishes a {{man label|Potential Merges}} result list window is presented with the following columns shown:
*<code>Rating</code> : this gives you an idea of the resemblance between the two people. The higher the ranking, the higher the chance that the people are duplicates.
*<code>First Person</code>
*<code>Second Person</code>

You can either double-click on the selected row or select the {{man button|Compare}} button to check the details.

Three buttons are present: {{man button|Help}} brings you to this page, a {{man button|Close}} to close the window which returns you to the {{man label|Find Possible Duplicate People}} window and a {{man button|Compare}} button to which brings up the {{man label|Merge People}} window which was explained in detail in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_People|Merge People]]}} dialog. Here you can select with the radio buttons one of the persons and eventually use the {{man button|OK}} button to merge the data if you find the two persons are duplicates.

Selecting the {{man button|Cancel}} button brings you back to the {{man label|Potential Merges}} result list window.
{{-}}

====Fix Capitalization of Family Names====

This tool searches the entire database and attempts to fix the capitalization of family names.

The aim is to have conventional capitalization: capital first letter and lower case for the rest of the family name. If deviations from this rule are detected, the candidates for fixing will be presented in the table.

You may then decide which to repair as suggested and which not to.

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Fix Capitalization of Family Names...}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{-}}
[[File:FixCapitalizationofFamilyNames-CapitalizationChanges-dialog-results-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Capitalization changes" - dialog - results example for "Fix Capitalization of Family Names" tool]]

If there where changes to the capitalization of any names you will be presented with the {{man label|Capitalization changes}} results window. The window shows a list of the family names that Gramps can convert to (according to Gramps) correct capitalization (please check that it is correct for you.). In the {{man label|Capitalization changes}} results window list the following columns are available:
*{{checkbox|1}} {{man label|Select}} - Check or uncheck these on a "by name" basis if you choose not to accept the recommendation (checkbox checked by default)
* {{man label|Original Name}} - The name as currently recorded.
* {{man label|Capitalization Change}} - The name with change if applied.

Select the names you want to be changed, then select the {{man button|Accept changes and close}} button. Or use the {{man button|Cancel}} button to abort changes.
{{-}}

You can also install the "[[Addon:Fix Capitalization of Given Names]]" tool Addon that once installed works almost identically to this tool but works for "Given Names"
{{-}}

====Merge citations====

{{man tip|The {{man label|Merge Citations}} tool|works by combining notes, media objects and data-items of matching citations.}}

You can select this via menu {{man menu|Tools > Family Tree Processing > Merge Citations...}} .

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.
{{-}}
[[File:MergeCitations-dialog-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Merge Citations" - dialog - default]]

Then the {{man label|Merge Citations}} dialog (Title of dialog shows:''Notes, media objects and data-items of matching citations will be combined.'')will be shown

The following options are available:
* {{man label|Match Threshold}} drop down list:
** Match on Page/Volume, Date and Confidence
** '''Ignore Date''' (default)
** Ignore Confidence
** Ignore Date and Confidence
* {{man label|Options}}
** {{checkbox|0}} {{man label|Don't merge if citation has notes}} (checkbox unchecked by default)

{{-}}
[[File:NumberOfMergesDone-dialog-result-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Number of merges done" result dialog for "Merge Citations" - dialog - Tool - example]]

Select {{man button|OK}} to run the tool and once complete it will report back the total with the {{man label|Number of merges done}} result dialog.
{{-}}
See also the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Citations|Merge Citations]] option available from the Citations Category list view
{{-}}

====Rename Event Types====

This tool will rename all events of one type to a different type.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Rename Event Types....}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}

{{-}}
[[File:RenameEventTypes-Tool-ChangeEventTypes-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Change Event Types" - dialog - example for "Rename Event Types" Tool]]

The {{man label|Change Event Types}} dialog is presented.

* {{man label|Original event type}}: fill in the text field or use the drop down menu and select an original event type
* {{man label|New event type}}: fill in the text field (you can create a complete new type here) or use the drop down menu and select a new type

The example shows a renaming of the '''Birth''' event to a '''Baptism''' event.

{{man note|Custom types|While the custom types do not show in the drop down list, you can over type or paste into either of the selection boxes and convert from one to another.}}

{{-}}
[[File:RenameEventTypes-Tool-ChangeTypes-result-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Change types" - result dialog - example for "Rename Event Types" Tool]]

Finally use the {{man button|Cancel}} to exit or select {{man button|OK}} to run the tool and once complete it will report back the total events modified with the {{man label|Change types}} result dialog.
{{-}}

{{man warn|1=Renaming events|2=Once completed, this cannot be undone by the regular {{man label|Undo}} function.}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Editing information about events]]


====Reorder Gramps IDs====

This tool can be used to reorder your Gramps object IDs.

[[File:ReorderGrampsIDs-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" tool window - example]]

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Reorder Gramps IDs...}}.

Initialy the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}}''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

Then the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_tool_window|Reorder Gramps IDs]]}} tool window will be shown where you can modify the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_tool_window|column options]] as needed then select {{man button|OK}} to start the process.

The tool will then show various progress dialogs during the different progress stages; as the following object IDs' are reordered: 'Reordering People IDs', 'Reordering Family IDs', 'Reordering Event IDs', 'Reordering Place IDs', 'Reordering Source IDs', 'Reordering Citation IDs', 'Reordering Repository IDs', 'Reordering Media Object IDs' and finally 'Reordering Note IDs'.

In the final step 'unused IDs' are searched for and assigned.

During this process the tool will examine each ID to see if it looks like it has been 'customized', if it doesn't look like the previous object ID format or the default object ID format. This might be the case if the user has manually entered their own text in the ID field for the object when editing it. It might also occur if the third-party [[Addon:GeoName|GeoName Addon]] has been used or the [[Addon:GetGOV|GetGOV Addon]] that stores the '''GOV ID''' in the Place ID field. If a ''customized'' ID is found, the tool will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_replace_dialog|Reorder Gramps IDs]]}} replace dialog that ask the user if they really wants to replace the ID and also optionally allows the user to use the same answer for same found customized object IDs.

{{man warn|Custom IDs'|If you customized your object IDs', all those can be replaced by this tool. So take care by backing up before you use this tool!}}

=====Reorder Gramps IDs tool window=====
[[File:ReorderGrampsIDs-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" tool window - default on new empty family tree]]

The {{man label|Reorder Gramps IDs}} tool window shows each of Gramps objects (Person, Family, Event, Place, Source, Citation, Repository, Media, Note) and the following option columns (<code>Object</code>, '<code>Actual</code>, <code>Quantity</code>, <code>Format</code>, <code>Change</code>, <code>Start</code>, <code>Stop</code>, <code>Keep</code>) that can be applied to changing the object ID's.

The {{man button|Help}} button will show this section. The {{man button|Cancel}} button will exit the tool. The {{man button|Ok}} start the tool.

Most of the column labels also double as hidden toggles buttons and perform various actions as described below.

;<code>Object</code>:This column lists the type of Gramps ID. Immediately to the left of this column are checkboxes that allow the enabling of changes to individual object types. When checked, the type can be reordered. The {{man button|Object}} label is actually a hidden button that can be used to toggle all of the checkboxes at once.

;<code>Actual</code>:This column shows an example of the current objects ID.

;<code>Quantity</code>:This column show the current number of objects in the family tree.

;<code>Format</code>:This column can be used to change the ID format for each object type. Note that the default ID formats consists of a one letter prefix (I, F, E, P, S, C, R, O, N) representing each of the objects, and then a suffix '<code>%04d</code>'. There '''MUST''' be at least a prefix or a suffix, both are allowed. It is recommended to keep these relatively short. The '<code>%04d</code>' defines the length of the numeric portion of the ID, the '<code>4</code>' can be changed, anything from '<code>3</code>' (allowing numbers from 000-999) to '<code>9</code>' (000000000-999999999) is allowed (''If your family tree needs more than "nine hundred ninety-nine million, nine hundred ninety-nine thousand, nine hundred ninety-nine" please raise a feature request!''). Changes made here are the same as made in the menu {{man menu|Edit->Preferences...}} and then select the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}''' tab. The '{{man button|Format}}' label is actually a hidden button that can be used to ''reset'' all the formats to the last used value.

;<code>Change</code>:This column contains checkboxes for each object type. When checked, the IDs for that object will be replaced with new IDs of the <code>Format</code> style, unless <code>Keep</code> is also checked. If there is no checkmark, the ID formats are ''NOT'' updated, but the number field within the format is renumbered. The {{man button|Change}} label is actually a hidden button that can be used to toggle all of the check boxes at once.

;<code>Start</code>:This field indicates the starting number used during the renumber operation. The {{man button|Start}} label is actually a hidden button that can be used to toggle between start at <code>0</code>, and start after last current number.

;<code>Step</code>:This field indicates the interval between numbers during the renumber, <code>1</code> is a simple increment, <code>2</code> will increment by 2 etc. The {{man button|Step}} label is actually a hidden button that can be used to toggle between <code>1</code>, <code>2</code>, <code>5</code>, and <code>10</code>.

;<code>Keep</code>:This column contains check boxes for each object type. If both the <code>Keep</code> and <code>Change</code> check boxes are checked, the ID formats for that object will be retained, and the number field within the format is renumbered. The {{man button|Keep}} label is actually a hidden button that can be used to toggle all of the check boxes at once.

=====Reorder Gramps IDs replace dialog=====
[[File:ReorderGrampsIDs-replace-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" replace dialog - example]]

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_dialog|Reorder Gramps IDs]]}} replace dialog that ask the user if they really wants to replace the ID and also optionally allows the user to use the same answer for same found customized object IDs.

* {{man label|[ ] Use this answer for the rest of the items}}

Select {{man button|Yes}} or {{man button|No}}.
{{-}}

====Sort Events====

Events appearing on the Event tab on a ''Person'' or ''Family Editor'' are not sorted in any particular order other than the order that the events were added. The reason for not enforcing any particular ordering, particularly ordering by date, is to allow for the situation where an event was known to have happened but the exact chronology is not. Importing or merging data from an external source can lead to extra events being added to, but out of sequence with, the existing set of events of a person or family.

Events can be manually re-ordered by [http://en.wikipedia.org/wiki/Drag-and-drop ''drag & drop''] or by use of the re-order buttons on the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Events]]}} tab. Either way, an event can be moved up or down in the list of events and Gramps will remember the new order when the changes are saved. The new ordering will be used wherever events are shown elsewhere in Gramps, such as on a report.

The order of all events on a tab can also be changed by clicking a column title. For example, clicking the <code>Date</code> column header will sort all the events in date order. However this way of sorting events is temporary and changes to the event order are not preserved when the window is closed.

The [http://en.wikipedia.org/wiki/Drag-and-drop ''drag and drop''] approach to sorting events is fine for moving a small number of events but is not practical for large scale changes. The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Sort_Events_tool|Sort Events tool]]}} has been designed specifically for this purpose, re-sorting all events in the database or just those associated with a targeted selection of people chosen by using a filter.

=====Sort Events tool=====

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Sort events...}}.

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}

{{-}}
======Tool Options tab ======
[[File:SortEvents-dialog-ToolOptions-tab-default-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Sort Events" Tool - dialog - showing "Tool Options" tab]]

On the {{man label|Tool Options}} tab for the {{man label|Sort Events}} dialog window the first option is used to define the range of people who's events are to be sorted. The first choice in the list is to apply the sorting to all people in the database. Alternative choices are to apply sorting to ancestors and descendants of a chosen person or to a range of people selected by a custom built person filter. After choosing who the sort should apply to, the next thing to consider is how the events should be sorted. The first option is to sort by date. This is probably the most likely choice, but other event attributes can be chosen too. The final choices are whether to make the events sorted ascending or descending and whether to apply the sort to family events that the selected people belong to as well.

{{stub}}

{{-}}
{{man warn|1=Sorting events|2=Once completed, this cannot be undone by the regular {{man label|Undo}} function.}}

=== Family Tree Repair ===

The following Family Tree Repair tools are available:

* [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Gender_Statistics|Rebuild Gender Statistics]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Reference_Maps|Rebuild Reference Maps]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Secondary_Indexes|Rebuild Secondary Indexes]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Remove_Unused_Objects|Remove Unused Objects]]



====Check and Repair Database====

{{man warn|Warning: The {{man label|Check and repair Database}} tool performs automatic fixes.|Once completed, this cannot be undone by the regular {{man label|[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_Undo_History|Undo History]]}} function.}}

The {{man label|Check and repair Database}} tool checks the selected database/Family Tree for integrity problems, fixing the problems it can. Specifically, the tool is checking for:

*Broken family links. These are the cases when a person's record refers to a family while the family's record does not refer to that person, and vice versa.

*Missing media objects. The missing media object is the object whose file is referenced in the database but does not exist. This can happen when the file is accidentally deleted, renamed, or moved to another location.

*Empty families. These are the family entries which have no reference to any person as their member.

*Parent relationship. This checks all families to ensure that father and mother are not mixed up. The check is also made that parents have different gender. If they have common gender then their relationship is renamed to "Partners".

You can use this tool via menu {{man menu|Tools->Family Tree Repair->Check and Repair Database...}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{-}}
=====Integrity Check Results dialog=====
[[File:IntegrityCheckResults-dialog-CheckAndRepairDatabase-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Integrity Check Results" - example result dialog - for the "Check and Repair Database" tool]]

Any issues found are automatically fixed and the {{man label|Integrity Check Results}} dialog will be shown with a summary actions taken.
{{-}}
=====No errors were found dialog=====
Otherwise you will see the {{man label|No errors were found}} dialog stating that ''The database has passed internal checks''.
{{-}}
=====Gramps had a problem the last time it was run - dialog=====
[[File:GrampsHadAProblemTheLastTimeItWasRun-dialog-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps had a problem the last time it was run - dialog ]]

After Gramps crashes [https://github.com/gramps-project/gramps/pull/778 on restart, Gramps will offer to run Check & Repair] tool. (Introduced in Gramps 5.1.x)

{{-}}

====Rebuild Gender Statistics====

[[File:GenderStatisticsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender statistics rebuilt" - result dialog for "Rebuild Gender Statistics" tool]]

Rebuilds gender statistics for name gender guessing based on the accumulated statistics of genders for given names within the tree. If a gender is common to more than half the in the Tree with a particular first word in their Given name, then Gramps will guess that Gender for that name will be the same.

The statistics can also be cleared (if the {{man menu|Tools ➡ [[Gramps_6.0_Wiki_Manual_-_Tools#Debug|Debug]]}} menu has been enabled) with the [[Gramps_6.0_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics]] Tool.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Gender Statistics...}}.

Once completed the {{man label|Gender statistics rebuilt}} result dialog will be shown.

{{man warn|Rebuild Gender Statistics needed after converting database|Issue {{bug|11314}} notes that gender statistics are swapped after database conversion to SQLite. If your gender guessing is suggesting the opposite gender for particular given names, use the Rebuilt Gender Statistics tool to fix the guessing.}}

See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.

{{-}}

====Rebuild Reference Maps====

[[File:ReferenceMapsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reference maps rebuilt" - result dialog for "Rebuild Reference Maps" tool]]

This tool rebuilds reference map tables. This drives the list of ''References'' items in editors.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Reference Maps...}}.

Once completed the {{man label|Reference maps rebuilt}} result dialog will be shown.
=====See also=====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}

====Rebuild Secondary Indexes====

[[File:SecondaryIndexesRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Secondary indexes rebuilt" - result dialog for "Rebuild Secondary Indexes" tool]]

This tool rebuilds secondary indices.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Secondary Indexes...}}.

Once completed the {{man label|Secondary indexes rebuilt}} result dialog will be shown.

The {{man menu|Rebuild Secondary indexes...}} re-constructs the secondary tables in the Tree db. These tables include things like gender statistics (Given Name versus gender) to allow guessing the gender of names as they are entered, surnames (for faster lookup of possible surname and to make the person tree view work), the various IDs for objects (to facilitate lookup by ID), place enclosure tables, to make the place tree view work, and a few others.

In theory, these tables are kept constantly up-to-date when anything changes. So rebuilding the Reference Maps and Secondary Indices should not be necessary. But, especially early on in the Gramps history, bugs sometimes interfered with updates completing correctly. So the tools remain available... ‘just in case’.
=====See also=====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}

====Remove Unused Objects====

This tool will search your database for pieces of information which are not connected to anything else, and then allow you to edit and attach the information or remove them.

You can use this tool via menu {{man menu|Tools->Family Tree Repair->Remove Unused Objects...}}.

{{-}}
[[File:UnusedObjects-dialog-example-results-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Unused Objects" - dialog example results for "Remove Unused Objects" tool]]

The {{man label|Unused Objects}} dialog is presented.

You can choose from the search option you want to use from the top section of the {{man label|Unused Objects}} dialog:
*{{checkbox|1}} {{man label|Search for events}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for sources}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for citations}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for places}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for media}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for repositories}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for notes}} (checkbox checked by default)

Select the {{man button|Find}} button to run the tool, and once completed the results if any will show in the bottom section of the {{man label|Unused Objects}} dialog with the following columns shown:
* {{man label|Mark}} Select the row if you want to delete the object (unchecked by default)
* {{man label|}} - Icon representing the type of object.
* {{man label|ID}} - Gramps internal name for the object.
* {{man label|Name}} - of the object.

To examine the object you must double-click on the row and it will show the appropriate editor for the object allowing you to edit if required.

{{man label|Mark}} the objects you want to delete either using the individual checkboxes or using the associated buttons:
* {{man button|Mark all}}
* {{man button|Unmark all}}
* {{man button|Invert marks}}

Once your deletion choices have been made select the {{man button|Delete}} button to delete the objects.

When finished you may then use the {{man button|Close}} button to exit the tool.
{{-}}
{{man note|Multiple runs of the Remove Unused Objects tool maybe needed in order to actually clean the database.|See: Feature Requests {{bug|3249}} "Remove Unused Objects" tool is misleading as Multiple runs of the tool are needed.
}}

=== Utilities ===

This section contains tools allowing you to perform a simple operation on a portion of data. The results can be saved in your database, but they will not modify your existing data. The following utilities are currently available in Gramps:
* [[Gramps_6.0_Wiki_Manual_-_Tools#Clean_input_data|Clean input data]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Find_database_loop|Find database loop]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|Media Manager]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Not_Related|Not Related]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Verify_the_Data|Verify the Data]]

====Clean input data====

====Remove leading and trailing spaces====

[[File:CleanInputData-dialog-tool-example-dialog-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clean input data]]
Tool to clean leading and trailing spaces from imported or old data. The tool searches for place names with leading or/and trailing spaces. It also looks in the first name and surname.

Leading and trailing spaces are automatically removed during name data being committed to the tree.

The tool can be triggered from the menu {{man menu|Tools > Utilities > Clean input data...}} or Tools selector dialog

See also:
* Avoid invalid characters and leading or trailing spaces in the entry field - (added in Gramps [[Template:Releases/5.0.2|5.0.2]] with [https://github.com/gramps-project/gramps/pull/811 PR811])
* [https://github.com/gramps-project/gramps/pull/783 New tool to suppress leading and trailing spaces.] - (added in Gramps [[Template:Releases/5.1.0|5.1.0]])
* Feature request {{bug|4566}} : Please remove trailing spaces on items on input (2016)
* Feature request {{bug|4619}} : Trailing blanks are removed from queries in the preset filters (2011)

{{-}}

====Find database loop====

[[File:FindDatabaseLoop-example-PedigreeChartView-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree chart showing loop - example]]

The {{man label|Find database loop}} utility allows you to verify if you have ancestral loops in the database. Loops in your family tree may for example show a person as both the child and ancestor of another person in Family Tree. Loops can happen accidentally during data entry, for example, when a son is linked into the family tree as his own grandfather!

Other valid loops also happen and should be kept in the family tree if verified:
* An inbreeding loop because the parents are related.
* A mating loop caused by a male who has children to genetically related females.
* An incest mating loop caused by full siblings.
{{-}}
[[File:FindDatabaseLoop-dialog-example-results-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find database loop - dialog - results from example family tree case]]

Use the menu {{man menu|Tools->Utilities->Find database loop...}} and you will get a {{man label|Find database loop}} window that will display the results in a list with six columns: <code> </code> ''Loop Group unlabeled'' (<code>Gramps ID</code>, <code>Parent</code>), (<code>Gramps ID</code>, <code>Child</code>), <code>Family ID</code>.

* Loop Group unlabeled column - a number related to which loop the entries are about.
* First <code>Gramps ID</code> is a reference to the Parent.
* <code>Parent</code> (Ancestor on the image) is the person we are looking for a loop.
* Second <code>Gramps ID</code> is a reference to the Child.
* <code>Child</code> (Descendant) is the origin of the loop.
* <code>Family ID</code> is a reference to the associated family

Double clicking on a selection will open the related [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Families entry]].

To fix a pedigree loop in your family tree.
* Locate the person page of the individual whose relationship needs to be adjusted.
* First, verify that a name or vital event date was not accidentally entered incorrectly.
* If you are sure that deleting the incorrect parent-child relationship will fix the loop, proceed with the steps.

Once you have resolved any loops select {{man button|Close}} to exit.

{{-}}
To read more about ancestral loops see:
* [https://www.tamurajones.net/FindingAncestralLoops.xhtml Finding Ancestral Loops : Modern Software Experience]
* [http://www.beholdgenealogy.com/blog/?p=1309 Ancestral Loops : Louis Kessler's Behold Blog]

Also see:
* [https://wikipedia.org/wiki/Endogamy Endogamy] - From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Cousin_marriage Cousin marriage] - From Wikipedia, the free encyclopedia

=====Example ancestral loops=====

{{stub}}

[[File:FindDatabaseLoop-dialog-complex-example-results-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} chart showing complex example]]

In the following complex example, we have multiple ancestral loops indicated by the number in the first unlabeled column a "Loop Group" :

If we look at the second line, we have :
# First Gramps_ID : I0002
# Parent is : Father, Child2
# Second Gramps_ID : I0001
# Child is : Father, Father
# Family_ID is : F0000

{{-}}
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|600px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]

To understand what happens :
#we start at [I0002] Father, Child2.
#We continue with his son [I0003] Father, Child3.
#We continue with his son : [I0000] Child, Child.
#We continue with his son : [I0001] Father, Father.
#We continue with his son : [I0002] Father, Child2 ==> '''HERE, we have a ancestral loop'''.

{{-}}

====Media Manager====

{{stub}}

The {{man label|Gramps Media Manager}} is a group of four separate tools accessed via a wizard like dialog that you can access via the menu {{man menu|Tools->Utilities->Media Manager...}} which will show the first '''[[Gramps_6.0_Wiki_Manual_-_Tools#|Introduction]]''' dialog page.

=====Introduction=====

[[File:Introduction-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Introduction - page for "Gramps Media Manager" - Tool wizard]]

A brief information on the tools abilities is shown.

From the '''Introduction''' page selecting the {{man button|Next}} button (or using the keyboard shortcut {{man key press|Alt|N}}) you will be shown the '''[[Gramps_6.0_Wiki_Manual_-_Tools#Selection|Selection]]''' page window.

{{man note|Introduction|This tool allows [http://wikipedia.org/wiki/Batch_processing batch operations] on media objects stored in Gramps. An important distinction must be made between a Gramps media object and its file.

The Gramps media object is a collection of data about the media object file: its filename and/or path, its description, its ID, notes, source references, etc. These data '''do not include the file itself'''.

The files containing image, sound, video, etc. exist separately on your hard drive. These files are not managed by Gramps and are not included in the Gramps database. The Gramps database only stores the path and file names.

This tool allows you to only modify the records within your Gramps database. If you want to move or rename the files then you need to do it on your own, outside of Gramps. Then you can adjust the paths using this tool so that the media objects store the correct file locations.}}

{{-}}

=====Selection=====
[[File:Selection-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selection - page for "Gramps Media Manager" - Tool wizard - default]]

From the '''Selection''' page window select from one the four options the actions you want to take and then select the {{man button|Next}} button:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Replace_substrings_in_the_path|Replace substrings in the path]]}} (default)
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Add_images_not_included_in_database|Add images not included in database]]}}
{{-}}

=====Replace substrings in the path=====

[[File:ReplaceSubstringSettings-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Replace substring settings - page for "Gramps Media Manager" - Tool wizard - default]]

This tool allows replacing specified substring in the path of media objects with another substring. This can be useful when you move your media files from one directory to another.

Selecting this radio button will bring up a {{man label|Replace substring settings}} window where you can type in any string in the {{man label|Replace}} text field and the {{man label|With}} text field. At any time you can click on the {{man button|Cancel}} button or the {{man button|Back}} button. Clicking the {{man button|Forward}} button will bring up the {{man label|Final confirmation}} window.

{{-}}

=====Convert paths from relative to absolute=====
[[File:ConvertPathsFromRelativeToAbsolute-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from relative to absolute':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

This tool allows converting relative media paths to the absolute ones. It does this by prepending the {{man label|Base media path:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section, or if that is not set, it prepends the default [[Gramps_6.0_Wiki_Manual_-_User_Directory|User's Directory]].

* [https://wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}

=====Convert paths from absolute to relative=====
[[File:ConvertPathsFromAbsoluteToRelative-FinalConfirmation-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from absolute to relative':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

This tool allows converting absolute media paths to a relative path. The relative path is relative to the given base path in the setting {{man label|Base media path:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section, or if that is not set, the user's directory is used. A relative path connects the file location to the base media path that can be changed according to your needs.

* [https://en.wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}

=====Add images not included in database=====

[[File:AddImagesNotIncludedInDatabase-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Add images not included in database':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

Check directories for images not included in database, this tool adds images in directories that are referenced by existing images in the database. You will have to import one media item from each sub directory manually. Media Manager does not include sub-directories automatically. All the directory paths shown in the tool will be searched through.
{{-}}

====Not Related====

[[File:NotRelatedTo-dialog-NotRelated-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}. "Not related to '...'" - dialog - showing results for "Not Related" Tool]]

This tool will list people who are not connected to the selected active person. Connections may include linked in a chain of [[References|references]] or linkages created with the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Link_Editor|link editor in Notes]].

You can use this tool via menu {{man menu|Tools->Utilities->Not Related...}}.

You will get a {{man label|Not related to '...'}} results dialog which shows a list of all the people that are '''NOT''' related to the selected person.

This list gives you:
* ''Name''
* ''ID''
* ''Parents''
* ''Tags''

From the ''Name'' column you can use the {{man button|▶ right arrow}} button and {{man button|↓ down arrow}} buttons to collapse or expand the grouped ''Name'' list. Double clicking on a person will bring up the {{man label|person edit}} dialog or {{man label|family edit}} dialog.

If you select a person, you can use the {{man label|Tag}} text field (you can fill in whatever custom tag name you want to use) or use the drop down list to choose an existing tag eg TODO, NotRelated. Use the {{man button|Apply}} to add the selected tag to the person(s). This tag will then show up in the ''Tags'' column.
{{-}}

====Relationship Calculator====

[[File:RelationshipTo-dialog-RelationshipCalculator-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Relationship to '...' " - dialog - showing results for "Relationship Calculator" Tool]]
You can use this tool via menu {{man menu|Tools ➡ Utilities ▶ Relationship Calculator...}}.

Selecting the Relationship Calculator tool will open a list filtered to all people connected, '''but not necessarily related''', to the [[Gramps_Glossary#active_person|Active Person]]. To calculate relationship to different person, close the window, make that person Active and select the tool from the menu again.

Select the individual from the filtered list to report if a relationship exists. The exact relationship will be shown in the lower panel... along with the common ancestors in that relationship. Only blood relationships will display (except for husband-wife and step relationships). Note that "in-law" relationships are not displayed.

The filtered list will grouped and alphabetically sorted by surname. (Regardless of whether the View menu setting of the Person category has been set to '''Grouped'''.) The list columns cannot be re-sorted.

The degree of separation (generation distance) that will be recognized is controlled by the {{man label|Max generations for relationships}} value in the [[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]] tab under the {{man menu|Edit ➡ Preferences...}} menu. Moved from the [[Gramps_5.1_Wiki_Manual_-_Settings#General|5.1 General]] tab {{New|5.2}} (The default of 15 generations will report a 12th great-grandparent relationship but not the 13th great-grandparents. The active person is counted as one of the generations. So, self generation plus parent plus grandparents are the other 3 generations.)

Essentially, any two people are directly related by blood if they have an ancestor in common. One of these individuals may actually be an ancestor of the other - such as a great grandparent. Even in the cases of aunts and uncles, you still can calculate the relationship by searching for the common ancestor. In this case, the father or mother of the aunt or uncle will be a grandparent to the nephew or niece.

The most basic blood relationship through common ancestors is that of siblings (brothers and sisters) who are only one generation down from the common ancestor. Another special relationship is that of one of those siblings to the descendants of the other siblings. If the Active Person is a grandchild of the common ancestor, the sibling would be an aunt or uncle. Beyond that generation of descendants, there are two equivalent ways of describing the relationship. The daughter of great grandparents might be called either a grandaunt or a great aunt. (The Relationship Calculator uses the 'grand' variant.) That person is a great grandaunt to the second great grandchildren, who are four generations distant from the common ancestor. (She may also be called a second great aunt.) The reverse relationship of an aunt or uncle is a nephew or niece.

Cousins (also called "first" cousins) are two generations down from the common ancestor through different siblings. "Second" cousins are thus, three generations down from the common ancestor - and so on.

After that, everyone is considered a "cousin", but to indicate that they are not in the same generation we use the word "removed" to indicate the number of generations different between the two. For example, my father's "first" cousin is also my "first" cousin but "once removed" (one generation difference between us). My fathers "first" cousin is my own child's "first cousin twice removed" - two generations different.

If multiple blood relationships exist due to pedigree Collapse, all will be reported.

A full text list of all blood relations and their spouses can be viewed using a [[Gramps 6.0 Wiki Manual - Reports - part 6#Kinship Report|Kinship Report]].

=====See also:=====

* The '''Relationship to home person''' [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar
* '''Relation to Home Person''' [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].
* The '''[[Addon:Deep_Connections_Gramplet|Deep Connections]]''' gramplet: If this third party addon is installed, it will list the intervening generations through the sibling offspring of a common ancestor. (But it does not list the common ancestor or if both person a connected through the same spouse.) The Gramplet also details the indirect relationships.
* [[Specification:Relationship Calculator|Relationship Calculator Localization]] - create meaningful relation descriptions in your region.
{{-}}

====Verify the Data====
{{man tip|Verify the Data tool enhanced{{new|5.2}}|Tool performance improved, results reorganized into a Tree rather than a flat list, additional tests. 8 New rules ([[Gramps_6.0_Wiki_Manual_-_Tools#Data_Verification_Results_window|marked below]]) to find additional irregularities.
}}

[[File:VerifyTheData-DataVerifyTool-dialog-General-tab-defaults-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Verify the Data..." - "Data Verify tool" dialog - "General" tab - defaults]]

This utility allows you to verify the database based on the set of criteria specified by you.

For example, you may want to make sure that nobody in your database had children at the age of 98. Based on common sense, such a record would indicate an error. However, it is not a consistency error in the database. Besides, someone might have a child at the age of 98 (although this rarely happens). The Verify tool will display everything that violates your criteria so that you can check whether the record is erroneous or not. The ultimate decision is yours.

Select this via the menu {{man menu|Tools->Utilities->Verify the Data...}} you will get a {{man label|Data Verify Tool}} window. The window has four tabs; {{man label|General}}, {{man label|Women}}, {{man label|Men}}, {{man label|Families}}. Those tabs show a list with criteria and a input field where you can alter the criteria value. In the lists below I show some ''workable'' values.

=====Verify the Data tab pages=====

Select the criteria you want to run the tool with from the following tabs. If you are OK with the criteria click the {{man button|Run}} button (or hit the {{man key press|Alt|R}} keybinding) and you will be presented with a {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Data_Verification_Results_window|Data Verification Results]]}} window.

======General======
* {{man label|Maximum age}}: <code>90</code>
* {{man label|Minimum age to marry}}: <code>17</code>
* {{man label|Maximum age to marry}}: <code>50</code>
* {{man label|Maximum number of spouses for a person}}: <code>3</code>
* {{man label|Maximum number of consecutive years of widowhood before next marriage}}: <code>30</code>
* {{man label|Maximum age for an unmarried person}}: <code>99</code>

The first check box: {{man label|Estimate missing or inexact dates}} causes the tool to accept a baptism date if a birth date is not known, and to accept a burial date if a death date is not known. It also causes the tool to accept "inexact" dates (i.e., any "legal" Gramps date which is not a fully-specified one (with an explicit day and month and year)).

The second check box: {{man label|Identify invalid dates}} will check if the dates are invalid.

======Women======
* {{man label|Minimum age to bear a child}}: <code>17</code>
* {{man label|Maximum age to bear a child}}: <code>48</code>
* {{man label|Maximum number of children}}: <code>12</code>

======Men======
* {{man label|Minimum age to father a child}}: <code>18</code>
* {{man label|Maximum age to father a child}}: <code>65</code>
* {{man label|Maximum number of children}}: <code>15</code>

======Families======
* {{man label|Maximum husband-wife age difference}}: <code>30</code>
* {{man label|Maximum number of years between children}}: <code>8</code>
* {{man label|Maximum span of years for all children}}: <code>25</code>
{{-}}

=====Data Verification Results window=====

[[File:DataVerificationResults-window-example-52.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Data Verification Results window.]]

After you run the tool you will be presented with the {{man label|Data Verification Results}} window.

Depending on your criteria and your data, a list will be shown. The possibilities of findings are listed below. (But others may be added.) Each match will be grouped with similar findings.

* Baptism before birth
* '''Baptism too late according to family tradition'''
: This rule determines the median of days between birth and baptism over all children of a family. It then compares the days between the birth and the baptism of the person in question with also allowing some grace period of deviation. Currently, that grace period is hard-coded with 120 days.
* Birth equals death
* Birth equals marriage
* Burial before baptism
* Burial before birth
* Burial before death
* '''Burial too late'''
: A Burial is considered “too late” when its more than 14 days after the date of death. Should this be a parameter or might this confuse the user?
* '''Children are not in chronological order'''
: Birth dates (if no date exists and estimation is on, Baptism dates are used) are checked for each child of a family. Verifies that dates ascend through the list of children. Children without any of those dates are ignored
* Dead father
* Dead mother
* Death before baptism
* Death before birth
* Death equals marriage
* Disconnected individual
: ones with no parent or spouse or child or sibling
* Early marriage
: ( General tab, default = 17 )
* '''Families are not in chronological order'''
: This Rule uses the marriage date and evaluates that the families are ordered in a chronological order for a person. If no marriage date is available a divorce date or even the birth date of the oldes child of each family is used. The birth date as last possible fallback is used to account for non-married families with illegitimate children.
* '''Family events not ordered in chronological order'''
* '''Family has events with role Unknown'''
* Female husband
* Husband and wife with the same surname
* Invalid birth date
: ( General tab, default = True )
* Invalid death date
: ( General tab, default = True )
* Large age difference between spouses
: ( Families tab, default = 30 )
* Large age differences between children
: ( Families tab, default = 8 )
* '''Large year span for all children'''
: ( Families tab, default = 25 )
* Late marriage
: ( General tab, default = 50 )
* Male wife
* Marriage after death
* Marriage before birth
* Marriage date but not married
* Married often
: ( General tab, default = 3 )
* Multiple parents
* Old age at death
* Old age but no death
: ( General tab, default = 90 )
* Old and unmarried
: ( General tab, default = 50 )
* Old father
: ( Men tab, default = 65 )
* Old mother
: ( Women tab, default = 48 )
* '''Person events not in chronological order'''
* '''Person has events with role Unknown'''
* Same sex marriage
* Too many children
: ( Men tab, default = 15; Women tab, default = 12 )
* Unborn father
* Unborn mother
* Unknown gender
* Young father
: ( Men tab, default = 18 )
* Young mother
: ( Women tab, default = 17 )

On the bottom of the window four buttons are available to make a selection easier. Those are {{man button|Mark all}}, {{man button|Unmark all}}, {{man button|Invert marks}}, and {{man button|Hide marked}}.

Double-clicking on a row will give you a possibility to view and or edit the data.

With the {{man button|Close}} button (or select the keyboard shortcut {{man key press|Alt|C}}) you close the {{man label|Results}} window.
{{-}}

=====Examples=====
Two examples from using real data with this tool:

*:The warning showed 'female husband': checking the data I found a family with father : Anna Roelants. Luckily in the {{man label|Description}} I read: ''The marriage of Adam Roelants and Cornelia Crabbe''. It was clearly a typo: Anna i.s.o. Adam. Without this '''Tool''' it would be very hard to find.

*:The warning showed 'late marriage': checking the data: male person °1738 female person °1756 : marriage X 1804 [Gregorian Calendar] : Everything seemed to be OK: so they (re)married at the age of 66 and 48 years! The warning showed up because the '''General criteria''' was set to '''60'''.
=====See Also=====
* Development discussion on Gramps community support Discourse forum:
: [https://gramps.discourse.group/t/interest-in-enhancing-verify-py/4075/23 Interest in enhancing verify.py]
{{man tip|Difference between {{man label|Verify the Data}} tool and the [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database tool]] |The Check and Repair Database tool detects inconsistencies in the database structure. The {{man label|Verify the Data}} tool, however, is detecting the records that do not satisfy your particular criteria.}}
{{-}}

=== Debug ===

{{man warn|{{man menu|Warning do not use the '''Debug''' tools on your working Family Tree}}|{{man menu|Always create a new empty Family Tree or a copy of your existing Family Tree for testing.}} The tools available in this advanced menu are used for testing only.}}

[[File:MenuOverview-Tools-Debug-menu-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "{{man menu|Tools >Debug>...}}" Menubar - Tools - Debug menu Overview]]

When the command line: Python option <code>-O</code> ''optimise flag'' is not turned on, an additional {{man menu|Debug}} entry appears in the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Tools|Tools]]}} menu and the following tools are available:
* [[Gramps_6.0_Wiki_Manual_-_Tools#Check_Localized_Date_Displayer_and_Parser|Check Localized Date Displayer and Parser]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Generate_Testcases_for_Persons_and_Families|Generate Testcases for Persons and Families]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Populate_Sources_and_Citations|Populate Sources and Citations]]

Also See:
* [[Gramps_6.0 Wiki Manual - Command Line#Python options|Command Line: Python options]]
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Uncollected_Objects|Uncollected Objects]] Gramplet
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] Gramplet
{{-}}
====Check Localized Date Displayer and Parser====

[[File:StartDateTest-dialog-CheckLocalizedDateDisplayerAndParser-Tool-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Start date test?" dialog - for "Check Localized Date Displayer and Parser" - Tool]]

This test tool will create many people showing all different date variants as birth. The death date is created by parsing the result of the date displayer for the birth date. This way you can ensure that dates printed can be parsed back in correctly.

You will be shown the {{man label|Start date test?}} dialog to select either {{man button|Cancel}} to exit or {{man button|Run test}} to start the tool.
{{-}}

====Dump Gender Statistics====

[[File:GenderStatisticsTool-dialog-DumpGenderStatistics-Tool-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender Statistics tool" dialog results example - for "Dump Gender Statistics" - Tool]]

The "Gender Statistics tool" dialog will show the results in list about the statistics for the gender guessing based on the persons first name.

See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.
{{-}}

====Generate Testcases for Persons and Families====

[[File:GenerateTestcases-dialog-GenerateTestcasesForPersonsAndFamilies-Tool-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Generate testcases" dialog - for "Generate Testcases for Persons and Families" - Tool - default]]

The testcase generator will generate some persons and families that have broken links in the database or data that is in conflict to a relation.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

You can generate testcases that cause the following:
*{{checkbox|0}} {{man label|Generate low level database errors Correction needs database reload}}
*{{checkbox|0}} {{man label|Generate database errors}}
*{{checkbox|1}} {{man label|Generate dummy data}}
*{{checkbox|0}} {{man label|Generate long names}}
*{{checkbox|0}} {{man label|Add special characters}}
*{{checkbox|0}} {{man label|Add serial number}}
*{{checkbox|0}} {{man label|Add line break}}

*{{man label|Number of people to generate (Number is approximate because families are generated)}} <code>2000</code>(default)

Select {{man button|Cancel}} to exit or {{man button|OK}} to start the tool.

{{man button|Help}} will bring you here.

* Command line usage see: [[Plugins_Command_Line#Generate_Testcases_for_Persons_and_Families]]
{{-}}

====Populate Sources and Citations====

[[File:PopulateSourcesAndCitationsTool-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Populate sources and citations tool" dialog - default]]

This tool generates sources and citations for each source in order to populate the database for testing with significant numbers of sources and citations.

Enter the required number and then select {{man button|OK}} to run the tool:
*{{man label|Number of sources:}} <code>2</code> (default)
*{{man label|Number of citations:}} <code>2</code> (default)

Once the tool is complete you will be shown the {{man label|Data generated}} alert dialog.

{{-}}
{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Tools}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Tools]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Tools

2026-01-16T01:47:26Z

CallMeDave: /* Remove Unused Objects */

{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Tools}}
{{#vardefine:chapter|14}}
{{#vardefine:figure|0}}
[[File:MenuOverview-Tools-default-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}
"{{man menu|Tools >...}}" Menubar - Tools Overview - default]]
This chapter describes the various {{man label|Tools}} available in Gramps.

Gramps {{man label|Tools}} allow you to perform various types of analysis of your genealogical data. Typically, the tools do not produce output in form of printouts or files. Instead, they produce screen output immediately available for the researcher. However, when appropriate, you can save the results of running a tool into a file.

== Tools ==

[[File:ToolbarIcon-OpenTheToolsDialog-60.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Toolbar Icon for "Open the tools dialog"]]

The tools can be accessed by choosing the menu {{man menu|Tools ->''Tool Section'' ->''Particular Tool''}} .

Alternatively, you can browse the complete selection of available tools along with their brief descriptions in a {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Tool_Selection_dialog|Tool Selection]]}} dialog invoked by clicking the {{man button|Open the tools dialog}} icon on the toolbar from any of the categories.
{{-}}
{{man note|Additional Tools |Gramps allows you to install even more tools. This system is controlled by the [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|'''Plugin Manager''']]. For additional tools see [[6.0 Addons|'''Addons''']].}}

=== Tool Selection dialog ===

[[File:ToolSelection-dialog-with-debug-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - default information (and "Debug" tools selection)]]

[[File:ToolSelection-dialog-example-with-debug-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - example showing "Check and Repair Database" information (and "Debug" tools selection)]]



The {{man label|Tool Selection}} dialog allows you to browse the complete selection of available tools along with their brief descriptions when invoked by clicking the [[File:Gramps-tools.png|28px]] {{man button|Open the tools dialog}} icon on the toolbar from any of the categories and use the {{man button|▶}} arrows to expand the listings.

'''Select a tool from those available on the left'''. Use the {{man button|▶}} arrows to expand the top level listings:
* [[#Analysis_and_Exploration|Analysis and Exploration]]
* [[#Debug|Debug]]
* [[#Family_Tree_Processing|Family Tree Processing]]
* [[#Family_Tree_Repair|Family Tree Repair]]
* [[#Utilities|Utilities]]

Then select the tool you are interested in to be shown on the right hand side the following:
* Tool name
* Tool description
* Status:
* Author:
* Author's email:

You can can then use the buttons below to either find out more about the tool or open and run your tool.

* {{man button|Wiki}} opens the help page if available - needs an internet connection {{new|6.0.0}}
* {{man button|Close}} exits this dialog
* {{man button|Run}} - {{man tooltip|Run selected tool}} - opens the tools configuration page.
{{-}}
See also: [[Gramps_6.0_Wiki_Manual_-_Reports#Report_Selection_dialog|Report Selection dialog]]


=== Analysis and Exploration ===

This section contains tools which analyze and explore the database, but do not alter it. The following analysis and exploration tools are currently available in Gramps:

====Compare Individual Events====
[[File:CompareIndividualEvents-EventComparisonFilterSelection-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event comparison filter selection" - dialog]]

This tool collates all the event types discovered in a group of people. Arguably, it could be considered to be more a Report than a Tool. It generates a summary comparison table that begins with the Name and ID of each person, then adds columns for the Event types and dates. If there are multiples of the same event type, additional rows are created. The collation ignores the Roles but includes custom Event types.

The resulting table is useful for comparing of suspected duplicates and revealing inconsistencies. The table can become quite wide so the Save As (in the .ods format) will allow analysis in a spreadsheet application.

You can use this tool via menu {{man menu|Tools->Analysis and Exploration > Compare Individual Events...}} which will open the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Event_comparison_filter_selection_dialog|Event comparison filter selection]]}} dialog

=====Event comparison filter selection dialog=====

The people for this comparison can be chosen from previously created custom filters by selecting the {{man label|Filter:}} drop down list, which defaults to the ''Entire Database''. Or by selecting the {{man button|Custom Filter Editor}} button, to create custom filters in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Filters#.3Ccategory.3E_Filters_editor_dialog|Person Filters]]}} editor. To run the report select {{man button|Apply}} and the results will be displayed in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Event_Comparison_Results_dialog|Event Comparison Results]]}} dialog.

{{-}}

=====Event Comparison Results dialog=====
From the {{man label|Event Comparison Results}} dialog you can view the results or {{man button|Save As}} the resulting table as a spreadsheet (ODS format). Select {{man button|Close}} to exit the report.
{{-}}
[[File:CompareIndividualEvents-EventComparisonResults-dialog-expanded-example-60.png|center|thumb|800px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event Comparison Results" - dialog - expanded example]]

The spreadsheet (ODS format) shows the following output fields:
* <code>Person, ID, Birth Date, Birth Place, Death Date, Death Place, LVG Date, LVG Place, Burial Date, Burial Place, Marriage Date, Marriage Place</code> 

{{-}}

===Family Tree Processing===

This section contains tools which may modify your database. The tools from this section are used mostly for finding and correcting errors in the data. The following Family Tree Processing tools are currently available in Gramps:

* [[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Extract_Event_Description|Extract Event Description]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Extract_Information_from_Names|Extract Information from Names]]
* [[Addon:Extract_Place_Data_from_a_Place_Title|Extract Place Data from a Place Title]] - '''This tool was moved to [[Third-party_Addons|Third-party addons]]'''
* [[Gramps_6.0_Wiki_Manual_-_Tools#Find_Possible_Duplicate_People|Find Possible Duplicate People]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Fix_Capitalization_of_Family_Names|Fix Capitalization of Family Names]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Merge_citations|Merge citations]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rename_Event_Types|Rename Event Types]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Sort_Events|Sort Events]]

{{man note|Family Tree Processing tools will only perform modifications upon your explicit consent|Except for the automatic fixes performed by {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair Database]]}} tool in the '''Family Tree Repair''' menu.}}

====Edit Database Owner Information====

[[File:DatabaseOwnerEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Database Owner Editor" - dialog - default]]

The {{man label|Edit Database Owner Information}} tool modifies any existing [[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher Information]].

Select the menu {{man menu|Tools->Family Tree Processing->Edit Database Owner Information...}}. This brings up the {{man label|Database Owner Editor}} window, where you can fill in the needed information or use one of the buttons to retrieve existing information.

*{{man label|Name:}}
*{{man label|Street:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

This information is family tree specific and will be used when exporting your data in GEDCOM format.

Two button choices are available:
* {{man button|Copy from DB to Preferences}} - to the '''Researcher''' section.
* {{man button|Copy from Preferences to DB}} - from the '''Researcher''' section.

{{new|6.0 - [https://github.com/gramps-project/gramps/pull/1660 Use regular buttons to copy owner information from/to preferences]}}
{{-}}

====Extract Event Description====

{{man note|The name format in the Event's Description field depends on|the defined name format in {{man menu|Edit->Preferences->Data> Display Options (section) ->}}{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Name format:]]}} }}



Extracts event descriptions from the event data by using a model :

<code>{event type} of {Surname}, {Given name}</code>

If event description is missing, then tool will use this event description field model.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Event Description...}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

Once you {{man button|Proceed with the tool}} this tool will scan and modify your Family Tree and if not present show you the {{man label|No modifications made}} alert otherwise if present you with the:

=====Modifications made result window=====
[[File:ExtractEventDescription-ModificationsMade-window-example-60.png|right|thumb|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Extract Event Description's - "Modifications Made" - window - example result]]

{{man label|Modifications made}} result window listing the total number of event descriptions that have been added.
{{-}}

====Extract Information from Names====

This tool searches the entire database and attempts to extract titles and nicknames that may be embedded in a person's {{man label|Given name}} field. If any information could be extracted, the candidates for fixing will be presented in the table. You may then decide which to repair as suggested and which not to.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Information from Names....}}

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Default_prefix_and_connector_settings_dialog|Default prefix and connector settings]]}} dialog will be shown and you can modify each of the options as required and once you have finished select {{man button|OK}} to start the tool.
{{-}}

Once the tool finishes either the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#No_modifications_made_dialog|No modifications made]]}} dialog will be shown as ''No titles, nicknames or prefixes were found'' or the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Name_and_title_extraction_tool_window|Name and title extraction tool]]}} window will be shown with results of the search.
{{-}}

=====Default prefix and connector settings dialog=====
[[File:ExtractInformationFromNames-DefaultPrefixAndConnectorSettings-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Default prefix and connector settings" - dialog for the "Extract Information from Names" Tool]]

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Default_prefix_and_connector_settings_dialog|Default prefix and connector settings]]}} dialog you can modify each of the options as required:
* {{man label|Prefixes to search for:}} <code>de, van, von, di, le, du, dela, della, des, vande, ten, da, af, den, das, dello, del, en, ein, elet, les, lo, los, un, um, una, uno, der, ter, te, die</code> (default)
* {{man label|Connectors splitting surnames:}} <code>e, y</code> (default)
* {{man label|Connectors not splitting surnames:}} <code>de, van</code> (default)
{{-}}

=====No modifications made dialog=====
[[File:ExtractInformationFromNames-NoModificationsMade-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "No modifications made" - dialog for the "Extract Information from Names" Tool]]

Shown when ''No titles, nicknames or prefixes were found'' in the selected family tree.

Select {{man button|Close}} to dismiss the dialog.

{{-}}

=====Name and title extraction tool window=====
The top section shows information about the tool.
{{man note|Below is a list of the nicknames, titles, prefixes and compound surnames that Gramps can extract from the Family Tree.
If you accept the changes, Gramps will modify the entries that have been selected.

Compound surnames are shown as lists of [prefix, surname, connector].

For example, with the defaults, the name "de Mascarenhas da Silva e Lencastre" shows as:

[de, Mascarenhas]-[da, Silva, e]-[,Lencastre]

Run this tool several times to correct names that have multiple information that can be extracted.}}

[[File:ExtractInformationFromNames-NameAndTitleExtractionTool-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Name and title extraction tool" - dialog results window for the "Extract Information from Names" Tool]]

The bottom section displays the results list in a table with the following columns: <code>Select</code>, <code>ID</code>, <code>Type</code>, <code>Value</code>, <code>Current Name</code>

You can un-<code>Select</code> the results you don't want and then {{man button|Accept and close}} to apply those results to your family tree or {{man button|Cancel}} to do nothing. The {{man button|Help}} button brings you to this tools help section.
{{-}}

====Extract Place Data from a Place Title====

{{man warn|This tool was moved to [[Third-party_Addons|Third-party addons]].|When the Place Hierarchy was first added to Gramps, every user needed a tool to [[Addon:Extract Place Data from a Place Title]]. Now that that a Hierarchy of Places is well established, the tool is needed infrequently. So installation has been made optional.}}

====Find Possible Duplicate People====

[[File:FindPossibleDuplicatePeople-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find Possible Duplicate People - dialog - default]]

The '''Find Possible Duplicate People''' tool searches the entire Tree database, looking for the entries that may represent the same person.

You can access this tool via the menu {{man menu|Tool -> Family Tree Processing -> Find Possible Duplicate People...}}.

The {{man label|Find Possible Duplicate People}} dialog will be shown and you can adjust the following options:
*{{man label|Match Threshold}} : choose between '''Low''' (default), ''Medium'' and ''High'' from the drop down menu.
{{man note|How is the quality of match measured?|2=This calculates the chances (or 'odds') of matching on a quality scale labeled as low, medium and high. For each piece of information that corresponds, the quality of the match is considered to be marginally increased. The closer the particular pieces of data correlate, the larger the increase. When the chance is greater than the selected '''Match Threshold''' then a match will reported. The thresholds are Low=0.25, Medium=1.0 and High=2.0. So, with the filtering threshold set to High, fewer matches are expected.}}

{{man label|Options}}
*{{checkbox|1}} {{man label|Use [[Gramps_6.0_Wiki_Manual_-_Gramplets#SoundEx_Gramplet|soundex]] codes}} for matching possible duplicate people. (checkbox checked by default)

The following buttons are present: {{man button|Help}} brings you to this page, {{man button|Cancel}} to stop processing and an {{man button|OK}} button to start processing the data.

Select {{man button|OK}} to start the tool and the data will be processed in two passes.

*Pass 1: Building preliminary lists
*Pass 2: Calculating potential matches.

A progress bar will be shown and depending the speed of your computer and the amount of people in the database this can take some time.

{{-}}

=====Potential Merges=====
[[File:FindPossibleDuplicatePeople-PotentialMerges-result-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Potential Merges" result dialog window for "Find Possible Duplicate People" - dialog - example]]

Once the report finishes a {{man label|Potential Merges}} result list window is presented with the following columns shown:
*<code>Rating</code> : this gives you an idea of the resemblance between the two people. The higher the ranking, the higher the chance that the people are duplicates.
*<code>First Person</code>
*<code>Second Person</code>

You can either double-click on the selected row or select the {{man button|Compare}} button to check the details.

Three buttons are present: {{man button|Help}} brings you to this page, a {{man button|Close}} to close the window which returns you to the {{man label|Find Possible Duplicate People}} window and a {{man button|Compare}} button to which brings up the {{man label|Merge People}} window which was explained in detail in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_People|Merge People]]}} dialog. Here you can select with the radio buttons one of the persons and eventually use the {{man button|OK}} button to merge the data if you find the two persons are duplicates.

Selecting the {{man button|Cancel}} button brings you back to the {{man label|Potential Merges}} result list window.
{{-}}

====Fix Capitalization of Family Names====

This tool searches the entire database and attempts to fix the capitalization of family names.

The aim is to have conventional capitalization: capital first letter and lower case for the rest of the family name. If deviations from this rule are detected, the candidates for fixing will be presented in the table.

You may then decide which to repair as suggested and which not to.

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Fix Capitalization of Family Names...}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{-}}
[[File:FixCapitalizationofFamilyNames-CapitalizationChanges-dialog-results-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Capitalization changes" - dialog - results example for "Fix Capitalization of Family Names" tool]]

If there where changes to the capitalization of any names you will be presented with the {{man label|Capitalization changes}} results window. The window shows a list of the family names that Gramps can convert to (according to Gramps) correct capitalization (please check that it is correct for you.). In the {{man label|Capitalization changes}} results window list the following columns are available:
*{{checkbox|1}} {{man label|Select}} - Check or uncheck these on a "by name" basis if you choose not to accept the recommendation (checkbox checked by default)
* {{man label|Original Name}} - The name as currently recorded.
* {{man label|Capitalization Change}} - The name with change if applied.

Select the names you want to be changed, then select the {{man button|Accept changes and close}} button. Or use the {{man button|Cancel}} button to abort changes.
{{-}}

You can also install the "[[Addon:Fix Capitalization of Given Names]]" tool Addon that once installed works almost identically to this tool but works for "Given Names"
{{-}}

====Merge citations====

{{man tip|The {{man label|Merge Citations}} tool|works by combining notes, media objects and data-items of matching citations.}}

You can select this via menu {{man menu|Tools > Family Tree Processing > Merge Citations...}} .

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.
{{-}}
[[File:MergeCitations-dialog-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Merge Citations" - dialog - default]]

Then the {{man label|Merge Citations}} dialog (Title of dialog shows:''Notes, media objects and data-items of matching citations will be combined.'')will be shown

The following options are available:
* {{man label|Match Threshold}} drop down list:
** Match on Page/Volume, Date and Confidence
** '''Ignore Date''' (default)
** Ignore Confidence
** Ignore Date and Confidence
* {{man label|Options}}
** {{checkbox|0}} {{man label|Don't merge if citation has notes}} (checkbox unchecked by default)

{{-}}
[[File:NumberOfMergesDone-dialog-result-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Number of merges done" result dialog for "Merge Citations" - dialog - Tool - example]]

Select {{man button|OK}} to run the tool and once complete it will report back the total with the {{man label|Number of merges done}} result dialog.
{{-}}
See also the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Citations|Merge Citations]] option available from the Citations Category list view
{{-}}

====Rename Event Types====

This tool will rename all events of one type to a different type.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Rename Event Types....}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}

{{-}}
[[File:RenameEventTypes-Tool-ChangeEventTypes-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Change Event Types" - dialog - example for "Rename Event Types" Tool]]

The {{man label|Change Event Types}} dialog is presented.

* {{man label|Original event type}}: fill in the text field or use the drop down menu and select an original event type
* {{man label|New event type}}: fill in the text field (you can create a complete new type here) or use the drop down menu and select a new type

The example shows a renaming of the '''Birth''' event to a '''Baptism''' event.

{{man note|Custom types|While the custom types do not show in the drop down list, you can over type or paste into either of the selection boxes and convert from one to another.}}

{{-}}
[[File:RenameEventTypes-Tool-ChangeTypes-result-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Change types" - result dialog - example for "Rename Event Types" Tool]]

Finally use the {{man button|Cancel}} to exit or select {{man button|OK}} to run the tool and once complete it will report back the total events modified with the {{man label|Change types}} result dialog.
{{-}}

{{man warn|1=Renaming events|2=Once completed, this cannot be undone by the regular {{man label|Undo}} function.}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Editing information about events]]


====Reorder Gramps IDs====

This tool can be used to reorder your Gramps object IDs.

[[File:ReorderGrampsIDs-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" tool window - example]]

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Reorder Gramps IDs...}}.

Initialy the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}}''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

Then the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_tool_window|Reorder Gramps IDs]]}} tool window will be shown where you can modify the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_tool_window|column options]] as needed then select {{man button|OK}} to start the process.

The tool will then show various progress dialogs during the different progress stages; as the following object IDs' are reordered: 'Reordering People IDs', 'Reordering Family IDs', 'Reordering Event IDs', 'Reordering Place IDs', 'Reordering Source IDs', 'Reordering Citation IDs', 'Reordering Repository IDs', 'Reordering Media Object IDs' and finally 'Reordering Note IDs'.

In the final step 'unused IDs' are searched for and assigned.

During this process the tool will examine each ID to see if it looks like it has been 'customized', if it doesn't look like the previous object ID format or the default object ID format. This might be the case if the user has manually entered their own text in the ID field for the object when editing it. It might also occur if the third-party [[Addon:GeoName|GeoName Addon]] has been used or the [[Addon:GetGOV|GetGOV Addon]] that stores the '''GOV ID''' in the Place ID field. If a ''customized'' ID is found, the tool will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_replace_dialog|Reorder Gramps IDs]]}} replace dialog that ask the user if they really wants to replace the ID and also optionally allows the user to use the same answer for same found customized object IDs.

{{man warn|Custom IDs'|If you customized your object IDs', all those can be replaced by this tool. So take care by backing up before you use this tool!}}

=====Reorder Gramps IDs tool window=====
[[File:ReorderGrampsIDs-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" tool window - default on new empty family tree]]

The {{man label|Reorder Gramps IDs}} tool window shows each of Gramps objects (Person, Family, Event, Place, Source, Citation, Repository, Media, Note) and the following option columns (<code>Object</code>, '<code>Actual</code>, <code>Quantity</code>, <code>Format</code>, <code>Change</code>, <code>Start</code>, <code>Stop</code>, <code>Keep</code>) that can be applied to changing the object ID's.

The {{man button|Help}} button will show this section. The {{man button|Cancel}} button will exit the tool. The {{man button|Ok}} start the tool.

Most of the column labels also double as hidden toggles buttons and perform various actions as described below.

;<code>Object</code>:This column lists the type of Gramps ID. Immediately to the left of this column are checkboxes that allow the enabling of changes to individual object types. When checked, the type can be reordered. The {{man button|Object}} label is actually a hidden button that can be used to toggle all of the checkboxes at once.

;<code>Actual</code>:This column shows an example of the current objects ID.

;<code>Quantity</code>:This column show the current number of objects in the family tree.

;<code>Format</code>:This column can be used to change the ID format for each object type. Note that the default ID formats consists of a one letter prefix (I, F, E, P, S, C, R, O, N) representing each of the objects, and then a suffix '<code>%04d</code>'. There '''MUST''' be at least a prefix or a suffix, both are allowed. It is recommended to keep these relatively short. The '<code>%04d</code>' defines the length of the numeric portion of the ID, the '<code>4</code>' can be changed, anything from '<code>3</code>' (allowing numbers from 000-999) to '<code>9</code>' (000000000-999999999) is allowed (''If your family tree needs more than "nine hundred ninety-nine million, nine hundred ninety-nine thousand, nine hundred ninety-nine" please raise a feature request!''). Changes made here are the same as made in the menu {{man menu|Edit->Preferences...}} and then select the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}''' tab. The '{{man button|Format}}' label is actually a hidden button that can be used to ''reset'' all the formats to the last used value.

;<code>Change</code>:This column contains checkboxes for each object type. When checked, the IDs for that object will be replaced with new IDs of the <code>Format</code> style, unless <code>Keep</code> is also checked. If there is no checkmark, the ID formats are ''NOT'' updated, but the number field within the format is renumbered. The {{man button|Change}} label is actually a hidden button that can be used to toggle all of the check boxes at once.

;<code>Start</code>:This field indicates the starting number used during the renumber operation. The {{man button|Start}} label is actually a hidden button that can be used to toggle between start at <code>0</code>, and start after last current number.

;<code>Step</code>:This field indicates the interval between numbers during the renumber, <code>1</code> is a simple increment, <code>2</code> will increment by 2 etc. The {{man button|Step}} label is actually a hidden button that can be used to toggle between <code>1</code>, <code>2</code>, <code>5</code>, and <code>10</code>.

;<code>Keep</code>:This column contains check boxes for each object type. If both the <code>Keep</code> and <code>Change</code> check boxes are checked, the ID formats for that object will be retained, and the number field within the format is renumbered. The {{man button|Keep}} label is actually a hidden button that can be used to toggle all of the check boxes at once.

=====Reorder Gramps IDs replace dialog=====
[[File:ReorderGrampsIDs-replace-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" replace dialog - example]]

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_dialog|Reorder Gramps IDs]]}} replace dialog that ask the user if they really wants to replace the ID and also optionally allows the user to use the same answer for same found customized object IDs.

* {{man label|[ ] Use this answer for the rest of the items}}

Select {{man button|Yes}} or {{man button|No}}.
{{-}}

====Sort Events====

Events appearing on the Event tab on a ''Person'' or ''Family Editor'' are not sorted in any particular order other than the order that the events were added. The reason for not enforcing any particular ordering, particularly ordering by date, is to allow for the situation where an event was known to have happened but the exact chronology is not. Importing or merging data from an external source can lead to extra events being added to, but out of sequence with, the existing set of events of a person or family.

Events can be manually re-ordered by [http://en.wikipedia.org/wiki/Drag-and-drop ''drag & drop''] or by use of the re-order buttons on the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Events]]}} tab. Either way, an event can be moved up or down in the list of events and Gramps will remember the new order when the changes are saved. The new ordering will be used wherever events are shown elsewhere in Gramps, such as on a report.

The order of all events on a tab can also be changed by clicking a column title. For example, clicking the <code>Date</code> column header will sort all the events in date order. However this way of sorting events is temporary and changes to the event order are not preserved when the window is closed.

The [http://en.wikipedia.org/wiki/Drag-and-drop ''drag and drop''] approach to sorting events is fine for moving a small number of events but is not practical for large scale changes. The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Sort_Events_tool|Sort Events tool]]}} has been designed specifically for this purpose, re-sorting all events in the database or just those associated with a targeted selection of people chosen by using a filter.

=====Sort Events tool=====

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Sort events...}}.

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}

{{-}}
======Tool Options tab ======
[[File:SortEvents-dialog-ToolOptions-tab-default-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Sort Events" Tool - dialog - showing "Tool Options" tab]]

On the {{man label|Tool Options}} tab for the {{man label|Sort Events}} dialog window the first option is used to define the range of people who's events are to be sorted. The first choice in the list is to apply the sorting to all people in the database. Alternative choices are to apply sorting to ancestors and descendants of a chosen person or to a range of people selected by a custom built person filter. After choosing who the sort should apply to, the next thing to consider is how the events should be sorted. The first option is to sort by date. This is probably the most likely choice, but other event attributes can be chosen too. The final choices are whether to make the events sorted ascending or descending and whether to apply the sort to family events that the selected people belong to as well.

{{stub}}

{{-}}
{{man warn|1=Sorting events|2=Once completed, this cannot be undone by the regular {{man label|Undo}} function.}}

=== Family Tree Repair ===

The following Family Tree Repair tools are available:

* [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Gender_Statistics|Rebuild Gender Statistics]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Reference_Maps|Rebuild Reference Maps]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Secondary_Indexes|Rebuild Secondary Indexes]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Remove_Unused_Objects|Remove Unused Objects]]



====Check and Repair Database====

{{man warn|Warning: The {{man label|Check and repair Database}} tool performs automatic fixes.|Once completed, this cannot be undone by the regular {{man label|[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_Undo_History|Undo History]]}} function.}}

The {{man label|Check and repair Database}} tool checks the selected database/Family Tree for integrity problems, fixing the problems it can. Specifically, the tool is checking for:

*Broken family links. These are the cases when a person's record refers to a family while the family's record does not refer to that person, and vice versa.

*Missing media objects. The missing media object is the object whose file is referenced in the database but does not exist. This can happen when the file is accidentally deleted, renamed, or moved to another location.

*Empty families. These are the family entries which have no reference to any person as their member.

*Parent relationship. This checks all families to ensure that father and mother are not mixed up. The check is also made that parents have different gender. If they have common gender then their relationship is renamed to "Partners".

You can use this tool via menu {{man menu|Tools->Family Tree Repair->Check and Repair Database...}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{-}}
=====Integrity Check Results dialog=====
[[File:IntegrityCheckResults-dialog-CheckAndRepairDatabase-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Integrity Check Results" - example result dialog - for the "Check and Repair Database" tool]]

Any issues found are automatically fixed and the {{man label|Integrity Check Results}} dialog will be shown with a summary actions taken.
{{-}}
=====No errors were found dialog=====
Otherwise you will see the {{man label|No errors were found}} dialog stating that ''The database has passed internal checks''.
{{-}}
=====Gramps had a problem the last time it was run - dialog=====
[[File:GrampsHadAProblemTheLastTimeItWasRun-dialog-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps had a problem the last time it was run - dialog ]]

After Gramps crashes [https://github.com/gramps-project/gramps/pull/778 on restart, Gramps will offer to run Check & Repair] tool. (Introduced in Gramps 5.1.x)

{{-}}

====Rebuild Gender Statistics====

[[File:GenderStatisticsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender statistics rebuilt" - result dialog for "Rebuild Gender Statistics" tool]]

Rebuilds gender statistics for name gender guessing based on the accumulated statistics of genders for given names within the tree. If a gender is common to more than half the in the Tree with a particular first word in their Given name, then Gramps will guess that Gender for that name will be the same.

The statistics can also be cleared (if the {{man menu|Tools ➡ [[Gramps_6.0_Wiki_Manual_-_Tools#Debug|Debug]]}} menu has been enabled) with the [[Gramps_6.0_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics]] Tool.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Gender Statistics...}}.

Once completed the {{man label|Gender statistics rebuilt}} result dialog will be shown.

{{man warn|Rebuild Gender Statistics needed after converting database|Issue {{bug|11314}} notes that gender statistics are swapped after database conversion to SQLite. If your gender guessing is suggesting the opposite gender for particular given names, use the Rebuilt Gender Statistics tool to fix the guessing.}}

See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.

{{-}}

====Rebuild Reference Maps====

[[File:ReferenceMapsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reference maps rebuilt" - result dialog for "Rebuild Reference Maps" tool]]

This tool rebuilds reference map tables. This drives the list of ''References'' items in editors.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Reference Maps...}}.

Once completed the {{man label|Reference maps rebuilt}} result dialog will be shown.
=====See also=====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}

====Rebuild Secondary Indexes====

[[File:SecondaryIndexesRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Secondary indexes rebuilt" - result dialog for "Rebuild Secondary Indexes" tool]]

This tool rebuilds secondary indices.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Secondary Indexes...}}.

Once completed the {{man label|Secondary indexes rebuilt}} result dialog will be shown.

The {{man menu|Rebuild Secondary indexes...}} re-constructs the secondary tables in the Tree db. These tables include things like gender statistics (Given Name versus gender) to allow guessing the gender of names as they are entered, surnames (for faster lookup of possible surname and to make the person tree view work), the various IDs for objects (to facilitate lookup by ID), place enclosure tables, to make the place tree view work, and a few others.

In theory, these tables are kept constantly up-to-date when anything changes. So rebuilding the Reference Maps and Secondary Indices should not be necessary. But, especially early on in the Gramps history, bugs sometimes interfered with updates completing correctly. So the tools remain available... ‘just in case’.
=====See also=====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}

====Remove Unused Objects====

This tool will search your database for pieces of information which are not connected to anything else, and then allow you to edit and attach the information or remove them.

You can use this tool via menu {{man menu|Tools->Family Tree Repair->Remove Unused Objects...}}.

{{-}}
[[File:UnusedObjects-dialog-example-results-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Unused Objects" - dialog example results for "Remove Unused Objects" tool]]

The {{man label|Unused Objects}} dialog is presented.

You can choose from the search option you want to use from the top section of the {{man label|Unused Objects}} dialog:
*{{checkbox|1}} {{man label|Search for events}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for sources}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for citations}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for places}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for media}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for repositories}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for notes}} (checkbox checked by default)

Select the {{man button|Find}} button to run the tool, and once completed the results if any will show in the bottom section of the {{man label|Unused Objects}} dialog with the following columns shown:
* {{man label|Mark}} Select the row if you want to delete the object (unchecked by default)
* {{man label|}} - Icon representing the type of object.
* {{man label|ID}} - Gramps internal name for the object.
* {{man label|Name}} - of the object.

To examine the object you must double-click on the row and it will show the appropriate editor for the object allowing you to edit if required.

{{man label|Mark}} the objects you want to delete either using the individual checkboxes or using the associated buttons:
* {{man button|Mark all}}
* {{man button|Unmark all}}
* {{man button|Invert marks}}

Once your deletion choices have been made select the {{man button|Delete}} button to delete the objects.

When finished you may then use the {{man button|Close}} button to exit the tool.
{{-}}
{{man note|Multiple runs of the Remove Unused Objects tool maybe needed in order to actually clean the database.|See {{bug|3249}}
}}

=== Utilities ===

This section contains tools allowing you to perform a simple operation on a portion of data. The results can be saved in your database, but they will not modify your existing data. The following utilities are currently available in Gramps:
* [[Gramps_6.0_Wiki_Manual_-_Tools#Clean_input_data|Clean input data]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Find_database_loop|Find database loop]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|Media Manager]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Not_Related|Not Related]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Verify_the_Data|Verify the Data]]

====Clean input data====

====Remove leading and trailing spaces====

[[File:CleanInputData-dialog-tool-example-dialog-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clean input data]]
Tool to clean leading and trailing spaces from imported or old data. The tool searches for place names with leading or/and trailing spaces. It also looks in the first name and surname.

Leading and trailing spaces are automatically removed during name data being committed to the tree.

The tool can be triggered from the menu {{man menu|Tools > Utilities > Clean input data...}} or Tools selector dialog

See also:
* Avoid invalid characters and leading or trailing spaces in the entry field - (added in Gramps [[Template:Releases/5.0.2|5.0.2]] with [https://github.com/gramps-project/gramps/pull/811 PR811])
* [https://github.com/gramps-project/gramps/pull/783 New tool to suppress leading and trailing spaces.] - (added in Gramps [[Template:Releases/5.1.0|5.1.0]])
* Feature request {{bug|4566}} : Please remove trailing spaces on items on input (2016)
* Feature request {{bug|4619}} : Trailing blanks are removed from queries in the preset filters (2011)

{{-}}

====Find database loop====

[[File:FindDatabaseLoop-example-PedigreeChartView-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree chart showing loop - example]]

The {{man label|Find database loop}} utility allows you to verify if you have ancestral loops in the database. Loops in your family tree may for example show a person as both the child and ancestor of another person in Family Tree. Loops can happen accidentally during data entry, for example, when a son is linked into the family tree as his own grandfather!

Other valid loops also happen and should be kept in the family tree if verified:
* An inbreeding loop because the parents are related.
* A mating loop caused by a male who has children to genetically related females.
* An incest mating loop caused by full siblings.
{{-}}
[[File:FindDatabaseLoop-dialog-example-results-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find database loop - dialog - results from example family tree case]]

Use the menu {{man menu|Tools->Utilities->Find database loop...}} and you will get a {{man label|Find database loop}} window that will display the results in a list with six columns: <code> </code> ''Loop Group unlabeled'' (<code>Gramps ID</code>, <code>Parent</code>), (<code>Gramps ID</code>, <code>Child</code>), <code>Family ID</code>.

* Loop Group unlabeled column - a number related to which loop the entries are about.
* First <code>Gramps ID</code> is a reference to the Parent.
* <code>Parent</code> (Ancestor on the image) is the person we are looking for a loop.
* Second <code>Gramps ID</code> is a reference to the Child.
* <code>Child</code> (Descendant) is the origin of the loop.
* <code>Family ID</code> is a reference to the associated family

Double clicking on a selection will open the related [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Families entry]].

To fix a pedigree loop in your family tree.
* Locate the person page of the individual whose relationship needs to be adjusted.
* First, verify that a name or vital event date was not accidentally entered incorrectly.
* If you are sure that deleting the incorrect parent-child relationship will fix the loop, proceed with the steps.

Once you have resolved any loops select {{man button|Close}} to exit.

{{-}}
To read more about ancestral loops see:
* [https://www.tamurajones.net/FindingAncestralLoops.xhtml Finding Ancestral Loops : Modern Software Experience]
* [http://www.beholdgenealogy.com/blog/?p=1309 Ancestral Loops : Louis Kessler's Behold Blog]

Also see:
* [https://wikipedia.org/wiki/Endogamy Endogamy] - From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Cousin_marriage Cousin marriage] - From Wikipedia, the free encyclopedia

=====Example ancestral loops=====

{{stub}}

[[File:FindDatabaseLoop-dialog-complex-example-results-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} chart showing complex example]]

In the following complex example, we have multiple ancestral loops indicated by the number in the first unlabeled column a "Loop Group" :

If we look at the second line, we have :
# First Gramps_ID : I0002
# Parent is : Father, Child2
# Second Gramps_ID : I0001
# Child is : Father, Father
# Family_ID is : F0000

{{-}}
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|600px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]

To understand what happens :
#we start at [I0002] Father, Child2.
#We continue with his son [I0003] Father, Child3.
#We continue with his son : [I0000] Child, Child.
#We continue with his son : [I0001] Father, Father.
#We continue with his son : [I0002] Father, Child2 ==> '''HERE, we have a ancestral loop'''.

{{-}}

====Media Manager====

{{stub}}

The {{man label|Gramps Media Manager}} is a group of four separate tools accessed via a wizard like dialog that you can access via the menu {{man menu|Tools->Utilities->Media Manager...}} which will show the first '''[[Gramps_6.0_Wiki_Manual_-_Tools#|Introduction]]''' dialog page.

=====Introduction=====

[[File:Introduction-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Introduction - page for "Gramps Media Manager" - Tool wizard]]

A brief information on the tools abilities is shown.

From the '''Introduction''' page selecting the {{man button|Next}} button (or using the keyboard shortcut {{man key press|Alt|N}}) you will be shown the '''[[Gramps_6.0_Wiki_Manual_-_Tools#Selection|Selection]]''' page window.

{{man note|Introduction|This tool allows [http://wikipedia.org/wiki/Batch_processing batch operations] on media objects stored in Gramps. An important distinction must be made between a Gramps media object and its file.

The Gramps media object is a collection of data about the media object file: its filename and/or path, its description, its ID, notes, source references, etc. These data '''do not include the file itself'''.

The files containing image, sound, video, etc. exist separately on your hard drive. These files are not managed by Gramps and are not included in the Gramps database. The Gramps database only stores the path and file names.

This tool allows you to only modify the records within your Gramps database. If you want to move or rename the files then you need to do it on your own, outside of Gramps. Then you can adjust the paths using this tool so that the media objects store the correct file locations.}}

{{-}}

=====Selection=====
[[File:Selection-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selection - page for "Gramps Media Manager" - Tool wizard - default]]

From the '''Selection''' page window select from one the four options the actions you want to take and then select the {{man button|Next}} button:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Replace_substrings_in_the_path|Replace substrings in the path]]}} (default)
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Add_images_not_included_in_database|Add images not included in database]]}}
{{-}}

=====Replace substrings in the path=====

[[File:ReplaceSubstringSettings-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Replace substring settings - page for "Gramps Media Manager" - Tool wizard - default]]

This tool allows replacing specified substring in the path of media objects with another substring. This can be useful when you move your media files from one directory to another.

Selecting this radio button will bring up a {{man label|Replace substring settings}} window where you can type in any string in the {{man label|Replace}} text field and the {{man label|With}} text field. At any time you can click on the {{man button|Cancel}} button or the {{man button|Back}} button. Clicking the {{man button|Forward}} button will bring up the {{man label|Final confirmation}} window.

{{-}}

=====Convert paths from relative to absolute=====
[[File:ConvertPathsFromRelativeToAbsolute-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from relative to absolute':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

This tool allows converting relative media paths to the absolute ones. It does this by prepending the {{man label|Base media path:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section, or if that is not set, it prepends the default [[Gramps_6.0_Wiki_Manual_-_User_Directory|User's Directory]].

* [https://wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}

=====Convert paths from absolute to relative=====
[[File:ConvertPathsFromAbsoluteToRelative-FinalConfirmation-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from absolute to relative':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

This tool allows converting absolute media paths to a relative path. The relative path is relative to the given base path in the setting {{man label|Base media path:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section, or if that is not set, the user's directory is used. A relative path connects the file location to the base media path that can be changed according to your needs.

* [https://en.wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}

=====Add images not included in database=====

[[File:AddImagesNotIncludedInDatabase-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Add images not included in database':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

Check directories for images not included in database, this tool adds images in directories that are referenced by existing images in the database. You will have to import one media item from each sub directory manually. Media Manager does not include sub-directories automatically. All the directory paths shown in the tool will be searched through.
{{-}}

====Not Related====

[[File:NotRelatedTo-dialog-NotRelated-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}. "Not related to '...'" - dialog - showing results for "Not Related" Tool]]

This tool will list people who are not connected to the selected active person. Connections may include linked in a chain of [[References|references]] or linkages created with the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Link_Editor|link editor in Notes]].

You can use this tool via menu {{man menu|Tools->Utilities->Not Related...}}.

You will get a {{man label|Not related to '...'}} results dialog which shows a list of all the people that are '''NOT''' related to the selected person.

This list gives you:
* ''Name''
* ''ID''
* ''Parents''
* ''Tags''

From the ''Name'' column you can use the {{man button|▶ right arrow}} button and {{man button|↓ down arrow}} buttons to collapse or expand the grouped ''Name'' list. Double clicking on a person will bring up the {{man label|person edit}} dialog or {{man label|family edit}} dialog.

If you select a person, you can use the {{man label|Tag}} text field (you can fill in whatever custom tag name you want to use) or use the drop down list to choose an existing tag eg TODO, NotRelated. Use the {{man button|Apply}} to add the selected tag to the person(s). This tag will then show up in the ''Tags'' column.
{{-}}

====Relationship Calculator====

[[File:RelationshipTo-dialog-RelationshipCalculator-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Relationship to '...' " - dialog - showing results for "Relationship Calculator" Tool]]
You can use this tool via menu {{man menu|Tools ➡ Utilities ▶ Relationship Calculator...}}.

Selecting the Relationship Calculator tool will open a list filtered to all people connected, '''but not necessarily related''', to the [[Gramps_Glossary#active_person|Active Person]]. To calculate relationship to different person, close the window, make that person Active and select the tool from the menu again.

Select the individual from the filtered list to report if a relationship exists. The exact relationship will be shown in the lower panel... along with the common ancestors in that relationship. Only blood relationships will display (except for husband-wife and step relationships). Note that "in-law" relationships are not displayed.

The filtered list will grouped and alphabetically sorted by surname. (Regardless of whether the View menu setting of the Person category has been set to '''Grouped'''.) The list columns cannot be re-sorted.

The degree of separation (generation distance) that will be recognized is controlled by the {{man label|Max generations for relationships}} value in the [[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]] tab under the {{man menu|Edit ➡ Preferences...}} menu. Moved from the [[Gramps_5.1_Wiki_Manual_-_Settings#General|5.1 General]] tab {{New|5.2}} (The default of 15 generations will report a 12th great-grandparent relationship but not the 13th great-grandparents. The active person is counted as one of the generations. So, self generation plus parent plus grandparents are the other 3 generations.)

Essentially, any two people are directly related by blood if they have an ancestor in common. One of these individuals may actually be an ancestor of the other - such as a great grandparent. Even in the cases of aunts and uncles, you still can calculate the relationship by searching for the common ancestor. In this case, the father or mother of the aunt or uncle will be a grandparent to the nephew or niece.

The most basic blood relationship through common ancestors is that of siblings (brothers and sisters) who are only one generation down from the common ancestor. Another special relationship is that of one of those siblings to the descendants of the other siblings. If the Active Person is a grandchild of the common ancestor, the sibling would be an aunt or uncle. Beyond that generation of descendants, there are two equivalent ways of describing the relationship. The daughter of great grandparents might be called either a grandaunt or a great aunt. (The Relationship Calculator uses the 'grand' variant.) That person is a great grandaunt to the second great grandchildren, who are four generations distant from the common ancestor. (She may also be called a second great aunt.) The reverse relationship of an aunt or uncle is a nephew or niece.

Cousins (also called "first" cousins) are two generations down from the common ancestor through different siblings. "Second" cousins are thus, three generations down from the common ancestor - and so on.

After that, everyone is considered a "cousin", but to indicate that they are not in the same generation we use the word "removed" to indicate the number of generations different between the two. For example, my father's "first" cousin is also my "first" cousin but "once removed" (one generation difference between us). My fathers "first" cousin is my own child's "first cousin twice removed" - two generations different.

If multiple blood relationships exist due to pedigree Collapse, all will be reported.

A full text list of all blood relations and their spouses can be viewed using a [[Gramps 6.0 Wiki Manual - Reports - part 6#Kinship Report|Kinship Report]].

=====See also:=====

* The '''Relationship to home person''' [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar
* '''Relation to Home Person''' [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].
* The '''[[Addon:Deep_Connections_Gramplet|Deep Connections]]''' gramplet: If this third party addon is installed, it will list the intervening generations through the sibling offspring of a common ancestor. (But it does not list the common ancestor or if both person a connected through the same spouse.) The Gramplet also details the indirect relationships.
* [[Specification:Relationship Calculator|Relationship Calculator Localization]] - create meaningful relation descriptions in your region.
{{-}}

====Verify the Data====
{{man tip|Verify the Data tool enhanced{{new|5.2}}|Tool performance improved, results reorganized into a Tree rather than a flat list, additional tests. 8 New rules ([[Gramps_6.0_Wiki_Manual_-_Tools#Data_Verification_Results_window|marked below]]) to find additional irregularities.
}}

[[File:VerifyTheData-DataVerifyTool-dialog-General-tab-defaults-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Verify the Data..." - "Data Verify tool" dialog - "General" tab - defaults]]

This utility allows you to verify the database based on the set of criteria specified by you.

For example, you may want to make sure that nobody in your database had children at the age of 98. Based on common sense, such a record would indicate an error. However, it is not a consistency error in the database. Besides, someone might have a child at the age of 98 (although this rarely happens). The Verify tool will display everything that violates your criteria so that you can check whether the record is erroneous or not. The ultimate decision is yours.

Select this via the menu {{man menu|Tools->Utilities->Verify the Data...}} you will get a {{man label|Data Verify Tool}} window. The window has four tabs; {{man label|General}}, {{man label|Women}}, {{man label|Men}}, {{man label|Families}}. Those tabs show a list with criteria and a input field where you can alter the criteria value. In the lists below I show some ''workable'' values.

=====Verify the Data tab pages=====

Select the criteria you want to run the tool with from the following tabs. If you are OK with the criteria click the {{man button|Run}} button (or hit the {{man key press|Alt|R}} keybinding) and you will be presented with a {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Data_Verification_Results_window|Data Verification Results]]}} window.

======General======
* {{man label|Maximum age}}: <code>90</code>
* {{man label|Minimum age to marry}}: <code>17</code>
* {{man label|Maximum age to marry}}: <code>50</code>
* {{man label|Maximum number of spouses for a person}}: <code>3</code>
* {{man label|Maximum number of consecutive years of widowhood before next marriage}}: <code>30</code>
* {{man label|Maximum age for an unmarried person}}: <code>99</code>

The first check box: {{man label|Estimate missing or inexact dates}} causes the tool to accept a baptism date if a birth date is not known, and to accept a burial date if a death date is not known. It also causes the tool to accept "inexact" dates (i.e., any "legal" Gramps date which is not a fully-specified one (with an explicit day and month and year)).

The second check box: {{man label|Identify invalid dates}} will check if the dates are invalid.

======Women======
* {{man label|Minimum age to bear a child}}: <code>17</code>
* {{man label|Maximum age to bear a child}}: <code>48</code>
* {{man label|Maximum number of children}}: <code>12</code>

======Men======
* {{man label|Minimum age to father a child}}: <code>18</code>
* {{man label|Maximum age to father a child}}: <code>65</code>
* {{man label|Maximum number of children}}: <code>15</code>

======Families======
* {{man label|Maximum husband-wife age difference}}: <code>30</code>
* {{man label|Maximum number of years between children}}: <code>8</code>
* {{man label|Maximum span of years for all children}}: <code>25</code>
{{-}}

=====Data Verification Results window=====

[[File:DataVerificationResults-window-example-52.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Data Verification Results window.]]

After you run the tool you will be presented with the {{man label|Data Verification Results}} window.

Depending on your criteria and your data, a list will be shown. The possibilities of findings are listed below. (But others may be added.) Each match will be grouped with similar findings.

* Baptism before birth
* '''Baptism too late according to family tradition'''
: This rule determines the median of days between birth and baptism over all children of a family. It then compares the days between the birth and the baptism of the person in question with also allowing some grace period of deviation. Currently, that grace period is hard-coded with 120 days.
* Birth equals death
* Birth equals marriage
* Burial before baptism
* Burial before birth
* Burial before death
* '''Burial too late'''
: A Burial is considered “too late” when its more than 14 days after the date of death. Should this be a parameter or might this confuse the user?
* '''Children are not in chronological order'''
: Birth dates (if no date exists and estimation is on, Baptism dates are used) are checked for each child of a family. Verifies that dates ascend through the list of children. Children without any of those dates are ignored
* Dead father
* Dead mother
* Death before baptism
* Death before birth
* Death equals marriage
* Disconnected individual
: ones with no parent or spouse or child or sibling
* Early marriage
: ( General tab, default = 17 )
* '''Families are not in chronological order'''
: This Rule uses the marriage date and evaluates that the families are ordered in a chronological order for a person. If no marriage date is available a divorce date or even the birth date of the oldes child of each family is used. The birth date as last possible fallback is used to account for non-married families with illegitimate children.
* '''Family events not ordered in chronological order'''
* '''Family has events with role Unknown'''
* Female husband
* Husband and wife with the same surname
* Invalid birth date
: ( General tab, default = True )
* Invalid death date
: ( General tab, default = True )
* Large age difference between spouses
: ( Families tab, default = 30 )
* Large age differences between children
: ( Families tab, default = 8 )
* '''Large year span for all children'''
: ( Families tab, default = 25 )
* Late marriage
: ( General tab, default = 50 )
* Male wife
* Marriage after death
* Marriage before birth
* Marriage date but not married
* Married often
: ( General tab, default = 3 )
* Multiple parents
* Old age at death
* Old age but no death
: ( General tab, default = 90 )
* Old and unmarried
: ( General tab, default = 50 )
* Old father
: ( Men tab, default = 65 )
* Old mother
: ( Women tab, default = 48 )
* '''Person events not in chronological order'''
* '''Person has events with role Unknown'''
* Same sex marriage
* Too many children
: ( Men tab, default = 15; Women tab, default = 12 )
* Unborn father
* Unborn mother
* Unknown gender
* Young father
: ( Men tab, default = 18 )
* Young mother
: ( Women tab, default = 17 )

On the bottom of the window four buttons are available to make a selection easier. Those are {{man button|Mark all}}, {{man button|Unmark all}}, {{man button|Invert marks}}, and {{man button|Hide marked}}.

Double-clicking on a row will give you a possibility to view and or edit the data.

With the {{man button|Close}} button (or select the keyboard shortcut {{man key press|Alt|C}}) you close the {{man label|Results}} window.
{{-}}

=====Examples=====
Two examples from using real data with this tool:

*:The warning showed 'female husband': checking the data I found a family with father : Anna Roelants. Luckily in the {{man label|Description}} I read: ''The marriage of Adam Roelants and Cornelia Crabbe''. It was clearly a typo: Anna i.s.o. Adam. Without this '''Tool''' it would be very hard to find.

*:The warning showed 'late marriage': checking the data: male person °1738 female person °1756 : marriage X 1804 [Gregorian Calendar] : Everything seemed to be OK: so they (re)married at the age of 66 and 48 years! The warning showed up because the '''General criteria''' was set to '''60'''.
=====See Also=====
* Development discussion on Gramps community support Discourse forum:
: [https://gramps.discourse.group/t/interest-in-enhancing-verify-py/4075/23 Interest in enhancing verify.py]
{{man tip|Difference between {{man label|Verify the Data}} tool and the [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database tool]] |The Check and Repair Database tool detects inconsistencies in the database structure. The {{man label|Verify the Data}} tool, however, is detecting the records that do not satisfy your particular criteria.}}
{{-}}

=== Debug ===

{{man warn|{{man menu|Warning do not use the '''Debug''' tools on your working Family Tree}}|{{man menu|Always create a new empty Family Tree or a copy of your existing Family Tree for testing.}} The tools available in this advanced menu are used for testing only.}}

[[File:MenuOverview-Tools-Debug-menu-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "{{man menu|Tools >Debug>...}}" Menubar - Tools - Debug menu Overview]]

When the command line: Python option <code>-O</code> ''optimise flag'' is not turned on, an additional {{man menu|Debug}} entry appears in the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Tools|Tools]]}} menu and the following tools are available:
* [[Gramps_6.0_Wiki_Manual_-_Tools#Check_Localized_Date_Displayer_and_Parser|Check Localized Date Displayer and Parser]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Generate_Testcases_for_Persons_and_Families|Generate Testcases for Persons and Families]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Populate_Sources_and_Citations|Populate Sources and Citations]]

Also See:
* [[Gramps_6.0 Wiki Manual - Command Line#Python options|Command Line: Python options]]
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Uncollected_Objects|Uncollected Objects]] Gramplet
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] Gramplet
{{-}}
====Check Localized Date Displayer and Parser====

[[File:StartDateTest-dialog-CheckLocalizedDateDisplayerAndParser-Tool-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Start date test?" dialog - for "Check Localized Date Displayer and Parser" - Tool]]

This test tool will create many people showing all different date variants as birth. The death date is created by parsing the result of the date displayer for the birth date. This way you can ensure that dates printed can be parsed back in correctly.

You will be shown the {{man label|Start date test?}} dialog to select either {{man button|Cancel}} to exit or {{man button|Run test}} to start the tool.
{{-}}

====Dump Gender Statistics====

[[File:GenderStatisticsTool-dialog-DumpGenderStatistics-Tool-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender Statistics tool" dialog results example - for "Dump Gender Statistics" - Tool]]

The "Gender Statistics tool" dialog will show the results in list about the statistics for the gender guessing based on the persons first name.

See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.
{{-}}

====Generate Testcases for Persons and Families====

[[File:GenerateTestcases-dialog-GenerateTestcasesForPersonsAndFamilies-Tool-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Generate testcases" dialog - for "Generate Testcases for Persons and Families" - Tool - default]]

The testcase generator will generate some persons and families that have broken links in the database or data that is in conflict to a relation.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

You can generate testcases that cause the following:
*{{checkbox|0}} {{man label|Generate low level database errors Correction needs database reload}}
*{{checkbox|0}} {{man label|Generate database errors}}
*{{checkbox|1}} {{man label|Generate dummy data}}
*{{checkbox|0}} {{man label|Generate long names}}
*{{checkbox|0}} {{man label|Add special characters}}
*{{checkbox|0}} {{man label|Add serial number}}
*{{checkbox|0}} {{man label|Add line break}}

*{{man label|Number of people to generate (Number is approximate because families are generated)}} <code>2000</code>(default)

Select {{man button|Cancel}} to exit or {{man button|OK}} to start the tool.

{{man button|Help}} will bring you here.

* Command line usage see: [[Plugins_Command_Line#Generate_Testcases_for_Persons_and_Families]]
{{-}}

====Populate Sources and Citations====

[[File:PopulateSourcesAndCitationsTool-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Populate sources and citations tool" dialog - default]]

This tool generates sources and citations for each source in order to populate the database for testing with significant numbers of sources and citations.

Enter the required number and then select {{man button|OK}} to run the tool:
*{{man label|Number of sources:}} <code>2</code> (default)
*{{man label|Number of citations:}} <code>2</code> (default)

Once the tool is complete you will be shown the {{man label|Data generated}} alert dialog.

{{-}}
{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Tools}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Tools]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Tools

2026-01-16T01:46:09Z

CallMeDave: /* Remove Unused Objects */

{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Tools}}
{{#vardefine:chapter|14}}
{{#vardefine:figure|0}}
[[File:MenuOverview-Tools-default-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}
"{{man menu|Tools >...}}" Menubar - Tools Overview - default]]
This chapter describes the various {{man label|Tools}} available in Gramps.

Gramps {{man label|Tools}} allow you to perform various types of analysis of your genealogical data. Typically, the tools do not produce output in form of printouts or files. Instead, they produce screen output immediately available for the researcher. However, when appropriate, you can save the results of running a tool into a file.

== Tools ==

[[File:ToolbarIcon-OpenTheToolsDialog-60.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Toolbar Icon for "Open the tools dialog"]]

The tools can be accessed by choosing the menu {{man menu|Tools ->''Tool Section'' ->''Particular Tool''}} .

Alternatively, you can browse the complete selection of available tools along with their brief descriptions in a {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Tool_Selection_dialog|Tool Selection]]}} dialog invoked by clicking the {{man button|Open the tools dialog}} icon on the toolbar from any of the categories.
{{-}}
{{man note|Additional Tools |Gramps allows you to install even more tools. This system is controlled by the [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|'''Plugin Manager''']]. For additional tools see [[6.0 Addons|'''Addons''']].}}

=== Tool Selection dialog ===

[[File:ToolSelection-dialog-with-debug-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - default information (and "Debug" tools selection)]]

[[File:ToolSelection-dialog-example-with-debug-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - example showing "Check and Repair Database" information (and "Debug" tools selection)]]



The {{man label|Tool Selection}} dialog allows you to browse the complete selection of available tools along with their brief descriptions when invoked by clicking the [[File:Gramps-tools.png|28px]] {{man button|Open the tools dialog}} icon on the toolbar from any of the categories and use the {{man button|▶}} arrows to expand the listings.

'''Select a tool from those available on the left'''. Use the {{man button|▶}} arrows to expand the top level listings:
* [[#Analysis_and_Exploration|Analysis and Exploration]]
* [[#Debug|Debug]]
* [[#Family_Tree_Processing|Family Tree Processing]]
* [[#Family_Tree_Repair|Family Tree Repair]]
* [[#Utilities|Utilities]]

Then select the tool you are interested in to be shown on the right hand side the following:
* Tool name
* Tool description
* Status:
* Author:
* Author's email:

You can can then use the buttons below to either find out more about the tool or open and run your tool.

* {{man button|Wiki}} opens the help page if available - needs an internet connection {{new|6.0.0}}
* {{man button|Close}} exits this dialog
* {{man button|Run}} - {{man tooltip|Run selected tool}} - opens the tools configuration page.
{{-}}
See also: [[Gramps_6.0_Wiki_Manual_-_Reports#Report_Selection_dialog|Report Selection dialog]]


=== Analysis and Exploration ===

This section contains tools which analyze and explore the database, but do not alter it. The following analysis and exploration tools are currently available in Gramps:

====Compare Individual Events====
[[File:CompareIndividualEvents-EventComparisonFilterSelection-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event comparison filter selection" - dialog]]

This tool collates all the event types discovered in a group of people. Arguably, it could be considered to be more a Report than a Tool. It generates a summary comparison table that begins with the Name and ID of each person, then adds columns for the Event types and dates. If there are multiples of the same event type, additional rows are created. The collation ignores the Roles but includes custom Event types.

The resulting table is useful for comparing of suspected duplicates and revealing inconsistencies. The table can become quite wide so the Save As (in the .ods format) will allow analysis in a spreadsheet application.

You can use this tool via menu {{man menu|Tools->Analysis and Exploration > Compare Individual Events...}} which will open the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Event_comparison_filter_selection_dialog|Event comparison filter selection]]}} dialog

=====Event comparison filter selection dialog=====

The people for this comparison can be chosen from previously created custom filters by selecting the {{man label|Filter:}} drop down list, which defaults to the ''Entire Database''. Or by selecting the {{man button|Custom Filter Editor}} button, to create custom filters in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Filters#.3Ccategory.3E_Filters_editor_dialog|Person Filters]]}} editor. To run the report select {{man button|Apply}} and the results will be displayed in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Event_Comparison_Results_dialog|Event Comparison Results]]}} dialog.

{{-}}

=====Event Comparison Results dialog=====
From the {{man label|Event Comparison Results}} dialog you can view the results or {{man button|Save As}} the resulting table as a spreadsheet (ODS format). Select {{man button|Close}} to exit the report.
{{-}}
[[File:CompareIndividualEvents-EventComparisonResults-dialog-expanded-example-60.png|center|thumb|800px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event Comparison Results" - dialog - expanded example]]

The spreadsheet (ODS format) shows the following output fields:
* <code>Person, ID, Birth Date, Birth Place, Death Date, Death Place, LVG Date, LVG Place, Burial Date, Burial Place, Marriage Date, Marriage Place</code> 

{{-}}

===Family Tree Processing===

This section contains tools which may modify your database. The tools from this section are used mostly for finding and correcting errors in the data. The following Family Tree Processing tools are currently available in Gramps:

* [[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Extract_Event_Description|Extract Event Description]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Extract_Information_from_Names|Extract Information from Names]]
* [[Addon:Extract_Place_Data_from_a_Place_Title|Extract Place Data from a Place Title]] - '''This tool was moved to [[Third-party_Addons|Third-party addons]]'''
* [[Gramps_6.0_Wiki_Manual_-_Tools#Find_Possible_Duplicate_People|Find Possible Duplicate People]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Fix_Capitalization_of_Family_Names|Fix Capitalization of Family Names]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Merge_citations|Merge citations]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rename_Event_Types|Rename Event Types]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Sort_Events|Sort Events]]

{{man note|Family Tree Processing tools will only perform modifications upon your explicit consent|Except for the automatic fixes performed by {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair Database]]}} tool in the '''Family Tree Repair''' menu.}}

====Edit Database Owner Information====

[[File:DatabaseOwnerEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Database Owner Editor" - dialog - default]]

The {{man label|Edit Database Owner Information}} tool modifies any existing [[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher Information]].

Select the menu {{man menu|Tools->Family Tree Processing->Edit Database Owner Information...}}. This brings up the {{man label|Database Owner Editor}} window, where you can fill in the needed information or use one of the buttons to retrieve existing information.

*{{man label|Name:}}
*{{man label|Street:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

This information is family tree specific and will be used when exporting your data in GEDCOM format.

Two button choices are available:
* {{man button|Copy from DB to Preferences}} - to the '''Researcher''' section.
* {{man button|Copy from Preferences to DB}} - from the '''Researcher''' section.

{{new|6.0 - [https://github.com/gramps-project/gramps/pull/1660 Use regular buttons to copy owner information from/to preferences]}}
{{-}}

====Extract Event Description====

{{man note|The name format in the Event's Description field depends on|the defined name format in {{man menu|Edit->Preferences->Data> Display Options (section) ->}}{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Name format:]]}} }}



Extracts event descriptions from the event data by using a model :

<code>{event type} of {Surname}, {Given name}</code>

If event description is missing, then tool will use this event description field model.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Event Description...}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

Once you {{man button|Proceed with the tool}} this tool will scan and modify your Family Tree and if not present show you the {{man label|No modifications made}} alert otherwise if present you with the:

=====Modifications made result window=====
[[File:ExtractEventDescription-ModificationsMade-window-example-60.png|right|thumb|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Extract Event Description's - "Modifications Made" - window - example result]]

{{man label|Modifications made}} result window listing the total number of event descriptions that have been added.
{{-}}

====Extract Information from Names====

This tool searches the entire database and attempts to extract titles and nicknames that may be embedded in a person's {{man label|Given name}} field. If any information could be extracted, the candidates for fixing will be presented in the table. You may then decide which to repair as suggested and which not to.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Information from Names....}}

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Default_prefix_and_connector_settings_dialog|Default prefix and connector settings]]}} dialog will be shown and you can modify each of the options as required and once you have finished select {{man button|OK}} to start the tool.
{{-}}

Once the tool finishes either the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#No_modifications_made_dialog|No modifications made]]}} dialog will be shown as ''No titles, nicknames or prefixes were found'' or the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Name_and_title_extraction_tool_window|Name and title extraction tool]]}} window will be shown with results of the search.
{{-}}

=====Default prefix and connector settings dialog=====
[[File:ExtractInformationFromNames-DefaultPrefixAndConnectorSettings-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Default prefix and connector settings" - dialog for the "Extract Information from Names" Tool]]

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Default_prefix_and_connector_settings_dialog|Default prefix and connector settings]]}} dialog you can modify each of the options as required:
* {{man label|Prefixes to search for:}} <code>de, van, von, di, le, du, dela, della, des, vande, ten, da, af, den, das, dello, del, en, ein, elet, les, lo, los, un, um, una, uno, der, ter, te, die</code> (default)
* {{man label|Connectors splitting surnames:}} <code>e, y</code> (default)
* {{man label|Connectors not splitting surnames:}} <code>de, van</code> (default)
{{-}}

=====No modifications made dialog=====
[[File:ExtractInformationFromNames-NoModificationsMade-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "No modifications made" - dialog for the "Extract Information from Names" Tool]]

Shown when ''No titles, nicknames or prefixes were found'' in the selected family tree.

Select {{man button|Close}} to dismiss the dialog.

{{-}}

=====Name and title extraction tool window=====
The top section shows information about the tool.
{{man note|Below is a list of the nicknames, titles, prefixes and compound surnames that Gramps can extract from the Family Tree.
If you accept the changes, Gramps will modify the entries that have been selected.

Compound surnames are shown as lists of [prefix, surname, connector].

For example, with the defaults, the name "de Mascarenhas da Silva e Lencastre" shows as:

[de, Mascarenhas]-[da, Silva, e]-[,Lencastre]

Run this tool several times to correct names that have multiple information that can be extracted.}}

[[File:ExtractInformationFromNames-NameAndTitleExtractionTool-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Name and title extraction tool" - dialog results window for the "Extract Information from Names" Tool]]

The bottom section displays the results list in a table with the following columns: <code>Select</code>, <code>ID</code>, <code>Type</code>, <code>Value</code>, <code>Current Name</code>

You can un-<code>Select</code> the results you don't want and then {{man button|Accept and close}} to apply those results to your family tree or {{man button|Cancel}} to do nothing. The {{man button|Help}} button brings you to this tools help section.
{{-}}

====Extract Place Data from a Place Title====

{{man warn|This tool was moved to [[Third-party_Addons|Third-party addons]].|When the Place Hierarchy was first added to Gramps, every user needed a tool to [[Addon:Extract Place Data from a Place Title]]. Now that that a Hierarchy of Places is well established, the tool is needed infrequently. So installation has been made optional.}}

====Find Possible Duplicate People====

[[File:FindPossibleDuplicatePeople-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find Possible Duplicate People - dialog - default]]

The '''Find Possible Duplicate People''' tool searches the entire Tree database, looking for the entries that may represent the same person.

You can access this tool via the menu {{man menu|Tool -> Family Tree Processing -> Find Possible Duplicate People...}}.

The {{man label|Find Possible Duplicate People}} dialog will be shown and you can adjust the following options:
*{{man label|Match Threshold}} : choose between '''Low''' (default), ''Medium'' and ''High'' from the drop down menu.
{{man note|How is the quality of match measured?|2=This calculates the chances (or 'odds') of matching on a quality scale labeled as low, medium and high. For each piece of information that corresponds, the quality of the match is considered to be marginally increased. The closer the particular pieces of data correlate, the larger the increase. When the chance is greater than the selected '''Match Threshold''' then a match will reported. The thresholds are Low=0.25, Medium=1.0 and High=2.0. So, with the filtering threshold set to High, fewer matches are expected.}}

{{man label|Options}}
*{{checkbox|1}} {{man label|Use [[Gramps_6.0_Wiki_Manual_-_Gramplets#SoundEx_Gramplet|soundex]] codes}} for matching possible duplicate people. (checkbox checked by default)

The following buttons are present: {{man button|Help}} brings you to this page, {{man button|Cancel}} to stop processing and an {{man button|OK}} button to start processing the data.

Select {{man button|OK}} to start the tool and the data will be processed in two passes.

*Pass 1: Building preliminary lists
*Pass 2: Calculating potential matches.

A progress bar will be shown and depending the speed of your computer and the amount of people in the database this can take some time.

{{-}}

=====Potential Merges=====
[[File:FindPossibleDuplicatePeople-PotentialMerges-result-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Potential Merges" result dialog window for "Find Possible Duplicate People" - dialog - example]]

Once the report finishes a {{man label|Potential Merges}} result list window is presented with the following columns shown:
*<code>Rating</code> : this gives you an idea of the resemblance between the two people. The higher the ranking, the higher the chance that the people are duplicates.
*<code>First Person</code>
*<code>Second Person</code>

You can either double-click on the selected row or select the {{man button|Compare}} button to check the details.

Three buttons are present: {{man button|Help}} brings you to this page, a {{man button|Close}} to close the window which returns you to the {{man label|Find Possible Duplicate People}} window and a {{man button|Compare}} button to which brings up the {{man label|Merge People}} window which was explained in detail in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_People|Merge People]]}} dialog. Here you can select with the radio buttons one of the persons and eventually use the {{man button|OK}} button to merge the data if you find the two persons are duplicates.

Selecting the {{man button|Cancel}} button brings you back to the {{man label|Potential Merges}} result list window.
{{-}}

====Fix Capitalization of Family Names====

This tool searches the entire database and attempts to fix the capitalization of family names.

The aim is to have conventional capitalization: capital first letter and lower case for the rest of the family name. If deviations from this rule are detected, the candidates for fixing will be presented in the table.

You may then decide which to repair as suggested and which not to.

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Fix Capitalization of Family Names...}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{-}}
[[File:FixCapitalizationofFamilyNames-CapitalizationChanges-dialog-results-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Capitalization changes" - dialog - results example for "Fix Capitalization of Family Names" tool]]

If there where changes to the capitalization of any names you will be presented with the {{man label|Capitalization changes}} results window. The window shows a list of the family names that Gramps can convert to (according to Gramps) correct capitalization (please check that it is correct for you.). In the {{man label|Capitalization changes}} results window list the following columns are available:
*{{checkbox|1}} {{man label|Select}} - Check or uncheck these on a "by name" basis if you choose not to accept the recommendation (checkbox checked by default)
* {{man label|Original Name}} - The name as currently recorded.
* {{man label|Capitalization Change}} - The name with change if applied.

Select the names you want to be changed, then select the {{man button|Accept changes and close}} button. Or use the {{man button|Cancel}} button to abort changes.
{{-}}

You can also install the "[[Addon:Fix Capitalization of Given Names]]" tool Addon that once installed works almost identically to this tool but works for "Given Names"
{{-}}

====Merge citations====

{{man tip|The {{man label|Merge Citations}} tool|works by combining notes, media objects and data-items of matching citations.}}

You can select this via menu {{man menu|Tools > Family Tree Processing > Merge Citations...}} .

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.
{{-}}
[[File:MergeCitations-dialog-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Merge Citations" - dialog - default]]

Then the {{man label|Merge Citations}} dialog (Title of dialog shows:''Notes, media objects and data-items of matching citations will be combined.'')will be shown

The following options are available:
* {{man label|Match Threshold}} drop down list:
** Match on Page/Volume, Date and Confidence
** '''Ignore Date''' (default)
** Ignore Confidence
** Ignore Date and Confidence
* {{man label|Options}}
** {{checkbox|0}} {{man label|Don't merge if citation has notes}} (checkbox unchecked by default)

{{-}}
[[File:NumberOfMergesDone-dialog-result-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Number of merges done" result dialog for "Merge Citations" - dialog - Tool - example]]

Select {{man button|OK}} to run the tool and once complete it will report back the total with the {{man label|Number of merges done}} result dialog.
{{-}}
See also the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Citations|Merge Citations]] option available from the Citations Category list view
{{-}}

====Rename Event Types====

This tool will rename all events of one type to a different type.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Rename Event Types....}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}

{{-}}
[[File:RenameEventTypes-Tool-ChangeEventTypes-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Change Event Types" - dialog - example for "Rename Event Types" Tool]]

The {{man label|Change Event Types}} dialog is presented.

* {{man label|Original event type}}: fill in the text field or use the drop down menu and select an original event type
* {{man label|New event type}}: fill in the text field (you can create a complete new type here) or use the drop down menu and select a new type

The example shows a renaming of the '''Birth''' event to a '''Baptism''' event.

{{man note|Custom types|While the custom types do not show in the drop down list, you can over type or paste into either of the selection boxes and convert from one to another.}}

{{-}}
[[File:RenameEventTypes-Tool-ChangeTypes-result-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Change types" - result dialog - example for "Rename Event Types" Tool]]

Finally use the {{man button|Cancel}} to exit or select {{man button|OK}} to run the tool and once complete it will report back the total events modified with the {{man label|Change types}} result dialog.
{{-}}

{{man warn|1=Renaming events|2=Once completed, this cannot be undone by the regular {{man label|Undo}} function.}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Editing information about events]]


====Reorder Gramps IDs====

This tool can be used to reorder your Gramps object IDs.

[[File:ReorderGrampsIDs-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" tool window - example]]

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Reorder Gramps IDs...}}.

Initialy the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}}''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

Then the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_tool_window|Reorder Gramps IDs]]}} tool window will be shown where you can modify the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_tool_window|column options]] as needed then select {{man button|OK}} to start the process.

The tool will then show various progress dialogs during the different progress stages; as the following object IDs' are reordered: 'Reordering People IDs', 'Reordering Family IDs', 'Reordering Event IDs', 'Reordering Place IDs', 'Reordering Source IDs', 'Reordering Citation IDs', 'Reordering Repository IDs', 'Reordering Media Object IDs' and finally 'Reordering Note IDs'.

In the final step 'unused IDs' are searched for and assigned.

During this process the tool will examine each ID to see if it looks like it has been 'customized', if it doesn't look like the previous object ID format or the default object ID format. This might be the case if the user has manually entered their own text in the ID field for the object when editing it. It might also occur if the third-party [[Addon:GeoName|GeoName Addon]] has been used or the [[Addon:GetGOV|GetGOV Addon]] that stores the '''GOV ID''' in the Place ID field. If a ''customized'' ID is found, the tool will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_replace_dialog|Reorder Gramps IDs]]}} replace dialog that ask the user if they really wants to replace the ID and also optionally allows the user to use the same answer for same found customized object IDs.

{{man warn|Custom IDs'|If you customized your object IDs', all those can be replaced by this tool. So take care by backing up before you use this tool!}}

=====Reorder Gramps IDs tool window=====
[[File:ReorderGrampsIDs-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" tool window - default on new empty family tree]]

The {{man label|Reorder Gramps IDs}} tool window shows each of Gramps objects (Person, Family, Event, Place, Source, Citation, Repository, Media, Note) and the following option columns (<code>Object</code>, '<code>Actual</code>, <code>Quantity</code>, <code>Format</code>, <code>Change</code>, <code>Start</code>, <code>Stop</code>, <code>Keep</code>) that can be applied to changing the object ID's.

The {{man button|Help}} button will show this section. The {{man button|Cancel}} button will exit the tool. The {{man button|Ok}} start the tool.

Most of the column labels also double as hidden toggles buttons and perform various actions as described below.

;<code>Object</code>:This column lists the type of Gramps ID. Immediately to the left of this column are checkboxes that allow the enabling of changes to individual object types. When checked, the type can be reordered. The {{man button|Object}} label is actually a hidden button that can be used to toggle all of the checkboxes at once.

;<code>Actual</code>:This column shows an example of the current objects ID.

;<code>Quantity</code>:This column show the current number of objects in the family tree.

;<code>Format</code>:This column can be used to change the ID format for each object type. Note that the default ID formats consists of a one letter prefix (I, F, E, P, S, C, R, O, N) representing each of the objects, and then a suffix '<code>%04d</code>'. There '''MUST''' be at least a prefix or a suffix, both are allowed. It is recommended to keep these relatively short. The '<code>%04d</code>' defines the length of the numeric portion of the ID, the '<code>4</code>' can be changed, anything from '<code>3</code>' (allowing numbers from 000-999) to '<code>9</code>' (000000000-999999999) is allowed (''If your family tree needs more than "nine hundred ninety-nine million, nine hundred ninety-nine thousand, nine hundred ninety-nine" please raise a feature request!''). Changes made here are the same as made in the menu {{man menu|Edit->Preferences...}} and then select the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}''' tab. The '{{man button|Format}}' label is actually a hidden button that can be used to ''reset'' all the formats to the last used value.

;<code>Change</code>:This column contains checkboxes for each object type. When checked, the IDs for that object will be replaced with new IDs of the <code>Format</code> style, unless <code>Keep</code> is also checked. If there is no checkmark, the ID formats are ''NOT'' updated, but the number field within the format is renumbered. The {{man button|Change}} label is actually a hidden button that can be used to toggle all of the check boxes at once.

;<code>Start</code>:This field indicates the starting number used during the renumber operation. The {{man button|Start}} label is actually a hidden button that can be used to toggle between start at <code>0</code>, and start after last current number.

;<code>Step</code>:This field indicates the interval between numbers during the renumber, <code>1</code> is a simple increment, <code>2</code> will increment by 2 etc. The {{man button|Step}} label is actually a hidden button that can be used to toggle between <code>1</code>, <code>2</code>, <code>5</code>, and <code>10</code>.

;<code>Keep</code>:This column contains check boxes for each object type. If both the <code>Keep</code> and <code>Change</code> check boxes are checked, the ID formats for that object will be retained, and the number field within the format is renumbered. The {{man button|Keep}} label is actually a hidden button that can be used to toggle all of the check boxes at once.

=====Reorder Gramps IDs replace dialog=====
[[File:ReorderGrampsIDs-replace-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" replace dialog - example]]

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_dialog|Reorder Gramps IDs]]}} replace dialog that ask the user if they really wants to replace the ID and also optionally allows the user to use the same answer for same found customized object IDs.

* {{man label|[ ] Use this answer for the rest of the items}}

Select {{man button|Yes}} or {{man button|No}}.
{{-}}

====Sort Events====

Events appearing on the Event tab on a ''Person'' or ''Family Editor'' are not sorted in any particular order other than the order that the events were added. The reason for not enforcing any particular ordering, particularly ordering by date, is to allow for the situation where an event was known to have happened but the exact chronology is not. Importing or merging data from an external source can lead to extra events being added to, but out of sequence with, the existing set of events of a person or family.

Events can be manually re-ordered by [http://en.wikipedia.org/wiki/Drag-and-drop ''drag & drop''] or by use of the re-order buttons on the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Events]]}} tab. Either way, an event can be moved up or down in the list of events and Gramps will remember the new order when the changes are saved. The new ordering will be used wherever events are shown elsewhere in Gramps, such as on a report.

The order of all events on a tab can also be changed by clicking a column title. For example, clicking the <code>Date</code> column header will sort all the events in date order. However this way of sorting events is temporary and changes to the event order are not preserved when the window is closed.

The [http://en.wikipedia.org/wiki/Drag-and-drop ''drag and drop''] approach to sorting events is fine for moving a small number of events but is not practical for large scale changes. The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Sort_Events_tool|Sort Events tool]]}} has been designed specifically for this purpose, re-sorting all events in the database or just those associated with a targeted selection of people chosen by using a filter.

=====Sort Events tool=====

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Sort events...}}.

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}

{{-}}
======Tool Options tab ======
[[File:SortEvents-dialog-ToolOptions-tab-default-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Sort Events" Tool - dialog - showing "Tool Options" tab]]

On the {{man label|Tool Options}} tab for the {{man label|Sort Events}} dialog window the first option is used to define the range of people who's events are to be sorted. The first choice in the list is to apply the sorting to all people in the database. Alternative choices are to apply sorting to ancestors and descendants of a chosen person or to a range of people selected by a custom built person filter. After choosing who the sort should apply to, the next thing to consider is how the events should be sorted. The first option is to sort by date. This is probably the most likely choice, but other event attributes can be chosen too. The final choices are whether to make the events sorted ascending or descending and whether to apply the sort to family events that the selected people belong to as well.

{{stub}}

{{-}}
{{man warn|1=Sorting events|2=Once completed, this cannot be undone by the regular {{man label|Undo}} function.}}

=== Family Tree Repair ===

The following Family Tree Repair tools are available:

* [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Gender_Statistics|Rebuild Gender Statistics]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Reference_Maps|Rebuild Reference Maps]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Secondary_Indexes|Rebuild Secondary Indexes]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Remove_Unused_Objects|Remove Unused Objects]]



====Check and Repair Database====

{{man warn|Warning: The {{man label|Check and repair Database}} tool performs automatic fixes.|Once completed, this cannot be undone by the regular {{man label|[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_Undo_History|Undo History]]}} function.}}

The {{man label|Check and repair Database}} tool checks the selected database/Family Tree for integrity problems, fixing the problems it can. Specifically, the tool is checking for:

*Broken family links. These are the cases when a person's record refers to a family while the family's record does not refer to that person, and vice versa.

*Missing media objects. The missing media object is the object whose file is referenced in the database but does not exist. This can happen when the file is accidentally deleted, renamed, or moved to another location.

*Empty families. These are the family entries which have no reference to any person as their member.

*Parent relationship. This checks all families to ensure that father and mother are not mixed up. The check is also made that parents have different gender. If they have common gender then their relationship is renamed to "Partners".

You can use this tool via menu {{man menu|Tools->Family Tree Repair->Check and Repair Database...}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{-}}
=====Integrity Check Results dialog=====
[[File:IntegrityCheckResults-dialog-CheckAndRepairDatabase-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Integrity Check Results" - example result dialog - for the "Check and Repair Database" tool]]

Any issues found are automatically fixed and the {{man label|Integrity Check Results}} dialog will be shown with a summary actions taken.
{{-}}
=====No errors were found dialog=====
Otherwise you will see the {{man label|No errors were found}} dialog stating that ''The database has passed internal checks''.
{{-}}
=====Gramps had a problem the last time it was run - dialog=====
[[File:GrampsHadAProblemTheLastTimeItWasRun-dialog-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps had a problem the last time it was run - dialog ]]

After Gramps crashes [https://github.com/gramps-project/gramps/pull/778 on restart, Gramps will offer to run Check & Repair] tool. (Introduced in Gramps 5.1.x)

{{-}}

====Rebuild Gender Statistics====

[[File:GenderStatisticsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender statistics rebuilt" - result dialog for "Rebuild Gender Statistics" tool]]

Rebuilds gender statistics for name gender guessing based on the accumulated statistics of genders for given names within the tree. If a gender is common to more than half the in the Tree with a particular first word in their Given name, then Gramps will guess that Gender for that name will be the same.

The statistics can also be cleared (if the {{man menu|Tools ➡ [[Gramps_6.0_Wiki_Manual_-_Tools#Debug|Debug]]}} menu has been enabled) with the [[Gramps_6.0_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics]] Tool.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Gender Statistics...}}.

Once completed the {{man label|Gender statistics rebuilt}} result dialog will be shown.

{{man warn|Rebuild Gender Statistics needed after converting database|Issue {{bug|11314}} notes that gender statistics are swapped after database conversion to SQLite. If your gender guessing is suggesting the opposite gender for particular given names, use the Rebuilt Gender Statistics tool to fix the guessing.}}

See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.

{{-}}

====Rebuild Reference Maps====

[[File:ReferenceMapsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reference maps rebuilt" - result dialog for "Rebuild Reference Maps" tool]]

This tool rebuilds reference map tables. This drives the list of ''References'' items in editors.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Reference Maps...}}.

Once completed the {{man label|Reference maps rebuilt}} result dialog will be shown.
=====See also=====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}

====Rebuild Secondary Indexes====

[[File:SecondaryIndexesRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Secondary indexes rebuilt" - result dialog for "Rebuild Secondary Indexes" tool]]

This tool rebuilds secondary indices.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Secondary Indexes...}}.

Once completed the {{man label|Secondary indexes rebuilt}} result dialog will be shown.

The {{man menu|Rebuild Secondary indexes...}} re-constructs the secondary tables in the Tree db. These tables include things like gender statistics (Given Name versus gender) to allow guessing the gender of names as they are entered, surnames (for faster lookup of possible surname and to make the person tree view work), the various IDs for objects (to facilitate lookup by ID), place enclosure tables, to make the place tree view work, and a few others.

In theory, these tables are kept constantly up-to-date when anything changes. So rebuilding the Reference Maps and Secondary Indices should not be necessary. But, especially early on in the Gramps history, bugs sometimes interfered with updates completing correctly. So the tools remain available... ‘just in case’.
=====See also=====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}

====Remove Unused Objects====

This tool will search your database for pieces of information which are not connected to anything else, and then allow you to edit and attach the information or remove them.

You can use this tool via menu {{man menu|Tools->Family Tree Repair->Remove Unused Objects...}}.

{{-}}
[[File:UnusedObjects-dialog-example-results-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Unused Objects" - dialog example results for "Remove Unused Objects" tool]]

The {{man label|Unused Objects}} dialog is presented.

You can choose from the search option you want to use from the top section of the {{man label|Unused Objects}} dialog:
*{{checkbox|1}} {{man label|Search for events}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for sources}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for citations}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for places}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for media}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for repositories}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for notes}} (checkbox checked by default)

Select the {{man button|Find}} button to run the tool, and once completed the results if any will show in the bottom section of the {{man label|Unused Objects}} dialog with the following columns shown:
* {{man label|Mark}} Select the row if you want to delete the object (unchecked by default)
* {{man label|}} - Icon representing the type of object.
* {{man label|ID}} - Gramps internal name for the object.
* {{man label|Name}} - of the object.

To examine the object you must double-click on the row and it will show the appropriate editor for the object allowing you to edit if required.

{{man label|Mark}} the objects you want to delete either using the individual checkboxes or using the associated buttons:
* {{man button|Mark all}}
* {{man button|Unmark all}}
* {{man button|Invert marks}}

Once your deletion choices have been made select the {{man button|Delete}} button to delete the objects.

When finished you may then use the {{man button|Close}} button to exit the tool.
{{-}}
{{man note|Multiple runs of the Remove Unused Objects tool maybe needed in order to actually clean the database.

See {{bug|3249}}
}}

=== Utilities ===

This section contains tools allowing you to perform a simple operation on a portion of data. The results can be saved in your database, but they will not modify your existing data. The following utilities are currently available in Gramps:
* [[Gramps_6.0_Wiki_Manual_-_Tools#Clean_input_data|Clean input data]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Find_database_loop|Find database loop]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|Media Manager]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Not_Related|Not Related]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Verify_the_Data|Verify the Data]]

====Clean input data====

====Remove leading and trailing spaces====

[[File:CleanInputData-dialog-tool-example-dialog-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clean input data]]
Tool to clean leading and trailing spaces from imported or old data. The tool searches for place names with leading or/and trailing spaces. It also looks in the first name and surname.

Leading and trailing spaces are automatically removed during name data being committed to the tree.

The tool can be triggered from the menu {{man menu|Tools > Utilities > Clean input data...}} or Tools selector dialog

See also:
* Avoid invalid characters and leading or trailing spaces in the entry field - (added in Gramps [[Template:Releases/5.0.2|5.0.2]] with [https://github.com/gramps-project/gramps/pull/811 PR811])
* [https://github.com/gramps-project/gramps/pull/783 New tool to suppress leading and trailing spaces.] - (added in Gramps [[Template:Releases/5.1.0|5.1.0]])
* Feature request {{bug|4566}} : Please remove trailing spaces on items on input (2016)
* Feature request {{bug|4619}} : Trailing blanks are removed from queries in the preset filters (2011)

{{-}}

====Find database loop====

[[File:FindDatabaseLoop-example-PedigreeChartView-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree chart showing loop - example]]

The {{man label|Find database loop}} utility allows you to verify if you have ancestral loops in the database. Loops in your family tree may for example show a person as both the child and ancestor of another person in Family Tree. Loops can happen accidentally during data entry, for example, when a son is linked into the family tree as his own grandfather!

Other valid loops also happen and should be kept in the family tree if verified:
* An inbreeding loop because the parents are related.
* A mating loop caused by a male who has children to genetically related females.
* An incest mating loop caused by full siblings.
{{-}}
[[File:FindDatabaseLoop-dialog-example-results-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find database loop - dialog - results from example family tree case]]

Use the menu {{man menu|Tools->Utilities->Find database loop...}} and you will get a {{man label|Find database loop}} window that will display the results in a list with six columns: <code> </code> ''Loop Group unlabeled'' (<code>Gramps ID</code>, <code>Parent</code>), (<code>Gramps ID</code>, <code>Child</code>), <code>Family ID</code>.

* Loop Group unlabeled column - a number related to which loop the entries are about.
* First <code>Gramps ID</code> is a reference to the Parent.
* <code>Parent</code> (Ancestor on the image) is the person we are looking for a loop.
* Second <code>Gramps ID</code> is a reference to the Child.
* <code>Child</code> (Descendant) is the origin of the loop.
* <code>Family ID</code> is a reference to the associated family

Double clicking on a selection will open the related [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Families entry]].

To fix a pedigree loop in your family tree.
* Locate the person page of the individual whose relationship needs to be adjusted.
* First, verify that a name or vital event date was not accidentally entered incorrectly.
* If you are sure that deleting the incorrect parent-child relationship will fix the loop, proceed with the steps.

Once you have resolved any loops select {{man button|Close}} to exit.

{{-}}
To read more about ancestral loops see:
* [https://www.tamurajones.net/FindingAncestralLoops.xhtml Finding Ancestral Loops : Modern Software Experience]
* [http://www.beholdgenealogy.com/blog/?p=1309 Ancestral Loops : Louis Kessler's Behold Blog]

Also see:
* [https://wikipedia.org/wiki/Endogamy Endogamy] - From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Cousin_marriage Cousin marriage] - From Wikipedia, the free encyclopedia

=====Example ancestral loops=====

{{stub}}

[[File:FindDatabaseLoop-dialog-complex-example-results-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} chart showing complex example]]

In the following complex example, we have multiple ancestral loops indicated by the number in the first unlabeled column a "Loop Group" :

If we look at the second line, we have :
# First Gramps_ID : I0002
# Parent is : Father, Child2
# Second Gramps_ID : I0001
# Child is : Father, Father
# Family_ID is : F0000

{{-}}
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|600px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]

To understand what happens :
#we start at [I0002] Father, Child2.
#We continue with his son [I0003] Father, Child3.
#We continue with his son : [I0000] Child, Child.
#We continue with his son : [I0001] Father, Father.
#We continue with his son : [I0002] Father, Child2 ==> '''HERE, we have a ancestral loop'''.

{{-}}

====Media Manager====

{{stub}}

The {{man label|Gramps Media Manager}} is a group of four separate tools accessed via a wizard like dialog that you can access via the menu {{man menu|Tools->Utilities->Media Manager...}} which will show the first '''[[Gramps_6.0_Wiki_Manual_-_Tools#|Introduction]]''' dialog page.

=====Introduction=====

[[File:Introduction-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Introduction - page for "Gramps Media Manager" - Tool wizard]]

A brief information on the tools abilities is shown.

From the '''Introduction''' page selecting the {{man button|Next}} button (or using the keyboard shortcut {{man key press|Alt|N}}) you will be shown the '''[[Gramps_6.0_Wiki_Manual_-_Tools#Selection|Selection]]''' page window.

{{man note|Introduction|This tool allows [http://wikipedia.org/wiki/Batch_processing batch operations] on media objects stored in Gramps. An important distinction must be made between a Gramps media object and its file.

The Gramps media object is a collection of data about the media object file: its filename and/or path, its description, its ID, notes, source references, etc. These data '''do not include the file itself'''.

The files containing image, sound, video, etc. exist separately on your hard drive. These files are not managed by Gramps and are not included in the Gramps database. The Gramps database only stores the path and file names.

This tool allows you to only modify the records within your Gramps database. If you want to move or rename the files then you need to do it on your own, outside of Gramps. Then you can adjust the paths using this tool so that the media objects store the correct file locations.}}

{{-}}

=====Selection=====
[[File:Selection-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selection - page for "Gramps Media Manager" - Tool wizard - default]]

From the '''Selection''' page window select from one the four options the actions you want to take and then select the {{man button|Next}} button:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Replace_substrings_in_the_path|Replace substrings in the path]]}} (default)
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Add_images_not_included_in_database|Add images not included in database]]}}
{{-}}

=====Replace substrings in the path=====

[[File:ReplaceSubstringSettings-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Replace substring settings - page for "Gramps Media Manager" - Tool wizard - default]]

This tool allows replacing specified substring in the path of media objects with another substring. This can be useful when you move your media files from one directory to another.

Selecting this radio button will bring up a {{man label|Replace substring settings}} window where you can type in any string in the {{man label|Replace}} text field and the {{man label|With}} text field. At any time you can click on the {{man button|Cancel}} button or the {{man button|Back}} button. Clicking the {{man button|Forward}} button will bring up the {{man label|Final confirmation}} window.

{{-}}

=====Convert paths from relative to absolute=====
[[File:ConvertPathsFromRelativeToAbsolute-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from relative to absolute':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

This tool allows converting relative media paths to the absolute ones. It does this by prepending the {{man label|Base media path:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section, or if that is not set, it prepends the default [[Gramps_6.0_Wiki_Manual_-_User_Directory|User's Directory]].

* [https://wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}

=====Convert paths from absolute to relative=====
[[File:ConvertPathsFromAbsoluteToRelative-FinalConfirmation-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from absolute to relative':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

This tool allows converting absolute media paths to a relative path. The relative path is relative to the given base path in the setting {{man label|Base media path:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section, or if that is not set, the user's directory is used. A relative path connects the file location to the base media path that can be changed according to your needs.

* [https://en.wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}

=====Add images not included in database=====

[[File:AddImagesNotIncludedInDatabase-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Add images not included in database':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

Check directories for images not included in database, this tool adds images in directories that are referenced by existing images in the database. You will have to import one media item from each sub directory manually. Media Manager does not include sub-directories automatically. All the directory paths shown in the tool will be searched through.
{{-}}

====Not Related====

[[File:NotRelatedTo-dialog-NotRelated-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}. "Not related to '...'" - dialog - showing results for "Not Related" Tool]]

This tool will list people who are not connected to the selected active person. Connections may include linked in a chain of [[References|references]] or linkages created with the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Link_Editor|link editor in Notes]].

You can use this tool via menu {{man menu|Tools->Utilities->Not Related...}}.

You will get a {{man label|Not related to '...'}} results dialog which shows a list of all the people that are '''NOT''' related to the selected person.

This list gives you:
* ''Name''
* ''ID''
* ''Parents''
* ''Tags''

From the ''Name'' column you can use the {{man button|▶ right arrow}} button and {{man button|↓ down arrow}} buttons to collapse or expand the grouped ''Name'' list. Double clicking on a person will bring up the {{man label|person edit}} dialog or {{man label|family edit}} dialog.

If you select a person, you can use the {{man label|Tag}} text field (you can fill in whatever custom tag name you want to use) or use the drop down list to choose an existing tag eg TODO, NotRelated. Use the {{man button|Apply}} to add the selected tag to the person(s). This tag will then show up in the ''Tags'' column.
{{-}}

====Relationship Calculator====

[[File:RelationshipTo-dialog-RelationshipCalculator-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Relationship to '...' " - dialog - showing results for "Relationship Calculator" Tool]]
You can use this tool via menu {{man menu|Tools ➡ Utilities ▶ Relationship Calculator...}}.

Selecting the Relationship Calculator tool will open a list filtered to all people connected, '''but not necessarily related''', to the [[Gramps_Glossary#active_person|Active Person]]. To calculate relationship to different person, close the window, make that person Active and select the tool from the menu again.

Select the individual from the filtered list to report if a relationship exists. The exact relationship will be shown in the lower panel... along with the common ancestors in that relationship. Only blood relationships will display (except for husband-wife and step relationships). Note that "in-law" relationships are not displayed.

The filtered list will grouped and alphabetically sorted by surname. (Regardless of whether the View menu setting of the Person category has been set to '''Grouped'''.) The list columns cannot be re-sorted.

The degree of separation (generation distance) that will be recognized is controlled by the {{man label|Max generations for relationships}} value in the [[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]] tab under the {{man menu|Edit ➡ Preferences...}} menu. Moved from the [[Gramps_5.1_Wiki_Manual_-_Settings#General|5.1 General]] tab {{New|5.2}} (The default of 15 generations will report a 12th great-grandparent relationship but not the 13th great-grandparents. The active person is counted as one of the generations. So, self generation plus parent plus grandparents are the other 3 generations.)

Essentially, any two people are directly related by blood if they have an ancestor in common. One of these individuals may actually be an ancestor of the other - such as a great grandparent. Even in the cases of aunts and uncles, you still can calculate the relationship by searching for the common ancestor. In this case, the father or mother of the aunt or uncle will be a grandparent to the nephew or niece.

The most basic blood relationship through common ancestors is that of siblings (brothers and sisters) who are only one generation down from the common ancestor. Another special relationship is that of one of those siblings to the descendants of the other siblings. If the Active Person is a grandchild of the common ancestor, the sibling would be an aunt or uncle. Beyond that generation of descendants, there are two equivalent ways of describing the relationship. The daughter of great grandparents might be called either a grandaunt or a great aunt. (The Relationship Calculator uses the 'grand' variant.) That person is a great grandaunt to the second great grandchildren, who are four generations distant from the common ancestor. (She may also be called a second great aunt.) The reverse relationship of an aunt or uncle is a nephew or niece.

Cousins (also called "first" cousins) are two generations down from the common ancestor through different siblings. "Second" cousins are thus, three generations down from the common ancestor - and so on.

After that, everyone is considered a "cousin", but to indicate that they are not in the same generation we use the word "removed" to indicate the number of generations different between the two. For example, my father's "first" cousin is also my "first" cousin but "once removed" (one generation difference between us). My fathers "first" cousin is my own child's "first cousin twice removed" - two generations different.

If multiple blood relationships exist due to pedigree Collapse, all will be reported.

A full text list of all blood relations and their spouses can be viewed using a [[Gramps 6.0 Wiki Manual - Reports - part 6#Kinship Report|Kinship Report]].

=====See also:=====

* The '''Relationship to home person''' [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar
* '''Relation to Home Person''' [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].
* The '''[[Addon:Deep_Connections_Gramplet|Deep Connections]]''' gramplet: If this third party addon is installed, it will list the intervening generations through the sibling offspring of a common ancestor. (But it does not list the common ancestor or if both person a connected through the same spouse.) The Gramplet also details the indirect relationships.
* [[Specification:Relationship Calculator|Relationship Calculator Localization]] - create meaningful relation descriptions in your region.
{{-}}

====Verify the Data====
{{man tip|Verify the Data tool enhanced{{new|5.2}}|Tool performance improved, results reorganized into a Tree rather than a flat list, additional tests. 8 New rules ([[Gramps_6.0_Wiki_Manual_-_Tools#Data_Verification_Results_window|marked below]]) to find additional irregularities.
}}

[[File:VerifyTheData-DataVerifyTool-dialog-General-tab-defaults-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Verify the Data..." - "Data Verify tool" dialog - "General" tab - defaults]]

This utility allows you to verify the database based on the set of criteria specified by you.

For example, you may want to make sure that nobody in your database had children at the age of 98. Based on common sense, such a record would indicate an error. However, it is not a consistency error in the database. Besides, someone might have a child at the age of 98 (although this rarely happens). The Verify tool will display everything that violates your criteria so that you can check whether the record is erroneous or not. The ultimate decision is yours.

Select this via the menu {{man menu|Tools->Utilities->Verify the Data...}} you will get a {{man label|Data Verify Tool}} window. The window has four tabs; {{man label|General}}, {{man label|Women}}, {{man label|Men}}, {{man label|Families}}. Those tabs show a list with criteria and a input field where you can alter the criteria value. In the lists below I show some ''workable'' values.

=====Verify the Data tab pages=====

Select the criteria you want to run the tool with from the following tabs. If you are OK with the criteria click the {{man button|Run}} button (or hit the {{man key press|Alt|R}} keybinding) and you will be presented with a {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Data_Verification_Results_window|Data Verification Results]]}} window.

======General======
* {{man label|Maximum age}}: <code>90</code>
* {{man label|Minimum age to marry}}: <code>17</code>
* {{man label|Maximum age to marry}}: <code>50</code>
* {{man label|Maximum number of spouses for a person}}: <code>3</code>
* {{man label|Maximum number of consecutive years of widowhood before next marriage}}: <code>30</code>
* {{man label|Maximum age for an unmarried person}}: <code>99</code>

The first check box: {{man label|Estimate missing or inexact dates}} causes the tool to accept a baptism date if a birth date is not known, and to accept a burial date if a death date is not known. It also causes the tool to accept "inexact" dates (i.e., any "legal" Gramps date which is not a fully-specified one (with an explicit day and month and year)).

The second check box: {{man label|Identify invalid dates}} will check if the dates are invalid.

======Women======
* {{man label|Minimum age to bear a child}}: <code>17</code>
* {{man label|Maximum age to bear a child}}: <code>48</code>
* {{man label|Maximum number of children}}: <code>12</code>

======Men======
* {{man label|Minimum age to father a child}}: <code>18</code>
* {{man label|Maximum age to father a child}}: <code>65</code>
* {{man label|Maximum number of children}}: <code>15</code>

======Families======
* {{man label|Maximum husband-wife age difference}}: <code>30</code>
* {{man label|Maximum number of years between children}}: <code>8</code>
* {{man label|Maximum span of years for all children}}: <code>25</code>
{{-}}

=====Data Verification Results window=====

[[File:DataVerificationResults-window-example-52.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Data Verification Results window.]]

After you run the tool you will be presented with the {{man label|Data Verification Results}} window.

Depending on your criteria and your data, a list will be shown. The possibilities of findings are listed below. (But others may be added.) Each match will be grouped with similar findings.

* Baptism before birth
* '''Baptism too late according to family tradition'''
: This rule determines the median of days between birth and baptism over all children of a family. It then compares the days between the birth and the baptism of the person in question with also allowing some grace period of deviation. Currently, that grace period is hard-coded with 120 days.
* Birth equals death
* Birth equals marriage
* Burial before baptism
* Burial before birth
* Burial before death
* '''Burial too late'''
: A Burial is considered “too late” when its more than 14 days after the date of death. Should this be a parameter or might this confuse the user?
* '''Children are not in chronological order'''
: Birth dates (if no date exists and estimation is on, Baptism dates are used) are checked for each child of a family. Verifies that dates ascend through the list of children. Children without any of those dates are ignored
* Dead father
* Dead mother
* Death before baptism
* Death before birth
* Death equals marriage
* Disconnected individual
: ones with no parent or spouse or child or sibling
* Early marriage
: ( General tab, default = 17 )
* '''Families are not in chronological order'''
: This Rule uses the marriage date and evaluates that the families are ordered in a chronological order for a person. If no marriage date is available a divorce date or even the birth date of the oldes child of each family is used. The birth date as last possible fallback is used to account for non-married families with illegitimate children.
* '''Family events not ordered in chronological order'''
* '''Family has events with role Unknown'''
* Female husband
* Husband and wife with the same surname
* Invalid birth date
: ( General tab, default = True )
* Invalid death date
: ( General tab, default = True )
* Large age difference between spouses
: ( Families tab, default = 30 )
* Large age differences between children
: ( Families tab, default = 8 )
* '''Large year span for all children'''
: ( Families tab, default = 25 )
* Late marriage
: ( General tab, default = 50 )
* Male wife
* Marriage after death
* Marriage before birth
* Marriage date but not married
* Married often
: ( General tab, default = 3 )
* Multiple parents
* Old age at death
* Old age but no death
: ( General tab, default = 90 )
* Old and unmarried
: ( General tab, default = 50 )
* Old father
: ( Men tab, default = 65 )
* Old mother
: ( Women tab, default = 48 )
* '''Person events not in chronological order'''
* '''Person has events with role Unknown'''
* Same sex marriage
* Too many children
: ( Men tab, default = 15; Women tab, default = 12 )
* Unborn father
* Unborn mother
* Unknown gender
* Young father
: ( Men tab, default = 18 )
* Young mother
: ( Women tab, default = 17 )

On the bottom of the window four buttons are available to make a selection easier. Those are {{man button|Mark all}}, {{man button|Unmark all}}, {{man button|Invert marks}}, and {{man button|Hide marked}}.

Double-clicking on a row will give you a possibility to view and or edit the data.

With the {{man button|Close}} button (or select the keyboard shortcut {{man key press|Alt|C}}) you close the {{man label|Results}} window.
{{-}}

=====Examples=====
Two examples from using real data with this tool:

*:The warning showed 'female husband': checking the data I found a family with father : Anna Roelants. Luckily in the {{man label|Description}} I read: ''The marriage of Adam Roelants and Cornelia Crabbe''. It was clearly a typo: Anna i.s.o. Adam. Without this '''Tool''' it would be very hard to find.

*:The warning showed 'late marriage': checking the data: male person °1738 female person °1756 : marriage X 1804 [Gregorian Calendar] : Everything seemed to be OK: so they (re)married at the age of 66 and 48 years! The warning showed up because the '''General criteria''' was set to '''60'''.
=====See Also=====
* Development discussion on Gramps community support Discourse forum:
: [https://gramps.discourse.group/t/interest-in-enhancing-verify-py/4075/23 Interest in enhancing verify.py]
{{man tip|Difference between {{man label|Verify the Data}} tool and the [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database tool]] |The Check and Repair Database tool detects inconsistencies in the database structure. The {{man label|Verify the Data}} tool, however, is detecting the records that do not satisfy your particular criteria.}}
{{-}}

=== Debug ===

{{man warn|{{man menu|Warning do not use the '''Debug''' tools on your working Family Tree}}|{{man menu|Always create a new empty Family Tree or a copy of your existing Family Tree for testing.}} The tools available in this advanced menu are used for testing only.}}

[[File:MenuOverview-Tools-Debug-menu-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "{{man menu|Tools >Debug>...}}" Menubar - Tools - Debug menu Overview]]

When the command line: Python option <code>-O</code> ''optimise flag'' is not turned on, an additional {{man menu|Debug}} entry appears in the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Tools|Tools]]}} menu and the following tools are available:
* [[Gramps_6.0_Wiki_Manual_-_Tools#Check_Localized_Date_Displayer_and_Parser|Check Localized Date Displayer and Parser]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Generate_Testcases_for_Persons_and_Families|Generate Testcases for Persons and Families]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Populate_Sources_and_Citations|Populate Sources and Citations]]

Also See:
* [[Gramps_6.0 Wiki Manual - Command Line#Python options|Command Line: Python options]]
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Uncollected_Objects|Uncollected Objects]] Gramplet
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] Gramplet
{{-}}
====Check Localized Date Displayer and Parser====

[[File:StartDateTest-dialog-CheckLocalizedDateDisplayerAndParser-Tool-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Start date test?" dialog - for "Check Localized Date Displayer and Parser" - Tool]]

This test tool will create many people showing all different date variants as birth. The death date is created by parsing the result of the date displayer for the birth date. This way you can ensure that dates printed can be parsed back in correctly.

You will be shown the {{man label|Start date test?}} dialog to select either {{man button|Cancel}} to exit or {{man button|Run test}} to start the tool.
{{-}}

====Dump Gender Statistics====

[[File:GenderStatisticsTool-dialog-DumpGenderStatistics-Tool-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender Statistics tool" dialog results example - for "Dump Gender Statistics" - Tool]]

The "Gender Statistics tool" dialog will show the results in list about the statistics for the gender guessing based on the persons first name.

See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.
{{-}}

====Generate Testcases for Persons and Families====

[[File:GenerateTestcases-dialog-GenerateTestcasesForPersonsAndFamilies-Tool-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Generate testcases" dialog - for "Generate Testcases for Persons and Families" - Tool - default]]

The testcase generator will generate some persons and families that have broken links in the database or data that is in conflict to a relation.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

You can generate testcases that cause the following:
*{{checkbox|0}} {{man label|Generate low level database errors Correction needs database reload}}
*{{checkbox|0}} {{man label|Generate database errors}}
*{{checkbox|1}} {{man label|Generate dummy data}}
*{{checkbox|0}} {{man label|Generate long names}}
*{{checkbox|0}} {{man label|Add special characters}}
*{{checkbox|0}} {{man label|Add serial number}}
*{{checkbox|0}} {{man label|Add line break}}

*{{man label|Number of people to generate (Number is approximate because families are generated)}} <code>2000</code>(default)

Select {{man button|Cancel}} to exit or {{man button|OK}} to start the tool.

{{man button|Help}} will bring you here.

* Command line usage see: [[Plugins_Command_Line#Generate_Testcases_for_Persons_and_Families]]
{{-}}

====Populate Sources and Citations====

[[File:PopulateSourcesAndCitationsTool-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Populate sources and citations tool" dialog - default]]

This tool generates sources and citations for each source in order to populate the database for testing with significant numbers of sources and citations.

Enter the required number and then select {{man button|OK}} to run the tool:
*{{man label|Number of sources:}} <code>2</code> (default)
*{{man label|Number of citations:}} <code>2</code> (default)

Once the tool is complete you will be shown the {{man label|Data generated}} alert dialog.

{{-}}
{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Tools}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Tools]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Tools

2026-01-16T01:09:43Z

CallMeDave: /* Remove Unused Objects */ {{man note|Multiple runs of the Remove Unused Objects tool maybe needed in order to actually clean the database}} https://gramps-project.org/bugs/view.php?id=3249

{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Tools}}
{{#vardefine:chapter|14}}
{{#vardefine:figure|0}}
[[File:MenuOverview-Tools-default-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}
"{{man menu|Tools >...}}" Menubar - Tools Overview - default]]
This chapter describes the various {{man label|Tools}} available in Gramps.

Gramps {{man label|Tools}} allow you to perform various types of analysis of your genealogical data. Typically, the tools do not produce output in form of printouts or files. Instead, they produce screen output immediately available for the researcher. However, when appropriate, you can save the results of running a tool into a file.

== Tools ==

[[File:ToolbarIcon-OpenTheToolsDialog-60.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Toolbar Icon for "Open the tools dialog"]]

The tools can be accessed by choosing the menu {{man menu|Tools ->''Tool Section'' ->''Particular Tool''}} .

Alternatively, you can browse the complete selection of available tools along with their brief descriptions in a {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Tool_Selection_dialog|Tool Selection]]}} dialog invoked by clicking the {{man button|Open the tools dialog}} icon on the toolbar from any of the categories.
{{-}}
{{man note|Additional Tools |Gramps allows you to install even more tools. This system is controlled by the [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|'''Plugin Manager''']]. For additional tools see [[6.0 Addons|'''Addons''']].}}

=== Tool Selection dialog ===

[[File:ToolSelection-dialog-with-debug-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - default information (and "Debug" tools selection)]]

[[File:ToolSelection-dialog-example-with-debug-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - example showing "Check and Repair Database" information (and "Debug" tools selection)]]



The {{man label|Tool Selection}} dialog allows you to browse the complete selection of available tools along with their brief descriptions when invoked by clicking the [[File:Gramps-tools.png|28px]] {{man button|Open the tools dialog}} icon on the toolbar from any of the categories and use the {{man button|▶}} arrows to expand the listings.

'''Select a tool from those available on the left'''. Use the {{man button|▶}} arrows to expand the top level listings:
* [[#Analysis_and_Exploration|Analysis and Exploration]]
* [[#Debug|Debug]]
* [[#Family_Tree_Processing|Family Tree Processing]]
* [[#Family_Tree_Repair|Family Tree Repair]]
* [[#Utilities|Utilities]]

Then select the tool you are interested in to be shown on the right hand side the following:
* Tool name
* Tool description
* Status:
* Author:
* Author's email:

You can can then use the buttons below to either find out more about the tool or open and run your tool.

* {{man button|Wiki}} opens the help page if available - needs an internet connection {{new|6.0.0}}
* {{man button|Close}} exits this dialog
* {{man button|Run}} - {{man tooltip|Run selected tool}} - opens the tools configuration page.
{{-}}
See also: [[Gramps_6.0_Wiki_Manual_-_Reports#Report_Selection_dialog|Report Selection dialog]]


=== Analysis and Exploration ===

This section contains tools which analyze and explore the database, but do not alter it. The following analysis and exploration tools are currently available in Gramps:

====Compare Individual Events====
[[File:CompareIndividualEvents-EventComparisonFilterSelection-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event comparison filter selection" - dialog]]

This tool collates all the event types discovered in a group of people. Arguably, it could be considered to be more a Report than a Tool. It generates a summary comparison table that begins with the Name and ID of each person, then adds columns for the Event types and dates. If there are multiples of the same event type, additional rows are created. The collation ignores the Roles but includes custom Event types.

The resulting table is useful for comparing of suspected duplicates and revealing inconsistencies. The table can become quite wide so the Save As (in the .ods format) will allow analysis in a spreadsheet application.

You can use this tool via menu {{man menu|Tools->Analysis and Exploration > Compare Individual Events...}} which will open the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Event_comparison_filter_selection_dialog|Event comparison filter selection]]}} dialog

=====Event comparison filter selection dialog=====

The people for this comparison can be chosen from previously created custom filters by selecting the {{man label|Filter:}} drop down list, which defaults to the ''Entire Database''. Or by selecting the {{man button|Custom Filter Editor}} button, to create custom filters in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Filters#.3Ccategory.3E_Filters_editor_dialog|Person Filters]]}} editor. To run the report select {{man button|Apply}} and the results will be displayed in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Event_Comparison_Results_dialog|Event Comparison Results]]}} dialog.

{{-}}

=====Event Comparison Results dialog=====
From the {{man label|Event Comparison Results}} dialog you can view the results or {{man button|Save As}} the resulting table as a spreadsheet (ODS format). Select {{man button|Close}} to exit the report.
{{-}}
[[File:CompareIndividualEvents-EventComparisonResults-dialog-expanded-example-60.png|center|thumb|800px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event Comparison Results" - dialog - expanded example]]

The spreadsheet (ODS format) shows the following output fields:
* <code>Person, ID, Birth Date, Birth Place, Death Date, Death Place, LVG Date, LVG Place, Burial Date, Burial Place, Marriage Date, Marriage Place</code> 

{{-}}

===Family Tree Processing===

This section contains tools which may modify your database. The tools from this section are used mostly for finding and correcting errors in the data. The following Family Tree Processing tools are currently available in Gramps:

* [[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Extract_Event_Description|Extract Event Description]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Extract_Information_from_Names|Extract Information from Names]]
* [[Addon:Extract_Place_Data_from_a_Place_Title|Extract Place Data from a Place Title]] - '''This tool was moved to [[Third-party_Addons|Third-party addons]]'''
* [[Gramps_6.0_Wiki_Manual_-_Tools#Find_Possible_Duplicate_People|Find Possible Duplicate People]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Fix_Capitalization_of_Family_Names|Fix Capitalization of Family Names]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Merge_citations|Merge citations]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rename_Event_Types|Rename Event Types]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Sort_Events|Sort Events]]

{{man note|Family Tree Processing tools will only perform modifications upon your explicit consent|Except for the automatic fixes performed by {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair Database]]}} tool in the '''Family Tree Repair''' menu.}}

====Edit Database Owner Information====

[[File:DatabaseOwnerEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Database Owner Editor" - dialog - default]]

The {{man label|Edit Database Owner Information}} tool modifies any existing [[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher Information]].

Select the menu {{man menu|Tools->Family Tree Processing->Edit Database Owner Information...}}. This brings up the {{man label|Database Owner Editor}} window, where you can fill in the needed information or use one of the buttons to retrieve existing information.

*{{man label|Name:}}
*{{man label|Street:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

This information is family tree specific and will be used when exporting your data in GEDCOM format.

Two button choices are available:
* {{man button|Copy from DB to Preferences}} - to the '''Researcher''' section.
* {{man button|Copy from Preferences to DB}} - from the '''Researcher''' section.

{{new|6.0 - [https://github.com/gramps-project/gramps/pull/1660 Use regular buttons to copy owner information from/to preferences]}}
{{-}}

====Extract Event Description====

{{man note|The name format in the Event's Description field depends on|the defined name format in {{man menu|Edit->Preferences->Data> Display Options (section) ->}}{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Name format:]]}} }}



Extracts event descriptions from the event data by using a model :

<code>{event type} of {Surname}, {Given name}</code>

If event description is missing, then tool will use this event description field model.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Event Description...}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

Once you {{man button|Proceed with the tool}} this tool will scan and modify your Family Tree and if not present show you the {{man label|No modifications made}} alert otherwise if present you with the:

=====Modifications made result window=====
[[File:ExtractEventDescription-ModificationsMade-window-example-60.png|right|thumb|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Extract Event Description's - "Modifications Made" - window - example result]]

{{man label|Modifications made}} result window listing the total number of event descriptions that have been added.
{{-}}

====Extract Information from Names====

This tool searches the entire database and attempts to extract titles and nicknames that may be embedded in a person's {{man label|Given name}} field. If any information could be extracted, the candidates for fixing will be presented in the table. You may then decide which to repair as suggested and which not to.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Information from Names....}}

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Default_prefix_and_connector_settings_dialog|Default prefix and connector settings]]}} dialog will be shown and you can modify each of the options as required and once you have finished select {{man button|OK}} to start the tool.
{{-}}

Once the tool finishes either the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#No_modifications_made_dialog|No modifications made]]}} dialog will be shown as ''No titles, nicknames or prefixes were found'' or the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Name_and_title_extraction_tool_window|Name and title extraction tool]]}} window will be shown with results of the search.
{{-}}

=====Default prefix and connector settings dialog=====
[[File:ExtractInformationFromNames-DefaultPrefixAndConnectorSettings-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Default prefix and connector settings" - dialog for the "Extract Information from Names" Tool]]

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Default_prefix_and_connector_settings_dialog|Default prefix and connector settings]]}} dialog you can modify each of the options as required:
* {{man label|Prefixes to search for:}} <code>de, van, von, di, le, du, dela, della, des, vande, ten, da, af, den, das, dello, del, en, ein, elet, les, lo, los, un, um, una, uno, der, ter, te, die</code> (default)
* {{man label|Connectors splitting surnames:}} <code>e, y</code> (default)
* {{man label|Connectors not splitting surnames:}} <code>de, van</code> (default)
{{-}}

=====No modifications made dialog=====
[[File:ExtractInformationFromNames-NoModificationsMade-dialog-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "No modifications made" - dialog for the "Extract Information from Names" Tool]]

Shown when ''No titles, nicknames or prefixes were found'' in the selected family tree.

Select {{man button|Close}} to dismiss the dialog.

{{-}}

=====Name and title extraction tool window=====
The top section shows information about the tool.
{{man note|Below is a list of the nicknames, titles, prefixes and compound surnames that Gramps can extract from the Family Tree.
If you accept the changes, Gramps will modify the entries that have been selected.

Compound surnames are shown as lists of [prefix, surname, connector].

For example, with the defaults, the name "de Mascarenhas da Silva e Lencastre" shows as:

[de, Mascarenhas]-[da, Silva, e]-[,Lencastre]

Run this tool several times to correct names that have multiple information that can be extracted.}}

[[File:ExtractInformationFromNames-NameAndTitleExtractionTool-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Name and title extraction tool" - dialog results window for the "Extract Information from Names" Tool]]

The bottom section displays the results list in a table with the following columns: <code>Select</code>, <code>ID</code>, <code>Type</code>, <code>Value</code>, <code>Current Name</code>

You can un-<code>Select</code> the results you don't want and then {{man button|Accept and close}} to apply those results to your family tree or {{man button|Cancel}} to do nothing. The {{man button|Help}} button brings you to this tools help section.
{{-}}

====Extract Place Data from a Place Title====

{{man warn|This tool was moved to [[Third-party_Addons|Third-party addons]].|When the Place Hierarchy was first added to Gramps, every user needed a tool to [[Addon:Extract Place Data from a Place Title]]. Now that that a Hierarchy of Places is well established, the tool is needed infrequently. So installation has been made optional.}}

====Find Possible Duplicate People====

[[File:FindPossibleDuplicatePeople-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find Possible Duplicate People - dialog - default]]

The '''Find Possible Duplicate People''' tool searches the entire Tree database, looking for the entries that may represent the same person.

You can access this tool via the menu {{man menu|Tool -> Family Tree Processing -> Find Possible Duplicate People...}}.

The {{man label|Find Possible Duplicate People}} dialog will be shown and you can adjust the following options:
*{{man label|Match Threshold}} : choose between '''Low''' (default), ''Medium'' and ''High'' from the drop down menu.
{{man note|How is the quality of match measured?|2=This calculates the chances (or 'odds') of matching on a quality scale labeled as low, medium and high. For each piece of information that corresponds, the quality of the match is considered to be marginally increased. The closer the particular pieces of data correlate, the larger the increase. When the chance is greater than the selected '''Match Threshold''' then a match will reported. The thresholds are Low=0.25, Medium=1.0 and High=2.0. So, with the filtering threshold set to High, fewer matches are expected.}}

{{man label|Options}}
*{{checkbox|1}} {{man label|Use [[Gramps_6.0_Wiki_Manual_-_Gramplets#SoundEx_Gramplet|soundex]] codes}} for matching possible duplicate people. (checkbox checked by default)

The following buttons are present: {{man button|Help}} brings you to this page, {{man button|Cancel}} to stop processing and an {{man button|OK}} button to start processing the data.

Select {{man button|OK}} to start the tool and the data will be processed in two passes.

*Pass 1: Building preliminary lists
*Pass 2: Calculating potential matches.

A progress bar will be shown and depending the speed of your computer and the amount of people in the database this can take some time.

{{-}}

=====Potential Merges=====
[[File:FindPossibleDuplicatePeople-PotentialMerges-result-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Potential Merges" result dialog window for "Find Possible Duplicate People" - dialog - example]]

Once the report finishes a {{man label|Potential Merges}} result list window is presented with the following columns shown:
*<code>Rating</code> : this gives you an idea of the resemblance between the two people. The higher the ranking, the higher the chance that the people are duplicates.
*<code>First Person</code>
*<code>Second Person</code>

You can either double-click on the selected row or select the {{man button|Compare}} button to check the details.

Three buttons are present: {{man button|Help}} brings you to this page, a {{man button|Close}} to close the window which returns you to the {{man label|Find Possible Duplicate People}} window and a {{man button|Compare}} button to which brings up the {{man label|Merge People}} window which was explained in detail in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_People|Merge People]]}} dialog. Here you can select with the radio buttons one of the persons and eventually use the {{man button|OK}} button to merge the data if you find the two persons are duplicates.

Selecting the {{man button|Cancel}} button brings you back to the {{man label|Potential Merges}} result list window.
{{-}}

====Fix Capitalization of Family Names====

This tool searches the entire database and attempts to fix the capitalization of family names.

The aim is to have conventional capitalization: capital first letter and lower case for the rest of the family name. If deviations from this rule are detected, the candidates for fixing will be presented in the table.

You may then decide which to repair as suggested and which not to.

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Fix Capitalization of Family Names...}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{-}}
[[File:FixCapitalizationofFamilyNames-CapitalizationChanges-dialog-results-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Capitalization changes" - dialog - results example for "Fix Capitalization of Family Names" tool]]

If there where changes to the capitalization of any names you will be presented with the {{man label|Capitalization changes}} results window. The window shows a list of the family names that Gramps can convert to (according to Gramps) correct capitalization (please check that it is correct for you.). In the {{man label|Capitalization changes}} results window list the following columns are available:
*{{checkbox|1}} {{man label|Select}} - Check or uncheck these on a "by name" basis if you choose not to accept the recommendation (checkbox checked by default)
* {{man label|Original Name}} - The name as currently recorded.
* {{man label|Capitalization Change}} - The name with change if applied.

Select the names you want to be changed, then select the {{man button|Accept changes and close}} button. Or use the {{man button|Cancel}} button to abort changes.
{{-}}

You can also install the "[[Addon:Fix Capitalization of Given Names]]" tool Addon that once installed works almost identically to this tool but works for "Given Names"
{{-}}

====Merge citations====

{{man tip|The {{man label|Merge Citations}} tool|works by combining notes, media objects and data-items of matching citations.}}

You can select this via menu {{man menu|Tools > Family Tree Processing > Merge Citations...}} .

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.
{{-}}
[[File:MergeCitations-dialog-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Merge Citations" - dialog - default]]

Then the {{man label|Merge Citations}} dialog (Title of dialog shows:''Notes, media objects and data-items of matching citations will be combined.'')will be shown

The following options are available:
* {{man label|Match Threshold}} drop down list:
** Match on Page/Volume, Date and Confidence
** '''Ignore Date''' (default)
** Ignore Confidence
** Ignore Date and Confidence
* {{man label|Options}}
** {{checkbox|0}} {{man label|Don't merge if citation has notes}} (checkbox unchecked by default)

{{-}}
[[File:NumberOfMergesDone-dialog-result-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Number of merges done" result dialog for "Merge Citations" - dialog - Tool - example]]

Select {{man button|OK}} to run the tool and once complete it will report back the total with the {{man label|Number of merges done}} result dialog.
{{-}}
See also the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Citations|Merge Citations]] option available from the Citations Category list view
{{-}}

====Rename Event Types====

This tool will rename all events of one type to a different type.

You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Rename Event Types....}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}

{{-}}
[[File:RenameEventTypes-Tool-ChangeEventTypes-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Change Event Types" - dialog - example for "Rename Event Types" Tool]]

The {{man label|Change Event Types}} dialog is presented.

* {{man label|Original event type}}: fill in the text field or use the drop down menu and select an original event type
* {{man label|New event type}}: fill in the text field (you can create a complete new type here) or use the drop down menu and select a new type

The example shows a renaming of the '''Birth''' event to a '''Baptism''' event.

{{man note|Custom types|While the custom types do not show in the drop down list, you can over type or paste into either of the selection boxes and convert from one to another.}}

{{-}}
[[File:RenameEventTypes-Tool-ChangeTypes-result-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Change types" - result dialog - example for "Rename Event Types" Tool]]

Finally use the {{man button|Cancel}} to exit or select {{man button|OK}} to run the tool and once complete it will report back the total events modified with the {{man label|Change types}} result dialog.
{{-}}

{{man warn|1=Renaming events|2=Once completed, this cannot be undone by the regular {{man label|Undo}} function.}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Editing information about events]]


====Reorder Gramps IDs====

This tool can be used to reorder your Gramps object IDs.

[[File:ReorderGrampsIDs-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" tool window - example]]

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Reorder Gramps IDs...}}.

Initialy the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}}''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

Then the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_tool_window|Reorder Gramps IDs]]}} tool window will be shown where you can modify the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_tool_window|column options]] as needed then select {{man button|OK}} to start the process.

The tool will then show various progress dialogs during the different progress stages; as the following object IDs' are reordered: 'Reordering People IDs', 'Reordering Family IDs', 'Reordering Event IDs', 'Reordering Place IDs', 'Reordering Source IDs', 'Reordering Citation IDs', 'Reordering Repository IDs', 'Reordering Media Object IDs' and finally 'Reordering Note IDs'.

In the final step 'unused IDs' are searched for and assigned.

During this process the tool will examine each ID to see if it looks like it has been 'customized', if it doesn't look like the previous object ID format or the default object ID format. This might be the case if the user has manually entered their own text in the ID field for the object when editing it. It might also occur if the third-party [[Addon:GeoName|GeoName Addon]] has been used or the [[Addon:GetGOV|GetGOV Addon]] that stores the '''GOV ID''' in the Place ID field. If a ''customized'' ID is found, the tool will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_replace_dialog|Reorder Gramps IDs]]}} replace dialog that ask the user if they really wants to replace the ID and also optionally allows the user to use the same answer for same found customized object IDs.

{{man warn|Custom IDs'|If you customized your object IDs', all those can be replaced by this tool. So take care by backing up before you use this tool!}}

=====Reorder Gramps IDs tool window=====
[[File:ReorderGrampsIDs-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" tool window - default on new empty family tree]]

The {{man label|Reorder Gramps IDs}} tool window shows each of Gramps objects (Person, Family, Event, Place, Source, Citation, Repository, Media, Note) and the following option columns (<code>Object</code>, '<code>Actual</code>, <code>Quantity</code>, <code>Format</code>, <code>Change</code>, <code>Start</code>, <code>Stop</code>, <code>Keep</code>) that can be applied to changing the object ID's.

The {{man button|Help}} button will show this section. The {{man button|Cancel}} button will exit the tool. The {{man button|Ok}} start the tool.

Most of the column labels also double as hidden toggles buttons and perform various actions as described below.

;<code>Object</code>:This column lists the type of Gramps ID. Immediately to the left of this column are checkboxes that allow the enabling of changes to individual object types. When checked, the type can be reordered. The {{man button|Object}} label is actually a hidden button that can be used to toggle all of the checkboxes at once.

;<code>Actual</code>:This column shows an example of the current objects ID.

;<code>Quantity</code>:This column show the current number of objects in the family tree.

;<code>Format</code>:This column can be used to change the ID format for each object type. Note that the default ID formats consists of a one letter prefix (I, F, E, P, S, C, R, O, N) representing each of the objects, and then a suffix '<code>%04d</code>'. There '''MUST''' be at least a prefix or a suffix, both are allowed. It is recommended to keep these relatively short. The '<code>%04d</code>' defines the length of the numeric portion of the ID, the '<code>4</code>' can be changed, anything from '<code>3</code>' (allowing numbers from 000-999) to '<code>9</code>' (000000000-999999999) is allowed (''If your family tree needs more than "nine hundred ninety-nine million, nine hundred ninety-nine thousand, nine hundred ninety-nine" please raise a feature request!''). Changes made here are the same as made in the menu {{man menu|Edit->Preferences...}} and then select the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}''' tab. The '{{man button|Format}}' label is actually a hidden button that can be used to ''reset'' all the formats to the last used value.

;<code>Change</code>:This column contains checkboxes for each object type. When checked, the IDs for that object will be replaced with new IDs of the <code>Format</code> style, unless <code>Keep</code> is also checked. If there is no checkmark, the ID formats are ''NOT'' updated, but the number field within the format is renumbered. The {{man button|Change}} label is actually a hidden button that can be used to toggle all of the check boxes at once.

;<code>Start</code>:This field indicates the starting number used during the renumber operation. The {{man button|Start}} label is actually a hidden button that can be used to toggle between start at <code>0</code>, and start after last current number.

;<code>Step</code>:This field indicates the interval between numbers during the renumber, <code>1</code> is a simple increment, <code>2</code> will increment by 2 etc. The {{man button|Step}} label is actually a hidden button that can be used to toggle between <code>1</code>, <code>2</code>, <code>5</code>, and <code>10</code>.

;<code>Keep</code>:This column contains check boxes for each object type. If both the <code>Keep</code> and <code>Change</code> check boxes are checked, the ID formats for that object will be retained, and the number field within the format is renumbered. The {{man button|Keep}} label is actually a hidden button that can be used to toggle all of the check boxes at once.

=====Reorder Gramps IDs replace dialog=====
[[File:ReorderGrampsIDs-replace-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Gramps IDs" replace dialog - example]]

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs_dialog|Reorder Gramps IDs]]}} replace dialog that ask the user if they really wants to replace the ID and also optionally allows the user to use the same answer for same found customized object IDs.

* {{man label|[ ] Use this answer for the rest of the items}}

Select {{man button|Yes}} or {{man button|No}}.
{{-}}

====Sort Events====

Events appearing on the Event tab on a ''Person'' or ''Family Editor'' are not sorted in any particular order other than the order that the events were added. The reason for not enforcing any particular ordering, particularly ordering by date, is to allow for the situation where an event was known to have happened but the exact chronology is not. Importing or merging data from an external source can lead to extra events being added to, but out of sequence with, the existing set of events of a person or family.

Events can be manually re-ordered by [http://en.wikipedia.org/wiki/Drag-and-drop ''drag & drop''] or by use of the re-order buttons on the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Events]]}} tab. Either way, an event can be moved up or down in the list of events and Gramps will remember the new order when the changes are saved. The new ordering will be used wherever events are shown elsewhere in Gramps, such as on a report.

The order of all events on a tab can also be changed by clicking a column title. For example, clicking the <code>Date</code> column header will sort all the events in date order. However this way of sorting events is temporary and changes to the event order are not preserved when the window is closed.

The [http://en.wikipedia.org/wiki/Drag-and-drop ''drag and drop''] approach to sorting events is fine for moving a small number of events but is not practical for large scale changes. The {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Sort_Events_tool|Sort Events tool]]}} has been designed specifically for this purpose, re-sorting all events in the database or just those associated with a targeted selection of people chosen by using a filter.

=====Sort Events tool=====

You can use this tool via menu {{man menu|Tools->Family Tree Processing->Sort events...}}.

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}

{{-}}
======Tool Options tab ======
[[File:SortEvents-dialog-ToolOptions-tab-default-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Sort Events" Tool - dialog - showing "Tool Options" tab]]

On the {{man label|Tool Options}} tab for the {{man label|Sort Events}} dialog window the first option is used to define the range of people who's events are to be sorted. The first choice in the list is to apply the sorting to all people in the database. Alternative choices are to apply sorting to ancestors and descendants of a chosen person or to a range of people selected by a custom built person filter. After choosing who the sort should apply to, the next thing to consider is how the events should be sorted. The first option is to sort by date. This is probably the most likely choice, but other event attributes can be chosen too. The final choices are whether to make the events sorted ascending or descending and whether to apply the sort to family events that the selected people belong to as well.

{{stub}}

{{-}}
{{man warn|1=Sorting events|2=Once completed, this cannot be undone by the regular {{man label|Undo}} function.}}

=== Family Tree Repair ===

The following Family Tree Repair tools are available:

* [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Gender_Statistics|Rebuild Gender Statistics]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Reference_Maps|Rebuild Reference Maps]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Rebuild_Secondary_Indexes|Rebuild Secondary Indexes]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Remove_Unused_Objects|Remove Unused Objects]]



====Check and Repair Database====

{{man warn|Warning: The {{man label|Check and repair Database}} tool performs automatic fixes.|Once completed, this cannot be undone by the regular {{man label|[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_Undo_History|Undo History]]}} function.}}

The {{man label|Check and repair Database}} tool checks the selected database/Family Tree for integrity problems, fixing the problems it can. Specifically, the tool is checking for:

*Broken family links. These are the cases when a person's record refers to a family while the family's record does not refer to that person, and vice versa.

*Missing media objects. The missing media object is the object whose file is referenced in the database but does not exist. This can happen when the file is accidentally deleted, renamed, or moved to another location.

*Empty families. These are the family entries which have no reference to any person as their member.

*Parent relationship. This checks all families to ensure that father and mother are not mixed up. The check is also made that parents have different gender. If they have common gender then their relationship is renamed to "Partners".

You can use this tool via menu {{man menu|Tools->Family Tree Repair->Check and Repair Database...}}.

{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}

The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

{{-}}
=====Integrity Check Results dialog=====
[[File:IntegrityCheckResults-dialog-CheckAndRepairDatabase-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Integrity Check Results" - example result dialog - for the "Check and Repair Database" tool]]

Any issues found are automatically fixed and the {{man label|Integrity Check Results}} dialog will be shown with a summary actions taken.
{{-}}
=====No errors were found dialog=====
Otherwise you will see the {{man label|No errors were found}} dialog stating that ''The database has passed internal checks''.
{{-}}
=====Gramps had a problem the last time it was run - dialog=====
[[File:GrampsHadAProblemTheLastTimeItWasRun-dialog-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps had a problem the last time it was run - dialog ]]

After Gramps crashes [https://github.com/gramps-project/gramps/pull/778 on restart, Gramps will offer to run Check & Repair] tool. (Introduced in Gramps 5.1.x)

{{-}}

====Rebuild Gender Statistics====

[[File:GenderStatisticsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender statistics rebuilt" - result dialog for "Rebuild Gender Statistics" tool]]

Rebuilds gender statistics for name gender guessing based on the accumulated statistics of genders for given names within the tree. If a gender is common to more than half the in the Tree with a particular first word in their Given name, then Gramps will guess that Gender for that name will be the same.

The statistics can also be cleared (if the {{man menu|Tools ➡ [[Gramps_6.0_Wiki_Manual_-_Tools#Debug|Debug]]}} menu has been enabled) with the [[Gramps_6.0_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics]] Tool.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Gender Statistics...}}.

Once completed the {{man label|Gender statistics rebuilt}} result dialog will be shown.

{{man warn|Rebuild Gender Statistics needed after converting database|Issue {{bug|11314}} notes that gender statistics are swapped after database conversion to SQLite. If your gender guessing is suggesting the opposite gender for particular given names, use the Rebuilt Gender Statistics tool to fix the guessing.}}

See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.

{{-}}

====Rebuild Reference Maps====

[[File:ReferenceMapsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reference maps rebuilt" - result dialog for "Rebuild Reference Maps" tool]]

This tool rebuilds reference map tables. This drives the list of ''References'' items in editors.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Reference Maps...}}.

Once completed the {{man label|Reference maps rebuilt}} result dialog will be shown.
=====See also=====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}

====Rebuild Secondary Indexes====

[[File:SecondaryIndexesRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Secondary indexes rebuilt" - result dialog for "Rebuild Secondary Indexes" tool]]

This tool rebuilds secondary indices.

You can use this tool via menu {{man menu|Tools ➡ Family Tree Repair ▶ Rebuild Secondary Indexes...}}.

Once completed the {{man label|Secondary indexes rebuilt}} result dialog will be shown.

The {{man menu|Rebuild Secondary indexes...}} re-constructs the secondary tables in the Tree db. These tables include things like gender statistics (Given Name versus gender) to allow guessing the gender of names as they are entered, surnames (for faster lookup of possible surname and to make the person tree view work), the various IDs for objects (to facilitate lookup by ID), place enclosure tables, to make the place tree view work, and a few others.

In theory, these tables are kept constantly up-to-date when anything changes. So rebuilding the Reference Maps and Secondary Indices should not be necessary. But, especially early on in the Gramps history, bugs sometimes interfered with updates completing correctly. So the tools remain available... ‘just in case’.
=====See also=====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}

====Remove Unused Objects====

This tool will search your database for pieces of information which are not connected to anything else, and then allow you to edit and attach the information or remove them.

You can use this tool via menu {{man menu|Tools->Family Tree Repair->Remove Unused Objects...}}.

{{-}}
[[File:UnusedObjects-dialog-example-results-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Unused Objects" - dialog example results for "Remove Unused Objects" tool]]

The {{man label|Unused Objects}} dialog is presented.

You can choose from the search option you want to use from the top section of the {{man label|Unused Objects}} dialog:
*{{checkbox|1}} {{man label|Search for events}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for sources}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for citations}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for places}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for media}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for repositories}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for notes}} (checkbox checked by default)

Select the {{man button|Find}} button to run the tool, and once completed the results if any will show in the bottom section of the {{man label|Unused Objects}} dialog with the following columns shown:
* {{man label|Mark}} Select the row if you want to delete the object (unchecked by default)
* {{man label|}} - Icon representing the type of object.
* {{man label|ID}} - Gramps internal name for the object.
* {{man label|Name}} - of the object.

To examine the object you must double-click on the row and it will show the appropriate editor for the object allowing you to edit if required.

{{man label|Mark}} the objects you want to delete either using the individual checkboxes or using the associated buttons:
* {{man button|Mark all}}
* {{man button|Unmark all}}
* {{man button|Invert marks}}

Once your deletion choices have been made select the {{man button|Delete}} button to delete the objects.

When finished you may then use the {{man button|Close}} button to exit the tool.
{{-}}
{{man note|Multiple runs of the Remove Unused Objects tool maybe needed in order to actually clean the database}}

=== Utilities ===

This section contains tools allowing you to perform a simple operation on a portion of data. The results can be saved in your database, but they will not modify your existing data. The following utilities are currently available in Gramps:
* [[Gramps_6.0_Wiki_Manual_-_Tools#Clean_input_data|Clean input data]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Find_database_loop|Find database loop]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|Media Manager]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Not_Related|Not Related]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Verify_the_Data|Verify the Data]]

====Clean input data====

====Remove leading and trailing spaces====

[[File:CleanInputData-dialog-tool-example-dialog-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clean input data]]
Tool to clean leading and trailing spaces from imported or old data. The tool searches for place names with leading or/and trailing spaces. It also looks in the first name and surname.

Leading and trailing spaces are automatically removed during name data being committed to the tree.

The tool can be triggered from the menu {{man menu|Tools > Utilities > Clean input data...}} or Tools selector dialog

See also:
* Avoid invalid characters and leading or trailing spaces in the entry field - (added in Gramps [[Template:Releases/5.0.2|5.0.2]] with [https://github.com/gramps-project/gramps/pull/811 PR811])
* [https://github.com/gramps-project/gramps/pull/783 New tool to suppress leading and trailing spaces.] - (added in Gramps [[Template:Releases/5.1.0|5.1.0]])
* Feature request {{bug|4566}} : Please remove trailing spaces on items on input (2016)
* Feature request {{bug|4619}} : Trailing blanks are removed from queries in the preset filters (2011)

{{-}}

====Find database loop====

[[File:FindDatabaseLoop-example-PedigreeChartView-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree chart showing loop - example]]

The {{man label|Find database loop}} utility allows you to verify if you have ancestral loops in the database. Loops in your family tree may for example show a person as both the child and ancestor of another person in Family Tree. Loops can happen accidentally during data entry, for example, when a son is linked into the family tree as his own grandfather!

Other valid loops also happen and should be kept in the family tree if verified:
* An inbreeding loop because the parents are related.
* A mating loop caused by a male who has children to genetically related females.
* An incest mating loop caused by full siblings.
{{-}}
[[File:FindDatabaseLoop-dialog-example-results-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find database loop - dialog - results from example family tree case]]

Use the menu {{man menu|Tools->Utilities->Find database loop...}} and you will get a {{man label|Find database loop}} window that will display the results in a list with six columns: <code> </code> ''Loop Group unlabeled'' (<code>Gramps ID</code>, <code>Parent</code>), (<code>Gramps ID</code>, <code>Child</code>), <code>Family ID</code>.

* Loop Group unlabeled column - a number related to which loop the entries are about.
* First <code>Gramps ID</code> is a reference to the Parent.
* <code>Parent</code> (Ancestor on the image) is the person we are looking for a loop.
* Second <code>Gramps ID</code> is a reference to the Child.
* <code>Child</code> (Descendant) is the origin of the loop.
* <code>Family ID</code> is a reference to the associated family

Double clicking on a selection will open the related [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Families entry]].

To fix a pedigree loop in your family tree.
* Locate the person page of the individual whose relationship needs to be adjusted.
* First, verify that a name or vital event date was not accidentally entered incorrectly.
* If you are sure that deleting the incorrect parent-child relationship will fix the loop, proceed with the steps.

Once you have resolved any loops select {{man button|Close}} to exit.

{{-}}
To read more about ancestral loops see:
* [https://www.tamurajones.net/FindingAncestralLoops.xhtml Finding Ancestral Loops : Modern Software Experience]
* [http://www.beholdgenealogy.com/blog/?p=1309 Ancestral Loops : Louis Kessler's Behold Blog]

Also see:
* [https://wikipedia.org/wiki/Endogamy Endogamy] - From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Cousin_marriage Cousin marriage] - From Wikipedia, the free encyclopedia

=====Example ancestral loops=====

{{stub}}

[[File:FindDatabaseLoop-dialog-complex-example-results-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} chart showing complex example]]

In the following complex example, we have multiple ancestral loops indicated by the number in the first unlabeled column a "Loop Group" :

If we look at the second line, we have :
# First Gramps_ID : I0002
# Parent is : Father, Child2
# Second Gramps_ID : I0001
# Child is : Father, Father
# Family_ID is : F0000

{{-}}
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|600px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]

To understand what happens :
#we start at [I0002] Father, Child2.
#We continue with his son [I0003] Father, Child3.
#We continue with his son : [I0000] Child, Child.
#We continue with his son : [I0001] Father, Father.
#We continue with his son : [I0002] Father, Child2 ==> '''HERE, we have a ancestral loop'''.

{{-}}

====Media Manager====

{{stub}}

The {{man label|Gramps Media Manager}} is a group of four separate tools accessed via a wizard like dialog that you can access via the menu {{man menu|Tools->Utilities->Media Manager...}} which will show the first '''[[Gramps_6.0_Wiki_Manual_-_Tools#|Introduction]]''' dialog page.

=====Introduction=====

[[File:Introduction-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Introduction - page for "Gramps Media Manager" - Tool wizard]]

A brief information on the tools abilities is shown.

From the '''Introduction''' page selecting the {{man button|Next}} button (or using the keyboard shortcut {{man key press|Alt|N}}) you will be shown the '''[[Gramps_6.0_Wiki_Manual_-_Tools#Selection|Selection]]''' page window.

{{man note|Introduction|This tool allows [http://wikipedia.org/wiki/Batch_processing batch operations] on media objects stored in Gramps. An important distinction must be made between a Gramps media object and its file.

The Gramps media object is a collection of data about the media object file: its filename and/or path, its description, its ID, notes, source references, etc. These data '''do not include the file itself'''.

The files containing image, sound, video, etc. exist separately on your hard drive. These files are not managed by Gramps and are not included in the Gramps database. The Gramps database only stores the path and file names.

This tool allows you to only modify the records within your Gramps database. If you want to move or rename the files then you need to do it on your own, outside of Gramps. Then you can adjust the paths using this tool so that the media objects store the correct file locations.}}

{{-}}

=====Selection=====
[[File:Selection-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selection - page for "Gramps Media Manager" - Tool wizard - default]]

From the '''Selection''' page window select from one the four options the actions you want to take and then select the {{man button|Next}} button:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Replace_substrings_in_the_path|Replace substrings in the path]]}} (default)
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Add_images_not_included_in_database|Add images not included in database]]}}
{{-}}

=====Replace substrings in the path=====

[[File:ReplaceSubstringSettings-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Replace substring settings - page for "Gramps Media Manager" - Tool wizard - default]]

This tool allows replacing specified substring in the path of media objects with another substring. This can be useful when you move your media files from one directory to another.

Selecting this radio button will bring up a {{man label|Replace substring settings}} window where you can type in any string in the {{man label|Replace}} text field and the {{man label|With}} text field. At any time you can click on the {{man button|Cancel}} button or the {{man button|Back}} button. Clicking the {{man button|Forward}} button will bring up the {{man label|Final confirmation}} window.

{{-}}

=====Convert paths from relative to absolute=====
[[File:ConvertPathsFromRelativeToAbsolute-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from relative to absolute':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

This tool allows converting relative media paths to the absolute ones. It does this by prepending the {{man label|Base media path:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section, or if that is not set, it prepends the default [[Gramps_6.0_Wiki_Manual_-_User_Directory|User's Directory]].

* [https://wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}

=====Convert paths from absolute to relative=====
[[File:ConvertPathsFromAbsoluteToRelative-FinalConfirmation-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from absolute to relative':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

This tool allows converting absolute media paths to a relative path. The relative path is relative to the given base path in the setting {{man label|Base media path:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section, or if that is not set, the user's directory is used. A relative path connects the file location to the base media path that can be changed according to your needs.

* [https://en.wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}

=====Add images not included in database=====

[[File:AddImagesNotIncludedInDatabase-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Add images not included in database':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]

Check directories for images not included in database, this tool adds images in directories that are referenced by existing images in the database. You will have to import one media item from each sub directory manually. Media Manager does not include sub-directories automatically. All the directory paths shown in the tool will be searched through.
{{-}}

====Not Related====

[[File:NotRelatedTo-dialog-NotRelated-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}. "Not related to '...'" - dialog - showing results for "Not Related" Tool]]

This tool will list people who are not connected to the selected active person. Connections may include linked in a chain of [[References|references]] or linkages created with the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Link_Editor|link editor in Notes]].

You can use this tool via menu {{man menu|Tools->Utilities->Not Related...}}.

You will get a {{man label|Not related to '...'}} results dialog which shows a list of all the people that are '''NOT''' related to the selected person.

This list gives you:
* ''Name''
* ''ID''
* ''Parents''
* ''Tags''

From the ''Name'' column you can use the {{man button|▶ right arrow}} button and {{man button|↓ down arrow}} buttons to collapse or expand the grouped ''Name'' list. Double clicking on a person will bring up the {{man label|person edit}} dialog or {{man label|family edit}} dialog.

If you select a person, you can use the {{man label|Tag}} text field (you can fill in whatever custom tag name you want to use) or use the drop down list to choose an existing tag eg TODO, NotRelated. Use the {{man button|Apply}} to add the selected tag to the person(s). This tag will then show up in the ''Tags'' column.
{{-}}

====Relationship Calculator====

[[File:RelationshipTo-dialog-RelationshipCalculator-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Relationship to '...' " - dialog - showing results for "Relationship Calculator" Tool]]
You can use this tool via menu {{man menu|Tools ➡ Utilities ▶ Relationship Calculator...}}.

Selecting the Relationship Calculator tool will open a list filtered to all people connected, '''but not necessarily related''', to the [[Gramps_Glossary#active_person|Active Person]]. To calculate relationship to different person, close the window, make that person Active and select the tool from the menu again.

Select the individual from the filtered list to report if a relationship exists. The exact relationship will be shown in the lower panel... along with the common ancestors in that relationship. Only blood relationships will display (except for husband-wife and step relationships). Note that "in-law" relationships are not displayed.

The filtered list will grouped and alphabetically sorted by surname. (Regardless of whether the View menu setting of the Person category has been set to '''Grouped'''.) The list columns cannot be re-sorted.

The degree of separation (generation distance) that will be recognized is controlled by the {{man label|Max generations for relationships}} value in the [[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]] tab under the {{man menu|Edit ➡ Preferences...}} menu. Moved from the [[Gramps_5.1_Wiki_Manual_-_Settings#General|5.1 General]] tab {{New|5.2}} (The default of 15 generations will report a 12th great-grandparent relationship but not the 13th great-grandparents. The active person is counted as one of the generations. So, self generation plus parent plus grandparents are the other 3 generations.)

Essentially, any two people are directly related by blood if they have an ancestor in common. One of these individuals may actually be an ancestor of the other - such as a great grandparent. Even in the cases of aunts and uncles, you still can calculate the relationship by searching for the common ancestor. In this case, the father or mother of the aunt or uncle will be a grandparent to the nephew or niece.

The most basic blood relationship through common ancestors is that of siblings (brothers and sisters) who are only one generation down from the common ancestor. Another special relationship is that of one of those siblings to the descendants of the other siblings. If the Active Person is a grandchild of the common ancestor, the sibling would be an aunt or uncle. Beyond that generation of descendants, there are two equivalent ways of describing the relationship. The daughter of great grandparents might be called either a grandaunt or a great aunt. (The Relationship Calculator uses the 'grand' variant.) That person is a great grandaunt to the second great grandchildren, who are four generations distant from the common ancestor. (She may also be called a second great aunt.) The reverse relationship of an aunt or uncle is a nephew or niece.

Cousins (also called "first" cousins) are two generations down from the common ancestor through different siblings. "Second" cousins are thus, three generations down from the common ancestor - and so on.

After that, everyone is considered a "cousin", but to indicate that they are not in the same generation we use the word "removed" to indicate the number of generations different between the two. For example, my father's "first" cousin is also my "first" cousin but "once removed" (one generation difference between us). My fathers "first" cousin is my own child's "first cousin twice removed" - two generations different.

If multiple blood relationships exist due to pedigree Collapse, all will be reported.

A full text list of all blood relations and their spouses can be viewed using a [[Gramps 6.0 Wiki Manual - Reports - part 6#Kinship Report|Kinship Report]].

=====See also:=====

* The '''Relationship to home person''' [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar
* '''Relation to Home Person''' [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].
* The '''[[Addon:Deep_Connections_Gramplet|Deep Connections]]''' gramplet: If this third party addon is installed, it will list the intervening generations through the sibling offspring of a common ancestor. (But it does not list the common ancestor or if both person a connected through the same spouse.) The Gramplet also details the indirect relationships.
* [[Specification:Relationship Calculator|Relationship Calculator Localization]] - create meaningful relation descriptions in your region.
{{-}}

====Verify the Data====
{{man tip|Verify the Data tool enhanced{{new|5.2}}|Tool performance improved, results reorganized into a Tree rather than a flat list, additional tests. 8 New rules ([[Gramps_6.0_Wiki_Manual_-_Tools#Data_Verification_Results_window|marked below]]) to find additional irregularities.
}}

[[File:VerifyTheData-DataVerifyTool-dialog-General-tab-defaults-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Verify the Data..." - "Data Verify tool" dialog - "General" tab - defaults]]

This utility allows you to verify the database based on the set of criteria specified by you.

For example, you may want to make sure that nobody in your database had children at the age of 98. Based on common sense, such a record would indicate an error. However, it is not a consistency error in the database. Besides, someone might have a child at the age of 98 (although this rarely happens). The Verify tool will display everything that violates your criteria so that you can check whether the record is erroneous or not. The ultimate decision is yours.

Select this via the menu {{man menu|Tools->Utilities->Verify the Data...}} you will get a {{man label|Data Verify Tool}} window. The window has four tabs; {{man label|General}}, {{man label|Women}}, {{man label|Men}}, {{man label|Families}}. Those tabs show a list with criteria and a input field where you can alter the criteria value. In the lists below I show some ''workable'' values.

=====Verify the Data tab pages=====

Select the criteria you want to run the tool with from the following tabs. If you are OK with the criteria click the {{man button|Run}} button (or hit the {{man key press|Alt|R}} keybinding) and you will be presented with a {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Data_Verification_Results_window|Data Verification Results]]}} window.

======General======
* {{man label|Maximum age}}: <code>90</code>
* {{man label|Minimum age to marry}}: <code>17</code>
* {{man label|Maximum age to marry}}: <code>50</code>
* {{man label|Maximum number of spouses for a person}}: <code>3</code>
* {{man label|Maximum number of consecutive years of widowhood before next marriage}}: <code>30</code>
* {{man label|Maximum age for an unmarried person}}: <code>99</code>

The first check box: {{man label|Estimate missing or inexact dates}} causes the tool to accept a baptism date if a birth date is not known, and to accept a burial date if a death date is not known. It also causes the tool to accept "inexact" dates (i.e., any "legal" Gramps date which is not a fully-specified one (with an explicit day and month and year)).

The second check box: {{man label|Identify invalid dates}} will check if the dates are invalid.

======Women======
* {{man label|Minimum age to bear a child}}: <code>17</code>
* {{man label|Maximum age to bear a child}}: <code>48</code>
* {{man label|Maximum number of children}}: <code>12</code>

======Men======
* {{man label|Minimum age to father a child}}: <code>18</code>
* {{man label|Maximum age to father a child}}: <code>65</code>
* {{man label|Maximum number of children}}: <code>15</code>

======Families======
* {{man label|Maximum husband-wife age difference}}: <code>30</code>
* {{man label|Maximum number of years between children}}: <code>8</code>
* {{man label|Maximum span of years for all children}}: <code>25</code>
{{-}}

=====Data Verification Results window=====

[[File:DataVerificationResults-window-example-52.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Data Verification Results window.]]

After you run the tool you will be presented with the {{man label|Data Verification Results}} window.

Depending on your criteria and your data, a list will be shown. The possibilities of findings are listed below. (But others may be added.) Each match will be grouped with similar findings.

* Baptism before birth
* '''Baptism too late according to family tradition'''
: This rule determines the median of days between birth and baptism over all children of a family. It then compares the days between the birth and the baptism of the person in question with also allowing some grace period of deviation. Currently, that grace period is hard-coded with 120 days.
* Birth equals death
* Birth equals marriage
* Burial before baptism
* Burial before birth
* Burial before death
* '''Burial too late'''
: A Burial is considered “too late” when its more than 14 days after the date of death. Should this be a parameter or might this confuse the user?
* '''Children are not in chronological order'''
: Birth dates (if no date exists and estimation is on, Baptism dates are used) are checked for each child of a family. Verifies that dates ascend through the list of children. Children without any of those dates are ignored
* Dead father
* Dead mother
* Death before baptism
* Death before birth
* Death equals marriage
* Disconnected individual
: ones with no parent or spouse or child or sibling
* Early marriage
: ( General tab, default = 17 )
* '''Families are not in chronological order'''
: This Rule uses the marriage date and evaluates that the families are ordered in a chronological order for a person. If no marriage date is available a divorce date or even the birth date of the oldes child of each family is used. The birth date as last possible fallback is used to account for non-married families with illegitimate children.
* '''Family events not ordered in chronological order'''
* '''Family has events with role Unknown'''
* Female husband
* Husband and wife with the same surname
* Invalid birth date
: ( General tab, default = True )
* Invalid death date
: ( General tab, default = True )
* Large age difference between spouses
: ( Families tab, default = 30 )
* Large age differences between children
: ( Families tab, default = 8 )
* '''Large year span for all children'''
: ( Families tab, default = 25 )
* Late marriage
: ( General tab, default = 50 )
* Male wife
* Marriage after death
* Marriage before birth
* Marriage date but not married
* Married often
: ( General tab, default = 3 )
* Multiple parents
* Old age at death
* Old age but no death
: ( General tab, default = 90 )
* Old and unmarried
: ( General tab, default = 50 )
* Old father
: ( Men tab, default = 65 )
* Old mother
: ( Women tab, default = 48 )
* '''Person events not in chronological order'''
* '''Person has events with role Unknown'''
* Same sex marriage
* Too many children
: ( Men tab, default = 15; Women tab, default = 12 )
* Unborn father
* Unborn mother
* Unknown gender
* Young father
: ( Men tab, default = 18 )
* Young mother
: ( Women tab, default = 17 )

On the bottom of the window four buttons are available to make a selection easier. Those are {{man button|Mark all}}, {{man button|Unmark all}}, {{man button|Invert marks}}, and {{man button|Hide marked}}.

Double-clicking on a row will give you a possibility to view and or edit the data.

With the {{man button|Close}} button (or select the keyboard shortcut {{man key press|Alt|C}}) you close the {{man label|Results}} window.
{{-}}

=====Examples=====
Two examples from using real data with this tool:

*:The warning showed 'female husband': checking the data I found a family with father : Anna Roelants. Luckily in the {{man label|Description}} I read: ''The marriage of Adam Roelants and Cornelia Crabbe''. It was clearly a typo: Anna i.s.o. Adam. Without this '''Tool''' it would be very hard to find.

*:The warning showed 'late marriage': checking the data: male person °1738 female person °1756 : marriage X 1804 [Gregorian Calendar] : Everything seemed to be OK: so they (re)married at the age of 66 and 48 years! The warning showed up because the '''General criteria''' was set to '''60'''.
=====See Also=====
* Development discussion on Gramps community support Discourse forum:
: [https://gramps.discourse.group/t/interest-in-enhancing-verify-py/4075/23 Interest in enhancing verify.py]
{{man tip|Difference between {{man label|Verify the Data}} tool and the [[Gramps_6.0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database tool]] |The Check and Repair Database tool detects inconsistencies in the database structure. The {{man label|Verify the Data}} tool, however, is detecting the records that do not satisfy your particular criteria.}}
{{-}}

=== Debug ===

{{man warn|{{man menu|Warning do not use the '''Debug''' tools on your working Family Tree}}|{{man menu|Always create a new empty Family Tree or a copy of your existing Family Tree for testing.}} The tools available in this advanced menu are used for testing only.}}

[[File:MenuOverview-Tools-Debug-menu-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "{{man menu|Tools >Debug>...}}" Menubar - Tools - Debug menu Overview]]

When the command line: Python option <code>-O</code> ''optimise flag'' is not turned on, an additional {{man menu|Debug}} entry appears in the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Tools|Tools]]}} menu and the following tools are available:
* [[Gramps_6.0_Wiki_Manual_-_Tools#Check_Localized_Date_Displayer_and_Parser|Check Localized Date Displayer and Parser]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Dump_Gender_Statistics|Dump Gender Statistics]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Generate_Testcases_for_Persons_and_Families|Generate Testcases for Persons and Families]]
* [[Gramps_6.0_Wiki_Manual_-_Tools#Populate_Sources_and_Citations|Populate Sources and Citations]]

Also See:
* [[Gramps_6.0 Wiki Manual - Command Line#Python options|Command Line: Python options]]
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Uncollected_Objects|Uncollected Objects]] Gramplet
* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] Gramplet
{{-}}
====Check Localized Date Displayer and Parser====

[[File:StartDateTest-dialog-CheckLocalizedDateDisplayerAndParser-Tool-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Start date test?" dialog - for "Check Localized Date Displayer and Parser" - Tool]]

This test tool will create many people showing all different date variants as birth. The death date is created by parsing the result of the date displayer for the birth date. This way you can ensure that dates printed can be parsed back in correctly.

You will be shown the {{man label|Start date test?}} dialog to select either {{man button|Cancel}} to exit or {{man button|Run test}} to start the tool.
{{-}}

====Dump Gender Statistics====

[[File:GenderStatisticsTool-dialog-DumpGenderStatistics-Tool-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender Statistics tool" dialog results example - for "Dump Gender Statistics" - Tool]]

The "Gender Statistics tool" dialog will show the results in list about the statistics for the gender guessing based on the persons first name.

See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.
{{-}}

====Generate Testcases for Persons and Families====

[[File:GenerateTestcases-dialog-GenerateTestcasesForPersonsAndFamilies-Tool-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Generate testcases" dialog - for "Generate Testcases for Persons and Families" - Tool - default]]

The testcase generator will generate some persons and families that have broken links in the database or data that is in conflict to a relation.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.

You can generate testcases that cause the following:
*{{checkbox|0}} {{man label|Generate low level database errors Correction needs database reload}}
*{{checkbox|0}} {{man label|Generate database errors}}
*{{checkbox|1}} {{man label|Generate dummy data}}
*{{checkbox|0}} {{man label|Generate long names}}
*{{checkbox|0}} {{man label|Add special characters}}
*{{checkbox|0}} {{man label|Add serial number}}
*{{checkbox|0}} {{man label|Add line break}}

*{{man label|Number of people to generate (Number is approximate because families are generated)}} <code>2000</code>(default)

Select {{man button|Cancel}} to exit or {{man button|OK}} to start the tool.

{{man button|Help}} will bring you here.

* Command line usage see: [[Plugins_Command_Line#Generate_Testcases_for_Persons_and_Families]]
{{-}}

====Populate Sources and Citations====

[[File:PopulateSourcesAndCitationsTool-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Populate sources and citations tool" dialog - default]]

This tool generates sources and citations for each source in order to populate the database for testing with significant numbers of sources and citations.

Enter the required number and then select {{man button|OK}} to run the tool:
*{{man label|Number of sources:}} <code>2</code> (default)
*{{man label|Number of citations:}} <code>2</code> (default)

Once the tool is complete you will be shown the {{man label|Data generated}} alert dialog.

{{-}}
{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Tools}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Tools]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Settings

2025-12-28T06:07:22Z

CallMeDave: /* Tip of the Day dialog */

{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with settings you can manage within Gramps either in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog or [[Gramps_6.0_Wiki_Manual_-_Settings#Other_settings|other various settings]]. As well as various ways of [[Gramps_6.0_Wiki_Manual_-_Settings#Customizing|customizing]] Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-60.png|center|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all default Preferences tabs]]

Most of the settings affecting the entire Gramps program are configured in the {{man label|Preferences}} dialog. To invoke it, select the menu {{man menu|Edit ➡ Preferences...}} or select the {{man button|[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_Preferences|Open Preferences]]}} icon on the toolbar.

There are overrides that can be set ''before'' running Gramps (such setting the Language shown in the interfaces or for reports) that can be set temporarily or permanently from the [[Gramps_6.0_Wiki_Manual_-_Command_Line|command line interface]].

For configuration options that are limited to the current view or Gramplet set, choose via the menu {{man menu|View ➡ Configure View...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The tabs on the top display the available option categories as follows:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#General|General]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Import|Import]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Text|Text]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Warnings|Warnings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher]]}}

Also ''other'' additional tabs maybe shown from any [[6.0_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab defaults]]
The {{man label|Data}} tab contains preferences relevant to the following two sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Display Options" section defaults]]
The {{man label|Display Options}} section contains the following options:

*{{checkbox|1}}{{man label|Automate Place format:}} This option controls the display of places. {{man tooltip|Enables automatic place title generation using specified format.}} This feature was labeled as "Enable automatic place title generation" in the 5.0 revision and as "Place format(auto place title)" in the 5.1 revision. The [[Gramps_4.1_Wiki_Manual_-_What%27s_new%3F#Place_hierarchies|hierarchy of Places]] was new in the [[Template:Releases/4.1.0|4.1.0]] revision and the [[Gramps_4.2_Wiki_Manual_-_Settings#Places|Places tab]] of Preferences only existed in the 4.2 version. Major revisions are expected for Place hierarchies so this interfaces is likely to relocated and renamed again.
** '''Full''' (default)
*** Selecting the {{man button|Edit...}} button will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]])
** '''DEG Degree,minutes,seconds notation''' (default)
** DEG-: degree, minutes, seconds notation with :
** D.D4 degree notation, 4 decimals
** D.D8 degree notation, 8 decimals (precision like ISO-DMS)
** RT90 Output format for the [https://en.wikipedia.org/wiki/Swedish_grid Swedish coordinate system RT90]
*{{man label|Name format:}} This option controls the display of names in the current database (the setting is saved in the database and is not system wide). In Gramps there are two type of name display formats: the predefined formats, and the user defined custom formats{{man label|Custom name display options are unique to each family tree.}}. Several different predefined name formats are available: '''"Surname, Given Suffix"''' (default), ''"Given Surname Suffix"'', ''"Given"'', ''"Primary[sur] Primary[con] NotPatronymic, Given Patronymic[sur] Suffix Primary[pre]"''
** Clicking on the right hand side {{man button|Edit...}} button will bring up a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}} window where the available list of options is shown. The format is given as well as an example. When predefined formats are not suitable one can define one's own format. You can use the {{man button|Add}} button to add a Name format to the list. Clicking once will give you a '''SURNAME,Given Suffix(call)''' format and as example : '''SMITH, Edwin Jose Sr (Ed)'''. If you added new name formats to the list the {{man button|Remove}} and {{man button|Edit}} buttons become available to change the name format list.
***{{checkbox|0}}{{man label|Consider single pa/matronymic as surname}}: Checkbox unselected by default. If selected enables Gramps to consider patronymic and matronymic names as surnames.

{{man note|1=Besides this database-wide setting|2=Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]]}} dialog}}

*{{man label|Date format *:}} This option controls the display of dates. It is a global setting, requiring a restart of Gramps to take effect, and applies to the display of dates in all databases loaded within Gramps until such time as the date display format is changed again. Several different formats are available, which may be dependent on your locale. {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new date display format}}
** '''YYYY-MM-DD (ISO)''' (default) - Example 2020-09-30 - Displays the date using the international standard [https://wikipedia.org/wiki/ISO_8601 ISO 8601 Data elements and interchange formats – Information interchange] particularly useful when sharing data between countries with different conventions for writing numeric dates and times.
** Numerical
** Month Day, Year
** MON DAY, YEAR
** Day Month Year
** DAY MON YEAR

*{{man label|Age display precision *:}} {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new Age precision format}}
** '''Years''' (default)
** Years, Months
** Years, Months, Days
*{{checkbox|1}}{{man label|Round the year}}
*{{checkbox|1}}{{man label|Display ages for events after death *}} {{man menu|Please note that once changed, it is necessary to restart Gramps to see the change.}}

*{{man label|Calendar on reports:}} '''Gregorian''' (default). This option controls the display of calendar on reports, tools, gramplets, views. Several different calendars are available (see [[Gramps_6.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates|Date Edition]]). Two dates with two different calendars will not properly display timeline or period, (e.g. Using the Gregorian calendar as the default displayed calendar, users will have a better coherency for displaying dates on period).
*{{man label|Calendar on input:}} '''Gregorian''' (default).
*{{man label|Show leap day anniversaries:}} '''On the previous day''' (default). {{man tooltip|For non leap years, anniversaries are displayed on either February 28, March 1 or not at all in Gregorian calendars}}

*{{man label|Status bar:}} This option controls the information displayed in the status bar. This can be either the '''[[Gramps_Glossary#active_person|Active Person]]'s name and ID''' (default) or '''Relationship to [[Gramps_Glossary#home_person|home person]]'''.

*{{man label|Citation formatter:}} '''Legacy''' (default). Select from the available plugins for composing and display of Citation data. The built-in "Legacy" [[Addon_list_legend#cite|CITE plugin]] is compatible with versions 5.1.6 and earlier.

===== Place Format Editor =====
[[File:EditPreferences-Data-tab-DisplayOptions-section-PlaceFormatEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Format Editor - dialog (default) from Menu: "Edit > Preferences..." - "Data" tab "Display Options" section]]

The {{man label|Place Format Editor}} dialog contains preferences relevant to how Places should be shown.

The {{man label|Place Format Editor}} dialog can be accessed from the {{man menu|Edit > Preferences...}} - "Data" tab in the [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]] section via the {{man button|Edit}} button on the {{man label|[] Automate Place Format}} option.

The {{man label|Place Format Editor}} dialog allows you to create custom Place formats by using the {{man button|Add}} button in the left column and choosing how each part of the Place shown should be displayed based on the following settings:

*{{man label|Name:}} <code>New</code> (by default) - A name for the place format strongly suggest you change this to be unique.
*{{man label|Levels:}} <code>:</code> (default colon ":" meaning display all of the place name ) - Select the hierarchy levels of the place names to be displayed.
** Each level in the hierarchy is represented by a positive integer, starting with 0 for the selected place and increasing by 1 for each level up the hierarchy. The levels can also be represented by negative integers, starting with -1 for the top level (usually a country) and decreasing by 1 for each level lower in the hierarchy. In addition, the populated place (city, town, village or hamlet) is represented by the letter p; this can be used with an offset (e.g. p+1 or p-2).
** The names to be displayed are defined as a comma-separated list of ranges. A range can either be a single level, or a start level and an end level separated by a colon. The start level must be less than the end level in a range. The start and end levels default to 0 and -1 if missing.
*{{man label|Street format:}} - Optionally concatenate the number and street in order to suppress the comma.
** '''None''' (default) - Display as is.
** ''Number Street'' - For these options to work, the street must have the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
** ''Street Number'' - as per ''Number Street''
*{{man label|Language:}} (Empty by Default) A [https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes two-digit language code].
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

You can remove a custom place format using the {{man button|Remove}} button.

The {{man label|Place Format Editor}} has one pre-defined format named '''Full''' by default.

{{man note|Creates a <code>place_formats.xml</code> file in your Gramps User directory|Not backed up see: [[Template:Backup_Omissions]]}}

See also:
* [https://github.com/gramps-project/gramps/pull/368 Implement place formats #368]
* [[Hierarchical Place Structure]]
* https://gramps-project.org/wiki/index.php/GEPS_045:_Place_Model_Enhancements_-_Place_Changes_Screenshots#Enhanced_Place_Format_Editor
* [https://sourceforge.net/p/gramps/mailman/message/36637553/ (Gramps-users) Proposed place formatting dialogs] From: Nick Hall. - 2019-04-11
* https://sourceforge.net/p/gramps/mailman/message/36422019/
* https://sourceforge.net/p/gramps/mailman/message/36363239/
* https://sourceforge.net/p/gramps/mailman/message/35694337/
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
====== Example Place Formats ======
{{stub}}
The editor has a new field called "levels". It allows users to select hierarchy levels in the place loosely based on the python string slicing syntax. A number of colon ranges can be specified in a comma-separated list. "0" represents the lowest level - typically a building or street. "-1" represents the highest level - typically a country. The populated place is represented as "p".

For example:
"p:" = Populated place upwards.
"p,-1" = Populated place and country.

Valid options:
* <tt>0 - 9</tt> - Hierarchy Level
* <tt>-</tt> - Negative
* <tt>:</tt> - ??
* <tt>p</tt> - Populated Place
* <tt>,</tt> - comma

Place Format examples
* ["p:" = Populated place upwards]
* ["p,-1" = Populated place and country.]
* [1,p House and city],[p,1 City and house]

It lets you restrict long place descriptions in reports and views. [https://github.com/gramps-project/gramps/pull/368#issuecomment-290886087]

{{-}}

=====Display Name Editor=====

{{man note|1=Custom name display formats are stored in the Family Trees|2=Thus before loading any Family Tree the {{man label|Custom format details}} expander is disabled.}}

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Display Name Editor" - dialog (default) from Menu: "Edit>Preferences..." - "Data" tab > "Display Options" section]]
The {{man label|Display Name Editor}} allows you to define custom name formats, that can be shown on reports and charts at a global level or a per person level.

The {{man label|Display Name Editor}} has two section:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference|Help Reference]]}} section shown at the top
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_list|Display Name list]]}} table section

The {{man label|Display Name Editor}} can be accessed from the menu: {{man menu|Edit>Preferences...}} - {{man label|Data}} tab > {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}} sections {{man label|Name format:}} {{man button|Edit...}} button.
{{-}}
======Help Reference======


Display Name Help Reference:
<hr>
The following keywords are replaced with the appropriate name parts:
* '''Given''' - given name (first name)
* '''Title''' - title (Dr., Mrs.)
* '''Call''' - call name
* '''Initials''' - first letters of Given
* '''Prefix''' - all prefixes (von, de)
* '''Surname''' - surnames (with prefix and connectors)
* '''Suffix''' - suffix (Jr., Sr.)
* '''Nickname''' - nick name
* '''Common''' - nick name as first option if it exists, Call as second option, otherwise first of Given
<hr>
:Surname:
* '''Rest''' - non primary surnames
* '''Familynick''' - family nick name
* '''Primary, Primary[pre] or [sur] or [con]'''- full primary surname, prefix, surname only, connector
* '''Patronymic, or [pre] or [sur] or [con]''' - full pa/matronymic surname, prefix, surname only, connector
* '''Notpatronymic'''- all surnames, except pa/matronymic & primary
* '''Rawsurnames'''- surnames (no prefixes and connectors)
<hr>
{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.
<hr>
:'''Example:''' Dr. Edwin Jose von der Smith and Weston Wilson Sr (“Ed”) - Underhills 
:''Edwin Jose'': '''Given''', ''von der'': '''Prefix''', ''Smith'' and ''Weston'': '''Primary''', ''and'': <abbr title="a connector">'''[con]'''</abbr>, ''Wilson'': '''Patronymic''', 
:''Dr.'': '''Title''', ''Sr'': '''Suffix''', ''Ed'': '''Nickname''', ''Underhills'' <abbr title="family nick name">'''Familynick'''</abbr>, Jose <abbr title="called (preferred given name)">'''Call'''</abbr>.
<hr>
{{-}}

======Help Reference Example person======
[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor's - reference person  shown in the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]] dialog]]

All the fields for the Help Reference '''Example''' person except the Family Nickname can be added in the standard Person Editor dialog. Double-click the Preferred name in Names tab of the Person Editor to access additional fields including: the Family Nick Name, Grouping controls, exception Sorting and Display controls, Date range controls for using a particular name.
{{-}}

======Display Name list======


In this section you can add, remove or edit existing name formats as well as see an example of the formatted name.

Table shows two headings {{man label|Format}} and {{man label|Example}}
* {{man label|Format}} - Based on the name parts shown
* {{man label|Example}} - Displays the name format applied to a ? [[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|builtin reference person]] ?

The List shows four default display name formats they are: 
* ''Surname, Given Suffix'' - displays the name as:
* ''Given Surname Suffix'' - displays the name as:
* ''Given'' - displays the name as: ''Edwin Jose''
* ''xxx''' - displays the name as:

* {{man button|Add}} - a new name format, type the required keywords as needed and press the {{man button|Enter}} key to see the resulting {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|Example]]}}
* {{man button|Remove}} - an existing name format (except for the four default name formats )
* {{man button|Edit}} - an existing name format (except for the four default name formats )
{{stub}}
{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Input Options" section defaults]]

*{{man label|Surname guessing:}} This option affects the initial family name of a child when they are added to the family tree.
** '''Father's surname''' (default) - will use the family name of the father.
** ''None'' - means that no surname guessing will be attempted.
** ''Combination of mother's and father's surname'' - will use the father's name followed by the mother's name.
** ''[https://wikipedia.org/wiki/Icelandic_name Icelandic style]'' - will use the father's given name followed by the "sson" suffix (e.g. the son of Edwin will be guessed as Edwin''sson'').

{{man tip|1=Tip |2=The {{man label|Surname guessing:}} option only affects the initial family name guessed by Gramps when the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog is launched from a {{man label|Family Editor}} window.
You can modify that name any way you see fit. Set this Preferences [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display tab]] option to the value that you will most frequently use, as it will save you a lot of typing.

See:
* [https://gramps-project.org/bugs/view.php?id=1715 feature request to support other local variations for surname guessing]
* [https://wikipedia.org/wiki/Category:Names_by_country Category:Names by country], From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Category:Names_by_language Category:Names by language], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}} - used by the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor]]}} dialog.
** '''Unknown''' (default)
** ''Married''
** ''Unmarried''
** ''Civil Union''

*{{checkbox|0}}{{man label|Hide LDS tab in [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|person]] and [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS_2|family]] editors}}: Latter Days Saints
{{-}}

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-60.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "General" tab "Environment Settings" section defaults]]

This tab contains one section containing preferences relevant to the general operation of the program.

==== Environment Settings ====
*{{checkbox|0}}{{man label|Display Tip of the Day}}: This checkbox option controls the enabling and disabling of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tip_of_the_Day_dialog|Tip of the Day]]}} dialog at startup. {{man tooltip|Show useful information about using Gramps on startup.}}
*{{checkbox|0}}{{man label|Remember last Family Tree}}: Selecting this checkbox option causes the last used database to load upon start. It bypasses the '''Manage Family Trees''' dialog.
*{{checkbox|0}}{{man label|Remember last view displayed}}: This checkbox option controls the enabling and disabling of the display of the last [[Gramps_Glossary#view|View]]. Enabling will bring you to the view where you stopped the program the last time. {{man tooltip|Remember last view displayed and open it next time.}}
*{{checkbox|0}}{{man label|Enable spell checker}}: This checkbox option controls the enabling and disabling of the global spelling checker for notes. The '''[https://gitlab.gnome.org/GNOME/gspell gspell]''' package must be loaded for this to have an effect.[https://github.com/gramps-project/gramps/pull/1450] ( See: [[Troubleshoot Spellcheck]] ) {{man tooltip|Enable the spelling checker for notes.}} (Note the Edit>preferences option enables global English or the language your Gramps is run in and the note context menu is per note in the selected Language of your choice)

*{{checkbox|1}}{{man label|Show text label beside Navigator buttons *}} ''checked'' (default) This checkbox controls whether or not a text description is displayed next to the icon in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Main_Window|Main Window]]. This option takes effect after the program has been restarted. {{man tooltip|Show or hide text beside Navigator buttons (People, Families, Events...). Requires Gramps restart to apply.}}

*{{checkbox|1}}{{man label|Show Clipboard icon on toolbar}}
*{{checkbox|1}}{{man label|Show Reports icon on toolbar}}
*{{checkbox|1}}{{man label|Show Tools icon on toolbar}}
*{{checkbox|1}}{{man label|Show Addons icon on toolbar}}
*{{checkbox|1}}{{man label|Show Preferences icon on toolbar}}
*{{man label|Toolbar Style:}} {{man tooltip|Display text, icons or both on the toolbar buttons.}}
** '''Both text and icons''' (default)
** ''Text only''
** ''Icons only''
*{{checkbox|1}}{{man label|Show close button in gramplet bar tabs}} ''checked''(default) {{man tooltip|Show close button to simplify removing gramplets from bars.}}

*{{man label|Markup for invalid date format:}} Default: <code>%s</code>
** Convenience markups are:
*** Bold (Default)
*** <big><big>Makes font relatively larger</big></big>
*** Italic
*** <s><s>Strikethrough</s></s>
*** Subscript
*** Superscript
*** Makes font relatively smaller
*** <tt><tt>Monospace font</tt></tt>
*** Underline
**** For example: %s will display Underlined bold date.

*{{man label|Multiple surname box height:}} Default: <code>150</code> Pixels {{man tooltip|Enter height in pixels. When multiple surnames are entered, these names display in a box. This setting sets the size of this box.}}

====Tip of the Day dialog====

[[File:TipOfTheDay-dialog--example-PrivacyInGramps-60.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog - example]]

When enabled in {{man menu|Edit > Preferences}} {{man label|General}} tab the {{man label|Tip of the Day}} dialog shows helpful hints.

The following options are available:
*{{checkbox|1}} {{man label|Display on startup}} (check box checked by default - once enabled) - uncheck to stop further tips appearing.
*{{man button|Forward}} - Advance to the next tip.
*{{man button|Close}} - exit for this session until the Gramps program is restarted.
[[Category:Tips]]

{{-}}

=== Family Tree ===
[[File:EditPreferences-FamilyTree-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - defaults]]
The {{man label|Family Tree}} tab contains the following four sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a family tree]] - more information on backups
* [[Template:Backup_Omissions|Backup omissions]] - what is not included during a backup
{{-}}
====Database Settings====
[[File:EditPreferences-FamilyTree-tab-DatabaseSetting-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Settings" section defaults]]

*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** ... If other database backends addons are installed, they will be added to the list <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>: [[Addon:PostgreSQL|PostgreSQL]] backend

See also:
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds experimental support for PostgreSQL databases. Recommended for Experts only!

{{man warn|The ''[[Gramps_Glossary#bsddb|BSDDB]]'' - Legacy Database backend was superseded in the Gramps 5.1 version.|Note that BSDDB can be converted only. BSDDB 3 (Read-only for upgrades) }}
{{-}}

====Database Location====
[[File:EditPreferences-FamilyTree-tab-DatabaseLocation-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Location" section defaults]]
*{{man label|Host:}} - Server address or other computer IP address for the location of the database.
*{{man label|Port:}} - Port number to access the Host database
*{{man label|Database path:}} Unless you have a definite reason to change this, stay with the default path. The default path where databases are stored is <code>grampsdb</code> within the [[Gramps_6.0_Wiki_Manual_-_User_Directory|User Directory]].
{{-}}

====Backup Management====
[[File:EditPreferences-FamilyTree-tab-BackupManagement-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Backup Management" section defaults]]
*{{man label|Backup path:}} - Location in which to save your Gramps backup archive files.
*{{checkbox|1}}{{man label|Backup on exit}} - Selecting this option will Backup Your family tree upon choosing to exit Gramps. The file be saved to the Backup path specified above. The filename of the backup will match the Family Tree appended with a date and time.
*{{man label|Autobackup:}} timer interval for triggering full backups during Gramps editing sessions.
** '''Never''' (''default'')
** Every 15 minutes
** Every 30 minutes
** Every hour
** Every 12 hours
** Every day
{{-}}

====Family Tree's Media path====
[[File:EditPreferences-FamilyTree-tab-FamilyTreesMediaPath-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Family Tree's Media path" section defaults]]
*{{man label|Base media path:}} Here you can fill in a base path for the media objects.
** Selecting the {{man button|Directory}} button gives you a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Select_media_directory_dialog|Select media directory]]}} dialog where you can fill in the required path.

{{man tip|The base relative media path is specific to the active family tree.|It is not a global setting in Gramps. Each family tree is able to have a unique media base path that is stored with the database.}}

{{man tip|To make media paths relative|You also need to select the {{man label|[ ] Convert to a relative path}} checkbox, at the bottom of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_a_media_object_selector|Select a media object selector]]}} dialog. Once checked for the first time it will be remembered for each subsequent media selection.}}

See also:
*[[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|{{man label|Gramps Media Manager}}]] a group of four separate tools two of which allow you to:
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

{{-}}
=====Select media directory dialog=====

{{stub}}

See [[Gramps_6.0_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
[[File:BrokenMediaPath-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media object with a broken filepath]]

If the Preview thumbnails displays 'broken link' icon of a box with a red 'x' you will need to correct {{man label|Base media path:}} for your family tree in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.

See also:
* Example.gramps - [[Example.gramps#Connecting_to_the_example_Media_Objects|Connecting to the example Media Objects]]
* [[Addon:Media_Verify_Tool|Media Verify Tool]] addon tool for revalidating media paths
{{-}}
{{stub}}

=== Import ===
[[File:EditPreferences-Import-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Import" - tab - defaults]]
The {{man label|Import}} tab has two sections as follows:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tag_Records|Tag Records]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Source_GEDCOM_import|Source GEDCOM import]]}}

==== Tag Records ====

*{{checkbox|0}}{{man label|Add tag on import}}: Checkbox (Default: <code>Imported %Y/%m/%d %H:%M:%S</code> ) ''' {{man tooltip|Specified tag will be added on import. Clear to set default value.}} Note - Adding a timestamped [[Gramps_Glossary#tag|Tag]] on import can significantly slow down the importing of your data, but are helpful for the ensuing data cleanup.'''

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|GEDCOM data]]. If this is set, each item that is imported will contain a [[Gramps_Glossary#source|Source]] reference to the imported file. '''Note - Adding a default source can significantly slow down the importing of your GEDCOM data, but are helpful for the ensuing data cleanup.'''

{{-}}

=== Limits ===
[[File:EditPreferences-Limits-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Limits" - tab - defaults]]

Settings used for calculation operations of dates, ages and generations.

See also:
* [[Gramps 6.0 Wiki Manual - Probably Alive]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|Editing dates]]
* Setting the [[Match_dates#Changing_after.2Fbefore.2Fabout_range|date approximation .ini]] manually

==== Calculation limits ====

*{{man label|Date 'about' year range: (date ± #):}} Default: <code>50</code>
** Defines the number of years +/- of the event date "<code>about <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'after' year range: (date + #):}} Default: <code>50</code>
** Defines the number of years after the event date "<code>after <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'before' year range: (date - #):}} Default: <code>50</code>
** Defines the number of years before the event date "<code>before <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Maximum age probably alive:}} Default: <code>110</code>
** Absent a Death event, the age by which Gramps will consider the person is no longer alive.
*{{man label|Maximum sibling age difference:}} Default: <code>20</code>
*{{man label|Minimum years between generations:}} Default: <code>13</code>
*{{man label|Average years between generations:}} Default: <code>20</code>
*{{man label|Max generations for relationships:}} You can enter the number of generations used to determine relationships. The default value is '''<code>15</code>'''. Limits the scope of features based on the [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
[[File:EditPreferences-Colors-tab-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - defaults]]

This tab has seven section related to allowing you to set the '''colors used for boxes in the graphical views'''.

Each of the colors can be customized using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]}}.

==== Colors used for boxes in the graphical views ====

You can select the
* {{man label|Color scheme:}}
** '''Light colors''' (default)
** ''Dark colors''
*** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* {{man label|Background for Alive:}} [ ] #b8cee6
* {{man label|Border for Alive:}} [ ] #1f4986
* {{man label|Background for Dead:}} [ ] #b8cee6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Female persons====
* {{man label|Background for Alive:}} [ ] #feccf0
* {{man label|Border for Alive:}} [ ] #861f69
* {{man label|Background for Dead:}} [ ] #feccf0
* {{man label|Border for Dead:}} [ ] #000000

====Colors for people who are neither male nor female====
* {{man label|Background for Alive:}} [ ] #94ef9e
* {{man label|Border for Alive:}} [ ] #2a5d16
* {{man label|Background for Dead:}} [ ] #94ef9e
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Unknown persons====
* {{man label|Background for Alive:}} [ ] #f3dbb6
* {{man label|Border for Alive:}} [ ] #8e5801
* {{man label|Background for Dead:}} [ ] #f3dbb6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Family nodes====
* {{man label|Default background:}} [ ] #eeeeee
* {{man label|Default border:}} [ ] #cccccc
* {{man label|Background for Married:}} [ ] #eeeeee
* {{man label|Background for Unmarried:}} [ ] #eeeeee
* {{man label|Background for Civil Union:}} [ ] #eeeeee
* {{man label|Background for Unknown:}} [ ] #eeeeee
* {{man label|Background for Divorced:}} [ ] #eeeeee
* {{man label|Border for Divorced:}} [ ] #ff7373

====Other colors====
* {{man label|Background for Home Person:}} [ ] #bbe68a
{{-}}

=== Genealogical Symbols ===
{{stub}}
{{man warn|Prerequisites exist for this feature|The Genealogical Symbols tab can only be used if the [[#Prerequisite_to_use_Genealogical_Symbols|prerequisite]] program <code>[[#Prerequisite_to_use_Genealogical_Symbols|python-fontconfig]]</code> is present that Gramps can use.}}

[[File:EditPreferences-GenealogicalSymbols-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Genealogical Symbols" - tab - defaults]]

Allows you to use Genealogical symbols instead of text abbreviations in reports, charts and the Gramps interface.

This tab gives you the possibility to use one font which is able to show all genealogical symbols. (Once configured see: [[#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]])

If you select the "{{man label|Use symbols}}" checkbox, Gramps will use the selected font if it exists.

This can be useful if you want to add phonetic in a note to show how to pronounce a name or if you mix multiple languages like Greek and Russian.

You can only configure the death symbol from this tab.

:List of Genealogical Symbols shown (listed in order shown at bottom of screenshot):

* Female
* Male
* Asexuality, sexless, genderless
* Lesbianism
* Male homosexuality
* Heterosexuality
* Transgender, hermaphrodite (in entomology)
* Transgender
* Neuter

* Illegitimate
* Birth
* Baptism/Christening
* Engaged
* Marriage
* Divorce
* Unmarried partnership
* Buried
* Cremated/Funeral urn
* Killed in action
* Extinct

* Death

{{-}}

{| class="wikitable"
|-
! meaning
! symbol
! Unicode code point(s)
! name
|-
! male
| ♂
| U+2642
| Male Sign
|-
! female
| ♀
| U+2640
| Female Sign
|-
! unknown
| ⚪︎
| U+26AA
| Medium White Circle
|-
! hermaphrodite
| ⚥
| U+26A5
| Interlocked Male and Female Sign
|-
! neuter
| ⚲
| U+26B2
| Neuter

|-
! birth
| *
| U+002A
| Asterisk
|-
! baptisation, christening
| ~
| U+007E
| Tilde
|-
! death
| ✝︎
| U+271D
| Latin Cross
|-
! burial
| ⚰︎
| U+26B0
| Coffin
|-
! cremation
| ⚱︎
| U+26B1
| Funeral Urn
|-
! stillborn
| ✝︎*
| U+0086 U+002A
| Latin Cross, Asterisk
|-
! born illegitimately
| *⃝
| U+002A U+20DD
| Circled Asterisk
|-
! born illegitimately
| ⊛
| U+229B
| Circled Asterisk Operator
|-
! killed in action
| ⚔︎
| U+2694
| Crossed Swords
|-
! this line extinct
| ‡
| U+2021
| Double Dagger
|-
! approximate(ly)
| ±
| U+00B1
| Plus-Minus
|-
! before
| <
| U+003C
| Less-Than Symbol
|-
! after
| >
| U+003E
| Greater-Than Symbol

|-
! engaged
| ⚬
| U+26AC
| Medium Small White Circle
|-
! married
| ⚭
| U+26AD
| Marriage Symbol
|-
! divorced
| ⚮
| U+26AE
| Divorce Symbol
|-
! unmarried
| ⚯
| U+26AF
| Unmarried Partnership Symbol
|}
{{-}}
====Prerequisite to use Genealogical Symbols====
{{stub}}
[[File:EditPreferences-GenealogicalSymbols-tab-default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences tab - defaults]]

=====Initial setup=====

If the fontconfig [[Gramps_6.0_Wiki_Manual_-_Settings#Prerequisite|prerequisite has been installed]], then on the {{man label|Genealogical Symbols}} tab select the {{man button|Try to find}} button, Gramps will attempt to detect any suitable unicode text fonts that can be used.

[[File:EditPreferences-GenealogicalSymbols-FindFont-51.png|center|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Finding fonts]]

When the search has completed select one of the fonts from the {{man button|Choose font}} list and then select the checkbox:

{{checkbox|1|Use symbols}}

=====Prerequisite=====
Prerequisite : '''python-fontconfig''' : Python bindings of fontconfig and its dependencies are required for displaying genealogical symbols
{{man note|Use the [[Addon:Prerequisites_Checker_Gramplet|Prerequisites Checker]]|Do you have <code>python-fontconfig</code> installed? Run the Prerequisites Checker Addon and look for something similar to the following line:<pre>* python-fontconfig 0.5.0 (Success version 0.5.x is installed.)</pre>}}

See also:
* Tamura Jones expounds on [https://www.tamurajones.net/GenealogySymbols.xhtml Genealogical Symbols] ''(the 'Unicode' section is particularly relevant)''
* [[GEPS 039: Genealogical symbols in gramps]]
* Feature request: {{bug|9098}} Gramps should be able to use genealogy symbols everywhere.
* [[Customize the Genealogical Symbols lookup table]] located in the [[Gramps_6.0_Wiki_Manual_-_User_Directory#MS_Windows|Gramps user directory]] at: [https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py gramps\gen\utils\symbols.py]
{{-}}

=== ID Formats ===
{{man tip|ID Prefixes |The ID prefixes use formatting conventions common for C, Python, and other programming languages. For example, the <code>%04d</code> expands to an integer, prepended with zeros to have the total width of four digits. If you would like IDs to be 1, 2, 3, etc., simply set the formatting parameter to <code>%d</code>, the 'd' specifies Decimal Integer, outputting the number in base 10. See: Python [https://docs.python.org/3/library/string.html#format-specification-mini-language (String) Format Specification Mini-Language]}}

[[File:EditPreferences-IDFormats-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "ID Formats" - tab - defaults]]

This tab contains preferences relevant to the automatic generation of Gramps IDs.

*{{man label|Person:}} Provides the template for generating IDs for a Person. Default value: <code>I%04d</code>
*{{man label|Family:}} Provides the template for generating IDs for a Family. Default value: <code>F%04d</code>
*{{man label|Place:}} Provides the template for generating IDs for a Place. Default value: <code>P%04d</code>
*{{man label|Source:}} Provides the template for generating IDs for a Source. Default value: <code>S%04d</code>
*{{man label|Citation:}} Provides the template for generating IDs for a Citation. Default value: <code>C%04d</code>
*{{man label|Media Object:}} Provides the template for generating IDs for a Media Object. Default value: <code>O%04d</code>
*{{man label|Event:}} Provides the template for generating IDs for an Event. Default value: <code>E%04d</code>
*{{man label|Repository:}} Provides the template for generating IDs for a Repository. Default value: <code>R%04d</code>
*{{man label|Note:}} Provides the template for generating IDs for a Note. Default value: <code>N%04d</code>

You can use the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

[[File:EditPreferences-Text-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Text" - tab - defaults]]

This tab contains one section {{man label|Conditional Text Replacements}} with preferences relevant to how missing and private names and records should be shown.

==== Conditional Text Replacements ====

*{{man label|Missing surname:}} in the input field you can determine how a missing surname should be displayed. Default value is '''<code>[Missing Surname]</code>'''. You can change this to [--] or whatever is most convenient for you.
*{{man label|Missing given name}} in the input field you can determine how a missing given name should be displayed. Default value is '''<code>[Missing Given Name]</code>'''. You can change this to whatever you want.
*{{man label|Missing record:}} Default: <code>[Missing Record]</code>
*{{man label|Private surname:}} Default: <code>[Living]</code>
*{{man label|Private given name:}} Default: <code>[Living]</code>
*{{man label|Private record:}} Default: <code>[Private Record]</code>
{{-}}

=== Warnings ===
[[File:EditPreferences-Warnings-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab has one section {{man label|Warnings and Error dialogs}} that controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

See the [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
==== Warnings and Error dialogs ====
*{{checkbox|0}}{{man label|Suppress warning when adding parents to a child.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_adding_parents_to_a_child|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning when cancelling with changed data.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_cancelling_with_changed_data|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning about missing researcher when exporting to GEDCOM.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_about_missing_researcher_when_exporting_to_GEDCOM|Dialog]])
*{{checkbox|0}}{{man label|Suppress tooltip warnings about data being saved immediately.}} Checkbox unchecked by Default
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])
{{-}}

=== Researcher ===
{{man tip|Researcher Information|This contact information is independent of the family trees you create. Most exports and reports will be filtered to protect the privacy of living people of the Tree... including yourself. This information feeds into the authoring and citation features of any publication (or archival) options.}}
[[File:EditPreferences-Researcher-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Researcher" - tab - defaults]]

Allows you to {{man label|Enter your information so people can contact you when you distribute your Family Tree}} in the corresponding text entry fields. Although Gramps requests information about you, this information is used only so that Gramps can create valid GEDCOM output files. A valid GEDCOM file requires information about the file's creator. If you choose, you may leave the information empty, however none of your exported GEDCOM files will be valid.

The available text entry fields are (all blank by default):
*{{man label|Name:}}
*{{man label|Address:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

The information entered under this preference acts as default value for family tree specific values that can be adjusted with the {{man menu|Tools->Family Tree Processing->[[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information...]]}}.
{{-}}

== Other settings ==

Besides {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Columns editor===

{{man tip|The {{man label|Columns}} editor is available and works in the same way for all list views.|Specifically, it is available for People View, Family View (children list). Sources View, Citations View, Places View, Media View, Repositories View and the Notes View.}}

[[File:ColumnsEditorTab-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Columns''' editor tab - dialog - People Tree View default columns]]

The columns of the list views may be added, removed, or reordered in a {{man label|Columns}} editor dialog.

To use the {{man label|Columns}} editor dialog for the current view, choose via the menu {{man menu|View ➡ Configure...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

Only columns with a selected checkbox will be shown in the view. You can also change the position of a column in the View by clicking and dragging it to a new position in the Editor ([https://wikipedia.org/wiki/Drag-and-drop ''drag and drop'']). Once you have made the changes you want click {{man button|Apply}}, then click {{man button|OK}} to exit the Editor and see your changes in the View.

By default, the View List, displays several columns of information about the respective category. You can add or remove columns to and from the display

The default sort key for the view [always ascending] is the left-most field [i.e. at the top in the Columns Editor], so changing which field is in that position affects default sorting. For some views the first field cannot be changed and the reason will be mentioned at the top of the Columns editor.

The {{man label|Columns Editor}} dialog will have a different selection of columns for each category of View that displays a simple table.

Changes will only be enacted when the {{man button|Apply}} button is clicked.

Once the View columns changes have been applied, clicking once on the column header sorts in ascending order, clicking again sorts in descending order.

The subset of columns and the current [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PersonView-PeopleListView-example-with-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Before''' - default sort by "Name" column "People" Category - "Person" (List) View]]

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''After''' - Sorted by "Birth Date" column in the list mode of the People Category View - example]]

By default, each Category View presenting data in a columnated table layout will sort the rows in ascending order based on the data in the first (left-most) column. If the table has grouped rows, the grouped data will be sub-sorted. ''(Tables in tabbed subsets of data, Editors and Selectors will work similarly.)''

Click once on a different column header to sort on the data of that column in ascending order. Click the header again to sort in reverse order.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]]}} dialog can be used to add, remove and rearrange the displayed columns. Choosing a different first column will make that the new default sorting column of the view [though always ascending].
{{-}}

===Setting Home person===
[[File:MenuEdit-SetHomePerson-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu showing ''Set Home Person'']]

To set (designate) the [[Gramps_Glossary#home_person|Home person]], select the People Category and select the desired person to make them into the [[Gramps_Glossary#active_person|Active Person]] and then choose {{man menu|Edit ->Set Home Person}} via the menus.

Alternately, when editing any Person, right-clicking on inactive areas (areas without a text-entry box) of the top section displays a pop-up menu which includes an option to {{man menu|Make Home Person}} of that profile.

The Home person is the persistently designated person who becomes the [[Gramps_Glossary#active_person|Active Person]] when one of the following occurs:
*By default, when the Family tree database is opened ''(The [[Gramps_6.0_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]] can modify this default behavior. The "Remember last view displayed" will return to the last [[Gramps_Glossary#active_person|Active Person]] of the previous session.)''
*As the toolbar {{man button|Home}} button is clicked
*When the Home menu item is selected from either the {{man button|Go}} menu or the right-click context menu in selected views
*As the [[Gramps_6.0_Wiki_Manual_-_Keybindings#15|keybinding]] {{Man key press|ALT|Home}} is pressed to return to the '''Home Person'''.

The toolbar {{man button|Home}} button is available in the People Category, Relationships Category, and Charts Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Home_Person|Setting the Home Person]]
{{-}}

===Adjusting viewing controls===

Whether the toolbar, the sidebar, or the filter (not available on Charts and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Navigation#View|View]]}} menu will shows for boxes you can click:
*Navigator
*Toolbar
*Sidebar
*Bottombar
*Full Screen {{man key press|F11}}

Additionally, depending on the view you are in, other options will be available on {{man label|Configure}}.

*Gramplets:
**Set Columns to 1
**Set Columns to 2
**Set Columns to 3
*Relationships:
**Show Siblings
**Show Details
*Geography:
**Time period
**Layout

All other Views: the [[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example showing "Export View" menu entry]]

On most [[Gramps_6.0_Wiki_Manual_-_Categories#Categories_of_the_Navigator|Category List Views]], displayed data maybe be exported, choose via the {{man menu|Family Trees ->Export View...}} [[Gramps_6.0_Wiki_Manual_-_Navigation#Main_Menus|menu]] command.

This Menu command only appears if the displayed data can be exported. Gramps will export data on screen according your choice: '''CSV''' or '''Open Document''' spreadsheet format.

Note that the current configuration of the View's columns will control what data will be exported. The export will contain only the displayed column data (in the same order) and be limited to records matching any [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] you have applied.

Use the Views [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect]] tab control the type of CSV to be created.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) filetype - dialog - example]]

Gramps will then display the {{man label|Export View as Spreadsheet}} dialog where after choosing a file location to save to and a name for your file; export data on from the Category List View in one of two spreadsheet formats:
*{{man label|Formats:}}
** '''CSV''' (default)
** '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-ODS-Displayed-in-LibreOfficeCalc-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example ODS Spreadsheet - Displayed in LibreOffice Calc]]

The example screenshot shows an export to the '''OpenDocument Spreadsheet''' (ODS format) displayed as a Spreadsheet in LibreOffice Calc.

{{-}}

====CSV Dialect====
[[File:CSV-Dialect-Tab-dialog-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "CSV Dialect" tab - dialog - example]]

All list table views have a {{man label|CSV Dialect}} tab in the dialog for the {{man menu|View -> Configure...}} menu. You can choose the CSV format's delimiter to be used when exporting and importing data in Gramps.

''Choose your dialect'' from:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_Dialect|excel]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_tab_Dialect|excel-tab]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Unix_Dialect|unix]]}}
*{{man label|Custom}}
**{{man label|Delimiter:}}
*** ',' (default)
*** ';'
*** ':'
*** '|'
*** 'tab'

CSV stands for '''[https://wikipedia.org/wiki/Comma-separated_values comma-separated values]'''. It is a plain text file format that separate data into columns and rows for simple way to exchange data. Originally, data was limited by being separated into columns by fixed positions in <code>.txt</code> text files. When more flexibility was needed, the comma was chosen as a delimiter to mark the boundaries of the columns and the <code>.csv</code> format of a text file was established. To complicate matters, different Operating System marked their end-of-line and end-of-file with different terminating codes.

When comma was needed too frequently in the data itself, a <code>.tsv</code> (tab-separated-values) file format became popular. When other delimiters began being adopted, rather than use up more file extensions, CSV became synonymous with any text format with delimiter marked columns. They were just different 'dialects' of "CSV".

[https://docs.python.org/3/library/csv.html Python's <code>csv</code> module] provides several pre-defined dialects to simplify reading and writing CSV files. These dialects specify rules for parsing and formatting data. The standard dialects include {{man label|excel}}, {{man label|excel-tab}}, and {{man label|unix}}. The following sections outline each dialect's characteristics, including its separator, line terminator, and quoting behavior.

===== Excel Dialect =====

The {{man label|excel}} dialect is designed to be compatible with CSV files generated by Microsoft Excel. It is suitable for data that has been saved from Excel as comma-separated values.
*Separator:** Comma (<code>,</code>`)
*Line Terminator: Carriage return and line feed (<code>\r\n</code>)
*Quoting:
** Double quotes (<code>"</code>`) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Excel-tab Dialect =====

The {{man label|excel-tab}} dialect is similar to the `excel` dialect but uses tabs instead of commas as the separator. This format is often encountered when copying cell data from Excel to the OS clipboard. Pasting tab separated data into the [[Addon:Import_Text_Gramplet|Import Text]] addon gramplet is one of the quickest way to populate parts of your tree.

* Separator: Tab (<code>\t</code>)
* Line Terminator: Carriage return and line feed (<code>\r\n</code>)
* Quoting:
** Double quotes (<code>"</code>) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Unix Dialect =====

The {{man label|unix}} dialect is designed for use in Unix-like environments. It uses a line feed character as the line terminator and always quotes all fields.

* Separator: Comma (<code>,</code>)
* Line Terminator: Line feed (<code>\n</code>)
* Quoting:
** All fields are enclosed in double quotes (<code>"</code>).
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== See also: =====
* [https://github.com/gramps-project/gramps/pull/1314 CSV: possibility to select the dialect. #1314 ]
{{-}}

===Modularity and plugins===


Gramps has been designed for expansion. The Plugin (a.k.a. Plug-in, addon, extension) framework provides a path for third party development outside the normal Gramps release distributions.

The documentation for each addon is maintained outside the flow of these main wiki chapters. The interface and functionality of the software and documentation may not conform with the styles seen throughout the rest of Gramps... although we encourage Developers to try to make their additions as seamless as possible.

A brief description and screenshot of each addon can be found in the [[6.0_Addons#Addon_List|Addon List]] section of the wiki manual. The separately maintained documentation page for the addon is linked from the 1st column of that list.

See [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[6.0 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-section-PlainText-output-settings-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Options - tab defaults for Text Reports (Plain Text - output selected) example]]

What kind of output customization is available? This dialog allows you to change the fonts, font sizes, font color, background color of the text and alignment of paragraphs on the report.

For most report dialogs, in the top part are option tabs specifically related that particular report. The lower part will have more broadly reusable features and is called the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Document_Options|Document Options]]}} section.

From the {{man label|Style:}} drop down list you can choose an existing custom style. Or to make your own {{man label|Style:}} select the {{man button|Style Editor...}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Document_Styles_dialog|Document Styles]]}} dialog and then select the {{man button|Add a new style}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.

{{stub}}
{{-}}
====Document Styles dialog====

[[File:DocumentStyles-dialog-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Styles - dialog - default]]

The {{man label|Document Styles}} dialog, list the ''default'' style and any custom styles for that report and allows you to edit or delete any custom styles you have created. Select the {{man button|+ (Add a new style)}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====
[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

The {{man label|Style editor}} dialog allow you to customize the document style specific to each report.

Change the {{man label|Style sheet name:}} <code>New Style</code> (default) field to a unique name as it will appear in {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Document_Options|Document Options]]}} {{man label|Style:}} drop down list.

Once changes for your custom style have been finalized select the {{man button|OK}} button to save the changes or {{man button|Cancel}} to exit.

=====Style editor dialog tabs=====
On the left hand side you will see the {{man label|Style}} column that list the paragraph options specific to that report that you may modify. For example the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for <code>AHN-Entry</code>, <code>AHN-Generation</code> and <code>AHN-Title</code>.

On the right hand side are three tabs associated with each style listed in the left hand column:
* [[#Description|Description]]
* [[#Font_options|Font options]]
* [[#Paragraph_options|Paragraph options]]

{{-}}
======Description======

[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

*{{man label|Description}} tab describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( <code>AHN-Entry</code> ) with the description: ''The basic style used for the text display.''
{{-}}

======Font options======

[[File:StyleEditor-dialog-FontOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Font options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Font options}} tab allows you to set the {{man label|Type face}} ''Roman'' or ''Swiss'', the {{man label|Size}} of the font in pt.(point), the {{man label|Color}} of the font and some {{man label|Options}} like ''Bold'', ''Italic'' or ''Underline''.
{{-}}

======Paragraph options======

[[File:StyleEditor-dialog-ParagraphOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Paragraph options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Paragraph options}} tab allows you to set the {{man label|Alignment}}, the {{man label|Background color}}, {{man label|Indentation}}, {{man label|Spacing}} and {{man label|Borders}} of your style.
{{-}}

===Context menu===
[[File:Clipboard-dialog-example-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clipboard - with example contextual pop-up menu from right-clicking a Family]]
[[Gramps_6.0_Wiki_Manual_-_Main_Window#Pop-up_menus|Pop-up menus]] are used in various places in Gramps; how you access the context menu is dependent on your operating systems:
* On Microsoft windows, you generally use the right button of your mouse to show the context menu or use the keyboard shortcut {{man button|Shift}}+{{man button|F10}}. see [https://docs.microsoft.com/en-us/previous-versions/windows/desktop/mpc/using-context-menus Using Context Menus - Microsoft Docs]
* On Apple macOS, you generally press {{man button|Ctrl}} while clicking the button of your mouse to show the context menu. see: [https://developer.apple.com/design/human-interface-guidelines/macos/menus/contextual-menus/ Contextual Menus - Menus - macOS - Human Interface Guidelines - Apple Developer]

List of known Context menus in Gramps:
* Pedigree View Context menus
* Clipboard context menu
* File Chooser - Context Menu options
* <Category view> context menus
* Manage Books dialog 
* ... and many more
{{stub}}

See also:
* [[Gramps 6.0 Wiki Manual - Keybindings|Keybindings]]

=== Selector dialogs ===
[[File:SelectFamily-SelectorDialog-example-60.png|450px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]] - showing Search Bar]]


Selector dialogs are a combo interface box and you generally use then to select an object (Person/Family/Events etc). Also various {{man label|Selectors}} also have search bars:
* [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Event_selector|Select Event selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Note_selector|Select Note selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Person_selector|Select Person selector]]
*[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Select_a_person_for_the_report_selector|Select a person for the report selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Father_selector|Select Father selector]] (filtered to Father)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Mother_selector|Select Mother selector]] (filtered to Mother)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Child_selector|Select Child selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Media_Object_selector|Select Media Object selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Place_selector|Select Place selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Repository_selector|Select Repository selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_or_Citation_selector|Select Source or Citation selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_selector|Select Source selector]]

{{-}}
See also
* [https://gramps-project.org/wiki/index.php/GEPS_041:_New_Selector GEPS_041:_New_Selector]
* [[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]

{{stub}}

== Customizing ==
Here are some ways that you can customize Gramps.
=== Preferences ===

In the "Display Options" section of the Edit>Preferences {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}} tab you can select the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}}, allowing the creation of user-defined (custom) stylings beyond the pre-defined (built-in) name format choices.

See [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Name Editor]]}}, allowing the selection of a name format exceptions that will override the format chosen in the Display tab of Preferences for the entire Tree.

The name format, grouping and sorting can be overridden for selected individuals and surnames. The Edit Person dialogs have two Edit buttons to access this feature. The button for Preferred name is to the right of the Suffix field. However, for any selected Name (Preferred or Alternative) in the Names tab which opens the Name Editor. The built-in and custom Display Name formats can be selected exceptions to "Group as:" and "Sort as:" options that default to the Name format selected in Preferences.

=== Pick a Color selector ===
The [[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]] tab of the Preferences allows customizing of the color of various elements of diagrams in the Charts category's graphical views.

==== Color Palette ====
[[File:PickAColor-selector-dialog-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - palette selector dialog]]
Select a color from the 45 [[Gramps_Glossary#swatch|swatches]] in predefined color palette area. Or select from the recently used {{man label|Custom}} color swatches. Or click the {{man button|+}} button to create your own custom color. Right-click on any swatch to add another custom color and open the gradient selector.

You can drag any color swatch to any swatch in the preference (or configure) dialog.

{{-}}
==== Color Gradient ====
[[File:PickAColor-gradient-dialog-52.png|right|thumb|436px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - gradient selector dialog]]
The gradient selector dialog is for adjust the [[Gramps_Glossary#swatch|color swatch]] at the top of the dialog. Once changed, either click the {{man button|Select}} button to apply the color. Drag the single gradient dialog swatch to any swatch in the preference (or configure) dialog.

Specific colors of the swatch can be changed in several ways:
* via direct entry 'color Hex color code'
* the hue slider (with a numeric fine control
* mouse left-click in the 1-dimensional (hue) rainbow gradient or the 2-dimensional (brightness and saturation) hue gradient.
* mouse right-click in either gradient to show the numeric control for the dimension(s) of the gradient
* mouse left-click on the eyedropper color picker to choose from any pixel shown on the monitor(s)
{{-}}

=== File Chooser ===
[[File:FileChooser_Bookmarks_Breadcrumbs.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Linux GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs mac.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} macOS GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs win.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Windows GTK File Chooser: highlighting breadcrumbs and bookmarking]]
The Open and Save dialogs (File Chooser) for Gramps are based on the [https://docs.gtk.org/gtk3/iface.FileChooser.html GTK File Chooser]. Each operating system has expected behaviors for clicks, double-clicks, sorting, [[Gramps_6.0_Wiki_Manual_-_Keybindings#Handy_Shortcuts|keybindings]], environmental variables, and standard file locations that are characteristic of File Chooser dialogs native to the operating system. A few of these can be customized via the user interface to feel more similar to the OS native File Choosers. However, the idiosyncrasies of various OSes mean shared network folders and URI support may not be as readily browsed as when using the OS native File Choosers.

The [https://developer-old.gnome.org/gtk4/stable/GtkFileChooser.html GtkFileChooser] allows for adding quick navigation hotlinks to commonly used places of the filesystem. In the default implementation, these are displayed in the left sidebar navigation pane. It may be a bit unclear at first that these shortcuts come from various sources and in various flavors, so let's explain the terminology here:
* '''[[#Bookmarking_file_folders|Bookmarks]]''': are created by the user, by dragging folders from the right pane to the left pane, or by using the “Add”. Bookmarks can be renamed and deleted by the user.
* '''Shortcuts''': can be provided by the Gramps application. For example, program may want to add a shortcut for a Downloads or Documents folder. Shortcuts ''cannot'' be added or removed by the user. The 'Rename...' context menu option allows them to be relabeled.
* '''Volumes''': are provided by the underlying filesystem abstraction. They are the “roots” of the filesystem. The Home and Downloads hotlinks are common "roots". Volumes cannot be modified by the user.

====File Chooser context menus====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
<hr>
*{{man menu|Open With File Manager}}
<hr>
*{{man menu|Copy Location}}
*{{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]}}
<hr>
*{{man menu|❏ Show Hidden Files}}
*{{man menu|☑ Show Size Column}}
*{{man menu|☑ Show Type Column}}
*{{man menu|❏ Show Time}}
*{{man menu|❏ Sort Folders before Files}}
<hr>

Right-click in the navigation sidebar to open context pop-up menu with the following options:
<hr>
*{{man menu|Open}}
*{{man menu|Remove}}
*{{man menu|Rename...}}
<hr>

====Breadcrumbs and text-entry address bar====
By default, the file folder navigation in the File Chooser is by browsing. There are also some shortcuts on the left and breadcrumbs (highlighted in green in the dialog illustration) for quick navigation up and down the path.

Optionally, a text-entry address bar can be used to directly key-in or paste a path. Toggle between displaying breadcrumbs and the text-entry address bar with the {{Man key press|CTRL|L}} [[Gramps_6.0_Wiki_Manual_-_Keybindings|keybinding]].

====Bookmarking file folders====
File folder bookmarks can be user defined to make finding standard locations easier. These bookmarks are remembered between sessions and regardless of which Family Tree has been loaded.

With any Open or Save dialog open, navigate to the file location containing the folder to be bookmarked. Create the bookmark by either: dragging the folder icon to the navigation column on the left; or, right-clicking that folder to use the {{Man menu|Add to Bookmarks}} context menu option.

Right-clicking an existing Bookmark allows renaming that bookmark or removing it.

====File Formats====
Support for several file formats are built into the standard distribution of Gramps. Import plugin and Export Plugin Addons can be installed via the Plugin Manager or Preferences to expand the options.

See the [[Output_formats|Output Format]] article for list of file formats.

====See also====
* [https://ubuntugenius.wordpress.com/2010/05/14/how-to-show-text-entry-address-bar-or-breadcrumbs-navigation-buttons-in-nautilus-after-ubuntu-10-04-upgrade/ How to Show Text-Entry Address Bar or “Breadcrumbs” (Navigation Buttons)] in Nautilus After Ubuntu 10.04 Upgrade

*Discourse discussions about the GTK File Chooser:
** [https://gramps.discourse.group/t/need-suggestions-for-documenting-the-gtk-file-chooser/1820/8 Documenting the File Chooser in the wiki]
** [https://gramps.discourse.group/t/macos-and-windows-gtk-file-chooser-dialog-capture-request/3364 Illustrating the File Chooser in the Wiki]
** [https://gramps.discourse.group/t/can-i-cause-folders-to-sort-to-the-top-of-the-list-when-presented-with-the-folder-contents/1708/14 File Chooser: Sorting files and folders]
* [https://discourse.gnome.org/t/where-is-the-filechooser-feature-list/9101/1 Where is the FileChooser feature list?]

=== Language ===

Gramps has been translated into a number of [[Portal:Translators|languages]]. Usually Gramps automatically starts in your local language, as chosen for other applications, but sometimes this may not be right for you. And in other cases, a module or addon will not yet have been translated and a warning dialog will appear saying something like “Warning: plugin XYZ has no translation for any of your configured languages, using US English instead”. (Note that the US dialect of English is the default rather than British.) This can become annoying or intrusive.

The most idealistic situation is that you are as fluent in US English as the language selected for the operating system GUI on your computer. And that you would take the opportunity to translate that Gramps feature for users who are non-English speakers.

If your system is configured to show a language other then English, you can override this for Gramps.

As an example, assume that a computer in the Netherlands is configured to default to Unicode 8 Dutch: "LANG: nl_NL.UTF-8". You could either reset the OS language

In Windows, use the SET command to change the LANG environment variable to "en_GB.UTF-8" for British English. You can do this from the command line interface or [https://gramps-project.org/bugs/view.php?id=11009 create a startup shortcut with the following Target]:
<code>C:\Windows\System32\cmd.exe /c "SET LANG=en_GB.UTF-8 && START /D ^"C:\Program Files\GrampsAIO64-6.0.5^" gramps.exe"</code>

{{stub}} '''{{man warn|tbd|Describe for each main platform how the normal language is determined and how the user can [[Howto:Change_the_language_of_reports#Run_Gramps_in_a_different_language|choose a different language]].'''}}

==== Linux ====
{{stub}}

If you want to choose a locale 'variant' for sorting that is not the default variant, then you can start Gramps from the terminal (or console) with a different LC_COLLATE environment. For example, the default sorting (collation) variant for Swedish is "reformed", but you can instead choose "standard" by typing:
export LC_COLLATE="sv_SE.UTF-8@collation=standard"
python Gramps.py

==== macOS ====

For macOS see [[Mac_OS_X:Application_package#Advanced_setup|Advanced setup]] for details on how the language is normally chosen, and how to choose a special, non-default setting for the language, the sorting order or the format of such things as day and month names and number separators.

==== MS Windows ====
[[File:MicrosoftWindowGrampsAIO-Installer-ChooseComponents-Selection-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps 6.0.3 AIO 64 bit for Microsoft Windows installer - "Choose Components" page showing selection of the "de"( German) Translation]]
If you want to run Gramps in another language other than English using the Gramps AIO installer, then you must select it during installation process.

Otherwise it will not be available.

More information can be found at [[Installing_Gramps_for_Windows_computers#Missing_other_languages]] page.

{{-}}

===Add Windows OS Menu Item===
[[File:Edit-Target-GrampsAIO64-Properties-Danish-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for Danish shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_6.0_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 6.x.x}}" icon on Desktop and from menu choose: {{man label|Copy}}.
* Right click anywhere on Desktop and from menu choose: {{man label|Paste shortcut}}
* New icon will be created with name: "{{man label|GrampsAIO64 6.x.x (2)}}"
* Right click on that and from menu choose: {{man label|Properties}}
* A new window will open, click on first tab called {{man label|General}} and change text from "{{man label|GrampsAIO64 6.x.x (2)}}" to something more descriptive like: "{{man label|GrampsAIO Danish}}"
** Click on second tab called {{man label|Shortcut}}, change text in first entry called {{man label|Target}} from (note path will vary depending on Gramps version used):
***<code>"C:\Program Files\GrampsAIO64-6.x.x\grampsw.exe"</code> to:
***<code>%comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"</code>
* Click {{man label|OK}}

Now when you click on that icon Gramps will start in Danish.

{{-}}
{{man tip|You can download a zip file attached to feature request:{{bug|13204}} Gramps AIO64 X.x.x Language icons Shortcuts Pack ( for the languages shown in the [[#Language_codes|Language codes]] table below)}}
{{-}}

===Change the windows LANG variables===
Another option if you want Gramps to always load in say: French Canadian language, you can go to Windows > System Properties, and add the LANG variable in the user section of the environment variables dialog with the appropriate Value.

The value to add is:
<pre>
Name: LANG
Value: fr_CA.UTF-8
</pre>

* [https://www.redswitches.com/blog/environment-variables/#method-1-set-environment-variables-through-the-gui How to Set Environment Variables in Windows 10]

===Language codes===
Select from the following table of [[Portal:Translators|languages Gramps]] has been translated into:

{| {{prettytable}}
!Language
!ISO code
!Example
!Notes
|-
| English-USA (Default)
| en_US.UTF-8
| %comspec% /c set LANG=en_US.UTF-8 && start grampsw.exe"
|
|-
| English (British)
| en_GB.UTF-8
| %comspec% /c set LANG=en_GB.UTF-8 && start grampsw.exe"
|
|-
| Finnish
| fi.UTF-8
| %comspec% /c set LANG=fi.UTF-8 && start grampsw.exe"
|
|-
| Russian
| ru_RU.UTF-8
| %comspec% /c set LANG=ru_RU.UTF-8 && start grampsw.exe"
|
|-
| Albanian
| sq_AL.UTF-8
| %comspec% /c set LANG=sq_AL.UTF-8 && start grampsw.exe"
|
|-
| German
| de_DE.UTF-8
| %comspec% /c set LANG=de_DE.UTF-8 && start grampsw.exe"
|
|-
| French
| fr_FR.UTF-8
| %comspec% /c set LANG=fr_FR.UTF-8 && start grampsw.exe"
|
|-
| French Canadian
| fr_CA.UTF-8
| %comspec% /c set LANG=fr_CA.UTF-8 && start grampsw.exe"
|
|-
| Macedonian
| mk_MK.UTF-8 ???
|
|
|-
| Nederlands (Dutch)
| nl_NL.UTF-8
| %comspec% /c set LANG=nl_NL.UTF-8 && start grampsw.exe"
|
|-
| Dutch
| nl_BE.UTF-8
| %comspec% /c set LANG=nl_BE.UTF-8 && start grampsw.exe"
|
|-
| Slovak
| sk_SK.UTF-8
| %comspec% /c set LANG=sk_SK.UTF-8 && start grampsw.exe"
|
|-
| Hebrew
| he_IL.UTF-8
| %comspec% /c set LANG=he_IL.UTF-8 && start grampsw.exe"
|
|-
| Danish
| da_DK.UTF-8
| %comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"
|
|-
| Greek
| el_GR.UTF-8
| %comspec% /c set LANG=el_GR.UTF-8 && start grampsw.exe"
|
|-
| Italian
| it_IT.UTF-8
| %comspec% /c set LANG=it_IT.UTF-8 && start grampsw.exe"
|
|-
| Esperanto
| eo.UTF-8 ???
|
|
|-
| Chinese (Simplified)
| zh_CN.UTF-8
| %comspec% /c set LANG=zh_CN.UTF-8 && start grampsw.exe"
|
|-
| Chinese (Hong Kong)
| zh_HK.UTF-8 ???
|
|
|-
| Chinese (Traditional)
| zh_TW.UTF-8
| %comspec% /c set LANG=zh_TW.UTF-8 && start grampsw.exe"
|
|-
| Ukrainian
| uk_UA.UTF-8
|
|
|-
| Portuguese
| pt_PT.UTF-8
| %comspec% /c set LANG=pt_PT.UTF-8 && start grampsw.exe"
|
|-
| Portuguese (Brazil)
| pt_BR.UTF-8
| %comspec% /c set LANG=pt_BR.UTF-8 && start grampsw.exe"
|
|-
| Afrikaans
| af_ZA.UTF-8
|
|
|-
| Norwegian Bokmål
| nb_NO.UTF-8
| %comspec% /c set LANG=nb_NO.UTF-8 && start grampsw.exe"
|
|-
| Norwegian Nynorsk
| nn_NO.UTF-8
| %comspec% /c set LANG=nn_NO.UTF-8 && start grampsw.exe"
|
|-
| Turkish
| tr_TR.UTF-8
| %comspec% /c set LANG=tr_TR.UTF-8 && start grampsw.exe"
|
|-
| Spanish
| es_ES.UTF-8
| %comspec% /c set LANG=es_ES.UTF-8 && start grampsw.exe"
|
|-
| Polish
| pl_PL.UTF-8
| %comspec% /c set LANG=pl_PL.UTF-8 && start grampsw.exe"
|
|-
| Slovenian
| sl_SI.UTF-8
| %comspec% /c set LANG=sl_SI.UTF-8 && start grampsw.exe"
|
|-
| Japanese
| ja_JP.UTF-8
| %comspec% /c set LANG=ja_JP.UTF-8 && start grampsw.exe"
|
|-
| Arabic (Saudi Arabia)
| ar_SA.UTF-8
| %comspec% /c set LANG=ar_SA.UTF-8 && start grampsw.exe"
|
|-
|
|
|
|
|-
|
|
|
|
|}
*The language codes are two-letter lowercase ISO language codes (such as "da") as defined by [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1].
*The country codes are two-letter uppercase ISO country codes (such as "BE") as defined by [https://en.wikipedia.org/wiki/ISO_3166-1 ISO 3166-1].

===Advanced manipulation of settings===
{{stub}}

{{man warn| Warning ** Make sure you have closed Gramps **|The contents of this section is outside the scope of interest of a general user of Gramps. If you proceed with tweaking the options on the low level you may damage your Gramps installation. Be careful. '''YOU HAVE BEEN WARNED!'''}}

Besides the settings available in Preferences, you may also wish to explore the advanced settings.

Gramps uses '''[https://en.wikipedia.org/wiki/INI_file#Keys_(properties) INI keys]''' and [https://en.wikipedia.org/wiki/INI_file#Sections INI sections] for managing user preferences and program settings these are stored in the text file <code>gramps.ini</code> under the <code>.gramps/gramps[XX]</code> folder in your home or user directory.

The <code>gramps.ini</code> file has following sections:
* [behavior] : typical Key names are: [https://github.com/gramps-project/gramps/blob/master/gramps/gui/grampsgui.py#L502 betawarn], enable-autobackup, use-tips...
* [colors] :
* [csv] :
* [database] : related to database settings for the Family Tree.
* [export] : export and import folders/directories
* [geography] :
* [interface] : a lot of keys regarding height and width of the different Views: e.g. event-height: 450, event-ref-height: 585, event-ref-width: 728, event-width: 712...
* [paths] : keys related to recent imported files and folders/directories
* [plugin] :
* [preferences] : keys related to preferences: all the common prefixes , todo -colors..
* [researcher] : all information regarding the researcher
* [spacing] :
* [test] :
* [utf8] :

====Example <code>gramps.ini</code> file====
Example contents of the <code>gramps.ini</code> file:


<pre>
;; Gramps key file
;; Automatically created at 2025/05/24 08:49:41

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps60', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps60'
;;autoload=0
;;avg-generation-gap=20
;;check-for-addon-update-types=['new']
;;check-for-addon-updates=0
;;date-about-range=50
;;date-after-range=50
;;date-before-range=50
;;do-not-show-previously-seen-addon-updates=1
;;generation-depth=15
;;immediate-warn=0
;;last-check-for-addon-updates='1970/01/01'
;;max-age-prob-alive=110
;;max-sib-age-diff=20
;;min-generation-years=13
;;owner-warn=0
;;pop-plugin-status=0
;;previously-seen-addon-updates=[]
;;recent-export-type=3
;;runcheck=0
;;spellcheck=0
;;startup=0
;;surname-guessing=0
translator-needed=0
;;use-tips=1
;;web-search-url='https://google.com/search?q=%(text)s'
;;welcome=100

[colors]
;;border-family=['#cccccc', '#252525']
;;border-family-divorced=['#ff7373', '#720b0b']
;;border-female-alive=['#861f69', '#261111']
;;border-female-dead=['#000000', '#000000']
;;border-male-alive=['#1f4986', '#171d26']
;;border-male-dead=['#000000', '#000000']
;;border-other-alive=['#2a5f16', '#26a269']
;;border-other-dead=['#000000', '#000000']
;;border-unknown-alive=['#8e5801', '#8e5801']
;;border-unknown-dead=['#000000', '#000000']
;;family=['#eeeeee', '#454545']
;;family-civil-union=['#eeeeee', '#454545']
;;family-divorced=['#ffdede', '#5c3636']
;;family-married=['#eeeeee', '#454545']
;;family-unknown=['#eeeeee', '#454545']
;;family-unmarried=['#eeeeee', '#454545']
;;female-alive=['#feccf0', '#62242D']
;;female-dead=['#feccf0', '#3a292b']
;;home-person=['#bbe68a', '#304918']
;;male-alive=['#b8cee6', '#1f344a']
;;male-dead=['#b8cee6', '#2d3039']
;;other-alive=['#94ef9e', '#285b27']
;;other-dead=['#94ef9e', '#062304']
;;scheme=0
;;unknown-alive=['#f3dbb6', '#75507B']
;;unknown-dead=['#f3dbb6', '#35103b']

[csv]
;;delimiter=','
;;dialect='excel'

[database]
;;autobackup=0
;;backend='sqlite'
;;backup-on-exit=1
;;backup-path='C:\\Users\\[username]'
;;compress-backup=1
;;host=''
;;path='C:\\Users\\[username]\\AppData\\Roaming\\gramps\\grampsdb'
;;port=''

[export]
;;proxy-order=[['privacy', 0], ['living', 0], ['person', 0], ['note', 0], ['reference', 0]]

[geography]
;;center-lat=0.0
;;center-lon=0.0
;;lock=0
;;map_service=1
;;path=''
;;personal-map=''
;;show_cross=0
;;use-keypad=1
;;zoom=0
;;zoom_when_center=12

[interface]
dbmanager-height=370
;;dbmanager-horiz-position=12
;;dbmanager-vert-position=85
;;dbmanager-width=780
;;dont-ask=0
;;filter=0
;;fullscreen=0
;;grampletbar-close=1
;;hide-lds=0
;;ignore-gexiv2=0
;;ignore-osmgpsmap=0
;;ignore-pil=0
;;main-window-height=500
;;main-window-horiz-position=15
;;main-window-vert-position=10
;;main-window-width=775
;;mapservice='OpenStreetMap'
;;open-with-default-viewer=0
;;pedview-layout=0
;;pedview-show-images=1
;;pedview-show-marriage=0
;;pedview-show-unknown-people=0
;;pedview-tree-direction=2
;;pedview-tree-size=5
;;place-name-height=100
;;place-name-width=450
;;sidebar-text=1
;;size-checked=0
;;statusbar=1
;;surname-box-height=150
;;tipofday-height=350
tipofday-horiz-position=-49
tipofday-vert-position=84
;;tipofday-width=550
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-style=0
;;toolbar-tools=1
;;treemodel-cache-size=1000
;;view=1
;;view-categories=['Dashboard', 'People', 'Relationships', 'Families', 'Ancestry', 'Events', 'Places', 'Geography', 'Sources', 'Citations', 'Repositories', 'Media', 'Notes']

[paths]
;;quick-backup-directory='C:\\Users\\[username]'
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'
;;recent-export-dir='C:\\Users\\[username]'
;;recent-file=''
;;recent-import-dir='C:\\Users\\[username]'
;;report-directory='C:\\Users\\[username]'
;;website-cal-uri=''
;;website-cms-uri=''
;;website-directory='C:\\Users\\[username]'
;;website-extra-page-name=''
;;website-extra-page-uri=''

[plugin]
;;addonplugins=[]
;;hiddenplugins=[]

[preferences]
;;age-after-death=1
;;age-display-precision=1
;;age-rounded-year=1
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-legacy'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=0
;;february-29=0
;;fprefix='F%04d'
;;hide-ep-msg=0
;;invalid-date-format='%s'
;;iprefix='I%04d'
last-view='dashboardview'
last-views=['dashboardview', '', '', '', '', '', '', '', '', '', '', '', '']
;;name-format=1
;;no-given-text='[Missing Given Name]'
;;no-record-text='[Missing Record]'
;;no-surname-text='[Missing Surname]'
;;nprefix='N%04d'
;;online-maps=0
;;oprefix='O%04d'
;;paper-metric=0
;;paper-preference='Letter'
;;patronimic-surname=0
;;place-auto=1
;;place-format=0
;;pprefix='P%04d'
;;private-given-text='[Living]'
;;private-record-text='[Private Record]'
;;private-surname-text='[Living]'
;;quick-backup-include-mode=0
;;rprefix='R%04d'
;;sprefix='S%04d'
;;tag-on-import=0
;;tag-on-import-format='Imported %Y/%m/%d %H:%M:%S'
;;use-last-view=0

[researcher]
;;researcher-addr=''
;;researcher-city=''
;;researcher-country=''
;;researcher-email=''
;;researcher-locality=''
;;researcher-name=''
;;researcher-phone=''
;;researcher-postal=''
;;researcher-state=''

[spacing]
dbman=[22.605613425925927, 5.877459490740741, 9.856047453703704]

[test]
;;january='January'

[utf8]
;;baptism-symbol='~'
;;birth-symbol='*'
;;buried-symbol='[]'
;;cremated-symbol='⚱'
;;dead-symbol='✝'
;;death-symbol=2
;;divorce-symbol='o|o'
;;engaged-symbol='o'
;;in-use=0
;;killed-symbol='x'
;;marriage-symbol='oo'
;;partner-symbol='o-o'
;;selected-font=''
</pre>

====Advanced backup filename setting====
You can also define the naming pattern for the backup filename by setting the ''<code>paths.quick-backup-filename</code>'' in the <code>~/.gramps/gramps60/gramps.ini</code> key file like the following:
{{-}}
[paths]
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'

by removing the two semicolons(<code>;;</code>) from the front of INI key line and using use any of the following keywords for the filename pattern:
*filename
*year
*month
*day
*hour
*minutes
*seconds
*extension :
**'''.gpkg'''(default) if you include media.
**''.gramps'' if you exclude media.

Use the appropriate ~/.gramps/gramps{XX}/gramps.ini key file.
*Gramps version 6.0 :
~/.gramps/gramps60/gramps.ini

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Command_Line#Configuration_.28config.29_option]]
* [[Install_latest_BSDDB#Make_Gramps_use_bsddb3]]
* [[Customize_the_Genealogical_Symbols_lookup_table#Genealogy_symbols_preferences]]

===Theme===
The look of Gramps can be changed.

* [[Addon:ThemePreferences|Addon:Theme Preferences]]
* [[Windows_AIO_themes]]
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]
* [[Overrule_Gramps_Icons]] - for older Gramps versions.
* [[UI style]]

Some reports can also be changed:

* [[Website report Themes]]
{{-}}
{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

User:CallMeDave

2025-12-23T19:56:34Z

CallMeDave: /* Watching */

Hello [https://www.reddit.com/user/call_me_dav Call me Dave]

I try to help out others on the [https://www.reddit.com/r/gramps/ Gramps Reddit].

==Interesting addons==
* [[Addon:Isotammi addons]] - not part of Gramps addons but can be installed very easily.
** SuperTools - excellent tool allows scripts, should be part of Gramps by default!
* [[Addon:GeneanetForGramps]] - unreleased
* [[Addon:CardView]] - unreleased
* https://github.com/jmichault/PersonFS "PersonFS is a gramplet to interface gramps with familysearch.com." [https://gramps.discourse.group/t/sources-and-citations-some-thoughts/2899/45][https://www.geneanet.org/forum/viewtopic.php?p=2272796#p2272796 From this post on Gramps Geneanet Forum [fr] (which include some screenshots)] "Note: it works only on Linux platforms; it needs asynchio Python library unavailable on Windows version of Gramps." https://www.geneanet.org/forum/viewtopic.php?t=803090 https://gramps.discourse.group/t/familysearch-gramplet/3475
* [[Addon:DNAMatches]]
* [https://gramps.discourse.group/t/myheritage-ftb-to-gramps-data-transfer/6516 Import data from MyHeritage Family Tree Builder (FTB) to Gramps][https://github.com/VaZaR00/]
* [https://gramps-project.org/wiki/index.php/Addon:DynamicWeb_report Addon:DynamicWeb_report]

==Gramps info==
===New widget: interactive searchbox. Use our own interactive-search box to get it.===
Introduced in Gramps 4.2.0 (mentioned on Whats New page )
# more efficient (binary search on sorted columns).
# customizable (delayed by 150ms launch of search to avoid text scrambling)

https://gramps-project.org/wiki/index.php/Gramps_4.2_Wiki_Manual_-_What%27s_new%3F#GUI

https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Navigation#Find_a_Record

https://gramps.discourse.group/t/where-is-the-find-box-code/2505

https://github.com/gramps-project/gramps/blob/master/gramps/gui/widgets/interactivesearchbox.py

Press Ctrl-F to open the searchbox on any of the list or just give the list focus (select a line) and start typing

* 150ms is 0.15 seconds ( quarter of a second)
** Whats new mentions the timing is customizable ; so 1000ms is 1 second ( [https://github.com/gramps-project/gramps/blob/48fa8f33052aca542324143a448fc16d60535ed1/gramps/gui/widgets/interactivesearchbox.py#L59 line 59 shows: _SEARCH_DIALOG_LAUNCH_TIMEOUT = 150] and changing that works!

If nothing is typed then after 5 seconds ( 5000ms ) the box goes away ( _SEARCH_DIALOG_TIMEOUT = 5000 )

==Watching==
* https://gramps-project.org/wiki/index.php/Talk:6.0_Addons
* [[Lossless GEDCOM Export]]
* [[Adapt a builtin Report]]
* [[Handler List]]
* [[Previous releases of Gramps]]
* [[Previous releases of Gramps Web]] [https://gramps.discourse.group/t/better-gramps-web-announcements/7706/2] ''If a “previous versions” table in the Wiki would be useful, I could create one... DavidMStraub''
* [[Build from source]]
* [[Template:Backup Omissions]] - list of settings in Gramps that are not transferred in the Gramps XML Backup!
* [[Manual Generation 5.1]] makes a pdf of user manual.
* https://github.com/ben-cohen/editrcs Python code to Library to read, manipulate and write RCS files.(RCS 5.9.2 version ) GPL-3.0 license [https://www.reddit.com/r/gramps/comments/ffd1uj/looking_for_workflowtoolset_for_storing_grampsxml/fjywocm/]

==Handy wiki code==
* <code><nowiki>[[Category:Deletion request]]</nowiki></code>

==Currently editing==

* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Archiving]] - RCS

===Redirects===
* https://gramps-project.org/wiki/index.php/User:Patsyblefebre/User_manual_translations_check_of_redirects_per_Language

==[https://github.com/openzim ZIM] Request for Wiki==
* https://github.com/openzim/zim-requests/issues/1350

[https://en.wikipedia.org/wiki/ZIM_(file_format) The ZIM file format is an open file format that stores website content for offline usage]

==Project info==
* [https://sourceforge.net/p/gramps/mailman/message/36294464/ (Gramps-devel) ADMIN: Gramps Organization ], From: [[Team|Brian Matherly]] - 2018-04-16 02:53:29

[[Category:User|C]]

User:CallMeDave

2025-12-23T19:56:07Z

CallMeDave: /* Interesting addons */

Hello [https://www.reddit.com/user/call_me_dav Call me Dave]

I try to help out others on the [https://www.reddit.com/r/gramps/ Gramps Reddit].

==Interesting addons==
* [[Addon:Isotammi addons]] - not part of Gramps addons but can be installed very easily.
** SuperTools - excellent tool allows scripts, should be part of Gramps by default!
* [[Addon:GeneanetForGramps]] - unreleased
* [[Addon:CardView]] - unreleased
* https://github.com/jmichault/PersonFS "PersonFS is a gramplet to interface gramps with familysearch.com." [https://gramps.discourse.group/t/sources-and-citations-some-thoughts/2899/45][https://www.geneanet.org/forum/viewtopic.php?p=2272796#p2272796 From this post on Gramps Geneanet Forum [fr] (which include some screenshots)] "Note: it works only on Linux platforms; it needs asynchio Python library unavailable on Windows version of Gramps." https://www.geneanet.org/forum/viewtopic.php?t=803090 https://gramps.discourse.group/t/familysearch-gramplet/3475
* [[Addon:DNAMatches]]
* [https://gramps.discourse.group/t/myheritage-ftb-to-gramps-data-transfer/6516 Import data from MyHeritage Family Tree Builder (FTB) to Gramps][https://github.com/VaZaR00/]
* [https://gramps-project.org/wiki/index.php/Addon:DynamicWeb_report Addon:DynamicWeb_report]

==Gramps info==
===New widget: interactive searchbox. Use our own interactive-search box to get it.===
Introduced in Gramps 4.2.0 (mentioned on Whats New page )
# more efficient (binary search on sorted columns).
# customizable (delayed by 150ms launch of search to avoid text scrambling)

https://gramps-project.org/wiki/index.php/Gramps_4.2_Wiki_Manual_-_What%27s_new%3F#GUI

https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Navigation#Find_a_Record

https://gramps.discourse.group/t/where-is-the-find-box-code/2505

https://github.com/gramps-project/gramps/blob/master/gramps/gui/widgets/interactivesearchbox.py

Press Ctrl-F to open the searchbox on any of the list or just give the list focus (select a line) and start typing

* 150ms is 0.15 seconds ( quarter of a second)
** Whats new mentions the timing is customizable ; so 1000ms is 1 second ( [https://github.com/gramps-project/gramps/blob/48fa8f33052aca542324143a448fc16d60535ed1/gramps/gui/widgets/interactivesearchbox.py#L59 line 59 shows: _SEARCH_DIALOG_LAUNCH_TIMEOUT = 150] and changing that works!

If nothing is typed then after 5 seconds ( 5000ms ) the box goes away ( _SEARCH_DIALOG_TIMEOUT = 5000 )

==Watching==
* https://gramps-project.org/wiki/index.php/Talk:6.0_Addons
* [[Lossless GEDCOM Export]]
* [[Adapt a built-in Report]]
* [[Handler List]]
* [[Previous releases of Gramps]]
* [[Previous releases of Gramps Web]] [https://gramps.discourse.group/t/better-gramps-web-announcements/7706/2] ''If a “previous versions” table in the Wiki would be useful, I could create one... DavidMStraub''
* [[Build from source]]
* [[Template:Backup Omissions]] - list of settings in Gramps that are not transferred in the Gramps XML Backup!
* [[Manual Generation 5.1]] makes a pdf of user manual.
* https://github.com/ben-cohen/editrcs Python code to Library to read, manipulate and write RCS files.(RCS 5.9.2 version ) GPL-3.0 license [https://www.reddit.com/r/gramps/comments/ffd1uj/looking_for_workflowtoolset_for_storing_grampsxml/fjywocm/]

==Handy wiki code==
* <code><nowiki>[[Category:Deletion request]]</nowiki></code>

==Currently editing==

* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Archiving]] - RCS

===Redirects===
* https://gramps-project.org/wiki/index.php/User:Patsyblefebre/User_manual_translations_check_of_redirects_per_Language

==[https://github.com/openzim ZIM] Request for Wiki==
* https://github.com/openzim/zim-requests/issues/1350

[https://en.wikipedia.org/wiki/ZIM_(file_format) The ZIM file format is an open file format that stores website content for offline usage]

==Project info==
* [https://sourceforge.net/p/gramps/mailman/message/36294464/ (Gramps-devel) ADMIN: Gramps Organization ], From: [[Team|Brian Matherly]] - 2018-04-16 02:53:29

[[Category:User|C]]

Gramps 6.0 Wiki Manual - Settings

2025-12-23T19:53:29Z

CallMeDave: /* Language codes */ mentioned by codefarmer https://gramps-project.org/bugs/view.php?id=13204#c70135

{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with settings you can manage within Gramps either in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog or [[Gramps_6.0_Wiki_Manual_-_Settings#Other_settings|other various settings]]. As well as various ways of [[Gramps_6.0_Wiki_Manual_-_Settings#Customizing|customizing]] Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-60.png|center|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all default Preferences tabs]]

Most of the settings affecting the entire Gramps program are configured in the {{man label|Preferences}} dialog. To invoke it, select the menu {{man menu|Edit ➡ Preferences...}} or select the {{man button|[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_Preferences|Open Preferences]]}} icon on the toolbar.

There are overrides that can be set ''before'' running Gramps (such setting the Language shown in the interfaces or for reports) that can be set temporarily or permanently from the [[Gramps_6.0_Wiki_Manual_-_Command_Line|command line interface]].

For configuration options that are limited to the current view or Gramplet set, choose via the menu {{man menu|View ➡ Configure View...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The tabs on the top display the available option categories as follows:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#General|General]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Import|Import]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Text|Text]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Warnings|Warnings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher]]}}

Also ''other'' additional tabs maybe shown from any [[6.0_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab defaults]]
The {{man label|Data}} tab contains preferences relevant to the following two sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Display Options" section defaults]]
The {{man label|Display Options}} section contains the following options:

*{{checkbox|1}}{{man label|Automate Place format:}} This option controls the display of places. {{man tooltip|Enables automatic place title generation using specified format.}} This feature was labeled as "Enable automatic place title generation" in the 5.0 revision and as "Place format(auto place title)" in the 5.1 revision. The [[Gramps_4.1_Wiki_Manual_-_What%27s_new%3F#Place_hierarchies|hierarchy of Places]] was new in the [[Template:Releases/4.1.0|4.1.0]] revision and the [[Gramps_4.2_Wiki_Manual_-_Settings#Places|Places tab]] of Preferences only existed in the 4.2 version. Major revisions are expected for Place hierarchies so this interfaces is likely to relocated and renamed again.
** '''Full''' (default)
*** Selecting the {{man button|Edit...}} button will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]])
** '''DEG Degree,minutes,seconds notation''' (default)
** DEG-: degree, minutes, seconds notation with :
** D.D4 degree notation, 4 decimals
** D.D8 degree notation, 8 decimals (precision like ISO-DMS)
** RT90 Output format for the [https://en.wikipedia.org/wiki/Swedish_grid Swedish coordinate system RT90]
*{{man label|Name format:}} This option controls the display of names in the current database (the setting is saved in the database and is not system wide). In Gramps there are two type of name display formats: the predefined formats, and the user defined custom formats{{man label|Custom name display options are unique to each family tree.}}. Several different predefined name formats are available: '''"Surname, Given Suffix"''' (default), ''"Given Surname Suffix"'', ''"Given"'', ''"Primary[sur] Primary[con] NotPatronymic, Given Patronymic[sur] Suffix Primary[pre]"''
** Clicking on the right hand side {{man button|Edit...}} button will bring up a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}} window where the available list of options is shown. The format is given as well as an example. When predefined formats are not suitable one can define one's own format. You can use the {{man button|Add}} button to add a Name format to the list. Clicking once will give you a '''SURNAME,Given Suffix(call)''' format and as example : '''SMITH, Edwin Jose Sr (Ed)'''. If you added new name formats to the list the {{man button|Remove}} and {{man button|Edit}} buttons become available to change the name format list.
***{{checkbox|0}}{{man label|Consider single pa/matronymic as surname}}: Checkbox unselected by default. If selected enables Gramps to consider patronymic and matronymic names as surnames.

{{man note|1=Besides this database-wide setting|2=Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]]}} dialog}}

*{{man label|Date format *:}} This option controls the display of dates. It is a global setting, requiring a restart of Gramps to take effect, and applies to the display of dates in all databases loaded within Gramps until such time as the date display format is changed again. Several different formats are available, which may be dependent on your locale. {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new date display format}}
** '''YYYY-MM-DD (ISO)''' (default) - Example 2020-09-30 - Displays the date using the international standard [https://wikipedia.org/wiki/ISO_8601 ISO 8601 Data elements and interchange formats – Information interchange] particularly useful when sharing data between countries with different conventions for writing numeric dates and times.
** Numerical
** Month Day, Year
** MON DAY, YEAR
** Day Month Year
** DAY MON YEAR

*{{man label|Age display precision *:}} {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new Age precision format}}
** '''Years''' (default)
** Years, Months
** Years, Months, Days
*{{checkbox|1}}{{man label|Round the year}}
*{{checkbox|1}}{{man label|Display ages for events after death *}} {{man menu|Please note that once changed, it is necessary to restart Gramps to see the change.}}

*{{man label|Calendar on reports:}} '''Gregorian''' (default). This option controls the display of calendar on reports, tools, gramplets, views. Several different calendars are available (see [[Gramps_6.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates|Date Edition]]). Two dates with two different calendars will not properly display timeline or period, (e.g. Using the Gregorian calendar as the default displayed calendar, users will have a better coherency for displaying dates on period).
*{{man label|Calendar on input:}} '''Gregorian''' (default).
*{{man label|Show leap day anniversaries:}} '''On the previous day''' (default). {{man tooltip|For non leap years, anniversaries are displayed on either February 28, March 1 or not at all in Gregorian calendars}}

*{{man label|Status bar:}} This option controls the information displayed in the status bar. This can be either the '''[[Gramps_Glossary#active_person|Active Person]]'s name and ID''' (default) or '''Relationship to [[Gramps_Glossary#home_person|home person]]'''.

*{{man label|Citation formatter:}} '''Legacy''' (default). Select from the available plugins for composing and display of Citation data. The built-in "Legacy" [[Addon_list_legend#cite|CITE plugin]] is compatible with versions 5.1.6 and earlier.

===== Place Format Editor =====
[[File:EditPreferences-Data-tab-DisplayOptions-section-PlaceFormatEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Format Editor - dialog (default) from Menu: "Edit > Preferences..." - "Data" tab "Display Options" section]]

The {{man label|Place Format Editor}} dialog contains preferences relevant to how Places should be shown.

The {{man label|Place Format Editor}} dialog can be accessed from the {{man menu|Edit > Preferences...}} - "Data" tab in the [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]] section via the {{man button|Edit}} button on the {{man label|[] Automate Place Format}} option.

The {{man label|Place Format Editor}} dialog allows you to create custom Place formats by using the {{man button|Add}} button in the left column and choosing how each part of the Place shown should be displayed based on the following settings:

*{{man label|Name:}} <code>New</code> (by default) - A name for the place format strongly suggest you change this to be unique.
*{{man label|Levels:}} <code>:</code> (default colon ":" meaning display all of the place name ) - Select the hierarchy levels of the place names to be displayed.
** Each level in the hierarchy is represented by a positive integer, starting with 0 for the selected place and increasing by 1 for each level up the hierarchy. The levels can also be represented by negative integers, starting with -1 for the top level (usually a country) and decreasing by 1 for each level lower in the hierarchy. In addition, the populated place (city, town, village or hamlet) is represented by the letter p; this can be used with an offset (e.g. p+1 or p-2).
** The names to be displayed are defined as a comma-separated list of ranges. A range can either be a single level, or a start level and an end level separated by a colon. The start level must be less than the end level in a range. The start and end levels default to 0 and -1 if missing.
*{{man label|Street format:}} - Optionally concatenate the number and street in order to suppress the comma.
** '''None''' (default) - Display as is.
** ''Number Street'' - For these options to work, the street must have the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
** ''Street Number'' - as per ''Number Street''
*{{man label|Language:}} (Empty by Default) A [https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes two-digit language code].
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

You can remove a custom place format using the {{man button|Remove}} button.

The {{man label|Place Format Editor}} has one pre-defined format named '''Full''' by default.

{{man note|Creates a <code>place_formats.xml</code> file in your Gramps User directory|Not backed up see: [[Template:Backup_Omissions]]}}

See also:
* [https://github.com/gramps-project/gramps/pull/368 Implement place formats #368]
* [[Hierarchical Place Structure]]
* https://gramps-project.org/wiki/index.php/GEPS_045:_Place_Model_Enhancements_-_Place_Changes_Screenshots#Enhanced_Place_Format_Editor
* [https://sourceforge.net/p/gramps/mailman/message/36637553/ (Gramps-users) Proposed place formatting dialogs] From: Nick Hall. - 2019-04-11
* https://sourceforge.net/p/gramps/mailman/message/36422019/
* https://sourceforge.net/p/gramps/mailman/message/36363239/
* https://sourceforge.net/p/gramps/mailman/message/35694337/
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
====== Example Place Formats ======
{{stub}}
The editor has a new field called "levels". It allows users to select hierarchy levels in the place loosely based on the python string slicing syntax. A number of colon ranges can be specified in a comma-separated list. "0" represents the lowest level - typically a building or street. "-1" represents the highest level - typically a country. The populated place is represented as "p".

For example:
"p:" = Populated place upwards.
"p,-1" = Populated place and country.

Valid options:
* <tt>0 - 9</tt> - Hierarchy Level
* <tt>-</tt> - Negative
* <tt>:</tt> - ??
* <tt>p</tt> - Populated Place
* <tt>,</tt> - comma

Place Format examples
* ["p:" = Populated place upwards]
* ["p,-1" = Populated place and country.]
* [1,p House and city],[p,1 City and house]

It lets you restrict long place descriptions in reports and views. [https://github.com/gramps-project/gramps/pull/368#issuecomment-290886087]

{{-}}

=====Display Name Editor=====

{{man note|1=Custom name display formats are stored in the Family Trees|2=Thus before loading any Family Tree the {{man label|Custom format details}} expander is disabled.}}

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Display Name Editor" - dialog (default) from Menu: "Edit>Preferences..." - "Data" tab > "Display Options" section]]
The {{man label|Display Name Editor}} allows you to define custom name formats, that can be shown on reports and charts at a global level or a per person level.

The {{man label|Display Name Editor}} has two section:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference|Help Reference]]}} section shown at the top
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_list|Display Name list]]}} table section

The {{man label|Display Name Editor}} can be accessed from the menu: {{man menu|Edit>Preferences...}} - {{man label|Data}} tab > {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}} sections {{man label|Name format:}} {{man button|Edit...}} button.
{{-}}
======Help Reference======


Display Name Help Reference:
<hr>
The following keywords are replaced with the appropriate name parts:
* '''Given''' - given name (first name)
* '''Title''' - title (Dr., Mrs.)
* '''Call''' - call name
* '''Initials''' - first letters of Given
* '''Prefix''' - all prefixes (von, de)
* '''Surname''' - surnames (with prefix and connectors)
* '''Suffix''' - suffix (Jr., Sr.)
* '''Nickname''' - nick name
* '''Common''' - nick name as first option if it exists, Call as second option, otherwise first of Given
<hr>
:Surname:
* '''Rest''' - non primary surnames
* '''Familynick''' - family nick name
* '''Primary, Primary[pre] or [sur] or [con]'''- full primary surname, prefix, surname only, connector
* '''Patronymic, or [pre] or [sur] or [con]''' - full pa/matronymic surname, prefix, surname only, connector
* '''Notpatronymic'''- all surnames, except pa/matronymic & primary
* '''Rawsurnames'''- surnames (no prefixes and connectors)
<hr>
{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.
<hr>
:'''Example:''' Dr. Edwin Jose von der Smith and Weston Wilson Sr (“Ed”) - Underhills 
:''Edwin Jose'': '''Given''', ''von der'': '''Prefix''', ''Smith'' and ''Weston'': '''Primary''', ''and'': <abbr title="a connector">'''[con]'''</abbr>, ''Wilson'': '''Patronymic''', 
:''Dr.'': '''Title''', ''Sr'': '''Suffix''', ''Ed'': '''Nickname''', ''Underhills'' <abbr title="family nick name">'''Familynick'''</abbr>, Jose <abbr title="called (preferred given name)">'''Call'''</abbr>.
<hr>
{{-}}

======Help Reference Example person======
[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor's - reference person  shown in the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]] dialog]]

All the fields for the Help Reference '''Example''' person except the Family Nickname can be added in the standard Person Editor dialog. Double-click the Preferred name in Names tab of the Person Editor to access additional fields including: the Family Nick Name, Grouping controls, exception Sorting and Display controls, Date range controls for using a particular name.
{{-}}

======Display Name list======


In this section you can add, remove or edit existing name formats as well as see an example of the formatted name.

Table shows two headings {{man label|Format}} and {{man label|Example}}
* {{man label|Format}} - Based on the name parts shown
* {{man label|Example}} - Displays the name format applied to a ? [[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|builtin reference person]] ?

The List shows four default display name formats they are: 
* ''Surname, Given Suffix'' - displays the name as:
* ''Given Surname Suffix'' - displays the name as:
* ''Given'' - displays the name as: ''Edwin Jose''
* ''xxx''' - displays the name as:

* {{man button|Add}} - a new name format, type the required keywords as needed and press the {{man button|Enter}} key to see the resulting {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|Example]]}}
* {{man button|Remove}} - an existing name format (except for the four default name formats )
* {{man button|Edit}} - an existing name format (except for the four default name formats )
{{stub}}
{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Input Options" section defaults]]

*{{man label|Surname guessing:}} This option affects the initial family name of a child when they are added to the family tree.
** '''Father's surname''' (default) - will use the family name of the father.
** ''None'' - means that no surname guessing will be attempted.
** ''Combination of mother's and father's surname'' - will use the father's name followed by the mother's name.
** ''[https://wikipedia.org/wiki/Icelandic_name Icelandic style]'' - will use the father's given name followed by the "sson" suffix (e.g. the son of Edwin will be guessed as Edwin''sson'').

{{man tip|1=Tip |2=The {{man label|Surname guessing:}} option only affects the initial family name guessed by Gramps when the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog is launched from a {{man label|Family Editor}} window.
You can modify that name any way you see fit. Set this Preferences [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display tab]] option to the value that you will most frequently use, as it will save you a lot of typing.

See:
* [https://gramps-project.org/bugs/view.php?id=1715 feature request to support other local variations for surname guessing]
* [https://wikipedia.org/wiki/Category:Names_by_country Category:Names by country], From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Category:Names_by_language Category:Names by language], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}} - used by the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor]]}} dialog.
** '''Unknown''' (default)
** ''Married''
** ''Unmarried''
** ''Civil Union''

*{{checkbox|0}}{{man label|Hide LDS tab in [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|person]] and [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS_2|family]] editors}}: Latter Days Saints
{{-}}

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-60.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "General" tab "Environment Settings" section defaults]]

This tab contains one section containing preferences relevant to the general operation of the program.

==== Environment Settings ====
*{{checkbox|0}}{{man label|Display Tip of the Day}}: This checkbox option controls the enabling and disabling of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tip_of_the_Day_dialog|Tip of the Day]]}} dialog at startup. {{man tooltip|Show useful information about using Gramps on startup.}}
*{{checkbox|0}}{{man label|Remember last Family Tree}}: Selecting this checkbox option causes the last used database to load upon start. It bypasses the '''Manage Family Trees''' dialog.
*{{checkbox|0}}{{man label|Remember last view displayed}}: This checkbox option controls the enabling and disabling of the display of the last [[Gramps_Glossary#view|View]]. Enabling will bring you to the view where you stopped the program the last time. {{man tooltip|Remember last view displayed and open it next time.}}
*{{checkbox|0}}{{man label|Enable spell checker}}: This checkbox option controls the enabling and disabling of the global spelling checker for notes. The '''[https://gitlab.gnome.org/GNOME/gspell gspell]''' package must be loaded for this to have an effect.[https://github.com/gramps-project/gramps/pull/1450] ( See: [[Troubleshoot Spellcheck]] ) {{man tooltip|Enable the spelling checker for notes.}} (Note the Edit>preferences option enables global English or the language your Gramps is run in and the note context menu is per note in the selected Language of your choice)

*{{checkbox|1}}{{man label|Show text label beside Navigator buttons *}} ''checked'' (default) This checkbox controls whether or not a text description is displayed next to the icon in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Main_Window|Main Window]]. This option takes effect after the program has been restarted. {{man tooltip|Show or hide text beside Navigator buttons (People, Families, Events...). Requires Gramps restart to apply.}}

*{{checkbox|1}}{{man label|Show Clipboard icon on toolbar}}
*{{checkbox|1}}{{man label|Show Reports icon on toolbar}}
*{{checkbox|1}}{{man label|Show Tools icon on toolbar}}
*{{checkbox|1}}{{man label|Show Addons icon on toolbar}}
*{{checkbox|1}}{{man label|Show Preferences icon on toolbar}}
*{{man label|Toolbar Style:}} {{man tooltip|Display text, icons or both on the toolbar buttons.}}
** '''Both text and icons''' (default)
** ''Text only''
** ''Icons only''
*{{checkbox|1}}{{man label|Show close button in gramplet bar tabs}} ''checked''(default) {{man tooltip|Show close button to simplify removing gramplets from bars.}}

*{{man label|Markup for invalid date format:}} Default: <code>%s</code>
** Convenience markups are:
*** Bold (Default)
*** <big><big>Makes font relatively larger</big></big>
*** Italic
*** <s><s>Strikethrough</s></s>
*** Subscript
*** Superscript
*** Makes font relatively smaller
*** <tt><tt>Monospace font</tt></tt>
*** Underline
**** For example: %s will display Underlined bold date.

*{{man label|Multiple surname box height:}} Default: <code>150</code> Pixels {{man tooltip|Enter height in pixels. When multiple surnames are entered, these names display in a box. This setting sets the size of this box.}}

====Tip of the Day dialog====

[[File:TipOfTheDay-dialog--example-PrivacyInGramps-60.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog - example]]

When enabled in {{man menu|Edit > Preferences}} {{man label|General}} tab the {{man label|Tip of the Day}} dialog shows helpful hints.

The following options are available:
*{{checkbox|1}} {{man label|Display on startup}} (check box checked by default - once enabled) - uncheck to stop further tips appearing.
*{{man button|Forward}} - Advance to the next tip.
*{{man button|Close}} - exit for this session until the Gramps program is restarted.
[[Category:Tips]]

{{-}}

=== Family Tree ===
[[File:EditPreferences-FamilyTree-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - defaults]]
The {{man label|Family Tree}} tab contains the following four sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a family tree]] - more information on backups
* [[Template:Backup_Omissions|Backup omissions]] - what is not included during a backup
{{-}}
====Database Settings====
[[File:EditPreferences-FamilyTree-tab-DatabaseSetting-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Settings" section defaults]]

*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** ... If other database backends addons are installed, they will be added to the list <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>: [[Addon:PostgreSQL|PostgreSQL]] backend

See also:
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds experimental support for PostgreSQL databases. Recommended for Experts only!

{{man warn|The ''[[Gramps_Glossary#bsddb|BSDDB]]'' - Legacy Database backend was superseded in the Gramps 5.1 version.|Note that BSDDB can be converted only. BSDDB 3 (Read-only for upgrades) }}
{{-}}

====Database Location====
[[File:EditPreferences-FamilyTree-tab-DatabaseLocation-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Location" section defaults]]
*{{man label|Host:}} - Server address or other computer IP address for the location of the database.
*{{man label|Port:}} - Port number to access the Host database
*{{man label|Database path:}} Unless you have a definite reason to change this, stay with the default path. The default path where databases are stored is <code>grampsdb</code> within the [[Gramps_6.0_Wiki_Manual_-_User_Directory|User Directory]].
{{-}}

====Backup Management====
[[File:EditPreferences-FamilyTree-tab-BackupManagement-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Backup Management" section defaults]]
*{{man label|Backup path:}} - Location in which to save your Gramps backup archive files.
*{{checkbox|1}}{{man label|Backup on exit}} - Selecting this option will Backup Your family tree upon choosing to exit Gramps. The file be saved to the Backup path specified above. The filename of the backup will match the Family Tree appended with a date and time.
*{{man label|Autobackup:}} timer interval for triggering full backups during Gramps editing sessions.
** '''Never''' (''default'')
** Every 15 minutes
** Every 30 minutes
** Every hour
** Every 12 hours
** Every day
{{-}}

====Family Tree's Media path====
[[File:EditPreferences-FamilyTree-tab-FamilyTreesMediaPath-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Family Tree's Media path" section defaults]]
*{{man label|Base media path:}} Here you can fill in a base path for the media objects.
** Selecting the {{man button|Directory}} button gives you a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Select_media_directory_dialog|Select media directory]]}} dialog where you can fill in the required path.

{{man tip|The base relative media path is specific to the active family tree.|It is not a global setting in Gramps. Each family tree is able to have a unique media base path that is stored with the database.}}

{{man tip|To make media paths relative|You also need to select the {{man label|[ ] Convert to a relative path}} checkbox, at the bottom of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_a_media_object_selector|Select a media object selector]]}} dialog. Once checked for the first time it will be remembered for each subsequent media selection.}}

See also:
*[[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|{{man label|Gramps Media Manager}}]] a group of four separate tools two of which allow you to:
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

{{-}}
=====Select media directory dialog=====

{{stub}}

See [[Gramps_6.0_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
[[File:BrokenMediaPath-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media object with a broken filepath]]

If the Preview thumbnails displays 'broken link' icon of a box with a red 'x' you will need to correct {{man label|Base media path:}} for your family tree in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.

See also:
* Example.gramps - [[Example.gramps#Connecting_to_the_example_Media_Objects|Connecting to the example Media Objects]]
* [[Addon:Media_Verify_Tool|Media Verify Tool]] addon tool for revalidating media paths
{{-}}
{{stub}}

=== Import ===
[[File:EditPreferences-Import-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Import" - tab - defaults]]
The {{man label|Import}} tab has two sections as follows:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tag_Records|Tag Records]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Source_GEDCOM_import|Source GEDCOM import]]}}

==== Tag Records ====

*{{checkbox|0}}{{man label|Add tag on import}}: Checkbox (Default: <code>Imported %Y/%m/%d %H:%M:%S</code> ) ''' {{man tooltip|Specified tag will be added on import. Clear to set default value.}} Note - Adding a timestamped [[Gramps_Glossary#tag|Tag]] on import can significantly slow down the importing of your data, but are helpful for the ensuing data cleanup.'''

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|GEDCOM data]]. If this is set, each item that is imported will contain a [[Gramps_Glossary#source|Source]] reference to the imported file. '''Note - Adding a default source can significantly slow down the importing of your GEDCOM data, but are helpful for the ensuing data cleanup.'''

{{-}}

=== Limits ===
[[File:EditPreferences-Limits-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Limits" - tab - defaults]]

Settings used for calculation operations of dates, ages and generations.

See also:
* [[Gramps 6.0 Wiki Manual - Probably Alive]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|Editing dates]]
* Setting the [[Match_dates#Changing_after.2Fbefore.2Fabout_range|date approximation .ini]] manually

==== Calculation limits ====

*{{man label|Date 'about' year range: (date ± #):}} Default: <code>50</code>
** Defines the number of years +/- of the event date "<code>about <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'after' year range: (date + #):}} Default: <code>50</code>
** Defines the number of years after the event date "<code>after <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'before' year range: (date - #):}} Default: <code>50</code>
** Defines the number of years before the event date "<code>before <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Maximum age probably alive:}} Default: <code>110</code>
** Absent a Death event, the age by which Gramps will consider the person is no longer alive.
*{{man label|Maximum sibling age difference:}} Default: <code>20</code>
*{{man label|Minimum years between generations:}} Default: <code>13</code>
*{{man label|Average years between generations:}} Default: <code>20</code>
*{{man label|Max generations for relationships:}} You can enter the number of generations used to determine relationships. The default value is '''<code>15</code>'''. Limits the scope of features based on the [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
[[File:EditPreferences-Colors-tab-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - defaults]]

This tab has seven section related to allowing you to set the '''colors used for boxes in the graphical views'''.

Each of the colors can be customized using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]}}.

==== Colors used for boxes in the graphical views ====

You can select the
* {{man label|Color scheme:}}
** '''Light colors''' (default)
** ''Dark colors''
*** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* {{man label|Background for Alive:}} [ ] #b8cee6
* {{man label|Border for Alive:}} [ ] #1f4986
* {{man label|Background for Dead:}} [ ] #b8cee6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Female persons====
* {{man label|Background for Alive:}} [ ] #feccf0
* {{man label|Border for Alive:}} [ ] #861f69
* {{man label|Background for Dead:}} [ ] #feccf0
* {{man label|Border for Dead:}} [ ] #000000

====Colors for people who are neither male nor female====
* {{man label|Background for Alive:}} [ ] #94ef9e
* {{man label|Border for Alive:}} [ ] #2a5d16
* {{man label|Background for Dead:}} [ ] #94ef9e
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Unknown persons====
* {{man label|Background for Alive:}} [ ] #f3dbb6
* {{man label|Border for Alive:}} [ ] #8e5801
* {{man label|Background for Dead:}} [ ] #f3dbb6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Family nodes====
* {{man label|Default background:}} [ ] #eeeeee
* {{man label|Default border:}} [ ] #cccccc
* {{man label|Background for Married:}} [ ] #eeeeee
* {{man label|Background for Unmarried:}} [ ] #eeeeee
* {{man label|Background for Civil Union:}} [ ] #eeeeee
* {{man label|Background for Unknown:}} [ ] #eeeeee
* {{man label|Background for Divorced:}} [ ] #eeeeee
* {{man label|Border for Divorced:}} [ ] #ff7373

====Other colors====
* {{man label|Background for Home Person:}} [ ] #bbe68a
{{-}}

=== Genealogical Symbols ===
{{stub}}
{{man warn|Prerequisites exist for this feature|The Genealogical Symbols tab can only be used if the [[#Prerequisite_to_use_Genealogical_Symbols|prerequisite]] program <code>[[#Prerequisite_to_use_Genealogical_Symbols|python-fontconfig]]</code> is present that Gramps can use.}}

[[File:EditPreferences-GenealogicalSymbols-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Genealogical Symbols" - tab - defaults]]

Allows you to use Genealogical symbols instead of text abbreviations in reports, charts and the Gramps interface.

This tab gives you the possibility to use one font which is able to show all genealogical symbols. (Once configured see: [[#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]])

If you select the "{{man label|Use symbols}}" checkbox, Gramps will use the selected font if it exists.

This can be useful if you want to add phonetic in a note to show how to pronounce a name or if you mix multiple languages like Greek and Russian.

You can only configure the death symbol from this tab.

:List of Genealogical Symbols shown (listed in order shown at bottom of screenshot):

* Female
* Male
* Asexuality, sexless, genderless
* Lesbianism
* Male homosexuality
* Heterosexuality
* Transgender, hermaphrodite (in entomology)
* Transgender
* Neuter

* Illegitimate
* Birth
* Baptism/Christening
* Engaged
* Marriage
* Divorce
* Unmarried partnership
* Buried
* Cremated/Funeral urn
* Killed in action
* Extinct

* Death

{{-}}

{| class="wikitable"
|-
! meaning
! symbol
! Unicode code point(s)
! name
|-
! male
| ♂
| U+2642
| Male Sign
|-
! female
| ♀
| U+2640
| Female Sign
|-
! unknown
| ⚪︎
| U+26AA
| Medium White Circle
|-
! hermaphrodite
| ⚥
| U+26A5
| Interlocked Male and Female Sign
|-
! neuter
| ⚲
| U+26B2
| Neuter

|-
! birth
| *
| U+002A
| Asterisk
|-
! baptisation, christening
| ~
| U+007E
| Tilde
|-
! death
| ✝︎
| U+271D
| Latin Cross
|-
! burial
| ⚰︎
| U+26B0
| Coffin
|-
! cremation
| ⚱︎
| U+26B1
| Funeral Urn
|-
! stillborn
| ✝︎*
| U+0086 U+002A
| Latin Cross, Asterisk
|-
! born illegitimately
| *⃝
| U+002A U+20DD
| Circled Asterisk
|-
! born illegitimately
| ⊛
| U+229B
| Circled Asterisk Operator
|-
! killed in action
| ⚔︎
| U+2694
| Crossed Swords
|-
! this line extinct
| ‡
| U+2021
| Double Dagger
|-
! approximate(ly)
| ±
| U+00B1
| Plus-Minus
|-
! before
| <
| U+003C
| Less-Than Symbol
|-
! after
| >
| U+003E
| Greater-Than Symbol

|-
! engaged
| ⚬
| U+26AC
| Medium Small White Circle
|-
! married
| ⚭
| U+26AD
| Marriage Symbol
|-
! divorced
| ⚮
| U+26AE
| Divorce Symbol
|-
! unmarried
| ⚯
| U+26AF
| Unmarried Partnership Symbol
|}
{{-}}
====Prerequisite to use Genealogical Symbols====
{{stub}}
[[File:EditPreferences-GenealogicalSymbols-tab-default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences tab - defaults]]

=====Initial setup=====

If the fontconfig [[Gramps_6.0_Wiki_Manual_-_Settings#Prerequisite|prerequisite has been installed]], then on the {{man label|Genealogical Symbols}} tab select the {{man button|Try to find}} button, Gramps will attempt to detect any suitable unicode text fonts that can be used.

[[File:EditPreferences-GenealogicalSymbols-FindFont-51.png|center|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Finding fonts]]

When the search has completed select one of the fonts from the {{man button|Choose font}} list and then select the checkbox:

{{checkbox|1|Use symbols}}

=====Prerequisite=====
Prerequisite : '''python-fontconfig''' : Python bindings of fontconfig and its dependencies are required for displaying genealogical symbols
{{man note|Use the [[Addon:Prerequisites_Checker_Gramplet|Prerequisites Checker]]|Do you have <code>python-fontconfig</code> installed? Run the Prerequisites Checker Addon and look for something similar to the following line:<pre>* python-fontconfig 0.5.0 (Success version 0.5.x is installed.)</pre>}}

See also:
* Tamura Jones expounds on [https://www.tamurajones.net/GenealogySymbols.xhtml Genealogical Symbols] ''(the 'Unicode' section is particularly relevant)''
* [[GEPS 039: Genealogical symbols in gramps]]
* Feature request: {{bug|9098}} Gramps should be able to use genealogy symbols everywhere.
* [[Customize the Genealogical Symbols lookup table]] located in the [[Gramps_6.0_Wiki_Manual_-_User_Directory#MS_Windows|Gramps user directory]] at: [https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py gramps\gen\utils\symbols.py]
{{-}}

=== ID Formats ===
{{man tip|ID Prefixes |The ID prefixes use formatting conventions common for C, Python, and other programming languages. For example, the <code>%04d</code> expands to an integer, prepended with zeros to have the total width of four digits. If you would like IDs to be 1, 2, 3, etc., simply set the formatting parameter to <code>%d</code>, the 'd' specifies Decimal Integer, outputting the number in base 10. See: Python [https://docs.python.org/3/library/string.html#format-specification-mini-language (String) Format Specification Mini-Language]}}

[[File:EditPreferences-IDFormats-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "ID Formats" - tab - defaults]]

This tab contains preferences relevant to the automatic generation of Gramps IDs.

*{{man label|Person:}} Provides the template for generating IDs for a Person. Default value: <code>I%04d</code>
*{{man label|Family:}} Provides the template for generating IDs for a Family. Default value: <code>F%04d</code>
*{{man label|Place:}} Provides the template for generating IDs for a Place. Default value: <code>P%04d</code>
*{{man label|Source:}} Provides the template for generating IDs for a Source. Default value: <code>S%04d</code>
*{{man label|Citation:}} Provides the template for generating IDs for a Citation. Default value: <code>C%04d</code>
*{{man label|Media Object:}} Provides the template for generating IDs for a Media Object. Default value: <code>O%04d</code>
*{{man label|Event:}} Provides the template for generating IDs for an Event. Default value: <code>E%04d</code>
*{{man label|Repository:}} Provides the template for generating IDs for a Repository. Default value: <code>R%04d</code>
*{{man label|Note:}} Provides the template for generating IDs for a Note. Default value: <code>N%04d</code>

You can use the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

[[File:EditPreferences-Text-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Text" - tab - defaults]]

This tab contains one section {{man label|Conditional Text Replacements}} with preferences relevant to how missing and private names and records should be shown.

==== Conditional Text Replacements ====

*{{man label|Missing surname:}} in the input field you can determine how a missing surname should be displayed. Default value is '''<code>[Missing Surname]</code>'''. You can change this to [--] or whatever is most convenient for you.
*{{man label|Missing given name}} in the input field you can determine how a missing given name should be displayed. Default value is '''<code>[Missing Given Name]</code>'''. You can change this to whatever you want.
*{{man label|Missing record:}} Default: <code>[Missing Record]</code>
*{{man label|Private surname:}} Default: <code>[Living]</code>
*{{man label|Private given name:}} Default: <code>[Living]</code>
*{{man label|Private record:}} Default: <code>[Private Record]</code>
{{-}}

=== Warnings ===
[[File:EditPreferences-Warnings-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab has one section {{man label|Warnings and Error dialogs}} that controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

See the [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
==== Warnings and Error dialogs ====
*{{checkbox|0}}{{man label|Suppress warning when adding parents to a child.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_adding_parents_to_a_child|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning when cancelling with changed data.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_cancelling_with_changed_data|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning about missing researcher when exporting to GEDCOM.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_about_missing_researcher_when_exporting_to_GEDCOM|Dialog]])
*{{checkbox|0}}{{man label|Suppress tooltip warnings about data being saved immediately.}} Checkbox unchecked by Default
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])
{{-}}

=== Researcher ===
{{man tip|Researcher Information|This contact information is independent of the family trees you create. Most exports and reports will be filtered to protect the privacy of living people of the Tree... including yourself. This information feeds into the authoring and citation features of any publication (or archival) options.}}
[[File:EditPreferences-Researcher-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Researcher" - tab - defaults]]

Allows you to {{man label|Enter your information so people can contact you when you distribute your Family Tree}} in the corresponding text entry fields. Although Gramps requests information about you, this information is used only so that Gramps can create valid GEDCOM output files. A valid GEDCOM file requires information about the file's creator. If you choose, you may leave the information empty, however none of your exported GEDCOM files will be valid.

The available text entry fields are (all blank by default):
*{{man label|Name:}}
*{{man label|Address:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

The information entered under this preference acts as default value for family tree specific values that can be adjusted with the {{man menu|Tools->Family Tree Processing->[[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information...]]}}.
{{-}}

== Other settings ==

Besides {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Columns editor===

{{man tip|The {{man label|Columns}} editor is available and works in the same way for all list views.|Specifically, it is available for People View, Family View (children list). Sources View, Citations View, Places View, Media View, Repositories View and the Notes View.}}

[[File:ColumnsEditorTab-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Columns''' editor tab - dialog - People Tree View default columns]]

The columns of the list views may be added, removed, or reordered in a {{man label|Columns}} editor dialog.

To use the {{man label|Columns}} editor dialog for the current view, choose via the menu {{man menu|View ➡ Configure...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

Only columns with a selected checkbox will be shown in the view. You can also change the position of a column in the View by clicking and dragging it to a new position in the Editor ([https://wikipedia.org/wiki/Drag-and-drop ''drag and drop'']). Once you have made the changes you want click {{man button|Apply}}, then click {{man button|OK}} to exit the Editor and see your changes in the View.

By default, the View List, displays several columns of information about the respective category. You can add or remove columns to and from the display

The default sort key for the view [always ascending] is the left-most field [i.e. at the top in the Columns Editor], so changing which field is in that position affects default sorting. For some views the first field cannot be changed and the reason will be mentioned at the top of the Columns editor.

The {{man label|Columns Editor}} dialog will have a different selection of columns for each category of View that displays a simple table.

Changes will only be enacted when the {{man button|Apply}} button is clicked.

Once the View columns changes have been applied, clicking once on the column header sorts in ascending order, clicking again sorts in descending order.

The subset of columns and the current [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PersonView-PeopleListView-example-with-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Before''' - default sort by "Name" column "People" Category - "Person" (List) View]]

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''After''' - Sorted by "Birth Date" column in the list mode of the People Category View - example]]

By default, each Category View presenting data in a columnated table layout will sort the rows in ascending order based on the data in the first (left-most) column. If the table has grouped rows, the grouped data will be sub-sorted. ''(Tables in tabbed subsets of data, Editors and Selectors will work similarly.)''

Click once on a different column header to sort on the data of that column in ascending order. Click the header again to sort in reverse order.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]]}} dialog can be used to add, remove and rearrange the displayed columns. Choosing a different first column will make that the new default sorting column of the view [though always ascending].
{{-}}

===Setting Home person===
[[File:MenuEdit-SetHomePerson-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu showing ''Set Home Person'']]

To set (designate) the [[Gramps_Glossary#home_person|Home person]], select the People Category and select the desired person to make them into the [[Gramps_Glossary#active_person|Active Person]] and then choose {{man menu|Edit ->Set Home Person}} via the menus.

Alternately, when editing any Person, right-clicking on inactive areas (areas without a text-entry box) of the top section displays a pop-up menu which includes an option to {{man menu|Make Home Person}} of that profile.

The Home person is the persistently designated person who becomes the [[Gramps_Glossary#active_person|Active Person]] when one of the following occurs:
*By default, when the Family tree database is opened ''(The [[Gramps_6.0_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]] can modify this default behavior. The "Remember last view displayed" will return to the last [[Gramps_Glossary#active_person|Active Person]] of the previous session.)''
*As the toolbar {{man button|Home}} button is clicked
*When the Home menu item is selected from either the {{man button|Go}} menu or the right-click context menu in selected views
*As the [[Gramps_6.0_Wiki_Manual_-_Keybindings#15|keybinding]] {{Man key press|ALT|Home}} is pressed to return to the '''Home Person'''.

The toolbar {{man button|Home}} button is available in the People Category, Relationships Category, and Charts Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Home_Person|Setting the Home Person]]
{{-}}

===Adjusting viewing controls===

Whether the toolbar, the sidebar, or the filter (not available on Charts and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Navigation#View|View]]}} menu will shows for boxes you can click:
*Navigator
*Toolbar
*Sidebar
*Bottombar
*Full Screen {{man key press|F11}}

Additionally, depending on the view you are in, other options will be available on {{man label|Configure}}.

*Gramplets:
**Set Columns to 1
**Set Columns to 2
**Set Columns to 3
*Relationships:
**Show Siblings
**Show Details
*Geography:
**Time period
**Layout

All other Views: the [[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example showing "Export View" menu entry]]

On most [[Gramps_6.0_Wiki_Manual_-_Categories#Categories_of_the_Navigator|Category List Views]], displayed data maybe be exported, choose via the {{man menu|Family Trees ->Export View...}} [[Gramps_6.0_Wiki_Manual_-_Navigation#Main_Menus|menu]] command.

This Menu command only appears if the displayed data can be exported. Gramps will export data on screen according your choice: '''CSV''' or '''Open Document''' spreadsheet format.

Note that the current configuration of the View's columns will control what data will be exported. The export will contain only the displayed column data (in the same order) and be limited to records matching any [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] you have applied.

Use the Views [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect]] tab control the type of CSV to be created.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) filetype - dialog - example]]

Gramps will then display the {{man label|Export View as Spreadsheet}} dialog where after choosing a file location to save to and a name for your file; export data on from the Category List View in one of two spreadsheet formats:
*{{man label|Formats:}}
** '''CSV''' (default)
** '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-ODS-Displayed-in-LibreOfficeCalc-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example ODS Spreadsheet - Displayed in LibreOffice Calc]]

The example screenshot shows an export to the '''OpenDocument Spreadsheet''' (ODS format) displayed as a Spreadsheet in LibreOffice Calc.

{{-}}

====CSV Dialect====
[[File:CSV-Dialect-Tab-dialog-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "CSV Dialect" tab - dialog - example]]

All list table views have a {{man label|CSV Dialect}} tab in the dialog for the {{man menu|View -> Configure...}} menu. You can choose the CSV format's delimiter to be used when exporting and importing data in Gramps.

''Choose your dialect'' from:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_Dialect|excel]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_tab_Dialect|excel-tab]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Unix_Dialect|unix]]}}
*{{man label|Custom}}
**{{man label|Delimiter:}}
*** ',' (default)
*** ';'
*** ':'
*** '|'
*** 'tab'

CSV stands for '''[https://wikipedia.org/wiki/Comma-separated_values comma-separated values]'''. It is a plain text file format that separate data into columns and rows for simple way to exchange data. Originally, data was limited by being separated into columns by fixed positions in <code>.txt</code> text files. When more flexibility was needed, the comma was chosen as a delimiter to mark the boundaries of the columns and the <code>.csv</code> format of a text file was established. To complicate matters, different Operating System marked their end-of-line and end-of-file with different terminating codes.

When comma was needed too frequently in the data itself, a <code>.tsv</code> (tab-separated-values) file format became popular. When other delimiters began being adopted, rather than use up more file extensions, CSV became synonymous with any text format with delimiter marked columns. They were just different 'dialects' of "CSV".

[https://docs.python.org/3/library/csv.html Python's <code>csv</code> module] provides several pre-defined dialects to simplify reading and writing CSV files. These dialects specify rules for parsing and formatting data. The standard dialects include {{man label|excel}}, {{man label|excel-tab}}, and {{man label|unix}}. The following sections outline each dialect's characteristics, including its separator, line terminator, and quoting behavior.

===== Excel Dialect =====

The {{man label|excel}} dialect is designed to be compatible with CSV files generated by Microsoft Excel. It is suitable for data that has been saved from Excel as comma-separated values.
*Separator:** Comma (<code>,</code>`)
*Line Terminator: Carriage return and line feed (<code>\r\n</code>)
*Quoting:
** Double quotes (<code>"</code>`) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Excel-tab Dialect =====

The {{man label|excel-tab}} dialect is similar to the `excel` dialect but uses tabs instead of commas as the separator. This format is often encountered when copying cell data from Excel to the OS clipboard. Pasting tab separated data into the [[Addon:Import_Text_Gramplet|Import Text]] addon gramplet is one of the quickest way to populate parts of your tree.

* Separator: Tab (<code>\t</code>)
* Line Terminator: Carriage return and line feed (<code>\r\n</code>)
* Quoting:
** Double quotes (<code>"</code>) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Unix Dialect =====

The {{man label|unix}} dialect is designed for use in Unix-like environments. It uses a line feed character as the line terminator and always quotes all fields.

* Separator: Comma (<code>,</code>)
* Line Terminator: Line feed (<code>\n</code>)
* Quoting:
** All fields are enclosed in double quotes (<code>"</code>).
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== See also: =====
* [https://github.com/gramps-project/gramps/pull/1314 CSV: possibility to select the dialect. #1314 ]
{{-}}

===Modularity and plugins===


Gramps has been designed for expansion. The Plugin (a.k.a. Plug-in, addon, extension) framework provides a path for third party development outside the normal Gramps release distributions.

The documentation for each addon is maintained outside the flow of these main wiki chapters. The interface and functionality of the software and documentation may not conform with the styles seen throughout the rest of Gramps... although we encourage Developers to try to make their additions as seamless as possible.

A brief description and screenshot of each addon can be found in the [[6.0_Addons#Addon_List|Addon List]] section of the wiki manual. The separately maintained documentation page for the addon is linked from the 1st column of that list.

See [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[6.0 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-section-PlainText-output-settings-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Options - tab defaults for Text Reports (Plain Text - output selected) example]]

What kind of output customization is available? This dialog allows you to change the fonts, font sizes, font color, background color of the text and alignment of paragraphs on the report.

For most report dialogs, in the top part are option tabs specifically related that particular report. The lower part will have more broadly reusable features and is called the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Document_Options|Document Options]]}} section.

From the {{man label|Style:}} drop down list you can choose an existing custom style. Or to make your own {{man label|Style:}} select the {{man button|Style Editor...}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Document_Styles_dialog|Document Styles]]}} dialog and then select the {{man button|Add a new style}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.

{{stub}}
{{-}}
====Document Styles dialog====

[[File:DocumentStyles-dialog-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Styles - dialog - default]]

The {{man label|Document Styles}} dialog, list the ''default'' style and any custom styles for that report and allows you to edit or delete any custom styles you have created. Select the {{man button|+ (Add a new style)}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====
[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

The {{man label|Style editor}} dialog allow you to customize the document style specific to each report.

Change the {{man label|Style sheet name:}} <code>New Style</code> (default) field to a unique name as it will appear in {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Document_Options|Document Options]]}} {{man label|Style:}} drop down list.

Once changes for your custom style have been finalized select the {{man button|OK}} button to save the changes or {{man button|Cancel}} to exit.

=====Style editor dialog tabs=====
On the left hand side you will see the {{man label|Style}} column that list the paragraph options specific to that report that you may modify. For example the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for <code>AHN-Entry</code>, <code>AHN-Generation</code> and <code>AHN-Title</code>.

On the right hand side are three tabs associated with each style listed in the left hand column:
* [[#Description|Description]]
* [[#Font_options|Font options]]
* [[#Paragraph_options|Paragraph options]]

{{-}}
======Description======

[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

*{{man label|Description}} tab describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( <code>AHN-Entry</code> ) with the description: ''The basic style used for the text display.''
{{-}}

======Font options======

[[File:StyleEditor-dialog-FontOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Font options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Font options}} tab allows you to set the {{man label|Type face}} ''Roman'' or ''Swiss'', the {{man label|Size}} of the font in pt.(point), the {{man label|Color}} of the font and some {{man label|Options}} like ''Bold'', ''Italic'' or ''Underline''.
{{-}}

======Paragraph options======

[[File:StyleEditor-dialog-ParagraphOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Paragraph options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Paragraph options}} tab allows you to set the {{man label|Alignment}}, the {{man label|Background color}}, {{man label|Indentation}}, {{man label|Spacing}} and {{man label|Borders}} of your style.
{{-}}

===Context menu===
[[File:Clipboard-dialog-example-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clipboard - with example contextual pop-up menu from right-clicking a Family]]
[[Gramps_6.0_Wiki_Manual_-_Main_Window#Pop-up_menus|Pop-up menus]] are used in various places in Gramps; how you access the context menu is dependent on your operating systems:
* On Microsoft windows, you generally use the right button of your mouse to show the context menu or use the keyboard shortcut {{man button|Shift}}+{{man button|F10}}. see [https://docs.microsoft.com/en-us/previous-versions/windows/desktop/mpc/using-context-menus Using Context Menus - Microsoft Docs]
* On Apple macOS, you generally press {{man button|Ctrl}} while clicking the button of your mouse to show the context menu. see: [https://developer.apple.com/design/human-interface-guidelines/macos/menus/contextual-menus/ Contextual Menus - Menus - macOS - Human Interface Guidelines - Apple Developer]

List of known Context menus in Gramps:
* Pedigree View Context menus
* Clipboard context menu
* File Chooser - Context Menu options
* <Category view> context menus
* Manage Books dialog 
* ... and many more
{{stub}}

See also:
* [[Gramps 6.0 Wiki Manual - Keybindings|Keybindings]]

=== Selector dialogs ===
[[File:SelectFamily-SelectorDialog-example-60.png|450px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]] - showing Search Bar]]


Selector dialogs are a combo interface box and you generally use then to select an object (Person/Family/Events etc). Also various {{man label|Selectors}} also have search bars:
* [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Event_selector|Select Event selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Note_selector|Select Note selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Person_selector|Select Person selector]]
*[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Select_a_person_for_the_report_selector|Select a person for the report selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Father_selector|Select Father selector]] (filtered to Father)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Mother_selector|Select Mother selector]] (filtered to Mother)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Child_selector|Select Child selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Media_Object_selector|Select Media Object selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Place_selector|Select Place selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Repository_selector|Select Repository selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_or_Citation_selector|Select Source or Citation selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_selector|Select Source selector]]

{{-}}
See also
* [https://gramps-project.org/wiki/index.php/GEPS_041:_New_Selector GEPS_041:_New_Selector]
* [[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]

{{stub}}

== Customizing ==
Here are some ways that you can customize Gramps.
=== Preferences ===

In the "Display Options" section of the Edit>Preferences {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}} tab you can select the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}}, allowing the creation of user-defined (custom) stylings beyond the pre-defined (built-in) name format choices.

See [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Name Editor]]}}, allowing the selection of a name format exceptions that will override the format chosen in the Display tab of Preferences for the entire Tree.

The name format, grouping and sorting can be overridden for selected individuals and surnames. The Edit Person dialogs have two Edit buttons to access this feature. The button for Preferred name is to the right of the Suffix field. However, for any selected Name (Preferred or Alternative) in the Names tab which opens the Name Editor. The built-in and custom Display Name formats can be selected exceptions to "Group as:" and "Sort as:" options that default to the Name format selected in Preferences.

=== Pick a Color selector ===
The [[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]] tab of the Preferences allows customizing of the color of various elements of diagrams in the Charts category's graphical views.

==== Color Palette ====
[[File:PickAColor-selector-dialog-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - palette selector dialog]]
Select a color from the 45 [[Gramps_Glossary#swatch|swatches]] in predefined color palette area. Or select from the recently used {{man label|Custom}} color swatches. Or click the {{man button|+}} button to create your own custom color. Right-click on any swatch to add another custom color and open the gradient selector.

You can drag any color swatch to any swatch in the preference (or configure) dialog.

{{-}}
==== Color Gradient ====
[[File:PickAColor-gradient-dialog-52.png|right|thumb|436px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - gradient selector dialog]]
The gradient selector dialog is for adjust the [[Gramps_Glossary#swatch|color swatch]] at the top of the dialog. Once changed, either click the {{man button|Select}} button to apply the color. Drag the single gradient dialog swatch to any swatch in the preference (or configure) dialog.

Specific colors of the swatch can be changed in several ways:
* via direct entry 'color Hex color code'
* the hue slider (with a numeric fine control
* mouse left-click in the 1-dimensional (hue) rainbow gradient or the 2-dimensional (brightness and saturation) hue gradient.
* mouse right-click in either gradient to show the numeric control for the dimension(s) of the gradient
* mouse left-click on the eyedropper color picker to choose from any pixel shown on the monitor(s)
{{-}}

=== File Chooser ===
[[File:FileChooser_Bookmarks_Breadcrumbs.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Linux GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs mac.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} macOS GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs win.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Windows GTK File Chooser: highlighting breadcrumbs and bookmarking]]
The Open and Save dialogs (File Chooser) for Gramps are based on the [https://docs.gtk.org/gtk3/iface.FileChooser.html GTK File Chooser]. Each operating system has expected behaviors for clicks, double-clicks, sorting, [[Gramps_6.0_Wiki_Manual_-_Keybindings#Handy_Shortcuts|keybindings]], environmental variables, and standard file locations that are characteristic of File Chooser dialogs native to the operating system. A few of these can be customized via the user interface to feel more similar to the OS native File Choosers. However, the idiosyncrasies of various OSes mean shared network folders and URI support may not be as readily browsed as when using the OS native File Choosers.

The [https://developer-old.gnome.org/gtk4/stable/GtkFileChooser.html GtkFileChooser] allows for adding quick navigation hotlinks to commonly used places of the filesystem. In the default implementation, these are displayed in the left sidebar navigation pane. It may be a bit unclear at first that these shortcuts come from various sources and in various flavors, so let's explain the terminology here:
* '''[[#Bookmarking_file_folders|Bookmarks]]''': are created by the user, by dragging folders from the right pane to the left pane, or by using the “Add”. Bookmarks can be renamed and deleted by the user.
* '''Shortcuts''': can be provided by the Gramps application. For example, program may want to add a shortcut for a Downloads or Documents folder. Shortcuts ''cannot'' be added or removed by the user. The 'Rename...' context menu option allows them to be relabeled.
* '''Volumes''': are provided by the underlying filesystem abstraction. They are the “roots” of the filesystem. The Home and Downloads hotlinks are common "roots". Volumes cannot be modified by the user.

====File Chooser context menus====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
<hr>
*{{man menu|Open With File Manager}}
<hr>
*{{man menu|Copy Location}}
*{{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]}}
<hr>
*{{man menu|❏ Show Hidden Files}}
*{{man menu|☑ Show Size Column}}
*{{man menu|☑ Show Type Column}}
*{{man menu|❏ Show Time}}
*{{man menu|❏ Sort Folders before Files}}
<hr>

Right-click in the navigation sidebar to open context pop-up menu with the following options:
<hr>
*{{man menu|Open}}
*{{man menu|Remove}}
*{{man menu|Rename...}}
<hr>

====Breadcrumbs and text-entry address bar====
By default, the file folder navigation in the File Chooser is by browsing. There are also some shortcuts on the left and breadcrumbs (highlighted in green in the dialog illustration) for quick navigation up and down the path.

Optionally, a text-entry address bar can be used to directly key-in or paste a path. Toggle between displaying breadcrumbs and the text-entry address bar with the {{Man key press|CTRL|L}} [[Gramps_6.0_Wiki_Manual_-_Keybindings|keybinding]].

====Bookmarking file folders====
File folder bookmarks can be user defined to make finding standard locations easier. These bookmarks are remembered between sessions and regardless of which Family Tree has been loaded.

With any Open or Save dialog open, navigate to the file location containing the folder to be bookmarked. Create the bookmark by either: dragging the folder icon to the navigation column on the left; or, right-clicking that folder to use the {{Man menu|Add to Bookmarks}} context menu option.

Right-clicking an existing Bookmark allows renaming that bookmark or removing it.

====File Formats====
Support for several file formats are built into the standard distribution of Gramps. Import plugin and Export Plugin Addons can be installed via the Plugin Manager or Preferences to expand the options.

See the [[Output_formats|Output Format]] article for list of file formats.

====See also====
* [https://ubuntugenius.wordpress.com/2010/05/14/how-to-show-text-entry-address-bar-or-breadcrumbs-navigation-buttons-in-nautilus-after-ubuntu-10-04-upgrade/ How to Show Text-Entry Address Bar or “Breadcrumbs” (Navigation Buttons)] in Nautilus After Ubuntu 10.04 Upgrade

*Discourse discussions about the GTK File Chooser:
** [https://gramps.discourse.group/t/need-suggestions-for-documenting-the-gtk-file-chooser/1820/8 Documenting the File Chooser in the wiki]
** [https://gramps.discourse.group/t/macos-and-windows-gtk-file-chooser-dialog-capture-request/3364 Illustrating the File Chooser in the Wiki]
** [https://gramps.discourse.group/t/can-i-cause-folders-to-sort-to-the-top-of-the-list-when-presented-with-the-folder-contents/1708/14 File Chooser: Sorting files and folders]
* [https://discourse.gnome.org/t/where-is-the-filechooser-feature-list/9101/1 Where is the FileChooser feature list?]

=== Language ===

Gramps has been translated into a number of [[Portal:Translators|languages]]. Usually Gramps automatically starts in your local language, as chosen for other applications, but sometimes this may not be right for you. And in other cases, a module or addon will not yet have been translated and a warning dialog will appear saying something like “Warning: plugin XYZ has no translation for any of your configured languages, using US English instead”. (Note that the US dialect of English is the default rather than British.) This can become annoying or intrusive.

The most idealistic situation is that you are as fluent in US English as the language selected for the operating system GUI on your computer. And that you would take the opportunity to translate that Gramps feature for users who are non-English speakers.

If your system is configured to show a language other then English, you can override this for Gramps.

As an example, assume that a computer in the Netherlands is configured to default to Unicode 8 Dutch: "LANG: nl_NL.UTF-8". You could either reset the OS language

In Windows, use the SET command to change the LANG environment variable to "en_GB.UTF-8" for British English. You can do this from the command line interface or [https://gramps-project.org/bugs/view.php?id=11009 create a startup shortcut with the following Target]:
<code>C:\Windows\System32\cmd.exe /c "SET LANG=en_GB.UTF-8 && START /D ^"C:\Program Files\GrampsAIO64-6.0.5^" gramps.exe"</code>

{{stub}} '''{{man warn|tbd|Describe for each main platform how the normal language is determined and how the user can [[Howto:Change_the_language_of_reports#Run_Gramps_in_a_different_language|choose a different language]].'''}}

==== Linux ====
{{stub}}

If you want to choose a locale 'variant' for sorting that is not the default variant, then you can start Gramps from the terminal (or console) with a different LC_COLLATE environment. For example, the default sorting (collation) variant for Swedish is "reformed", but you can instead choose "standard" by typing:
export LC_COLLATE="sv_SE.UTF-8@collation=standard"
python Gramps.py

==== macOS ====

For macOS see [[Mac_OS_X:Application_package#Advanced_setup|Advanced setup]] for details on how the language is normally chosen, and how to choose a special, non-default setting for the language, the sorting order or the format of such things as day and month names and number separators.

==== MS Windows ====
[[File:MicrosoftWindowGrampsAIO-Installer-ChooseComponents-Selection-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps 6.0.3 AIO 64 bit for Microsoft Windows installer - "Choose Components" page showing selection of the "de"( German) Translation]]
If you want to run Gramps in another language other than English using the Gramps AIO installer, then you must select it during installation process.

Otherwise it will not be available.

More information can be found at [[Installing_Gramps_for_Windows_computers#Missing_other_languages]] page.

{{-}}

===Add Windows OS Menu Item===
[[File:Edit-Target-GrampsAIO64-Properties-Danish-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for Danish shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_6.0_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 6.x.x}}" icon on Desktop and from menu choose: {{man label|Copy}}.
* Right click anywhere on Desktop and from menu choose: {{man label|Paste shortcut}}
* New icon will be created with name: "{{man label|GrampsAIO64 6.x.x (2)}}"
* Right click on that and from menu choose: {{man label|Properties}}
* A new window will open, click on first tab called {{man label|General}} and change text from "{{man label|GrampsAIO64 6.x.x (2)}}" to something more descriptive like: "{{man label|GrampsAIO Danish}}"
** Click on second tab called {{man label|Shortcut}}, change text in first entry called {{man label|Target}} from (note path will vary depending on Gramps version used):
***<code>"C:\Program Files\GrampsAIO64-6.x.x\grampsw.exe"</code> to:
***<code>%comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"</code>
* Click {{man label|OK}}

Now when you click on that icon Gramps will start in Danish.

{{-}}
{{man tip|You can download a zip file attached to feature request:{{bug|13204}} Gramps AIO64 5.2 Language icons Shortcuts Pack ( for the languages shown in the [[#Language_codes|Language codes]] table below)}}
{{-}}

===Change the windows LANG variables===
Another option if you want Gramps to always load in say: French Canadian language, you can go to Windows > System Properties, and add the LANG variable in the user section of the environment variables dialog with the appropriate Value.

The value to add is:
<pre>
Name: LANG
Value: fr_CA.UTF-8
</pre>

* [https://www.redswitches.com/blog/environment-variables/#method-1-set-environment-variables-through-the-gui How to Set Environment Variables in Windows 10]

===Language codes===
Select from the following table of [[Portal:Translators|languages Gramps]] has been translated into:

{| {{prettytable}}
!Language
!ISO code
!Example
!Notes
|-
| English-USA (Default)
| en_US.UTF-8
| %comspec% /c set LANG=en_US.UTF-8 && start grampsw.exe"
|
|-
| English (British)
| en_GB.UTF-8
| %comspec% /c set LANG=en_GB.UTF-8 && start grampsw.exe"
|
|-
| Finnish
| fi.UTF-8
| %comspec% /c set LANG=fi.UTF-8 && start grampsw.exe"
|
|-
| Russian
| ru_RU.UTF-8
| %comspec% /c set LANG=ru_RU.UTF-8 && start grampsw.exe"
|
|-
| Albanian
| sq_AL.UTF-8
| %comspec% /c set LANG=sq_AL.UTF-8 && start grampsw.exe"
|
|-
| German
| de_DE.UTF-8
| %comspec% /c set LANG=de_DE.UTF-8 && start grampsw.exe"
|
|-
| French
| fr_FR.UTF-8
| %comspec% /c set LANG=fr_FR.UTF-8 && start grampsw.exe"
|
|-
| French Canadian
| fr_CA.UTF-8
| %comspec% /c set LANG=fr_CA.UTF-8 && start grampsw.exe"
|
|-
| Macedonian
| mk_MK.UTF-8 ???
|
|
|-
| Nederlands (Dutch)
| nl_NL.UTF-8
| %comspec% /c set LANG=nl_NL.UTF-8 && start grampsw.exe"
|
|-
| Dutch
| nl_BE.UTF-8
| %comspec% /c set LANG=nl_BE.UTF-8 && start grampsw.exe"
|
|-
| Slovak
| sk_SK.UTF-8
| %comspec% /c set LANG=sk_SK.UTF-8 && start grampsw.exe"
|
|-
| Hebrew
| he_IL.UTF-8
| %comspec% /c set LANG=he_IL.UTF-8 && start grampsw.exe"
|
|-
| Danish
| da_DK.UTF-8
| %comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"
|
|-
| Greek
| el_GR.UTF-8
| %comspec% /c set LANG=el_GR.UTF-8 && start grampsw.exe"
|
|-
| Italian
| it_IT.UTF-8
| %comspec% /c set LANG=it_IT.UTF-8 && start grampsw.exe"
|
|-
| Esperanto
| eo.UTF-8 ???
|
|
|-
| Chinese (Simplified)
| zh_CN.UTF-8
| %comspec% /c set LANG=zh_CN.UTF-8 && start grampsw.exe"
|
|-
| Chinese (Hong Kong)
| zh_HK.UTF-8 ???
|
|
|-
| Chinese (Traditional)
| zh_TW.UTF-8
| %comspec% /c set LANG=zh_TW.UTF-8 && start grampsw.exe"
|
|-
| Ukrainian
| uk_UA.UTF-8
|
|
|-
| Portuguese
| pt_PT.UTF-8
| %comspec% /c set LANG=pt_PT.UTF-8 && start grampsw.exe"
|
|-
| Portuguese (Brazil)
| pt_BR.UTF-8
| %comspec% /c set LANG=pt_BR.UTF-8 && start grampsw.exe"
|
|-
| Afrikaans
| af_ZA.UTF-8
|
|
|-
| Norwegian Bokmål
| nb_NO.UTF-8
| %comspec% /c set LANG=nb_NO.UTF-8 && start grampsw.exe"
|
|-
| Norwegian Nynorsk
| nn_NO.UTF-8
| %comspec% /c set LANG=nn_NO.UTF-8 && start grampsw.exe"
|
|-
| Turkish
| tr_TR.UTF-8
| %comspec% /c set LANG=tr_TR.UTF-8 && start grampsw.exe"
|
|-
| Spanish
| es_ES.UTF-8
| %comspec% /c set LANG=es_ES.UTF-8 && start grampsw.exe"
|
|-
| Polish
| pl_PL.UTF-8
| %comspec% /c set LANG=pl_PL.UTF-8 && start grampsw.exe"
|
|-
| Slovenian
| sl_SI.UTF-8
| %comspec% /c set LANG=sl_SI.UTF-8 && start grampsw.exe"
|
|-
| Japanese
| ja_JP.UTF-8
| %comspec% /c set LANG=ja_JP.UTF-8 && start grampsw.exe"
|
|-
| Arabic (Saudi Arabia)
| ar_SA.UTF-8
| %comspec% /c set LANG=ar_SA.UTF-8 && start grampsw.exe"
|
|-
|
|
|
|
|-
|
|
|
|
|}
*The language codes are two-letter lowercase ISO language codes (such as "da") as defined by [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1].
*The country codes are two-letter uppercase ISO country codes (such as "BE") as defined by [https://en.wikipedia.org/wiki/ISO_3166-1 ISO 3166-1].

===Advanced manipulation of settings===
{{stub}}

{{man warn| Warning ** Make sure you have closed Gramps **|The contents of this section is outside the scope of interest of a general user of Gramps. If you proceed with tweaking the options on the low level you may damage your Gramps installation. Be careful. '''YOU HAVE BEEN WARNED!'''}}

Besides the settings available in Preferences, you may also wish to explore the advanced settings.

Gramps uses '''[https://en.wikipedia.org/wiki/INI_file#Keys_(properties) INI keys]''' and [https://en.wikipedia.org/wiki/INI_file#Sections INI sections] for managing user preferences and program settings these are stored in the text file <code>gramps.ini</code> under the <code>.gramps/gramps[XX]</code> folder in your home or user directory.

The <code>gramps.ini</code> file has following sections:
* [behavior] : typical Key names are: [https://github.com/gramps-project/gramps/blob/master/gramps/gui/grampsgui.py#L502 betawarn], enable-autobackup, use-tips...
* [colors] :
* [csv] :
* [database] : related to database settings for the Family Tree.
* [export] : export and import folders/directories
* [geography] :
* [interface] : a lot of keys regarding height and width of the different Views: e.g. event-height: 450, event-ref-height: 585, event-ref-width: 728, event-width: 712...
* [paths] : keys related to recent imported files and folders/directories
* [plugin] :
* [preferences] : keys related to preferences: all the common prefixes , todo -colors..
* [researcher] : all information regarding the researcher
* [spacing] :
* [test] :
* [utf8] :

====Example <code>gramps.ini</code> file====
Example contents of the <code>gramps.ini</code> file:


<pre>
;; Gramps key file
;; Automatically created at 2025/05/24 08:49:41

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps60', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps60'
;;autoload=0
;;avg-generation-gap=20
;;check-for-addon-update-types=['new']
;;check-for-addon-updates=0
;;date-about-range=50
;;date-after-range=50
;;date-before-range=50
;;do-not-show-previously-seen-addon-updates=1
;;generation-depth=15
;;immediate-warn=0
;;last-check-for-addon-updates='1970/01/01'
;;max-age-prob-alive=110
;;max-sib-age-diff=20
;;min-generation-years=13
;;owner-warn=0
;;pop-plugin-status=0
;;previously-seen-addon-updates=[]
;;recent-export-type=3
;;runcheck=0
;;spellcheck=0
;;startup=0
;;surname-guessing=0
translator-needed=0
;;use-tips=1
;;web-search-url='https://google.com/search?q=%(text)s'
;;welcome=100

[colors]
;;border-family=['#cccccc', '#252525']
;;border-family-divorced=['#ff7373', '#720b0b']
;;border-female-alive=['#861f69', '#261111']
;;border-female-dead=['#000000', '#000000']
;;border-male-alive=['#1f4986', '#171d26']
;;border-male-dead=['#000000', '#000000']
;;border-other-alive=['#2a5f16', '#26a269']
;;border-other-dead=['#000000', '#000000']
;;border-unknown-alive=['#8e5801', '#8e5801']
;;border-unknown-dead=['#000000', '#000000']
;;family=['#eeeeee', '#454545']
;;family-civil-union=['#eeeeee', '#454545']
;;family-divorced=['#ffdede', '#5c3636']
;;family-married=['#eeeeee', '#454545']
;;family-unknown=['#eeeeee', '#454545']
;;family-unmarried=['#eeeeee', '#454545']
;;female-alive=['#feccf0', '#62242D']
;;female-dead=['#feccf0', '#3a292b']
;;home-person=['#bbe68a', '#304918']
;;male-alive=['#b8cee6', '#1f344a']
;;male-dead=['#b8cee6', '#2d3039']
;;other-alive=['#94ef9e', '#285b27']
;;other-dead=['#94ef9e', '#062304']
;;scheme=0
;;unknown-alive=['#f3dbb6', '#75507B']
;;unknown-dead=['#f3dbb6', '#35103b']

[csv]
;;delimiter=','
;;dialect='excel'

[database]
;;autobackup=0
;;backend='sqlite'
;;backup-on-exit=1
;;backup-path='C:\\Users\\[username]'
;;compress-backup=1
;;host=''
;;path='C:\\Users\\[username]\\AppData\\Roaming\\gramps\\grampsdb'
;;port=''

[export]
;;proxy-order=[['privacy', 0], ['living', 0], ['person', 0], ['note', 0], ['reference', 0]]

[geography]
;;center-lat=0.0
;;center-lon=0.0
;;lock=0
;;map_service=1
;;path=''
;;personal-map=''
;;show_cross=0
;;use-keypad=1
;;zoom=0
;;zoom_when_center=12

[interface]
dbmanager-height=370
;;dbmanager-horiz-position=12
;;dbmanager-vert-position=85
;;dbmanager-width=780
;;dont-ask=0
;;filter=0
;;fullscreen=0
;;grampletbar-close=1
;;hide-lds=0
;;ignore-gexiv2=0
;;ignore-osmgpsmap=0
;;ignore-pil=0
;;main-window-height=500
;;main-window-horiz-position=15
;;main-window-vert-position=10
;;main-window-width=775
;;mapservice='OpenStreetMap'
;;open-with-default-viewer=0
;;pedview-layout=0
;;pedview-show-images=1
;;pedview-show-marriage=0
;;pedview-show-unknown-people=0
;;pedview-tree-direction=2
;;pedview-tree-size=5
;;place-name-height=100
;;place-name-width=450
;;sidebar-text=1
;;size-checked=0
;;statusbar=1
;;surname-box-height=150
;;tipofday-height=350
tipofday-horiz-position=-49
tipofday-vert-position=84
;;tipofday-width=550
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-style=0
;;toolbar-tools=1
;;treemodel-cache-size=1000
;;view=1
;;view-categories=['Dashboard', 'People', 'Relationships', 'Families', 'Ancestry', 'Events', 'Places', 'Geography', 'Sources', 'Citations', 'Repositories', 'Media', 'Notes']

[paths]
;;quick-backup-directory='C:\\Users\\[username]'
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'
;;recent-export-dir='C:\\Users\\[username]'
;;recent-file=''
;;recent-import-dir='C:\\Users\\[username]'
;;report-directory='C:\\Users\\[username]'
;;website-cal-uri=''
;;website-cms-uri=''
;;website-directory='C:\\Users\\[username]'
;;website-extra-page-name=''
;;website-extra-page-uri=''

[plugin]
;;addonplugins=[]
;;hiddenplugins=[]

[preferences]
;;age-after-death=1
;;age-display-precision=1
;;age-rounded-year=1
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-legacy'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=0
;;february-29=0
;;fprefix='F%04d'
;;hide-ep-msg=0
;;invalid-date-format='%s'
;;iprefix='I%04d'
last-view='dashboardview'
last-views=['dashboardview', '', '', '', '', '', '', '', '', '', '', '', '']
;;name-format=1
;;no-given-text='[Missing Given Name]'
;;no-record-text='[Missing Record]'
;;no-surname-text='[Missing Surname]'
;;nprefix='N%04d'
;;online-maps=0
;;oprefix='O%04d'
;;paper-metric=0
;;paper-preference='Letter'
;;patronimic-surname=0
;;place-auto=1
;;place-format=0
;;pprefix='P%04d'
;;private-given-text='[Living]'
;;private-record-text='[Private Record]'
;;private-surname-text='[Living]'
;;quick-backup-include-mode=0
;;rprefix='R%04d'
;;sprefix='S%04d'
;;tag-on-import=0
;;tag-on-import-format='Imported %Y/%m/%d %H:%M:%S'
;;use-last-view=0

[researcher]
;;researcher-addr=''
;;researcher-city=''
;;researcher-country=''
;;researcher-email=''
;;researcher-locality=''
;;researcher-name=''
;;researcher-phone=''
;;researcher-postal=''
;;researcher-state=''

[spacing]
dbman=[22.605613425925927, 5.877459490740741, 9.856047453703704]

[test]
;;january='January'

[utf8]
;;baptism-symbol='~'
;;birth-symbol='*'
;;buried-symbol='[]'
;;cremated-symbol='⚱'
;;dead-symbol='✝'
;;death-symbol=2
;;divorce-symbol='o|o'
;;engaged-symbol='o'
;;in-use=0
;;killed-symbol='x'
;;marriage-symbol='oo'
;;partner-symbol='o-o'
;;selected-font=''
</pre>

====Advanced backup filename setting====
You can also define the naming pattern for the backup filename by setting the ''<code>paths.quick-backup-filename</code>'' in the <code>~/.gramps/gramps60/gramps.ini</code> key file like the following:
{{-}}
[paths]
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'

by removing the two semicolons(<code>;;</code>) from the front of INI key line and using use any of the following keywords for the filename pattern:
*filename
*year
*month
*day
*hour
*minutes
*seconds
*extension :
**'''.gpkg'''(default) if you include media.
**''.gramps'' if you exclude media.

Use the appropriate ~/.gramps/gramps{XX}/gramps.ini key file.
*Gramps version 6.0 :
~/.gramps/gramps60/gramps.ini

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Command_Line#Configuration_.28config.29_option]]
* [[Install_latest_BSDDB#Make_Gramps_use_bsddb3]]
* [[Customize_the_Genealogical_Symbols_lookup_table#Genealogy_symbols_preferences]]

===Theme===
The look of Gramps can be changed.

* [[Addon:ThemePreferences|Addon:Theme Preferences]]
* [[Windows_AIO_themes]]
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]
* [[Overrule_Gramps_Icons]] - for older Gramps versions.
* [[UI style]]

Some reports can also be changed:

* [[Website report Themes]]
{{-}}
{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Gramps 6.0 Wiki Manual - Settings

2025-12-23T19:50:21Z

CallMeDave: /* Add Windows OS Menu Item */

{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with settings you can manage within Gramps either in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog or [[Gramps_6.0_Wiki_Manual_-_Settings#Other_settings|other various settings]]. As well as various ways of [[Gramps_6.0_Wiki_Manual_-_Settings#Customizing|customizing]] Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-60.png|center|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all default Preferences tabs]]

Most of the settings affecting the entire Gramps program are configured in the {{man label|Preferences}} dialog. To invoke it, select the menu {{man menu|Edit ➡ Preferences...}} or select the {{man button|[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_Preferences|Open Preferences]]}} icon on the toolbar.

There are overrides that can be set ''before'' running Gramps (such setting the Language shown in the interfaces or for reports) that can be set temporarily or permanently from the [[Gramps_6.0_Wiki_Manual_-_Command_Line|command line interface]].

For configuration options that are limited to the current view or Gramplet set, choose via the menu {{man menu|View ➡ Configure View...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The tabs on the top display the available option categories as follows:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#General|General]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Import|Import]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Text|Text]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Warnings|Warnings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher]]}}

Also ''other'' additional tabs maybe shown from any [[6.0_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab defaults]]
The {{man label|Data}} tab contains preferences relevant to the following two sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Display Options" section defaults]]
The {{man label|Display Options}} section contains the following options:

*{{checkbox|1}}{{man label|Automate Place format:}} This option controls the display of places. {{man tooltip|Enables automatic place title generation using specified format.}} This feature was labeled as "Enable automatic place title generation" in the 5.0 revision and as "Place format(auto place title)" in the 5.1 revision. The [[Gramps_4.1_Wiki_Manual_-_What%27s_new%3F#Place_hierarchies|hierarchy of Places]] was new in the [[Template:Releases/4.1.0|4.1.0]] revision and the [[Gramps_4.2_Wiki_Manual_-_Settings#Places|Places tab]] of Preferences only existed in the 4.2 version. Major revisions are expected for Place hierarchies so this interfaces is likely to relocated and renamed again.
** '''Full''' (default)
*** Selecting the {{man button|Edit...}} button will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]])
** '''DEG Degree,minutes,seconds notation''' (default)
** DEG-: degree, minutes, seconds notation with :
** D.D4 degree notation, 4 decimals
** D.D8 degree notation, 8 decimals (precision like ISO-DMS)
** RT90 Output format for the [https://en.wikipedia.org/wiki/Swedish_grid Swedish coordinate system RT90]
*{{man label|Name format:}} This option controls the display of names in the current database (the setting is saved in the database and is not system wide). In Gramps there are two type of name display formats: the predefined formats, and the user defined custom formats{{man label|Custom name display options are unique to each family tree.}}. Several different predefined name formats are available: '''"Surname, Given Suffix"''' (default), ''"Given Surname Suffix"'', ''"Given"'', ''"Primary[sur] Primary[con] NotPatronymic, Given Patronymic[sur] Suffix Primary[pre]"''
** Clicking on the right hand side {{man button|Edit...}} button will bring up a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}} window where the available list of options is shown. The format is given as well as an example. When predefined formats are not suitable one can define one's own format. You can use the {{man button|Add}} button to add a Name format to the list. Clicking once will give you a '''SURNAME,Given Suffix(call)''' format and as example : '''SMITH, Edwin Jose Sr (Ed)'''. If you added new name formats to the list the {{man button|Remove}} and {{man button|Edit}} buttons become available to change the name format list.
***{{checkbox|0}}{{man label|Consider single pa/matronymic as surname}}: Checkbox unselected by default. If selected enables Gramps to consider patronymic and matronymic names as surnames.

{{man note|1=Besides this database-wide setting|2=Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]]}} dialog}}

*{{man label|Date format *:}} This option controls the display of dates. It is a global setting, requiring a restart of Gramps to take effect, and applies to the display of dates in all databases loaded within Gramps until such time as the date display format is changed again. Several different formats are available, which may be dependent on your locale. {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new date display format}}
** '''YYYY-MM-DD (ISO)''' (default) - Example 2020-09-30 - Displays the date using the international standard [https://wikipedia.org/wiki/ISO_8601 ISO 8601 Data elements and interchange formats – Information interchange] particularly useful when sharing data between countries with different conventions for writing numeric dates and times.
** Numerical
** Month Day, Year
** MON DAY, YEAR
** Day Month Year
** DAY MON YEAR

*{{man label|Age display precision *:}} {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new Age precision format}}
** '''Years''' (default)
** Years, Months
** Years, Months, Days
*{{checkbox|1}}{{man label|Round the year}}
*{{checkbox|1}}{{man label|Display ages for events after death *}} {{man menu|Please note that once changed, it is necessary to restart Gramps to see the change.}}

*{{man label|Calendar on reports:}} '''Gregorian''' (default). This option controls the display of calendar on reports, tools, gramplets, views. Several different calendars are available (see [[Gramps_6.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates|Date Edition]]). Two dates with two different calendars will not properly display timeline or period, (e.g. Using the Gregorian calendar as the default displayed calendar, users will have a better coherency for displaying dates on period).
*{{man label|Calendar on input:}} '''Gregorian''' (default).
*{{man label|Show leap day anniversaries:}} '''On the previous day''' (default). {{man tooltip|For non leap years, anniversaries are displayed on either February 28, March 1 or not at all in Gregorian calendars}}

*{{man label|Status bar:}} This option controls the information displayed in the status bar. This can be either the '''[[Gramps_Glossary#active_person|Active Person]]'s name and ID''' (default) or '''Relationship to [[Gramps_Glossary#home_person|home person]]'''.

*{{man label|Citation formatter:}} '''Legacy''' (default). Select from the available plugins for composing and display of Citation data. The built-in "Legacy" [[Addon_list_legend#cite|CITE plugin]] is compatible with versions 5.1.6 and earlier.

===== Place Format Editor =====
[[File:EditPreferences-Data-tab-DisplayOptions-section-PlaceFormatEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Format Editor - dialog (default) from Menu: "Edit > Preferences..." - "Data" tab "Display Options" section]]

The {{man label|Place Format Editor}} dialog contains preferences relevant to how Places should be shown.

The {{man label|Place Format Editor}} dialog can be accessed from the {{man menu|Edit > Preferences...}} - "Data" tab in the [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]] section via the {{man button|Edit}} button on the {{man label|[] Automate Place Format}} option.

The {{man label|Place Format Editor}} dialog allows you to create custom Place formats by using the {{man button|Add}} button in the left column and choosing how each part of the Place shown should be displayed based on the following settings:

*{{man label|Name:}} <code>New</code> (by default) - A name for the place format strongly suggest you change this to be unique.
*{{man label|Levels:}} <code>:</code> (default colon ":" meaning display all of the place name ) - Select the hierarchy levels of the place names to be displayed.
** Each level in the hierarchy is represented by a positive integer, starting with 0 for the selected place and increasing by 1 for each level up the hierarchy. The levels can also be represented by negative integers, starting with -1 for the top level (usually a country) and decreasing by 1 for each level lower in the hierarchy. In addition, the populated place (city, town, village or hamlet) is represented by the letter p; this can be used with an offset (e.g. p+1 or p-2).
** The names to be displayed are defined as a comma-separated list of ranges. A range can either be a single level, or a start level and an end level separated by a colon. The start level must be less than the end level in a range. The start and end levels default to 0 and -1 if missing.
*{{man label|Street format:}} - Optionally concatenate the number and street in order to suppress the comma.
** '''None''' (default) - Display as is.
** ''Number Street'' - For these options to work, the street must have the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
** ''Street Number'' - as per ''Number Street''
*{{man label|Language:}} (Empty by Default) A [https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes two-digit language code].
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

You can remove a custom place format using the {{man button|Remove}} button.

The {{man label|Place Format Editor}} has one pre-defined format named '''Full''' by default.

{{man note|Creates a <code>place_formats.xml</code> file in your Gramps User directory|Not backed up see: [[Template:Backup_Omissions]]}}

See also:
* [https://github.com/gramps-project/gramps/pull/368 Implement place formats #368]
* [[Hierarchical Place Structure]]
* https://gramps-project.org/wiki/index.php/GEPS_045:_Place_Model_Enhancements_-_Place_Changes_Screenshots#Enhanced_Place_Format_Editor
* [https://sourceforge.net/p/gramps/mailman/message/36637553/ (Gramps-users) Proposed place formatting dialogs] From: Nick Hall. - 2019-04-11
* https://sourceforge.net/p/gramps/mailman/message/36422019/
* https://sourceforge.net/p/gramps/mailman/message/36363239/
* https://sourceforge.net/p/gramps/mailman/message/35694337/
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
====== Example Place Formats ======
{{stub}}
The editor has a new field called "levels". It allows users to select hierarchy levels in the place loosely based on the python string slicing syntax. A number of colon ranges can be specified in a comma-separated list. "0" represents the lowest level - typically a building or street. "-1" represents the highest level - typically a country. The populated place is represented as "p".

For example:
"p:" = Populated place upwards.
"p,-1" = Populated place and country.

Valid options:
* <tt>0 - 9</tt> - Hierarchy Level
* <tt>-</tt> - Negative
* <tt>:</tt> - ??
* <tt>p</tt> - Populated Place
* <tt>,</tt> - comma

Place Format examples
* ["p:" = Populated place upwards]
* ["p,-1" = Populated place and country.]
* [1,p House and city],[p,1 City and house]

It lets you restrict long place descriptions in reports and views. [https://github.com/gramps-project/gramps/pull/368#issuecomment-290886087]

{{-}}

=====Display Name Editor=====

{{man note|1=Custom name display formats are stored in the Family Trees|2=Thus before loading any Family Tree the {{man label|Custom format details}} expander is disabled.}}

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Display Name Editor" - dialog (default) from Menu: "Edit>Preferences..." - "Data" tab > "Display Options" section]]
The {{man label|Display Name Editor}} allows you to define custom name formats, that can be shown on reports and charts at a global level or a per person level.

The {{man label|Display Name Editor}} has two section:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference|Help Reference]]}} section shown at the top
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_list|Display Name list]]}} table section

The {{man label|Display Name Editor}} can be accessed from the menu: {{man menu|Edit>Preferences...}} - {{man label|Data}} tab > {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}} sections {{man label|Name format:}} {{man button|Edit...}} button.
{{-}}
======Help Reference======


Display Name Help Reference:
<hr>
The following keywords are replaced with the appropriate name parts:
* '''Given''' - given name (first name)
* '''Title''' - title (Dr., Mrs.)
* '''Call''' - call name
* '''Initials''' - first letters of Given
* '''Prefix''' - all prefixes (von, de)
* '''Surname''' - surnames (with prefix and connectors)
* '''Suffix''' - suffix (Jr., Sr.)
* '''Nickname''' - nick name
* '''Common''' - nick name as first option if it exists, Call as second option, otherwise first of Given
<hr>
:Surname:
* '''Rest''' - non primary surnames
* '''Familynick''' - family nick name
* '''Primary, Primary[pre] or [sur] or [con]'''- full primary surname, prefix, surname only, connector
* '''Patronymic, or [pre] or [sur] or [con]''' - full pa/matronymic surname, prefix, surname only, connector
* '''Notpatronymic'''- all surnames, except pa/matronymic & primary
* '''Rawsurnames'''- surnames (no prefixes and connectors)
<hr>
{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.
<hr>
:'''Example:''' Dr. Edwin Jose von der Smith and Weston Wilson Sr (“Ed”) - Underhills 
:''Edwin Jose'': '''Given''', ''von der'': '''Prefix''', ''Smith'' and ''Weston'': '''Primary''', ''and'': <abbr title="a connector">'''[con]'''</abbr>, ''Wilson'': '''Patronymic''', 
:''Dr.'': '''Title''', ''Sr'': '''Suffix''', ''Ed'': '''Nickname''', ''Underhills'' <abbr title="family nick name">'''Familynick'''</abbr>, Jose <abbr title="called (preferred given name)">'''Call'''</abbr>.
<hr>
{{-}}

======Help Reference Example person======
[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor's - reference person  shown in the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]] dialog]]

All the fields for the Help Reference '''Example''' person except the Family Nickname can be added in the standard Person Editor dialog. Double-click the Preferred name in Names tab of the Person Editor to access additional fields including: the Family Nick Name, Grouping controls, exception Sorting and Display controls, Date range controls for using a particular name.
{{-}}

======Display Name list======


In this section you can add, remove or edit existing name formats as well as see an example of the formatted name.

Table shows two headings {{man label|Format}} and {{man label|Example}}
* {{man label|Format}} - Based on the name parts shown
* {{man label|Example}} - Displays the name format applied to a ? [[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|builtin reference person]] ?

The List shows four default display name formats they are: 
* ''Surname, Given Suffix'' - displays the name as:
* ''Given Surname Suffix'' - displays the name as:
* ''Given'' - displays the name as: ''Edwin Jose''
* ''xxx''' - displays the name as:

* {{man button|Add}} - a new name format, type the required keywords as needed and press the {{man button|Enter}} key to see the resulting {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|Example]]}}
* {{man button|Remove}} - an existing name format (except for the four default name formats )
* {{man button|Edit}} - an existing name format (except for the four default name formats )
{{stub}}
{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Input Options" section defaults]]

*{{man label|Surname guessing:}} This option affects the initial family name of a child when they are added to the family tree.
** '''Father's surname''' (default) - will use the family name of the father.
** ''None'' - means that no surname guessing will be attempted.
** ''Combination of mother's and father's surname'' - will use the father's name followed by the mother's name.
** ''[https://wikipedia.org/wiki/Icelandic_name Icelandic style]'' - will use the father's given name followed by the "sson" suffix (e.g. the son of Edwin will be guessed as Edwin''sson'').

{{man tip|1=Tip |2=The {{man label|Surname guessing:}} option only affects the initial family name guessed by Gramps when the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog is launched from a {{man label|Family Editor}} window.
You can modify that name any way you see fit. Set this Preferences [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display tab]] option to the value that you will most frequently use, as it will save you a lot of typing.

See:
* [https://gramps-project.org/bugs/view.php?id=1715 feature request to support other local variations for surname guessing]
* [https://wikipedia.org/wiki/Category:Names_by_country Category:Names by country], From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Category:Names_by_language Category:Names by language], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}} - used by the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor]]}} dialog.
** '''Unknown''' (default)
** ''Married''
** ''Unmarried''
** ''Civil Union''

*{{checkbox|0}}{{man label|Hide LDS tab in [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|person]] and [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS_2|family]] editors}}: Latter Days Saints
{{-}}

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-60.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "General" tab "Environment Settings" section defaults]]

This tab contains one section containing preferences relevant to the general operation of the program.

==== Environment Settings ====
*{{checkbox|0}}{{man label|Display Tip of the Day}}: This checkbox option controls the enabling and disabling of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tip_of_the_Day_dialog|Tip of the Day]]}} dialog at startup. {{man tooltip|Show useful information about using Gramps on startup.}}
*{{checkbox|0}}{{man label|Remember last Family Tree}}: Selecting this checkbox option causes the last used database to load upon start. It bypasses the '''Manage Family Trees''' dialog.
*{{checkbox|0}}{{man label|Remember last view displayed}}: This checkbox option controls the enabling and disabling of the display of the last [[Gramps_Glossary#view|View]]. Enabling will bring you to the view where you stopped the program the last time. {{man tooltip|Remember last view displayed and open it next time.}}
*{{checkbox|0}}{{man label|Enable spell checker}}: This checkbox option controls the enabling and disabling of the global spelling checker for notes. The '''[https://gitlab.gnome.org/GNOME/gspell gspell]''' package must be loaded for this to have an effect.[https://github.com/gramps-project/gramps/pull/1450] ( See: [[Troubleshoot Spellcheck]] ) {{man tooltip|Enable the spelling checker for notes.}} (Note the Edit>preferences option enables global English or the language your Gramps is run in and the note context menu is per note in the selected Language of your choice)

*{{checkbox|1}}{{man label|Show text label beside Navigator buttons *}} ''checked'' (default) This checkbox controls whether or not a text description is displayed next to the icon in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Main_Window|Main Window]]. This option takes effect after the program has been restarted. {{man tooltip|Show or hide text beside Navigator buttons (People, Families, Events...). Requires Gramps restart to apply.}}

*{{checkbox|1}}{{man label|Show Clipboard icon on toolbar}}
*{{checkbox|1}}{{man label|Show Reports icon on toolbar}}
*{{checkbox|1}}{{man label|Show Tools icon on toolbar}}
*{{checkbox|1}}{{man label|Show Addons icon on toolbar}}
*{{checkbox|1}}{{man label|Show Preferences icon on toolbar}}
*{{man label|Toolbar Style:}} {{man tooltip|Display text, icons or both on the toolbar buttons.}}
** '''Both text and icons''' (default)
** ''Text only''
** ''Icons only''
*{{checkbox|1}}{{man label|Show close button in gramplet bar tabs}} ''checked''(default) {{man tooltip|Show close button to simplify removing gramplets from bars.}}

*{{man label|Markup for invalid date format:}} Default: <code>%s</code>
** Convenience markups are:
*** Bold (Default)
*** <big><big>Makes font relatively larger</big></big>
*** Italic
*** <s><s>Strikethrough</s></s>
*** Subscript
*** Superscript
*** Makes font relatively smaller
*** <tt><tt>Monospace font</tt></tt>
*** Underline
**** For example: %s will display Underlined bold date.

*{{man label|Multiple surname box height:}} Default: <code>150</code> Pixels {{man tooltip|Enter height in pixels. When multiple surnames are entered, these names display in a box. This setting sets the size of this box.}}

====Tip of the Day dialog====

[[File:TipOfTheDay-dialog--example-PrivacyInGramps-60.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog - example]]

When enabled in {{man menu|Edit > Preferences}} {{man label|General}} tab the {{man label|Tip of the Day}} dialog shows helpful hints.

The following options are available:
*{{checkbox|1}} {{man label|Display on startup}} (check box checked by default - once enabled) - uncheck to stop further tips appearing.
*{{man button|Forward}} - Advance to the next tip.
*{{man button|Close}} - exit for this session until the Gramps program is restarted.
[[Category:Tips]]

{{-}}

=== Family Tree ===
[[File:EditPreferences-FamilyTree-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - defaults]]
The {{man label|Family Tree}} tab contains the following four sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a family tree]] - more information on backups
* [[Template:Backup_Omissions|Backup omissions]] - what is not included during a backup
{{-}}
====Database Settings====
[[File:EditPreferences-FamilyTree-tab-DatabaseSetting-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Settings" section defaults]]

*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** ... If other database backends addons are installed, they will be added to the list <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>: [[Addon:PostgreSQL|PostgreSQL]] backend

See also:
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds experimental support for PostgreSQL databases. Recommended for Experts only!

{{man warn|The ''[[Gramps_Glossary#bsddb|BSDDB]]'' - Legacy Database backend was superseded in the Gramps 5.1 version.|Note that BSDDB can be converted only. BSDDB 3 (Read-only for upgrades) }}
{{-}}

====Database Location====
[[File:EditPreferences-FamilyTree-tab-DatabaseLocation-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Location" section defaults]]
*{{man label|Host:}} - Server address or other computer IP address for the location of the database.
*{{man label|Port:}} - Port number to access the Host database
*{{man label|Database path:}} Unless you have a definite reason to change this, stay with the default path. The default path where databases are stored is <code>grampsdb</code> within the [[Gramps_6.0_Wiki_Manual_-_User_Directory|User Directory]].
{{-}}

====Backup Management====
[[File:EditPreferences-FamilyTree-tab-BackupManagement-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Backup Management" section defaults]]
*{{man label|Backup path:}} - Location in which to save your Gramps backup archive files.
*{{checkbox|1}}{{man label|Backup on exit}} - Selecting this option will Backup Your family tree upon choosing to exit Gramps. The file be saved to the Backup path specified above. The filename of the backup will match the Family Tree appended with a date and time.
*{{man label|Autobackup:}} timer interval for triggering full backups during Gramps editing sessions.
** '''Never''' (''default'')
** Every 15 minutes
** Every 30 minutes
** Every hour
** Every 12 hours
** Every day
{{-}}

====Family Tree's Media path====
[[File:EditPreferences-FamilyTree-tab-FamilyTreesMediaPath-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Family Tree's Media path" section defaults]]
*{{man label|Base media path:}} Here you can fill in a base path for the media objects.
** Selecting the {{man button|Directory}} button gives you a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Select_media_directory_dialog|Select media directory]]}} dialog where you can fill in the required path.

{{man tip|The base relative media path is specific to the active family tree.|It is not a global setting in Gramps. Each family tree is able to have a unique media base path that is stored with the database.}}

{{man tip|To make media paths relative|You also need to select the {{man label|[ ] Convert to a relative path}} checkbox, at the bottom of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_a_media_object_selector|Select a media object selector]]}} dialog. Once checked for the first time it will be remembered for each subsequent media selection.}}

See also:
*[[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|{{man label|Gramps Media Manager}}]] a group of four separate tools two of which allow you to:
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

{{-}}
=====Select media directory dialog=====

{{stub}}

See [[Gramps_6.0_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
[[File:BrokenMediaPath-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media object with a broken filepath]]

If the Preview thumbnails displays 'broken link' icon of a box with a red 'x' you will need to correct {{man label|Base media path:}} for your family tree in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.

See also:
* Example.gramps - [[Example.gramps#Connecting_to_the_example_Media_Objects|Connecting to the example Media Objects]]
* [[Addon:Media_Verify_Tool|Media Verify Tool]] addon tool for revalidating media paths
{{-}}
{{stub}}

=== Import ===
[[File:EditPreferences-Import-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Import" - tab - defaults]]
The {{man label|Import}} tab has two sections as follows:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tag_Records|Tag Records]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Source_GEDCOM_import|Source GEDCOM import]]}}

==== Tag Records ====

*{{checkbox|0}}{{man label|Add tag on import}}: Checkbox (Default: <code>Imported %Y/%m/%d %H:%M:%S</code> ) ''' {{man tooltip|Specified tag will be added on import. Clear to set default value.}} Note - Adding a timestamped [[Gramps_Glossary#tag|Tag]] on import can significantly slow down the importing of your data, but are helpful for the ensuing data cleanup.'''

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|GEDCOM data]]. If this is set, each item that is imported will contain a [[Gramps_Glossary#source|Source]] reference to the imported file. '''Note - Adding a default source can significantly slow down the importing of your GEDCOM data, but are helpful for the ensuing data cleanup.'''

{{-}}

=== Limits ===
[[File:EditPreferences-Limits-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Limits" - tab - defaults]]

Settings used for calculation operations of dates, ages and generations.

See also:
* [[Gramps 6.0 Wiki Manual - Probably Alive]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|Editing dates]]
* Setting the [[Match_dates#Changing_after.2Fbefore.2Fabout_range|date approximation .ini]] manually

==== Calculation limits ====

*{{man label|Date 'about' year range: (date ± #):}} Default: <code>50</code>
** Defines the number of years +/- of the event date "<code>about <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'after' year range: (date + #):}} Default: <code>50</code>
** Defines the number of years after the event date "<code>after <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'before' year range: (date - #):}} Default: <code>50</code>
** Defines the number of years before the event date "<code>before <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Maximum age probably alive:}} Default: <code>110</code>
** Absent a Death event, the age by which Gramps will consider the person is no longer alive.
*{{man label|Maximum sibling age difference:}} Default: <code>20</code>
*{{man label|Minimum years between generations:}} Default: <code>13</code>
*{{man label|Average years between generations:}} Default: <code>20</code>
*{{man label|Max generations for relationships:}} You can enter the number of generations used to determine relationships. The default value is '''<code>15</code>'''. Limits the scope of features based on the [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
[[File:EditPreferences-Colors-tab-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - defaults]]

This tab has seven section related to allowing you to set the '''colors used for boxes in the graphical views'''.

Each of the colors can be customized using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]}}.

==== Colors used for boxes in the graphical views ====

You can select the
* {{man label|Color scheme:}}
** '''Light colors''' (default)
** ''Dark colors''
*** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* {{man label|Background for Alive:}} [ ] #b8cee6
* {{man label|Border for Alive:}} [ ] #1f4986
* {{man label|Background for Dead:}} [ ] #b8cee6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Female persons====
* {{man label|Background for Alive:}} [ ] #feccf0
* {{man label|Border for Alive:}} [ ] #861f69
* {{man label|Background for Dead:}} [ ] #feccf0
* {{man label|Border for Dead:}} [ ] #000000

====Colors for people who are neither male nor female====
* {{man label|Background for Alive:}} [ ] #94ef9e
* {{man label|Border for Alive:}} [ ] #2a5d16
* {{man label|Background for Dead:}} [ ] #94ef9e
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Unknown persons====
* {{man label|Background for Alive:}} [ ] #f3dbb6
* {{man label|Border for Alive:}} [ ] #8e5801
* {{man label|Background for Dead:}} [ ] #f3dbb6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Family nodes====
* {{man label|Default background:}} [ ] #eeeeee
* {{man label|Default border:}} [ ] #cccccc
* {{man label|Background for Married:}} [ ] #eeeeee
* {{man label|Background for Unmarried:}} [ ] #eeeeee
* {{man label|Background for Civil Union:}} [ ] #eeeeee
* {{man label|Background for Unknown:}} [ ] #eeeeee
* {{man label|Background for Divorced:}} [ ] #eeeeee
* {{man label|Border for Divorced:}} [ ] #ff7373

====Other colors====
* {{man label|Background for Home Person:}} [ ] #bbe68a
{{-}}

=== Genealogical Symbols ===
{{stub}}
{{man warn|Prerequisites exist for this feature|The Genealogical Symbols tab can only be used if the [[#Prerequisite_to_use_Genealogical_Symbols|prerequisite]] program <code>[[#Prerequisite_to_use_Genealogical_Symbols|python-fontconfig]]</code> is present that Gramps can use.}}

[[File:EditPreferences-GenealogicalSymbols-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Genealogical Symbols" - tab - defaults]]

Allows you to use Genealogical symbols instead of text abbreviations in reports, charts and the Gramps interface.

This tab gives you the possibility to use one font which is able to show all genealogical symbols. (Once configured see: [[#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]])

If you select the "{{man label|Use symbols}}" checkbox, Gramps will use the selected font if it exists.

This can be useful if you want to add phonetic in a note to show how to pronounce a name or if you mix multiple languages like Greek and Russian.

You can only configure the death symbol from this tab.

:List of Genealogical Symbols shown (listed in order shown at bottom of screenshot):

* Female
* Male
* Asexuality, sexless, genderless
* Lesbianism
* Male homosexuality
* Heterosexuality
* Transgender, hermaphrodite (in entomology)
* Transgender
* Neuter

* Illegitimate
* Birth
* Baptism/Christening
* Engaged
* Marriage
* Divorce
* Unmarried partnership
* Buried
* Cremated/Funeral urn
* Killed in action
* Extinct

* Death

{{-}}

{| class="wikitable"
|-
! meaning
! symbol
! Unicode code point(s)
! name
|-
! male
| ♂
| U+2642
| Male Sign
|-
! female
| ♀
| U+2640
| Female Sign
|-
! unknown
| ⚪︎
| U+26AA
| Medium White Circle
|-
! hermaphrodite
| ⚥
| U+26A5
| Interlocked Male and Female Sign
|-
! neuter
| ⚲
| U+26B2
| Neuter

|-
! birth
| *
| U+002A
| Asterisk
|-
! baptisation, christening
| ~
| U+007E
| Tilde
|-
! death
| ✝︎
| U+271D
| Latin Cross
|-
! burial
| ⚰︎
| U+26B0
| Coffin
|-
! cremation
| ⚱︎
| U+26B1
| Funeral Urn
|-
! stillborn
| ✝︎*
| U+0086 U+002A
| Latin Cross, Asterisk
|-
! born illegitimately
| *⃝
| U+002A U+20DD
| Circled Asterisk
|-
! born illegitimately
| ⊛
| U+229B
| Circled Asterisk Operator
|-
! killed in action
| ⚔︎
| U+2694
| Crossed Swords
|-
! this line extinct
| ‡
| U+2021
| Double Dagger
|-
! approximate(ly)
| ±
| U+00B1
| Plus-Minus
|-
! before
| <
| U+003C
| Less-Than Symbol
|-
! after
| >
| U+003E
| Greater-Than Symbol

|-
! engaged
| ⚬
| U+26AC
| Medium Small White Circle
|-
! married
| ⚭
| U+26AD
| Marriage Symbol
|-
! divorced
| ⚮
| U+26AE
| Divorce Symbol
|-
! unmarried
| ⚯
| U+26AF
| Unmarried Partnership Symbol
|}
{{-}}
====Prerequisite to use Genealogical Symbols====
{{stub}}
[[File:EditPreferences-GenealogicalSymbols-tab-default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences tab - defaults]]

=====Initial setup=====

If the fontconfig [[Gramps_6.0_Wiki_Manual_-_Settings#Prerequisite|prerequisite has been installed]], then on the {{man label|Genealogical Symbols}} tab select the {{man button|Try to find}} button, Gramps will attempt to detect any suitable unicode text fonts that can be used.

[[File:EditPreferences-GenealogicalSymbols-FindFont-51.png|center|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Finding fonts]]

When the search has completed select one of the fonts from the {{man button|Choose font}} list and then select the checkbox:

{{checkbox|1|Use symbols}}

=====Prerequisite=====
Prerequisite : '''python-fontconfig''' : Python bindings of fontconfig and its dependencies are required for displaying genealogical symbols
{{man note|Use the [[Addon:Prerequisites_Checker_Gramplet|Prerequisites Checker]]|Do you have <code>python-fontconfig</code> installed? Run the Prerequisites Checker Addon and look for something similar to the following line:<pre>* python-fontconfig 0.5.0 (Success version 0.5.x is installed.)</pre>}}

See also:
* Tamura Jones expounds on [https://www.tamurajones.net/GenealogySymbols.xhtml Genealogical Symbols] ''(the 'Unicode' section is particularly relevant)''
* [[GEPS 039: Genealogical symbols in gramps]]
* Feature request: {{bug|9098}} Gramps should be able to use genealogy symbols everywhere.
* [[Customize the Genealogical Symbols lookup table]] located in the [[Gramps_6.0_Wiki_Manual_-_User_Directory#MS_Windows|Gramps user directory]] at: [https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py gramps\gen\utils\symbols.py]
{{-}}

=== ID Formats ===
{{man tip|ID Prefixes |The ID prefixes use formatting conventions common for C, Python, and other programming languages. For example, the <code>%04d</code> expands to an integer, prepended with zeros to have the total width of four digits. If you would like IDs to be 1, 2, 3, etc., simply set the formatting parameter to <code>%d</code>, the 'd' specifies Decimal Integer, outputting the number in base 10. See: Python [https://docs.python.org/3/library/string.html#format-specification-mini-language (String) Format Specification Mini-Language]}}

[[File:EditPreferences-IDFormats-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "ID Formats" - tab - defaults]]

This tab contains preferences relevant to the automatic generation of Gramps IDs.

*{{man label|Person:}} Provides the template for generating IDs for a Person. Default value: <code>I%04d</code>
*{{man label|Family:}} Provides the template for generating IDs for a Family. Default value: <code>F%04d</code>
*{{man label|Place:}} Provides the template for generating IDs for a Place. Default value: <code>P%04d</code>
*{{man label|Source:}} Provides the template for generating IDs for a Source. Default value: <code>S%04d</code>
*{{man label|Citation:}} Provides the template for generating IDs for a Citation. Default value: <code>C%04d</code>
*{{man label|Media Object:}} Provides the template for generating IDs for a Media Object. Default value: <code>O%04d</code>
*{{man label|Event:}} Provides the template for generating IDs for an Event. Default value: <code>E%04d</code>
*{{man label|Repository:}} Provides the template for generating IDs for a Repository. Default value: <code>R%04d</code>
*{{man label|Note:}} Provides the template for generating IDs for a Note. Default value: <code>N%04d</code>

You can use the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

[[File:EditPreferences-Text-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Text" - tab - defaults]]

This tab contains one section {{man label|Conditional Text Replacements}} with preferences relevant to how missing and private names and records should be shown.

==== Conditional Text Replacements ====

*{{man label|Missing surname:}} in the input field you can determine how a missing surname should be displayed. Default value is '''<code>[Missing Surname]</code>'''. You can change this to [--] or whatever is most convenient for you.
*{{man label|Missing given name}} in the input field you can determine how a missing given name should be displayed. Default value is '''<code>[Missing Given Name]</code>'''. You can change this to whatever you want.
*{{man label|Missing record:}} Default: <code>[Missing Record]</code>
*{{man label|Private surname:}} Default: <code>[Living]</code>
*{{man label|Private given name:}} Default: <code>[Living]</code>
*{{man label|Private record:}} Default: <code>[Private Record]</code>
{{-}}

=== Warnings ===
[[File:EditPreferences-Warnings-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab has one section {{man label|Warnings and Error dialogs}} that controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

See the [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
==== Warnings and Error dialogs ====
*{{checkbox|0}}{{man label|Suppress warning when adding parents to a child.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_adding_parents_to_a_child|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning when cancelling with changed data.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_cancelling_with_changed_data|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning about missing researcher when exporting to GEDCOM.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_about_missing_researcher_when_exporting_to_GEDCOM|Dialog]])
*{{checkbox|0}}{{man label|Suppress tooltip warnings about data being saved immediately.}} Checkbox unchecked by Default
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])
{{-}}

=== Researcher ===
{{man tip|Researcher Information|This contact information is independent of the family trees you create. Most exports and reports will be filtered to protect the privacy of living people of the Tree... including yourself. This information feeds into the authoring and citation features of any publication (or archival) options.}}
[[File:EditPreferences-Researcher-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Researcher" - tab - defaults]]

Allows you to {{man label|Enter your information so people can contact you when you distribute your Family Tree}} in the corresponding text entry fields. Although Gramps requests information about you, this information is used only so that Gramps can create valid GEDCOM output files. A valid GEDCOM file requires information about the file's creator. If you choose, you may leave the information empty, however none of your exported GEDCOM files will be valid.

The available text entry fields are (all blank by default):
*{{man label|Name:}}
*{{man label|Address:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

The information entered under this preference acts as default value for family tree specific values that can be adjusted with the {{man menu|Tools->Family Tree Processing->[[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information...]]}}.
{{-}}

== Other settings ==

Besides {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Columns editor===

{{man tip|The {{man label|Columns}} editor is available and works in the same way for all list views.|Specifically, it is available for People View, Family View (children list). Sources View, Citations View, Places View, Media View, Repositories View and the Notes View.}}

[[File:ColumnsEditorTab-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Columns''' editor tab - dialog - People Tree View default columns]]

The columns of the list views may be added, removed, or reordered in a {{man label|Columns}} editor dialog.

To use the {{man label|Columns}} editor dialog for the current view, choose via the menu {{man menu|View ➡ Configure...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

Only columns with a selected checkbox will be shown in the view. You can also change the position of a column in the View by clicking and dragging it to a new position in the Editor ([https://wikipedia.org/wiki/Drag-and-drop ''drag and drop'']). Once you have made the changes you want click {{man button|Apply}}, then click {{man button|OK}} to exit the Editor and see your changes in the View.

By default, the View List, displays several columns of information about the respective category. You can add or remove columns to and from the display

The default sort key for the view [always ascending] is the left-most field [i.e. at the top in the Columns Editor], so changing which field is in that position affects default sorting. For some views the first field cannot be changed and the reason will be mentioned at the top of the Columns editor.

The {{man label|Columns Editor}} dialog will have a different selection of columns for each category of View that displays a simple table.

Changes will only be enacted when the {{man button|Apply}} button is clicked.

Once the View columns changes have been applied, clicking once on the column header sorts in ascending order, clicking again sorts in descending order.

The subset of columns and the current [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PersonView-PeopleListView-example-with-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Before''' - default sort by "Name" column "People" Category - "Person" (List) View]]

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''After''' - Sorted by "Birth Date" column in the list mode of the People Category View - example]]

By default, each Category View presenting data in a columnated table layout will sort the rows in ascending order based on the data in the first (left-most) column. If the table has grouped rows, the grouped data will be sub-sorted. ''(Tables in tabbed subsets of data, Editors and Selectors will work similarly.)''

Click once on a different column header to sort on the data of that column in ascending order. Click the header again to sort in reverse order.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]]}} dialog can be used to add, remove and rearrange the displayed columns. Choosing a different first column will make that the new default sorting column of the view [though always ascending].
{{-}}

===Setting Home person===
[[File:MenuEdit-SetHomePerson-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu showing ''Set Home Person'']]

To set (designate) the [[Gramps_Glossary#home_person|Home person]], select the People Category and select the desired person to make them into the [[Gramps_Glossary#active_person|Active Person]] and then choose {{man menu|Edit ->Set Home Person}} via the menus.

Alternately, when editing any Person, right-clicking on inactive areas (areas without a text-entry box) of the top section displays a pop-up menu which includes an option to {{man menu|Make Home Person}} of that profile.

The Home person is the persistently designated person who becomes the [[Gramps_Glossary#active_person|Active Person]] when one of the following occurs:
*By default, when the Family tree database is opened ''(The [[Gramps_6.0_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]] can modify this default behavior. The "Remember last view displayed" will return to the last [[Gramps_Glossary#active_person|Active Person]] of the previous session.)''
*As the toolbar {{man button|Home}} button is clicked
*When the Home menu item is selected from either the {{man button|Go}} menu or the right-click context menu in selected views
*As the [[Gramps_6.0_Wiki_Manual_-_Keybindings#15|keybinding]] {{Man key press|ALT|Home}} is pressed to return to the '''Home Person'''.

The toolbar {{man button|Home}} button is available in the People Category, Relationships Category, and Charts Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Home_Person|Setting the Home Person]]
{{-}}

===Adjusting viewing controls===

Whether the toolbar, the sidebar, or the filter (not available on Charts and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Navigation#View|View]]}} menu will shows for boxes you can click:
*Navigator
*Toolbar
*Sidebar
*Bottombar
*Full Screen {{man key press|F11}}

Additionally, depending on the view you are in, other options will be available on {{man label|Configure}}.

*Gramplets:
**Set Columns to 1
**Set Columns to 2
**Set Columns to 3
*Relationships:
**Show Siblings
**Show Details
*Geography:
**Time period
**Layout

All other Views: the [[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example showing "Export View" menu entry]]

On most [[Gramps_6.0_Wiki_Manual_-_Categories#Categories_of_the_Navigator|Category List Views]], displayed data maybe be exported, choose via the {{man menu|Family Trees ->Export View...}} [[Gramps_6.0_Wiki_Manual_-_Navigation#Main_Menus|menu]] command.

This Menu command only appears if the displayed data can be exported. Gramps will export data on screen according your choice: '''CSV''' or '''Open Document''' spreadsheet format.

Note that the current configuration of the View's columns will control what data will be exported. The export will contain only the displayed column data (in the same order) and be limited to records matching any [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] you have applied.

Use the Views [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect]] tab control the type of CSV to be created.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) filetype - dialog - example]]

Gramps will then display the {{man label|Export View as Spreadsheet}} dialog where after choosing a file location to save to and a name for your file; export data on from the Category List View in one of two spreadsheet formats:
*{{man label|Formats:}}
** '''CSV''' (default)
** '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-ODS-Displayed-in-LibreOfficeCalc-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example ODS Spreadsheet - Displayed in LibreOffice Calc]]

The example screenshot shows an export to the '''OpenDocument Spreadsheet''' (ODS format) displayed as a Spreadsheet in LibreOffice Calc.

{{-}}

====CSV Dialect====
[[File:CSV-Dialect-Tab-dialog-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "CSV Dialect" tab - dialog - example]]

All list table views have a {{man label|CSV Dialect}} tab in the dialog for the {{man menu|View -> Configure...}} menu. You can choose the CSV format's delimiter to be used when exporting and importing data in Gramps.

''Choose your dialect'' from:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_Dialect|excel]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_tab_Dialect|excel-tab]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Unix_Dialect|unix]]}}
*{{man label|Custom}}
**{{man label|Delimiter:}}
*** ',' (default)
*** ';'
*** ':'
*** '|'
*** 'tab'

CSV stands for '''[https://wikipedia.org/wiki/Comma-separated_values comma-separated values]'''. It is a plain text file format that separate data into columns and rows for simple way to exchange data. Originally, data was limited by being separated into columns by fixed positions in <code>.txt</code> text files. When more flexibility was needed, the comma was chosen as a delimiter to mark the boundaries of the columns and the <code>.csv</code> format of a text file was established. To complicate matters, different Operating System marked their end-of-line and end-of-file with different terminating codes.

When comma was needed too frequently in the data itself, a <code>.tsv</code> (tab-separated-values) file format became popular. When other delimiters began being adopted, rather than use up more file extensions, CSV became synonymous with any text format with delimiter marked columns. They were just different 'dialects' of "CSV".

[https://docs.python.org/3/library/csv.html Python's <code>csv</code> module] provides several pre-defined dialects to simplify reading and writing CSV files. These dialects specify rules for parsing and formatting data. The standard dialects include {{man label|excel}}, {{man label|excel-tab}}, and {{man label|unix}}. The following sections outline each dialect's characteristics, including its separator, line terminator, and quoting behavior.

===== Excel Dialect =====

The {{man label|excel}} dialect is designed to be compatible with CSV files generated by Microsoft Excel. It is suitable for data that has been saved from Excel as comma-separated values.
*Separator:** Comma (<code>,</code>`)
*Line Terminator: Carriage return and line feed (<code>\r\n</code>)
*Quoting:
** Double quotes (<code>"</code>`) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Excel-tab Dialect =====

The {{man label|excel-tab}} dialect is similar to the `excel` dialect but uses tabs instead of commas as the separator. This format is often encountered when copying cell data from Excel to the OS clipboard. Pasting tab separated data into the [[Addon:Import_Text_Gramplet|Import Text]] addon gramplet is one of the quickest way to populate parts of your tree.

* Separator: Tab (<code>\t</code>)
* Line Terminator: Carriage return and line feed (<code>\r\n</code>)
* Quoting:
** Double quotes (<code>"</code>) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Unix Dialect =====

The {{man label|unix}} dialect is designed for use in Unix-like environments. It uses a line feed character as the line terminator and always quotes all fields.

* Separator: Comma (<code>,</code>)
* Line Terminator: Line feed (<code>\n</code>)
* Quoting:
** All fields are enclosed in double quotes (<code>"</code>).
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== See also: =====
* [https://github.com/gramps-project/gramps/pull/1314 CSV: possibility to select the dialect. #1314 ]
{{-}}

===Modularity and plugins===


Gramps has been designed for expansion. The Plugin (a.k.a. Plug-in, addon, extension) framework provides a path for third party development outside the normal Gramps release distributions.

The documentation for each addon is maintained outside the flow of these main wiki chapters. The interface and functionality of the software and documentation may not conform with the styles seen throughout the rest of Gramps... although we encourage Developers to try to make their additions as seamless as possible.

A brief description and screenshot of each addon can be found in the [[6.0_Addons#Addon_List|Addon List]] section of the wiki manual. The separately maintained documentation page for the addon is linked from the 1st column of that list.

See [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[6.0 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-section-PlainText-output-settings-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Options - tab defaults for Text Reports (Plain Text - output selected) example]]

What kind of output customization is available? This dialog allows you to change the fonts, font sizes, font color, background color of the text and alignment of paragraphs on the report.

For most report dialogs, in the top part are option tabs specifically related that particular report. The lower part will have more broadly reusable features and is called the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Document_Options|Document Options]]}} section.

From the {{man label|Style:}} drop down list you can choose an existing custom style. Or to make your own {{man label|Style:}} select the {{man button|Style Editor...}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Document_Styles_dialog|Document Styles]]}} dialog and then select the {{man button|Add a new style}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.

{{stub}}
{{-}}
====Document Styles dialog====

[[File:DocumentStyles-dialog-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Styles - dialog - default]]

The {{man label|Document Styles}} dialog, list the ''default'' style and any custom styles for that report and allows you to edit or delete any custom styles you have created. Select the {{man button|+ (Add a new style)}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====
[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

The {{man label|Style editor}} dialog allow you to customize the document style specific to each report.

Change the {{man label|Style sheet name:}} <code>New Style</code> (default) field to a unique name as it will appear in {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Document_Options|Document Options]]}} {{man label|Style:}} drop down list.

Once changes for your custom style have been finalized select the {{man button|OK}} button to save the changes or {{man button|Cancel}} to exit.

=====Style editor dialog tabs=====
On the left hand side you will see the {{man label|Style}} column that list the paragraph options specific to that report that you may modify. For example the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for <code>AHN-Entry</code>, <code>AHN-Generation</code> and <code>AHN-Title</code>.

On the right hand side are three tabs associated with each style listed in the left hand column:
* [[#Description|Description]]
* [[#Font_options|Font options]]
* [[#Paragraph_options|Paragraph options]]

{{-}}
======Description======

[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

*{{man label|Description}} tab describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( <code>AHN-Entry</code> ) with the description: ''The basic style used for the text display.''
{{-}}

======Font options======

[[File:StyleEditor-dialog-FontOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Font options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Font options}} tab allows you to set the {{man label|Type face}} ''Roman'' or ''Swiss'', the {{man label|Size}} of the font in pt.(point), the {{man label|Color}} of the font and some {{man label|Options}} like ''Bold'', ''Italic'' or ''Underline''.
{{-}}

======Paragraph options======

[[File:StyleEditor-dialog-ParagraphOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Paragraph options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Paragraph options}} tab allows you to set the {{man label|Alignment}}, the {{man label|Background color}}, {{man label|Indentation}}, {{man label|Spacing}} and {{man label|Borders}} of your style.
{{-}}

===Context menu===
[[File:Clipboard-dialog-example-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clipboard - with example contextual pop-up menu from right-clicking a Family]]
[[Gramps_6.0_Wiki_Manual_-_Main_Window#Pop-up_menus|Pop-up menus]] are used in various places in Gramps; how you access the context menu is dependent on your operating systems:
* On Microsoft windows, you generally use the right button of your mouse to show the context menu or use the keyboard shortcut {{man button|Shift}}+{{man button|F10}}. see [https://docs.microsoft.com/en-us/previous-versions/windows/desktop/mpc/using-context-menus Using Context Menus - Microsoft Docs]
* On Apple macOS, you generally press {{man button|Ctrl}} while clicking the button of your mouse to show the context menu. see: [https://developer.apple.com/design/human-interface-guidelines/macos/menus/contextual-menus/ Contextual Menus - Menus - macOS - Human Interface Guidelines - Apple Developer]

List of known Context menus in Gramps:
* Pedigree View Context menus
* Clipboard context menu
* File Chooser - Context Menu options
* <Category view> context menus
* Manage Books dialog 
* ... and many more
{{stub}}

See also:
* [[Gramps 6.0 Wiki Manual - Keybindings|Keybindings]]

=== Selector dialogs ===
[[File:SelectFamily-SelectorDialog-example-60.png|450px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]] - showing Search Bar]]


Selector dialogs are a combo interface box and you generally use then to select an object (Person/Family/Events etc). Also various {{man label|Selectors}} also have search bars:
* [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Event_selector|Select Event selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Note_selector|Select Note selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Person_selector|Select Person selector]]
*[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Select_a_person_for_the_report_selector|Select a person for the report selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Father_selector|Select Father selector]] (filtered to Father)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Mother_selector|Select Mother selector]] (filtered to Mother)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Child_selector|Select Child selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Media_Object_selector|Select Media Object selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Place_selector|Select Place selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Repository_selector|Select Repository selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_or_Citation_selector|Select Source or Citation selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_selector|Select Source selector]]

{{-}}
See also
* [https://gramps-project.org/wiki/index.php/GEPS_041:_New_Selector GEPS_041:_New_Selector]
* [[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]

{{stub}}

== Customizing ==
Here are some ways that you can customize Gramps.
=== Preferences ===

In the "Display Options" section of the Edit>Preferences {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}} tab you can select the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}}, allowing the creation of user-defined (custom) stylings beyond the pre-defined (built-in) name format choices.

See [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Name Editor]]}}, allowing the selection of a name format exceptions that will override the format chosen in the Display tab of Preferences for the entire Tree.

The name format, grouping and sorting can be overridden for selected individuals and surnames. The Edit Person dialogs have two Edit buttons to access this feature. The button for Preferred name is to the right of the Suffix field. However, for any selected Name (Preferred or Alternative) in the Names tab which opens the Name Editor. The built-in and custom Display Name formats can be selected exceptions to "Group as:" and "Sort as:" options that default to the Name format selected in Preferences.

=== Pick a Color selector ===
The [[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]] tab of the Preferences allows customizing of the color of various elements of diagrams in the Charts category's graphical views.

==== Color Palette ====
[[File:PickAColor-selector-dialog-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - palette selector dialog]]
Select a color from the 45 [[Gramps_Glossary#swatch|swatches]] in predefined color palette area. Or select from the recently used {{man label|Custom}} color swatches. Or click the {{man button|+}} button to create your own custom color. Right-click on any swatch to add another custom color and open the gradient selector.

You can drag any color swatch to any swatch in the preference (or configure) dialog.

{{-}}
==== Color Gradient ====
[[File:PickAColor-gradient-dialog-52.png|right|thumb|436px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - gradient selector dialog]]
The gradient selector dialog is for adjust the [[Gramps_Glossary#swatch|color swatch]] at the top of the dialog. Once changed, either click the {{man button|Select}} button to apply the color. Drag the single gradient dialog swatch to any swatch in the preference (or configure) dialog.

Specific colors of the swatch can be changed in several ways:
* via direct entry 'color Hex color code'
* the hue slider (with a numeric fine control
* mouse left-click in the 1-dimensional (hue) rainbow gradient or the 2-dimensional (brightness and saturation) hue gradient.
* mouse right-click in either gradient to show the numeric control for the dimension(s) of the gradient
* mouse left-click on the eyedropper color picker to choose from any pixel shown on the monitor(s)
{{-}}

=== File Chooser ===
[[File:FileChooser_Bookmarks_Breadcrumbs.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Linux GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs mac.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} macOS GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs win.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Windows GTK File Chooser: highlighting breadcrumbs and bookmarking]]
The Open and Save dialogs (File Chooser) for Gramps are based on the [https://docs.gtk.org/gtk3/iface.FileChooser.html GTK File Chooser]. Each operating system has expected behaviors for clicks, double-clicks, sorting, [[Gramps_6.0_Wiki_Manual_-_Keybindings#Handy_Shortcuts|keybindings]], environmental variables, and standard file locations that are characteristic of File Chooser dialogs native to the operating system. A few of these can be customized via the user interface to feel more similar to the OS native File Choosers. However, the idiosyncrasies of various OSes mean shared network folders and URI support may not be as readily browsed as when using the OS native File Choosers.

The [https://developer-old.gnome.org/gtk4/stable/GtkFileChooser.html GtkFileChooser] allows for adding quick navigation hotlinks to commonly used places of the filesystem. In the default implementation, these are displayed in the left sidebar navigation pane. It may be a bit unclear at first that these shortcuts come from various sources and in various flavors, so let's explain the terminology here:
* '''[[#Bookmarking_file_folders|Bookmarks]]''': are created by the user, by dragging folders from the right pane to the left pane, or by using the “Add”. Bookmarks can be renamed and deleted by the user.
* '''Shortcuts''': can be provided by the Gramps application. For example, program may want to add a shortcut for a Downloads or Documents folder. Shortcuts ''cannot'' be added or removed by the user. The 'Rename...' context menu option allows them to be relabeled.
* '''Volumes''': are provided by the underlying filesystem abstraction. They are the “roots” of the filesystem. The Home and Downloads hotlinks are common "roots". Volumes cannot be modified by the user.

====File Chooser context menus====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
<hr>
*{{man menu|Open With File Manager}}
<hr>
*{{man menu|Copy Location}}
*{{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]}}
<hr>
*{{man menu|❏ Show Hidden Files}}
*{{man menu|☑ Show Size Column}}
*{{man menu|☑ Show Type Column}}
*{{man menu|❏ Show Time}}
*{{man menu|❏ Sort Folders before Files}}
<hr>

Right-click in the navigation sidebar to open context pop-up menu with the following options:
<hr>
*{{man menu|Open}}
*{{man menu|Remove}}
*{{man menu|Rename...}}
<hr>

====Breadcrumbs and text-entry address bar====
By default, the file folder navigation in the File Chooser is by browsing. There are also some shortcuts on the left and breadcrumbs (highlighted in green in the dialog illustration) for quick navigation up and down the path.

Optionally, a text-entry address bar can be used to directly key-in or paste a path. Toggle between displaying breadcrumbs and the text-entry address bar with the {{Man key press|CTRL|L}} [[Gramps_6.0_Wiki_Manual_-_Keybindings|keybinding]].

====Bookmarking file folders====
File folder bookmarks can be user defined to make finding standard locations easier. These bookmarks are remembered between sessions and regardless of which Family Tree has been loaded.

With any Open or Save dialog open, navigate to the file location containing the folder to be bookmarked. Create the bookmark by either: dragging the folder icon to the navigation column on the left; or, right-clicking that folder to use the {{Man menu|Add to Bookmarks}} context menu option.

Right-clicking an existing Bookmark allows renaming that bookmark or removing it.

====File Formats====
Support for several file formats are built into the standard distribution of Gramps. Import plugin and Export Plugin Addons can be installed via the Plugin Manager or Preferences to expand the options.

See the [[Output_formats|Output Format]] article for list of file formats.

====See also====
* [https://ubuntugenius.wordpress.com/2010/05/14/how-to-show-text-entry-address-bar-or-breadcrumbs-navigation-buttons-in-nautilus-after-ubuntu-10-04-upgrade/ How to Show Text-Entry Address Bar or “Breadcrumbs” (Navigation Buttons)] in Nautilus After Ubuntu 10.04 Upgrade

*Discourse discussions about the GTK File Chooser:
** [https://gramps.discourse.group/t/need-suggestions-for-documenting-the-gtk-file-chooser/1820/8 Documenting the File Chooser in the wiki]
** [https://gramps.discourse.group/t/macos-and-windows-gtk-file-chooser-dialog-capture-request/3364 Illustrating the File Chooser in the Wiki]
** [https://gramps.discourse.group/t/can-i-cause-folders-to-sort-to-the-top-of-the-list-when-presented-with-the-folder-contents/1708/14 File Chooser: Sorting files and folders]
* [https://discourse.gnome.org/t/where-is-the-filechooser-feature-list/9101/1 Where is the FileChooser feature list?]

=== Language ===

Gramps has been translated into a number of [[Portal:Translators|languages]]. Usually Gramps automatically starts in your local language, as chosen for other applications, but sometimes this may not be right for you. And in other cases, a module or addon will not yet have been translated and a warning dialog will appear saying something like “Warning: plugin XYZ has no translation for any of your configured languages, using US English instead”. (Note that the US dialect of English is the default rather than British.) This can become annoying or intrusive.

The most idealistic situation is that you are as fluent in US English as the language selected for the operating system GUI on your computer. And that you would take the opportunity to translate that Gramps feature for users who are non-English speakers.

If your system is configured to show a language other then English, you can override this for Gramps.

As an example, assume that a computer in the Netherlands is configured to default to Unicode 8 Dutch: "LANG: nl_NL.UTF-8". You could either reset the OS language

In Windows, use the SET command to change the LANG environment variable to "en_GB.UTF-8" for British English. You can do this from the command line interface or [https://gramps-project.org/bugs/view.php?id=11009 create a startup shortcut with the following Target]:
<code>C:\Windows\System32\cmd.exe /c "SET LANG=en_GB.UTF-8 && START /D ^"C:\Program Files\GrampsAIO64-6.0.5^" gramps.exe"</code>

{{stub}} '''{{man warn|tbd|Describe for each main platform how the normal language is determined and how the user can [[Howto:Change_the_language_of_reports#Run_Gramps_in_a_different_language|choose a different language]].'''}}

==== Linux ====
{{stub}}

If you want to choose a locale 'variant' for sorting that is not the default variant, then you can start Gramps from the terminal (or console) with a different LC_COLLATE environment. For example, the default sorting (collation) variant for Swedish is "reformed", but you can instead choose "standard" by typing:
export LC_COLLATE="sv_SE.UTF-8@collation=standard"
python Gramps.py

==== macOS ====

For macOS see [[Mac_OS_X:Application_package#Advanced_setup|Advanced setup]] for details on how the language is normally chosen, and how to choose a special, non-default setting for the language, the sorting order or the format of such things as day and month names and number separators.

==== MS Windows ====
[[File:MicrosoftWindowGrampsAIO-Installer-ChooseComponents-Selection-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps 6.0.3 AIO 64 bit for Microsoft Windows installer - "Choose Components" page showing selection of the "de"( German) Translation]]
If you want to run Gramps in another language other than English using the Gramps AIO installer, then you must select it during installation process.

Otherwise it will not be available.

More information can be found at [[Installing_Gramps_for_Windows_computers#Missing_other_languages]] page.

{{-}}

===Add Windows OS Menu Item===
[[File:Edit-Target-GrampsAIO64-Properties-Danish-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for Danish shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_6.0_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 6.x.x}}" icon on Desktop and from menu choose: {{man label|Copy}}.
* Right click anywhere on Desktop and from menu choose: {{man label|Paste shortcut}}
* New icon will be created with name: "{{man label|GrampsAIO64 6.x.x (2)}}"
* Right click on that and from menu choose: {{man label|Properties}}
* A new window will open, click on first tab called {{man label|General}} and change text from "{{man label|GrampsAIO64 6.x.x (2)}}" to something more descriptive like: "{{man label|GrampsAIO Danish}}"
** Click on second tab called {{man label|Shortcut}}, change text in first entry called {{man label|Target}} from (note path will vary depending on Gramps version used):
***<code>"C:\Program Files\GrampsAIO64-6.x.x\grampsw.exe"</code> to:
***<code>%comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"</code>
* Click {{man label|OK}}

Now when you click on that icon Gramps will start in Danish.

{{-}}
{{man tip|You can download a zip file attached to feature request:{{bug|13204}} Gramps AIO64 5.2 Language icons Shortcuts Pack ( for the languages shown in the [[#Language_codes|Language codes]] table below)}}
{{-}}

===Change the windows LANG variables===
Another option if you want Gramps to always load in say: French Canadian language, you can go to Windows > System Properties, and add the LANG variable in the user section of the environment variables dialog with the appropriate Value.

The value to add is:
<pre>
Name: LANG
Value: fr_CA.UTF-8
</pre>

* [https://www.redswitches.com/blog/environment-variables/#method-1-set-environment-variables-through-the-gui How to Set Environment Variables in Windows 10]

===Language codes===
Select from the following table of [[Portal:Translators|languages Gramps]] has been translated into:

{| {{prettytable}}
!Language
!ISO code
!Example
!Notes
|-
| English-USA (Default)
| en_US.UTF-8
| %comspec% /c set LANG=en_US.UTF-8 && start grampsw.exe"
|
|-
| English (British)
| en_GB.UTF-8
| %comspec% /c set LANG=en_GB.UTF-8 && start grampsw.exe"
|
|-
| Finnish
| fi.UTF-8
| %comspec% /c set LANG=fi.UTF-8 && start grampsw.exe"
|
|-
| Russian
| ru_RU.UTF-8
| %comspec% /c set LANG=ru_RU.UTF-8 && start grampsw.exe"
|
|-
| Albanian
| sq_AL.UTF-8
| %comspec% /c set LANG=sq_AL.UTF-8 && start grampsw.exe"
|
|-
| German
| de_DE.UTF-8
| %comspec% /c set LANG=de_DE.UTF-8 && start grampsw.exe"
|
|-
| French
| fr_FR.UTF-8
| %comspec% /c set LANG=fr_FR.UTF-8 && start grampsw.exe"
|
|-
| French Canadian
| fr_CA.UTF-8
| %comspec% /c set LANG=fr_CA.UTF-8 && start grampsw.exe"
|
|-
| Macedonian
| mk_MK.UTF-8 ???
|
|
|-
| Nederlands (Dutch)
| nl_NL.UTF-8
| %comspec% /c set LANG=nl_NL.UTF-8 && start grampsw.exe"
|
|-
| Dutch
| nl_BE.UTF-8
| %comspec% /c set LANG=nl_BE.UTF-8 && start grampsw.exe"
|
|-
| Slovak
| sk_SK.UTF-8
| %comspec% /c set LANG=sk_SK.UTF-8 && start grampsw.exe"
|
|-
| Hebrew
| he_IL.UTF-8
| %comspec% /c set LANG=he_IL.UTF-8 && start grampsw.exe"
|
|-
| Danish
| da_DK.UTF-8
| %comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"
|
|-
| Greek
| el_GR.UTF-8
| %comspec% /c set LANG=el_GR.UTF-8 && start grampsw.exe"
|
|-
| Italian
| it_IT.UTF-8
| %comspec% /c set LANG=it_IT.UTF-8 && start grampsw.exe"
|
|-
| Esperanto
| eo.UTF-8 ???
|
|
|-
| Chinese (Simplified)
| zh_CN.UTF-8
| %comspec% /c set LANG=zh_CN.UTF-8 && start grampsw.exe"
|
|-
| Chinese (Hong Kong)
| zh_HK.UTF-8 ???
|
|
|-
| Chinese (Traditional)
| zh_TW.UTF-8
| %comspec% /c set LANG=zh_TW.UTF-8 && start grampsw.exe"
|
|-
| Ukrainian
| uk_UA.UTF-8
|
|
|-
| Portuguese
| pt_PT.UTF-8
| %comspec% /c set LANG=pt_PT.UTF-8 && start grampsw.exe"
|
|-
| Portuguese (Brazil)
| pt_BR.UTF-8
| %comspec% /c set LANG=pt_BR.UTF-8 && start grampsw.exe"
|
|-
| Afrikaans
| af_ZA.UTF-8
|
|
|-
| Norwegian Bokmål
| nb_NO.UTF-8
| %comspec% /c set LANG=nb_NO.UTF-8 && start grampsw.exe"
|
|-
| Norwegian Nynorsk
| nn_NO.UTF-8
| %comspec% /c set LANG=nn_NO.UTF-8 && start grampsw.exe"
|
|-
| Turkish
| tr_TR.UTF-8
| %comspec% /c set LANG=tr_TR.UTF-8 && start grampsw.exe"
|
|-
| Spanish
| es_ES.UTF-8
| %comspec% /c set LANG=es_ES.UTF-8 && start grampsw.exe"
|
|-
| Polish
| pl_PL.UTF-8
| %comspec% /c set LANG=pl_PL.UTF-8 && start grampsw.exe"
|
|-
| Slovenian
| sl_SI.UTF-8
| %comspec% /c set LANG=sl_SI.UTF-8 && start grampsw.exe"
|
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|}
*The language codes are two-letter lowercase ISO language codes (such as "da") as defined by [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1].
*The country codes are two-letter uppercase ISO country codes (such as "BE") as defined by [https://en.wikipedia.org/wiki/ISO_3166-1 ISO 3166-1].

===Advanced manipulation of settings===
{{stub}}

{{man warn| Warning ** Make sure you have closed Gramps **|The contents of this section is outside the scope of interest of a general user of Gramps. If you proceed with tweaking the options on the low level you may damage your Gramps installation. Be careful. '''YOU HAVE BEEN WARNED!'''}}

Besides the settings available in Preferences, you may also wish to explore the advanced settings.

Gramps uses '''[https://en.wikipedia.org/wiki/INI_file#Keys_(properties) INI keys]''' and [https://en.wikipedia.org/wiki/INI_file#Sections INI sections] for managing user preferences and program settings these are stored in the text file <code>gramps.ini</code> under the <code>.gramps/gramps[XX]</code> folder in your home or user directory.

The <code>gramps.ini</code> file has following sections:
* [behavior] : typical Key names are: [https://github.com/gramps-project/gramps/blob/master/gramps/gui/grampsgui.py#L502 betawarn], enable-autobackup, use-tips...
* [colors] :
* [csv] :
* [database] : related to database settings for the Family Tree.
* [export] : export and import folders/directories
* [geography] :
* [interface] : a lot of keys regarding height and width of the different Views: e.g. event-height: 450, event-ref-height: 585, event-ref-width: 728, event-width: 712...
* [paths] : keys related to recent imported files and folders/directories
* [plugin] :
* [preferences] : keys related to preferences: all the common prefixes , todo -colors..
* [researcher] : all information regarding the researcher
* [spacing] :
* [test] :
* [utf8] :

====Example <code>gramps.ini</code> file====
Example contents of the <code>gramps.ini</code> file:


<pre>
;; Gramps key file
;; Automatically created at 2025/05/24 08:49:41

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps60', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps60'
;;autoload=0
;;avg-generation-gap=20
;;check-for-addon-update-types=['new']
;;check-for-addon-updates=0
;;date-about-range=50
;;date-after-range=50
;;date-before-range=50
;;do-not-show-previously-seen-addon-updates=1
;;generation-depth=15
;;immediate-warn=0
;;last-check-for-addon-updates='1970/01/01'
;;max-age-prob-alive=110
;;max-sib-age-diff=20
;;min-generation-years=13
;;owner-warn=0
;;pop-plugin-status=0
;;previously-seen-addon-updates=[]
;;recent-export-type=3
;;runcheck=0
;;spellcheck=0
;;startup=0
;;surname-guessing=0
translator-needed=0
;;use-tips=1
;;web-search-url='https://google.com/search?q=%(text)s'
;;welcome=100

[colors]
;;border-family=['#cccccc', '#252525']
;;border-family-divorced=['#ff7373', '#720b0b']
;;border-female-alive=['#861f69', '#261111']
;;border-female-dead=['#000000', '#000000']
;;border-male-alive=['#1f4986', '#171d26']
;;border-male-dead=['#000000', '#000000']
;;border-other-alive=['#2a5f16', '#26a269']
;;border-other-dead=['#000000', '#000000']
;;border-unknown-alive=['#8e5801', '#8e5801']
;;border-unknown-dead=['#000000', '#000000']
;;family=['#eeeeee', '#454545']
;;family-civil-union=['#eeeeee', '#454545']
;;family-divorced=['#ffdede', '#5c3636']
;;family-married=['#eeeeee', '#454545']
;;family-unknown=['#eeeeee', '#454545']
;;family-unmarried=['#eeeeee', '#454545']
;;female-alive=['#feccf0', '#62242D']
;;female-dead=['#feccf0', '#3a292b']
;;home-person=['#bbe68a', '#304918']
;;male-alive=['#b8cee6', '#1f344a']
;;male-dead=['#b8cee6', '#2d3039']
;;other-alive=['#94ef9e', '#285b27']
;;other-dead=['#94ef9e', '#062304']
;;scheme=0
;;unknown-alive=['#f3dbb6', '#75507B']
;;unknown-dead=['#f3dbb6', '#35103b']

[csv]
;;delimiter=','
;;dialect='excel'

[database]
;;autobackup=0
;;backend='sqlite'
;;backup-on-exit=1
;;backup-path='C:\\Users\\[username]'
;;compress-backup=1
;;host=''
;;path='C:\\Users\\[username]\\AppData\\Roaming\\gramps\\grampsdb'
;;port=''

[export]
;;proxy-order=[['privacy', 0], ['living', 0], ['person', 0], ['note', 0], ['reference', 0]]

[geography]
;;center-lat=0.0
;;center-lon=0.0
;;lock=0
;;map_service=1
;;path=''
;;personal-map=''
;;show_cross=0
;;use-keypad=1
;;zoom=0
;;zoom_when_center=12

[interface]
dbmanager-height=370
;;dbmanager-horiz-position=12
;;dbmanager-vert-position=85
;;dbmanager-width=780
;;dont-ask=0
;;filter=0
;;fullscreen=0
;;grampletbar-close=1
;;hide-lds=0
;;ignore-gexiv2=0
;;ignore-osmgpsmap=0
;;ignore-pil=0
;;main-window-height=500
;;main-window-horiz-position=15
;;main-window-vert-position=10
;;main-window-width=775
;;mapservice='OpenStreetMap'
;;open-with-default-viewer=0
;;pedview-layout=0
;;pedview-show-images=1
;;pedview-show-marriage=0
;;pedview-show-unknown-people=0
;;pedview-tree-direction=2
;;pedview-tree-size=5
;;place-name-height=100
;;place-name-width=450
;;sidebar-text=1
;;size-checked=0
;;statusbar=1
;;surname-box-height=150
;;tipofday-height=350
tipofday-horiz-position=-49
tipofday-vert-position=84
;;tipofday-width=550
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-style=0
;;toolbar-tools=1
;;treemodel-cache-size=1000
;;view=1
;;view-categories=['Dashboard', 'People', 'Relationships', 'Families', 'Ancestry', 'Events', 'Places', 'Geography', 'Sources', 'Citations', 'Repositories', 'Media', 'Notes']

[paths]
;;quick-backup-directory='C:\\Users\\[username]'
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'
;;recent-export-dir='C:\\Users\\[username]'
;;recent-file=''
;;recent-import-dir='C:\\Users\\[username]'
;;report-directory='C:\\Users\\[username]'
;;website-cal-uri=''
;;website-cms-uri=''
;;website-directory='C:\\Users\\[username]'
;;website-extra-page-name=''
;;website-extra-page-uri=''

[plugin]
;;addonplugins=[]
;;hiddenplugins=[]

[preferences]
;;age-after-death=1
;;age-display-precision=1
;;age-rounded-year=1
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-legacy'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=0
;;february-29=0
;;fprefix='F%04d'
;;hide-ep-msg=0
;;invalid-date-format='%s'
;;iprefix='I%04d'
last-view='dashboardview'
last-views=['dashboardview', '', '', '', '', '', '', '', '', '', '', '', '']
;;name-format=1
;;no-given-text='[Missing Given Name]'
;;no-record-text='[Missing Record]'
;;no-surname-text='[Missing Surname]'
;;nprefix='N%04d'
;;online-maps=0
;;oprefix='O%04d'
;;paper-metric=0
;;paper-preference='Letter'
;;patronimic-surname=0
;;place-auto=1
;;place-format=0
;;pprefix='P%04d'
;;private-given-text='[Living]'
;;private-record-text='[Private Record]'
;;private-surname-text='[Living]'
;;quick-backup-include-mode=0
;;rprefix='R%04d'
;;sprefix='S%04d'
;;tag-on-import=0
;;tag-on-import-format='Imported %Y/%m/%d %H:%M:%S'
;;use-last-view=0

[researcher]
;;researcher-addr=''
;;researcher-city=''
;;researcher-country=''
;;researcher-email=''
;;researcher-locality=''
;;researcher-name=''
;;researcher-phone=''
;;researcher-postal=''
;;researcher-state=''

[spacing]
dbman=[22.605613425925927, 5.877459490740741, 9.856047453703704]

[test]
;;january='January'

[utf8]
;;baptism-symbol='~'
;;birth-symbol='*'
;;buried-symbol='[]'
;;cremated-symbol='⚱'
;;dead-symbol='✝'
;;death-symbol=2
;;divorce-symbol='o|o'
;;engaged-symbol='o'
;;in-use=0
;;killed-symbol='x'
;;marriage-symbol='oo'
;;partner-symbol='o-o'
;;selected-font=''
</pre>

====Advanced backup filename setting====
You can also define the naming pattern for the backup filename by setting the ''<code>paths.quick-backup-filename</code>'' in the <code>~/.gramps/gramps60/gramps.ini</code> key file like the following:
{{-}}
[paths]
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'

by removing the two semicolons(<code>;;</code>) from the front of INI key line and using use any of the following keywords for the filename pattern:
*filename
*year
*month
*day
*hour
*minutes
*seconds
*extension :
**'''.gpkg'''(default) if you include media.
**''.gramps'' if you exclude media.

Use the appropriate ~/.gramps/gramps{XX}/gramps.ini key file.
*Gramps version 6.0 :
~/.gramps/gramps60/gramps.ini

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Command_Line#Configuration_.28config.29_option]]
* [[Install_latest_BSDDB#Make_Gramps_use_bsddb3]]
* [[Customize_the_Genealogical_Symbols_lookup_table#Genealogy_symbols_preferences]]

===Theme===
The look of Gramps can be changed.

* [[Addon:ThemePreferences|Addon:Theme Preferences]]
* [[Windows_AIO_themes]]
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]
* [[Overrule_Gramps_Icons]] - for older Gramps versions.
* [[UI style]]

Some reports can also be changed:

* [[Website report Themes]]
{{-}}
{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Gramps 6.0 Wiki Manual - Categories

2025-12-06T04:36:33Z

CallMeDave: /* ⚙ Configuration Options */

{{man index|Gramps 6.0 Wiki Manual - Main Window|Gramps 6.0 Wiki Manual - Manage Family Trees|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Categories}}
{{#vardefine:chapter|4}}
{{#vardefine:figure|0}}
Genealogical information is very broad and can be extremely detailed. Displaying it poses a challenge that Gramps takes on by dividing and organizing the information into a series of Categories, each with their own Views. Each View displays a portion of the total information, selected according to a particular category. This will become clearer as we explore the different Categories.

* See the [https://wikipedia.org/wiki/Genealogy#Types_of_information Types of Genealogical information] - entry on Wikipedia, the free encyclopedia
== Categories of the Navigator ==
The different Categories of the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Navigator|Navigator]]: The navigator is located at the left of the window and allows selection of the different categories.

[[File:Gramps-navigator-sidebar-60.png|left|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Navigator sidebar with Navigator mode "Category" selection Drop-Down list shown]]

*{{man label|{{icon|gram}} '''[[#Dashboard_Category|Dashboard]]'''}}: Displays different general purpose Gramplets, small widgets that can help in your genealogical research.

*{{man label|{{icon|peop}} '''[[#People_Category|People]]'''}}: List of people in the family tree.

*{{man label|{{icon|rela}} '''[[#Relationships_Category|Relationships]]'''}}: Displays the relationships between the Active Person and other people in a textual way. This includes the parents, siblings, spouses, and children of that person.

*{{man label|{{icon|fami}} '''[[#Families_Category|Families]]'''}}: List of families in the family tree.

*{{man label|{{icon|ance}} '''[[#Charts_Category|Charts]]'''}}: Displays graphical trees for the selected person.

*{{man label|{{icon|even}} '''[[#Events_Category|Events]]'''}}: List of events in the family tree.

*{{man label|{{icon|plac}} '''[[#Places_Category|Places]]'''}}: List of places in the family tree.

*{{man label|{{icon|geog}} '''[[#Geography_Category|Geography]]'''}}: Displays place data of your family tree on a map.

*{{man label|{{icon|sour34}} '''[[#Sources_Category|Sources]]'''}}: List of sources in the family tree.

*{{man label|{{icon|cite}} '''[[#Citations_Category|Citations]]'''}}: List of citations in the family tree.

*{{man label|{{icon|repo}} '''[[#Repositories_Category|Repositories]]'''}}: List of repositories in the family tree.

*{{man label|{{icon|medi}} '''[[#Media_Category|Media]]'''}}: List of media objects in the family tree.

*{{man label|{{icon|note}} '''[[#Notes_Category|Notes]]'''}}: List of notes in the family tree.

{{-}}
[[File:Navigator-mode-selection-drop-down-60.png|450px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} [[Gramps_6.0_Wiki_Manual_-_Main_Window#Drop-Down_navigator_mode|Drop-Down navigator mode]] showing Charts Category view modes]]

===View modes===
The categories can contain several ways of presenting the data. Each specific way is called a View mode.
For example:
*{{man label|{{icon|ance}} '''[[#Charts_Category|Charts]]'''}} ''view category''
** {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#Pedigree_View|Pedigree]]}} '''default view mode'''
** {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#Fan_Chart_View|Fan Chart]]}} ''alternate view mode''
** {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#Descendant_Fan_View|Descendant Fan]]}} ''alternate view mode''
** {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#2-Way_Fan_View|2-Way Fan]]}} ''alternate view mode''

{{-}}
For each category you have a variety of ways to switch between View modes:
# By selecting the relevant icon from the toolbar
# From the menu {{man menu|View > ... }}
# Via the number-based [[Gramps_6.0_Wiki_Manual_-_Keybindings#List_Views|keybindings]] (aka keyboard shortcuts) to ''Change the view mode to correspond to number key {{man key press|0}}/{{man key press|1}}/{{man key press|2}}/../{{man key press|9}} in this view category''
# From the Navigator bar when the Drop-Down or Expander features are selected (See [[Gramps_6.0_Wiki_Manual_-_Main_Window#Switching_Navigator_modes|Switching Navigator modes]])
{{-}}
{{man tip|By default, the Navigator is configured to select Views by main Category|New users may find that re-configuring to the Drop-Down option would make selecting the alternate View modes more intuitive. The Drop-Down and Expander options create mode selectors in close proximity to the Category icon and those interface options will not change with context.
 
[[File:Navigator-mode-selection-dropdownlist-60.png|center|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Navigator mode selection Drop-Down list. See [[Gramps_6.0_Wiki_Manual_-_Main_Window#Switching_Navigator_modes|Switching Navigator modes]] ]]

}}

{{-}}
The following sections provide a brief description of each category and the view modes within.

== Dashboard Category ==
[[File:gramps-gramplet.png|left]]
[[File:DashboardCategory-DashboardView-default-gramplets-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dashboard Category (Default View)]]
This category contains the '''Dashboard''', which shows a number of widgets, called [[Gramps_6.0_Wiki_Manual_-_Gramplets#What_is_a_Gramplet|Gramplets]], that can help you in your research.

Two Gramplets are shown by default on start-up (the [[Gramps_6.0_Wiki_Manual_-_Gramplets#Top_Surnames|Top Surname]] and [[Gramps_6.0_Wiki_Manual_-_Gramplets#Welcome|Welcome to Gramps!]] Gramplets) in a two column configuration; changeable in the [[Gramps_6.0_Wiki_Manual_-_Categories#Gramplet_Layout_tab|Gramplet layout]] tab. The Sidebar and Bottombar are not available on the Dashboard.

On the Dashboard you can:
* Click on a gramplets {{man button|name}} to rename it.
* {{man button|⚙}} - {{man tooltip|Drag to move; click to detach}} and rearrange the Gramplets.
** Closing {{man button|x}} a detached gramplet returns it to the Dashboard.
* {{man button|-}} - {{man tooltip|Click to expand/collapse}} the Gramplet.
* {{man button|x}} - {{man tooltip|Click to delete gramplet from view}} when attached.

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#The_Dashboard_Category_View]] 

You can change the Gramplets on the Dashboard by using the context menu (right-clicking) on an empty area of the Dashboard View. This will show a pop-up menu to {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#Add_a_gramplet|Add a gramplet]]}}, populated with a list of the possible Gramplets you may add and use with this particular view. (Some Gramplets are only available in particular category views.) It is better to have a Family Tree open when changing out Gramplets. The added feedback of some tree data in the Gramplets will help make choices about configuring the layout.

*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Age_on_Date|Age on Date]]}} Gramplet - list the people alive and their ages on a particular date
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Age_Stats|Age Stats]]}} Gramplet - list age span statistics in a number of graphs
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Calendar|Calendar]]}} Gramplet - see people's events on a particular date, or in a month in the past
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#FAQ|FAQ]]}} - Frequently asked questions about Gramps.
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Given_Name_Cloud|Given Name Cloud]]}} Gramplet - most popular given names
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Quick_View|Quick View]]}} - run a Quick View on the current person
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Records|Records Gramplet]]}} - see world's records of your data
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Session_Log|Session Log]]}} Gramplet - keep track of what you have done, and what records you have visited
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#SoundEx|SoundEx Gramplet]]}} generates [[Gramps_6.0_Wiki_Manual_-_Gramplets#Soundex|SoundEx codes]] for the names of people in the database.
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Statistics|Statistics]]}} Gramplet - see stats on the database
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Surname_Cloud|Surname Cloud]]}} Gramplet - most popular surnames as a "text cloud"
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#To_Do|To Do]]}} Gramplet - a notepad to keep tabs on your research
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Top_Surnames|Top Surnames]]}} Gramplet - top 10 most popular surnames ''(default)''
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Welcome|Welcome]]}} Gramplet - a Gramps welcome message ''(default)''
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#What.27s_Next|What's Next]]}} Gramplet - what needs to be done next

In addition, there are a number of Third-party Gramplets that you can easily install and use. These include:
*{{man label|[[Addon:HeadlineNewsGramplet|Headline News Gramplet]]}} - current, breaking news from Gramps
*{{man label|[[Addon:DataEntryGramplet|Data Entry Gramplet]]}} - edit active person's name, birth date and place, death date and place, and add people
*{{man label|[[Addon:Python_Shell_Gramplet|Python Gramplet]]}} - a Python shell
*{{man label|[[Addon:NoteGramplet|Note Gramplet]]}} - see and edit active person's primary Person Note

and many others. See [[Third-party Addons]] for more details.

For more detailed information on using the installed Gramplets, see [[Gramps 6.0 Wiki Manual - Gramplets|Gramplets]].

{{-}}
=== Dashboard context menu ===
[[File:DashboardCategory-context-menu-default-gramplets-list-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dashboard Category View - Showing Dashboards context menu "Add a gramplet"s default gramplet list. With no gramplets on Dashboard]]

The Dashboard context menu shown when right-clicking on an empty area of the Dashboard View, allows you to add or restore gramplets.

Dashboard views {{man button|Add a gramplet}} drop-down menu shows the {{man button|Add a gramplet}} and {{man button|Restore a gramplets}} options. A similar {{man button|Add a gramplet}} drop-down menu is also available from the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Gramplet_Bar_Menu|Gramplet Bar Menu]] available on the Bottombar and Sidebar of other Category views.

===={{man menu|Add a gramplet}}====
Shows a list of gramplets that can be installed on the Dashboard view.

===={{man menu|Restore a gramplet}}====
Shows a list of gramplets that have been removed during that session of Gramps that can be restored.
{{-}}

===⚙ Dashboard Category Configuration Options===
[[File:ConfigureTheActiveView-icon-on-toolbar-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man button|Configure the active view}} button]]
If any of the displayed Gramplets on the Dashboard have configuration options then those options will be shown on the related tabs, click the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button. Alternatively, you can choose {{man menu|Configure...}} from the {{man menu|View}} menu.

{{-}}
==== Gramplet Layout tab====
[[File:ConfigureDashboard-GrampletLayout-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Dashboard - Gramplet Layout - tab - default ]]
On the {{man label|Gramplet Layout}} tab you can change the number of columns shown for Gramplets.

* {{man label|Number of Columns:}} <code>2</code> (default)
{{-}}

== People Category ==
[[File:PeopleCategory-Toolbar-partial-overview-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People Category - Toolbar People View Options.]]

[[File: gramps-person.png|left]]
[[File:Menubar-View-overview-example-60.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} View menu for the People category - People Tree view mode]]
In the {{man label|People Category}} the {{man label|[[#Tree_View_-_Grouped_People|Grouped People]]}} ''by surname'' (default) or {{man label|[[#People_List_View|People List]]}} views display a list of all people in the family tree without their connections. From this view, you may add, edit, remove, export column data, or merge people. Each view (Grouped or List) display several columns of information about each person.

Additional options are available by selecting a person from the list and using the pop-up [[Gramps_Glossary#context_menu|context menu]] shown by right-clicking.
{{-}}

===Tree View - Grouped People===
{{man note|Configure the view limitation|For the Grouped People view the first column ({{man label|Name}}) cannot be changed as the view is based on showing grouped surnames.}}

[[File:PeopleTreeView-GroupedPeople-example-with-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "People Category" - "People Tree View" - "Grouped People" list showing context menu]]

People are grouped according to their family names (also known as a surname or last name). To the left of each collapsed family name is typically either an arrow {{man button|▶}} or some other type of indicator (e.g., {{man button|+}}). Clicking it once will reveal the entire list of people sharing that name. Clicking the indicator again will "roll up" the list and show only the family name.

Additional options are available by selecting a person from the grouped list and using the pop-up {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Grouped_People_context_menu|Grouped People context menu]]}} shown by right-clicking.

==== Grouped People context menu ====
Additional options are available by selecting a person from the grouped list and using the pop-up [[Gramps_Glossary#context_menu|context menu]] shown by right-clicking:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Home}}
*{{man menu|Set Home Person}}
<hr>
*{{man menu|Expand all Nodes}}
*{{man menu|Collapse all Nodes}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View}}
**{{man menu|All Events}}
**{{man menu|Father lineage}}
**{{man menu|Mother lineage}}
**{{man menu|Person References}}
**{{man menu|Relation to Home Person}}
**{{man menu|Same Given Names}}
**{{man menu|Same Surnames}}
**{{man menu|Siblings}}
<hr>
{{-}}

===People List View===
===Tree View - People List View===

[[File:PersonView-PeopleListView-example-with-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "People" Category - "Person" (List) View - showing context menu]]

List of all the people in the database, sorted by first column which by default is the {{man label|Name ▴}} column.

Additional options are available by selecting a person from the list and using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#People_List_View_context_menu|People List View context menu]]}} shown by right-clicking.

==== People List View context menu ====
Additional options are available by selecting a person from the list and using the context/pop-up menu shown by right-clicking:

<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Home}}
*{{man menu|Set Home Person}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View}}
**{{man menu|All Events}}
**{{man menu|Father lineage}}
**{{man menu|Mother lineage}}
**{{man menu|Person References}}
**{{man menu|Relation to Home Person}}
**{{man menu|Same Given Names}}
**{{man menu|Same Surnames}}
**{{man menu|Siblings}}
<hr>
{{-}}

{{#vardefine:viewmode|People category}}{{View Configuration Options}}
{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]]}} tab, {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV dialect]]}} tabs. The People view also defaults to showing the [[#People_Category_Sidebar|Sidebar]] tabs and [[#People_Category_Bottombar_tabs|Bottombar]]. None of the default sidebar gramplets (see [[Gramps_6.0_Wiki_Manual_-_Gramplets#Details|Details]], [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]], [[Gramps_6.0_Wiki_Manual_-_Gramplets#Events|Events]], [[Gramps_6.0_Wiki_Manual_-_Gramplets#Children|Children]], [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]], [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]], [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]], [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]]) or sidebar gramplets (see [[Gramps_6.0_Wiki_Manual_-_Gramplets#People_Filter|Filter]]) have Configurable options.

====={{#var:viewmode}} Columns=====
[[File:ColumnsEditorTab-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Columns''' editor tab - dialog - People Tree View default columns]]

By default, the tabular {{#var:viewmode}} view modes will display the columns selected in the Configuration Options with a row for each Person. Additional columns may be selected in the Configuration Options dialog. Configuration changes appear when the {{man button|Apply}} button is clicked.

The available columns for display are:
* {{checkbox|1}} {{man label|Name}} ('''required''' 1st column for the Grouped People view mode. So it is not shown as a configurable option)
* {{checkbox|1}} {{man label|ID}}
* {{checkbox|1}} {{man label|Gender}}
* {{checkbox|1}} {{man label|Birth Date}}
* {{checkbox|0}} {{man label|Birth Place}}
* {{checkbox|1}} {{man label|Death Date}}
* {{checkbox|0}} {{man label|Death Place}}
* {{checkbox|0}} {{man label|Spouse}}
* {{checkbox|0}} {{man label|Number of Parents}} 
* {{checkbox|0}} {{man label|Number of Marriages}}
* {{checkbox|0}} {{man label|Number of Children}}
* {{checkbox|0}} {{man label|Number of To Do Notes}}
* {{checkbox|0}} {{man label|Private}}
* {{checkbox|0}} {{man label|Tags}}
* {{checkbox|0}} {{man label|Last Changed}}

See also
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_People_Category|Using the People Category]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_people|Editing information about people]]

{{man note|For Information displayed in the columns|Some of the column selection types require that the event being shown to have the ''Role'' type of ''Primary'' e.g., Birth and Death Dates. This is set via the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Event_Reference_Editor_dialog|Event Reference Editor dialog]]'s ''General'' tab.}}
{{man note|Column counts for <code>Number of xxxxxx</code>|For <code>Number of Marriages</code> only relationships of type ''Married'' are counted. For <code>Number of Children</code> only children with a ''Birth'' relationship are counted. However, for <code>Number of Parents</code> any parent in the [[Gramps_6.0_Wiki_Manual_-_Categories#Reorder_Relationships_dialog|Primary relationship]] (even those with a relationship of 'None') will be included in the parent count.}}
{{-}}

===People Category Bottombar tabs===
Both Tree Views (Grouped People/People List View) have the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs. The configuration is independent between modes.
{{-}}
====Details====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Details|Details]] Gramplet
{{-}}
====Gallery====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Events====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Events|Events]] Gramplet
{{-}}
====Children====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Children|Children]] Gramplet
{{-}}
====Citations====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====Attributes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]] Gramplet
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}

===People Category Sidebar tabs===

Both Tree Views (Grouped People/People List View) have the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tab by default. The configuration is independent between modes.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Relationships Category ==
[[File:gramps-relation.png|left]]
[[File:Relationships-category-view-default-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view]]

The Relationships Category shows the default {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Relationships_Category_view|Relationships Category view]]}} which displays all the relationships of the Active Person (the selected person). Specifically, it shows the parents, siblings, spouses, and children of that person.

The Relationships Category is designed to allow for quick navigation. You can quickly change the Active Person simply by clicking the name of any person listed on the page. Each name is actually a [http://en.wikipedia.org/wiki/Hyperlink hypertext link], similar to a web page.

The name of the Active Person is in '''bold''' style and is not underlined. Other names are shown underlined either with or without '''''bold and italic''''' emphasis depending on whether certain relationships exist for the named person. For a person listed as a parent or spouse of the Active Person, the name is emphasized if that person has a parent family. For a person listed as a sibling or child of the Active Person, the name is emphasized if that person has children.

Dates are normally in regular style, and in ''italic'' style if the displayed event is a fallback event, i.e., a substitute event for another missing event. That may be christening event for birth event, burial event for death event, etc.
{{-}}
===Relationships Category view===
[[File:Relationships-category-view-toolbar-detail-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Toolbar section - Relationships Category view]]

For the Relationships Category views via the menu or toolbar you may select:
* {{man menu|Edit > Edit...}} or the {{man button|[[File:Gramps-notes.png|13px]] Edit...{{man tooltip|Edit the active person}}}} icon - opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Person_Editor_dialog|Person Edit dialog]]}}
* {{man menu|Edit > Add New Parents...}} or the {{man button|[[File:Gramps-parents-add.png|13px]] Add {{man tooltip|Add a new set of parents}}}} icon - to create a new family with the Active Person listed as a child.
* {{man menu|Edit > Add Existing Parents...}} or the {{man button|[[File:Gramps-parents-open.png|13px]] Share {{man tooltip|Add person as child to an existing family}}}} icon - which opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]]}} allowing you to choose from a list of existing families, and then add the person as a child to that family.
* {{man menu|Edit > Add Partner...}} or the {{man button|[[File:Gramps-spouse.png|13px]] Partner {{man tooltip|Add a new family with person as parent}}}} icon - to open a new {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor]]}} dialog with the Active Person listed as one of the partners.
* {{man menu|Edit > Reorder...}} or the {{man button|[[File:Stock_reorder.png|13px]] Reorder {{man tooltip|Change order of parents families}}}} icon - to open the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Reorder_Relationships_dialog|Reorder Relationships]]}} dialog.
{{-}}
[[File:Relationships-category-view-sections-collapsed-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category View - example (all sections collapsed)]]

The following sections are available:
* Top section shows the [[Gramps_6.0_Wiki_Manual_-_Categories#Active_Person_section|Active Person]]
* [[Gramps_6.0_Wiki_Manual_-_Categories#Parents|Parents]]
** [[Gramps_6.0_Wiki_Manual_-_Categories#Siblings|Siblings]]
* [[Gramps_6.0_Wiki_Manual_-_Categories#Family|Family]]
** [[Gramps_6.0_Wiki_Manual_-_Categories#Spouse|Spouse]]
** [[Gramps_6.0_Wiki_Manual_-_Categories#Children|Children]]

You can collapse or expand the sections by selecting the {{man button|▶}} arrows.
{{-}}
====Active Person section====

Starting at the top of this section:
* The ''Active Person'''s name is displayed, along with a symbol indicating gender,
** The {{man button|[[File:Gramps-notes.png|13px]]Edit}} button opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog so you can edit all of the Active person's individual information. Pressing {{man button|Ctrl + Return}} on the keyboard together also opens the dialog.

Below that you are shown information on active persons:
* Gramps {{man label|ID}}
* {{man label|* (Birth)}}
* {{man label|Alive:}}
** {{man label|✝ (Death)}}

You will also be shown the calculated age if {{man label|Alive:}} and final age if deceased.

The {{man label|* (Birth)}} and {{man label|✝ (Death)}} areas are text fields that can be highlight and copied.

On the right hand side of this area if available:
* A photo of the active person will be shown. This photo shows the first image available in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Gallery]]}} tab of this person (if any exist). You can click on the photo to open it in the default picture viewer. (See also [[Gramps_6.0_Wiki_Manual_-_Settings#Missing_Media_Objects_.27broken_link.27_icon_of_a_box_with_a_red_.27x.27|Missing Media Objects 'broken link' icon of a box with a red 'x']] )

See also:
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Setting the Active Person]]
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Relationships_Category|Using the Relationships Category]]
* [[Gramps_6.0_Wiki_Manual_-_Settings#Genealogical_Symbols|Genealogical Symbols]]

====Parents====

The Parents section, displays the families in which the person is a child. Since it is possible for a person to have multiple sets of parents ([[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Child_Reference_Editor|biological and non-biological]]), it is possible to have several Parents sections.

You may edit an existing parents by selecting the {{man button|[[File:Gramps-notes.png|13px]]Edit}} button next to the parents. If you select the {{man button|-}} button next to a set of parents, then the Active Person will be removed as a child from the parents. This button does not delete the parents' relationship.

When you collapse the sections by selecting the {{man button|▶}} arrow only the parents names are shown along with a total count of the siblings.

See the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#.E2.9A.99_Relationships_Category_Configuration_Options|Configure Relationships]]}} section to configure what details to show or hide etc...

{{man warn|Warning: If you are not careful, it is possible to create multiple families with the same parents.|This is rarely what the user wants to do. If you attempt to add a new family that has the same parents as an existing family, Gramps will issue a {{man label|[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Duplicate_Family_warning_dialog|Duplicate Family]]}} warning dialog. If you get this dialog, you should probably Cancel the edit, and then use the {{man button|Select}} button to select the existing family.}}

=====Select Family selector=====
[[File:SelectFamily-SelectorDialog-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Family - selector dialog example]]

The {{man label|Select Family}} selector dialog allows you to link to an already existing Family.

The following columns are shown: <code>ID</code> (default sort for list), <code>Father</code>, <code>Mother</code>, <code>Last Change</code>.

You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
* '''ID contains''' (default)
* ''ID does not contain''
* ''Father contains''
* ''Father does not contain''
* ''Mother contains''
* ''Mother does not contain''
* ''Last Change contains''
* ''Last Change does not contain''

Use the {{man button|Clear}} button to clear the search field.

Note on some reports the list is restricted until you select the {{man label|[] Show all}} check box.
{{-}}

=====Siblings=====

The Sibling section shows brothers and sisters of the Active Person plus the Active Person themself.
{{-}}

====Family====

Similar to the Parents section is the Family section, which displays families where the Active Person is a parent. Because it is possible for a Person to have been a partner in multiple families, Gramps allows multiple Family sections to describe that. Each family section displays the spouse and any children. Children who were biological offspring of both partners in one Family might be a stepchild or adopted child for one partner of a subsequently formed family.

{{man note | Spouse |We use the term spouse for sake of simplicity. However, please note that spouse may in fact be a domestic partner, a partner in a civil union, or various other similar relationships between two people. Spouse relationships are ''not'' required to be only between a male and female.}}

You may add a family by selecting the {{man button|Add Spouse}} button in the toolbar. This will create a new family with the Active Person listed as a father or mother.

Selecting the {{man button|[[File:Gramps-notes.png|13px]]Edit}} button next to the spouse will allow you to edit the displayed family.

Clicking the {{man button|-}} button will remove the person from the displayed family.

When you collapse the section by selecting the {{man button|▶}} arrow only the  spouses names are shown along with a total count of the children from that spouse.

{{-}}

{{man warn| Removing a person from a family |Removing a person from a family does not delete the family. The person is removed as the father or mother, and any other relationships in the family continue to exist.}}

{{man note |The terms father and mother are used for the sake of simplicity.|Even if there are no children in a family, the father and mother terminology is still used. In the case of male/male or female/female relationships, the father and mother labels should be considered to be convenience labels.}}

{{-}}
======Reorder Relationships dialog======
{{man note|This option will only be enabled|if more than one set of parents or more than one set of spouses exists for the Active Person.}}

[[File:ReorderRelationships-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reorder Relationships" - dialog - example]]

Select the {{man button|[[File:Stock_reorder.png|13px]] Reorder {{man tooltip|Change order of parents families}}}} button to display the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Reorder_Relationships_dialog|Reorder Relationships]]}} dialog that will allow you to reorder the parents and families. The topmost entry in each of the sections is considered the primary entry and is used for charts, graphs and summaries.

When more than one set of parents or more than one set of spouses exists for the Active Person.

Select one of the following:
* the menu {{man menu|Edit > Reorder}}
* or the {{man button|Change order of parents and families}} toolbar icon button
* or the {{man button|Reorder Parents}} icon near the {{man label|Parents:}} label
* or the {{man button|Reorder Families}} icon near the {{man label|Family:}} label
to display the {{man label|Reorder Relationships}} dialog that will allow you to reorder:

;Parent relationships
* the parents order in the top section {{man label|Parent relationships}} using the {{man button|↑ up}}/{{man button|↓ down}} arrow buttons.
** The topmost set of parents are considered the Primary parents and are used for charts, graphs and summaries.

;Family relationships
* or families order in the bottom section {{man label|Family relationships}} using the {{man button|↑ up}}/{{man button|↓ down}} arrow buttons.
** The topmost family is considered the Primary family and is the family used for charts, graphs and summaries.
{{-}}

=====Children=====

Shows the Active persons children. You are also able to add new or add existing children to the family.
{{-}}

====⚙ Relationships Category Configuration Options====

[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The following options are available:
{{-}}
=====Content=====
[[File:ConfigureRelationshipsView-Content-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Relationships Category - Content (tab) defaults]]

*On the {{man label|Content}} tab
** {{checkbox|1}} {{man label|Show Details}} (checkbox checked by default) show or hide the birth and death information (All except the Active person)
** {{checkbox|1}} {{man label|Show Siblings}} (checkbox checked by default) show or hide siblings.
{{-}}

=====Layout=====
[[File:ConfigureRelationshipsView-Layout-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Relationships Category - Layout (tab) defaults]]

*On the {{man label|Layout}} tab
** {{checkbox|1}} {{man label|Use shading}} (checkbox checked by default)
** {{checkbox|1}} {{man label|Display edit buttons}} (checkbox checked by default) - show or hide the {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button shown next to each person.
** {{checkbox|0}} {{man label|View links as website links}} (checkbox unchecked by default) - Non active peoples names are displayed as blue text with no underline.
{{-}}

===Relationships Category Bottombar tabs===
The {{man label|Relationships Category view}} by default displays no Gramplets in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tab. You may add them as required.
{{-}}
===Relationships Category Sidebar tabs===
The {{man label|Relationships Category view}} by default displays no Gramplets in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tab. You may add them as required.
{{-}}

== Families Category ==
[[File: gramps-family.png|left]]
[[File:Families-category-list-view-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Families" Category - (List) View - showing context menu and "Children" tab in the bottombar]]

In the {{man label|Families Category}} the {{man label|Families List view}} displays a list of all families in the family tree (see Fig. {{#var:chapter}}.{{#var:figure}}).

From this view, you may use buttons on the toolbar to:
* {{icon|stock_add}} {{man button|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Add a new Family]]}}
* {{icon|stock_edit}} {{man button|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Edit the selected family]]}}
* {{icon|stock_remove}} {{man button|Delete the selected family}}
* [[File:Gramps_Merge48x48_win.png|16px]] {{man button|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Families|Merge the selected families]]}} from the list ( you can only select and merge two(2) families at a time. )
* [[File:16x16-gramps-tag.png]] {{man button|Tag the selected rows}}

The default display lists the <code>ID, Father, Mother, Relationship and Marriage Date</code>. If you configure the active view you can, hide existing columns, show additional columns like <code>Private, Tags, Last Changed</code>, or rearrange the column order.

{{man note|Children cannot be displayed on the screen in this list view.|The children can be viewed in the associated ''Children'' tab in the bottombar or sidebar and [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Children|Family Editor's ''Children'']] tab.}}

==== Families Category context menu ====
Additional options are available by selecting a family from the list and using the context/pop-up menu shown by right-clicking:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Make Mother Active Person}}
*{{man menu|Make Father Active Person}}
<hr>
*{{man menu|Quick View}}
**{{man menu|All Family Events}}
**{{man menu|Family References}}
<hr>

See also
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Families_Category|Using the Families Category]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_relationships|Editing information about relationships]]
{{-}}

====⚙ Families Category Configuration Options====
[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The following two tabs are shown:
* Columns
* CSV Dialect
{{-}}
=====Columns=====
[[File:FamiliesCategory-FamiliesView-Configure-dialog-Columns-defaults-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Families Category - Families View - Configure the active view - dialog - showing Defaults on Columns tab]]

As with most list style Views, the layout configuration tab allows customization of which columns will be displayed and their order of display.

The displayable columns include:

The available columns for display are:
* {{checkbox|1}} {{man label|ID}}
* {{checkbox|1}} {{man label|Father}}
* {{checkbox|1}} {{man label|Mother}}
* {{checkbox|1}} {{man label|Relationship}}
* {{checkbox|1}} {{man label|Marriage Date}}
* {{checkbox|0}} {{man label|Private}}
* {{checkbox|0}} {{man label|Tags}}
* {{checkbox|0}} {{man label|Last Changed}}
{{-}}
=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].

{{-}}

===Families Category Bottombar tabs===
The {{man label|Families Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs as default.
{{-}}
====Gallery====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Events====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Events|Events]] Gramplet
{{-}}
====Children====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Children|Children]] Gramplet
{{-}}
====Citations====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====Attributes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]] Gramplet
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}

===Families Category Sidebar tabs===

The {{man label|Families Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs as default.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Charts Category ==
[[File:ChartsCategory-Toolbar-partial-overview-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Toolbar Chart View Options]]

[[File:gramps.png|left]]
The {{man label|Charts}} Category shows several graphical representations of the ancestry or descendants of the active person.

By default Gramps shows the {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#Pedigree_View|Pedigree]]}} View. With the {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#Fan_Chart_View|Fan Chart]]}} View and {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#Descendant_Fan_View|Descendant Fan]]}} chart View and {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#2-Way_Fan_View|2-Way Fan]]}} chart view being selectable from the toolbar or menu via {{man menu|View > '''Name of Chart View'''}}

{{man tip|Want more Chart Views?|A small selection of basic Chart views are bundled with Gramps. Additional charts can be installed with the [[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Addon_Manager|Addon Manager]]. See [[Third-party Addons]]}}
=== Pedigree View===

[[File:ChartsCategory-Pedigree-view1-horizontal-right-standard-5gen-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pedigree" view (Default) Tree direction: Horizontal (→) (horizontal to right) with person tooltip shown]]

The {{man label|Pedigree}} View shows up to nine generations in the form of a chart, depending on the size of the window you may need to use the scroll bars to see parts of the chart.

Each person is indicated by a box labeled with his or her name, birth information (indicated by an asterisk <tt>*</tt> sign), death information (indicated by a plus <tt>+</tt> sign), a black stripe across the top left corner of the box is shown if the person is deceased (or determined by Gramps to be no longer alive) and optionally the primary image will be displayed if available.

If you hover the mouse cursor over any of person boxes or marriage nodes you will be shown a tooltip.

Two lines branch from each person box. The top line leads to the person's father and the bottom line leads to the mother. Solid lines represent the biological birth type relationship, while dashed lines represent non-birth relationships such as adoption, step-parenthood, guardianship, etc.

The left arrow {{man button|< Jump to child...}} button beside the Active Person is a only selectable if the Active Person has children, clicking this button expands to show a list of the Active Person's children. Selecting one of the children makes that child the Active Person for the chart.

The appearance of the children's names in the menu differentiates the dead ends of the tree from the continuing branches.

Children who have children themselves appear in the menu in the boldface and italic type, while children without children (dead ends) appear in a regular font. If the Active Person has only one child, no menu will be displayed (since there is only one choice) and the child will become the Active Person when the arrow button is clicked.

The right-hand side of the window shows two right arrow buttons. When the top button {{man button|Jump to father >}} is clicked, the Father of the Active Person becomes the Active Person. When the bottom button {{man button|Jump to mother >}} is clicked, the Mother of the Active Person becomes the Active Person.

{{-}}
==== Pedigree View Context menus====
===== Pedigree View Person Context menu=====
[[File:ChartsCategory-PedigreeView-PersonContextMenu-showing-Children-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree View "Person context menu" showing Children]]

Right-clicking on any person's box in the Pedigree View will bring up the Person "context menu".

Among other useful items, the context menu has sub-menus listing {{man menu|Spouses}} , {{man menu|Siblings}} , {{man menu|Children}} and {{man menu|Parents}}

In addition, there is a submenu for {{man menu|Related}} people to that person. These are people who share an Event with the Person.

"Greyed-out" sub-menus indicate the absence of the data in the appropriate category. Similar to the children menu above, Childrens' and Parents' menus distinguish continuing lines from dead ends.

The {{man menu|[[Gramps_6.0_Wiki_Manual_-_Categories#Pedigree_View|About Pedigree View]]}} button will bring you to this page for help.

Context menu entries:
<hr>
* {{man menu|[Persons Name]}}
* {{man menu|Edit}}
* {{man menu|Copy}}
* {{man menu|Spouses}} >
* {{man menu|Siblings}} >
* {{man menu|Children}} >
* {{man menu|Parents}} >
* {{man menu|Related}} >
<hr>
* {{man menu|Previous}}
* {{man menu|Next}}
* {{man menu|Home}}
* {{man menu|Set Home Person}}
<hr>
* {{man menu|Mouse scroll direction}} >
** {{man menu|Top <-> Bottom}}
** {{man menu|Left <-> Right}}
<hr>
* {{man menu|[[Gramps_6.0_Wiki_Manual_-_Categories#Pedigree_View|About Pedigree View]]}}
<hr>

{{man note|Additional information on the {{man menu|Related}} submenu|See the Discourse community support forum topic "[https://gramps.discourse.group/t/who-are-the-related-in-charts-context-menus/6498 Who are the "Related" in Charts context menus]".}}

===== Pedigree View Blank Context menu=====
[[File:ChartsCategory-PedigreeView-BlankAreaContextMenu-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree View "Blank (area) context menu" overview]]

Right-clicking on an empty area of the Pedigree view will bring up the same Person "context menu" but with limited choices.
{{-}}


====⚙ Configuration Options====

[[File:ChartsCategory-PedigreeView-ConfigureCharts-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Pedigree View - Configure the active view - dialog - showing Defaults on Layout tab]]
[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

=====Layout=====
The {{man label|Pedigree}} View {{man label|Layout}} tab has the following option available:
* {{checkbox|1}} {{man label|Show images}} (checked by default)
* {{checkbox|1}} {{man label|Show marriage data}} (checked by default)
* {{checkbox|1}} {{man label|Show unknown people}} (checked by default)
* {{checkbox|0}} {{man label|Show tags}} (unchecked by default)
* {{man label|Tree style:}}
** '''Standard'''(default)
** Compact
** Expanded
* {{man label|Tree direction:}}
** Vertical (↑) [[File:ChartsCategory-pedigreeview2-vertical-up-standard-5gen-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 1 - Tree direction: Vertical (↑) (vertical and up)]] (See Fig. {{#var:chapter}}.{{#expr:{{#var:figure}}}})
** Vertical (↓) [[File:ChartsCategory-pedigreeview2-vertical-down-standard-5gen-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 2 - Tree direction: Vertical (↓) (vertical and down)]] (See Fig. {{#var:chapter}}.{{#expr:{{#var:figure}}}})
** '''Horizontal (→)'''(default)  [[File:ChartsCategory-Pedigree-view1-horizontal-right-standard-5gen-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pedigree" view (Default) Tree direction: Horizontal (→) (horizontal to right) with person tooltip shown]] (See Fig. {{#var:chapter}}.{{#expr:{{#var:figure}}}})
** Horizontal (←) [[File:ChartsCategory-pedigreeview2-horizontal-left-standard-5gen-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 4 - Tree direction: Horizontal (←) (horizontal to left)]] (See Fig. {{#var:chapter}}.{{#expr:{{#var:figure}}}})
* {{man label|Tree size:}} slider range 2 to 9 generations. Set to <code>5</code>(by default)

{{-}}

=== Fan Chart View ===

[[File:ChartsCategory-fanchartview-halfcircle-7gen-Royals-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Fan Chart View - half circle (Royals92.ged)]]

The {{man label|Fan Chart}} view shows the active persons ancestry as a pie chart. Clicking on a name in the chart will double the section of the pie allocated to that person by collapsing the spouse section. A second click brings the chart back to the original form. Right-click brings up a context menu like in the pedigree view, allowing to navigate to other people.

This view enables to see large ancestries in a more compact manner, and to see very quickly which parts of an ancestry need further research.

You can rotate the view by click and drag outside the fan chart. You can move the view by click and drag inside the inner (white) region.

* The view can be a circle, a halfcircle or a quadrant of a circle. The latter are always attached to the bottom or side of the view
* Children of the center person are shown within the ring at the center
* Drag and drop people to the center to change the active person
* Color options
** Colors of the boxes based on the age of the people
** Colors of the boxes depending on the time period the person lived in
** White, classic, gender based, and user defined colors
* Filtering: use the person filter in the sidebar to quickly obtain insight in the people shown. For example: which people have birth events, who has the attribute ''blue eyes'', ... . Filtered results have bold font, the ones that don’t satisfy the filter are shown transparent
* Show up to 11 generations in the view.
* Print the view from the toolbar. The view as you see it (after rotating, expanding, changing color) can via the {{man button|Print...}} button. The view can be printed or use the Print to File option to save in any of the following formats: SVG (which can be edit further in tools like Inkscape or viewed in browsers like Firefox), PostScript (.ps) or PDF.
* The font used can be selected and automatically adjust to fit within the boxes. On a darker background, the font is white, and vice versa.
{{-}}
=====Fan Chart View context menu=====
{{stub}}
Context menu entries:
<hr>
* {{man menu|[Persons Name]}}
* {{man menu|Edit}}
* {{man menu|Copy}}
* {{man menu|Spouses}} >
* {{man menu|Siblings}} >
* {{man menu|Children}} >
* {{man menu|Parents}} >
* {{man menu|Related}} >
* {{man menu|Add}} >
<hr>

{{-}}


====⚙ Configuration Options====

[[File:ChartsCategory-FanChartView-ConfigureCharts-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Fan Chart View - Configure the active view - dialog - showing Defaults Defaults on Layout tab]]
[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

=====Layout=====
* {{man label|Max generations:}} ''9'' (default)
* {{man label|Text Font:}} ''Sans'' (default)
* {{man label|Background:}}
** Gender colors
** '''Generation based gradient''' (default)
** Age (0-100) based gradient
** Single main (filter) color
** Time period based gradient
** White
** Color scheme classic report
** Color scheme classic view
* {{man label|Start gradient/Main color:}} ''#ef2929'' (default)
* {{man label|End gradient/2nd color:}} ''#3d37e9'' (default)
* {{man label|Fan chart type:}}
** '''Full Circle''' (default)
** Half Circle
** Quadrant
* {{checkbox|1}} {{man label|Show names on two lines}}
* {{checkbox|1}} {{man label|Flip name on the left of the fan}}
* {{checkbox|1}} {{man label|Show children ring}}
* {{checkbox|0}} {{man label|Show gramps id}} 

====See also====
{{fan_charts}}
{{-}}

=== Descendant Fan View ===
[[File:ChartsCategory-DescendantFanChart-fullcircle-9gen-default-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Descendant Fan Chart View - full circle - showing context menu]]
The {{man label|Descendant Fan Chart}} view interactively displays the active person's descendants in a pie chart format. The Descendant Fan provides a comprehensive and visually appealing way to explore and analyze an individual's descendants within your family tree.

Clicking on a name in the chart collapses the sibling sections of the pie chart, while a second click reverts the chart to its original form. Right-clicking brings up a context menu similar to the pedigree view, allowing navigation to other individuals. The center Active Person's parents are shown within the innermost ring

This view enables users to visualize large descendant trees more compactly and quickly identify areas that require further research.

Key Features:
* Tooltips appear (with the person's Name, birth and death information) after a slight delay when indicating a Fan segment
* Drag and drop individuals to the center to change the active person (or [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Navigate the Active Person]] using the standard methods)
* Clicking on a descendant name in the chart collapses (or expands) the sibling sections
* Rotate the view by clicking and dragging outside the fan chart or inside the inner (white) region
* Drag the center black dot to move the center focus in the main view area
* Move the center focus horizontally by dragging the bottom scrollbar.
* Move the center focus vertically by dragging the right hand scrollbar or scrolling the mouse wheel.
* Surnames appear in bold font
* Display up to 16 generations
* Adjustable font selection with automatic sizing to fit within boxes


The Filter gramplet, configuration options and Dark Variants (of the [[Addon:ThemePreferences|Themes addon]] for Preferences) can be used to adjust the way data is rendered.

Use the person filter in the sidebar for quick insights (e.g., individuals with birth events, specific attributes). Filtered results are in full saturation color while the non-matching entry colors are semi-transparent.

====Descendant Fan View context menu====
Right-clicking brings up a context menu similar to the pedigree view, allowing navigation to other individuals.

==== Printing ====

Use the {{man button|Print...}} button on the views toolbar, output will include any rotations, expansions, or color changes. Use the Print to File option to save in various formats:
* SVG (editable in tools like Inkscape or viewable in browsers)
* PostScript (.ps)
* PDF
{{-}}


====⚙ Configuration Options====

[[File:ChartsCategory-DescendantFanChartView-ConfigureCharts-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Descendant Fan Chart View - Configure the active view - dialog - showing Defaults on Layout tab]]
[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

=====Layout=====
* {{man label|Max generations:}} ''9'' (default)
* {{man label|Text Font:}} ''Sans'' (default)
* {{man label|Background:}}
** Gender colors
** '''Generation based gradient''' (default)
** Age (0-100) based gradient
** Single main (filter) color
** Time period based gradient
** White
** Color scheme classic report
** Color scheme classic view
* {{man label|Start gradient/Main color:}} ''#ef2929'' (default)
* {{man label|End gradient/2nd color:}} ''#3d37e9'' (default)
* {{man label|Fan chart type:}}
** '''Full Circle''' (default)
** Half Circle
** Quadrant
* {{man label|Fan chart distributions:}}
** Homogeneous children distribution
** '''Size proportional to number of descendants''' (default)
* {{checkbox|1}} {{man label|Show names on two lines}}
* {{checkbox|1}} {{man label|Flip name on the left of the fan}}
* {{checkbox|0}} {{man label|Show gramps id}}

====See also====
* [https://gramps-project.org/blog/2012/09/descendant-fanchart/ Descendant Fan View] (blog announcement)
* {{fan_charts}}

{{-}}

=== 2-Way Fan View ===

[[File:ChartsCategory-2-WayFan-fullcircle-ances4gen-descen4gen-example-defaults-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 2-Way Fan Chart View - 4 Generations of Ancestors (Top) / 4 Generations of Descendants (bottom) showing context menu]]

The {{man label|2-Way Fan Chart}} View interactively displays the active person's ancestors and descendants in a pie chart format. The Descendant Fan provides a comprehensive and visually appealing way to explore and analyze an individual's descendants within your family tree.

Clicking on a ancestor name in the chart collapses their spouse section of the pie, while a second click reverts the chart to its original form. Clicking on a descendant name in the chart collapses that person's sibling sections, while a second click reverts the chart to its original form. Right-clicking brings up a context menu similar to the pedigree view, allowing navigation to other individuals. The center Active Person's parents are shown within the innermost ring

This view enables users to visualize large descendant trees more compactly and quickly identify areas that require further research.

Key Features:
* Tooltips appear (with the person's Name, birth and death information) after a slight delay when indicating a Fan segment
* Drag and drop individuals to the center to change the active person (or [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Navigate the Active Person]] using the standard methods)
* Clicking on a descendant name in the chart collapses (or expands) the sibling sections
* Rotate the view by clicking and dragging outside the fan chart or inside the inner (white) region
* Drag the center black dot to move the center focus in the main view area
* Move the center focus horizontally by dragging the bottom scrollbar.
* Move the center focus vertically by dragging the right hand scrollbar or scrolling the mouse wheel.
* Surnames appear in bold font
* Configurable to display up to 11 generations of ancestors
* Configurable to display up to 11 generations of descendants
* Adjustable font selection with automatic sizing to fit within boxes


The Filter gramplet, configuration options and Dark Variants (of the Themes addon for Preferences) can be used to adjust the way data is rendered.

Use the person filter in the sidebar for quick insights (e.g., individuals with birth events, specific attributes). Filtered results are in full saturation color while the non-matching entry colors are semi-transparent.

==== Printing ====

Print the view from the toolbar, including any rotations, expansions, or color changes. Use the Print to File option to save in various formats:
* SVG (editable in tools like Inkscape or viewable in browsers)
* PostScript (.ps)
* PDF
{{-}}
===== 2-Way Fan View Person Context menu=====
{{stub}}
{{-}}

====⚙ Configuration Options====

[[File:ChartsCategory-2-WayFanChartView-ConfigureCharts-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - 2-Way Fan Chart View - Configure the active view - dialog - showing Defaults on Layout tab]]
[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

=====Layout=====
* {{man label|Max ancestor generations:}} ''4'' (default)
* {{man label|Max descendant generations:}} ''4'' (default)
* {{man label|Text Font:}} ''Sans'' (default)
* {{man label|Background:}}
** Gender colors
** '''Generation based gradient''' (default)
** Age (0-100) based gradient
** Single main (filter) color
** Time period based gradient
** White
** Color scheme classic report
** Color scheme classic view
* {{checkbox|1}} {{man label|Add global background colored gradient}}
* {{man label|Start gradient/Main color:}} ''#ef2929'' (default)
* {{man label|End gradient/2nd color:}} ''#3d37e9'' (default)
* {{man label|Color for duplicates:}} ''#888a85'' (default)
* {{man label|Fan chart distribution:}}
** Homogeneous children distribution
** '''Size proportional to number of descendants''' (default)
* {{checkbox|1}} {{man label|Show names on two lines}}
* {{checkbox|1}} {{man label|Flip name on the left of the fan}}
* {{checkbox|0}} {{man label|Show gramps id}}

====See also====
* [https://github.com/gramps-project/gramps/pull/222 Feature: Gep-030 FanChart2Way]
{{fan_charts}}
{{-}}

===Charts Category Bottombar tabs===

The {{man label|Charts Category}} by default displays no Gramplets in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tab. You may add them as required.
{{-}}
===Charts Category Sidebar tabs===

The {{man label|Charts Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
The Filter is shown by default in all Chart views except ''Pedigree View''

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Events Category ==
[[File:gramps-event.png|left]] The {{man label|Events Category}} shows the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Events_View|Events View]]}} that lists the all the events recorded in the Family Tree.

When first created, an Event is expected to be about an incident (or fact) for a specific (Primary) Person or Family. The details of the Event record the categorization of the Event, the date (which can be exact date or a span of dates) and Place where it occurred, and often includes a brief description when the categorization is broad. (A "Birth" category is often specific enough to not require a description. But an Occupation "Event" is almost meaningless without a description containing the specific type of vocation.)

Events can be shared between multiple people and multiple families. Each person or family may have had a different Role in shared events.

See also:
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Editing information about events]]
{{-}}
===Events View===
[[File:EventsCategory-EventsListView-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events Category - Events (List) View - example with context menu]]

Displays a list of Events, that from the toolbar you can add, edit, delete, merge and tag.

* {{man button|Add...}} - {{man tooltip|Add a new event}} using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Event_dialog|New Event dialog]]}}
* {{man button|Edit...}} - {{man tooltip|Edit the selected event}} in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Event_dialog|New Event dialog]]}}
* {{man button|Delete...}} - {{man tooltip|Delete the selected event}}
* {{man button|Merge...}} - {{man tooltip|Merge the selected events}}
* {{man button|Tag}} - {{man tooltip|Tag the selected rows}}
** {{man menu|New Tag...}} -
** {{man menu|Organize Tags...}} -

From the {{man label|Events View}} list the following default columns are shown: <code>Description</code> , <code>ID</code>, <code>Type</code> , <code>Date</code> and <code>Place</code> of the event. The {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Columns_2|Columns Editor]]}} dialog can be used to add, remove and rearrange the displayed columns. This can be accessed from the {{man button|[[Gramps_6.0_Wiki_Manual_-_Categories#.E2.9A.99_Events_Category_Configuration_Options|Configure View...]]}} button on the toolbar.

The list of Events can be sorted in the usual manner, by clicking on the column heading. Clicking once sorts in ascending order, clicking again sorts in descending order.

You can [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export the view]] to a '''CSV''' file (default) or '''OpenDocument Spreadsheet''' (ODS).

{{man warn|Use meaningful event descriptions|Because events can be shared, you should take the extra time to give each event a unique and meaningful description. This will help you find the correct event when you share events.}}

====Events View Context menu====
Additional options are available by selecting an event from the list and using the context/pop-up menu shown by right-clicking:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
**{{man menu|Event References}}
**{{man menu|On This Day}}
<hr>

====⚙ Events Category Configuration Options====
[[File:EventsCategory-EventsView-Configure-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events Category - Events list View - Configure the active view - dialog - showing Defaults on Column tab]]
[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].
=====Columns=====
As with most list style Views, the layout configuration tab allows customization of which columns will be displayed and their order of display.

The displayable columns include:
* {{checkbox|1}} {{man label|Type }}
* {{checkbox|1}} {{man label|Main Participants}}
* {{checkbox|1}} {{man label|Date}}
* {{checkbox|1}} {{man label|Place}}
* {{checkbox|1}} {{man label|Description}}
* {{checkbox|1}} {{man label|ID}}
* {{checkbox|0}} {{man label|Private}}
* {{checkbox|0}} {{man label|Tags}}
* {{checkbox|0}} {{man label|Last Changed}}

Drag and drop columns to change their order in the Event list. The view will not be changed unless the {{man button|Apply}} button is clicked. Clicking {{man button|Close}} without first clicking {{man button|Apply}} will abandon the changes.

{{-}}
=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].

{{-}}

===Events Category Bottombar tabs===

The {{man label|Events Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Gallery====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Citations====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====Attributes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]] Gramplet
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Events Category Sidebar tabs===

The {{man label|Events Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Places Category ==
[[File:PlacesCategory-Toolbar-partial-overview-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - Toolbar Place View Options]]

[[File:gramps-place.png|left]]
The {{man label|Places Category}} holds two views that show [[Gramps_Glossary#place|places]]: either as grouped (hierarchically in a tree) or ungrouped (in a simple flat list). Each view lists the geographical places in which the events of the database took place. These could be places of birth, death, and marriages of people, as well as their home, employment, education addresses, or any other conceivable reference to the geographical location.
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Place_Tree_View|Place Tree]]}} View - places grouped (hierarchically in a tree)
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Places_List_View|Places]]}} List View - places ungrouped (in a simple flat list)

The Places View lists the places' <code>Name</code>, <code>Title</code>, <code>ID</code>, <code>Type</code>, <code>Code</code>, <code>Latitude</code>, <code>Longitude</code>, <code>Private</code>, <code>Tags</code>, and <code>Last Changed</code>. All of these columns can be used for sorting by clicking on a column heading.
{{man tip|When providing a maps coordinates, latitude always precedes longitude|Latitude (north or south) parallels and longitude (east or west) meridians are divided in degrees (°), minutes (’) and seconds (”). There are 60 minutes to a degree and 60 seconds to a minute.
 
See: [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]] See: [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Coordinates format:]] in preferences Display as this option controls the display of Coordinates.
}}


===Place Tree View===
[[File:PlacesCategory-PlaceTreeView-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Tree View - example with context menu]]

The Place Tree View groups the list of places in a hierarchy: country, county, ... etc

You can expand the listing using the {{man button|▶}} arrows.

{{-}}
====Place Tree View context menu====
All the nodes of the tree view mode can be simultaneously collapsed or expanded from the context/pop-up menu shown by selecting a place and right-clicking:
<hr>
*{{man menu|Expand this Entire Group}}
*{{man menu|Collapse this Entire Group}}
*{{man menu|Expand all Nodes}}
*{{man menu|Collapse all Nodes}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
**{{man menu|Place References}}
<hr>
*{{man menu|Look up with Map Service}}
<hr>
{{-}}
====⚙ Configuration Options====
[[File:PlacesCategory-PlaceTreeView-Configure-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Places Category View - Places Tree View - Columns tab]]
[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].
=====Columns=====
As with most list style Views, the layout configuration tab allows customization of which columns will be displayed and their order of display.

The available columns for display are:
* {{checkbox|1}} {{man label|Name}} (must be first column in the '''Place Tree''' view)
* ''Title''
* '''ID''' (default)
* '''Type''' (default)
* '''Code''' (default)
* ''Latitude''
* ''Longitude''
* ''Private''
* ''Tags''
* ''Last Changed''

Once the View columns are shown, clicking once on the column header sorts in ascending order, clicking again sorts in descending order.

These Configuration options and the current [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export View...]]}}
{{-}}

=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].
{{-}}


===Places List View===

[[File:PlacesCategory-PlaceView-list-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - Place View (List) - example with context menu]]

The Place(s) View (List) shows all the places in one long list.

The Places View lists the places' <code>Name</code>, <code>Title</code>, <code>ID</code>, <code>Type</code>, <code>Code</code>, <code>Latitude</code>, <code>Longitude</code>, <code>Private</code>, <code>Tags</code>, and <code>Last Changed</code>. All of these columns can be used for sorting by clicking on a column heading.

{{stub}}
{{-}}
====Places List View context menu====
Additional options are available by selecting a place from the list and using the context/pop-up menu shown by right-clicking:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
**{{man menu|Place References}}
<hr>
*{{man menu|Look up with Map Service}}
{{-}}

===Places Category Bottombar tabs===

The {{man label|Places Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Details====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Details|Details]] Gramplet
{{-}}
====Location====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Locations|Locations]] Gramplet
{{-}}

====Gallery====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Events====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Events|Events]] Gramplet
{{-}}
====Citations====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Places Category Sidebar tabs===

The {{man label|Places Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

===Map Service===
{{man warn|The Map Service feature requires a set of coordinates (Longitude and Latitude) for each of the Places|If the enclosed Place record does not yet have coordinates information, then Gramps will not request a map service marker for the Place associated with that person or event.
 
See: [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]] See: [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Coordinates format:]] in preferences Display as this option controls the display of Coordinates.
}}

[[File:PlacesCategory-AttemptToSeeSelectedLocation-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - "Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ..." button - example]]

If a place has been highlighted, you may display the place in a web browser by selecting the {{man button|Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ...}} button or using the right-click context menu to {{man menu|Look up with Map Service}}.

Your default web browser should open, attempting to use either the recorded coordinates (longitude and latitude) or the place name to display the location using the Maps provider web site. Different map services might have different requirements for the location description.

{{-}}
[[File:PlacesCategory-MapServices-list-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - "Select a Map Service" button - showing list of options with OpenStreeMap (default)]]

From the {{man button|Select a Map Service}} drop down list you can choose the map service you want to use from the following three options:
* '''{{man label|OpenStreetMap}}'''(default) - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.
* ''{{man label|EniroMaps}}'' - Valid for places within Sweden and Denmark, only if longitude and latitude are available, otherwise uses city and country, or uses description of the place.
* ''{{man label|GoogleMaps}}'' - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.

{{-}}
See also:
* [[Addon:MapService-GoogleEarth|Map Services - Google Earth]] - addon allows you to use Google Earth.

== Geography Category ==

{{man tip|Is your {{icon|geog}} Geography icon missing?|The Geography category is only shown in the Navigator sidebar when the <code>[[Gramps_6.0_Wiki_Manual_-_Categories#Prerequisites_to_see_the_geography_view|OsmGpsMap]]</code> prerequisite widget has been installed.}}

[[File:GeographyCategory-GeoPerson-navigator-expander-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Geography Category - partial overview of navigator - expander entries for all GeoPerson View Options]]

[[File:Gramps-geo.png|left]]The {{man label|Geography Category}} shows place event data visually on a map. It contains many Geographic Views, which allows you to see the people and their events placed on a map via an internet map provider (OpenStreetMap, Google maps ...).

The following core Geography Views are available:
* '''GeoPerson''' - {{man label|[[#All_known_places_for_one_Person|All known places for one Person]]}} - Show all known places connected to the active person.
* '''GeoFamily''' - {{man label|[[#All_known_places_for_one_Family|All known places for one Family]]}} - Show all places connected to the active family.
* '''GeoMoves''' - {{man label|[[#Every_residence_or_move_for_a_person_and_any_descendants|Every residence or move for a person and any descendants]]}} - Show all residences, displacements or moves for one person and their descendants.
* '''GeoFamClose''' Show {{man label|[[#Have_these_two_families_been_able_to_meet_.3F|Have these two families been able to meet?]]}} - if two families have been able to meet?
* '''GeoClose''' - {{man label|[[#Have_they_been_able_to_meet_.3F|Have they been able to meet?]]}} - Show if two people have been able to meet?
* '''GeoPlaces''' - {{man label|[[#All_known_places|All known Places]]}} - Show all known Places in your family tree
* '''GeoEvents''' - {{man label|[[#All_places_related_to_Events|All places related to Events]]}} - Show all places connected to a filtered selection of events with a {{man menu|[[#show_all _events|Show all event places]]}} option.

These views are accessible via the buttons on the toolbar, the view menu and if selected as Navigator(Expander) entries. To filter on places or events, activate the filter sidebar via the menu {{man menu|View->Filter Sidebar}}

See also:
* Additional [[6.0_Addons#Addon_List|third-party addon]] Geography views are available:
** '''GeoAncestor''' [[Addon:AncestorsMap|Ancestors map]] view addon - A Geography category View Mode which maps Event Places related to the Ancestors of the Home Person.
** '''PlaceCoordinateGeoView''' [[Addon:PlaceCoordinatesGramplet#Additional_geography_view_with_a_context_menu|Place Coordinate Gramplet view]] addon - additional Geography category View Mode packaged with the Place and Coordinates Gramplet simplifies setting coordinates interactively.

[[File:GeographyCategory-GeoPlaces-view-AllKnownPlaces-openstreemap-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known Places" GeoPlaces View - Geography Category - example using Openstreetmap]]

=== Prerequisites for usage ===
To have these Geographic views work correctly, you need:

* To have events related to places.
* These places must have coordinates : latitude and longitude.
* If a place has no coordinates, it will never appear on the map.
* If you have an active internet connection, for all moves on the map, all zoom ... all tile maps are saved.
** When you are without an internet connection, all tile maps are cached from the previous session and can be used.
** So, the map can be used without an internet connection and all already visited places can be shown again.
** The only thing to do is for each place or area you want to use without an internet connection is to select them, zoom into these places. You'll be able to use them again without connection.

====Possible problems====
{{man tip|Is your {{icon|geog}} Geography icon missing?|The Geography category is only shown in the Navigator sidebar when the <code>[[Gramps_6.0_Wiki_Manual_-_Categories#Prerequisites_to_see_the_geography_view|OsmGpsMap]]</code> prerequisite widget has been installed.}}

*No {{icon|geog}} Geography category icon in the Navigator sidebar : do you have the prerequisite <code>osmgpsmap</code> installed ? (''<code>gramps -v</code>'' from the command line may help you)
*No tiles : do you have an internet connection active ?
*No tiles for one provider : if other providers are OK, file a bug
*Missing tiles : you have no internet connection and it's the first time you try to show the current place.
*Missing tiles : this can be the same as no tiles for one provider if they modify the access rules (i.e user-agent)
*Other : [[Using_the_bug_tracker|Report a bug]]

{{man warn|Map Features can ''rapidly'' increase Storage Usage|
Using the map features in the {{man label|Geography Category}} can consume a significant amount of storage space. Each map service viewed saves detailed images (called "tiles") to the device cache. Zooming in or switching between different map types (such as streets, satellite, or terrain) causes the amount of stored data to grow quickly. This can potentially use many [https://wikipedia.org/wiki/Gigabyte Gigabytes] of storage, especially with frequent use.}}

===Prerequisites to see the geography view===
For Gramps 6.x, you need to install [http://nzjrs.github.io/osm-gps-map/ osmgpsmap] version 1.0 and above and the associated gir ('''G'''Object '''I'''ntrospection '''R'''epository) package.

For example on ubuntu, you must have:
<code>gir1.2-osmgpsmap-1.0</code> and <code>libosmgpsmap-1.0-0</code>

=== The different views ===
[[File:GeographyCategory-GeoPerson-navigator-expander-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Geography Category - partial overview of navigator - expander entries for all GeoPerson View Options]]

As listed above the following core [[#Geography_Category|Geography Views]] are available:
{{-}}
==== All known places for one Person ====
[[File:GeographyCategory-AllKnownPlacesForOnePerson-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known places for one Person" GeoPerson View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view show all places visited by one person during that persons life.

This view is not connected to filters. It only depend on the active person and the history.

If you want to use the animate functionality, click on the [[Gramps_6.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse. You'll get a context menu popup.
From the context menu popup, you can select {{man menu|Animate}} to see the life way of the current person:

If the active person has several related events, you can see a virtual move between those markers. The move is related to years or distance and can be modified in the person map preferences. If the distance between to markers is greater than a value in tenth of degree, we show moves depending on distance instead of years. In these case, the number of steps between these two markers can be modified. You can modify the animation speed between steps. The moves start at the first event year until the last event year.
{{-}}
[[File:GeographyCategory-AllKnownPlacesForOnePerson-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The animation parameters" tab for the "All known places for one Person" GeoPerson View - Configure the active view]]

=====Configure the active view=====
======The animation parameters tab======
{{man label|The animation parameters}} tab
See the configuration menu tab for the following options you can change:
*A slider to set the {{man label|Animation speed in milliseconds(big value means slower:)}} (default: ''100'')
*A slider to set the {{man label|How many steps between two markers when we are on large move?:}} (default: ''20'')
*A slider to set the {{man label|The minimum latitude/longitude to select large move. The value is in tenth of degree.}} (default: ''5'')
{{-}}

==== All known places for one Family ====

[[File:GeographyCategory-AllKnownPlacesForOneFamily-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known places for one Family" GeoFamily View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view show all places visited by all family members during their lives.

This view is not connected to filters. It only depend on the active family and the history.
{{-}}
=====Configure the active view=====
The configuration menu tab shows the {{man label|Specific parameters}} tab for this view has which has no additional options.
{{-}}

==== Every residence or move for a person and any descendants ====

[[File:GeographyCategory-EveryResidenceOrMoveForAPersonAndAnyDescendants-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Every residence or move for a person and any descendants" GeoMoves View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view is used to show all the places in a person and their descendant's lifetime.

They are displayed by generation.
You can change the delay between the generation display in the view configuration.

This view is not connected to filters. It only depends on the [[Gramps_Glossary#active_person|Active Person]] and their history.
{{-}}
[[File:GeographyCategory-EveryResidenceOrMoveForAPersonAndAnyDescendants-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The parameters for moves" tab for the "Every residence or move for a person and any descendants" GeoMoves View - Configure the active view]]

=====Configure the active view=====
======The parameters for moves tab======
{{man label|The parameters for moves}} tab
See the configuration menu tab for the following options you can change:
*A slider to set {{man label|The maximum number of generations.}} to show. (default: ''20'')
*A slider to set the {{man label|Time in milliseconds between drawing two generations.}} (default: ''500'')
{{-}}

==== Have these two families been able to meet? ====

[[File:GeographyCategory-HaveTheseTwoFamiliesBeenAbleToMeet-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Have these two families been able to meet ?" GeoFamClose View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view is used to show if two families were able to meet during their life.

You must select one reference family :
* From the menu popup : Choose the reference family
* From the toolbar

When the reference family is active, you'll see all its member's life way.
For each known place with coordinates, you'll see a circle or an oval depending on the longitude.

The circle radius can be tuned in the configuration view.
This value is defined in tenth of degree.
{{-}}
[[File:GeographyCategory-HaveTheseTwoFamiliesBeenAbleToMeet-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The selection parameters" tab for the "Have these two families been able to meet ?" GeoFamClose View - Configure the active view]]

=====Configure the active view=====
======The selection parameters tab======
{{man label|The selection parameters}} tab
See the configuration menu tab for additional options.
{{-}}

==== Have they been able to meet? ====

[[File:GeographyCategory-HaveTheyBeenAbleToMeet-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Have they been able to meet ?" GeoClose View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view is used to show if two persons were able to meet during their life.

You must select one reference person :
#From the menu popup : Choose the reference person
#From the toolbar

When the reference person is active, you'll see its life way.
For each known place with coordinates, you'll see a circle or an oval depending on the longitude.

The circle radius can be tuned in the configuration view.
This value is defined in tenth of degree.

{{-}}
[[File:GeographyCategory-HaveTheyBeenAbleToMeet-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The selection parameters" tab for the "Have they been able to meet ?" GeoClose View - Configure the active view]]

=====Configure the active view=====
======The selection parameters tab======
{{man label|The selection parameters}} tab
See the configuration menu tab for additional options.
{{-}}

==== All known places ====

[[File:GeographyCategory-GeoPlaces-view-AllKnownPlaces-openstreemap-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known Places" GeoPlaces View - Geography Category - example using Openstreetmap - showing context menu]]

This view show all places with coordinates in the database.

For performances reason, by default, the view show only the place related to the places history or the filtered places.
One additional step is required to see all places, you need to select "{{man menu|show all places}}" from the context menu [[Gramps_6.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]]
{{-}}
[[File:GeographyCategory-AllKnownPlaces-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man label|The places marker color}} tab for the "All known Places" GeoPlaces View - Configure the active view]]

=====Configure the active view=====
======The places marker color tab======
{{man label|The places marker color}} tab
The configuration menu tab for has the following options:

The {{man label|All known Places}} view is the only Geography view that allows you to change the color used for the place type markers.

The colors are green for the following map renders:
* OpenStreetMap
* Maps for free
* Opencyclemap
* Public transport.

All other marker renders are red.

Click on the {{man button|Configure the active view}} button on the toolbar.

Then click on the {{man label|The places marker color}} tab. The default color for each Place Type is green "#008b00"

For each type of place, you can select and choose a color. Once the '''Pick a Color''' dialog appears, you can drag a color swatch from that dialog to the Configure's {{man label|The places marker color}} swatches. It is not necessary to click the {{man button|Close}} button for each Type then reopen the dialog.

See also:
* [[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]
* [[Gramps_6.0_Wiki_Manual_-_Categories#Can_we_change_the_place_marker.27s_color_.3F|Can we change the place marker's color?]]
{{-}}

==== All places related to Events ====
[[File:GeographyCategory-AllPlacesRelatedToEvents-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All places related to Events" GeoEvents View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

For performances reason, the default view initially shows only the places related to the events history or the filtered events.

This view can also be used to show all places related to events. However, it can take some time to show when the tree records many events and many places.


If you really want to see all events, you need to select "show all events" from the [[Gramps_6.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] contextual popup menu.
{{-}}
=====Configure the active view=====
{{man label|Specific parameters}} tab
The configuration menu tab shows the {{man label|Specific parameters}} tab for this view has which has no additional options.
{{-}}

===== All known places for one person with graphical information (KML files) =====

[[File:gramps-person-kml.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} One person with 3 KML files]]

If KML files are added as Media objects in the Gallery tab for the various records, the '''{{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#All_places_related_to_Events|All places related to Events]]}}''' Geography view will show one path or one surface for each KML file.

In the following example, you see 3 layered KML files rendered from different Gallery tabs referenced by this Person:
* a farm limits outline KML in the Birth Event.
* a path KML used to go to school in the Education Event.
* a parish (or municipality) limits outline KLM in the Place Gallery tab for the Baptism Event.

In the case of the Farm limits outline, the KLM was added to the Gallery tab of the Birth Event (rather than being applied to that of the re-useable [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'Farm' type Place]]) because acreage was bought and sold over the years. This outline represented the Farm size at the date of birth.

See [[Gramps_6.0_Wiki_Manual_-_Categories#Adding_places_from_KML_files|Adding places from KML files]]

{{man tip|What is a KML file?|KML ([https://wikipedia.org/wiki/Keyhole_Markup_Language Keyhole Markup Language]) files are used to enhance cartographic data in the Geography view. They contain location information that can be overlaid on map tiles, such as adding custom boundaries, routes, or other spatial data to the mapping service.}}

{{-}}

===Geography Category Bottombar tabs===

The {{man label|Geography Category}} by default displays no Gramplets in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tab. You may add them as required.

{{-}}

===Geography Category Sidebar tabs===

The {{man label|Geography Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.

{{-}}
====Filter====

The filter type may change depending on the view selected.

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

===Usage===
====Print or save the Map====
Printing or saving each of the [[Gramps_6.0_Wiki_Manual_-_Categories#Geography_Category|Geography Category]] views, can be done via the menu, toolbar or keyboard shortcut as follows:

* Menu {{man menu|Edit > Print...}}
* Toolbar button {{man button|Print or save the Map}}
* Keyboard shortcut {{Man key press|Shift|Ctrl|P}}

====⚙ Configuration Options====
You can control the layout by clicking the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button, choosing {{Man menu|View ➡ Configure...}} from the View menu, or pressing the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].
=====All views=====
[[File:ConfigureGeography-the-map-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Geography - "The map" tab]]

{{man label|The map}} tab contains options common to all Geography views:
* {{man label|Where to save the tiles of the tiles for offline mode.:}} (the default is <code>~/.cache/gramps/maps</code> on POSIX systems and <code>C:\Users\''<username>''\appdata\local\gramps\maps</code> on Windows). If required you can change the directory where map tile files are stored on your computer. {{man menu|Be careful, it can take several gigabytes, and if on a metered internet connection may result in a monetary cost to you.}}.
** {{man button|Select tile cache directory for offline mode}} button
* A slider for {{man label|Zoom used when centering:}} (default: ''12''). The zoom level for when we center the map or when we select one marker. Every time the Geographic View redraws the map, this zoomlevel will be used.
* A slider for {{man label|The maximum number of places to show:}} (default: ''5000''). Reducing this number for faster map drawing but with less life ways.
* [x] {{man label|Use keypad for shortcuts: Either we choose the + and - from the keypad if we select this or we use the characters from the keyboard.}} - checkbox selected by default.
{{-}}

=====Specific views=====
See the configuration specific options for each views section.

* [[Gramps_6.0_Wiki_Manual_-_Categories#Geography_Category|Geography Category]] - List of views.

====The mouse actions on the map====
The following mouse actions on the map are described for right handed people using the right hand mouse button otherwise use the left hand mouse button if you are a left handed person.

=====button 1 (left button)=====
You have two possible actions for the button 1 (left button) :
# The place marker selection.
# Validate the region selection 

=====button 2 ( middle button )=====
[[File:Geography_MiddleButton.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Zoom rectangle drawn with middle button]]
The only usage for the center button is to draw a rectangular region on the map via click and drag.
# when pressed : start the region selection
# when released, end the region selection.

A left-click (button 1) will zoom-in the Geography view to fit the rectangle.
{{-}}

=====button 3 ( right button )=====
Only one usage for this button.
* show the [[Gramps_6.0_Wiki_Manual_-_Categories#The_context_menu_popup|context menu popup]].

====The context menu popup====
[[File:GeographyCategoryView-context-menu-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Geography Category View - context menu - example]]

From this context menu, you have the following functions available for views:
<hr>
*{{man menu|Add cross hair}} - hide or show the cross hair. See: [[Gramps_6.0_Wiki_Manual_-_Categories#How_to_show.2Fremove_the_crosshair_.3F|How to show remove the crosshair ?]]
*{{man menu|Lock zoom and position}} - lock or unlock the zoom. See [[Gramps_6.0_Wiki_Manual_-_Categories#How_to_lock.2Funlock_the_map_.3F|How to lock unlock the map ?]]
*{{man menu|Add place}} - add a place at the mouse position. See [[Gramps_6.0_Wiki_Manual_-_Categories#Adding_or_Linking_to_a_place|Adding or Linking to a place]]
*{{man menu|Link place}} - link a place at the mouse position. See [[Gramps_6.0_Wiki_Manual_-_Categories#Adding_or_Linking_to_a_place|Adding or Linking to a place]]
*{{man menu|Add place from kml}} - add a place from KML (Keyhole Markup Language) file. See [[Gramps_6.0_Wiki_Manual_-_Categories#Adding_places_from_KML_files|Adding places from KML files]]
*{{man menu|Center here}} - center the map at the mouse position.
<hr>
Also when using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#All_known_places|All known places]]}} or {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#All_places_related_to_Events|All places related to Events]]}} views you will see additional context menu entries for respectively:
*{{man menu|Show all places}}
or
*{{man menu|Show all events}}
and for both views:
*{{man menu|Centering on Place}} > - center the map depending on a place from sub menu.
<hr>
*{{man menu|Animate}} - ... / Not available for the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#All_known_places|All known places]]}} or {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#All_places_related_to_Events|All places related to Events]]}} views
*{{man menu|'''Replace '(current map provider name)' by =>'''}} - change the default map (provider). See [[Gramps_6.0_Wiki_Manual_-_Categories#How_to_change_the_map_provider_.3F|How to change the map provider?]]
*{{man menu|Reload all visible tiles for '(current map provider name)'.}} - remove only the visible tiles already download from the current map provider.
*{{man menu|Clear the '(current map provider name)' tiles cache.}} - remove all tiles already download from the current map provider.
<hr>
{{-}}
{{stub}}

====How to zoom and move around the map ?====
Zoom in and out and moving around the map can be achieved via the following methods:

=====Zoom in and Zoom out the map=====
To zoom, you can use :
* The {{man button|+/-}} buttons shown at the top left of the map.
* The scroll button on the mouse.
* The {{man button|+}} or {{man button|-}} key on the keypad (default).

You can replace the numeric keypad by the alpha numeric keyboard in the configuration view.

=====Move around the map=====
To move around the map, you can :
* Click on the map, then drag it.
* Use the arrows.

====The mouse cursor over a place marker====

When the mouse cursor is positioned over one ''place marker'', the place name is display in the status bar.

====Click on a place marker====
We have two cases :
# events : For each event, we can edit this event or center the map on this place marker.
# places : For each place, we can edit this place or center the map on this place marker.

When centering the map, the zoom level used is defined in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#All_views|Geography preferences]]}}

We may have several place markers in the clicked area depending on the zoom.

In this case, We show for each marker all related events and/or places.

We obtain a mix between the two cases described above.

====Can we change the place marker's color ?====

Only the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#All_known_places|All known Places]]}} view supports changing the place type markers colors all the other views are hard coded in Gramps.
{{-}}

====Adding or Linking to a place====
For this context menu, (click on the [[Gramps_6.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse), select either {{man menu|Add place}} or {{man menu|Link place}} options.

When you add a place or try to link a place to the position of the ''mouse pointer'', you'll get a {{man label|Place selection in a region}} window dialog.

From the {{man label|Place selection in a region}} window dialog you'll see on the map a circle in which you may choose markers place names. You can adjust the circle size with the cursor. Depending on the diameter of this circle, a list is created. If the place has already some filled fields, you'll see these values in a green color row. If you agree, you double click on this row. if you don't agree, you can choose another row.

Another way to set latitude and longitude :
* Install the [[Addon:PlaceCleanupGramplet|Place Cleanup Gramplet]] addon via the [[6.0_Addons#Installing_Addons_in_Gramps|Addons manager]]. If you install this gramplet you can add latitude-longitude to all your places.

{{stub}}

====Adding places from KML files====

For this, click on the [[Gramps_6.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a context popup menu.

In this menu, you can select {{man menu|Add place from kml}} ('''KML''' - Keyhole Markup Language)

You will get the {{man label|Select a KML file used to add places}} file chooser dialog. Select the file you want to add.

If you have several places in the same KML file, you will get one place editor for each place. Be careful.

====How to change the map provider ?====
{{man warn|Some maps are not free|Please read the map providers ''Terms of Service''}}
{| style="float:right; margin:auto; text-align:center; margin-left: 0px;"
! colspan="3"|[[File:OpenStreetMap_5.15.10.png|256px|thumb|Center|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} OpenStreetMap]]
|-
|
|-
| [[File:MapsForFree_5.15.10.jpg|128px|thumb|Left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Maps For Free]]|| [[File:OpenCycleMap_5.15.10.png|128px|thumb|Center|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} OpenCycleMap ]]|| [[File:PublicTransport_5.15.10.png|128px|thumb|Right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Public Transport]]
|-
|
|-
| [[File:GoogleStreet_5.15.10.png|128px|thumb|Center|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Google street ]]|| [[File:GoogleSat_5.15.10.jpg|128px|thumb|Center|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Google sat ]]|| [[File:GoogleHybrid_5.15.10.jpg|128px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Center|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Google hybrid]]
|-
|
|-
| [[File:Virtualearthstreet_5.15.10.png|128px|thumb|Center|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Virtualearth street ]]|| [[File:VirtualearthSat_5.15.10.jpg|128px|thumb|Center|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Virtualearth sat]]|| [[File:VirtualearthHybrid_5.15.10.jpg|128px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Center|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Virtualearth hybrid]]
|}
Several map providers are available in Gramps.

From the context menu (click on the [[Gramps_6.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse) near the bottom you will see the:
* {{man menu|'''Replace '(current map provider name)' by =>'''}}
menu that allows you to select a another map provider from the following:
* '''OpenStreetMap''' (default) : The advantage of [http://www.openstreetmap.org/ OpenStreetMap] is that it is a free project, so you can update the maps yourself with missing information via their website.
* [https://maps-for-free.com Maps For Free]
* [https://www.opencyclemap.org/ OpenCycleMap]
* Public Transport
* [https://www.google.com/intl/en_ALL/help/terms_maps.html Google street]
* [https://www.google.com/intl/en_ALL/help/terms_maps.html Google sat]
* [https://www.google.com/intl/en_ALL/help/terms_maps.html Google hybrid]
* Virtualearth street ([https://www.bing.com/maps Bing maps] was Virtualearth)[http://www.microsoft.com/maps/product/terms.html]
* Virtualearth sat ([https://www.bing.com/maps Bing maps] was Virtualearth)[http://www.microsoft.com/maps/product/terms.html]
* Virtualearth hybrid ([https://www.bing.com/maps Bing maps] was Virtualearth)[http://www.microsoft.com/maps/product/terms.html]

[[File:GeographyCategoryView-context-menu-example-60.png|left|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Geography Category View - context menu - example]]

{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Categories#Map_Service|Map Service]] - Place Category.

====How to show/remove the crosshair ?====
It can be useful to have the crosshair visible to see the center of the map.

This functionality is available with the [[Gramps_6.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse. you'll get a context menu popup.

Select {{man menu|Add (or) Remove cross hair}}.

This is useful to add or link places to the correct latitude-longitude coordinates

====How to lock/unlock the map ?====
When we change the map ( person to family, ... ), the zoom is recalculated.

It can be useful in some case to keep the same zoom and position when we [[Gramps_6.0_Wiki_Manual_-_Categories#How_to_change_the_map_provider_.3F|change the map provider]].

For this, click on the [[Gramps_6.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a context menu popup.

In this menu, you can select {{man menu|Lock (or) Unlock zoom and position}}.

== Sources Category ==
[[File:gramps-source.png|left]]
The {{man label|Sources Category}} offers two view modes ({{man label|[[#Citation_Tree_View|Citation Tree]]}} View and {{man label|[[#Sources_List_View|Sources List]]}} View (default)) that list the sources of certain information stored in the family tree. The record selection, column configuration and Gramplet selections are independent for each view mode.

Sources can include various documents: birth, death, and marriage certificates; books; films; journals; private diaries - nearly anything that can be described as genealogical evidence. Gramps gives you the option to provide citations of sources for each (Event, Person, Place, Media, Note, et cetera) object you create.

By default, the Sources View mode lists the <code>Title</code>, <code>ID</code>, and <code>Author</code> of the source, as well as any <code>Publication</code> information that may be associated with it. The list of Sources can be re-sorted by clicking on a different column heading. Clicking the header the first time sorts the rows in ascending order based on that column. Clicking again reverses to descending order.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Columns_4|Columns Editor]]}} tab of the Configure Sources dialog can be used to add, remove and rearrange the displayed columns. Click the [[file:gramps-config.png|x32px]] {{man tooltip|Configure the active view}} toolbar button or select {{man menu|Configure…}} from the {{man menu|Edit}} menu to open the dialog.

You can select the {{man button| {{icon| stock_add}}}} {{man tooltip|Add a new source}} toolbar button to create a new source or {{man button| {{icon| stock_edit}}}} {{man tooltip|Edit the selected source}} button to edit the sources selected in the list. Either action will invoke the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Source_dialog|Source Editor]]}} dialog.

* See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|Editing information about sources]]
{{-}}
===Sources List View===

[[File:SourcesCategory-Sources-ListView-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Sources" Category - "Sources" - List View - with context menu]]

The default, {{man label|Sources View}} mode only shows the Sources as a list and displays the {{man label|Title}}, {{man label|ID}}, and {{man label|Author}} of the source, as well as any associated {{man label|Publication Information}}. The list of Sources can be re-sorted by clicking on a different column heading. Clicking the header the first time sorts the rows in ascending order based on that column. Clicking again reverses to descending order.

{{-}}
====Sources List View context menu====
Additional options are available by selecting a source from the list and using the context/pop-up menu shown by right-clicking:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
**{{man menu|Source References}}
<hr>
{{-}}

====⚙ Configuration Options====
{{stub}}
=====Columns=====
{{stub}}
=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].

{{-}}

===Sources Category Bottombar tabs===

The {{man label|Sources Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Gallery====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Notes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Sources Category Sidebar tabs===

The {{man label|Sources Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}
===Citation Tree View===
[[File:SourcesCategory-CitationTree-View-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Sources" Category - "Citation Tree" - View - example with context menu shown]]

The {{man label|[[#Citation_Tree_View|Citation Tree]]}} View mode list will also show all the sources. In addition, it allows the user to see the [[#Citations_Category|Citations]] associated with each source by clicking on the [https://en.wikipedia.org/wiki/Disclosure_widget disclosure triangle] node {{man button|▶}}expand or {{man button|▼}}collapse disclosure triangular widget.

{{-}}
====Citation Tree View context menu====
All the nodes of the tree view mode can be simultaneously collapsed or expanded from the context/pop-up menu shown by right-clicking:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|Expand all Nodes}}
*{{man menu|Collapse all Nodes}}
<hr>
*{{man menu|Add…}}
*{{man menu|Add citation…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
**{{man menu|Source or Citation References}}
<hr>
{{-}}
====⚙ Configuration Options====
{{stub}}
=====Columns=====

The Columns tab allows customization of which columns will be displayed and their order of display.

The available columns for display are:
* {{checkbox|1}} {{man label|}}
{{-}}
{{stub}}

=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].

{{-}}

== Citations Category ==
[[File:gramps-citation.png|left]]
The {{man label|Citations Category}} shows the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Citations_List_View|Citation List View]]}} that show the citations for certain information stored in the family tree.

Citations specify which parts of a source are relevant to the information in the Family Tree. For example, a Source may be a book, and the citation may be a particular page in the book. Gramps gives you the option to provide a citation for each event you record (births, deaths, marriages, etc.).

{{-}}
===Citations List View===
{{stub}}
[[File:CitationsCategory-CitationView-List-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Citations" Category - "Citation View" (List) - example with context menu]]

The Citations List View shows the <code>Volume/Page</code> , <code>ID</code>, and <code>Date</code> of the citation, as well as the citations [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Citation_information|<code>Confidence</code>]] level of the evidence.

The list of Citations can be sorted by clicking on a column heading.

Clicking once sorts in ascending order, clicking again sorts in descending order.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Columns_6|Columns]]}} editor tab dialog can be used to remove and rearrange the displayed columns.

For the view via the menu or toolbar you may select:
* {{man button|Add...}} - {{man tooltip|Add a new citation and a new source}}
* {{man button|Edit...}} - {{man tooltip|Edit the selected citation}}
* {{man button|Delete}} - {{man tooltip|Delete the selected citation}}
* {{man button|Merge...}} - {{man tooltip|Merge the selected citations}}
* {{man button|Tag}} - {{man tooltip|Tag selected rows}}

The view may be exported to the CSV or spreadsheet format.
{{-}}

====Citations List View context menu====
Additional options are available by selecting a citation from the list and using the context/pop-up menu shown by right-clicking:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
**{{man menu|Citation References}}
{{-}}
====⚙ Configuration Options====
{{stub}}

=====Columns=====

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Columns_6|Columns]]}} editor tab dialog can be used to remove and rearrange the displayed columns and add the follow columns:
* Private
* Tags
* Last Changed
* Source:Title
* Source:ID
* Source:Author
* Source:Abbreviation
* Source:Publication Information
* Source:Private
* Source:Last Changed
{{-}}

{{stub}}

=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].

{{-}}

===Citations Category Bottombar tabs===

The {{man label|Citations Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Gallery====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Notes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Citations Category Sidebar tabs===

The {{man label|Citations Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Repositories Category ==
[[File:gramps-repository.png|left]]
The {{man label|Repositories Category}} shows the Repository List View. A repository can be thought of as a collection of sources. Each source in the family tree may be a reference to a repository (such as a library) in which it belongs.

{{-}}
===Repository List View===
{{stub}}
[[File:RepositoriesCategory-Repositories-ListView-example-60.png|450px|right|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Repositories" (list) view - example with context menu]]

This view shows a list of all recorded repositories.
{{-}}
====Repository List View context menu====
Additional options are available by selecting a repository from the list and using the context/pop-up menu shown by right-clicking:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
** {{man menu|Repository References}}
<hr>
{{-}}
====⚙ Configuration Options====
{{stub}}
=====Columns=====

The Columns tab allows customization of which columns will be displayed and their order of display.

The available columns for display are:
* {{checkbox|1}} {{man label|}}
{{-}}
{{stub}}

=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].

{{-}}

===Repository Category Bottombar tabs===

The {{man label|Repository Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Details====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Details|Details]] Gramplet
{{-}}
====Notes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Repository Category Sidebar tabs===

The {{man label|Repository Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Media Category ==
[[File:gramps-media.png|left]]
The {{man label|Media Category}} shows the Media List View, which list the Media Objects stored in the family tree.

Media Objects are technically any files that relate somehow to the stored genealogical data.

Most frequently, these are images, audio files, animation files, etc.
{{-}}
===Media List View===
{{stub}}
[[File:MediaCategory-Media-ListView-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Media" Category - "Media" (List) View - example with context menu]]

The Media List View shows the following columns for the list <code>Name</code> , <code>ID</code>, <code>Type</code>, <code>Path</code> and <code>Date</code> of the Media Object.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Columns_8|Columns]]}} editor tab dialog may be used to rearrange the displayed columns, which obey usual sorting rules.
{{-}}
====Media List View context menu====
Selecting a media item from the list and using the context menu (right-clicking) offers the following options:
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|View}} - show the media item using an external program.
*{{man menu|Open Containing Folder}} - which opens to the folder containing the media item.
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
** {{man menu|Media References}}
<hr>
{{-}}

====⚙ Configuration Options====
{{stub}}
=====Columns=====

The Columns tab allows customization of which columns will be displayed and their order of display.

The available columns for display are:
* {{checkbox|1}} {{man label|}}
{{-}}
{{stub}}

=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].

{{-}}

===Media Category Bottombar tabs===

The {{man label|Media Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Preview====
In the "Preview" tab you can double click on the media/photo to open it in the default picture viewer.

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Media_Preview|Media Preview]] Gramplet
{{-}}
====Citations====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====Attributes====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]] Gramplet
{{-}}
====Image Metadata====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Image Metadata|Image Metadata]] Gramplet
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Media Category Sidebar tabs===

The {{man label|Media Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Notes Category ==
[[File:gramps-notes.png|left]]
The {{man label|Notes Category}} View shows a List mode, which inventories the text notes (either pure text or pre-formatted) that can be referenced by the other objects.

See also:
* Using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_notes|Note Editor]]}} dialog to make new annotations or editing information about existing notes
{{-}}
===Notes List View===

[[File:NotesCategory-Notes-ListView-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Notes" Category - "Notes" (List) view - example with context menu]]

The {{man label|Notes}} List View shows a list of text notes.

The functionality of the notes View is similar to the other views. The view lists all {{man label|Notes}} stored in the Family Tree.

Use the {{man menu|View ->Configure View...}} menu to open the {{man label|[[Gramps_6.0_Wiki_Manual_-_Categories#Columns_9|Columns]]}} editor tab and change the displayed columns from the default: <code>Preview</code>, <code>ID</code> and <code>Type</code>.

The <code>Type</code> can be ([[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#note_type|amongst others]]): ''Event Note'', ''Address Note'', ''Source text'', ''Place Note''. (In version 6.0, the built-in <code>Type</code> list includes: ''Citation'', ''Custom'', ''General'', ''HTML code'', ''Link'', ''Report'', ''Research'', ''Source text'', ''To Do'', ''Transcript'', ''Unknown'')

Double-clicking on a Note item in the list will bring up the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Note_editor_dialog|Note editor]]}} window dialog where you can edit the Note. You can change fonts, font color and background color. If enabled via the {{man label|[ ] Enable spell checker}} option a [[Gramps_6.0_Wiki_Manual_-_Settings#Environment_Settings|spelling checker]] is available for ''English'' and your local language.
{{-}}
====Notes List View context menu====
Selecting a Note item from the list and using the context menu (right-clicking) offers the following options
<hr>
*{{man menu|Back}}
*{{man menu|Forward}}
<hr>
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
<hr>
*{{man menu|Quick View}}
**{{man menu|Link References}}
**{{man menu|Note References}}
<hr>
{{-}}

====⚙ Configuration Options====
[[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]] is clicked to customize options specific to the current view mode. (As opposed to [[Gramps_6.0_Wiki_Manual_-_Settings|{{man menu|Edit ➡ Preferences}}]] options that customize all views.) Alternatively, use the {{man menu|View ➡ Configure...}} menu or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The following two tabs are shown:
* Columns
* CSV Dialect
{{-}}

=====Columns=====

The Columns tab allows customization of which columns will be displayed and their order of display.

The available columns for display are:
* {{checkbox|1}} {{man label|Preview}}
* {{checkbox|1}} {{man label|ID}}
* {{checkbox|1}} {{man label|Type}}
* {{checkbox|0}} {{man label|Private}}
* {{checkbox|0}} {{man label|Tags}}
* {{checkbox|0}} {{man label|Last Changed}}
{{-}}

=====CSV Dialect=====
On the [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect tab]] you can choose the CSV format for the delimiter to be used when [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|exporting this list view]].

{{-}}

===Notes Category Bottombar tabs===

The {{man label|Notes Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====References====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Notes Category Sidebar tabs===

The {{man label|Notes Category}} shows the following [[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet

{{-}}
{{man index|Gramps 6.0 Wiki Manual - Main Window|Gramps 6.0 Wiki Manual - Manage Family Trees|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Categories}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Gramps 6.0 Wiki Manual - Reports - part 5

2025-12-06T04:35:45Z

CallMeDave: /* Graph Style */

{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Reports - part 5}}
{{#vardefine:chapter|13.5}}
{{#vardefine:figure|0}}
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
<hr>
{{-}}
[[File:MenuOverview-Reports-Graphs-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man menu|Reports >Graphs>...}} Menu overview]]
This section describes the different {{man label|Graphs}} (aka Graph Reports) available in Gramps.
==Graphs==
{{man tip|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|Prerequisites for Graph Reports]]|These reports are created using the [[Output_formats#Graphviz|GraphViz]] program. Therefore, it is important that the '''Graphviz''' program is installed on your computer.}}
{{man warn|Reports and custom IDs|After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on {{man menu|Edit --> Preferences}} on the {{man label|ID Formats}} tab). If generated reports do not properly display data, then try [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs tool]] {{man menu|Tools-->Family Tree Processing-->Reorder Gramps IDs...}}}}

All three graph reports: [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines]], [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Hourglass_Graph|Hourglass]], and [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship]] Graphs share common options: {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Layout|Graphviz Layout]]}}, {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Options|Graphviz Options]]}}, and {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Note|Note]]}}.

Also they share common options with the other reports [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Common_options|common options]]: {{man label|Paper Options}} and {{man label|Document Options}}.

===Prerequisites for Graph Reports===
Requires the installation of the [[Output_formats#Graphviz|GraphViz]] program and Ghostscript program that is used by Graphviz reports to help create PDF files.

* On Linux, use your package manager.
* On Microsoft Windows use the Gramps AIO as they are already part of the installer.
* On Apple macOS use the Gramps .dmg as they are already part of the installer.

===Common Options===

There are also several [[Output_formats#Graphviz|GraphViz]] specific options related to pagination, color, and details of the graph.

This plugin uses the Graphviz graph visualization and Ghostscript programs. Graphviz takes the generated [[Output_formats#Graphviz|<code>.gv</code>]] files and creates the final files, such as <code>.gif</code>, <code>.png</code>, , <code>.ps</code>, (Ghostscript creates <code>.pdf</code>), etc.

====Graphviz Layout====

[[File:FamilyLinesGraph-Graphs-GraphvizLayout-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Layout - tab default options]]

*{{man label|Font family:}} Choose the font family. If international characters don't show, use '''FreeSans''' font. FreeSans is available from [http://www.nongnu.org/freefont/ the NonGNU org].
** '''Default'''
** PostScript/ Helvetica
** True Type/ FreeSans
*{{man label|Font size:}} (<code>14</code> default) The font size, in [https://wikipedia.org/wiki/Point_(typography) points].
*{{man label|Graph Direction:}} Whether the graph goes from top to bottom or left to right
** '''Vertical (top to bottom)''' (Default)
** Vertical (bottom to top)
** Horizontal (left to right)
** Horizontal (right to left)
*{{man label|Number of Horizontal Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array horizontally. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Number of Vertical Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array vertically. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Paging Direction:}} (''Bottom, left'' default) The order in which the graph pages are output. This option only applies if the horizontal pages or vertical pages are greater than 1.
*{{man label|Connecting lines:}} - How the lines between objects will be drawn. Choose from:
** ''Straight''
** '''Curved''' (Default)
** ''Orthogonal''
{{-}}

====Graphviz Options====

[[File:FamilyLinesGraph-Graphs-GraphvizOptions-tab-52.png|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Options - tab default options]]

* {{man label|Aspect Ratio:}} Affects greatly how the graph is laid out on the page. Specifically node spacing and scaling of the graph( see ''Advice 1:'').
** ''Compress to minimal minimal size''
** '''Fill the given area''' (default)
** ''Expand uniformly''
<hr>
'''Advice 1:'''

If the graph is smaller than the print area:
* ''Compress to minimal minimal size'' will not change the node spacing.
* ''Fill the given area'' will increase the node spacing to fit the print area in both width and height.
* ''Expand uniformly'' will increase the node spacing uniformly to preserve the aspect ratio.

If the graph is larger than the print area:
* ''Compress to minimal minimal size'' will shrink the graph to achieve tight packing at the expense of symmetry.
* ''Fill the given area'' will shrink the graph to fit the print area after first increasing the node spacing.
* ''Expand uniformly'' will shrink the graph uniformly to fit the print area.
<hr>

* {{man label|DPI:}} (<code>72</code> default) dots-per-inch. When creating PostScript or PDF, use 72 DPI. Typically between 75 and 120 if generating .png or .gif files, but 300 or 600 if generating files to be printed. When creating images such as .gif or .png files for the web, try numbers such as 100 or 300 DPI.
* {{man label|Node Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between individual nodes. For vertical graphs, this corresponds to spacing between columns. For horizontal graphs, this corresponds to spacing between rows.
* {{man label|Rank Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between ranks. For vertical graphs, this corresponds to spacing between rows. For horizontal graphs, this corresponds to spacing between columns.

====Note====
[[File:FamilyLinesGraph-Graphs-Note-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Note - tab default options]]

* {{man label|Note to add to the graph:}} (Empty by default) This text will be added to the graph
* {{man label|Note location:}} - Whether the note will appear on top or bottom of the page.
** '''Top''' (default)
** ''Bottom''
* {{man label|Note size:}} (<code>32</code> default) The size of note text, in [https://en.wikipedia.org/wiki/Point_(typography) points].
{{-}}

===Family Lines Graph===
{{man note|That Family Lines Graph does not display all of the people in the Family Tree.|Instead, this Graph report generates smaller family trees, with many options to try and restrict the number of people included.}}

[[File:Graphs-FamilyLinesGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - example output overview]]

The {{man label|Family Lines Graph}} works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants to generate the {{man label|Family Lines Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

A typical use of this report is to generate simplified graphs to be printed on ''large format printing plotters''.

To create a {{man label|Family Lines Graph}} from the menu select {{man menu|Reports ->Graphs -> Family Lines Graph...}} and then from the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#People_of_Interest|People of Interest]]}} tab click on the {{icon|stock_add}}(add) icon and select at least one person from the {{man label|Select Person}} selector dialog and the report will suggest if possible a second related person via the {{man label|Select Person - Also include <Person Name>}} warning dialog select {{man button|No}} or {{man button|Yes}} depending on what you decide and then select {{man button|OK}} to generate the report.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:FamilyLinesGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options - tab default options]]

* {{checkbox|1}} {{man label|Follow parents to determine "family lines"}} Parents and their ancestors will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Follow children to determine "family lines"}} Children will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Try to remove extra people and families}} People and families not directly related to people of interest will be removed when determining "family lines". (checkbox checked by default)
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Descendants <- Ancestors''' (default) - arrows point to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{man label|Rounded corners:}} to differentiate between women and men.
** '''None''' (default)
** ''Female''
** ''Male''
** ''Both''
* {{man label|Gramps ID:}} Whether (and where) to include Gramps IDs
** '''Do not include''' (default)
** ''Share an existing line''
** ''On a line of its own''
{{-}}

====Report Options (2)====
[[File:FamilyLinesGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD (ISO) (2024-11-15)''' (default for report)
** ''Numerical (15/11/2024)''
** ''Month Day, Year (March 14, 2018)''
** ''MON DAY, YEAR (Mar 14, 2018)''
** ''Day Month Year (14 March 2018)''
** ''DAY MON YEAR (14 Mar 2018)''
* {{checkbox|1}} {{man label|Use subgraphs}} (checkbox checked by default) - Subgraphs can help Grapviz position spouses together, but with non-trival graphs will result in longer lines and larger graphs.
{{-}}

====People of Interest====

[[File:FamilyLinesGraph-Graphs-PeopleOfInterest-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - People of Interest - tab default options]]

The graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.

* {{man label|People of interest:}} click on {{icon|stock_add}} and {{icon|stock_remove}} to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
* {{checkbox|0}} {{man label|Limit the number of ancestors}} (checkbox unchecked by default) Whether to limit the number of ancestors.
** <code>50</code> default. The maximum number of ancestors to include. The maximum is for the total number of people, not generations to be displayed on the chart.
* {{checkbox|0}} {{man label|Limit the number of descendants}} (checkbox unchecked by default) Whether to limit the number of descendants.
** <code>50</code> default. The maximum number of descendants to include. The maximum is for the total number of people, not generations to be displayed on the chart.
{{-}}
=====Select Person - Also include <Person Name> warning dialog=====

Select Person - Also include <Person Name> warning dialog
{{stub}}
{{-}}

====Include====

[[File:FamilyLinesGraph-Graphs-Include-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Include - tab default options]]

* {{checkbox|1}} {{man label|Include dates}}: date of birth, date of death, and marriage dates will be included in the graph when this is selected. (checkbox checked by default)
* {{checkbox|0}} {{man label|Limit dates to years only}}: from the above only show the years.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include places}}: place of birth, place of death, and place of marriage will be included in the graph when this is selected.(checkbox checked by default)
* {{checkbox|1}} {{man label|Include the number of children}}: marriage text will include the total number of children when this is selected.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include thumbnail images of people}} (checkbox checked by default)
* {{man label|Thumbnail location:}}
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Thumbnail size:}}
** '''Normal''' (default)
** ''Large''
{{-}}

====Family Colors====

[[File:FamilyLinesGraph-Graphs-FamilyColors-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Family Colors - tab default options]]

* {{man label|Family colors:}} Select the color to use for people with a specific surname. Two columns are available: ''Surname'' and ''Color''. Click on {{icon|stock_add}} or {{icon|stock_remove}} to add a surname from the {{man label|Select surname}} window, select a surname and press {{man button|OK}}. To edit the surname color double-click on a surname and from the {{man label|Select color for [Surname Selected]}} window choose from the shown colors and then select {{man button|Select}}.
{{-}}

====Individuals====

[[File:FamilyLinesGraph-Graphs-Individuals-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Individuals - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use to display men.
* {{man label|Females:}} the color to use to display women.
* {{man label|Other:}} the color to use to display people who neither men nor women.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use to display families. (marriages).
{{-}}

===Hourglass Graph===

[[File:Graphs-HourglassGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - example output overview]]

Generate an {{man label|Hourglass Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]]. Go to {{man menu|Reports -> Graph -> Hourglass Graph...}}.

The hourglass graph chart shows the {{man label|Center Person:}}s ancestors above them and descendants below them. The hourglass graph does not show siblings of the ancestors but it does include all the descendants below them including any spouses.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====

[[File:HourglassGraph-Graphs-ReportOptions-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options - tab default options]]

* {{man label|Center Person:}} the center person for the report, defaults to the current active person.
** {{man button|Select a different person}} button. - Change the center person.
* {{man label|Max Descendant Generations:}} default <code>10</code>
* {{man label|Max Ancestor Generations:}} default <code>10</code>
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Centre -> Others''' (default) - arrows point to the Other.
** ''Centre <- Others'' - arrows point to the Centre.
** ''Centre <-> Others'' - arrows point to both.
** ''Centre - Others'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} to differentiate between women and men (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' (default)
** ''include''
{{-}}

====Report Options (2)====
[[File:HourglassGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name format:}} - Select the format to display the names. This choice in normally taken from the default setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** Surname, Given Suffix
** Given Surname Suffix
** Given
** Main Surnames, Given Patronymic Suffix
** SURNAME, Given (Common)
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2018-03-14)''' (default for report)
** Numerical(14/3/2018)
** Month Day, Year(March 14, 2018)
** MON DAY, YEAR(Mar 14, 2018)
** Day Month Year(14 March 2018)
** DAY MON YEAR(14 Mar 2018)
{{-}}

====Graph Style====

[[File:HourglassGraph-Graphs-GraphStyle-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use for males.
* {{man label|Females:}} the color to use for females.
* {{man label|Other:}} the color to use for Others.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use for families (weddings).
{{checkbox|0}} {{man label| Force [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] order}} - Force Sosa / Sosa-Stradonitz / Ahnentafel layout order for all ancestors, so that fathers are always on the left branch and mothers are on the right branch.
{{checkbox|0}} {{man label| [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] number visible}} - Show Sosa / Sosa-Stradonitz / Ahnentafel number.
{{checkbox|0}} {{man label| Show symbols for events}} - Show genealogical symbols for birth, marriage and death events.
{{-}}

===Relationship Graph===

[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

The {{man label|Relationship Graph}} creates a complex relationship graph using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

Via the menu: {{man menu|Reports-> Graphs- >Relationship Graph...}}. You will be presented with a {{man label|Relationship Graph}} window where you can change all the settings.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:RelationshipGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options - tab default options]]

* {{man label|Filter:}} - Select the filter to be applied to the report. Choose from:
** '''Entire Database''' (Default) ({{man menu|'''Not recommended!'''}})
** ''Descendants of active person''
** ''Descendant families of active person''
** ''Ancestors of active person''
** ''People with common ancestor with active person''
** ''Any custom made filter you have created will be listed below the other choices.''
* {{man label|Centre Person:}} The center person for the filter. Defaults to the Active Person. If you use a custom filter, no Person can be chosen.
** {{man button|Select a different person}} button. - Change the Centre person.
* {{man label|Arrowhead direction}}: Choose the direction that the arrows point:
** '''Descendants <- Ancestors'''(default) - arrows point to the to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} Use rounded corners to differentiate between women and men (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Use hexagons}} (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' default
** ''include''
{{-}}

====Report Options (2)====
[[File:RelationshipGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code> (default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2024-11-15)''' (default for report)
** ''Numerical(15/11/2014)''
** ''Month Day, Year(November 15, 2024)''
** ''MON DAY, YEAR(Nov 15, 2024)''
** ''Day Month Year(15 November 2024)''
** ''DAY MON YEAR(15 Nov 2024)''
{{-}}

====Include====

[[File:RelationshipGraph-Graphs-Include-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Include - tab default options]]

* {{man label|Dates and/or Places:}} - Whether to include dates and/or places
** '''Do not include any dates or places''' (default)
** ''Include (birth, marriage, death) dates, but no places''
** ''Include (birth, marriage, death) dates, and place''
** ''Include (birth, marriage, death) dates, and place if no dates''
** ''Include (birth, marriage, death) years, but no places''
** ''Include (birth, marriage, death) years, and places''
** ''Include (birth, marriage, death) places, but no date''s
** ''Include (birth, marriage, death) dates and places on same line''
* {{checkbox|1}} {{man label|Show all family nodes}} Show family nodes even if the output contains only one member of the family. (checkbox checked by default)
* {{checkbox|0}} {{man label|Include URLs}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include relationship to center person}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include thumbnail images of people}} (checkbox unchecked by default)
* {{man label|Thumbnail location:}} Where the thumbnail image should appear relative to the name
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Include occupation:}} Whether to include the last occupation
** '''Do not include any occupation''' (default)
** ''Include description of most recent occupation''
** ''Include date, description and place of all occupations''
* {{checkbox|0}} {{man label|Include relationship debugging numbers also}} Whether to include 'Ga' and 'Gb' also, to debug the relationship calculator (checkbox unchecked by default)
{{-}}

====Graph Style====

[[File:RelationshipGraph-Graphs-GraphStyle-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use for males.
* {{man label|Females:}} the color to use for females.
* {{man label|Other:}} the color to use for others.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use for families (weddings).
* {{checkbox|1}} {{man label|Indicate non-birth relationships with dotted lines}} (checkbox checked by default) - Shows adopted relationships.
* {{checkbox|1}} {{man label|Show family nodes}} (checkbox checked by default)
* {{man label|Parent grouping:}} Decides the location of the parents in the graph.
** '''Normal''' (default)
** ''Parents together''
** ''Parents offset''
{{-}}

====Example relationship graph====
[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.
# First check that this person is the ''active person''. (You change this later but this is handier)
# Go via the menu {{man menu|Reports->Graphs->Relationship Graph...}}
# Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
# Report Options: filter: Descendant Families of..., Color fill, Use rounded corners
# Graph Style : Show Family Nodes
# Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
# Graphviz Options: Fill given area dpi 133
# Note : we add title on the top size: 18 pts
# Output Format: we want a JPEG file.

The results are similar to the image shown in Fig. {{#var:chapter}}.{{#var:figure}}.
{{-}}
See also:
* A detailed tutorial [[Howto:_Make_a_relationship_chart|How to make a relationship chart]]
{{-}}
<hr>
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Reports - part 5}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Reports - part 5

2025-12-06T04:35:23Z

CallMeDave: /* Report Options */

{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Reports - part 5}}
{{#vardefine:chapter|13.5}}
{{#vardefine:figure|0}}
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
<hr>
{{-}}
[[File:MenuOverview-Reports-Graphs-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man menu|Reports >Graphs>...}} Menu overview]]
This section describes the different {{man label|Graphs}} (aka Graph Reports) available in Gramps.
==Graphs==
{{man tip|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|Prerequisites for Graph Reports]]|These reports are created using the [[Output_formats#Graphviz|GraphViz]] program. Therefore, it is important that the '''Graphviz''' program is installed on your computer.}}
{{man warn|Reports and custom IDs|After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on {{man menu|Edit --> Preferences}} on the {{man label|ID Formats}} tab). If generated reports do not properly display data, then try [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs tool]] {{man menu|Tools-->Family Tree Processing-->Reorder Gramps IDs...}}}}

All three graph reports: [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines]], [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Hourglass_Graph|Hourglass]], and [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship]] Graphs share common options: {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Layout|Graphviz Layout]]}}, {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Options|Graphviz Options]]}}, and {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Note|Note]]}}.

Also they share common options with the other reports [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Common_options|common options]]: {{man label|Paper Options}} and {{man label|Document Options}}.

===Prerequisites for Graph Reports===
Requires the installation of the [[Output_formats#Graphviz|GraphViz]] program and Ghostscript program that is used by Graphviz reports to help create PDF files.

* On Linux, use your package manager.
* On Microsoft Windows use the Gramps AIO as they are already part of the installer.
* On Apple macOS use the Gramps .dmg as they are already part of the installer.

===Common Options===

There are also several [[Output_formats#Graphviz|GraphViz]] specific options related to pagination, color, and details of the graph.

This plugin uses the Graphviz graph visualization and Ghostscript programs. Graphviz takes the generated [[Output_formats#Graphviz|<code>.gv</code>]] files and creates the final files, such as <code>.gif</code>, <code>.png</code>, , <code>.ps</code>, (Ghostscript creates <code>.pdf</code>), etc.

====Graphviz Layout====

[[File:FamilyLinesGraph-Graphs-GraphvizLayout-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Layout - tab default options]]

*{{man label|Font family:}} Choose the font family. If international characters don't show, use '''FreeSans''' font. FreeSans is available from [http://www.nongnu.org/freefont/ the NonGNU org].
** '''Default'''
** PostScript/ Helvetica
** True Type/ FreeSans
*{{man label|Font size:}} (<code>14</code> default) The font size, in [https://wikipedia.org/wiki/Point_(typography) points].
*{{man label|Graph Direction:}} Whether the graph goes from top to bottom or left to right
** '''Vertical (top to bottom)''' (Default)
** Vertical (bottom to top)
** Horizontal (left to right)
** Horizontal (right to left)
*{{man label|Number of Horizontal Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array horizontally. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Number of Vertical Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array vertically. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Paging Direction:}} (''Bottom, left'' default) The order in which the graph pages are output. This option only applies if the horizontal pages or vertical pages are greater than 1.
*{{man label|Connecting lines:}} - How the lines between objects will be drawn. Choose from:
** ''Straight''
** '''Curved''' (Default)
** ''Orthogonal''
{{-}}

====Graphviz Options====

[[File:FamilyLinesGraph-Graphs-GraphvizOptions-tab-52.png|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Options - tab default options]]

* {{man label|Aspect Ratio:}} Affects greatly how the graph is laid out on the page. Specifically node spacing and scaling of the graph( see ''Advice 1:'').
** ''Compress to minimal minimal size''
** '''Fill the given area''' (default)
** ''Expand uniformly''
<hr>
'''Advice 1:'''

If the graph is smaller than the print area:
* ''Compress to minimal minimal size'' will not change the node spacing.
* ''Fill the given area'' will increase the node spacing to fit the print area in both width and height.
* ''Expand uniformly'' will increase the node spacing uniformly to preserve the aspect ratio.

If the graph is larger than the print area:
* ''Compress to minimal minimal size'' will shrink the graph to achieve tight packing at the expense of symmetry.
* ''Fill the given area'' will shrink the graph to fit the print area after first increasing the node spacing.
* ''Expand uniformly'' will shrink the graph uniformly to fit the print area.
<hr>

* {{man label|DPI:}} (<code>72</code> default) dots-per-inch. When creating PostScript or PDF, use 72 DPI. Typically between 75 and 120 if generating .png or .gif files, but 300 or 600 if generating files to be printed. When creating images such as .gif or .png files for the web, try numbers such as 100 or 300 DPI.
* {{man label|Node Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between individual nodes. For vertical graphs, this corresponds to spacing between columns. For horizontal graphs, this corresponds to spacing between rows.
* {{man label|Rank Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between ranks. For vertical graphs, this corresponds to spacing between rows. For horizontal graphs, this corresponds to spacing between columns.

====Note====
[[File:FamilyLinesGraph-Graphs-Note-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Note - tab default options]]

* {{man label|Note to add to the graph:}} (Empty by default) This text will be added to the graph
* {{man label|Note location:}} - Whether the note will appear on top or bottom of the page.
** '''Top''' (default)
** ''Bottom''
* {{man label|Note size:}} (<code>32</code> default) The size of note text, in [https://en.wikipedia.org/wiki/Point_(typography) points].
{{-}}

===Family Lines Graph===
{{man note|That Family Lines Graph does not display all of the people in the Family Tree.|Instead, this Graph report generates smaller family trees, with many options to try and restrict the number of people included.}}

[[File:Graphs-FamilyLinesGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - example output overview]]

The {{man label|Family Lines Graph}} works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants to generate the {{man label|Family Lines Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

A typical use of this report is to generate simplified graphs to be printed on ''large format printing plotters''.

To create a {{man label|Family Lines Graph}} from the menu select {{man menu|Reports ->Graphs -> Family Lines Graph...}} and then from the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#People_of_Interest|People of Interest]]}} tab click on the {{icon|stock_add}}(add) icon and select at least one person from the {{man label|Select Person}} selector dialog and the report will suggest if possible a second related person via the {{man label|Select Person - Also include <Person Name>}} warning dialog select {{man button|No}} or {{man button|Yes}} depending on what you decide and then select {{man button|OK}} to generate the report.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:FamilyLinesGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options - tab default options]]

* {{checkbox|1}} {{man label|Follow parents to determine "family lines"}} Parents and their ancestors will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Follow children to determine "family lines"}} Children will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Try to remove extra people and families}} People and families not directly related to people of interest will be removed when determining "family lines". (checkbox checked by default)
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Descendants <- Ancestors''' (default) - arrows point to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{man label|Rounded corners:}} to differentiate between women and men.
** '''None''' (default)
** ''Female''
** ''Male''
** ''Both''
* {{man label|Gramps ID:}} Whether (and where) to include Gramps IDs
** '''Do not include''' (default)
** ''Share an existing line''
** ''On a line of its own''
{{-}}

====Report Options (2)====
[[File:FamilyLinesGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD (ISO) (2024-11-15)''' (default for report)
** ''Numerical (15/11/2024)''
** ''Month Day, Year (March 14, 2018)''
** ''MON DAY, YEAR (Mar 14, 2018)''
** ''Day Month Year (14 March 2018)''
** ''DAY MON YEAR (14 Mar 2018)''
* {{checkbox|1}} {{man label|Use subgraphs}} (checkbox checked by default) - Subgraphs can help Grapviz position spouses together, but with non-trival graphs will result in longer lines and larger graphs.
{{-}}

====People of Interest====

[[File:FamilyLinesGraph-Graphs-PeopleOfInterest-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - People of Interest - tab default options]]

The graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.

* {{man label|People of interest:}} click on {{icon|stock_add}} and {{icon|stock_remove}} to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
* {{checkbox|0}} {{man label|Limit the number of ancestors}} (checkbox unchecked by default) Whether to limit the number of ancestors.
** <code>50</code> default. The maximum number of ancestors to include. The maximum is for the total number of people, not generations to be displayed on the chart.
* {{checkbox|0}} {{man label|Limit the number of descendants}} (checkbox unchecked by default) Whether to limit the number of descendants.
** <code>50</code> default. The maximum number of descendants to include. The maximum is for the total number of people, not generations to be displayed on the chart.
{{-}}
=====Select Person - Also include <Person Name> warning dialog=====

Select Person - Also include <Person Name> warning dialog
{{stub}}
{{-}}

====Include====

[[File:FamilyLinesGraph-Graphs-Include-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Include - tab default options]]

* {{checkbox|1}} {{man label|Include dates}}: date of birth, date of death, and marriage dates will be included in the graph when this is selected. (checkbox checked by default)
* {{checkbox|0}} {{man label|Limit dates to years only}}: from the above only show the years.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include places}}: place of birth, place of death, and place of marriage will be included in the graph when this is selected.(checkbox checked by default)
* {{checkbox|1}} {{man label|Include the number of children}}: marriage text will include the total number of children when this is selected.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include thumbnail images of people}} (checkbox checked by default)
* {{man label|Thumbnail location:}}
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Thumbnail size:}}
** '''Normal''' (default)
** ''Large''
{{-}}

====Family Colors====

[[File:FamilyLinesGraph-Graphs-FamilyColors-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Family Colors - tab default options]]

* {{man label|Family colors:}} Select the color to use for people with a specific surname. Two columns are available: ''Surname'' and ''Color''. Click on {{icon|stock_add}} or {{icon|stock_remove}} to add a surname from the {{man label|Select surname}} window, select a surname and press {{man button|OK}}. To edit the surname color double-click on a surname and from the {{man label|Select color for [Surname Selected]}} window choose from the shown colors and then select {{man button|Select}}.
{{-}}

====Individuals====

[[File:FamilyLinesGraph-Graphs-Individuals-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Individuals - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use to display men.
* {{man label|Females:}} the color to use to display women.
* {{man label|Other:}} the color to use to display people who neither men nor women.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use to display families. (marriages).
{{-}}

===Hourglass Graph===

[[File:Graphs-HourglassGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - example output overview]]

Generate an {{man label|Hourglass Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]]. Go to {{man menu|Reports -> Graph -> Hourglass Graph...}}.

The hourglass graph chart shows the {{man label|Center Person:}}s ancestors above them and descendants below them. The hourglass graph does not show siblings of the ancestors but it does include all the descendants below them including any spouses.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====

[[File:HourglassGraph-Graphs-ReportOptions-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options - tab default options]]

* {{man label|Center Person:}} the center person for the report, defaults to the current active person.
** {{man button|Select a different person}} button. - Change the center person.
* {{man label|Max Descendant Generations:}} default <code>10</code>
* {{man label|Max Ancestor Generations:}} default <code>10</code>
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Centre -> Others''' (default) - arrows point to the Other.
** ''Centre <- Others'' - arrows point to the Centre.
** ''Centre <-> Others'' - arrows point to both.
** ''Centre - Others'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} to differentiate between women and men (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' (default)
** ''include''
{{-}}

====Report Options (2)====
[[File:HourglassGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name format:}} - Select the format to display the names. This choice in normally taken from the default setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** Surname, Given Suffix
** Given Surname Suffix
** Given
** Main Surnames, Given Patronymic Suffix
** SURNAME, Given (Common)
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2018-03-14)''' (default for report)
** Numerical(14/3/2018)
** Month Day, Year(March 14, 2018)
** MON DAY, YEAR(Mar 14, 2018)
** Day Month Year(14 March 2018)
** DAY MON YEAR(14 Mar 2018)
{{-}}

====Graph Style====

[[File:HourglassGraph-Graphs-GraphStyle-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use for males.
* {{man label|Females:}} the color to use for females.
* {{man label|Other:}} the color to use for Others.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use for families (weddings).
{{checkbox|0}} {{man label| Force [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] order}} - Force Sosa / Sosa-Stradonitz / Ahnentafel layout order for all ancestors, so that fathers are always on the left branch and mothers are on the right branch.
{{checkbox|0}} {{man label| [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] number visible}} - Show Sosa / Sosa-Stradonitz / Ahnentafel number.
{{checkbox|0}} {{man label| Show symbols for events}} - Show genealogical symbols for birth, marriage and death events.
{{-}}

===Relationship Graph===

[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

The {{man label|Relationship Graph}} creates a complex relationship graph using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

Via the menu: {{man menu|Reports-> Graphs- >Relationship Graph...}}. You will be presented with a {{man label|Relationship Graph}} window where you can change all the settings.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:RelationshipGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options - tab default options]]

* {{man label|Filter:}} - Select the filter to be applied to the report. Choose from:
** '''Entire Database''' (Default) ({{man menu|'''Not recommended!'''}})
** ''Descendants of active person''
** ''Descendant families of active person''
** ''Ancestors of active person''
** ''People with common ancestor with active person''
** ''Any custom made filter you have created will be listed below the other choices.''
* {{man label|Centre Person:}} The center person for the filter. Defaults to the Active Person. If you use a custom filter, no Person can be chosen.
** {{man button|Select a different person}} button. - Change the Centre person.
* {{man label|Arrowhead direction}}: Choose the direction that the arrows point:
** '''Descendants <- Ancestors'''(default) - arrows point to the to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} Use rounded corners to differentiate between women and men (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Use hexagons}} (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' default
** ''include''
{{-}}

====Report Options (2)====
[[File:RelationshipGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code> (default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2024-11-15)''' (default for report)
** ''Numerical(15/11/2014)''
** ''Month Day, Year(November 15, 2024)''
** ''MON DAY, YEAR(Nov 15, 2024)''
** ''Day Month Year(15 November 2024)''
** ''DAY MON YEAR(15 Nov 2024)''
{{-}}

====Include====

[[File:RelationshipGraph-Graphs-Include-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Include - tab default options]]

* {{man label|Dates and/or Places:}} - Whether to include dates and/or places
** '''Do not include any dates or places''' (default)
** ''Include (birth, marriage, death) dates, but no places''
** ''Include (birth, marriage, death) dates, and place''
** ''Include (birth, marriage, death) dates, and place if no dates''
** ''Include (birth, marriage, death) years, but no places''
** ''Include (birth, marriage, death) years, and places''
** ''Include (birth, marriage, death) places, but no date''s
** ''Include (birth, marriage, death) dates and places on same line''
* {{checkbox|1}} {{man label|Show all family nodes}} Show family nodes even if the output contains only one member of the family. (checkbox checked by default)
* {{checkbox|0}} {{man label|Include URLs}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include relationship to center person}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include thumbnail images of people}} (checkbox unchecked by default)
* {{man label|Thumbnail location:}} Where the thumbnail image should appear relative to the name
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Include occupation:}} Whether to include the last occupation
** '''Do not include any occupation''' (default)
** ''Include description of most recent occupation''
** ''Include date, description and place of all occupations''
* {{checkbox|0}} {{man label|Include relationship debugging numbers also}} Whether to include 'Ga' and 'Gb' also, to debug the relationship calculator (checkbox unchecked by default)
{{-}}

====Graph Style====

[[File:RelationshipGraph-Graphs-GraphStyle-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
* {{checkbox|1}} {{man label|Indicate non-birth relationships with dotted lines}} (checkbox checked by default) - Shows adopted relationships.
* {{checkbox|1}} {{man label|Show family nodes}} (checkbox checked by default)
* {{man label|Parent grouping:}} Decides the location of the parents in the graph.
** '''Normal''' (default)
** ''Parents together''
** ''Parents offset''
{{-}}

====Example relationship graph====
[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.
# First check that this person is the ''active person''. (You change this later but this is handier)
# Go via the menu {{man menu|Reports->Graphs->Relationship Graph...}}
# Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
# Report Options: filter: Descendant Families of..., Color fill, Use rounded corners
# Graph Style : Show Family Nodes
# Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
# Graphviz Options: Fill given area dpi 133
# Note : we add title on the top size: 18 pts
# Output Format: we want a JPEG file.

The results are similar to the image shown in Fig. {{#var:chapter}}.{{#var:figure}}.
{{-}}
See also:
* A detailed tutorial [[Howto:_Make_a_relationship_chart|How to make a relationship chart]]
{{-}}
<hr>
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Reports - part 5}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Reports - part 5

2025-12-06T04:34:57Z

CallMeDave: /* Graph Style */

{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Reports - part 5}}
{{#vardefine:chapter|13.5}}
{{#vardefine:figure|0}}
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
<hr>
{{-}}
[[File:MenuOverview-Reports-Graphs-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man menu|Reports >Graphs>...}} Menu overview]]
This section describes the different {{man label|Graphs}} (aka Graph Reports) available in Gramps.
==Graphs==
{{man tip|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|Prerequisites for Graph Reports]]|These reports are created using the [[Output_formats#Graphviz|GraphViz]] program. Therefore, it is important that the '''Graphviz''' program is installed on your computer.}}
{{man warn|Reports and custom IDs|After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on {{man menu|Edit --> Preferences}} on the {{man label|ID Formats}} tab). If generated reports do not properly display data, then try [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs tool]] {{man menu|Tools-->Family Tree Processing-->Reorder Gramps IDs...}}}}

All three graph reports: [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines]], [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Hourglass_Graph|Hourglass]], and [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship]] Graphs share common options: {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Layout|Graphviz Layout]]}}, {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Options|Graphviz Options]]}}, and {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Note|Note]]}}.

Also they share common options with the other reports [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Common_options|common options]]: {{man label|Paper Options}} and {{man label|Document Options}}.

===Prerequisites for Graph Reports===
Requires the installation of the [[Output_formats#Graphviz|GraphViz]] program and Ghostscript program that is used by Graphviz reports to help create PDF files.

* On Linux, use your package manager.
* On Microsoft Windows use the Gramps AIO as they are already part of the installer.
* On Apple macOS use the Gramps .dmg as they are already part of the installer.

===Common Options===

There are also several [[Output_formats#Graphviz|GraphViz]] specific options related to pagination, color, and details of the graph.

This plugin uses the Graphviz graph visualization and Ghostscript programs. Graphviz takes the generated [[Output_formats#Graphviz|<code>.gv</code>]] files and creates the final files, such as <code>.gif</code>, <code>.png</code>, , <code>.ps</code>, (Ghostscript creates <code>.pdf</code>), etc.

====Graphviz Layout====

[[File:FamilyLinesGraph-Graphs-GraphvizLayout-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Layout - tab default options]]

*{{man label|Font family:}} Choose the font family. If international characters don't show, use '''FreeSans''' font. FreeSans is available from [http://www.nongnu.org/freefont/ the NonGNU org].
** '''Default'''
** PostScript/ Helvetica
** True Type/ FreeSans
*{{man label|Font size:}} (<code>14</code> default) The font size, in [https://wikipedia.org/wiki/Point_(typography) points].
*{{man label|Graph Direction:}} Whether the graph goes from top to bottom or left to right
** '''Vertical (top to bottom)''' (Default)
** Vertical (bottom to top)
** Horizontal (left to right)
** Horizontal (right to left)
*{{man label|Number of Horizontal Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array horizontally. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Number of Vertical Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array vertically. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Paging Direction:}} (''Bottom, left'' default) The order in which the graph pages are output. This option only applies if the horizontal pages or vertical pages are greater than 1.
*{{man label|Connecting lines:}} - How the lines between objects will be drawn. Choose from:
** ''Straight''
** '''Curved''' (Default)
** ''Orthogonal''
{{-}}

====Graphviz Options====

[[File:FamilyLinesGraph-Graphs-GraphvizOptions-tab-52.png|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Options - tab default options]]

* {{man label|Aspect Ratio:}} Affects greatly how the graph is laid out on the page. Specifically node spacing and scaling of the graph( see ''Advice 1:'').
** ''Compress to minimal minimal size''
** '''Fill the given area''' (default)
** ''Expand uniformly''
<hr>
'''Advice 1:'''

If the graph is smaller than the print area:
* ''Compress to minimal minimal size'' will not change the node spacing.
* ''Fill the given area'' will increase the node spacing to fit the print area in both width and height.
* ''Expand uniformly'' will increase the node spacing uniformly to preserve the aspect ratio.

If the graph is larger than the print area:
* ''Compress to minimal minimal size'' will shrink the graph to achieve tight packing at the expense of symmetry.
* ''Fill the given area'' will shrink the graph to fit the print area after first increasing the node spacing.
* ''Expand uniformly'' will shrink the graph uniformly to fit the print area.
<hr>

* {{man label|DPI:}} (<code>72</code> default) dots-per-inch. When creating PostScript or PDF, use 72 DPI. Typically between 75 and 120 if generating .png or .gif files, but 300 or 600 if generating files to be printed. When creating images such as .gif or .png files for the web, try numbers such as 100 or 300 DPI.
* {{man label|Node Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between individual nodes. For vertical graphs, this corresponds to spacing between columns. For horizontal graphs, this corresponds to spacing between rows.
* {{man label|Rank Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between ranks. For vertical graphs, this corresponds to spacing between rows. For horizontal graphs, this corresponds to spacing between columns.

====Note====
[[File:FamilyLinesGraph-Graphs-Note-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Note - tab default options]]

* {{man label|Note to add to the graph:}} (Empty by default) This text will be added to the graph
* {{man label|Note location:}} - Whether the note will appear on top or bottom of the page.
** '''Top''' (default)
** ''Bottom''
* {{man label|Note size:}} (<code>32</code> default) The size of note text, in [https://en.wikipedia.org/wiki/Point_(typography) points].
{{-}}

===Family Lines Graph===
{{man note|That Family Lines Graph does not display all of the people in the Family Tree.|Instead, this Graph report generates smaller family trees, with many options to try and restrict the number of people included.}}

[[File:Graphs-FamilyLinesGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - example output overview]]

The {{man label|Family Lines Graph}} works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants to generate the {{man label|Family Lines Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

A typical use of this report is to generate simplified graphs to be printed on ''large format printing plotters''.

To create a {{man label|Family Lines Graph}} from the menu select {{man menu|Reports ->Graphs -> Family Lines Graph...}} and then from the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#People_of_Interest|People of Interest]]}} tab click on the {{icon|stock_add}}(add) icon and select at least one person from the {{man label|Select Person}} selector dialog and the report will suggest if possible a second related person via the {{man label|Select Person - Also include <Person Name>}} warning dialog select {{man button|No}} or {{man button|Yes}} depending on what you decide and then select {{man button|OK}} to generate the report.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:FamilyLinesGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options - tab default options]]

* {{checkbox|1}} {{man label|Follow parents to determine "family lines"}} Parents and their ancestors will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Follow children to determine "family lines"}} Children will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Try to remove extra people and families}} People and families not directly related to people of interest will be removed when determining "family lines". (checkbox checked by default)
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Descendants <- Ancestors''' (default) - arrows point to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{man label|Rounded corners:}} to differentiate between women and men.
** '''None''' (default)
** ''Female''
** ''Male''
** ''Both''
* {{man label|Gramps ID:}} Whether (and where) to include Gramps IDs
** '''Do not include''' (default)
** ''Share an existing line''
** ''On a line of its own''
{{-}}

====Report Options (2)====
[[File:FamilyLinesGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD (ISO) (2024-11-15)''' (default for report)
** ''Numerical (15/11/2024)''
** ''Month Day, Year (March 14, 2018)''
** ''MON DAY, YEAR (Mar 14, 2018)''
** ''Day Month Year (14 March 2018)''
** ''DAY MON YEAR (14 Mar 2018)''
* {{checkbox|1}} {{man label|Use subgraphs}} (checkbox checked by default) - Subgraphs can help Grapviz position spouses together, but with non-trival graphs will result in longer lines and larger graphs.
{{-}}

====People of Interest====

[[File:FamilyLinesGraph-Graphs-PeopleOfInterest-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - People of Interest - tab default options]]

The graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.

* {{man label|People of interest:}} click on {{icon|stock_add}} and {{icon|stock_remove}} to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
* {{checkbox|0}} {{man label|Limit the number of ancestors}} (checkbox unchecked by default) Whether to limit the number of ancestors.
** <code>50</code> default. The maximum number of ancestors to include. The maximum is for the total number of people, not generations to be displayed on the chart.
* {{checkbox|0}} {{man label|Limit the number of descendants}} (checkbox unchecked by default) Whether to limit the number of descendants.
** <code>50</code> default. The maximum number of descendants to include. The maximum is for the total number of people, not generations to be displayed on the chart.
{{-}}
=====Select Person - Also include <Person Name> warning dialog=====

Select Person - Also include <Person Name> warning dialog
{{stub}}
{{-}}

====Include====

[[File:FamilyLinesGraph-Graphs-Include-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Include - tab default options]]

* {{checkbox|1}} {{man label|Include dates}}: date of birth, date of death, and marriage dates will be included in the graph when this is selected. (checkbox checked by default)
* {{checkbox|0}} {{man label|Limit dates to years only}}: from the above only show the years.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include places}}: place of birth, place of death, and place of marriage will be included in the graph when this is selected.(checkbox checked by default)
* {{checkbox|1}} {{man label|Include the number of children}}: marriage text will include the total number of children when this is selected.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include thumbnail images of people}} (checkbox checked by default)
* {{man label|Thumbnail location:}}
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Thumbnail size:}}
** '''Normal''' (default)
** ''Large''
{{-}}

====Family Colors====

[[File:FamilyLinesGraph-Graphs-FamilyColors-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Family Colors - tab default options]]

* {{man label|Family colors:}} Select the color to use for people with a specific surname. Two columns are available: ''Surname'' and ''Color''. Click on {{icon|stock_add}} or {{icon|stock_remove}} to add a surname from the {{man label|Select surname}} window, select a surname and press {{man button|OK}}. To edit the surname color double-click on a surname and from the {{man label|Select color for [Surname Selected]}} window choose from the shown colors and then select {{man button|Select}}.
{{-}}

====Individuals====

[[File:FamilyLinesGraph-Graphs-Individuals-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Individuals - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use to display men.
* {{man label|Females:}} the color to use to display women.
* {{man label|Other:}} the color to use to display people who neither men nor women.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use to display families. (marriages).
{{-}}

===Hourglass Graph===

[[File:Graphs-HourglassGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - example output overview]]

Generate an {{man label|Hourglass Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]]. Go to {{man menu|Reports -> Graph -> Hourglass Graph...}}.

The hourglass graph chart shows the {{man label|Center Person:}}s ancestors above them and descendants below them. The hourglass graph does not show siblings of the ancestors but it does include all the descendants below them including any spouses.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====

[[File:HourglassGraph-Graphs-ReportOptions-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options - tab default options]]

* {{man label|Center Person:}} the center person for the report, defaults to the current active person.
** {{man button|Select a different person}} button. - Change the center person.
* {{man label|Max Descendant Generations:}} default <code>10</code>
* {{man label|Max Ancestor Generations:}} default <code>10</code>
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Centre -> Others''' (default) - arrows point to the Other.
** ''Centre <- Others'' - arrows point to the Centre.
** ''Centre <-> Others'' - arrows point to both.
** ''Centre - Others'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} to differentiate between women and men (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' (default)
** ''include''
{{-}}

====Report Options (2)====
[[File:HourglassGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name format:}} - Select the format to display the names. This choice in normally taken from the default setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** Surname, Given Suffix
** Given Surname Suffix
** Given
** Main Surnames, Given Patronymic Suffix
** SURNAME, Given (Common)
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2018-03-14)''' (default for report)
** Numerical(14/3/2018)
** Month Day, Year(March 14, 2018)
** MON DAY, YEAR(Mar 14, 2018)
** Day Month Year(14 March 2018)
** DAY MON YEAR(14 Mar 2018)
{{-}}

====Graph Style====

[[File:HourglassGraph-Graphs-GraphStyle-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use for males.
* {{man label|Females:}} the color to use for females.
* {{man label|Other:}} the color to use for Others.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use for families (weddings).
{{checkbox|0}} {{man label| Force [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] order}} - Force Sosa / Sosa-Stradonitz / Ahnentafel layout order for all ancestors, so that fathers are always on the left branch and mothers are on the right branch.
{{checkbox|0}} {{man label| [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] number visible}} - Show Sosa / Sosa-Stradonitz / Ahnentafel number.
{{checkbox|0}} {{man label| Show symbols for events}} - Show genealogical symbols for birth, marriage and death events.
{{-}}

===Relationship Graph===

[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

The {{man label|Relationship Graph}} creates a complex relationship graph using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

Via the menu: {{man menu|Reports-> Graphs- >Relationship Graph...}}. You will be presented with a {{man label|Relationship Graph}} window where you can change all the settings.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:RelationshipGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options - tab default options]]

* {{man label|Filter:}} - Select the filter to be applied to the report. Choose from:
** '''Entire Database''' (Default) ({{man menu|'''Not recommended!'''}})
** ''Descendants of active person''
** ''Descendant families of active person''
** ''Ancestors of active person''
** ''People with common ancestor with active person''
** ''Any custom made filter you have created will be listed below the other choices.''
* {{man label|Centre Person:}} The center person for the filter. Defaults to the Active Person. If you use a custom filter, no Person can be chosen.
** {{man button|Select a different person}} button. - Change the Centre person.
* {{man label|Arrowhead direction}}: Choose the direction that the arrows point:
** '''Descendants <- Ancestors'''(default) - arrows point to the to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph colouring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Coloured outline''
** '''Colour fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} Use rounded corners to differentiate between women and men (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Use hexagons}} (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' default
** ''include''
{{-}}

====Report Options (2)====
[[File:RelationshipGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code> (default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2024-11-15)''' (default for report)
** ''Numerical(15/11/2014)''
** ''Month Day, Year(November 15, 2024)''
** ''MON DAY, YEAR(Nov 15, 2024)''
** ''Day Month Year(15 November 2024)''
** ''DAY MON YEAR(15 Nov 2024)''
{{-}}

====Include====

[[File:RelationshipGraph-Graphs-Include-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Include - tab default options]]

* {{man label|Dates and/or Places:}} - Whether to include dates and/or places
** '''Do not include any dates or places''' (default)
** ''Include (birth, marriage, death) dates, but no places''
** ''Include (birth, marriage, death) dates, and place''
** ''Include (birth, marriage, death) dates, and place if no dates''
** ''Include (birth, marriage, death) years, but no places''
** ''Include (birth, marriage, death) years, and places''
** ''Include (birth, marriage, death) places, but no date''s
** ''Include (birth, marriage, death) dates and places on same line''
* {{checkbox|1}} {{man label|Show all family nodes}} Show family nodes even if the output contains only one member of the family. (checkbox checked by default)
* {{checkbox|0}} {{man label|Include URLs}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include relationship to center person}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include thumbnail images of people}} (checkbox unchecked by default)
* {{man label|Thumbnail location:}} Where the thumbnail image should appear relative to the name
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Include occupation:}} Whether to include the last occupation
** '''Do not include any occupation''' (default)
** ''Include description of most recent occupation''
** ''Include date, description and place of all occupations''
* {{checkbox|0}} {{man label|Include relationship debugging numbers also}} Whether to include 'Ga' and 'Gb' also, to debug the relationship calculator (checkbox unchecked by default)
{{-}}

====Graph Style====

[[File:RelationshipGraph-Graphs-GraphStyle-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
* {{checkbox|1}} {{man label|Indicate non-birth relationships with dotted lines}} (checkbox checked by default) - Shows adopted relationships.
* {{checkbox|1}} {{man label|Show family nodes}} (checkbox checked by default)
* {{man label|Parent grouping:}} Decides the location of the parents in the graph.
** '''Normal''' (default)
** ''Parents together''
** ''Parents offset''
{{-}}

====Example relationship graph====
[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.
# First check that this person is the ''active person''. (You change this later but this is handier)
# Go via the menu {{man menu|Reports->Graphs->Relationship Graph...}}
# Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
# Report Options: filter: Descendant Families of..., Color fill, Use rounded corners
# Graph Style : Show Family Nodes
# Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
# Graphviz Options: Fill given area dpi 133
# Note : we add title on the top size: 18 pts
# Output Format: we want a JPEG file.

The results are similar to the image shown in Fig. {{#var:chapter}}.{{#var:figure}}.
{{-}}
See also:
* A detailed tutorial [[Howto:_Make_a_relationship_chart|How to make a relationship chart]]
{{-}}
<hr>
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Reports - part 5}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Reports - part 5

2025-12-06T04:34:36Z

CallMeDave: /* Report Options */

{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Reports - part 5}}
{{#vardefine:chapter|13.5}}
{{#vardefine:figure|0}}
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
<hr>
{{-}}
[[File:MenuOverview-Reports-Graphs-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man menu|Reports >Graphs>...}} Menu overview]]
This section describes the different {{man label|Graphs}} (aka Graph Reports) available in Gramps.
==Graphs==
{{man tip|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|Prerequisites for Graph Reports]]|These reports are created using the [[Output_formats#Graphviz|GraphViz]] program. Therefore, it is important that the '''Graphviz''' program is installed on your computer.}}
{{man warn|Reports and custom IDs|After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on {{man menu|Edit --> Preferences}} on the {{man label|ID Formats}} tab). If generated reports do not properly display data, then try [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs tool]] {{man menu|Tools-->Family Tree Processing-->Reorder Gramps IDs...}}}}

All three graph reports: [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines]], [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Hourglass_Graph|Hourglass]], and [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship]] Graphs share common options: {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Layout|Graphviz Layout]]}}, {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Options|Graphviz Options]]}}, and {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Note|Note]]}}.

Also they share common options with the other reports [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Common_options|common options]]: {{man label|Paper Options}} and {{man label|Document Options}}.

===Prerequisites for Graph Reports===
Requires the installation of the [[Output_formats#Graphviz|GraphViz]] program and Ghostscript program that is used by Graphviz reports to help create PDF files.

* On Linux, use your package manager.
* On Microsoft Windows use the Gramps AIO as they are already part of the installer.
* On Apple macOS use the Gramps .dmg as they are already part of the installer.

===Common Options===

There are also several [[Output_formats#Graphviz|GraphViz]] specific options related to pagination, color, and details of the graph.

This plugin uses the Graphviz graph visualization and Ghostscript programs. Graphviz takes the generated [[Output_formats#Graphviz|<code>.gv</code>]] files and creates the final files, such as <code>.gif</code>, <code>.png</code>, , <code>.ps</code>, (Ghostscript creates <code>.pdf</code>), etc.

====Graphviz Layout====

[[File:FamilyLinesGraph-Graphs-GraphvizLayout-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Layout - tab default options]]

*{{man label|Font family:}} Choose the font family. If international characters don't show, use '''FreeSans''' font. FreeSans is available from [http://www.nongnu.org/freefont/ the NonGNU org].
** '''Default'''
** PostScript/ Helvetica
** True Type/ FreeSans
*{{man label|Font size:}} (<code>14</code> default) The font size, in [https://wikipedia.org/wiki/Point_(typography) points].
*{{man label|Graph Direction:}} Whether the graph goes from top to bottom or left to right
** '''Vertical (top to bottom)''' (Default)
** Vertical (bottom to top)
** Horizontal (left to right)
** Horizontal (right to left)
*{{man label|Number of Horizontal Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array horizontally. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Number of Vertical Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array vertically. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Paging Direction:}} (''Bottom, left'' default) The order in which the graph pages are output. This option only applies if the horizontal pages or vertical pages are greater than 1.
*{{man label|Connecting lines:}} - How the lines between objects will be drawn. Choose from:
** ''Straight''
** '''Curved''' (Default)
** ''Orthogonal''
{{-}}

====Graphviz Options====

[[File:FamilyLinesGraph-Graphs-GraphvizOptions-tab-52.png|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Options - tab default options]]

* {{man label|Aspect Ratio:}} Affects greatly how the graph is laid out on the page. Specifically node spacing and scaling of the graph( see ''Advice 1:'').
** ''Compress to minimal minimal size''
** '''Fill the given area''' (default)
** ''Expand uniformly''
<hr>
'''Advice 1:'''

If the graph is smaller than the print area:
* ''Compress to minimal minimal size'' will not change the node spacing.
* ''Fill the given area'' will increase the node spacing to fit the print area in both width and height.
* ''Expand uniformly'' will increase the node spacing uniformly to preserve the aspect ratio.

If the graph is larger than the print area:
* ''Compress to minimal minimal size'' will shrink the graph to achieve tight packing at the expense of symmetry.
* ''Fill the given area'' will shrink the graph to fit the print area after first increasing the node spacing.
* ''Expand uniformly'' will shrink the graph uniformly to fit the print area.
<hr>

* {{man label|DPI:}} (<code>72</code> default) dots-per-inch. When creating PostScript or PDF, use 72 DPI. Typically between 75 and 120 if generating .png or .gif files, but 300 or 600 if generating files to be printed. When creating images such as .gif or .png files for the web, try numbers such as 100 or 300 DPI.
* {{man label|Node Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between individual nodes. For vertical graphs, this corresponds to spacing between columns. For horizontal graphs, this corresponds to spacing between rows.
* {{man label|Rank Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between ranks. For vertical graphs, this corresponds to spacing between rows. For horizontal graphs, this corresponds to spacing between columns.

====Note====
[[File:FamilyLinesGraph-Graphs-Note-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Note - tab default options]]

* {{man label|Note to add to the graph:}} (Empty by default) This text will be added to the graph
* {{man label|Note location:}} - Whether the note will appear on top or bottom of the page.
** '''Top''' (default)
** ''Bottom''
* {{man label|Note size:}} (<code>32</code> default) The size of note text, in [https://en.wikipedia.org/wiki/Point_(typography) points].
{{-}}

===Family Lines Graph===
{{man note|That Family Lines Graph does not display all of the people in the Family Tree.|Instead, this Graph report generates smaller family trees, with many options to try and restrict the number of people included.}}

[[File:Graphs-FamilyLinesGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - example output overview]]

The {{man label|Family Lines Graph}} works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants to generate the {{man label|Family Lines Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

A typical use of this report is to generate simplified graphs to be printed on ''large format printing plotters''.

To create a {{man label|Family Lines Graph}} from the menu select {{man menu|Reports ->Graphs -> Family Lines Graph...}} and then from the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#People_of_Interest|People of Interest]]}} tab click on the {{icon|stock_add}}(add) icon and select at least one person from the {{man label|Select Person}} selector dialog and the report will suggest if possible a second related person via the {{man label|Select Person - Also include <Person Name>}} warning dialog select {{man button|No}} or {{man button|Yes}} depending on what you decide and then select {{man button|OK}} to generate the report.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:FamilyLinesGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options - tab default options]]

* {{checkbox|1}} {{man label|Follow parents to determine "family lines"}} Parents and their ancestors will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Follow children to determine "family lines"}} Children will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Try to remove extra people and families}} People and families not directly related to people of interest will be removed when determining "family lines". (checkbox checked by default)
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Descendants <- Ancestors''' (default) - arrows point to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{man label|Rounded corners:}} to differentiate between women and men.
** '''None''' (default)
** ''Female''
** ''Male''
** ''Both''
* {{man label|Gramps ID:}} Whether (and where) to include Gramps IDs
** '''Do not include''' (default)
** ''Share an existing line''
** ''On a line of its own''
{{-}}

====Report Options (2)====
[[File:FamilyLinesGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD (ISO) (2024-11-15)''' (default for report)
** ''Numerical (15/11/2024)''
** ''Month Day, Year (March 14, 2018)''
** ''MON DAY, YEAR (Mar 14, 2018)''
** ''Day Month Year (14 March 2018)''
** ''DAY MON YEAR (14 Mar 2018)''
* {{checkbox|1}} {{man label|Use subgraphs}} (checkbox checked by default) - Subgraphs can help Grapviz position spouses together, but with non-trival graphs will result in longer lines and larger graphs.
{{-}}

====People of Interest====

[[File:FamilyLinesGraph-Graphs-PeopleOfInterest-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - People of Interest - tab default options]]

The graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.

* {{man label|People of interest:}} click on {{icon|stock_add}} and {{icon|stock_remove}} to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
* {{checkbox|0}} {{man label|Limit the number of ancestors}} (checkbox unchecked by default) Whether to limit the number of ancestors.
** <code>50</code> default. The maximum number of ancestors to include. The maximum is for the total number of people, not generations to be displayed on the chart.
* {{checkbox|0}} {{man label|Limit the number of descendants}} (checkbox unchecked by default) Whether to limit the number of descendants.
** <code>50</code> default. The maximum number of descendants to include. The maximum is for the total number of people, not generations to be displayed on the chart.
{{-}}
=====Select Person - Also include <Person Name> warning dialog=====

Select Person - Also include <Person Name> warning dialog
{{stub}}
{{-}}

====Include====

[[File:FamilyLinesGraph-Graphs-Include-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Include - tab default options]]

* {{checkbox|1}} {{man label|Include dates}}: date of birth, date of death, and marriage dates will be included in the graph when this is selected. (checkbox checked by default)
* {{checkbox|0}} {{man label|Limit dates to years only}}: from the above only show the years.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include places}}: place of birth, place of death, and place of marriage will be included in the graph when this is selected.(checkbox checked by default)
* {{checkbox|1}} {{man label|Include the number of children}}: marriage text will include the total number of children when this is selected.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include thumbnail images of people}} (checkbox checked by default)
* {{man label|Thumbnail location:}}
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Thumbnail size:}}
** '''Normal''' (default)
** ''Large''
{{-}}

====Family Colors====

[[File:FamilyLinesGraph-Graphs-FamilyColors-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Family Colors - tab default options]]

* {{man label|Family colors:}} Select the color to use for people with a specific surname. Two columns are available: ''Surname'' and ''Color''. Click on {{icon|stock_add}} or {{icon|stock_remove}} to add a surname from the {{man label|Select surname}} window, select a surname and press {{man button|OK}}. To edit the surname color double-click on a surname and from the {{man label|Select color for [Surname Selected]}} window choose from the shown colors and then select {{man button|Select}}.
{{-}}

====Individuals====

[[File:FamilyLinesGraph-Graphs-Individuals-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Individuals - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use to display men.
* {{man label|Females:}} the color to use to display women.
* {{man label|Other:}} the color to use to display people who neither men nor women.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use to display families. (marriages).
{{-}}

===Hourglass Graph===

[[File:Graphs-HourglassGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - example output overview]]

Generate an {{man label|Hourglass Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]]. Go to {{man menu|Reports -> Graph -> Hourglass Graph...}}.

The hourglass graph chart shows the {{man label|Center Person:}}s ancestors above them and descendants below them. The hourglass graph does not show siblings of the ancestors but it does include all the descendants below them including any spouses.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====

[[File:HourglassGraph-Graphs-ReportOptions-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options - tab default options]]

* {{man label|Center Person:}} the center person for the report, defaults to the current active person.
** {{man button|Select a different person}} button. - Change the center person.
* {{man label|Max Descendant Generations:}} default <code>10</code>
* {{man label|Max Ancestor Generations:}} default <code>10</code>
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Centre -> Others''' (default) - arrows point to the Other.
** ''Centre <- Others'' - arrows point to the Centre.
** ''Centre <-> Others'' - arrows point to both.
** ''Centre - Others'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} to differentiate between women and men (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' (default)
** ''include''
{{-}}

====Report Options (2)====
[[File:HourglassGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name format:}} - Select the format to display the names. This choice in normally taken from the default setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** Surname, Given Suffix
** Given Surname Suffix
** Given
** Main Surnames, Given Patronymic Suffix
** SURNAME, Given (Common)
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2018-03-14)''' (default for report)
** Numerical(14/3/2018)
** Month Day, Year(March 14, 2018)
** MON DAY, YEAR(Mar 14, 2018)
** Day Month Year(14 March 2018)
** DAY MON YEAR(14 Mar 2018)
{{-}}

====Graph Style====

[[File:HourglassGraph-Graphs-GraphStyle-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for Others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
{{checkbox|0}} {{man label| Force [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] order}} - Force Sosa / Sosa-Stradonitz / Ahnentafel layout order for all ancestors, so that fathers are always on the left branch and mothers are on the right branch.
{{checkbox|0}} {{man label| [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] number visible}} - Show Sosa / Sosa-Stradonitz / Ahnentafel number.
{{checkbox|0}} {{man label| Show symbols for events}} - Show genealogical symbols for birth, marriage and death events.
{{-}}

===Relationship Graph===

[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

The {{man label|Relationship Graph}} creates a complex relationship graph using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

Via the menu: {{man menu|Reports-> Graphs- >Relationship Graph...}}. You will be presented with a {{man label|Relationship Graph}} window where you can change all the settings.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:RelationshipGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options - tab default options]]

* {{man label|Filter:}} - Select the filter to be applied to the report. Choose from:
** '''Entire Database''' (Default) ({{man menu|'''Not recommended!'''}})
** ''Descendants of active person''
** ''Descendant families of active person''
** ''Ancestors of active person''
** ''People with common ancestor with active person''
** ''Any custom made filter you have created will be listed below the other choices.''
* {{man label|Centre Person:}} The center person for the filter. Defaults to the Active Person. If you use a custom filter, no Person can be chosen.
** {{man button|Select a different person}} button. - Change the Centre person.
* {{man label|Arrowhead direction}}: Choose the direction that the arrows point:
** '''Descendants <- Ancestors'''(default) - arrows point to the to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph colouring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Coloured outline''
** '''Colour fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} Use rounded corners to differentiate between women and men (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Use hexagons}} (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' default
** ''include''
{{-}}

====Report Options (2)====
[[File:RelationshipGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code> (default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2024-11-15)''' (default for report)
** ''Numerical(15/11/2014)''
** ''Month Day, Year(November 15, 2024)''
** ''MON DAY, YEAR(Nov 15, 2024)''
** ''Day Month Year(15 November 2024)''
** ''DAY MON YEAR(15 Nov 2024)''
{{-}}

====Include====

[[File:RelationshipGraph-Graphs-Include-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Include - tab default options]]

* {{man label|Dates and/or Places:}} - Whether to include dates and/or places
** '''Do not include any dates or places''' (default)
** ''Include (birth, marriage, death) dates, but no places''
** ''Include (birth, marriage, death) dates, and place''
** ''Include (birth, marriage, death) dates, and place if no dates''
** ''Include (birth, marriage, death) years, but no places''
** ''Include (birth, marriage, death) years, and places''
** ''Include (birth, marriage, death) places, but no date''s
** ''Include (birth, marriage, death) dates and places on same line''
* {{checkbox|1}} {{man label|Show all family nodes}} Show family nodes even if the output contains only one member of the family. (checkbox checked by default)
* {{checkbox|0}} {{man label|Include URLs}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include relationship to center person}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include thumbnail images of people}} (checkbox unchecked by default)
* {{man label|Thumbnail location:}} Where the thumbnail image should appear relative to the name
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Include occupation:}} Whether to include the last occupation
** '''Do not include any occupation''' (default)
** ''Include description of most recent occupation''
** ''Include date, description and place of all occupations''
* {{checkbox|0}} {{man label|Include relationship debugging numbers also}} Whether to include 'Ga' and 'Gb' also, to debug the relationship calculator (checkbox unchecked by default)
{{-}}

====Graph Style====

[[File:RelationshipGraph-Graphs-GraphStyle-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
* {{checkbox|1}} {{man label|Indicate non-birth relationships with dotted lines}} (checkbox checked by default) - Shows adopted relationships.
* {{checkbox|1}} {{man label|Show family nodes}} (checkbox checked by default)
* {{man label|Parent grouping:}} Decides the location of the parents in the graph.
** '''Normal''' (default)
** ''Parents together''
** ''Parents offset''
{{-}}

====Example relationship graph====
[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.
# First check that this person is the ''active person''. (You change this later but this is handier)
# Go via the menu {{man menu|Reports->Graphs->Relationship Graph...}}
# Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
# Report Options: filter: Descendant Families of..., Color fill, Use rounded corners
# Graph Style : Show Family Nodes
# Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
# Graphviz Options: Fill given area dpi 133
# Note : we add title on the top size: 18 pts
# Output Format: we want a JPEG file.

The results are similar to the image shown in Fig. {{#var:chapter}}.{{#var:figure}}.
{{-}}
See also:
* A detailed tutorial [[Howto:_Make_a_relationship_chart|How to make a relationship chart]]
{{-}}
<hr>
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Reports - part 5}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Reports - part 5

2025-12-06T04:34:18Z

CallMeDave: /* Individuals */

{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Reports - part 5}}
{{#vardefine:chapter|13.5}}
{{#vardefine:figure|0}}
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
<hr>
{{-}}
[[File:MenuOverview-Reports-Graphs-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man menu|Reports >Graphs>...}} Menu overview]]
This section describes the different {{man label|Graphs}} (aka Graph Reports) available in Gramps.
==Graphs==
{{man tip|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|Prerequisites for Graph Reports]]|These reports are created using the [[Output_formats#Graphviz|GraphViz]] program. Therefore, it is important that the '''Graphviz''' program is installed on your computer.}}
{{man warn|Reports and custom IDs|After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on {{man menu|Edit --> Preferences}} on the {{man label|ID Formats}} tab). If generated reports do not properly display data, then try [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs tool]] {{man menu|Tools-->Family Tree Processing-->Reorder Gramps IDs...}}}}

All three graph reports: [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines]], [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Hourglass_Graph|Hourglass]], and [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship]] Graphs share common options: {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Layout|Graphviz Layout]]}}, {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Options|Graphviz Options]]}}, and {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Note|Note]]}}.

Also they share common options with the other reports [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Common_options|common options]]: {{man label|Paper Options}} and {{man label|Document Options}}.

===Prerequisites for Graph Reports===
Requires the installation of the [[Output_formats#Graphviz|GraphViz]] program and Ghostscript program that is used by Graphviz reports to help create PDF files.

* On Linux, use your package manager.
* On Microsoft Windows use the Gramps AIO as they are already part of the installer.
* On Apple macOS use the Gramps .dmg as they are already part of the installer.

===Common Options===

There are also several [[Output_formats#Graphviz|GraphViz]] specific options related to pagination, color, and details of the graph.

This plugin uses the Graphviz graph visualization and Ghostscript programs. Graphviz takes the generated [[Output_formats#Graphviz|<code>.gv</code>]] files and creates the final files, such as <code>.gif</code>, <code>.png</code>, , <code>.ps</code>, (Ghostscript creates <code>.pdf</code>), etc.

====Graphviz Layout====

[[File:FamilyLinesGraph-Graphs-GraphvizLayout-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Layout - tab default options]]

*{{man label|Font family:}} Choose the font family. If international characters don't show, use '''FreeSans''' font. FreeSans is available from [http://www.nongnu.org/freefont/ the NonGNU org].
** '''Default'''
** PostScript/ Helvetica
** True Type/ FreeSans
*{{man label|Font size:}} (<code>14</code> default) The font size, in [https://wikipedia.org/wiki/Point_(typography) points].
*{{man label|Graph Direction:}} Whether the graph goes from top to bottom or left to right
** '''Vertical (top to bottom)''' (Default)
** Vertical (bottom to top)
** Horizontal (left to right)
** Horizontal (right to left)
*{{man label|Number of Horizontal Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array horizontally. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Number of Vertical Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array vertically. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Paging Direction:}} (''Bottom, left'' default) The order in which the graph pages are output. This option only applies if the horizontal pages or vertical pages are greater than 1.
*{{man label|Connecting lines:}} - How the lines between objects will be drawn. Choose from:
** ''Straight''
** '''Curved''' (Default)
** ''Orthogonal''
{{-}}

====Graphviz Options====

[[File:FamilyLinesGraph-Graphs-GraphvizOptions-tab-52.png|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Options - tab default options]]

* {{man label|Aspect Ratio:}} Affects greatly how the graph is laid out on the page. Specifically node spacing and scaling of the graph( see ''Advice 1:'').
** ''Compress to minimal minimal size''
** '''Fill the given area''' (default)
** ''Expand uniformly''
<hr>
'''Advice 1:'''

If the graph is smaller than the print area:
* ''Compress to minimal minimal size'' will not change the node spacing.
* ''Fill the given area'' will increase the node spacing to fit the print area in both width and height.
* ''Expand uniformly'' will increase the node spacing uniformly to preserve the aspect ratio.

If the graph is larger than the print area:
* ''Compress to minimal minimal size'' will shrink the graph to achieve tight packing at the expense of symmetry.
* ''Fill the given area'' will shrink the graph to fit the print area after first increasing the node spacing.
* ''Expand uniformly'' will shrink the graph uniformly to fit the print area.
<hr>

* {{man label|DPI:}} (<code>72</code> default) dots-per-inch. When creating PostScript or PDF, use 72 DPI. Typically between 75 and 120 if generating .png or .gif files, but 300 or 600 if generating files to be printed. When creating images such as .gif or .png files for the web, try numbers such as 100 or 300 DPI.
* {{man label|Node Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between individual nodes. For vertical graphs, this corresponds to spacing between columns. For horizontal graphs, this corresponds to spacing between rows.
* {{man label|Rank Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between ranks. For vertical graphs, this corresponds to spacing between rows. For horizontal graphs, this corresponds to spacing between columns.

====Note====
[[File:FamilyLinesGraph-Graphs-Note-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Note - tab default options]]

* {{man label|Note to add to the graph:}} (Empty by default) This text will be added to the graph
* {{man label|Note location:}} - Whether the note will appear on top or bottom of the page.
** '''Top''' (default)
** ''Bottom''
* {{man label|Note size:}} (<code>32</code> default) The size of note text, in [https://en.wikipedia.org/wiki/Point_(typography) points].
{{-}}

===Family Lines Graph===
{{man note|That Family Lines Graph does not display all of the people in the Family Tree.|Instead, this Graph report generates smaller family trees, with many options to try and restrict the number of people included.}}

[[File:Graphs-FamilyLinesGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - example output overview]]

The {{man label|Family Lines Graph}} works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants to generate the {{man label|Family Lines Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

A typical use of this report is to generate simplified graphs to be printed on ''large format printing plotters''.

To create a {{man label|Family Lines Graph}} from the menu select {{man menu|Reports ->Graphs -> Family Lines Graph...}} and then from the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#People_of_Interest|People of Interest]]}} tab click on the {{icon|stock_add}}(add) icon and select at least one person from the {{man label|Select Person}} selector dialog and the report will suggest if possible a second related person via the {{man label|Select Person - Also include <Person Name>}} warning dialog select {{man button|No}} or {{man button|Yes}} depending on what you decide and then select {{man button|OK}} to generate the report.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:FamilyLinesGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options - tab default options]]

* {{checkbox|1}} {{man label|Follow parents to determine "family lines"}} Parents and their ancestors will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Follow children to determine "family lines"}} Children will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Try to remove extra people and families}} People and families not directly related to people of interest will be removed when determining "family lines". (checkbox checked by default)
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Descendants <- Ancestors''' (default) - arrows point to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{man label|Rounded corners:}} to differentiate between women and men.
** '''None''' (default)
** ''Female''
** ''Male''
** ''Both''
* {{man label|Gramps ID:}} Whether (and where) to include Gramps IDs
** '''Do not include''' (default)
** ''Share an existing line''
** ''On a line of its own''
{{-}}

====Report Options (2)====
[[File:FamilyLinesGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD (ISO) (2024-11-15)''' (default for report)
** ''Numerical (15/11/2024)''
** ''Month Day, Year (March 14, 2018)''
** ''MON DAY, YEAR (Mar 14, 2018)''
** ''Day Month Year (14 March 2018)''
** ''DAY MON YEAR (14 Mar 2018)''
* {{checkbox|1}} {{man label|Use subgraphs}} (checkbox checked by default) - Subgraphs can help Grapviz position spouses together, but with non-trival graphs will result in longer lines and larger graphs.
{{-}}

====People of Interest====

[[File:FamilyLinesGraph-Graphs-PeopleOfInterest-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - People of Interest - tab default options]]

The graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.

* {{man label|People of interest:}} click on {{icon|stock_add}} and {{icon|stock_remove}} to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
* {{checkbox|0}} {{man label|Limit the number of ancestors}} (checkbox unchecked by default) Whether to limit the number of ancestors.
** <code>50</code> default. The maximum number of ancestors to include. The maximum is for the total number of people, not generations to be displayed on the chart.
* {{checkbox|0}} {{man label|Limit the number of descendants}} (checkbox unchecked by default) Whether to limit the number of descendants.
** <code>50</code> default. The maximum number of descendants to include. The maximum is for the total number of people, not generations to be displayed on the chart.
{{-}}
=====Select Person - Also include <Person Name> warning dialog=====

Select Person - Also include <Person Name> warning dialog
{{stub}}
{{-}}

====Include====

[[File:FamilyLinesGraph-Graphs-Include-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Include - tab default options]]

* {{checkbox|1}} {{man label|Include dates}}: date of birth, date of death, and marriage dates will be included in the graph when this is selected. (checkbox checked by default)
* {{checkbox|0}} {{man label|Limit dates to years only}}: from the above only show the years.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include places}}: place of birth, place of death, and place of marriage will be included in the graph when this is selected.(checkbox checked by default)
* {{checkbox|1}} {{man label|Include the number of children}}: marriage text will include the total number of children when this is selected.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include thumbnail images of people}} (checkbox checked by default)
* {{man label|Thumbnail location:}}
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Thumbnail size:}}
** '''Normal''' (default)
** ''Large''
{{-}}

====Family Colors====

[[File:FamilyLinesGraph-Graphs-FamilyColors-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Family Colors - tab default options]]

* {{man label|Family colors:}} Select the color to use for people with a specific surname. Two columns are available: ''Surname'' and ''Color''. Click on {{icon|stock_add}} or {{icon|stock_remove}} to add a surname from the {{man label|Select surname}} window, select a surname and press {{man button|OK}}. To edit the surname color double-click on a surname and from the {{man label|Select color for [Surname Selected]}} window choose from the shown colors and then select {{man button|Select}}.
{{-}}

====Individuals====

[[File:FamilyLinesGraph-Graphs-Individuals-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Individuals - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the color to use to display men.
* {{man label|Females:}} the color to use to display women.
* {{man label|Other:}} the color to use to display people who neither men nor women.
* {{man label|Unknown:}} the color to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colors" tab.)
* {{man label|Families:}} the color to use to display families. (marriages).
{{-}}

===Hourglass Graph===

[[File:Graphs-HourglassGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - example output overview]]

Generate an {{man label|Hourglass Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]]. Go to {{man menu|Reports -> Graph -> Hourglass Graph...}}.

The hourglass graph chart shows the {{man label|Center Person:}}s ancestors above them and descendants below them. The hourglass graph does not show siblings of the ancestors but it does include all the descendants below them including any spouses.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====

[[File:HourglassGraph-Graphs-ReportOptions-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options - tab default options]]

* {{man label|Center Person:}} the center person for the report, defaults to the current active person.
** {{man button|Select a different person}} button. - Change the center person.
* {{man label|Max Descendant Generations:}} default <code>10</code>
* {{man label|Max Ancestor Generations:}} default <code>10</code>
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Centre -> Others''' (default) - arrows point to the Other.
** ''Centre <- Others'' - arrows point to the Centre.
** ''Centre <-> Others'' - arrows point to both.
** ''Centre - Others'' - None (no arrows are shown)
* {{man label|Graph colouring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Coloured outline''
** '''Colour fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} to differentiate between women and men (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' (default)
** ''include''
{{-}}

====Report Options (2)====
[[File:HourglassGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name format:}} - Select the format to display the names. This choice in normally taken from the default setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** Surname, Given Suffix
** Given Surname Suffix
** Given
** Main Surnames, Given Patronymic Suffix
** SURNAME, Given (Common)
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2018-03-14)''' (default for report)
** Numerical(14/3/2018)
** Month Day, Year(March 14, 2018)
** MON DAY, YEAR(Mar 14, 2018)
** Day Month Year(14 March 2018)
** DAY MON YEAR(14 Mar 2018)
{{-}}

====Graph Style====

[[File:HourglassGraph-Graphs-GraphStyle-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for Others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
{{checkbox|0}} {{man label| Force [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] order}} - Force Sosa / Sosa-Stradonitz / Ahnentafel layout order for all ancestors, so that fathers are always on the left branch and mothers are on the right branch.
{{checkbox|0}} {{man label| [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] number visible}} - Show Sosa / Sosa-Stradonitz / Ahnentafel number.
{{checkbox|0}} {{man label| Show symbols for events}} - Show genealogical symbols for birth, marriage and death events.
{{-}}

===Relationship Graph===

[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

The {{man label|Relationship Graph}} creates a complex relationship graph using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

Via the menu: {{man menu|Reports-> Graphs- >Relationship Graph...}}. You will be presented with a {{man label|Relationship Graph}} window where you can change all the settings.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:RelationshipGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options - tab default options]]

* {{man label|Filter:}} - Select the filter to be applied to the report. Choose from:
** '''Entire Database''' (Default) ({{man menu|'''Not recommended!'''}})
** ''Descendants of active person''
** ''Descendant families of active person''
** ''Ancestors of active person''
** ''People with common ancestor with active person''
** ''Any custom made filter you have created will be listed below the other choices.''
* {{man label|Centre Person:}} The center person for the filter. Defaults to the Active Person. If you use a custom filter, no Person can be chosen.
** {{man button|Select a different person}} button. - Change the Centre person.
* {{man label|Arrowhead direction}}: Choose the direction that the arrows point:
** '''Descendants <- Ancestors'''(default) - arrows point to the to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph colouring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Coloured outline''
** '''Colour fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} Use rounded corners to differentiate between women and men (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Use hexagons}} (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' default
** ''include''
{{-}}

====Report Options (2)====
[[File:RelationshipGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code> (default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2024-11-15)''' (default for report)
** ''Numerical(15/11/2014)''
** ''Month Day, Year(November 15, 2024)''
** ''MON DAY, YEAR(Nov 15, 2024)''
** ''Day Month Year(15 November 2024)''
** ''DAY MON YEAR(15 Nov 2024)''
{{-}}

====Include====

[[File:RelationshipGraph-Graphs-Include-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Include - tab default options]]

* {{man label|Dates and/or Places:}} - Whether to include dates and/or places
** '''Do not include any dates or places''' (default)
** ''Include (birth, marriage, death) dates, but no places''
** ''Include (birth, marriage, death) dates, and place''
** ''Include (birth, marriage, death) dates, and place if no dates''
** ''Include (birth, marriage, death) years, but no places''
** ''Include (birth, marriage, death) years, and places''
** ''Include (birth, marriage, death) places, but no date''s
** ''Include (birth, marriage, death) dates and places on same line''
* {{checkbox|1}} {{man label|Show all family nodes}} Show family nodes even if the output contains only one member of the family. (checkbox checked by default)
* {{checkbox|0}} {{man label|Include URLs}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include relationship to center person}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include thumbnail images of people}} (checkbox unchecked by default)
* {{man label|Thumbnail location:}} Where the thumbnail image should appear relative to the name
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Include occupation:}} Whether to include the last occupation
** '''Do not include any occupation''' (default)
** ''Include description of most recent occupation''
** ''Include date, description and place of all occupations''
* {{checkbox|0}} {{man label|Include relationship debugging numbers also}} Whether to include 'Ga' and 'Gb' also, to debug the relationship calculator (checkbox unchecked by default)
{{-}}

====Graph Style====

[[File:RelationshipGraph-Graphs-GraphStyle-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
* {{checkbox|1}} {{man label|Indicate non-birth relationships with dotted lines}} (checkbox checked by default) - Shows adopted relationships.
* {{checkbox|1}} {{man label|Show family nodes}} (checkbox checked by default)
* {{man label|Parent grouping:}} Decides the location of the parents in the graph.
** '''Normal''' (default)
** ''Parents together''
** ''Parents offset''
{{-}}

====Example relationship graph====
[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.
# First check that this person is the ''active person''. (You change this later but this is handier)
# Go via the menu {{man menu|Reports->Graphs->Relationship Graph...}}
# Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
# Report Options: filter: Descendant Families of..., Color fill, Use rounded corners
# Graph Style : Show Family Nodes
# Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
# Graphviz Options: Fill given area dpi 133
# Note : we add title on the top size: 18 pts
# Output Format: we want a JPEG file.

The results are similar to the image shown in Fig. {{#var:chapter}}.{{#var:figure}}.
{{-}}
See also:
* A detailed tutorial [[Howto:_Make_a_relationship_chart|How to make a relationship chart]]
{{-}}
<hr>
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Reports - part 5}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Reports - part 5

2025-12-06T04:33:56Z

CallMeDave: /* Family Colours */

{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Reports - part 5}}
{{#vardefine:chapter|13.5}}
{{#vardefine:figure|0}}
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
<hr>
{{-}}
[[File:MenuOverview-Reports-Graphs-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man menu|Reports >Graphs>...}} Menu overview]]
This section describes the different {{man label|Graphs}} (aka Graph Reports) available in Gramps.
==Graphs==
{{man tip|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|Prerequisites for Graph Reports]]|These reports are created using the [[Output_formats#Graphviz|GraphViz]] program. Therefore, it is important that the '''Graphviz''' program is installed on your computer.}}
{{man warn|Reports and custom IDs|After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on {{man menu|Edit --> Preferences}} on the {{man label|ID Formats}} tab). If generated reports do not properly display data, then try [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs tool]] {{man menu|Tools-->Family Tree Processing-->Reorder Gramps IDs...}}}}

All three graph reports: [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines]], [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Hourglass_Graph|Hourglass]], and [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship]] Graphs share common options: {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Layout|Graphviz Layout]]}}, {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Options|Graphviz Options]]}}, and {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Note|Note]]}}.

Also they share common options with the other reports [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Common_options|common options]]: {{man label|Paper Options}} and {{man label|Document Options}}.

===Prerequisites for Graph Reports===
Requires the installation of the [[Output_formats#Graphviz|GraphViz]] program and Ghostscript program that is used by Graphviz reports to help create PDF files.

* On Linux, use your package manager.
* On Microsoft Windows use the Gramps AIO as they are already part of the installer.
* On Apple macOS use the Gramps .dmg as they are already part of the installer.

===Common Options===

There are also several [[Output_formats#Graphviz|GraphViz]] specific options related to pagination, color, and details of the graph.

This plugin uses the Graphviz graph visualization and Ghostscript programs. Graphviz takes the generated [[Output_formats#Graphviz|<code>.gv</code>]] files and creates the final files, such as <code>.gif</code>, <code>.png</code>, , <code>.ps</code>, (Ghostscript creates <code>.pdf</code>), etc.

====Graphviz Layout====

[[File:FamilyLinesGraph-Graphs-GraphvizLayout-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Layout - tab default options]]

*{{man label|Font family:}} Choose the font family. If international characters don't show, use '''FreeSans''' font. FreeSans is available from [http://www.nongnu.org/freefont/ the NonGNU org].
** '''Default'''
** PostScript/ Helvetica
** True Type/ FreeSans
*{{man label|Font size:}} (<code>14</code> default) The font size, in [https://wikipedia.org/wiki/Point_(typography) points].
*{{man label|Graph Direction:}} Whether the graph goes from top to bottom or left to right
** '''Vertical (top to bottom)''' (Default)
** Vertical (bottom to top)
** Horizontal (left to right)
** Horizontal (right to left)
*{{man label|Number of Horizontal Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array horizontally. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Number of Vertical Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array vertically. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Paging Direction:}} (''Bottom, left'' default) The order in which the graph pages are output. This option only applies if the horizontal pages or vertical pages are greater than 1.
*{{man label|Connecting lines:}} - How the lines between objects will be drawn. Choose from:
** ''Straight''
** '''Curved''' (Default)
** ''Orthogonal''
{{-}}

====Graphviz Options====

[[File:FamilyLinesGraph-Graphs-GraphvizOptions-tab-52.png|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Options - tab default options]]

* {{man label|Aspect Ratio:}} Affects greatly how the graph is laid out on the page. Specifically node spacing and scaling of the graph( see ''Advice 1:'').
** ''Compress to minimal minimal size''
** '''Fill the given area''' (default)
** ''Expand uniformly''
<hr>
'''Advice 1:'''

If the graph is smaller than the print area:
* ''Compress to minimal minimal size'' will not change the node spacing.
* ''Fill the given area'' will increase the node spacing to fit the print area in both width and height.
* ''Expand uniformly'' will increase the node spacing uniformly to preserve the aspect ratio.

If the graph is larger than the print area:
* ''Compress to minimal minimal size'' will shrink the graph to achieve tight packing at the expense of symmetry.
* ''Fill the given area'' will shrink the graph to fit the print area after first increasing the node spacing.
* ''Expand uniformly'' will shrink the graph uniformly to fit the print area.
<hr>

* {{man label|DPI:}} (<code>72</code> default) dots-per-inch. When creating PostScript or PDF, use 72 DPI. Typically between 75 and 120 if generating .png or .gif files, but 300 or 600 if generating files to be printed. When creating images such as .gif or .png files for the web, try numbers such as 100 or 300 DPI.
* {{man label|Node Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between individual nodes. For vertical graphs, this corresponds to spacing between columns. For horizontal graphs, this corresponds to spacing between rows.
* {{man label|Rank Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between ranks. For vertical graphs, this corresponds to spacing between rows. For horizontal graphs, this corresponds to spacing between columns.

====Note====
[[File:FamilyLinesGraph-Graphs-Note-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Note - tab default options]]

* {{man label|Note to add to the graph:}} (Empty by default) This text will be added to the graph
* {{man label|Note location:}} - Whether the note will appear on top or bottom of the page.
** '''Top''' (default)
** ''Bottom''
* {{man label|Note size:}} (<code>32</code> default) The size of note text, in [https://en.wikipedia.org/wiki/Point_(typography) points].
{{-}}

===Family Lines Graph===
{{man note|That Family Lines Graph does not display all of the people in the Family Tree.|Instead, this Graph report generates smaller family trees, with many options to try and restrict the number of people included.}}

[[File:Graphs-FamilyLinesGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - example output overview]]

The {{man label|Family Lines Graph}} works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants to generate the {{man label|Family Lines Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

A typical use of this report is to generate simplified graphs to be printed on ''large format printing plotters''.

To create a {{man label|Family Lines Graph}} from the menu select {{man menu|Reports ->Graphs -> Family Lines Graph...}} and then from the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#People_of_Interest|People of Interest]]}} tab click on the {{icon|stock_add}}(add) icon and select at least one person from the {{man label|Select Person}} selector dialog and the report will suggest if possible a second related person via the {{man label|Select Person - Also include <Person Name>}} warning dialog select {{man button|No}} or {{man button|Yes}} depending on what you decide and then select {{man button|OK}} to generate the report.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:FamilyLinesGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options - tab default options]]

* {{checkbox|1}} {{man label|Follow parents to determine "family lines"}} Parents and their ancestors will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Follow children to determine "family lines"}} Children will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Try to remove extra people and families}} People and families not directly related to people of interest will be removed when determining "family lines". (checkbox checked by default)
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Descendants <- Ancestors''' (default) - arrows point to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{man label|Rounded corners:}} to differentiate between women and men.
** '''None''' (default)
** ''Female''
** ''Male''
** ''Both''
* {{man label|Gramps ID:}} Whether (and where) to include Gramps IDs
** '''Do not include''' (default)
** ''Share an existing line''
** ''On a line of its own''
{{-}}

====Report Options (2)====
[[File:FamilyLinesGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD (ISO) (2024-11-15)''' (default for report)
** ''Numerical (15/11/2024)''
** ''Month Day, Year (March 14, 2018)''
** ''MON DAY, YEAR (Mar 14, 2018)''
** ''Day Month Year (14 March 2018)''
** ''DAY MON YEAR (14 Mar 2018)''
* {{checkbox|1}} {{man label|Use subgraphs}} (checkbox checked by default) - Subgraphs can help Grapviz position spouses together, but with non-trival graphs will result in longer lines and larger graphs.
{{-}}

====People of Interest====

[[File:FamilyLinesGraph-Graphs-PeopleOfInterest-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - People of Interest - tab default options]]

The graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.

* {{man label|People of interest:}} click on {{icon|stock_add}} and {{icon|stock_remove}} to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
* {{checkbox|0}} {{man label|Limit the number of ancestors}} (checkbox unchecked by default) Whether to limit the number of ancestors.
** <code>50</code> default. The maximum number of ancestors to include. The maximum is for the total number of people, not generations to be displayed on the chart.
* {{checkbox|0}} {{man label|Limit the number of descendants}} (checkbox unchecked by default) Whether to limit the number of descendants.
** <code>50</code> default. The maximum number of descendants to include. The maximum is for the total number of people, not generations to be displayed on the chart.
{{-}}
=====Select Person - Also include <Person Name> warning dialog=====

Select Person - Also include <Person Name> warning dialog
{{stub}}
{{-}}

====Include====

[[File:FamilyLinesGraph-Graphs-Include-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Include - tab default options]]

* {{checkbox|1}} {{man label|Include dates}}: date of birth, date of death, and marriage dates will be included in the graph when this is selected. (checkbox checked by default)
* {{checkbox|0}} {{man label|Limit dates to years only}}: from the above only show the years.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include places}}: place of birth, place of death, and place of marriage will be included in the graph when this is selected.(checkbox checked by default)
* {{checkbox|1}} {{man label|Include the number of children}}: marriage text will include the total number of children when this is selected.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include thumbnail images of people}} (checkbox checked by default)
* {{man label|Thumbnail location:}}
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Thumbnail size:}}
** '''Normal''' (default)
** ''Large''
{{-}}

====Family Colors====

[[File:FamilyLinesGraph-Graphs-FamilyColors-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Family Colors - tab default options]]

* {{man label|Family colors:}} Select the color to use for people with a specific surname. Two columns are available: ''Surname'' and ''Color''. Click on {{icon|stock_add}} or {{icon|stock_remove}} to add a surname from the {{man label|Select surname}} window, select a surname and press {{man button|OK}}. To edit the surname color double-click on a surname and from the {{man label|Select color for [Surname Selected]}} window choose from the shown colors and then select {{man button|Select}}.
{{-}}

====Individuals====

[[File:FamilyLinesGraph-Graphs-Individuals-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Individuals - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use to display men.
* {{man label|Females:}} the colour to use to display women.
* {{man label|Other:}} the colour to use to display people who neither men nor women.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use to display families. (marriages).
{{-}}

===Hourglass Graph===

[[File:Graphs-HourglassGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - example output overview]]

Generate an {{man label|Hourglass Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]]. Go to {{man menu|Reports -> Graph -> Hourglass Graph...}}.

The hourglass graph chart shows the {{man label|Center Person:}}s ancestors above them and descendants below them. The hourglass graph does not show siblings of the ancestors but it does include all the descendants below them including any spouses.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====

[[File:HourglassGraph-Graphs-ReportOptions-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options - tab default options]]

* {{man label|Center Person:}} the center person for the report, defaults to the current active person.
** {{man button|Select a different person}} button. - Change the center person.
* {{man label|Max Descendant Generations:}} default <code>10</code>
* {{man label|Max Ancestor Generations:}} default <code>10</code>
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Centre -> Others''' (default) - arrows point to the Other.
** ''Centre <- Others'' - arrows point to the Centre.
** ''Centre <-> Others'' - arrows point to both.
** ''Centre - Others'' - None (no arrows are shown)
* {{man label|Graph colouring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Coloured outline''
** '''Colour fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} to differentiate between women and men (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' (default)
** ''include''
{{-}}

====Report Options (2)====
[[File:HourglassGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name format:}} - Select the format to display the names. This choice in normally taken from the default setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** Surname, Given Suffix
** Given Surname Suffix
** Given
** Main Surnames, Given Patronymic Suffix
** SURNAME, Given (Common)
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2018-03-14)''' (default for report)
** Numerical(14/3/2018)
** Month Day, Year(March 14, 2018)
** MON DAY, YEAR(Mar 14, 2018)
** Day Month Year(14 March 2018)
** DAY MON YEAR(14 Mar 2018)
{{-}}

====Graph Style====

[[File:HourglassGraph-Graphs-GraphStyle-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for Others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
{{checkbox|0}} {{man label| Force [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] order}} - Force Sosa / Sosa-Stradonitz / Ahnentafel layout order for all ancestors, so that fathers are always on the left branch and mothers are on the right branch.
{{checkbox|0}} {{man label| [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] number visible}} - Show Sosa / Sosa-Stradonitz / Ahnentafel number.
{{checkbox|0}} {{man label| Show symbols for events}} - Show genealogical symbols for birth, marriage and death events.
{{-}}

===Relationship Graph===

[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

The {{man label|Relationship Graph}} creates a complex relationship graph using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

Via the menu: {{man menu|Reports-> Graphs- >Relationship Graph...}}. You will be presented with a {{man label|Relationship Graph}} window where you can change all the settings.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:RelationshipGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options - tab default options]]

* {{man label|Filter:}} - Select the filter to be applied to the report. Choose from:
** '''Entire Database''' (Default) ({{man menu|'''Not recommended!'''}})
** ''Descendants of active person''
** ''Descendant families of active person''
** ''Ancestors of active person''
** ''People with common ancestor with active person''
** ''Any custom made filter you have created will be listed below the other choices.''
* {{man label|Centre Person:}} The center person for the filter. Defaults to the Active Person. If you use a custom filter, no Person can be chosen.
** {{man button|Select a different person}} button. - Change the Centre person.
* {{man label|Arrowhead direction}}: Choose the direction that the arrows point:
** '''Descendants <- Ancestors'''(default) - arrows point to the to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph colouring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Coloured outline''
** '''Colour fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} Use rounded corners to differentiate between women and men (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Use hexagons}} (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' default
** ''include''
{{-}}

====Report Options (2)====
[[File:RelationshipGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code> (default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2024-11-15)''' (default for report)
** ''Numerical(15/11/2014)''
** ''Month Day, Year(November 15, 2024)''
** ''MON DAY, YEAR(Nov 15, 2024)''
** ''Day Month Year(15 November 2024)''
** ''DAY MON YEAR(15 Nov 2024)''
{{-}}

====Include====

[[File:RelationshipGraph-Graphs-Include-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Include - tab default options]]

* {{man label|Dates and/or Places:}} - Whether to include dates and/or places
** '''Do not include any dates or places''' (default)
** ''Include (birth, marriage, death) dates, but no places''
** ''Include (birth, marriage, death) dates, and place''
** ''Include (birth, marriage, death) dates, and place if no dates''
** ''Include (birth, marriage, death) years, but no places''
** ''Include (birth, marriage, death) years, and places''
** ''Include (birth, marriage, death) places, but no date''s
** ''Include (birth, marriage, death) dates and places on same line''
* {{checkbox|1}} {{man label|Show all family nodes}} Show family nodes even if the output contains only one member of the family. (checkbox checked by default)
* {{checkbox|0}} {{man label|Include URLs}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include relationship to center person}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include thumbnail images of people}} (checkbox unchecked by default)
* {{man label|Thumbnail location:}} Where the thumbnail image should appear relative to the name
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Include occupation:}} Whether to include the last occupation
** '''Do not include any occupation''' (default)
** ''Include description of most recent occupation''
** ''Include date, description and place of all occupations''
* {{checkbox|0}} {{man label|Include relationship debugging numbers also}} Whether to include 'Ga' and 'Gb' also, to debug the relationship calculator (checkbox unchecked by default)
{{-}}

====Graph Style====

[[File:RelationshipGraph-Graphs-GraphStyle-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
* {{checkbox|1}} {{man label|Indicate non-birth relationships with dotted lines}} (checkbox checked by default) - Shows adopted relationships.
* {{checkbox|1}} {{man label|Show family nodes}} (checkbox checked by default)
* {{man label|Parent grouping:}} Decides the location of the parents in the graph.
** '''Normal''' (default)
** ''Parents together''
** ''Parents offset''
{{-}}

====Example relationship graph====
[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.
# First check that this person is the ''active person''. (You change this later but this is handier)
# Go via the menu {{man menu|Reports->Graphs->Relationship Graph...}}
# Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
# Report Options: filter: Descendant Families of..., Color fill, Use rounded corners
# Graph Style : Show Family Nodes
# Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
# Graphviz Options: Fill given area dpi 133
# Note : we add title on the top size: 18 pts
# Output Format: we want a JPEG file.

The results are similar to the image shown in Fig. {{#var:chapter}}.{{#var:figure}}.
{{-}}
See also:
* A detailed tutorial [[Howto:_Make_a_relationship_chart|How to make a relationship chart]]
{{-}}
<hr>
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Reports - part 5}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual - Reports - part 5

2025-12-06T04:33:36Z

CallMeDave: /* Report Options */

{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Reports - part 5}}
{{#vardefine:chapter|13.5}}
{{#vardefine:figure|0}}
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
<hr>
{{-}}
[[File:MenuOverview-Reports-Graphs-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man menu|Reports >Graphs>...}} Menu overview]]
This section describes the different {{man label|Graphs}} (aka Graph Reports) available in Gramps.
==Graphs==
{{man tip|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|Prerequisites for Graph Reports]]|These reports are created using the [[Output_formats#Graphviz|GraphViz]] program. Therefore, it is important that the '''Graphviz''' program is installed on your computer.}}
{{man warn|Reports and custom IDs|After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on {{man menu|Edit --> Preferences}} on the {{man label|ID Formats}} tab). If generated reports do not properly display data, then try [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs tool]] {{man menu|Tools-->Family Tree Processing-->Reorder Gramps IDs...}}}}

All three graph reports: [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines]], [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Hourglass_Graph|Hourglass]], and [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship]] Graphs share common options: {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Layout|Graphviz Layout]]}}, {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphviz_Options|Graphviz Options]]}}, and {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Note|Note]]}}.

Also they share common options with the other reports [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Common_options|common options]]: {{man label|Paper Options}} and {{man label|Document Options}}.

===Prerequisites for Graph Reports===
Requires the installation of the [[Output_formats#Graphviz|GraphViz]] program and Ghostscript program that is used by Graphviz reports to help create PDF files.

* On Linux, use your package manager.
* On Microsoft Windows use the Gramps AIO as they are already part of the installer.
* On Apple macOS use the Gramps .dmg as they are already part of the installer.

===Common Options===

There are also several [[Output_formats#Graphviz|GraphViz]] specific options related to pagination, color, and details of the graph.

This plugin uses the Graphviz graph visualization and Ghostscript programs. Graphviz takes the generated [[Output_formats#Graphviz|<code>.gv</code>]] files and creates the final files, such as <code>.gif</code>, <code>.png</code>, , <code>.ps</code>, (Ghostscript creates <code>.pdf</code>), etc.

====Graphviz Layout====

[[File:FamilyLinesGraph-Graphs-GraphvizLayout-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Layout - tab default options]]

*{{man label|Font family:}} Choose the font family. If international characters don't show, use '''FreeSans''' font. FreeSans is available from [http://www.nongnu.org/freefont/ the NonGNU org].
** '''Default'''
** PostScript/ Helvetica
** True Type/ FreeSans
*{{man label|Font size:}} (<code>14</code> default) The font size, in [https://wikipedia.org/wiki/Point_(typography) points].
*{{man label|Graph Direction:}} Whether the graph goes from top to bottom or left to right
** '''Vertical (top to bottom)''' (Default)
** Vertical (bottom to top)
** Horizontal (left to right)
** Horizontal (right to left)
*{{man label|Number of Horizontal Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array horizontally. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Number of Vertical Pages:}} (<code>1</code> default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array vertically. '''Only valid for dot and pdf via Ghostscript'''.
*{{man label|Paging Direction:}} (''Bottom, left'' default) The order in which the graph pages are output. This option only applies if the horizontal pages or vertical pages are greater than 1.
*{{man label|Connecting lines:}} - How the lines between objects will be drawn. Choose from:
** ''Straight''
** '''Curved''' (Default)
** ''Orthogonal''
{{-}}

====Graphviz Options====

[[File:FamilyLinesGraph-Graphs-GraphvizOptions-tab-52.png|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Graphviz Options - tab default options]]

* {{man label|Aspect Ratio:}} Affects greatly how the graph is laid out on the page. Specifically node spacing and scaling of the graph( see ''Advice 1:'').
** ''Compress to minimal minimal size''
** '''Fill the given area''' (default)
** ''Expand uniformly''
<hr>
'''Advice 1:'''

If the graph is smaller than the print area:
* ''Compress to minimal minimal size'' will not change the node spacing.
* ''Fill the given area'' will increase the node spacing to fit the print area in both width and height.
* ''Expand uniformly'' will increase the node spacing uniformly to preserve the aspect ratio.

If the graph is larger than the print area:
* ''Compress to minimal minimal size'' will shrink the graph to achieve tight packing at the expense of symmetry.
* ''Fill the given area'' will shrink the graph to fit the print area after first increasing the node spacing.
* ''Expand uniformly'' will shrink the graph uniformly to fit the print area.
<hr>

* {{man label|DPI:}} (<code>72</code> default) dots-per-inch. When creating PostScript or PDF, use 72 DPI. Typically between 75 and 120 if generating .png or .gif files, but 300 or 600 if generating files to be printed. When creating images such as .gif or .png files for the web, try numbers such as 100 or 300 DPI.
* {{man label|Node Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between individual nodes. For vertical graphs, this corresponds to spacing between columns. For horizontal graphs, this corresponds to spacing between rows.
* {{man label|Rank Spacing:}} (<code>0.20</code> default) The minimum amount of free space, in inches, between ranks. For vertical graphs, this corresponds to spacing between rows. For horizontal graphs, this corresponds to spacing between columns.

====Note====
[[File:FamilyLinesGraph-Graphs-Note-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Note - tab default options]]

* {{man label|Note to add to the graph:}} (Empty by default) This text will be added to the graph
* {{man label|Note location:}} - Whether the note will appear on top or bottom of the page.
** '''Top''' (default)
** ''Bottom''
* {{man label|Note size:}} (<code>32</code> default) The size of note text, in [https://en.wikipedia.org/wiki/Point_(typography) points].
{{-}}

===Family Lines Graph===
{{man note|That Family Lines Graph does not display all of the people in the Family Tree.|Instead, this Graph report generates smaller family trees, with many options to try and restrict the number of people included.}}

[[File:Graphs-FamilyLinesGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - example output overview]]

The {{man label|Family Lines Graph}} works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants to generate the {{man label|Family Lines Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

A typical use of this report is to generate simplified graphs to be printed on ''large format printing plotters''.

To create a {{man label|Family Lines Graph}} from the menu select {{man menu|Reports ->Graphs -> Family Lines Graph...}} and then from the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#People_of_Interest|People of Interest]]}} tab click on the {{icon|stock_add}}(add) icon and select at least one person from the {{man label|Select Person}} selector dialog and the report will suggest if possible a second related person via the {{man label|Select Person - Also include <Person Name>}} warning dialog select {{man button|No}} or {{man button|Yes}} depending on what you decide and then select {{man button|OK}} to generate the report.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:FamilyLinesGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options - tab default options]]

* {{checkbox|1}} {{man label|Follow parents to determine "family lines"}} Parents and their ancestors will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Follow children to determine "family lines"}} Children will be considered when determining "family lines". (checkbox checked by default)
* {{checkbox|1}} {{man label|Try to remove extra people and families}} People and families not directly related to people of interest will be removed when determining "family lines". (checkbox checked by default)
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Descendants <- Ancestors''' (default) - arrows point to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph coloring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Colored outline''
** '''Color fill''' (default)
* {{man label|Rounded corners:}} to differentiate between women and men.
** '''None''' (default)
** ''Female''
** ''Male''
** ''Both''
* {{man label|Gramps ID:}} Whether (and where) to include Gramps IDs
** '''Do not include''' (default)
** ''Share an existing line''
** ''On a line of its own''
{{-}}

====Report Options (2)====
[[File:FamilyLinesGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD (ISO) (2024-11-15)''' (default for report)
** ''Numerical (15/11/2024)''
** ''Month Day, Year (March 14, 2018)''
** ''MON DAY, YEAR (Mar 14, 2018)''
** ''Day Month Year (14 March 2018)''
** ''DAY MON YEAR (14 Mar 2018)''
* {{checkbox|1}} {{man label|Use subgraphs}} (checkbox checked by default) - Subgraphs can help Grapviz position spouses together, but with non-trival graphs will result in longer lines and larger graphs.
{{-}}

====People of Interest====

[[File:FamilyLinesGraph-Graphs-PeopleOfInterest-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - People of Interest - tab default options]]

The graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.

* {{man label|People of interest:}} click on {{icon|stock_add}} and {{icon|stock_remove}} to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
* {{checkbox|0}} {{man label|Limit the number of ancestors}} (checkbox unchecked by default) Whether to limit the number of ancestors.
** <code>50</code> default. The maximum number of ancestors to include. The maximum is for the total number of people, not generations to be displayed on the chart.
* {{checkbox|0}} {{man label|Limit the number of descendants}} (checkbox unchecked by default) Whether to limit the number of descendants.
** <code>50</code> default. The maximum number of descendants to include. The maximum is for the total number of people, not generations to be displayed on the chart.
{{-}}
=====Select Person - Also include <Person Name> warning dialog=====

Select Person - Also include <Person Name> warning dialog
{{stub}}
{{-}}

====Include====

[[File:FamilyLinesGraph-Graphs-Include-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Include - tab default options]]

* {{checkbox|1}} {{man label|Include dates}}: date of birth, date of death, and marriage dates will be included in the graph when this is selected. (checkbox checked by default)
* {{checkbox|0}} {{man label|Limit dates to years only}}: from the above only show the years.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include places}}: place of birth, place of death, and place of marriage will be included in the graph when this is selected.(checkbox checked by default)
* {{checkbox|1}} {{man label|Include the number of children}}: marriage text will include the total number of children when this is selected.(checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include thumbnail images of people}} (checkbox checked by default)
* {{man label|Thumbnail location:}}
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Thumbnail size:}}
** '''Normal''' (default)
** ''Large''
{{-}}

====Family Colours====

[[File:FamilyLinesGraph-Graphs-FamilyColours-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Family Colours - tab default options]]

* {{man label|Family colors:}} Select the color to use for people with a specific surname. Two columns are available: ''Surname'' and ''Color''. Click on {{icon|stock_add}} or {{icon|stock_remove}} to add a surname from the {{man label|Select surname}} window, select a surname and press {{man button|OK}}. To edit the surname color double-click on a surname and from the {{man label|Select color for [Surname Selected]}} window choose from the shown colors and then select {{man button|Select}}.
{{-}}

====Individuals====

[[File:FamilyLinesGraph-Graphs-Individuals-tab-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Lines Graph - Graphs - Individuals - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use to display men.
* {{man label|Females:}} the colour to use to display women.
* {{man label|Other:}} the colour to use to display people who neither men nor women.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use to display families. (marriages).
{{-}}

===Hourglass Graph===

[[File:Graphs-HourglassGraph-example-overview-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - example output overview]]

Generate an {{man label|Hourglass Graph}} using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]]. Go to {{man menu|Reports -> Graph -> Hourglass Graph...}}.

The hourglass graph chart shows the {{man label|Center Person:}}s ancestors above them and descendants below them. The hourglass graph does not show siblings of the ancestors but it does include all the descendants below them including any spouses.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====

[[File:HourglassGraph-Graphs-ReportOptions-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options - tab default options]]

* {{man label|Center Person:}} the center person for the report, defaults to the current active person.
** {{man button|Select a different person}} button. - Change the center person.
* {{man label|Max Descendant Generations:}} default <code>10</code>
* {{man label|Max Ancestor Generations:}} default <code>10</code>
* {{man label|Arrowhead direction:}} Choose the direction that the arrows point:
** '''Centre -> Others''' (default) - arrows point to the Other.
** ''Centre <- Others'' - arrows point to the Centre.
** ''Centre <-> Others'' - arrows point to both.
** ''Centre - Others'' - None (no arrows are shown)
* {{man label|Graph colouring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Coloured outline''
** '''Colour fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} to differentiate between women and men (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' (default)
** ''include''
{{-}}

====Report Options (2)====
[[File:HourglassGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name format:}} - Select the format to display the names. This choice in normally taken from the default setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** Surname, Given Suffix
** Given Surname Suffix
** Given
** Main Surnames, Given Patronymic Suffix
** SURNAME, Given (Common)
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code>(default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2018-03-14)''' (default for report)
** Numerical(14/3/2018)
** Month Day, Year(March 14, 2018)
** MON DAY, YEAR(Mar 14, 2018)
** Day Month Year(14 March 2018)
** DAY MON YEAR(14 Mar 2018)
{{-}}

====Graph Style====

[[File:HourglassGraph-Graphs-GraphStyle-tab-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Hourglass Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for Others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
{{checkbox|0}} {{man label| Force [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] order}} - Force Sosa / Sosa-Stradonitz / Ahnentafel layout order for all ancestors, so that fathers are always on the left branch and mothers are on the right branch.
{{checkbox|0}} {{man label| [[Genealogical Numbering Systems#ahnentafel|Ahnentafel]] number visible}} - Show Sosa / Sosa-Stradonitz / Ahnentafel number.
{{checkbox|0}} {{man label| Show symbols for events}} - Show genealogical symbols for birth, marriage and death events.
{{-}}

===Relationship Graph===

[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

The {{man label|Relationship Graph}} creates a complex relationship graph using the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Prerequisites_for_Graph_Reports|GraphViz generator]].

Via the menu: {{man menu|Reports-> Graphs- >Relationship Graph...}}. You will be presented with a {{man label|Relationship Graph}} window where you can change all the settings.
{{-}}
See also:
* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Common_Options|common options]] - (GraphViz specific related to pagination, color, and details of the graph.)
{{-}}
====Report Options====
[[File:RelationshipGraph-Graphs-ReportOptions-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options - tab default options]]

* {{man label|Filter:}} - Select the filter to be applied to the report. Choose from:
** '''Entire Database''' (Default) ({{man menu|'''Not recommended!'''}})
** ''Descendants of active person''
** ''Descendant families of active person''
** ''Ancestors of active person''
** ''People with common ancestor with active person''
** ''Any custom made filter you have created will be listed below the other choices.''
* {{man label|Centre Person:}} The center person for the filter. Defaults to the Active Person. If you use a custom filter, no Person can be chosen.
** {{man button|Select a different person}} button. - Change the Centre person.
* {{man label|Arrowhead direction}}: Choose the direction that the arrows point:
** '''Descendants <- Ancestors'''(default) - arrows point to the to the Descendants.
** ''Descendants -> Ancestors'' - arrows point to the to the Ancestors.
** ''Descendants <-> Ancestors'' - arrows point to both.
** ''Descendants - Ancestors'' - None (no arrows are shown)
* {{man label|Graph colouring:}} - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
** ''B&W outline'' - Black and white outline
** ''Coloured outline''
** '''Colour fill''' (default)
* {{checkbox|0}} {{man label|Use rounded corners}} Use rounded corners to differentiate between women and men (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Use hexagons}} (checkbox unchecked by default)
* {{man label|Gramps ID:}} whether to include Gramps IDs.
** '''Do not include''' default
** ''include''
{{-}}

====Report Options (2)====
[[File:RelationshipGraph-Graphs-ReportOptions2-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Report Options (2) - tab default options]]

* {{man label|Name Format:}} - Select the format to display the names. This choice in normally taken from the default setting in {{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]]}} tab for {{man label|Name format:}}. Or to override that setting for the report choose from:
** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'' )
** ''Surname, Given Suffix''
** ''Given Surname Suffix''
** ''Given''
** ''Main Surnames, Given Patronymic Suffix''
** ''SURNAME, Given (Common)''
* {{checkbox|1}} {{man label|Include data marked private}} (checkbox checked by default) - Whether to include private data.
* {{man label|Living People:}} - How to handle (information about) living people
** '''Included, and all data''' (default)
** ''Full names, but data removed''
** ''Given names replaced, and data removed''
** ''Complete names replaced, and data removed''
** ''Not included''
* {{man label|Years from death to consider living:}} <code>0</code> (default) - Whether to restrict data on recently dead people.
* {{man label|Translation:}} The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
* {{man label|Date format:}} The format and language for dates, with examples
** Default - Choose this option to use the default set in [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Date format:}} option.
** '''YYYY-MM-DD(ISO)(2024-11-15)''' (default for report)
** ''Numerical(15/11/2014)''
** ''Month Day, Year(November 15, 2024)''
** ''MON DAY, YEAR(Nov 15, 2024)''
** ''Day Month Year(15 November 2024)''
** ''DAY MON YEAR(15 Nov 2024)''
{{-}}

====Include====

[[File:RelationshipGraph-Graphs-Include-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Include - tab default options]]

* {{man label|Dates and/or Places:}} - Whether to include dates and/or places
** '''Do not include any dates or places''' (default)
** ''Include (birth, marriage, death) dates, but no places''
** ''Include (birth, marriage, death) dates, and place''
** ''Include (birth, marriage, death) dates, and place if no dates''
** ''Include (birth, marriage, death) years, but no places''
** ''Include (birth, marriage, death) years, and places''
** ''Include (birth, marriage, death) places, but no date''s
** ''Include (birth, marriage, death) dates and places on same line''
* {{checkbox|1}} {{man label|Show all family nodes}} Show family nodes even if the output contains only one member of the family. (checkbox checked by default)
* {{checkbox|0}} {{man label|Include URLs}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include relationship to center person}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include thumbnail images of people}} (checkbox unchecked by default)
* {{man label|Thumbnail location:}} Where the thumbnail image should appear relative to the name
** '''Above the name''' (Default)
** ''Beside the name''
* {{man label|Include occupation:}} Whether to include the last occupation
** '''Do not include any occupation''' (default)
** ''Include description of most recent occupation''
** ''Include date, description and place of all occupations''
* {{checkbox|0}} {{man label|Include relationship debugging numbers also}} Whether to include 'Ga' and 'Gb' also, to debug the relationship calculator (checkbox unchecked by default)
{{-}}

====Graph Style====

[[File:RelationshipGraph-Graphs-GraphStyle-tab-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - Graph Style - tab default options]]

You can select a color for each of the following from the {{man label|Pick a Color}} window and then select the {{man button|Select}} button.

* {{man label|Males:}} the colour to use for males.
* {{man label|Females:}} the colour to use for females.
* {{man label|Other:}} the colour to use for others.
* {{man label|Unknown:}} the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
* {{man label|Families:}} the colour to use for families (weddings).
* {{checkbox|1}} {{man label|Indicate non-birth relationships with dotted lines}} (checkbox checked by default) - Shows adopted relationships.
* {{checkbox|1}} {{man label|Show family nodes}} (checkbox checked by default)
* {{man label|Parent grouping:}} Decides the location of the parents in the graph.
** '''Normal''' (default)
** ''Parents together''
** ''Parents offset''
{{-}}

====Example relationship graph====
[[File:Graphs-RelationshipGraph-example-overview-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationship Graph - Graphs - example output overview]]

Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.
# First check that this person is the ''active person''. (You change this later but this is handier)
# Go via the menu {{man menu|Reports->Graphs->Relationship Graph...}}
# Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
# Report Options: filter: Descendant Families of..., Color fill, Use rounded corners
# Graph Style : Show Family Nodes
# Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
# Graphviz Options: Fill given area dpi 133
# Note : we add title on the top size: 18 pts
# Output Format: we want a JPEG file.

The results are similar to the image shown in Fig. {{#var:chapter}}.{{#var:figure}}.
{{-}}
See also:
* A detailed tutorial [[Howto:_Make_a_relationship_chart|How to make a relationship chart]]
{{-}}
<hr>
Back to [[Gramps_6.0_Wiki_Manual_-_Reports|Index of Reports]].
{{man index|Gramps_6.0_Wiki_Manual_-_Reports_-_part_4|Gramps 6.0 Wiki Manual - Reports - part 6|6.0}}
{{languages|Gramps 6.0 Wiki Manual - Reports - part 5}}
{{grampsmanualcopyright}}

[[Category:Documentation]]
[[Category:Plugins]]

Gramps 6.0 Wiki Manual

2025-12-06T04:33:10Z

CallMeDave:

{{man menu|This is the [[Gramps_Glossary#wiki|Wiki]] Manual for Gramps version 6.0. All users are encouraged to edit this manual to help improve its readability and usability. }}
{{man index|Gramps 6.0 Wiki Manual|Gramps 6.0 Wiki Manual - Preface|6.0}}
{{languages|Gramps 6.0 Wiki Manual}}
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]
'''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 [[Gramps_Glossary#wiki|Wiki]] Manual''' for version 6.0 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]].

You can also download the '''Complete 6.0 Offline Manual''' ([[:Media:Gramps6.0UserManual.pdf|English 20 MiB PDF]] and [[User_manual_translations#Gramps_6.0.x_Manual|additional languages]]) last updated 2025-07-17. For previous Wiki Manuals revisions, see the [[User_manual_translations#superseded|archival versions]] made for [[Previous_releases_of_Gramps|previous releases of Gramps]]. (Search the page for "''offline PDF''" to find offline versions.) Volunteer WikiContributors started the 6.0 addition drafts to the 5.2 base pages on 23 March 2025. Users are urged to explore new features and help add documentation in the wiki.

The '''6.0 Addons Offline Manual''' is available for review at ([[Media:GrampsAddonsUserManual6.0.pdf|English 18 MiB PDF]]) last updated 2025-07-17.

To explore other sources of information about using Gramps, see the [[:Portal:Using_Gramps|Information Portal]].

==Table of Contents==

:[[Gramps 6.0 Wiki Manual - Preface|Preface]]
::[[Gramps 6.0 Wiki Manual - Preface#Why use Gramps.3F|Why use Gramps?]]
::[[Gramps 6.0 Wiki Manual - Preface#Typographical_conventions_in_the_Gramps_Wiki_Manual|Typographical conventions in the Gramps Wiki Manual]]
<hr>
:[[Gramps 6.0 Wiki Manual - Main Window|A Visual Guide to the Gramps Interface]]
<hr>

#[[Gramps 6.0 Wiki Manual - What's new?|What's new?]]
##[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Before_you_upgrade|Before you upgrade]]
##[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Visible changes to the core|Visible changes to the core]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Data Model|Data Model]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Primary_changes|Primary changes]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#GUI|GUI]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Place|Place]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Reports, Tools, Gramplets|Reports, Tools, Gramplets]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Import.2FExport|Import/Export]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#New_Addons|New Addons]]
##[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Under the hood changes|Under the hood changes]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Dependencies|Dependencies]]
##[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Further information|Further information]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Miscellaneous|Miscellaneous]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Localization|Localization]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Roadmap|Roadmap]]
###[[Gramps_6.0_Wiki_Manual_-_What's_new%3F#Changelog|Changelog]]<hr>


#[[Gramps 6.0 Wiki Manual - Getting started|Getting started]]
##[[Gramps_6.0_Wiki_Manual_-_Getting_started#Overview of Gramps|Overview]]
###[[Gramps_6.0_Wiki_Manual_-_Getting_started#Connections|Connections]]
###[[Gramps_6.0_Wiki_Manual_-_Getting_started#Privacy|Privacy]]
###[[Gramps_6.0_Wiki_Manual_-_Getting_started#GEDCOM|GEDCOM]]
##[[Gramps_6.0_Wiki_Manual_-_Getting_started#Start_Gramps|Start Gramps]]
###[[Gramps_6.0_Wiki_Manual_-_Getting_started#Linux|Linux]]
###[[Gramps_6.0_Wiki_Manual_-_Getting_started#MS_Windows|MS Windows]]
###[[Gramps_6.0_Wiki_Manual_-_Getting_started#macOS|macOS]]
##[[Gramps_6.0_Wiki_Manual_-_Getting_started#Choosing_a_Family_Tree|Choosing a Family Tree]]
##[[Gramps_6.0_Wiki_Manual_-_Getting_started#Tell_me_how_to_start_right_now.21|Tell me how to start right now!]]
##[[Gramps_6.0_Wiki_Manual_-_Getting_started#Obtaining_Help|Obtaining Help]]<hr>

#[[Gramps 6.0 Wiki Manual - Main Window|Main Window]] - ''A Visual Guide to the Gramps Interface''
##[[Gramps_6.0_Wiki_Manual_-_Main_Window#Main_Window|Main Window]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Window Title Bar|Window Title Bar]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Menubar|Menubar]]
####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Pull-down_menus|Pull-down menus]]
####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Pop-up_menus|Pop-up menus]]
####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Combo_Boxes|Combo Boxes]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Navigator|Navigator]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Display_area|Display area]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Status_Bar_and_Progress_Bar|Status Bar and Progress Bar]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar and Sidebar]]
####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Gramplet_Bar|Gramplet Bar]]
#####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Bottombar|Bottombar]]
#####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Sidebar|Sidebar]]
####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Gramplet_Bar_Menu|Gramplet Bar Menu]]
#####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Restore_to_defaults.3F_dialog|Restore to defaults? dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Main_Window#Search_Bar|Search Bar]]
##[[Gramps_6.0_Wiki_Manual_-_Main_Window#Switching_Navigator_modes|Switching Navigator modes]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Category_navigator_mode_.28default.29|Category navigator mode (default)]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Drop-Down_navigator_mode|Drop-Down navigator mode]]
###[[Gramps_6.0_Wiki_Manual_-_Main_Window#Expander_navigator_mode|Expander navigator mode]]
##[[Gramps_6.0_Wiki_Manual_-_Main_Window#Switching_Categories|Switching Categories]]
##[[Gramps_6.0_Wiki_Manual_-_Main_Window#Switching_Views|Switching Views]]
##[[Gramps_6.0_Wiki_Manual_-_Main_Window#Filters|Filters]]<hr>

#[[Gramps_6.0_Wiki_Manual_-_Categories|Categories]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Categories_of_the_Navigator|Categories of the Navigator]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Dashboard_Category|Dashboard Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Dashboard Context Menu|Dashboard Context Menu]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Dashboard Configuration Options|Dashboard Configuration Options]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Gramplet_Layout|Gramplet Layout]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#People Category|People Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Tree View - Grouped People|Tree View - Grouped People]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#People List View|People List View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#People Category Bottombar tabs|People Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Details|Details]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Gallery|Gallery]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Events|Events]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Children|Children]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Citations|Citations]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Notes|Notes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Attributes|Attributes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#People Category Sidebar tabs|People Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Relationships Category|Relationships Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Relationships Category view|Relationships Category view]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Active Person|Active Person]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Parents|Parents]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Select Family selector|Select Family selector]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Siblings|Siblings]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Family|Family]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Reorder Relationships dialog|Reorder Relationships dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Children_2|Children]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Configuration|Configuration]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Relationships Category Bottombar tabs|Relationships Category Bottombar tabs]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Relationships Category Sidebar tabs|Relationships Category Sidebar tabs]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Families Category|Families Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Families Category Bottombar tabs|Families Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Details_2|Details]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Gallery_2|Gallery]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Events_2|Events]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Children_3|Children]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Citations_2|Citations]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Notes_2|Notes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Attributes_2|Attributes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References_2|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Families Category Sidebar tabs|Families Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_2|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Charts Category|Charts Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Pedigree View|Pedigree View]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Pedigree_View_Context_menus|Pedigree View Context menus]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Pedigree_View_Person_Context_menu|Pedigree View Person Context menu]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Pedigree_View_Blank_Context_menu|Pedigree View Blank Context menu]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Configure_the_active_view|Configure the active view]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Fan Chart View|Fan Chart View]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Configure_the_active_view_2|Configure the active view]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Descendant Fan View|Descendant Fan View]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Configure_the_active_view_3|Configure the active view]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#2-Way Fan View|2-Way Fan View]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Configure_the_active_view_4|Configure the active view]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Charts Category Bottombar tabs|Charts Category Bottombar tabs]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Charts Category Sidebar tabs|Charts Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_3|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Events Category|Events Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Events View|Events View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Events Category Bottombar tabs|Events Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Gallery_3|Gallery]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Citations_3|Citations]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Notes_3|Notes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Attributes_3|Attributes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References_3|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Events Category Sidebar tabs|Events Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_4|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Places Category|Places Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#.E2.9A.99_Configuration_Options|⚙ Configuration Options]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Places List View|Places List View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Places Tree View|Places Tree View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Map Service|Map Service]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Places Category Bottombar tabs|Places Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Details_2|Details]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Location|Location]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Gallery_4|Gallery]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Events_3|Events]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Citations_4|Citations]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Notes_4|Notes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References_4|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Places Category Sidebar tabs|Places Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_5|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Geography Category|Geography Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#The different views|The different views]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#All known places|All known places]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#All_known_places_for_one_Family|All known places for one Family]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Have they been able to meet ?|Have they been able to meet ?]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#All_places_related_to_Events|All places related to Events]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#All known places for one person|All known places for one person]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#All_known_places_for_one_person_with_graphical_information_.28KML_files.29|All known places for one person with graphical information (KML files)]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Every_residence_or_move_for_a_person_and_any_descendants|Every residence or move for a person and any descendants]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Have_these_two_families_been_able_to_meet_.3F|Have these two families been able to meet ?]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Usage|Usage]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#The configuration|The configuration]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#All views|All views]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Specific views|Specific views]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Print_or_save_the_Map|Print or save the Map]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#How to zoom and move around the map ?|How to zoom and move around the map ?]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Zoom in and Zoom out the map|Zoom in and Zoom out the map]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#Move around the map|Move around the map]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#The mouse actions on the map|The mouse actions on the map]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#button 1 ( left button )|button 1 ( left button )]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#button 2 ( middle button )|button 2 ( middle button )]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#button 3 ( right button )|button 3 ( right button )]]
#####[[Gramps_6.0_Wiki_Manual_-_Categories#The mouse over a marker|The mouse over a marker]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#The menu popup|The menu popup]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Click on a marker|Click on a marker]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Adding or Linking to a place|Adding or Linking to a place]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Adding places from KML files|Adding places from KML files]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#How to change the map provider ?|How to change the map provider ?]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Can we change the marker's color ?|Can we change the marker's color ?]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#How to get/remove the crosshair ?|How to get/remove the crosshair ?]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#How to lock/unlock the map ?|How to lock/unlock the map ?]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Prerequisites to see the geography view|Prerequisites to see the geography view]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Possible problems|Possible problems]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Geography Category Bottombar tabs|Geography Category Bottombar tabs]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Geography Category Sidebar tabs|Geography Category Sidebar tabs]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_6|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Sources Category|Sources Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Citation_Tree_View|Citation Tree View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Sources List View|Sources List View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Sources Category Bottombar tabs|Sources Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Gallery_5|Gallery]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Notes_5|Notes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References_5|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Sources Category Sidebar tabs|Sources Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_7|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Citations Category|Citations Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Citations List View|Citations List View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Citations Category Bottombar tabs|Citations Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Gallery_6|Gallery]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Notes_6|Notes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References_6|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Citations Category Sidebar tabs|Citations Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_8|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Repositories Category|Repositories Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Repository List View|Repository List View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Repository Category Bottombar tabs|Repository Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Details_3|Details]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Notes_7|Notes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References_7|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Repository Category Sidebar tabs|Repository Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_9|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Media Category|Media Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Media List View|Media List View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Media Category Bottombar tabs|Media Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Preview|Preview]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Citations_5|Citations]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Notes_8|Notes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Attributes_4|Attributes]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Image Metadata|Image Metadata]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References_8|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Media Category Sidebar tabs|Media Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_10|Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Categories#Notes Category|Notes Category]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Notes List View|Notes List View]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Notes Category Bottombar tabs|Notes Category Bottombar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#References_9|References]]
###[[Gramps_6.0_Wiki_Manual_-_Categories#Notes Category Sidebar tabs|Notes Category Sidebar tabs]]
####[[Gramps_6.0_Wiki_Manual_-_Categories#Filter_11|Filter]]<hr>

#[[Gramps 6.0 Wiki Manual - Manage Family Trees|Manage Family Trees]]
##[[Gramps 6.0 Wiki Manual - Manage Family Trees#Starting a new Family Tree|Starting a new Family Tree]]
###[[Gramps 6.0 Wiki Manual - Manage Family Trees#Family Trees manager window|Family Trees manager window]]
####[[Gramps 6.0 Wiki Manual - Manage Family Trees#Database_Information_dialog|Database Information dialog]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Opening_a_Family_Tree|Opening a Family Tree]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Load_Family_Tree_button|Load Family Tree button]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Connect_to_a_recent_database|Connect to a recent database]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Could_not_load_a_recent_Family_Tree._warning|Could not load a recent Family Tree. warning]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Read_Only_Mode|Read Only Mode]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Saving_changes_to_your_Family_Tree|Saving changes to your Family Tree]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Opening_a_GEDCOM_or_XML_database|Opening a GEDCOM or XML database]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Deleting_a_Family_Tree|Deleting a Family Tree]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Remove_the_.3CXXXXXXXX.3E_Family_Tree.3F_dialog|Remove the <XXXXXXXX> Family Tree? dialog]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Renaming_a_Family_Tree|Renaming a Family Tree]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog|Backup dialog]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Archiving_a_Family_Tree|Archiving a Family Tree]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Extracting_a_Family_Tree_Archive|Extracting a Family Tree Archive]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Unlocking_a_Family_Tree|Unlocking a Family Tree]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Break_the_lock_on_the_.22Family_Tree_name.22_database.3F_dialog|Break the lock on the "Family Tree name" database? dialog]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#The_database_is_locked_dialog|The database is locked dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Command_Line:Force_unlock_option|Command Line:Force unlock option]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Repairing_a_damaged_Family_Tree|Repairing a damaged Family Tree]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|Converting a BSDDB Family Tree to SQLite]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Importing_data|Importing data]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Import Family Tree dialog|Import Family Tree dialog]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GRAMPS V2.x database import|GRAMPS V2.x database import]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Moving_a_Gramps_2.2_databases_to_Gramps_3.x|Moving a Gramps 2.2 databases to Gramps 3.x ]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Gramps XML and XML Package import|Gramps XML and XML Package import]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Gramps CSV import|Gramps CSV import]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM import|GEDCOM import]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_Encoding_dialog|GEDCOM Encoding dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Import Statistics dialog|Import Statistics dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM import report dialog|GEDCOM import report dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Reading_the_report|Reading the report]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM import limitations|GEDCOM import limitations]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#HEADer, SUBMitter and SUBmissioN|HEADer, SUBMitter and SUBmissioN]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#INDIvidual|INDIvidual]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#FAM_RECORD|FAM_RECORD]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#SOURCE_RECORD|SOURCE_RECORD]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#REPOSITORY_RECORD|REPOSITORY_RECORD]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#MULTIMEDIA_RECORD|MULTIMEDIA_RECORD]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#NOTE_RECORD|NOTE_RECORD]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|Exporting data]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Export Assistant dialog|Export Assistant dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Saving_your_data|Saving your data]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Choose_the_output_format|Choose the output format]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Export_options|Export options]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Filters and privacy|Filters and privacy]]
######[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Privacy Filter:|Privacy Filter:]]
######[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Living Filter:|Living Filter:]]
######[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Person Filter:|Person Filter:]]
######[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Note Filter:|Note Filter:]]
######[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Reference Filter:|Reference Filter:]]
#####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#File format specific export options|File format specific export options]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Select save file|Select save file]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Final confirmation|Final confirmation]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Summary|Summary]]
####[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Comma_Separated_Values_Spreadsheet.28CSV.29_export|Comma Separated Values Spreadsheet(CSV) export]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_export|GEDCOM export]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GeneWeb_export|GeneWeb export]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Gramps_XML_.28family_tree.29_export|Gramps XML (family tree) export]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Gramps_XML_Package_.28family_tree_and_media.29_export|Gramps XML Package (family tree and media) export]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Web_Family_Tree_export|Web Family Tree export]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#vCalendar_export|vCalendar export]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#vCard_export|vCard export]]<hr>

#[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export|CSV Import and Export]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Gramps Spreadsheet Import/Export|Gramps Spreadsheet Import/Export]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Export|Export]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Import|Import]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#People|People]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Marriage|Marriage]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Family|Family]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Place|Place]]
##[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Details|Details]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Example CSV with multiple areas|Example CSV with multiple areas]]
###[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Example_CSV_from_Spreadsheet|Example CSV from Spreadsheet]]<hr>

#[[Gramps_6.0_Wiki_Manual_-_Probably_Alive|Probably Alive]]
##[[Gramps_6.0_Wiki_Manual_-_Probably_Alive#How_does_Gramps_determine_if_someone_is_alive.3F|How does Gramps determine if someone is alive?]]
##[[Gramps_6.0_Wiki_Manual_-_Probably_Alive#Probably Alive Proxy|Probably Alive Proxy]]
##[[Gramps_6.0_Wiki_Manual_-_Probably_Alive#Probably Alive Filter|Probably Alive Filter]]
##[[Gramps_6.0_Wiki_Manual_-_Probably_Alive#Calendar Gramplet|Calendar Gramplet]]<hr>

#[[Gramps 6.0 Wiki Manual - Entering and editing data: brief|Entering and editing data: brief]]
##[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#To_add_or_edit_a_person|To add or edit a person]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#Add_a_new_person|Add a new person]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#Edit_an_existing_person|Edit an existing person]]
##[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#To_specify_a_relationship|To specify a relationship]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#Specifying a relationship using the Relationship View|Specifying a relationship using the Relationship View]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#Specifying a relationship using the Family List View|Specifying a relationship using the Family List View]]
##[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#To_specify_parents|To specify parents]]
##[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#To_specify_children|To specify children]]
##[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#Adding_photos_and_other_media_objects|Adding photos and other media objects]]
##[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_brief#To_edit_events.2C_sources.2C_places.2C_and_repositories|To edit events, sources, places, and repositories]]<hr>

#[[Gramps 6.0 Wiki Manual - Entering and editing data: detailed|Entering and editing data: detailed]]<hr>

##[[Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 1|Entering and editing data: detailed - part 1]] - ''Entering and editing data: detailed People, Relationships, Dates''
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_people|Editing information about people]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Person Editor dialog|Person Editor dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Preferred name section|Preferred name section]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Multiple_Surnames|Multiple Surnames]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#General section|General section]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Unknown_gender_specified_dialog|Unknown gender specified dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#ID|ID]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Tags|Tags]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Privacy|Privacy]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Preferred image|Preferred image]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit Person tab pages|Edit Person tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Events]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select Event selector|Select Event selector]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Names|Names]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Source Citations|Source Citations]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Attributes|Attributes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Addresses|Addresses]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Notes|Notes]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select Note selector|Select Note selector]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Gallery]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select Media Object selector|Select Media Object selector]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet|Internet]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet_Address_Editor|Internet Address Editor]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Associations|Associations]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Person Reference Editor|Person Reference Editor]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Person_selector|Select Person selector]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|LDS]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#References|References]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_relationships|Editing information about relationships]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family Editor dialog|Family Editor dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select Father selector|Select Father selector]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select Mother selector|Select Mother selector]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family Editor tab pages|Family Editor tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Children|Children]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select Child selector|Select Child selector]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Child Reference Editor|Child Reference Editor]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Source Citations tab|Source Citations tab]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Notes tab|Notes tab]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Events]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Source Citations|Source Citations]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Attributes|Attributes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Notes|Notes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Gallery]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|LDS]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS Ordinance Editor|LDS Ordinance Editor]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|Editing dates]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date selection dialog|Date selection dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date_validity_indicators|Date validity indicators]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date Quality|Date Quality]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Date formats and parsing rules|Date formats and parsing rules]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Calendars|Calendars]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Swedish calendar|Swedish calendar]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Dual-dated dates|Dual-dated dates]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Alternate new year day|Alternate new year day]]<hr>

##[[Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 2|Entering and editing data: detailed - part 2]] - ''Entering and editing data: detailed Events, Media, Places, Source Citations, Notes''
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Editing information about events]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Event dialog|New Event dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Event tab pages|New Event tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Source Citations|Source Citations]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Gallery|Gallery]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Attributes|Attributes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#References|References]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_event_references|Editing event references]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Event Reference Editor dialog|Event Reference Editor dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Reference Information|Reference Information]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Reference Information tab pages|Reference Information tab pages]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#General|General]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Attributes|Attributes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Shared Information|Shared Information]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#General_2|General]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Source Citations_2|Source Citations]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Attributes_3|Attributes]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes_3]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Gallery_2|Gallery]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#References_2|References]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_media_objects|Editing information about media objects]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Media dialog|New Media dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Media tab pages|New Media tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Source Citations|Source Citations]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Attributes|Attributes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#References|References]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_media_object_references|Editing media object references]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_a_media_object_file_chooser|Select a media object file chooser]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Media Reference Editor dialog|Media Reference Editor dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Top section|Top section]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Top section tab pages|Top section tab pages]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#General|General]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Source Citations|Source Citations]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Attributes|Attributes]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Shared Information|Shared Information]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Shared Information tab pages|Shared Information tab pages]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#General|General]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#References|References]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Source Citations|Source Citations]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Attributes|Attributes]]
#######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_places|Editing information about places]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place Editor dialog|Place Editor dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place editor tab pages|Place editor tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Enclosed By|Enclosed By]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select Place selector|Select Place selector]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place Reference Editor|Place Reference Editor]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Alternative Names|Alternative Names]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Source Citations|Source Citations]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Gallery|Gallery]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Internet|Internet]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#References|References]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place Name Editor dialog|Place Name Editor dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats (for coordinates)]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|Editing information about sources]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Source dialog|New Source dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Source tab pages|New Source tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Gallery|Gallery]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Attributes|Attributes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Repositories|Repositories]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select Repository selector|Select Repository selector]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#References|References]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing source citations|Editing source citations]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select Source or Citation selector|Select Source or Citation selector]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Citation dialog|New Citation dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Citation information|Citation information]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select Source selector|Select Source selector]]
######[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Citation information section tab pages|Citation information section tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Shared source information|Shared source information]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_repositories|Editing information about repositories]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Repository dialog|New Repository dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New Repository tab pages|New Repository tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Addresses|Addresses]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Internet|Internet]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Notes|Notes]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#References|References]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_notes|Editing information about notes]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Note_editor_dialog|Note editor dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Note tab|Note tab]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#References tab|References tab]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Link Editor|Link Editor]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Note_markup_and_preformat_in_reports|Note markup and preformat in reports]]<hr>

##[[Gramps 6.0 Wiki Manual - Entering and editing data: detailed - part 3|Entering and editing data: detailed - part 3]] - ''Entering and editing data: detailed Names, Attributes, Addresses, Merging''
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name Editor dialog|Name Editor dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Type|Type]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Given Name(s) Section|Given Name(s) Section]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Family_Names_Section|Family Names Section]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name Editor tab pages|Name Editor tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#General|General]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Source Citations|Source Citations]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Note|Notes]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes|Attributes]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attribute Editor dialog|Attribute Editor dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attribute Editor tab pages|Attribute Editor tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Source Citations|Source Citations]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Notes|Notes]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Addresses|Addresses]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Address Editor dialog|Address Editor dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Address Editor tab pages|Address Editor tab pages]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Source Citations|Source Citations]]
#####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Notes|Notes]]
###[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merging_records|Merging records]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_People|Merge People]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Families|Merge Families]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Events|Merge Events]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Sources|Merge Sources]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Citations|Merge Citations]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Places|Merge Places]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Media_Objects|Merge Media Objects]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Repositories|Merge Repositories]]
####[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Notes|Merge Notes]]<hr>

#[[Gramps 6.0 Wiki Manual - Navigation|Navigation]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_People_Category|Using the People Category]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Relationships_Category|Using the Relationships Category]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Families_Category|Using the Families Category]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Charts_Category|Using the Charts Category]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_Gramplets|Using Gramplets]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Home_Person|Setting the Home Person]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Setting the Active Person]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_history-based_Navigation|Using history-based Navigation]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Bookmarks|Bookmarks]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Finding_records|Finding records]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Jump_to_by_Gramps_ID|Jump to by Gramps ID]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Clipboard|Using the Clipboard]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Clipboard_context_menu|Clipboard context menu]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Addon_Manager...|Using the Addon Manager...]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Addon_Manager...|Addon Manager...]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Addons|Addons]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Settings|Settings]]
#####[[Gramps_6.0_Wiki_Manual_-_Navigation#Available_Gramps_Updates_for_Addons|Available Gramps Updates for Addons]]
######[[Gramps_6.0_Wiki_Manual_-_Navigation#Progress_Information_window|Progress Information window]]
######[[Gramps_6.0_Wiki_Manual_-_Navigation#Done_downloading_and_installing_addons_dialog|Done downloading and installing addons dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Projects|Projects]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Main_Menus|Main Menus]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Family_Trees|Family Trees]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Add|Add]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Edit|Edit]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#View|View]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Go|Go]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Bookmarks|Bookmarks]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Reports|Reports]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Tools|Tools]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Windows|Windows]]
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Help|Help]]
##[[Gramps_6.0_Wiki_Manual_-_Navigation#Toolbar|Toolbar]]<hr>
###[[Gramps_6.0_Wiki_Manual_-_Navigation#Common_Toolbar_buttons|Common Toolbar buttons]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Manage_databases|Manage databases]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#.E2.96.BC_Connect_to_a_recent_database|▼ Connect to a recent database]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Go_to_the_previous_object_in_the_history|Go to the previous object in the history]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Go_to_the_next_object_in_the_history|Go to the next object in the history]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Go_to_the_home_person|Go to the home person]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Add_a_new...|Add a new...]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Edit_the_selected...|Edit the selected...]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Delete_the_selected...|Delete the selected...]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Merge_the_selected...|Merge the selected...]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Tag_the_selected_rows|Tag the selected rows]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_the_Clipboard_dialog|Open the Clipboard dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Configure_the_active_view|Configure the active view]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_the_reports_dialog|Open the reports dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_the_tools_dialog|Open the tools dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_Addon_Manager|Open Addon Manager]]
####[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_Preferences|Open Preferences]]<hr>

#[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|Plugin Manager]]
##[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#Registration_and_loading|Registration and loading]]
##[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#Plugin_Manager_dialog|Registration and loading]]
###[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#Registered_Plugins|Registered Plugins]]
###[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#Loaded_Plugins|Loaded Plugins]]
##[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#Actions|Actions]]
###[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#Hide.2FUnhide|Hide/Unhide]]
###[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#Detailed_Info_dialog|Detailed Info dialog]]
##[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#Plugin_types|Plugin types]]
###[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#User_Plugins|User Plugins]]
###[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#System_Plugins|System Plugins]]
##[[Gramps_6.0_Wiki_Manual_-_Plugin_Manager#User_mode_or_Developer_mode|User mode or Developer mode]]<hr>

#[[Gramps_6.0_Wiki_Manual_-_Gramplets|Gramplets]]
##[[Gramps_6.0_Wiki_Manual_-_Gramplets#What_is_a_Gramplet|What is a Gramplet]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#General_Usage_and_Configuration|General Usage and Configuration]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Summary_of_Gramplets|Summary of Gramplets]]
####[[Gramps_6.0_Wiki_Manual_-_Gramplets#Gramplet_List|Gramplet List]]
##[[Gramps_6.0_Wiki_Manual_-_Gramplets#Gramplets|Gramplets]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#2-Way_Fan_Chart|2-Way Fan Chart]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Age_on_Date|Age on Date]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Age_Stats|Age Stats]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Ancestors|Ancestors]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Calendar|Calendar]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Children|Children]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Descendant_Fan_Chart|Descendant Fan Chart]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Descendants|Descendants]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Details|Details]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Events|Events]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Events_Coordinates|Events Coordinates]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Fan_Chart|Fan Chart]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#FAQ|FAQ]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Filter|Filter]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Given_Name_Cloud|Given Name Cloud]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Image_Metadata|Image Metadata]]
####[[Gramps_6.0_Wiki_Manual_-_Gramplets#The interface|The interface]]
#####[[Gramps_6.0_Wiki_Manual_-_Gramplets#Data Fields|Data Fields]]
#####[[Gramps_6.0_Wiki_Manual_-_Gramplets#Buttons|Buttons]]
####[[Gramps_6.0_Wiki_Manual_-_Gramplets#Prerequisites|Prerequisites]]
####[[Gramps_6.0_Wiki_Manual_-_Gramplets#Usage scenario|Usage scenario]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Locations|Locations]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Pedigree|Pedigree]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Preview|Preview]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Quick_View|Quick View]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Records|Records]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#References|References]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Relatives|Relatives]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Residence|Residence]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Session_Log|Session Log]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#SoundEx|SoundEx]]
####[[Gramps_6.0_Wiki_Manual_-_Gramplets#Soundex what is this?|Soundex what is this?]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Statistics|Statistics]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Surname_Cloud|Surname Cloud]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#To_Do|To Do]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Top_Surnames|Top Surnames]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Uncollected_Objects|Uncollected Objects]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#Welcome|Welcome]]
###[[Gramps_6.0_Wiki_Manual_-_Gramplets#What.27s_Next|What's Next]]<hr>

#[[Gramps 6.0 Wiki Manual - Reports|Reports]] - Index and Summary.<hr>

##[[Gramps 6.0 Wiki Manual - Reports - part 1|Generating Reports]]
###[[Gramps 6.0 Wiki Manual - Reports - part 1#Report Settings|Report Settings]]
###[[Gramps 6.0 Wiki Manual - Reports - part 1#Report Format Style|Report Format Style]]<hr>

##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Substitution_Values|Substitution Values]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#The Substitution Keys|The Substitution Keys]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Other Substitution Keys|Other Substitution Keys]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Default displayed formats|Default displayed formats]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Deprecated variables|Deprecated variables]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Format Strings|Format Strings]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Formatting names|Formatting names]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Formatting Dates|Formatting Dates]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Formatting Places|Formatting Places]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Rules for format strings|Rules for format strings]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Control Variables|Control Variables]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Grouping|Grouping]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Rules for groups|Rules for groups]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Examples|Examples]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Attributes|Attributes]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Events|Events]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Event format strings|Event format strings]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Notes for attributes and events|Notes for attributes and events]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_2#Separators|Separators]]<hr>

##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Books|Books]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Manage_Books_dialog|Manage Books dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Book name|Book name]]
#####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Book name toolbar|Book name toolbar]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Available items|Available items]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Available items selections|Available items selections]]
#####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Alphabetical Index|Alphabetical Index]]
#####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Custom Text|Custom Text]]
#####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Table of contents|Table of contents]]
#####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Title Page|Title Page]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Current book|Current book]]
#####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Current book toolbar|Current book toolbar]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Generate_Book_dialog|Generate Book dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Paper Options|Paper Options]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_3#Document Options|Document Options]]<hr>

##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Graphical_Reports|Graphical Reports]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Common options|Common options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Paper Options|Paper Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Document Options|Document Options]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Scale_and_Resize_options|Scale and Resize options]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Scale tree to fit:|Scale tree to fit:]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Resize Page to Fit Tree size|Resize Page to Fit Tree size]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#inter-box Y scale factor|inter-box Y scale factor]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#box shadow scale factor|box shadow scale factor]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Know what you want to print on|Know what you want to print on]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Ancestor Tree|Ancestor Tree]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Tree Options|Tree Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Display|Display]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Size|Size]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Include|Include]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Calendar|Calendar]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Content Options|Content Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Text Options|Text Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Descendant Tree|Descendant Tree]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Tree Options|Tree Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Display|Display]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Replace|Replace]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Size|Size]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Include|Include]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Family Descendant Tree|Family Descendant Tree]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Tree Options|Tree Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Display|Display]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Replace|Replace]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Size|Size]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Include|Include]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Fan Chart|Fan Chart]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Report Options|Report Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Statistics Charts|Statistics Charts]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Charts 1|Charts 1]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Charts 2|Charts 2]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Timeline Chart|Timeline Chart]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_4#Report Options|Report Options]]<hr>

##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Graphs|Graphs]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Common Options|Common Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Graphviz Layout|Graphviz Layout]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Graphviz Options|Graphviz Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Note|Note]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Family Lines Graph|Family Lines Graph]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Report Options (2)|Report Options (2)]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#People of Interest|People of Interest]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Include|Include]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Family Colors|Family Colors]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Individuals|Individuals]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Hourglass Graph|Hourglass Graph]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Report Options|Report Options]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Report_Options_.282.29_2|Report Options (2)]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Graph Style|Graph Style]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Relationship Graph|Relationship Graph]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Report Options|Report Options]]
####[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_5#Report_Options_.282.29_3|Report Options (2)]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Include|Include]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Graph Style|Graph Style]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_5#Example|Example]]<hr>

##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Text_Reports|Text Reports]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Common options|Common options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Paper Options|Paper Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Document Options|Document Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Ahnentafel Report|Ahnentafel Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Birthday and Anniversary Report|Birthday and Anniversary Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Text Options|Text Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Complete Individual Report|Complete Individual Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Include|Include]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Sections|Sections]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Database_Summary_Report|Database Summary Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Descendant Report|Descendant Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Detailed Ancestral Report|Detailed Ancestral Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Content|Content]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Include|Include]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Missing information|Missing information]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Detailed Descendant Report|Detailed Descendant Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Content|Content]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Include|Include]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Missing information|Missing information]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#End of Line Report|End of Line Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Family Group Report|Family Group Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Include|Include]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Missing information|Missing information]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Kinship Report|Kinship Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Note_Link_Report|Note Link Report]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Number_of_Ancestors_Report|Number of Ancestors Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Place_Report|Place Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Records_Report|Records Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Person Records|Person Records]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Family Records|Family Records]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Tag_Report|Tag Report]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_6#Report Options|Report Options]]<hr>

##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_7#Web_Pages|Web Pages]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Narrated Web Site|Narrated Web Site]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Dialog tabs|Dialog tabs]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Report Options|Report Options]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#HTML_Options|HTML Options]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Display|Display]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Page Generation|Page Generation]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Extra_Pages|Extra Pages]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Images_Generation|Images Generation]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Download|Download]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Advanced Options|Advanced Options]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Include|Include]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Place Map Options|Place Map Options]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Other_inclusion_.28CMS.2C_web_calendar.2C_PHP.29|Other inclusion (CMS, web calendar, PHP)]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Translations|Translations]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Calendar_Options|Calendar Options]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Example Web Site output|Example Web Site output]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Home|Home]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Introduction|Introduction]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Individuals|Individuals]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Surnames|Surnames]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Families|Families]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Events|Events]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Places|Places]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Sources|Sources]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Repositories|Repositories]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Media|Media]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Thumbnails|Thumbnails]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Download|Download]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Address Book|Address Book]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Contact|Contact]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Prerequisites_for_Narrated_Web_Site|Prerequisites for Narrated Web Site]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Possible_problems|Possible problems]]
###[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Web Calendar|Web Calendar]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Dialog tabs|Dialog tabs]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Report_Options_2|Report Options]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Report_Options_.282.29|Report Options (2)]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Content Options|Content Options]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Advanced_Options_2|Advanced Options]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Jan - Jun Notes|Jan - Jun Notes]]
#####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Jul - Dec Notes|Jul - Dec Notes]]
####[[Gramps 6.0 Wiki Manual - Reports_-_part_7#Example_Web_Site_output_2|Example Web Site output]]<hr>

##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quick Views]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#All_Events|All Events]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#All_Family_Events|All Family Events]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#On_This_Day|On This Day]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Father_lineage|Father lineage]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Mother_lineage|Mother lineage]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Siblings|Siblings]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Relation_to_Home_Person|Relation to Home Person]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Same_Given_Names|Same Given Names]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Same_Surnames|Same Surnames]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Person_References|Person References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Family_References|Family References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Event_References|Event References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Place_References|Place References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Source_References|Source References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Citation_References|Citation References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Repository_References|Repository References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Media_References|Media References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Link_References|Link References]]
###[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Note_References|Note References]]
##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_View_Gramplet|Quick View Gramplet]]
##[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Making your own Quick view|Making your own Quick view]]<hr>

#[[Gramps_6.0_Wiki_Manual_-_Tools|Tools]]
##[[Gramps_6.0_Wiki_Manual_-_Tools#Tool_Selection_dialog|Tool Selection dialog]]
##[[Gramps 6.0 Wiki Manual - Tools#Analysis and Exploration|Analysis and Exploration]]
###[[Gramps 6.0 Wiki Manual - Tools#Compare Individual Events|Compare Individual Events]]
####[[Gramps 6.0 Wiki Manual - Tools#Event_comparison_filter_selection_dialog|Event comparison filter selection dialog]]
####[[Gramps 6.0 Wiki Manual - Tools#Event_Comparison_Results_dialog|Event Comparison Results dialog]]
##[[Gramps 6.0 Wiki Manual - Tools#Family Tree Processing|Family Tree Processing]]
###[[Gramps 6.0 Wiki Manual - Tools#Edit Database Owner Information|Database Owner Information]]
###[[Gramps 6.0 Wiki Manual - Tools#Extract Event Description|Extract Event Description]]
###[[Gramps 6.0 Wiki Manual - Tools#Extract Information from Names|Extract Information from Names]]
###[[Gramps 6.0 Wiki Manual - Tools#Extract Place Data from a Place Title|Extract Place Data from a Place Title]]
###[[Gramps 6.0 Wiki Manual - Tools#Find Possible Duplicate People|Find Possible Duplicate People]]
####[[Gramps 6.0 Wiki Manual - Tools#Potential_Merges|Potential Merges]]
###[[Gramps 6.0 Wiki Manual - Tools#Fix Capitalization of Family Names|Fix Capitalization of Family Names]]
###[[Gramps_6.0_Wiki_Manual_-_Tools#Merge citations|Merge citations]]
###[[Gramps 6.0 Wiki Manual - Tools#Rename Event Types|Rename Event Types]]
###[[Gramps 6.0 Wiki Manual - Tools#Reorder Gramps ID|Reorder Gramps ID]]
###[[Gramps 6.0 Wiki Manual - Tools#Sort_Events|Sort Events]]
##[[Gramps 6.0 Wiki Manual - Tools#Family Tree Repair|Family Tree Repair]]
###[[Gramps 6.0 Wiki Manual - Tools#Check and Repair Database|Check and Repair Database]]
####[[Gramps_6.0_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_6.0_Wiki_Manual_-_Tools#Rebuild Gender Statistics|Rebuild Gender Statistics]]
###[[Gramps 6.0 Wiki Manual - Tools#Rebuild Reference Maps|Rebuild Reference Maps]]
###[[Gramps 6.0 Wiki Manual - Tools#Rebuild Secondary Indices|Rebuild Secondary Indices]]
###[[Gramps 6.0 Wiki Manual - Tools#Remove Unused Objects|Remove Unused Objects]]
##[[Gramps 6.0 Wiki Manual - Tools#Utilities|Utilities]]
###[[Gramps 6.0 Wiki Manual - Tools#Media Manager|Media Manager]]
####[[Gramps 6.0 Wiki Manual - Tools#Replace substrings in the path|Replace substrings in the path]]
####[[Gramps 6.0 Wiki Manual - Tools#Convert paths from relative to absolute|Convert paths from relative to absolute]]
####[[Gramps 6.0 Wiki Manual - Tools#Convert paths from absolute to relative|Convert paths from absolute to relative]]
####[[Gramps 6.0 Wiki Manual - Tools#Add images not included in database|Add images not included in database]]
###[[Gramps 6.0 Wiki Manual - Tools#Not Related|Not Related]]
###[[Gramps 6.0 Wiki Manual - Tools#Relationship Calculator|Relationship Calculator]]
###[[Gramps 6.0 Wiki Manual - Tools#Verify the Data|Verify the Data]]
####[[Gramps 6.0 Wiki Manual - Tools#Verify the Data tab pages|Verify the Data tab pages]]
#####[[Gramps 6.0 Wiki Manual - Tools#General|General]]
#####[[Gramps 6.0 Wiki Manual - Tools#Women|Women]]
#####[[Gramps 6.0 Wiki Manual - Tools#Men|Men]]
#####[[Gramps 6.0 Wiki Manual - Tools#Families|Families]]
####[[Gramps 6.0 Wiki Manual - Tools#Data Verification Results window|Data Verification Results window]]
####[[Gramps 6.0 Wiki Manual - Tools#Examples|Examples]]
###[[Gramps_6.0_Wiki_Manual_-_Tools#Find database loop|Find database loop]]
##[[Gramps 6.0 Wiki Manual - Tools#Debug|Debug]]
###[[Gramps 6.0 Wiki Manual - Tools#Check Localized Date Displayer and Parser|Check Localized Date Displayer and Parser]]
###[[Gramps 6.0 Wiki Manual - Tools#Dump Gender Statistics|Dump Gender Statistics]]
###[[Gramps 6.0 Wiki Manual - Tools#Generate Testcases for Persons and Families|Generate Testcases for Persons and Families]]
###[[Gramps 6.0 Wiki Manual - Tools#Populate Sources and Citations|Populate Sources and Citations]]<hr>

#[[Gramps 6.0 Wiki Manual - Settings|Settings]]
##[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]
#####[[Gramps_6.0_Wiki_Manual_-_Settings#Display Name Editor|Display Name Editor]]
#####[[Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Input_Options|Input Options]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#General|General]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Environment_Settings|Environment Settings]]
#####[[Gramps_6.0_Wiki_Manual_-_Settings#Environment_Settings|Enable spell checker]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Tip of the Day dialog|Tip of the Day dialog]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Location|Database Location]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]
#####[[Gramps_6.0_Wiki_Manual_-_Settings#Select_media_directory_dialog|Select media directory dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Settings#Missing_Media_Objects_.27broken_link.27_icon_of_a_box_with_a_red_.27x.27|Missing Media Objects 'broken link' icon of a box with a red 'x']]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Import|Import]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Tag_Records|Tag Records]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Source_GEDCOM_import|Source GEDCOM import]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Calculation_limits|Calculation limits]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Colors_used_for_boxes_in_the_graphical_views|Colors used for boxes in the graphical views]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Colors_for_Male_persons|Colors for Male persons]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Colors_for_Female_persons|Colors for Female persons]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Colors_for_people_who_are_neither_male_nor_female|Colors for people who are neither male nor female]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Colors_for_Unknown_persons|Colors for Unknown persons]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Colors_for_Family_nodes|Colors for Family nodes]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Other_colors|Other colors]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Genealogical_Symbols|Genealogical Symbols]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]]
#####[[Gramps_6.0_Wiki_Manual_-_Settings#Initial_setup|Initial setup]]
#####[[Gramps_6.0_Wiki_Manual_-_Settings#Prerequisite|Prerequisite]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Text|Text]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Warnings|Warnings]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher]]
##[[Gramps_6.0_Wiki_Manual_-_Settings#Other_settings|Other settings]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Sorting_columns|Sorting columns]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Setting_Home_person|Setting Home person]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Adjusting_viewing_controls|Adjusting viewing controls]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export View]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Export_View_as_Spreadsheet_dialog|Export View as Spreadsheet dialog]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Modularity_and_plugins|Modularity and plugins]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Customize report output formats|Customize report output formats]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Document Styles dialog|Document Styles dialog]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Style editor dialog|Style editor dialog]]
#####[[Gramps_6.0_Wiki_Manual_-_Settings#Style editor dialog tabs|Style editor dialog tabs]]
######[[Gramps_6.0_Wiki_Manual_-_Settings#Description|Description]]
######[[Gramps_6.0_Wiki_Manual_-_Settings#Font options|Font options]]
######[[Gramps_6.0_Wiki_Manual_-_Settings#Paragraph options|Paragraph options]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Context_menu|Context menu]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Selector_dialogs|Selector dialogs]]
##[[Gramps_6.0_Wiki_Manual_-_Settings#Customizing|Customizing]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Color_Palette|Color Palette]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Color_Gradient|Color Gradient]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#File_Chooser|File Chooser]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Context_Menu_options|Context Menu options]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Breadcrumbs_and_text-entry_address_bar|Breadcrumbs and text-entry address bar]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Bookmarking_file_folders|Bookmarking file folders]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#File_Formats|File Formats]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#See_also|See also]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Language|Language]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Linux|Linux]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#macOS|macOS]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#MS Windows|MS Windows]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Add_Windows_OS_Menu_Item|Add Windows OS Menu Item]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Change_the_windows_LANG_variables|Change the windows LANG variables]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Language_codes|Language codes]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings|Advanced manipulation of settings]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Example_gramps.ini_file|Example gramps.ini file]]
####[[Gramps_6.0_Wiki_Manual_-_Settings#Advanced_backup_filename_setting|Advanced backup filename setting]]
###[[Gramps_6.0_Wiki_Manual_-_Settings#Theme|Theme]]<hr>

#[[Gramps 6.0 Wiki Manual - Filters|Filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Filter vs. Search|Filter vs. Search]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Regular Expressions|Regular Expressions]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Groups and Sets|Groups and Sets]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Examples|Examples]]
####[[Gramps_6.0_Wiki_Manual_-_Filters#Common variations of a surname|Common variations of a surname]]
####[[Gramps_6.0_Wiki_Manual_-_Filters#testing regular expressions|testing regular expressions]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Custom_Filters|Custom Filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Which_filters_in_which_Category.3F|Which filters in which Category?]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Ancestral filters|Ancestral filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Child filters|Child filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Citation.2Fsource_filters|Citation/sources filters]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Persons-, and Relationship Category|Persons-, and Relationship Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Families Category|Families Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Events Category|Events Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Places Category|Places Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Media Category|Media Category]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Descendant filters|Descendant filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Event filters|Event filters]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Persons-, and Relationship Category|Persons-, and Relationship Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Families Category|Families Category]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Family filters|Family filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Father filters|Father filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#General_filters|General filters]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Persons-, and Relationship Category|Persons-, and Relationship Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Families Category|Families Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Events Category|Events Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Places Category|Places Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Sources Category|Sources Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Citations Category|Citations Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Repositories Category|Repositories Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Media Category|Media Category]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Notes Category|Notes Category]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Mother filters|Mother filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Position filters|Position filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Source_filters|Source filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Relationship_filters|Relationship filters]]
##[[Gramps_6.0_Wiki_Manual_-_Filters#Tagging|Tagging]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Concept|Concept]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Differences_with_markers|Differences with markers]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Tags_and_Filters|Tags and Filters]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Operations_with_tags|Operations with tags]]
####[[Gramps_6.0_Wiki_Manual_-_Filters#Filtering|Filtering]]
####[[Gramps_6.0_Wiki_Manual_-_Filters#Tagging_a_selection_of_objects|Tagging a selection of objects]]
###[[Gramps_6.0_Wiki_Manual_-_Filters#Tags_Column|Tags Column]]
<hr>

:Appendix A: [[Gramps_6.0_Wiki_Manual_-_FAQ|Frequently Asked Questions]]
:::[[Gramps_6.0_Wiki_Manual_-_FAQ#General|General]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#What_is_Gramps.3F|What is Gramps?]]

::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Where_do_I_get_it_and_how_much_does_it_cost.3F|Where do I get it and how much does it cost?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Do_I_need_to_register_as_a_user_to_use_Gramps.2C_I_am_not_a_programmer.3F|Do I need to register as a user to use Gramps, I am not a programmer?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Does_Gramps_exist_in_other_languages.3F|Does Gramps exist in other languages?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#How_do_I_keep_backups.3F|How do I keep backups?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Does_Gramps_support_Unicode_fonts.3F|Does Gramps support Unicode fonts?]]

:::[[Gramps_6.0_Wiki_Manual_-_FAQ#Installation|Installation]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#What_is_needed_to_install_Gramps_under_Linux.2C_Solaris.2C_or_FreeBSD.3F|What is needed to install Gramps under Linux, Solaris, or FreeBSD?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Does_Gramps_work_on_Windows.3F|Does Gramps work on Windows?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Does_Gramps_work_on_the_Mac.3F|Does Gramps work on the Mac?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Does_Gramps_work_on_my_mobile_device.3F|Does Gramps work on my mobile device?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Does_Gramps_work_on_my_Google_Chromebook.3F|Does Gramps work on my Google Chromebook?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#What_are_the_Minimum_Specs_to_run_Gramps.3F|What are the Minimum Specs to run Gramps?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#How_do_I_upgrade_Gramps.3F|How do I upgrade Gramps?]]
:::[[Gramps_6.0_Wiki_Manual_-_FAQ#Preferences|Preferences]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Can_I_change_the_dates_in_reports_to_.27day_month_year.27.3F|Can I change the dates in reports to 'day month year'?]]
:::[[Gramps_6.0_Wiki_Manual_-_FAQ#Collaboration-Portability|Collaboration-Portability]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Is_Gramps_compatible_with_other_genealogical_software.3F|Is Gramps compatible with other genealogical software?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Can_Gramps_read_files_created_by_other_genealogy_programs.3F|Can Gramps read files created by other genealogy programs?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Can_Gramps_write_files_readable_by_other_genealogy_programs.3F|Can Gramps write files readable by other genealogy programs?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#What_standards_does_Gramps_support.3F|What standards does Gramps support?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#How_do_I_import_data_from_another_genealogy_program_into_Gramps.3F|How do I import data from another genealogy program into Gramps?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Can_I_install_Gramps_on_a_Linux_Web_Server_and_use_it_via_a_web_browser.3F|Can I install Gramps on a Linux Web Server and use it via a web browser?]]
:::[[Gramps_6.0_Wiki_Manual_-_FAQ#Reports|Reports]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Can_Gramps_print_a_genealogical_tree_for_my_family.3F|Can Gramps print a genealogical tree for my family?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#In_what_formats_can_Gramps_output_its_reports.3F|In what formats can Gramps output its reports?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#How_can_I_change_the_default_language_in_reports.3F|How can I change the default language in reports?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Is_Gramps_compatible_with_the_Internet.3F|Is Gramps compatible with the Internet?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Can_I_create_custom_reports.2Ffilters.2Fwhatever.3F|Can I create custom reports/filters/whatever?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Why_are_non-Latin_characters_displayed_as_garbage_in_PDF.2FPS_reports.3F|Why are non-Latin characters displayed as garbage in PDF/PS reports?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#I_would_like_to_contribute_to_Gramps_by_writing_my_favorite_report._How_do_I_do_that.3F|I would like to contribute to Gramps by writing my favorite report. How do I do that?]]
:::[[Gramps_6.0_Wiki_Manual_-_FAQ#Database_-_Gramps_file_formats|Database - Gramps file formats]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#What_is_the_maximum_database_size_.28bytes.29_Gramps_can_handle.3F|What is the maximum database size (bytes) Gramps can handle?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#How_many_people_can_Gramps_database_handle.3F|How many people can Gramps database handle?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#My_database_is_really_big._Is_there_a_way_around_loading_all_the_data_into_memory.3F|My database is really big. Is there a way around loading all the data into memory?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Can_I_run_Gramps_from_a_database_on_a_NFS_share.3F|Can I run Gramps from a database on a NFS share?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#What_does_.22portable.22_mean.3F|What does "portable" mean?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Why_is_the_database_format_.28GRDB.29_not_portable.3F|Why is the database format (GRDB) not portable?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#Does_Gramps_have_an_Example_Tree.3F|Does Gramps have an Example Tree?]]
:::[[Gramps_6.0_Wiki_Manual_-_FAQ#Bugs_and_requests|Bugs and requests]]
::::[[Gramps_6.0_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_6.0_Wiki_Manual_-_FAQ#Requests|Requests]]
:::[[Gramps_6.0_Wiki_Manual_-_FAQ#Adding_to_and_editing_my_database|Adding to and editing my database]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#What_is_the_difference_between_a_residence_and_an_address.3F|What is the difference between a residence and an address?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#How_do_I_change_the_order_of_children.3F|How do I change the order of children?]]
::::[[Gramps_6.0_Wiki_Manual_-_FAQ#How_do_I_change_the_order_of_spouses.3F|How do I change the order of spouses?]]
<hr>

:Appendix B: [[Gramps 6.0 Wiki Manual - Keybindings|Keybindings reference]] - (also known as Keyboard shortcuts or hotkeys)
:::[[Gramps_6.0_Wiki_Manual_-_Keybindings#List_Views|List Views]]
::::[[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_bindings|Common bindings]]
::::[[Gramps_6.0_Wiki_Manual_-_Keybindings#All_List_Views_bindings|All List Views bindings]]
::::[[Gramps_6.0_Wiki_Manual_-_Keybindings#People_View_bindings|People View bindings]]
:::[[Gramps_6.0_Wiki_Manual_-_Keybindings#Editors|Editors]]
::::[[Gramps_6.0_Wiki_Manual_-_Keybindings#Editor_Tab_bindings|Editor Tab bindings]]
::::[[Gramps_6.0_Wiki_Manual_-_Keybindings#Editor bindings|Editor bindings]]
:::[[Gramps_6.0_Wiki_Manual_-_Keybindings#Handy_Shortcuts|Handy Shortcuts]]
:::[[Gramps_6.0_Wiki_Manual_-_Keybindings#Access_Key_Shortcuts|Access Key Shortcuts]]
:::[[Gramps_6.0_Wiki_Manual_-_Keybindings#See also|See also]]
<hr>

:Appendix C: [[Gramps 6.0 Wiki Manual - Command Line|Command line reference]]
:::[[Gramps 6.0 Wiki Manual - Command Line#|Start Gramps through the Command Line]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Linux|Linux]]
::::[[Gramps 6.0 Wiki Manual - Command Line#MS_Windows|MS Windows]]
::::[[Gramps 6.0 Wiki Manual - Command Line#macOS|macOS]]
:::[[Gramps 6.0 Wiki Manual - Command Line#Python_options|Python options]]
:::[[Gramps 6.0 Wiki Manual - Command Line#Available Options|Available options]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Format options|Format options]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Opening options|Opening options]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Import options|Import options]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Export options|Export options]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Action options|Action options]]
:::::[[Gramps 6.0 Wiki Manual - Command Line#report action option|report action option]]
:::::[[Gramps 6.0 Wiki Manual - Command Line#tool action option|tool action option]]
:::::[[Gramps 6.0 Wiki Manual - Command Line#book action option|book action option]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Force unlock option|Force unlock option]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Configuration (config) option|Configuration (config) option]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Safe mode|Safe mode]]
::::[[Gramps 6.0 Wiki Manual - Command Line#Defaults|Defaults]]
:::[[Gramps 6.0 Wiki Manual - Command Line#Operation|Operation]]
:::[[Gramps 6.0 Wiki Manual - Command Line#Examples|Examples]]
:::[[Gramps 6.0 Wiki Manual - Command Line#Environment variables|Environment variables]]
::::[[Gramps 6.0 Wiki Manual - Command Line#GRAMPSHOME|GRAMPSHOME]]
::::[[Gramps_6.0_Wiki_Manual_-_Command_Line#LANG.2C_LANGUAGE.2C_LC_MESSAGES.2C_LC_TIME|LANG, LANGUAGE, LC_MESSAGES, LC_TIME]]
::::[[Gramps_6.0_Wiki_Manual_-_Command_Line#GRAMPSI18N|GRAMPSI18N]]
::::[[Gramps_6.0_Wiki_Manual_-_Command_Line#GRAMPSDIR|GRAMPSDIR]]
::::[[Gramps_6.0_Wiki_Manual_-_Command_Line#GRAMPS_RESOURCES|GRAMPS_RESOURCES]]
<hr>

:Appendix D: [[Gramps_6.0_Wiki_Manual_-_User_Directory|User Directory]]
:::[[Gramps_6.0_Wiki_Manual_-_User_Directory#POSIX_-_style_systems|POSIX - style systems]]
::::[[Gramps_6.0_Wiki_Manual_-_User_Directory#macOS|macOS]]
:::::[[Gramps_6.0_Wiki_Manual_-_User_Directory#macOS_Application_Package|macOS Application Package]]
:::[[Gramps_6.0_Wiki_Manual_-_User_Directory#MS Windows|MS Windows]]
<hr>

:Appendix E: [[Gramps 6.0 Wiki Manual - Error and Warning Reference|Error and Warning Reference]]
:::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#When_something_goes_wrong|When something goes wrong]]
:::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Alerts|Alerts]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Are you sure you want to upgrade this Family Tree?|Are you sure you want to upgrade this Family Tree?]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Cannot open database|Cannot open database]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Low level database corruption detected|Low level database corruption detected]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Error detected in database|Error detected in database]]
:::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Warnings|Warnings]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Gramps_Warnings_dialog|Gramps Warnings dialog]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Locale warnings|Locale warnings]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Module not loaded warnings|Module not loaded warnings]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Show_plugin_status_dialog_on_plugin_load_error.|Show plugin status dialog on plugin load error.]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Configuration warnings|Configuration warnings]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Other warnings|Other warnings]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Cannot_save_person|Cannot save person]]
:::::[[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Cannot_merge_.3Cobject.3E|Cannot merge <object>]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Duplicate Family warning dialog|Duplicate Family warning dialog]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Suppress_warning_when_adding_parents_to_a_child|Suppress warning when adding parents to a child]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Suppress_warning_when_cancelling_with_changed_data|Suppress warning when cancelling with changed data]]
::::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Save_Changes.3F_dialog|Save Changes? dialog]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#_Error_and_Warning_Reference#Suppress_warning_about_missing_researcher_when_exporting_to_GEDCOM|Suppress warning about missing researcher when exporting to GEDCOM]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Undo_history_warning|Undo history warning]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#No_selected_book_item|No selected book item]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Person_.3C_.3E_is_not_in_the_Database|Person <____> is not in the Database]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Autobackup...|Autobackup...]]
:::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Errors|Errors]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Error Report|Error Report]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Error Reporting Assistant dialog|Error Reporting Assistant dialog]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Report_a_bug_page|Report a bug page]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Error Details page|Error Details page]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#System Information page|System Information page]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Further Information page|Further Information page]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Bug Report Summary page|Bug Report Summary page]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Send Bug Report page|Send Bug Report page]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Complete page|Complete page]]
:::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Seeing all the error messages|Seeing all the error messages]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Linux|Linux]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#MS_Windows|MS Windows]]
::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#macOS|macOS]]
:::::[[Gramps 6.0 Wiki Manual - Error and Warning Reference#Console_application|Console application]]
<hr>

:Appendix F: [[Gramps 6.0 Wiki Manual - Further References|Further References]]
:::[[Gramps_6.0_Wiki_Manual_-_Further_References#User_References|User References]]
:::[[Gramps_6.0_Wiki_Manual_-_Further_References#Programmers_References|Programmers References]]
:::[[Gramps_6.0_Wiki_Manual_-_Further_References#Translators_References|Translators References]]
<hr>

:Appendix G: [[Gramps 6.0 Wiki Manual - About|About Gramps]]
:::[[Gramps_6.0_Wiki_Manual_-_About#About|About]]
::::[[Gramps_6.0_Wiki_Manual_-_About#Original author|Original author]]
::::[[Gramps_6.0_Wiki_Manual_-_About#Contributors|Contributors]]
:::[[Gramps_6.0_Wiki_Manual_-_About#Have an issue or idea?|Have an issue or idea?]]
:::[[Gramps_6.0_Wiki_Manual_-_About#License|License]]
<hr>

{{man index|Gramps 6.0 Wiki Manual|Gramps 6.0 Wiki Manual - Preface|6.0}}
{{languages|Gramps 6.0 Wiki Manual}}

{{grampsmanualcopyright}}

[[Category:Documentation]]

Talk:FamilyGroups

2025-11-25T08:44:29Z

CallMeDave: /* Related email */

I suspect this is a very interesting plugin. But the documentation is still not as friendly as it could be. Is it about dividing groups of unrelated people in the same database? If someone could please provide some more basic examples I'd be grateful. Thanks for the work. --[[User:Lcc|Lcc]] 19:47, 4 April 2009 (UTC)

Seems to me that try to display groups into a database.
People having a family link are into the same group (blood, partner, spouses, in law, half-siblings).
Personnaly, I was happy to find some ''disconnected groups'' (e.g a family) into my database !
It sounds like a mix between a management tool (attributes, display groups) and a report. --[[User:Romjerome]]

== Related email ==
* [https://sourceforge.net/p/gramps/mailman/message/21790649/ FamilyGroups - Third-party Plugins - soon], Jean François Chassé 2009-03-10
* [https://gramps-project.org/bugs/view.php?id=2409#c8615 mention on bug report]

Template:Version BSD

2025-11-22T07:48:52Z

CallMeDave:

6.0.6<noinclude>

''three digit BSD version number, including fullstops''

Current version of Gramps core is : {{version}}

[[BSD platforms]]

Validate against package in:

;FreeBSD and FreshPorts (maintained by: eduardo@FreeBSD.org )
* https://ports.freebsd.org/cgi/ports.cgi?query=gramps   2025-11-22 version 6.0.6
* https://www.freshports.org/search.php?query=gramps   2025-11-09 version 6.0.6

;NetBSD
* gramps-5.1.6nb2.tgz - 2024/01/10 13:03 18823kB https://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/earmv7hf/9.0/All/

;OpenBSD
* gramps-6.0.5 updated on 2025-11-22 https://openbsd.app/?search=gramps

==Usage==
<code><nowiki>{{Version_BSD}}</nowiki></code>

==To request an update==
If outdated, contact the Package Maintainer:
* _____________

Maintainer beginning ___: _______
* _________________________


[[Category:Developers/Packaging|B]]
[[Category:Versions|T]]
[[Category:templates|B]] </noinclude>

Template:Version BSD

2025-11-22T07:48:31Z

CallMeDave:

6.0.6<noinclude>

''three digit GrampsPortable for Windows version number, including fullstops''

Current version of Gramps core is : {{version}}

[[BSD platforms]]

Validate against package in:

;FreeBSD and FreshPorts (maintained by: eduardo@FreeBSD.org )
* https://ports.freebsd.org/cgi/ports.cgi?query=gramps   2025-11-22 version 6.0.6
* https://www.freshports.org/search.php?query=gramps   2025-11-09 version 6.0.6

;NetBSD
* gramps-5.1.6nb2.tgz - 2024/01/10 13:03 18823kB https://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/earmv7hf/9.0/All/

;OpenBSD
* gramps-6.0.5 updated on 2025-11-22 https://openbsd.app/?search=gramps

==Usage==
<code><nowiki>{{Version_BSD}}</nowiki></code>

==To request an update==
If outdated, contact the Package Maintainer:
* _____________

Maintainer beginning ___: _______
* _________________________


[[Category:Developers/Packaging|B]]
[[Category:Versions|T]]
[[Category:templates|B]] </noinclude>

Template:Version BSD

2025-11-22T07:47:41Z

CallMeDave: Update to current versions

6.0.6<noinclude>

''three digit GrampsPortable for Windows version number, including fullstops''

Current version of Gramps core is : {{version}}

[[BSD platforms]]

Validate against package in:

:FreeBSD and FreshPorts (maintained by: eduardo@FreeBSD.org )
* https://ports.freebsd.org/cgi/ports.cgi?query=gramps   2025-11-22 version 6.0.6
* https://www.freshports.org/search.php?query=gramps   2025-11-09 version 6.0.6

:NetBSD
* gramps-5.1.6nb2.tgz - 2024/01/10 13:03 18823kB https://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/earmv7hf/9.0/All/

:OpenBSD
* gramps-6.0.5 updated on 2025-11-22 https://openbsd.app/?search=gramps

==Usage==
<code><nowiki>{{Version_BSD}}</nowiki></code>

==To request an update==
If outdated, contact the Package Maintainer:
* _____________

Maintainer beginning ___: _______
* _________________________


[[Category:Developers/Packaging|B]]
[[Category:Versions|T]]
[[Category:templates|B]] </noinclude>

Download/ru

2025-11-22T07:41:48Z

CallMeDave:

{{languages/ru|Download}}
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]
{{man note|{{Man menu|Gramps '''{{version}}''' - '''{{version-released}}'''}}|{{-}}
[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#Mac_OS_X]] [[File:Bsd_daemon.png|128px|link=Download#BSD]]}}
{{stub}}
===Последняя выпущенная версия===
* Версия '''Gramps''' {{version}}.

Посетите страницы для получения инструкций по cледующим разделам:
* [[Installation/ru|Установка]]
* [[Installation#Upgrading_Gramps|Обновление]]

===Официально поддерживаются===
* Только платформа Linux поддерживается официально, так как разработчики Gramps используют и тестируют '''исходный код''' на этой платформе, решая проблемы, возникающие вследствие обновлений.

{| {{Prettytable}}
! Платформа
! Gramps Релиз
! Скачать
! Примечание
|-
|Linux
|Различные
|[[Installation/ru#Установка из исходных кодов|Установка из исходных кодов]]
|Необходима сборка Gramps из исходных кодов
|}

===Поддерживаются сообществом===
* Платформа считается поддерживаемой сообществом, если пользователи создали инсталлируемую версию для этой платформы. Полная функциональность Gramps не гарантируется, и некоторые компоненты могут быть отключены. Разработчики зависят от сообщества в плане решения любых возникающих проблем. Разработчики ставят своей целью иметь Gramps, работающую на всех платформах, но не обладают ресурсами для проведения отдельного тестирования ради обеспечения этого при выпуске нового версии.

{| {{Prettytable}}
! Платформа
! Gramps Релиз
! Скачать
! Примечание
|-
|Windows
|{{version_windows_AIO32}} (All In One) {{Needs backup}}
|[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe {{filename_windows_AIO32}}.exe]
|[http://gramps.1791082.n4.nabble.com/GrampsAIO-all-in-one-new-version-td3109286.html All In One Gramps including the dependencies for Windows] ([http://gramps.1791082.n4.nabble.com/Which-GTK-Runtime-version-for-windows-td3061299.html]) ('''Under Development''' by Josip / '''Please test on Windows and report back to the author.''') (2011-10-02)
|-
|Windows
|{{version_windows_AIO64}} (All In One) {{Needs backup}}
|[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe {{filename_windows_AIO64}}.exe] (46.2 MB)
| [[All In One Gramps Software Bundle for Windows |All In One Gramps]] includes all dependencies required for Windows x64 (2011-11-13)
|-
|Windows
|{{version_windows_portable}} {{Needs backup}}
|[http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (17.4 MB)
|[http://portableapps.com/apps/education/gramps_portable Переносимая Gramps для PortableApps.com] всё в одном без всяких зависимостей.('''Final''' by Bart.S / '''Please report issues to the author.''') (2010-12-09) (Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.)
|-
|
|
|
|
|-
|Linux
|{{version}}
|[[Installation/ru#Автоматическая закачка и установка Gramps|Автоматическая установка]]
|Зависит от используемой версии Linux
|-
|Linux
|{{version}}
|[[Installation/ru#Ручная закачка и установка Gramps|Ручная установка]]
|Зависит от используемой версии Linux
|-
|
|
|
|
|-
|Linux Live CD
|3.2.5
|[[Linux_Genealogy_CD#Obtaining_the_CD|ubuntu10.10 lgenealogy-6.1-desktop-i386.iso]] (693 Mio)
|[[Linux Genealogy CD|Linux Genealogy CD, базирующийся на Ubuntu 10.10 (Maverick Meerkat)]]
|-
|
|
|
|
|-
|BSD
|{{version_BSD}} {{Needs backup}}
|[[BSD_platforms|BSD]]
|[[BSD platforms|Информация, связанная с BSD]]
|-
|
|
|
|
|-
|Solaris
|{{version_solaris}} {{Needs backup}}
|[[Solaris_Platforms|Платформы Solaris]]
|Необходима сборка Gramps из исходных кодов
|-
| Mac OS X
|{{version_MacPort}} {{Needs backup}}
|[[Mac OS X:Build from source:MacPorts]]
|Новый и относительно не тестировавшийся
|-
|Mac OS X
|{{version_Mac}} {{Needs backup}}
|[[Mac_OS_X:Application_package|Использование Gramps на Apple Mac]]
|Новый и относительно не тестировавшийся
|}

[[Category:Ru:Documentation]]
[[Category:Developers/Installation]]
[[Category:Developers/Packaging]]

Download/it

2025-11-22T07:41:24Z

CallMeDave:

{{languages|Download}}
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]
{{man note|{{Man menu|Gramps '''{{version}}''' - '''{{version-released}}'''}}|{{-}}
[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#Mac_OS_X]] [[File:Bsd_daemon.png|128px|link=Download#BSD]]}}
{{stub}}
===Ultima versione rilasciata===
* La versione '''Gramps''' {{version}}. Tutte le versioni di Gramps sono disponibili sulla [{{github_url}}/releases pagina di download di GitHub].

Visitare le pagine seguenti per informazioni su:
* [[Installation]]
* [[Installation#Aggiornamento_di_GRAMPS|Aggiornamento]]
* [[Third-party_Addons|Addons]] - plugin di terze parti

===Officially supported===
* Solo la piattaforma Linux è ufficialmente supportata dagli sviluppatori di Gramps che utilizzano e testano il '''codice sorgente''' su questo sistema operativo, correggendo tutti i problemi che possono sorgere nei vari aggiornamenti.

{| {{Prettytable}}
! Piattaforma
! Gramps Release
! Download
! Note
|-
|Linux
|Assorted
|[[It:Installazione|Installazione dal codice sorgente]]
|Building of Gramps from source required
|}

===Supportato dalla comunità===
*Una piattaforma si intende supportata dalla comunità quando gli utenti hanno creato una versione installabile su quella determinato sistema operativo. Non sono garantite tutte le funzionalità come pienamente funzionanti ed alcuni componenti potrebbero non essere abilitati. Gli sviluppatori dipendono dalla comunità per risolvere ogni problema che possa emergere. Gli sviluppatori di Gramps desidererebbero che Gramps potesse funzionare su tutte le piattaforme, ma non hanno risorse sufficienti per effettuare test specifici e garantire i futuri rilasci nelle altre piattaforme.

{| {{Prettytable}}
! Piattaforma
! Versione di Gramps
! Download
! Note
|-
|Windows
|{{version_windows_AIO32}} (All In One) {{Needs backup}}
|[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe {{filename_windows_AIO32}}.exe]
|[http://gramps.1791082.n4.nabble.com/GrampsAIO-all-in-one-new-version-td3109286.html All In One GRAMPS including the dependencies for Windows] ([http://gramps.1791082.n4.nabble.com/Which-GTK-Runtime-version-for-windows-td3061299.html]) ('''Under Development''' by Josip / '''Please test on Windows and report back to the author.''') (2011-10-02)
|-
|Windows
|{{version_windows_AIO64}} (All In One) {{Needs backup}}
|[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe {{filename_windows_AIO64}}.exe] (46.2 MB)
| [[All In One Gramps Software Bundle for Windows |All In One GRAMPS]] includes all dependencies required for Windows x64 (2011-11-13)
|-
|Windows
|{{version_windows_portable}} {{Needs backup}}
|[http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (17.4 MB)
|[http://portableapps.com/apps/education/gramps_portable Portable GRAMPS from PortableApps.com] pacchetto unico senza necessità di installazione.('''Final''' by Bart.S / '''Please report issues to the author.''') (2010-12-09) (Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.)
|-
|
|
|
|
|-
|Linux
|{{version}}
|[[Installation#Automatic_download_and_install_of_GRAMPS|Installazione automatica]]
|Dipende dalla versione di Linux utilizzata
|-
|Linux
|{{version}}
|[[Installation#Manual_download_and_install_of_GRAMPS|Installazione manuale]]
|Dipende dalla versione di Linux utilizzata
|-
|
|
|
|
|-
|Linux Live CD
|3.2.5
|[[Linux_Genealogy_CD#Obtaining_the_CD|ubuntu10.10 lgenealogy-6.1-desktop-i386.iso]] (693 Mio)
|[[Linux Genealogy CD|Linux Genealogy CD basato su Ubuntu 10.10 (Maverick Meerkat)]]
|-
|
|
|
|
|-
|BSD
|{{version_BSD}} {{Needs backup}}
|[[BSD_platforms|BSD]]
|[[BSD platforms|BSD information]]
|-
|
|
|
|
|-
|Solaris
|{{version_solaris}} {{Needs backup}}
|[[Solaris_Platforms|Solaris platforms]]
|È necessario compilare il codice sorgente di GRAMPS
|-
|
|
|
|
|-
| Mac OS X
|{{version_MacPort}} {{Needs backup}}
|[[Mac OS X:Build from source:MacPorts|Mac OS X MacPorts]]
|Nuova versione (testata molto poco) (Marzo 2010)
|-
|Mac OS X
|{{version_Mac}} {{Needs backup}}
|[[Mac_OS_X:Application_package]]
|Nuova versione (testata molto poco)
|}

[[Category:It:Documentation]]
[[Category:Developers/Installation]]
[[Category:Developers/Packaging]]

Installation/lt

2025-11-22T07:41:08Z

CallMeDave:

{{languages|Installation}} 

==Live CD==
Jei jus domina Gramps programa, bet jums nepavyksta ar negalite jos įdiegti (ne jūsų asmeninis kompiuteris, OS „Windows“, neturite interneto namuose, darbinis nešiojamasis kompiuteris, ...), tuomet išbandykite mūsų [[Linux Genealogy CD|Linux genealogijos CD]]. Jis pasileidžia be diegimo į kompiuterį ir turi pilną įvairių (atviro kodo, nemokamų) genealogijos programų paketą. Yra galimybė iš šio kompaktinio disko įdiegti OS Linux [http://www.ubuntulinux.org/ Ubuntu 10.10] ir Gramps į kompiuterį bet kada, kai tik to panorėsite.

==Automatinis Gramps parsisiuntimas ir įdiegimas==
Prieš parsisiųsdami Gramps iš šios svetainės, pažiūrėkite, galbūt jūsų operacinės sistemos diegimo šaltiniuose (repository) jau yra naujausia programos versija. Naujausią stabilią Gramps versiją rasite [http://sourceforge.net/project/showfiles.php?group_id=25770&package_id=109309 Gramps stable on Sourceforge].

Žemiau nurodyti būdai programos atsisiuntimui ir diegimui konkrečioms operacinėms, naudojant komandinę eilutę:
* Debian pagrindu sukurtos sistemos (Ubuntu ir jos variantai, Mepis, ...): <code>
sudo apt-get install gramps</code>
* Gentoo (ir Sabayon):<code>
sudo emerge gramps </code>
* Mandriva: <code>
sudo urpmi gramps</code>
* Redhat pagrindu sukurtos sistemos (Fedora, CentOS...): <code>
sudo yum install gramps</code>
* OpenSUSE: <code>
sudo sudo zypper install gramps</code>

==Paprastas Gramps parsisiuntimas ir įdiegimas==
Gramps geriausiai išbandyta ir pritaikyta Linux operacinėje sistemoje.
Jeigu naujausios Gramps versijos nėra jūsų operacinės sistemos diegimo šaltiniuose (angl. repositories), galite programą parsisiųsti iš šios svetainės. Kai kurie draugiški Gramps naudotojai sukūrė Gramps paketus skirtingoms operacinėms sistemoms (OS). Galbūt jūsų OS yra tarp žemiau išvardintų. Jei ne, bandykite susisiekti su programos kūrėjais el. paštu.

* '''Ubuntu''' ir jos variantai (KUbuntu,XUbuntu,EdUbuntu), Mephis: Ubuntu paketai prieinami [http://sourceforge.net/projects/gramps/files/Stable/ Gramps download page].See [http://sourceforge.net/projects/gramps/files/OldFiles/ OldFiles] for archives.
* '''(Open)SuSE''': Richard Bos kuria Gramps paketus OpenSUSE sistemai. OpenSUSE 11.1 diegimo šaltinis (repository) [http://download.opensuse.org/repositories/Education/openSUSE_11.1/]. Atminkite, kad šis šaltinis nėra tas pats, kaip šaltinių sąraše nurodytas „Education“, tad jį reikia pridėti kaip URL. Diegimo šaltinis OpenSUSE 11.0 versijai yra [http://download.opensuse.org/repositories/Education/openSUSE_11.0/], o 10.3 versijai – [http://download.opensuse.org/repositories/Education/openSUSE_10.3/]. Jei turite senesnę OpenSUSE (10.2), žiūrėkite forumo įrašus tema [http://www.suseforums.net/index.php?s=22f80a050a1e3cffffd590db0813dea9&showtopic=28727&pid=152093&st=0&#entry152093 satisfying Gramps dependencies for SuSE with the ''rbos'' and SMART].
* '''Mandriva''': Naujos Gramps versijos kartais yra ''backported''. Norint įdiegti ''backports'', reikia įjungti ''backports'' diegimo šaltinius (įsitikinkite, kad suprantate [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates Mandriva wiki] instrukcijas). Jei naujausios versijos nėra ''backports'' diegimo šaltiniuose, patikrinkite ''contrib'' repository.
* '''Fedora''': For Fedora Core look on the [http://sourceforge.net/project/showfiles.php?group_id=25770 Gramps download page] for a package containing ''fc'' with your number and ending with ''.rpm''. The alternative to installing from source is to [[Fedora RPM|build a package]] from an rpm spec file, or install a binary from fedora testing.
* '''Debian''': vėliausia programos versija gali būti randama ''unstable'' saugykloje (repository) ([http://packages.debian.org/sid/gramps Sid Gramps]) ir gali būti atnaujinta naudojantis jūsų paketų tvarkykle. ''Testing'' saugykla yra atnaujinama 10 dienų vėliau (išskyrus tada, kai artėja stabilios versijos pasirodymas), žr. [http://packages.debian.org/lenny/gramps Lenny Gramps].

''Atminkite: Kiekviena GNU/Linux atmaina (distribution) turi skirtingus būdus Gramps parsiuntimui ir diegimui. Daugiau informacijos ieškokite savo Linux žinyne.''

Visais kitais atvejais, jūs galite [http://sourceforge.net/project/showfiles.php?group_id=25770 atsisiųsti] programos išeities kodą (bylos pavadinimo pabaiga „.tar.gz“) ir įsidiegti Gramps komandinėje eilutėje (terminale). Daugiau informacijos rasite sekcijoje „Diegimas iš išeities kodo“.

==Windows, BSD, Mac OS X, Solaris==
===Windows===
[[Windows installer/lt|Windows diegyklė]] yra eksperimentinė programa. Jei siūloma diegyklė neatitinka naujausios Gramps versijos, palaukite, kol ši bus sukurta OS „MS Windows“.

„Windows“ naudotojams: žiūrėkite papildomą informaciją puslapyje [[Gramps and Windows/lt|Gramps ir OS „MS Windows“]].

===Mac OS X===
Mac OS X skirtus Gramps diegimo paketus galite atsisiųsti [http://finkproject.org Fink project] arba [http://macports.org MacPorts]. Fink projekto saugomos '''ypač''' senos versijos prieinamos adresu [http://pdb.finkproject.org/pdb/package.php/gramps# package database]. Detalesnių diegimo nurodymo ieškokite čia: [[Mac_OS_X|Diegimas iš išeities kodo operacinėje sistemoje Mac OS X]]

===BSD ir Solaris===
BSD ir Solaris sistemos skirti diegimo žemiau pateikti nurodymai yra eksperimentinio pobūdžio. Apie naudojimą FreeBSD sistemoje, žiūrėkite [http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps /usr/ports/science/gramps] svetainėje.

==Gnome ir KDE==
Jūs galite naudoti abi grafines sąsajas, bet Gramps labiau pritaikyta GNOME. KDE aplinkoje gali būti tam tikrų nesklandumų susijusių su GTK, tačiau ne pačia Gramps programa. [[KDE page | KDE puslapyje]] ieškokite aprašymo, kokie nesklandumai gali kilti.
Taip pat, žiūrėkite [http://portland.freedesktop.org/wiki/ XdgUtils].

==Papildoma programinė įranga, palengvinanti darbą su Gramps ==
Gramps nesusijusi su sekančiomis programomis, tačiau jų įdiegimas gali padidinti darbo našumą:

* '''Spell checking''': python-gnome2-extras ir python-enchant siūlo gtkspell ir enchant modulius, kurie įgalina pastabų rašybos tikrinimą.
* '''Graphviz''', '''Inkscape''': Gramps gali sukurti gražius genealoginius medžius (ryšių diagramas). Jiems sukurti reikalingas Graphviz pakatas, kuris aprašo kodą (dot), lygiai taip, kaip grafikus braižančios programos (dotty, iškviečiama komandinėje eilutėje). Tai leidžia jums, kaip tyrinėtojui, galingiausią įrankį giminės medžių peržiūrai, tačiau tam reikia įgūdžių. Arba jūs galite sukurti grafinę atskaitą sukurdami SVG bylą, kurią galėsite atverti/taisyti/tobulinti su, pvz., Inkscape.
* '''ttf-freefont''': naudingi unikodo šriftai. Gerai veikia tiek spausdinant, tiek įrašant bylas per graphviz.
* '''[http://portland.freedesktop.org/wiki/ XdgUtils]''' komandinės eilutės įrankiai, kurie assist applications with a variety of desktop integration tasks. About half of the tools focus on tasks commonly required during the installation of a desktop application and the other half focuses on integration with the desktop environment while the application is running. Even if the desktop components of your application are limited to an installer, configuration or management tool, Xdg-utils provides you with an easy way to enhance the usage experience of your customers by improving the integration of these components in the user's environment.
* '''[http://tilloy.net/dev/pyexiv2/overview.html pyexiv2]''' is a module that allows Gramps to read and write metadata embedded in image files. It is used in the Metadata Viewer and Image Metadata gramplets.

Kiti naudingi paketai:

* '''desktop-file-utils''': leidžia matyti sąrašą programų, kurios atveria media bylas, šias spraktelėjus dešiniu pelės klavišu.

==Diegimas iš išeities kodo==
===Reikalavimai sistemai===

Gramps {{version}} reikalauja, kad būtų įdiegta: python 2.6 arba naujesnė versija, pygtk 2.16 arba naujesnė versija, ir librsvg2

==== Linux paketų priklausomybės ====
{|border="1" align ="center"
|-
|Debian /Ubuntu
|Fedora /Redhat
|Pastaba
|-
|python
|python
|Būtinas (2.6 arba vėlesnė versija)
|-
|pygtk2
|pygtk2
|Būtinas (2.16 arba naujesnė versija)
|-
|xdg-utils
|xdg-utils
|Būtinas Gramps-3.1.x ir naujesnėms
|-
|rcs
|rcs
|Naudingas dirbant
|-
|librsvg2-common
|librsvg2
|Reikalinga kompiliuojant
|-
|libglib2.0-dev
|
|Reikalinga kompiliuojant
|-
|
|librsvg2-devel
|Reikalinga kompiliuojant
|-
|intltool
|intltool
|Reikalinga kompiliuojant
|-
|
|gcc, make, gettext
|Reikalingi kompiliuojant
|-
|}

===Programos išeities kodo gavimas===

* Naujausią stabilią Gramps versiją atsisiųskiti iš [http://sourceforge.net/projects/gramps Gramps SourceForge page]. Pavyzdžiui, gramps-{{version}}.tar.gz. Išskleiskite šią bylą į aplanką:
<code>
tar xzvf gramps-zzz.tar.gz
</code> ir įeikite į šį aplanką:<code>
cd gramps-zzz
</code>
* Jei norite išbandyti pačią naujausią kuriamą Gramps versiją, ją galite gauti iš SVN (žr. [[Brief introduction to SVN|Trumpas įvadas į SVN]]). SVN Gramps versijos diegimas gali kelti pavojų, kai ji nėra pakankamai išbandyta, o ypač tuomet, kai „trunk“ versija turinti tik iš dalies įgyvendintas galimybes. Atminkite, kad ši versija yra linkusi nulūžti ir jūs galite prarasti didžiulius savo duomenis. Prašome ją naudoti ypač atsargiai – dirbkite turėdami atsarginę duomenų kopiją!

Dabar jau galite perskaityti bylas [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/INSTALL?view=markup INSTALL] ir [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/README?view=markup README], kurias rasite išeities kodo pagrindiniame aplanke. Jose pateikiama naujausia informacija.

===Senesnių versijų šalinimas===

Jei jūs anksčiau jau kompiuteryje įdiegėte Gramps iš programos pradinio kodo, turite nuspręsti, ką darysite šia programa prieš diegdami naujesnę versiją. Jeigu norite išsaugoti senąją versiją, būtinai perskaitykite nurodymus INSTALL byloje apie „--prefix“ parinkties naudojimą nurodant naujos versijos diegimo aplanką.

Norėdami tiesiog pakeisti senąją versiją naujesne, pirmiausia pašalinkite senesniąją versiją prieš įdiegdami naująją versiją. Diegti naujesnę versiją „ant viršaus“ nepatartina. Kuriant naujas Gramps versijas, kai kurios funkcijos gali būti parašytos kitais būdais. Diegiant programą „ant viršaus“ (toje pačioje vietoje), kyla pavojus, kad senas kodas likęs iš senosios versijos gali būti naudojamas naujesnėje versijoje, kartais su nenumatytomis pasekmėmis. Diegiant iš pradinio programos kodo, geriausias būdas pašalinti senąją versiją yra komandinėje eilutėje įvykdyti<code>
make uninstall</code>

administratoriaus (root) teisėmis '''iš to aplanko, iš kurio diegėte senesnę versiją'''. Naudokite savo operacinės sistemos pakatų tvarkyklę programos pašalinimui, jei senoji versija buvo įdiegta kaip paketas.

'''Atminkite, kad jūs turėtumėte pasinaudoję senąja Gramps versija eksportuoti duomenų kopiją Gramps XML formatu prieš pašalindami senesniąją versiją.'''

===Diegimas iš išeities kodo operacinėje sistemoje Linux===

Gramps provides a script that can be used to prepare the code for building. This script automatically calls the standard configure script:<code>
./autogen.sh </code> kaip naudotojas

This script will report any missing dependencies. Install these (see also INSTALL file). Building from source code typically requires that the development versions of the required libraries be installed. You might consider setting a prefix path with autogen.sh, see the INSTALL file for instructions. Standard install is in /usr/local.

Once a successful run of autogen.sh has been completed, you can run the typical make procedure. <code>
make # (kaip naudotojas)</code>

then <code>
make install # (kaip root) </code>

===Diegimas iš išeities kodo operacinėje sistemoje BSD===

Installing on BSD is as straightforward as on Linux, apart from some minor issues like tools having different names. See the [[BSD platforms]] for details.

===Diegimas iš išeities kodo operacinėje sistemoje Mac OS X===

There are several different ways of building Gramps from source on Mac OS X. An overview of building from source is given at [[Mac OS X:Build from source]].

[[Mac OS X:Build from source:MacPorts|Macports]] and [[Mac OS X:Build from source:fink|fink]] versions of Gramps have been used.

The latest version of MacPorts Gramps is '''{{version_MacPort}}'''.
The latest official unstable fink version is '''3.0.4''' for Mac OS X 10.5 on both PPC and Intel.
There is currently no official stable fink version of Gramps. (As at February 2012)

Instructions for building the pre-built binary version (Mac OX X Application package) are given at [[Mac OS X:Build from source:Application package]]. Some discussion about earlier attempts is at [[Mac OS X:Build from source:gtk-osx]] with bugs reported at [[Mac OS X:Build from source:gtk-osx:bugs]]

An older build approach is given at [[Mac OS X:Build from source:Native OS X]].

===Diegimas iš išeities kodo operacinėje sistemoje Windows===

„Microsoft Windows“ vartotojų laimei, kai kurie programos naudotojai sukurė [[Windows installer/lt|Windows diegyklę]]. Kol kas nebuvo pranešimų, kad oficiali Gramps versija ir jos „Windows“ modifikacija žymiai skirtųsi. Ateitis daug žadanti, tačiau „Windows diegyklę“ naudokite savo pačių atsakomybe. Gramps geriausiai pritaikyta Linux/UNIX tipo operacinėms sistemoms.

If the dependencies are in place, the development version can be tested by getting the source (see above), making a copy of the file const.py.in and rename it to const.py, then execute "python gramps.py" from within the src directory. Of course, this is a development version, so warnings apply even more to this case than when using the installer.

===Diegimas iš išeities kodo operacinėje sistemoje Solaris===

Version 3.0.1 has been successfully installed from source on both Solaris 10 (SPARC) and OpenSolaris X86 (2008.05). Please see the [[Solaris_Platforms]] for step-by-step details.

==Gramps on handhelds==
Gramps can run fine on some small-factor devices. Users have been successful in using Gramps on:
* [[Gramps on the Eee|Asus Eee PC]]

[[Category:Documentation]]

Fi:Asennus

2025-11-22T07:40:54Z

CallMeDave:

{{languages|Installation|Asennus}}

==Live CD==
Jos olet kiinnostunut Grampsistä, mutta et halua tai voi asentaa Grampsiä (esim.Tietokone ei ole sinun, ei internet-yhteyttä kotona, työpaikan kannettava,..). Silloin voit kokeilla Grampsiä turvallisesti [[Linux Genealogy CD|Linux CD Live]]-levyltä. Tällöin voit kokeilla Grampsiä ja muita vapaita sukututkimus-ohjelmia levyltä asentamatta niitä. Kun olet varma, että asennat Grampsin voit asentaa sen [http://www.ubuntulinux.org/ Ubuntu 10.10] milloin haluat.

==Grampsin automaattinen lataus ja asennus==
Ennen kuin lataat Gramps:in tarkista käyttöjärjestelmäsi.Gramps:in eri versioita eri käyttöjärjestelmille löytyy
[http://sourceforge.net/projects/gramps/files/Stable/ Sourceforgesta(tästä linkistä)].
Katso käyttöjärjestelmäsi asennus ohjeet:
* Debian based systems (Ubuntu and it's variants, Mepis, Suse...): <code>
sudo apt-get install gramps</code>
* Gentoo (and Sabayon):<code>
sudo emerge gramps </code>
* Mandriva: <code>
sudo urpmi gramps</code>
* Redhat based systems (Fedora, CentOS...): <code>
sudo yum install gramps</code>

==Grampsin manuaalinen lataus ja asennus==
If you can't access the current version from your operating system's repositories you'll need to get it from this site. Some helpful users of Gramps have made packages for various systems. If you're lucky you'll find your system below. If it's missing you can contact the developers email list for advice.

* '''Ubuntu''' and derivatives (Kubuntu, Mephis, ...): Ubuntu packages are available on [http://sourceforge.net/project/showfiles.php?group_id=25770 Gramps download page]. See [http://sourceforge.net/projects/gramps/files/OldFiles/ OldFiles] for archives.
* '''SuSE''': Richard Bos has been providing the Gramps releases for SuSE's apt repository. They are available from his [http://software.opensuse.org/download/home:/rbos/ ''rbos'' repository]. See also the forum entry about [http://www.suseforums.net/index.php?s=22f80a050a1e3cffffd590db0813dea9&showtopic=28727&pid=152093&st=0&#entry152093 satisfying Gramps dependencies for SuSE with the ''rbos'' and SMART].
* '''Mandriva''': Newer versions of Gramps are sometimes backported. To install backports you must enable the ''backports'' repository (make sure you understand the instructions on the [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates Mandriva wiki]). If the latest version is not in the ''backports'' repository you cab try the ''contrib'' repository.
* '''Fedora''': For Fedora Core 6 look on the [http://sourceforge.net/project/showfiles.php?group_id=25770 Gramps download page] for a package containing ''fc6'' and ending with ''.rpm''. For Fedora 7, ''fc7'' and so on. The alternative to installing from source is to [[Fedora RPM|build a package]] from an rpm spec file, or install a binary from fedora testing.
* '''Debian''': the latest version should be in the ''unstable'' repository ([http://packages.debian.org/sid/gramps Sid Gramps]) and can be upgraded from your package manager. The ''testing'' repository is updated 10 days later (except near a new stable release), see [http://packages.debian.org/lenny/gramps Lenny Gramps].

''Note: Different GNU/Linux distributions have different preferred ways to download and install packages for Gramps. Please read the installation instructions specific to your distribution before downloading.''

In all other cases, you must [http://sourceforge.net/project/showfiles.php?group_id=25770 download] the source package (the file ending with '.tar.gz') and install Gramps manually. See the section about installing from source for details.

==Windows, BSD, MacOs, Solaris==
For Windows, there is an experimental [[Windows installer]]. If this installer does not offer the most recent versions of Gramps in Windows, you need to wait until a new installer is made available.
For Windows user: See also some additional information on page [[Gramps_and_Windows]].

For MacOSX, both the [http://finkproject.org Fink project] and [http://macports.org MacPorts] have Gramps as a installable package. Fink currently has '''very''' old versions available it in the [http://pdb.finkproject.org/pdb/package.php/gramps# package database]. Detailed instructions on using both these systems to install recent versions of gramps are given under [[Mac_OS_X|Installing from source code on Mac OS X]]

For BSD and Solaris there are experimental install instructions below. For FreeBSD use the ''/usr/ports/science/gramps'' port.

==Gnome ja KDE==
You can use both, but Gramps fits in better with GNOME. For KDE there are some minor issues due to some (GTK) issues outside of Gramps. Check the [[KDE page]] to know what these problems might be.

==Additional software Gramps can benefit from==
Gramps does not rely on the following programs, however, having them will increase your productivity:

* '''Gnome-print''': It adds the ability to directly print, to preview, and to generate fully internationalized PS and PDF output. At this time, one needs to install gnome-python-desktop to obtain this package (it might be known under different names, eg on debian python-gnome2-desktop).
* '''Spell checking''': Installing python-gnome2-extras provides the gtkspell module, which adds spell checking in the notes
* '''Graphviz''', '''Inkscape''': Gramps can make nice Genealogical trees (relationship graphs). These are generated by the Graphviz package, which defines a code (dot), as well as programs to produce graphs (dotty, to be called from command line). This gives you as researcher most power over how your tree will look, but has a learning curve. An alternative is to make a graphical report, converting the tree to an svg file, which you then can open/edit/refine in eg Inkscape.
* '''ttf-freefont''': Useful as a font that supports a large subset of the unicode and is a true type. This works well with both gnomeprint and graphviz output.
* '''[http://tilloy.net/dev/pyexiv2/overview.html pyexiv2]''' is a module that allows Gramps to read and write metadata embedded in image files. It is used in the Metadata Viewer and Image Metadata gramplets.

Other packages might also be useful:

* '''desktop-file-utils''': see list of programs to open a media file on right click on an image

==Lähdekoogista asentaminen==
===General Requirements===

Gramps {{version}} requires python 2.6 and pygtk2 packages. The pygtk package should be version 2.16 or greater.

Also librsvg2-common is needed. This is a common error at the moment in some packages. Without this library, the icons are not shown.

==== Linux Package Requirements ====
{|border="1" align ="center"
|-
|Debian /Ubuntu
|Fedora /Redhat
|Comment
|-
|python
|python
|Required (needs version 2.6 or later)
|-
|pygtk2
|pygtk2
|Required (needs 2.16 or greater)
|-
|xdg-utils
|xdg-utils
|Required (Gramps-3.1.x or later)
|-
|rcs
|rcs
|Suggested for running
|-
|librsvg2-common
|librsvg2
|Required for building
|-
|
|librsvg2-devel
|Required for building
|-
|
|intltool
|Required for building
|-
|
|gcc, make, gettext
|Required for building
|-
|}

===Obtaining the source===

* The lastest stable version of Gramps can be downloaded from the [http://sourceforge.net/projects/gramps Gramps SourceForge page]. As of this writing, this is gramps-{{version}}.tar.gz. Extract this file into a directory: <code>
tar xzvf gramps-zzz.tar.gz
</code> and then go into this directory:<code>
cd gramps-zzz
</code>
* If you are interested in testing out the very latest development versions of Gramps, they can be obtained from SVN, see [[Brief introduction to SVN]]. The SVN versions of Gramps are potentially very dangerous as they have not been extensively tested - especially the "trunk" version which contains features that may still be partly implemented. Be aware that they may be prone to crashing and cause extensive data loss. Please use with extreme caution - and only ever on a copy of your data!

Please, now is the time to read the [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/INSTALL?view=markup INSTALL] and [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/README?view=markup README] files accompanying the code. They come with the most recent information.

===Dealing with earlier versions===

If you have an older version of the Gramps source code installed you need to make a decision what you want to do with it before installing a later version. If you wish to keep the old version, make sure that you read the instructions in the INSTALL file regarding the use of the --prefix option to specify where the new version gets installed.

Should you just want to do a straightforward replacement instead, make sure that you remove the older version before you install the new version. Do not install over the top of the old version. As new versions of Gramps are developed, some functionality is occasionally rewritten in different ways. If you install over the top of an existing installation you run the risk that the old code left behind from the old version may be used instead of the new, sometimes with unintended consequences. If you installed from source, the best way of removing the old version is to run<code>
make uninstall</code>

as root from where you installed the version from. Use your distribution's package manager to uninstall if your old version was installed as a package.

===Installing from source code on Linux===

Gramps provides a script that can be used to prepare the code for building. This script automatically calls the standard configure script:<code>
./autogen.sh </code> as user

This script will report any missing dependencies. Install these (see also INSTALL file). Building from source code typically requires that the development versions of the required libraries be installed. You might consider setting a prefix path with autogen.sh, see the INSTALL file for instructions. Standard install is in /usr/local.

Once a successful run of autogen.sh has been completed, you can run the typical make procedure. <code>
make (as user)</code>

then <code>
make install (as root) </code>

===Installing from source code on BSD===

Installing on BSD is as straithforward as on linux, apart from some minor issues like tools having different names. See the [[BSD platforms]] for details.

===Mac OS X:Build from source===

There are several different ways of building Gramps from source on Mac OS X. An overview of building from source is given at [[Mac OS X:Build from source]].

[[Mac OS X:Build from source:MacPorts|Macports]] and [[Mac OS X:Build from source:fink|fink]] versions of Gramps have been used.

The latest version of MacPorts Gramps is '''{{version_MacPort}}'''.
The latest official unstable fink version is '''3.0.4''' for Mac OS X 10.5 on both PPC and Intel.
There is currently no official stable fink version of Gramps. (As at February 2012)

Instructions for building the pre-built binary version (Mac OX X Application package) are given at [[Mac OS X:Build from source:Application package]]. Some discussion about earlier attempts is at [[Mac OS X:Build from source:gtk-osx]] with bugs reported at [[Mac OS X:Build from source:gtk-osx:bugs]]

An older build approach is given at [[Mac OS X:Build from source:Native OS X]].

===Installing from source code on Windows===

Fortunately for users of Microsoft Windows, some users have made a [[Windows installer]]. So far there have not been any reports of serious differences between the official builds of Gramps and the Windows Installer, so the future looks promising. But please, use this at your own risk. The developers of Gramps provide the space for this install page, but are not responsible for it.

If the dependencies are in place, the development version can be tested by getting the source (see above), renaming the file const.py.in to const.py, and executing "python gramps.py" from within the src directory. Of course, this is a development version on an unsupported platform, so warnings apply even more to this case than when using the installer. (I have not managed to get a localized build working this way.)

===Installing from source code on Solaris===

Version 3.0.1 has been successfully installed from source on both Solaris 10 (SPARC) and OpenSolaris X86 (2008.05). Please see the [[Solaris_Platforms]] for step-by-step details.

==Gramps on handhelds==
Gramps can run fine on some small-factor devices. Users have been successfull in using Gramps on:
* [[Gramps on the Eee|Asus Eee PC]]

[[Category:Fi:Dokumentaatio]]
[[Category:Developers/Installation]]
[[Category:Developers/Packaging]]

User:Yenidai/Brudnopis

2025-11-22T07:40:47Z

CallMeDave:

==Live CD==
Jeśli jesteś zainteresowany wypróbowaniem tego programu, ale aktualnie nie możesz pozwolić sobie na jego instalację, (np. nie masz własnego PC, pracujesz na czyimś komputerze albo na laptopie firmowym), możesz wypróbować
[[Linux Genealogy CD]]. Działa on bez instalacji czegokolwiek na dysku twardym i zawiera kolekcję darmowych programów o otwartym kodzie z zakresu genealogii. Możesz także zainstalować z tego nośnika [http://ubuntu.com Ubuntu 8.04] oraz GRAMPS w późniejszym czasie.

==Łatwe pobranie i instalacja GRAMPS==
Przed instalacją, sprawdź czy wersja GRAMPS dostępna dla Twojej dystrybucji nie jest aktualna:
* Debian oraz systemy na nim bazujące,(Ubuntu i jego odmiany, Mepis, Suse...):
<code>
apt-get install gramps
</code>
* Gentoo (and Sabayon):
<code>
emerge gramps
</code>
* Mandriva:
<code>
urpmi gramps
</code>
* Systemy oparte na RedHacie (Fedora, CentOs...):
<code>
yum install gramps
</code>

==Ręczne pobieranie i instalacja GRAMPSa==
Jeśli wersja GRAMPSa dostępna w repozytoriach danego systemu nie jest najnowszą wersją, możesz ją wtedy popbrać z tej witryny. Możesz skorzystać też z faktu, że niektórzy użytkownicy udostępniają aktualizacje pakietów dla wybranych dystrybucji. Jeśli masz szczęście to wersja dla twego systemu jest widoczna niżej. Jeśli niestety nie ma takowej, możesz próbować skontaktować się z deweloperami poprzez email po poradę, jak ją zainstalować:

* '''Ubuntu''' oraz pochodne (Kubuntu, Mephis, ...): Pakiety Ubuntu są dostępne pod adresem [http://sourceforge.net/project/showfiles.php?group_id=25770 GRAMPS na SourceForge].
** Hardy (8.04) : pobierz [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps_3.0.1-1_Ubuntu840.deb]
** Gutsy (7.10) : pobierz [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps_3.0.0-1_ubuntu710.deb]
** Feisty (7.04) : pobierz [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps_2.2.10-1_all.deb] oraz [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps-help_2.2.10-1_all.deb], i zainstaluj za pomocą swojego menedżera pakietów. Standardowym, kórego możesz użyć jest pakiet [http://packages.ubuntu.com/gutsy/admin/gdebi gdebi].
** Dapper, Edgy i wcześniejsze : 2.2.10 nie jest aktualnie dostępne, pobierz [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps_2.2.8-1dapper1_all.deb] i [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps-help_2.2.8-1dapper1_all.deb] , i zainstaluj za pomocą menadżera pakietów.
* '''SuSE''': Richard Bos zapewnia wydania GRAMPS zgodne z repozytorium apt'a SuSE. Najnowsza wersja jest dostępna zawsze w [http://software.opensuse.org/download/home:/rbos/ jego repozytorium]. Zobacz też [http://www.suseforums.net/index.php?s=22f80a050a1e3cffffd590db0813dea9&showtopic=28727&pid=152093&st=0&#entry152093. ten wpis na forum].
* '''Mandriva''': Czasami nowsze wersje GRAMPS są przenoszone. Aby mieć do nich dostęp, musisz włączyć tzw ''backports'': zobacz artykuł [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates Mandriva wiki]. Wtedy najprawdopodobniej będziesz mógł zainstalować bardziej aktualne wersje programów, i mamy nadzieję - także GRAMPS. Możesz także spróbować grupy pakietów ''contrib''. Jeśli nie jest w ich dostępna najnowsza wersja GRAMPSa, musisz zainstalować ją z kodu źródłowego (zobacz niżej).
* '''Fedora''': Jeśli posiadasz <tt>FC6</tt>, to na SourceForge, [http://sourceforge.net/project/showfiles.php?group_id=25770 pobierz gramps-zzz.fc6.noarch.rpm] i zainstaluj za pomocą menadżera pakietów, dla wersji <tt>FC7</tt> użyj pakietu fc7. Alternatywą dla instalacji z kodu źródłowego (opisanego niżej) jest [[Fedora RPM|budowa pakietu]] z pliku rpm spec , lub instalacja binarnej wersji z gałęzi testowej fedora.
* '''Debian''': najnowsza wersja jest instalowana bezpośrednio do ([http://packages.debian.org/sid/gramps Sid Gramps]) i może być uaktualniana za pomocą twojego menadżera pakietów. Gałąź testowa jest uaktualniana 10 dni później (z wyjątkiem okresu bezpośrednio przed udostępnieniem nowego stabilnego wydania), zobacz [http://packages.debian.org/lenny/gramps Lenny Gramps].

''Note: Niektóre dystrybucje Linuxa mogą posiadać trochę zmodyfikowany sposób pobierania i instalacji GRAMPSa. Proszę przeczytać instrukcję pobierania pakietów dotyczącą twojej dystrybucji przed pobraniem pakietów.''

We wszystkich pozostałych przypadkach, musisz [http://sourceforge.net/project/showfiles.php?group_id=25770 pobrać] pakiet kodu źródłowego zzz.tar.gz, i zainstalować GRAMPS samodzielnie. Sobacz sekcję niżej po szczegóły.

==Windows, BSD, MacOs, Solaris==
Jeśli chcesz zainstalować GRAMPSa pod systemem Windows, zobacz artukuł [[Windows installer|Instalacja pod Windows]]. Jeśli ten instalator nie jest w najnowszej wersji, to niestety, ale musisz poczekać, aż nowa wersja zostanie wypuszczona.

Dla systemu MacOSX, zarówno [http://finkproject.org projekt Fink] oraz [http://macports.org MacPorts] posiadają Gramps jako pakiet gotowy do instalacji. Fink aktualnie posiada dostępne '''bardzo''' stare wersje w bazie [http://pdb.finkproject.org/pdb/package.php/gramps# pakietów]. Szczegółowe instrukcje jak zainstalować pakiet korzystając z dowolnego z tych systemów znajdują się w artykule [[Mac_OS_X|Instalacja z kodu źródłowego w Mac OS X]]

Dla BSD oraz Solarisa instrukcje, jak zainstalować znajdują się poniżej (są to jednak instrukcje eksperymentalne). Dla FreeBSD użyj portu ''/usr/ports/science/gramps''.

==Gnome i KDE==
Możesz używać obu, jednakże GRAMPS lepiej współpracuje z GNOME. W przypadku KDE jest kilka drobnych problemów związanych z problemami poza samym programem (w GTK). Sprawdź [[KDE page|stronę KDE]] aby wiedzieć, jakiego typu problemów się spodziewać.

==Dodatkowe oprogramowanie, z którego GRAMPS może skorzystać==
GRAMPS nie jest bezpośrednio zależny od poniższych programów, jednakże zainstalowanie ich zwiększa twoje możliwości:

* '''Gnome-print''': Dodaje możliwość bezpośredniego drukowania, podglądu wydruku oraz tworzenie w pełni zlokalizowanych plików wynikowych PS i PDF. Równocześnie, niektórzy będą musieli zainstalowac pakiet gnome-python-desktop aby móc zainstalować ten pakiet. (może on występować pod różnymi nazwami, np.: w systemie Debian będzie to python-gnome2-desktop).
* '''Spell checking''': Instalacja pakietu python-gnome2-extras zapewnia dostępo do modułu gtkspell, który rozszerza funkcjonalność GRAMPSa o sprawdzanie pisowni w notatkach
* '''Graphviz''', '''Inkscape''': Gramps może tworzyć pięknie wyglądające trzewa genealogiczne (grafy zależności). Te generowane przez pakiet Graphviz, który definiuje kod (dot), jak również programy do generacji grafów (dotty, zwane tak z linii poleceń). To pozwala badaczowi na podgąd, jak jego drzewa wyglądają. Co więcej, [https://gna.org/projects/kgraphviewer kgraphviewer] bardzo dobrze czyta pliki dot generowane przez GRAMPSa. Alternatywnie, zamiast tworzenia raportu graficznego, można skonwertować go do formatu svg i następnie otworzyć/edytować/porpawiać w np. Inkscape.
* '''ttf-freefont''': Bardzo użyteczne fonty w standardzie TrueType, które obsługują większość znaków ze standardu unicode. Użyteczne przy wydrukach zarówno przez gnomeprint jak i graphviz.

Inne pakiety także mogą być użyteczne:

* '''Yelp''': Przeglądarka pomocy Gnome. Pozwala na wywoływanie i czytanie dokumentacji GRAMPSa na swoim komputerze.
* '''desktop-file-utils''': np programy do odczytu plików medialnych pod prawym klawiszem myszy

==Instalacja ze źródła==
===Ogólne wymagania===

GRAMPS 2.0wymaga python 2.3 oraz pakietów gnome-python i pygtk2. Moduł gnome-python module powinien być w wersji 2.6.0 lub wyższej. Pakiet pygtk powinien być w wersji 2.5.0 albo wyższej.

Wymagana jest także biblioteka librsvg2-common. Jest to dosyć często spotykany błąd w niektórych pakietach. Bez tej biblioteki, ikony nie są widoczne.

==== Wymagania pakietów pod Linuksem ====
{|border="1" align ="center"
|-
|Debian /Ubuntu
|Fedora /Redhat
|Comment
|-
|python
|python
|Wymagane (wersja 2.5 lub późniejsza)
|-
|pygtk2
|pygtk2
|Wymagane (wersja 2.5.0 lub późniejsza)
|-
|gnome-python
|gnome-python
|Wymagane (wersja 2.6.0 lub późniejsza)
|-
|rcs
|rcs
|Zalecane do pracy
|-
|librsvg2-common
|librsvg2
|Wymagane przy kompilacji
|-
|
|librsvg2-devel
|Wymagane przy kompilacji
|-
|
|gnome-common
|Wymagane przy kompilacji
|-
|
|intltool
|Wymagane przy kompilacji
|-
|
|gnome-doc-utils
|Wymagane przy kompilacji
|-
|
|gcc, make, gettext
|Wymagane przy kompilacji
|-
|}

===Pobieranie kodu źródłowego===

* Najnowsza stabilna wersja GRAMPS może być pobrana ze strony [http://sourceforge.net/projects/gramps GRAMPS na SourceForge]. Podczas pisania tego artykułu był to gramps-3.0.1.tar.gz. Wypakuj ten plik do katalogu: <code>
tar xzvf gramps-zzz.tar.gz
</code> i przejdź do tego katalogu:<code>
cd gramps-zzz
</code>
* Jeśli jesteś zainteresowany przetestowaniem ostatniej wersji rozwojowej GRAMPSa, możesz ją pobrać z repozytorium SVN, zobacz [[Brief introduction to SVN]]. Wersje SVN są potencjalnie niebezpieczne jako że nie są wystarczająco przetestowane, szczególnie wersje "trunk", które mogą zawierać cechy nie zaimplementowane do końca. Zwróć uwagę, że te wersje mogą być podatne na awarie i powodować duże utraty danych. Proszę używać ich z rozwagą - i zawsze na kopii swoich danych!

Proszę, przeczytaj teraz pliki [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/INSTALL?view=markup INSTALL] oraz [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/README?view=markup README] towarzyszące kodu źródłowemu. Zawierają one najbardziej aktualne informacje.

===Postępowanie ze starszymi we prsjami===

Jeśli masz już zainstalowaną starszą wersję Gramps z kodu źródłowego, powinieneś podjąć decyzję co zrobić ze starszą wersją przed instalacją nowej. Jeśli chcesz ją zachować, postępuj według instrukcji zawartych w pliku INSTALL odnośnie użycia opcji --prefix podczas określania, gdzie nowa wersja ma zostać zainstalowana.

Powinieneś raczej chcieć zastąpić starą wersję nową, ale za nim to zrobisz, upewnij się, że usunąłeś starą wersję przed instalacją nowej. Nie instaluj nowej wersji na stają; nowe wersje czasem posiadają funkcjonalność napisaną w wieloraki sposób, jeśli zaś nadpiszesz starą wersję nową, ryzykujesz, że kod starej wersji będzie wykonywany zamiast nowej co prowadzić będzie do niespodziewanych rezultatów. Jeśli instalowałeś z kodu źródłowego, najlepszym rozwiązaniem jest usunięcie starej wersji przez wykonanie polecenia<code>
make uninstall</code>

jako root z katalogu, z którego zainstalowałeś daną wersję. Dla wersji zainstalowanej z pakietu użyj menedżera pakietów, aby ją odinstalować.

===Instalacja z kodu źródłowego pod Linuksem===

GRAMPS dostarcza skrypt, który może być użyty do przygotowania kodu źródłowego do budowy. Ten skrypt wywołuje standardowy skrypt konfiguracyjny:<code>
./autogen.sh </code> jako użytkownik

Skrypt wskaże wszelkie brakujące zależności, jeśli występują. Zainstaluj je wtedy (zobacz również plik INSTALL). Budowanie programu z kodu źródłowego zwykle wymaga posiadania zainstalowanych wersji deweloperskich bibliotek. Możesz także ustawić ścieżkę prefiksuw pliku autogen.sh, zobacz plik INSTALL po instrukcję, jak to zrobić. Standardowo instaluje się do /usr/local.

Po pomyślnym uruchomieniu skryptu autogen.sh, możesz uruchomić procedurę kompilacji wykonując <code>
make (jako użytkownik)</code>

a następnie <code>
make install (jako root) </code>

===Instalacja z kodu źródłowego na systemie BSD===

Instalacja w BSD jest bardzo podobna do instalacji na Linuksie, poza kilkoma drobnymi niedogodnościami jak nazwami narzędzi używanych do kompilacji kodu. Zobacz [[BSD platforms|stronę BSD]] po szczegóły.

===Instalacja z kodu źródłowego w Mac OS X===

Niektórzy użytkownicy pomyślnie zainstalowali GRAMPSa na Mac OS X. Zobacz stronę [[Mac OS X]] po szczegóły. Proszę, dodaj także do wiki informację, jak Ty to zrobiłeś.

===Instalacja z kodu źródłowego w Windows===

Na szczęście dla wielu użytkowników Microsoft Windows, niektórzy z nich przygotowali [[Windows installer|instalator Windows]]. Dotąd nie było zgłoszeń o poważniejszych różnicach pomiędzy kompilacją oficjalnych wydań GRAMPSa i tych z Windows Installera, tak że przyszłość wygląda optymistycznie. Ale pomimo tego używasz jej na własną rękę. Twórcy Grampsa choć zapewniają miejsce na informacje o tym, jak kompilować program pod Windows, to nie biorą odpowiedzialności za jego działanie.

Jesli wszystkie zależności są przygotowane, to wersja rozwojowa może być przetestowana przez przejście do katalogu źródłowego, zmianę nazwy pliku const.py.in na const.py, i wykonanie polecenia "python gramps.py" z katalogu wewnątrz folderu src. Oczywiście, wersja rozwojowa uruchamiana na nie w pełni wspieranej platformie generować będzie więcej ostrzeżeń niż ta z instalatora. (Aktualnie nie udało jeszcze stworzyć zlokalizowanych wersji w ten sposób).

===Instalacja z kodu źródłowego na Solarisie===

Wersja 3.0.1 została z powodzeniem zainstalowana z kodu źródłowego zarówno na Solaris 10 (SPARC) jak i na OpenSolaris X86 (2008.05). Proszę zobacz [[Solaris_Platforms|stronę Solaris]] po instrukcję krok-po-kroku jak to zrobić.

==GRAMPS na hanheldach==
GRAMPS może działać doskonale na małych urządzeniac. Użytkownicy z powodzeniem zainstalowali go na :
* [[Gramps on the Eee|Asus Eee PC]]

Sl:Namestitev

2025-11-22T07:40:35Z

CallMeDave:

{{languages/sl|Installation}}

{{stub}}

==Izvedljivi CD==
Če se zanimate za program GRAMPS, pa ga ne želite tudi namestiti oz. ga ne morete (ni vaš računalnik, windows, brez interneta, službeni računalnik,…) potem preizkusite naš {{call_lang|Linux Genealogy CD|sl|Rodoslovni CD za linux}}. Z njim lahko poganjate odprotkodne, brezplačne rodoslovne programe, ne da bi jih bilo treba namestiti na trdi disk. Kasneje lahko sistem [http://www.ubuntulinux.org/ Ubuntu 10.10] s programom GRAMPS tudi namestite.

==Enostaven prenos in namestitev programa GRAMPS==
Pred prenosom programa preverite, če je različica programa GRAMPS za vašo distribucijo najnovejša:
* Mandriva: <code>
sudo urpmi gramps</code>
* Debian, (K,X,Edu)Ubuntu, Mepis, Suse: <code>
sudo apt-get install gramps</code>
* Fedora: <code>
sudo yum install gramps</code>
* Gentoo (and Sabayon):<code>
sudo emerge gramps </code>

==Posodobitev na zadnjo različico==
Če različica programa GRAMPS, privzeta za vašo distribucijo ni najnovejša, morda lahko uporabite različice, ki so jih pripravili uporabniki:

* '''Ubuntu''' in izpeljanke (Kubuntu, Mephis, ...): Paketi Ubuntu so na voljo na naslovu [http://sourceforge.net/projects/gramps/files/Stable/ sourceforge].See [http://sourceforge.net/projects/gramps/files/OldFiles/ OldFiles] for archives.
* '''SuSE''': Richard Bos zagotavlja izdaje GRAMPS-a za skladišče apt SuSE. Na [http://software.opensuse.org/download/home:/rbos/ njegovi strani] se vedno nahaja zadnja izdaja paketov. Oglejte si tudi odgovor v tem [http://www.suseforums.net/index.php?s=22f80a050a1e3cffffd590db0813dea9&showtopic=28727&pid=152093&st=0&#entry152093. forumu].
* '''Mandriva''': Dostikrat se novejše različice GRAMPS-a nahajajo v navzgornjih skladiščih. Da bi jih uporabili, jih morate omogočiti z izbiro "backports". Poglejte [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates wiki distribucije Mandriva]. Z izbiro teh skladišč boste potem lahko nameščali novejše različice programov, vključno s programom GRAMPS, če bo na voljo. Preverite lahko tudi izbiro skladišč "contrib". Če zadnja različica programa GRAMPS ni na voljo, jo boste morali namestiti iz izvornih datotek (glejte spodaj).
* '''Fedora''': Če imate <tt>FC6</tt> (FC8), na straneh sourceforge poiščite [http://sourceforge.net/project/showfiles.php?group_id=25770 download gramps-zzz.fc6.noarch.rpm], če je na voljo, ter namestite želeni paket, za <tt>FC7</tt> pa uporabite paket fc7. Namesto nameščanja iz izvornih datotek (opisano spodaj) si lahko tudi sami [[Fedora RPM|zgradite paket]] iz datoteke z nastavitvami rpm, ali pa uporabite binarni paket iz testne različice fedore.
* '''Debian''': zadnja različica je nameščena neposredno v debian različico unstable ([http://packages.debian.org/sid/gramps Sid Gramps]). Lahko jo posodobite v običajnem upravljalniku paketov. Različica Testing se posodablja 10 dni kasneje (razen neposredno pred izidom nove stabilne različice), gl. [http://packages.debian.org/lenny/gramps Lenny Gramps].

"Opomba: Nekatere distribucije Linuxa imajo lahko nekoliko drugačen način pridobivanja in nameščanja paketov programa GRAMPS. Pred pridobivanjem paketa preberite navodila, ki se nanašajo na vašo distribucijo."

V vseh ostalih primerih morate [http://sourceforge.net/project/showfiles.php?group_id=25770 pridobiti] izvorni paket zzz.tar.gz in ročno namestiti program GRAMPS. Podrobnosti so navedene v nadaljevanju.

==Windows, BSD, MacOs, Solaris==
Za operacijski sistem Windows je na voljo preizkusni {{call_lang|Windows installer|sl|namestitveni program Windows}}. Če ta še ne prinaša zadnje različice programa GRAMPS, bo zanjo treba počakati do nove različice namestitvenega programa.

Za MacOSX je na voljo namestitveni paket GRAMPS na naslovih [http://finkproject.org Fink project] in [http://macports.org MacPorts]. V projektu Fink se trenutno nahaja na naslovu [http://www.finkproject.org/faq/usage-fink.php?phpLang=en#unstable unstable tree].

Navodila za poizkusno namestitev na sisteme BSD in MacOS se nahajajo nekoliko niže.
FreeBSD, [http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps /usr/ports/science/gramps]

==Gnome in KDE==
Uporabljate lahko oba okolja, vendar se GRAMPS bolje prilega okolju GNOME. Pri poganjanju v okolju KDE prihaja do določenih manjših težav, povezanih z GTK, ki pa jih ni možno rešiti znotraj programa GRAMPS. Za podrobnosti o tem si oglejte {{call_lang|KDE page|sl|stran za KDE}}.

=Dodatni programi, ki jih lahko uporablja program GRAMPS=
GRAMPS za svoje delovanje teh programov ne potrebuje, vseeno pa boste z njihovo pomočjo pri svojem delu učinkovitejši:

* '''Gnome-print''': Omogoča neposredno tiskanje, predogled in izvoz v obliki PS in PDF s polno mednarodno podporo. Trenutno je za ta program treba namestiti paket gnome-python-desktop (v posameznih distribucijah je lahko znan pod drugim imenom, npr. v debianu pythone-gnome2-desktop).
* '''Črkovalnik''': Namesti se s paketom python-gnome2-extras in omogoča preverjanje črkovanja v opombah.
* '''Graphviz''', '''Inkscape''': S programom GRAMPS lahko izdelate izvrstna rodoslovna drevesa (grafične prikaze sorodstva). Izdelajo se s pomočjo paketa Graphviz, ki generira kodo dot, in programov za izdelavo grafičnega prikaza na njeni osnovi (npr. dotty, ki ga uporabljamo iz ukazne vrstice). Oboje vam kot raziskovalcu daje proste roke pri oblikovanju prikaza, vendar zahteva določen trud pri učenju uporabe. Z datotekami dot, izdelanimi v programu GRAMPS. Druga možnost izdelave grafičnega prikaza je pretvorba drevesa v obliko svg, takšno datoteko pa potem odpirate in urejate v programu Inkscape.
* '''ttf-freefont''': Uporaben zaradi velikega števila podnaborov unicode in oblike truetype. Dobro se obnese z izhodnima oblikama gnomeprint in graphviz.
* '''[http://tilloy.net/dev/pyexiv2/overview.html pyexiv2]''' is a module that allows Gramps to read and write metadata embedded in image files. It is used in the Metadata Viewer and Image Metadata gramplets.

Drugi paketi, ki utegnejo biti uporabni:

* '''desktop-file-utils''': s tem paketom si ob desnem kliku lahko ogledate seznam programov, ki so na voljo za odpiranje zunanjih predmetov v programu GRAMPS.

=Nameščanje iz izvornih datotek=
==Splošne zahteve==

GRAMPS {{version}} zahteva nameščene pakete python 2.6, pygtk2. Pygtk mora biti 2.16 ali novejši.

Potreben je tudi paket librsvg2-common. Običajno prihaja do napak v nekaterih paketih ravno zaradi manjkanja tega paketa. Nujen je namreč za prikaz ikon.

=== Zahteve paketov Linux ===
{|border="1" align ="center"
|-
|Debian /Ubuntu
|Fedora /Redhat
|Opomba
|-
|python
|python
|nujen (potrebna različica 2.6 ali novejša)
|-
|pygtk2
|pygtk2
|nujen (zahtevana različica 2.16 ali novejša)
|-
|xdg-utils
|xdg-utils
|nujen (trunk)
|-
|librsvg2-common
|librsvg2
|nujen za prevajanje kode
|-
|
|librsvg2-devel
|nujen za prevajanje kode
|-
|
|intltool
|nujen za prevajanje kode
|-
|}

==Pridobitev izvorne kode==

* Zadnja stabilna različica programa GRAMPS je na voljo na naslovu [http://sourceforge.net/projects/gramps GRAMPS SourceForge page]. V času nastanka teh navodil je bila to različica gramps-{{version}}.tar.gz. Datoteko razširite v poljuben imenik: <code>
tar xzvf gramps-zzz.tar.gz
</code> ter ga nato odprite:<code>
cd gramps-zzz
</code>
* Če bi radi preizkusili najnovejšo razvojno različico programa GRAMPS, jo lahko dobite v obliki SVN na naslovu {{call_lang|Brief introduction to SVN|sl|Kratka navodila za SVN}}. Različica SVN je lahko razmeroma nevarna, saj ni preveč preizkušena. Lahko se zgodi, da v izvajanju programa pride do napake ali pa povzroči izgubo podatkov. Zato to različico uporabljajte z dovoljšno mero previdnosti.

Preberite si vsebino datotek [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/INSTALL?view=markup INSTALL] in [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/README?view=markup README], ki so priložene izvorni kodi. V njih so navedene najnovejše informacije v zvezi s tem.

==Nameščanje iz izvorne kode v Linuxu==

Uporabniki distribucije Debian imajo na razpolago več različic. V vsaki zahteva namestitev GRAMPS več datotek in knjižnic, kot jih je na voljo v običajno nameščenem programju Debian. Poleg tega je treba poskrbeti tudi za medsebojne odvisnosti programov.

Uporabniki trenutne stabilne različice debiana (Etch) naj razširijo vsebino datoteke gramps-2.8.8.tar.gz v svojo mapo ter se postavijo kot navaden uporabnik vanjo, saj je pred namestitvijo treba opraviti nekaj nastavitev.

V ta namen je na voljo skripta za pripravo izgradnje programa GRAMPS. Skripta samodejno pokliče običajen ukaz za nastavitev: <code>
./autogen.sh </code> (kot navaden uporabnik).

Izpisale se bodo morebitne nezadoščene odvisnosti. Pred nadaljevanjem jih je treba namestiti (gl. tudi datoteko INSTALL). Izgradnja programov iz izvornih datotek običajno zahteva namestitev tudi razvojnih različic knjižnic. Morda boste želeli nastaviti tudi predponsko pot za autogen.sh, kot je navedeno v navodilih INSTALL. Običajno mesto namestitve je /usr/local.

Po uspešno izvedeni skripti autogen.sh lahko opravite običajen postopek namestitve s pomočjo ukaza make. <code>
make (kot uporabnik)</code>

in nato <code>
make install (kot administrator) </code>

==Nameščanje iz izvorne kode v sistemih BSD==

Nameščanje na sistemih BSD poteka podobno brez posebnosti kot v Linuxu, le da je nekaj manjših sprememb pri imenih. Podrobnosti najdete na {{call_lang|BSD platforms|sl|straneh BSD}}.

==Nameščanje iz izvorne kode na sistemih z Mac OS X==

Nekaj uporabnikov je uspešno namestilo GRAMPS na sistem Mac OS X. Za podrobnosti poglejte na strani {{call_lang|Mac OS X|sl|Mac OS X}}. Na strani wiki tudi sami zapišite, če ste uspešno namestili program GRAMPS na OS X.

==Nameščanje iz izvorne kode v sistemih Windows==

K sreči je nekaj uporabnikov ustvarilo namestilni program za okolje {{call_lang|Windows installer|sl|Windows}}. Doslej ni bilo poročil o bistvenih razlikah med uradnimi različicami programa GRAMPS in namestilnim programom za okolje Windows. Vseeno pa uporabljajte namestilni program na lastno odgovornost. Razvojno osebje programa GRAMPS zagotavlja prostor za navodila za namestitev v okolju Windows, vendar zanjo niso odgovorni.

Če so zadoščene vse odvisnosti, lahko preizkusite razvojno različico programa GRAMPS iz izvorne kode tako, da preimenujete datoteko const.py.in v const.py, ter zaženete ukaz python gramps.py v mapi src. Ker gre za poganjanje razvojne različice v nepodprtem okolju, naj še bolj veljajo opozorila, ki so navedena zgoraj glede namestilnega programa. (Z lokalizirano različico programa so bile doslej težave).

==Nameščanje iz izvorne kode v sistemu Solaris==

Prejšnje različice programa GRAMPS so delovale tudi v sistemih Solaris. Vendar ni znano uspešno poganjanje na novejših različicah. Če bi to uspelo vam, bi bili veseli, če bi lahko posodobili {{call_lang|Solaris_Platforms|sl|strani za Solaris}}.

{{call_lang|Category:Sl:Documentation|sl|Dokumentacija}}

Sv:Gramps:Installation

2025-11-22T07:40:21Z

CallMeDave:

{{languages|Installation|Gramps:Installation}}

=Live CD=

Om du är intresserad av Gramps men inte vill- eller kan installera det (datorn är inte din, datorn kör Windows, du har inget Internet hemma, du sitter vid en arbetsdator etc) så kan du testa vår {{call lang|Linux Genealogy CD|sv|Linux Genealogy CD}}. Den körs utan att installeras på hårddisken och innehåller en samling fria genealogiprogram licensierade som Open Source. Du kan sedan installera [http://www.ubuntulinux.org/ Ubuntu 10.10] och Gramps från CD:n när du vill.

=Enkel nedladdning och installation av Gramps=

Innan du laddar ner så bör du först kontrollera så att inte den version av Gramps som medföljer din distribution är den senaste:
* Debian, (K, X, Edu)Ubuntu, Mepis, Suse: <code>
sudo apt-get install gramps</code>
* Gentoo (and Sabayon):<code>
sudo emerge gramps </code>
* Mandriva: <code>
sudo urpmi gramps</code>
* Redhat, Fedora, CentOS...: <code>
sudo yum install gramps</code>

=Uppgradera till den senaste versionen=

Om din version av Gramps inte är den senaste så erbjuder en del användare uppdaterade paket för vissa distributioner:

* '''Ubuntu''': På sourceforge så kan du [http://sourceforge.net/project/showfiles.php?group_id=25770 ladda ner] gramps_zzz.deb och gramps-help_zzz.deb. Installera med din pakethanterare. See [http://sourceforge.net/projects/gramps/files/OldFiles/ OldFiles] for archives.
* '''SuSE''': Richard Bos har tillhandahållit en variant av Gramps för SuSEs apt-förråd. I [http://software.opensuse.org/download/home:/rbos/ hans förråd] finns alltid den senaste versionen. Se även [http://www.suseforums.net/index.php?s=22f80a050a1e3cffffd590db0813dea9&showtopic=28727&pid=152093&st=0&#entry152093. den här forumtråden].
* '''Mandriva''': Paket för Mandriva finns tillgängliga via urpmi från [http://seerofsouls.com/ SeerOfSouls.com].
* '''Fedora''': FC6->FC8 [http://sourceforge.net/project/showfiles.php?group_id=25770 ladda ner]. Alternativet till att installera från källkod (beskrivs längre ner) är att {{call lang|fedora RPM|sv|bygga ett paket}} från en rpm spec-fil, eller installera en binärfil från Fedora testing.
* '''Debian''': den senaste versionen installeras direkt i unstable och kan uppgraderas från din pakethanterare. Testing uppdateras 10 dagar senare (förutom strax innan en stabil version).

''Notera: Vissa linuxdistributioner kan använda en något annorlunda metod för att ladda ner- och installera Gramps-paket. Var vänlig läs din distributions särskilda installationsanvisningar innan du laddar ner.''

I alla övriga fall så måste du [http://sourceforge.net/projects/gramps/files/Stable/ ladda ner] källkodspaketet zzz.tar.gz, och installera Gramps manuellt. Se detaljer nedan.

=Windows=

==Ladda hem Gramps för Windows==

Ta först reda på vilken variant av Windows Du har på din dator. Är det en 32-bitars eller en 64-bitars dator?

Gramps installationsfiler finns på [http://sourceforge.net/projects/gramps/files/Stable/3.4.1/ http://sourceforge.net/projects/gramps/files/Stable/3.4.1/]

Har Du en 32-bitars dator väljer du filen med 'AIO32' i namnet och för en 64-bitars filen med 'AIO64' i namnet. Spara ned filen i 'tmp'-katalogen eller en 'downloads'-katalog om Du använder en sådan.

==Installera Gramps på din dator==

==Starta Gramps för första gången==

==Inställningar i Gramps==

=BSD, MacOs, Solaris=

För BSD, MacOS och Solaris så återfinner du experimentella installationsanvisningar här nedan.
FreeBSD, [http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps /usr/ports/science/gramps]

=Gnome och KDE=

Du kan använda båda, men Gramps passar bättre ihop med GNOME. För KDE finns några mindre problem vilka beror på egenskaper hos (GTK) och ligger utanför Gramps kontroll. Se {{call lang|KDE page|sv|sidan om KDE}} för att läsa om vilka dessa problem kan vara.

=Ytterligare programvara som Gramps kan dra nytta av=
Gramps är inte beroende av följande program, men att ha dem installerade kan öka din produktivitet:

* '''Gnome-print''': Lägger till möjligheten att skriva ut direkt, att förhandsgranska och att generera fullt internationaliserade PS- och PDF-utskrifter. I dag så måste man installera gnome-python-desktop för att komma över detta paket (det kan också finnas under andra namn, exempelvis python-gnome2-desktop hos Debian).
* '''Stavningskontroll''': Genom att installera python-gnome2-extras så får du modulen gtkspell, vilken lägger till stavningskontroll i noteringar
* '''Graphviz''', '''Inkscape''': Gramps kan skapa fina släktträd (relationsgrafer). Dessa genereras av Graphviz, vilken definierar en kod (dot), likväl som program för att producera grafer (dotty, kan anropas från kommandoraden). Det här ger dig som forskare största möjliga kontroll över ditt träds utseende, men har samtidigt en inlärningskurva. Ett alternativ är att skapa en grafisk rapport, konvertera trädet till en svg-fil, som i sin tur kan öppnas/redigeras/förbättras i till exempel Inkscape.
* '''ttf-freefont''': Användbart True-Type-teckensnitt som stödjer en stor delmängd av Unicode. Fungerar bra med utskrifter från både gnomeprint och graphviz.
* '''[http://tilloy.net/dev/pyexiv2/overview.html pyexiv2]''' is a module that allows Gramps to read and write metadata embedded in image files. It is used in the Metadata Viewer and Image Metadata gramplets.

=Installera från källkod=
==Generella krav==

Gramps {{version}} kräver python 2.6 och paketen pygtk 2.16. Modulen python-gnome-extras/gnome-python2-gtkspell behövs för stavningskontrollen.

==Att erhålla källkoden==

* Den senaste stabila versionen av Gramps kan laddas ner från [http://sourceforge.net/projects/gramps Gramps SourceForge page]. Extrahera denna fil i en mapp: <code>
tar xzvf gramps-zzz.tar.gz
</code> och gå sedan till denna mapp:<code>
cd gramps-zzz
</code>
* Om du är intresserad av att prova de senaste utvecklingsversionerna av Gramps så kan dessa införskaffas från SVN, se {{call lang|Brief introduction to SVN|sv|kort introduktion till SVN}}. SVN-versionen av Gramps kan vara mycket farlig eftersom den inte har genomgått några genomgripande tester. Den kan vara benägen att krascha och orsaka omfattande dataförluster. Använd den med försiktighet.

Nu är tiden kommen att läsa filerna INSTALL och README som medföljer koden. De innehåller den mest aktuella informationen.

==Installera från källkod på Linux==

Gramps tillhandahåller ett skript som kan användas för att förbereda koden innan den byggs. Detta skript anropar automatiskt standardkonfigurationsskriptet:<code>
./autogen.sh</code>

Detta skript kommer att rapportera eventuella saknade beroenden. Installera dessa (se även filen INSTALL). Att bygga från källkod kräver vanligtvis att utvecklingsversionerna av de nödvändiga biblioteken finns installerade. Du kanske överväger att ställa in en prefix path med autogen.sh, se filen INSTALL för instruktioner.

Så snart en lyckad körning av autogen.sh har utförts så kan du som vanligt genomföra:<code>
make
sudo make install</code>

==Installera från källkod på BSD==

Att installera på BSD är lika rättframt som på Linux, frånsett några småsaker som att verktyg kan ha andra namn. Se {{call lang|BSD platforms|sv|sidan om BSD}} för detaljer.

==Installera från källkod på Mac OS X==

En del användare har lyckats installera Gramps på Mac OS X. Se {{call lang|Mac OS X|sv|sidan om Mac OS X}} för detaljer. Skriv gärna en rad här på wikin om du har lyckats installera Gramps på OS X.

==Installera från källkod på Windows==

På grund av beroenden så är det svårt att installera Gramps på Windows. Lyckligtvis så har några användare skapat ett installationsprogram som förenklar detta. Se {{call lang|Windows installer|sv|sidan om Windows installationsprogram}} för mer information. Använd denna på egen risk! Utvecklarna av Gramps tillhandahåller plats för denna installationssida men är inte ansvariga för den!

Det finns numera också AIO-versioner av Gramps för Windows. (AIO = All In One.) Här finns samtliga beroende med och installeras med Gramps i en egen katalog.
Se http://www.gramps-project.org/wiki/index.php?title=Download

==Installera från källkod på Solaris==

Tidigare versioner av Gramps kunde köras på Solaris men vi känner inte till några nyare fall där detta har skett. Om du med lyckat resultat har installerat Gramps på Solaris, var god uppdatera {{call lang|Solaris_Platforms|sv|sidan om Solaris}}.

[[Category:Sv:Dokumentation|Installation]]

BSD page

2025-11-22T07:38:44Z

CallMeDave:

#REDIRECT[[BSD platforms]]

Example filters

2025-11-22T07:34:58Z

CallMeDave: /* Introduction */

{{languages|Example filters}}

A collection of examples of filters.

==Introduction==
For more info, see [[Filter]] and also [[Gramps_{{man version}}_Wiki_Manual_-_Filters|the wiki manual on Filters]].
When creating custom filters, always make sure you have the [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Filter|Filter Gramplet]] in the [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|sidebar]] visible. This allows testing the filter on real data before putting the filter in general use. Test each filter individually... don't set up a 2nd stage filter until the 1st stage has been tested. To test: in the Filter tab of the sidebar, select the custom filter you made; then click the {{man button|Find}} button.

'''Create a custom filter with the following steps:'''

* Click on {{man menu|Edit}} in the menu bar to display the drop-down list
: The last item is the {{man menu|____ Filter Editor}} and it is contextual, changing the filter editor to only show filters for the category of the current View (Except for the Dashboard and Geography Category Views)
* Click on the {{man menu|Filter Editor}}
* Click on {{man label|Filter Editor}} {{man button| {{icon|stock_add}}}} {{man tooltip|Add a new filter}} to start creating a new filter
* Give your filter a unique '''name'''
* Click on {{man label|Define Filter : Rule List}} {{man button| {{icon|stock_add}}}} {{man tooltip|Add another rule to the filter}} to see the filter rules ([[Gramps_{{man version}}_Wiki_Manual_-_Filters#Which_filters_in_which_Category.3F|limited to those available in the current View]])
* Select an appropriate filtering '''rule'''

* Add further rules as needed

* Select the appropriate {{man label|Define Filter : Options}} pop-up menu item to define how the rules interact. ''The {{man menu|All rules must apply}} option is selected by default.'' This is only necessary when there are multiple rules.
* Click on the {{man label|Define Filter}} {{man button| OK}}
* Click on the {{man label|Filter Editor}} {{man button| Close}} ''Note that new custom filters (or changes) only take effect after closing the Filter Editor.''

There are rules to allow you to use filters defined for another View. In this way you can build up complex filtering involving several Views.

{{man warn|Custom Filters are resource hungry|Very large databases may encounter resource limitations when handling some complex filters}}

Most of the following examples appeared on the Gramps-Users mailing list in response to posts from users and cover Gramps versions 3.4.x to 4.1x

----

== Construction of custom filter examples ==

Please note these conventions for the construction of Filters:

'''''<Viewname> Filter Editor'''''.................Editor for this particular View
'''''Filter <filtername>:'''''...........................................................................................................Name of new filter
<rule name> ........................................................Filter rule selected

OR

<rule group name> =>
<selected rule name> ..........................................Filter rule selected from a drop-down group of rules

'''Option selected''' ................................................................................................................. All/At least one rule must be obeyed

'''Use regular expressions''' ................................................................................................. Blank if not required

'''<Run Filter <filtername> in <Viewname> View>''' .....................................................Where to run the new filter

----

----

----

=='''''1-stage FILTERS'''''==

=== Example 1. All sources that have no repository ===

'''''Source Filter Editor'''''
'''''Filter A:'''''
General filters=>
Sources with <count> Repository references; Number of instances:="1"; Number must be:="lesser than"
''OR''
Sources with a reference count of <count>; Reference count must be:= "lesser than"; Reference count:="1"

'''All rules must apply'''

'''<Run Filter A> in Source View'''

----

=== Example 2. All individuals with no name ===

''Comment: In Person View, click on the Name column to get the names in alphabetical order. All blank surnames will be at the top of the list''

The following filter will display '''only''' the blank given names and/or surnames

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
People with the <name>; Given Name:=^$; Full Family Name:=^$

'''Use regular expressions'''

'''All rules must apply'''

'''<Run Filter A> in Person View'''

----

=== Example 3. All female descendants of Joan Doe ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Descendant filters=>
Descendants of <person>: <''here find the ID of Joan Doe''> ; Include original person
General filters=>
Females

'''All rules must apply'''

'''<Run Filter A> in Person View'''

----

----

----

=='''''2-stage FILTERS'''''==

=== Example 1. All people with only one parent recorded ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
Persons with the <name>; Given name:="(^$|[uU]known)"; Full Family Name:="(^$|[uU]known)"

'''**Use regular expressions**'''

'''All rules must apply'''

'''''Filter B:'''''
Family filters=>
Children of <filter> match; Filter name:="B"

'''All rules must apply'''

'''THEN <Run Filter B> in Person View'''

''Comment: If both parents are unknown you probably won't have any gramps ID assigned for them''

----

=== Example 2. Individuals with siblings named “John” ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
People with the <name>: Given Name:="John"

'''All rules must apply'''

'''''Filter B:'''''
Family filter=>
Siblings of <filter> match: Filter name:="A”

'''All rules must apply'''

'''THEN <Run Filter B> in Person View'''

----

=== Example 3.“Timeline” of all people associated with a particular place ===

'''''Place Filter Editor'''''
'''''Filter A:'''''
General filters=>
Places matching the parameters ;Name : <''here insert name of place''>

'''All rules must apply'''
'''''Event Filter Editor'''
'''''Filter B:'''''
General filters=>
Events matching the place filter: Place filter name:=”A”

'''All rules must apply'''

'''THEN <Run Filter B> in Events view'''

''Configure the View to show columns for Type, Description, Date, Place.''
'' Order the items by Date to get a timeline.''

OR Alternative 2:
'''''Event Filter Editor'''
'''''Filter A:'''''
General filters=>
Events with data : Place:= <''here insert placename''>
''Comment: if the Event type default is "Birth"., just delete it''

'''All rules must apply'''

'''THEN <run Filter A> in Events View'''

''For an ordered list of the people '''add''' the following filter:''
'''''Person Filter Editor'''''
'''''Filter B:'''''
General filters=>
Persons with events matching the events filter: Events filter name:= "A".

'''All rules must apply'''

'''THEN <run Filter B> in Person View'''

----

=== Example 4. All marriage events on the ancestral tree dated after 1837 for a named individual ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Event filters=>
People with the personal <event>; Personal event:= Marriage; Date:= after 1837
Event filters=>
People with the family <event>; Family event:= Marriage; Date:= after 1837

'''**At least one rule applies**'''

'''''Filter B:'''''
General filters=>
People with the name; <''here insert name of individual''>
General filters=>
People matching the <filter>; Filter name:=”A”.

'''All rules must apply'''

'''THEN <run Filter B> in Person View'''

----

=== Example 5. All persons called "serge" having some connection with London ===

'''''Event Filter Editor'''''
'''''Filter A:'''''
General filters=>
Events with <data>: Place:="London"

'''All rules must apply'''
'''''Person Filter Editor'''''
'''''Filter B:'''''
General filters=>
Persons with events matching the <event filter>: Event filter name:= "A"
People with the <name>: Given name:="serge"

'''All rules must apply'''

'''THEN <run Filter B> in Person View'''

''Comment1: There is no way of going between people and places except by way of events they were involved in at those places''

''Comment2: What looks like a minor bug appears when Person filtering on names: a few extraneous individuals appear.''
''They are spouses, included because their married name (or occasionally spouse) is recorded in the database as their Alternative Name''

----

=== Example 6. Obtain a ‘focused’ descendant chart containing only a subset of the people ===

''Select the subset by tagging manually in your direct ancestral line up from your living relative. Call the tag, say, LINE 1.''

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
People with the <tag>; Tag:="LINE 1"

'''All rules must apply'''

'''''Filter B:'''''
Family filters=>
Children of <filter> match: Filter name:="A"
Family filters=>
Spouses of <filter> match: Filter name:="A"
Family filters=>
Siblings of <filter> match: Filter name:="A"

'''**At least one rule must apply**'''

'''THEN <run Filter B> in Person View''' to display the “focussed” tree

''OR:''
''Reports=> Graphs=> Relationship Graph=> Report Options=> Filter "B"'' to obtain a chart. Save as SVG for further manipulation
''OR:''
''Family Trees=> Export=> Forward=> select Gramps XML package=> Forward=> Person Filter.''
Click the drop-down list and ''select filter B'' to save the filter results as another family tree.
Name and export that gpkg; then you can create a new family tree and import the gpkg back into it.

----

=== Example 7. All people related to me but not my wife ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Ancestral filters=>
Ancestors of <person> ID:= <here find YOUR ID>; Inclusive:=0 ''i.e.note: don't include yourself''

'''All rules must apply'''

'''''Filter B:'''''
Descendant filters=>
Descendant family members of <filter> match; Filter name:="Filter A"

'''All rules must apply'''

'''THEN <Run Filter B> in Person View'''

''Comment: note the difference between the UP filter ("Ancestors") which is '''restrictive'''''
''and the DOWN filter ("Descendant family members of filter) which is '''inclusive'''.''
The former keeps the line of relationship away from the wife; the latter brings in your own in-laws
("Matches people that are descendants or the spouse of anybody matched by the filter")

''Comment 2: the filter falls down on people who are not strictly connected to you by marriage but only indirectly''
i.e. people who were married at some time to one of your in-laws, i.e.."in-laws of in-laws".

''If you want to incorporate those links as well, add a further filter as follows:''

'''''Filter C:'''''
Descendant filters=>
Descendant family members of <filter> match; Filter name:="Filter B"

'''**At least one rule must apply**'''

'''THEN <Run Filter C> in Person View'''

''Comment 3: you can widen the reach of the links further by adding more filters in the same form as filter C'' - until your patience runs out

----

=== Example 8. All married males with family name containing rechter/richter ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Event filters=>
People with the family <event>: Family event=> Family:= Marriage
General filters=>
Males

'''All rules must apply'''

'''''<Run Filter A> in Person View''''' ''to check''

THEN in the '''Filter sidebar''', enter ''r[ei]chter'' in the '''Name''' field, for the '''Custom filter''' select ''Filter A'', check '''Use regular expressions'''. Click '''Find'''.

----

=== Example 9. All descendants of Joan Doe of female or unknown sex ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
Males

'''All rules must apply'''

'''**Return values that do *not* match the filter rules**'''

'''''Filter B:'''''
Descendant filters=>
Descendants of person:=<here find the ID of Joan Doe>; Include original person

'''All rules must apply'''

'''THEN <Run Filter B> in Person View'''

----

----

----

=='''''3-stage FILTERS'''''==

=== Example 1. All marriages where the event is a "Personal" event but not part of a Family ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Event filters=>
People with the family <event>; Family Event:="Marriage"

'''All rules must apply'''

'''**Return values that do *not* match the filter rules**'''

'''''Filter B:'''''
Event filters=>
People with the personal <event>; Personal Event:="Marriage"; Primary role:="1"

'''All rules must apply'''

'''''Filter C:'''''
General filters=>
People matching the <filter>; Filter name:= "A"
General filters=>
People matching the <filter>; Filter name:= "B"

'''All rules must apply'''

'''<Run Filter C> in Person View'''

----

=== Example 2. People with events with place, to show an ancestor's descendants with no known birthplace ===

'''''Place Filter Editor'''''
'''''Filter A:'''''
Position filters=>
Places with no latitude or longitude given

'''All rules must apply'''

'''''Event Filter Editor'''''
'''''Filter B:'''''
General filters=>
Events with the particular type: Event type:="Birth"
General filters=>
Events of Places matching the <place filter>: Place filter name:=”A”

'''All rules must apply'''

'''''Person Filter Editor'''''
'''''Filter C:'''''
Descendant filters=>
Descendant family members of <person>:= <''here select the particular ancestor ID''>
General filters=>
Persons with events matching the <event filter>: Event Filter name:=”B”

'''All rules must apply'''

'''<run Filter C> in Person View'''

----

=== Example 3. All direct ancestors (and their siblings) of some person in set periods, e.g. 50 yrs ===

''Comment: For example, to show when the migration from country to town took place''

'''''Person Filter Editor'''''
'''''Filter A:'''''
Descendant filters=>
Descendant family members of <person>; select the person's ID; Include the original person

'''All rules must apply'''

'''''Event Filter Editor'''''
'''''Filter B:'''''
General filter =>
Events of persons matching the <person filter>: Person filter name:= "A"
General filter=>
Events with <data>: Event type:= "Birth"; Date:="between 1650 and 1750" ''(say)''

'''All rules must apply'''

'''''Place Filter Editor'''''
'''''Filter C:'''''
General filters=>
Places of events matching the <event filter>: Event filter name:= "B"

'''All rules must apply'''

'''<run Filter C> in Place View'''

----

=== Example 4. End of the line ancestors from a particular person X (Jones) ===

''Deal with the father's and mother's side separately.''

'''[father's side]'''

'''''Person Filter Editor'''''
'''''Filter A:'''''
Family filters=>
People missing parents

'''All rules must apply'''

'''''Filter B:'''''
Ancestral filters=>
Ancestors of <person>: ID := <''here find ID of person X''>
General filters=>
Males
General filters=>
People with the <name>:Full Family Name:="Jones"

'''All rules must apply'''

'''''Filter C:'''''
General filters=>
People matching the filter; Filter name:="A"
General filters=>
People matching the filter; Filter name:="B"

'''All rules must apply'''

'''<Run Filter C> in Person View.'''

'''[mother's side]'''

repeat A, B, C but in Filter B substitute the ID of the mother of X for the ID of X, and the family name of the mother of X for the name “Jones”.

''Comment: if the spelling of the surname has changed over the generations, you'll need to use a regular expression for the Full Family Name in Filter B and enable “Use regular expressions”''

----

=== Example 5. Show birthplaces of all people with the surname Whitesmith ===

'''''Person Filter Editor'''''
'''''Filter A:'''''

General filters=>
People with the <name> : Full family name:="Whitesmith"

'''All rules must apply'''

'''''Events Filter Editor'''''
'''''Filter B:'''''

General filters=>
Events of persons matching the <person filter>: Filter name:="A"
General filters=>
Events with the particular type: Event type:="Birth"

'''All rules must apply'''

'''''Places Filter Editor'''''
'''''Filter C:'''''

General filters=>
Places of events matching the <event filter>: Event filter name:="B"

'''All rules must apply'''

'''''<Run Filter C> in Place View''' to check''

These Places can be displayed in '''Geography View'''

Select '''All Known Places''', but use '''Filter sidebar''' with '''Custom filter "C"''' to restrict the places shown to birthplaces of the Whitesmith family

''[Acknowledgement: thanks to S. Noiraud for pointing out this very useful combination of filter and Geography View]
''

=== Example 6. People with a common ancestor with <person>, their spouses and their spouse's children ===

'''''Person Filter Editor'''''

'''''Filter A:'''''
Ancestral filters =>
People with a common ancestor with <person>
'''All rules must apply'''

'''''Filter B:'''''
Family filters =>
Spouses of <filter> match: Filter name:="A"
'''All rules must apply'''

'''''Filter C:'''''
Family filters =>
Children of <filter> match: Filter name:="B"
General filters =>
People matching the <filter>: Filter name:="A"
General filters =>
People matching the <filter>: Filter name:="B"
'''At least one rule must apply'''

<Run Filter C> in Person View

=='''''4-stage FILTERS'''''==

=== Example 1. People with surname Doe who lived in Illinois State ===

'''''Place Filter Editor'''''

''Comment: previous Filter A written for gramps 4.1 does not work in gramps 5 with the new Place hierarchy. It needs to be replaced by new
'''''Filter A:'''''
General filters=>
Places enclosed by another place: Name:= "Illinois"; Place type:= "State"
Inclusive:="1"
[NOTE "Include selected Gramps ID" - this is important or the filter excludes events where "Illinois" is the first part of the place address title]

'''All rules must apply'''

'''''Event Filter Editor'''''
'''''Filter B:'''''
General filters=>
Events of places matching the <place filter>: Place filter name:="A"

'''All rules must apply'''

'''''Person Filter Editor'''''
'''''Filter C:'''''

Event filters=>
People with the personal <event>: Personal event:="Residence"
Event filters=>
People with the personal <event>: Personal event:="Death"
Event filters=>
People with the personal <event>: Personal event:="Birth"

'''**At least one rule must apply**'''

'''''Filter D:'''''
General filters=>
People with events matching the <event filter>: Filter name:= "B"
General filters=>
People matching the <filter>: Filter name:= "C"
General filters=>
People with a name matching <text>: Text:= "Doe"

'''All rules must apply'''

'''<Run Filter D> in Person View.'''

----

[[Category:Gramps Examples]]
[[Category:Filters]]

Example filters

2025-11-22T07:33:47Z

CallMeDave: /* Introduction */

{{languages|Example filters}}

A collection of examples of filters.

==Introduction==
For more info, see [[Filter]] and also [[Gramps_{{man version}}_Wiki_Manual_-_Filters|the wiki manual on Filters]].
When creating custom filters, always make sure you have the [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Filter|Filter Gramplet]] in the [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|sidebar]] visible. This allows testing the filter on real data before putting the filter in general use. Test each filter individually... don't set up a 2nd stage filter until the 1st stage has been tested. To test: in the Filter tab of the sidebar, select the custom filter you made; then click the {{man button|Find}} button.

'''Create a custom filter with the following steps:'''

* Click on {{man menu|Edit}} in the menu bar to display the drop-down list
: The last item is the {{man menu|____ Filter Editor}} and it is contextual, changing the filter editor to only show filters for the category of the current View (Except for the Dashboard and Geography Category Views)
* Click on the {{man menu|Filter Editor}}
* Click on {{man label|Filter Editor}} {{man button| {{icon|stock_add}}}} {{man tooltip|Add a new filter}} to start creating a new filter
* Give your filter a unique '''name'''
* Click on {{man label|Define Filter : Rule List}} {{man button| {{icon|stock_add}}}} {{man tooltip|Add another rule to the filter}} to see the filter rules ([[Gramps_{{man version}}_Wiki_Manual_-_Filters#Which_filters_in_which_Category.3F|limited to those available in the current View]])
* Select an appropriate filtering '''rule'''

* Add further rules as needed

* Select the appropriate {{man label|Define Filter : Options}} pop-up menu item to define how the rules interact. ''The [[man menu|All rules must apply}} option is selected by default.'' This is only necessary when there are multiple rules.
* Click on the {{man label|Define Filter}} {{man button| OK}}
* Click on the {{man label|Filter Editor}} {{man button| Close}} ''Note that new custom filters (or changes) only take effect after closing the Filter Editor.''

There are rules to allow you to use filters defined for another View. In this way you can build up complex filtering involving several Views.

{{man warn|Custom Filters are resource hungry|Very large databases may encounter resource limitations when handling some complex filters}}

Most of the following examples appeared on the Gramps-Users mailing list in response to posts from users and cover Gramps versions 3.4.x to 4.1x

----

== Construction of custom filter examples ==

Please note these conventions for the construction of Filters:

'''''<Viewname> Filter Editor'''''.................Editor for this particular View
'''''Filter <filtername>:'''''...........................................................................................................Name of new filter
<rule name> ........................................................Filter rule selected

OR

<rule group name> =>
<selected rule name> ..........................................Filter rule selected from a drop-down group of rules

'''Option selected''' ................................................................................................................. All/At least one rule must be obeyed

'''Use regular expressions''' ................................................................................................. Blank if not required

'''<Run Filter <filtername> in <Viewname> View>''' .....................................................Where to run the new filter

----

----

----

=='''''1-stage FILTERS'''''==

=== Example 1. All sources that have no repository ===

'''''Source Filter Editor'''''
'''''Filter A:'''''
General filters=>
Sources with <count> Repository references; Number of instances:="1"; Number must be:="lesser than"
''OR''
Sources with a reference count of <count>; Reference count must be:= "lesser than"; Reference count:="1"

'''All rules must apply'''

'''<Run Filter A> in Source View'''

----

=== Example 2. All individuals with no name ===

''Comment: In Person View, click on the Name column to get the names in alphabetical order. All blank surnames will be at the top of the list''

The following filter will display '''only''' the blank given names and/or surnames

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
People with the <name>; Given Name:=^$; Full Family Name:=^$

'''Use regular expressions'''

'''All rules must apply'''

'''<Run Filter A> in Person View'''

----

=== Example 3. All female descendants of Joan Doe ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Descendant filters=>
Descendants of <person>: <''here find the ID of Joan Doe''> ; Include original person
General filters=>
Females

'''All rules must apply'''

'''<Run Filter A> in Person View'''

----

----

----

=='''''2-stage FILTERS'''''==

=== Example 1. All people with only one parent recorded ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
Persons with the <name>; Given name:="(^$|[uU]known)"; Full Family Name:="(^$|[uU]known)"

'''**Use regular expressions**'''

'''All rules must apply'''

'''''Filter B:'''''
Family filters=>
Children of <filter> match; Filter name:="B"

'''All rules must apply'''

'''THEN <Run Filter B> in Person View'''

''Comment: If both parents are unknown you probably won't have any gramps ID assigned for them''

----

=== Example 2. Individuals with siblings named “John” ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
People with the <name>: Given Name:="John"

'''All rules must apply'''

'''''Filter B:'''''
Family filter=>
Siblings of <filter> match: Filter name:="A”

'''All rules must apply'''

'''THEN <Run Filter B> in Person View'''

----

=== Example 3.“Timeline” of all people associated with a particular place ===

'''''Place Filter Editor'''''
'''''Filter A:'''''
General filters=>
Places matching the parameters ;Name : <''here insert name of place''>

'''All rules must apply'''
'''''Event Filter Editor'''
'''''Filter B:'''''
General filters=>
Events matching the place filter: Place filter name:=”A”

'''All rules must apply'''

'''THEN <Run Filter B> in Events view'''

''Configure the View to show columns for Type, Description, Date, Place.''
'' Order the items by Date to get a timeline.''

OR Alternative 2:
'''''Event Filter Editor'''
'''''Filter A:'''''
General filters=>
Events with data : Place:= <''here insert placename''>
''Comment: if the Event type default is "Birth"., just delete it''

'''All rules must apply'''

'''THEN <run Filter A> in Events View'''

''For an ordered list of the people '''add''' the following filter:''
'''''Person Filter Editor'''''
'''''Filter B:'''''
General filters=>
Persons with events matching the events filter: Events filter name:= "A".

'''All rules must apply'''

'''THEN <run Filter B> in Person View'''

----

=== Example 4. All marriage events on the ancestral tree dated after 1837 for a named individual ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Event filters=>
People with the personal <event>; Personal event:= Marriage; Date:= after 1837
Event filters=>
People with the family <event>; Family event:= Marriage; Date:= after 1837

'''**At least one rule applies**'''

'''''Filter B:'''''
General filters=>
People with the name; <''here insert name of individual''>
General filters=>
People matching the <filter>; Filter name:=”A”.

'''All rules must apply'''

'''THEN <run Filter B> in Person View'''

----

=== Example 5. All persons called "serge" having some connection with London ===

'''''Event Filter Editor'''''
'''''Filter A:'''''
General filters=>
Events with <data>: Place:="London"

'''All rules must apply'''
'''''Person Filter Editor'''''
'''''Filter B:'''''
General filters=>
Persons with events matching the <event filter>: Event filter name:= "A"
People with the <name>: Given name:="serge"

'''All rules must apply'''

'''THEN <run Filter B> in Person View'''

''Comment1: There is no way of going between people and places except by way of events they were involved in at those places''

''Comment2: What looks like a minor bug appears when Person filtering on names: a few extraneous individuals appear.''
''They are spouses, included because their married name (or occasionally spouse) is recorded in the database as their Alternative Name''

----

=== Example 6. Obtain a ‘focused’ descendant chart containing only a subset of the people ===

''Select the subset by tagging manually in your direct ancestral line up from your living relative. Call the tag, say, LINE 1.''

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
People with the <tag>; Tag:="LINE 1"

'''All rules must apply'''

'''''Filter B:'''''
Family filters=>
Children of <filter> match: Filter name:="A"
Family filters=>
Spouses of <filter> match: Filter name:="A"
Family filters=>
Siblings of <filter> match: Filter name:="A"

'''**At least one rule must apply**'''

'''THEN <run Filter B> in Person View''' to display the “focussed” tree

''OR:''
''Reports=> Graphs=> Relationship Graph=> Report Options=> Filter "B"'' to obtain a chart. Save as SVG for further manipulation
''OR:''
''Family Trees=> Export=> Forward=> select Gramps XML package=> Forward=> Person Filter.''
Click the drop-down list and ''select filter B'' to save the filter results as another family tree.
Name and export that gpkg; then you can create a new family tree and import the gpkg back into it.

----

=== Example 7. All people related to me but not my wife ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Ancestral filters=>
Ancestors of <person> ID:= <here find YOUR ID>; Inclusive:=0 ''i.e.note: don't include yourself''

'''All rules must apply'''

'''''Filter B:'''''
Descendant filters=>
Descendant family members of <filter> match; Filter name:="Filter A"

'''All rules must apply'''

'''THEN <Run Filter B> in Person View'''

''Comment: note the difference between the UP filter ("Ancestors") which is '''restrictive'''''
''and the DOWN filter ("Descendant family members of filter) which is '''inclusive'''.''
The former keeps the line of relationship away from the wife; the latter brings in your own in-laws
("Matches people that are descendants or the spouse of anybody matched by the filter")

''Comment 2: the filter falls down on people who are not strictly connected to you by marriage but only indirectly''
i.e. people who were married at some time to one of your in-laws, i.e.."in-laws of in-laws".

''If you want to incorporate those links as well, add a further filter as follows:''

'''''Filter C:'''''
Descendant filters=>
Descendant family members of <filter> match; Filter name:="Filter B"

'''**At least one rule must apply**'''

'''THEN <Run Filter C> in Person View'''

''Comment 3: you can widen the reach of the links further by adding more filters in the same form as filter C'' - until your patience runs out

----

=== Example 8. All married males with family name containing rechter/richter ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Event filters=>
People with the family <event>: Family event=> Family:= Marriage
General filters=>
Males

'''All rules must apply'''

'''''<Run Filter A> in Person View''''' ''to check''

THEN in the '''Filter sidebar''', enter ''r[ei]chter'' in the '''Name''' field, for the '''Custom filter''' select ''Filter A'', check '''Use regular expressions'''. Click '''Find'''.

----

=== Example 9. All descendants of Joan Doe of female or unknown sex ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
General filters=>
Males

'''All rules must apply'''

'''**Return values that do *not* match the filter rules**'''

'''''Filter B:'''''
Descendant filters=>
Descendants of person:=<here find the ID of Joan Doe>; Include original person

'''All rules must apply'''

'''THEN <Run Filter B> in Person View'''

----

----

----

=='''''3-stage FILTERS'''''==

=== Example 1. All marriages where the event is a "Personal" event but not part of a Family ===

'''''Person Filter Editor'''''
'''''Filter A:'''''
Event filters=>
People with the family <event>; Family Event:="Marriage"

'''All rules must apply'''

'''**Return values that do *not* match the filter rules**'''

'''''Filter B:'''''
Event filters=>
People with the personal <event>; Personal Event:="Marriage"; Primary role:="1"

'''All rules must apply'''

'''''Filter C:'''''
General filters=>
People matching the <filter>; Filter name:= "A"
General filters=>
People matching the <filter>; Filter name:= "B"

'''All rules must apply'''

'''<Run Filter C> in Person View'''

----

=== Example 2. People with events with place, to show an ancestor's descendants with no known birthplace ===

'''''Place Filter Editor'''''
'''''Filter A:'''''
Position filters=>
Places with no latitude or longitude given

'''All rules must apply'''

'''''Event Filter Editor'''''
'''''Filter B:'''''
General filters=>
Events with the particular type: Event type:="Birth"
General filters=>
Events of Places matching the <place filter>: Place filter name:=”A”

'''All rules must apply'''

'''''Person Filter Editor'''''
'''''Filter C:'''''
Descendant filters=>
Descendant family members of <person>:= <''here select the particular ancestor ID''>
General filters=>
Persons with events matching the <event filter>: Event Filter name:=”B”

'''All rules must apply'''

'''<run Filter C> in Person View'''

----

=== Example 3. All direct ancestors (and their siblings) of some person in set periods, e.g. 50 yrs ===

''Comment: For example, to show when the migration from country to town took place''

'''''Person Filter Editor'''''
'''''Filter A:'''''
Descendant filters=>
Descendant family members of <person>; select the person's ID; Include the original person

'''All rules must apply'''

'''''Event Filter Editor'''''
'''''Filter B:'''''
General filter =>
Events of persons matching the <person filter>: Person filter name:= "A"
General filter=>
Events with <data>: Event type:= "Birth"; Date:="between 1650 and 1750" ''(say)''

'''All rules must apply'''

'''''Place Filter Editor'''''
'''''Filter C:'''''
General filters=>
Places of events matching the <event filter>: Event filter name:= "B"

'''All rules must apply'''

'''<run Filter C> in Place View'''

----

=== Example 4. End of the line ancestors from a particular person X (Jones) ===

''Deal with the father's and mother's side separately.''

'''[father's side]'''

'''''Person Filter Editor'''''
'''''Filter A:'''''
Family filters=>
People missing parents

'''All rules must apply'''

'''''Filter B:'''''
Ancestral filters=>
Ancestors of <person>: ID := <''here find ID of person X''>
General filters=>
Males
General filters=>
People with the <name>:Full Family Name:="Jones"

'''All rules must apply'''

'''''Filter C:'''''
General filters=>
People matching the filter; Filter name:="A"
General filters=>
People matching the filter; Filter name:="B"

'''All rules must apply'''

'''<Run Filter C> in Person View.'''

'''[mother's side]'''

repeat A, B, C but in Filter B substitute the ID of the mother of X for the ID of X, and the family name of the mother of X for the name “Jones”.

''Comment: if the spelling of the surname has changed over the generations, you'll need to use a regular expression for the Full Family Name in Filter B and enable “Use regular expressions”''

----

=== Example 5. Show birthplaces of all people with the surname Whitesmith ===

'''''Person Filter Editor'''''
'''''Filter A:'''''

General filters=>
People with the <name> : Full family name:="Whitesmith"

'''All rules must apply'''

'''''Events Filter Editor'''''
'''''Filter B:'''''

General filters=>
Events of persons matching the <person filter>: Filter name:="A"
General filters=>
Events with the particular type: Event type:="Birth"

'''All rules must apply'''

'''''Places Filter Editor'''''
'''''Filter C:'''''

General filters=>
Places of events matching the <event filter>: Event filter name:="B"

'''All rules must apply'''

'''''<Run Filter C> in Place View''' to check''

These Places can be displayed in '''Geography View'''

Select '''All Known Places''', but use '''Filter sidebar''' with '''Custom filter "C"''' to restrict the places shown to birthplaces of the Whitesmith family

''[Acknowledgement: thanks to S. Noiraud for pointing out this very useful combination of filter and Geography View]
''

=== Example 6. People with a common ancestor with <person>, their spouses and their spouse's children ===

'''''Person Filter Editor'''''

'''''Filter A:'''''
Ancestral filters =>
People with a common ancestor with <person>
'''All rules must apply'''

'''''Filter B:'''''
Family filters =>
Spouses of <filter> match: Filter name:="A"
'''All rules must apply'''

'''''Filter C:'''''
Family filters =>
Children of <filter> match: Filter name:="B"
General filters =>
People matching the <filter>: Filter name:="A"
General filters =>
People matching the <filter>: Filter name:="B"
'''At least one rule must apply'''

<Run Filter C> in Person View

=='''''4-stage FILTERS'''''==

=== Example 1. People with surname Doe who lived in Illinois State ===

'''''Place Filter Editor'''''

''Comment: previous Filter A written for gramps 4.1 does not work in gramps 5 with the new Place hierarchy. It needs to be replaced by new
'''''Filter A:'''''
General filters=>
Places enclosed by another place: Name:= "Illinois"; Place type:= "State"
Inclusive:="1"
[NOTE "Include selected Gramps ID" - this is important or the filter excludes events where "Illinois" is the first part of the place address title]

'''All rules must apply'''

'''''Event Filter Editor'''''
'''''Filter B:'''''
General filters=>
Events of places matching the <place filter>: Place filter name:="A"

'''All rules must apply'''

'''''Person Filter Editor'''''
'''''Filter C:'''''

Event filters=>
People with the personal <event>: Personal event:="Residence"
Event filters=>
People with the personal <event>: Personal event:="Death"
Event filters=>
People with the personal <event>: Personal event:="Birth"

'''**At least one rule must apply**'''

'''''Filter D:'''''
General filters=>
People with events matching the <event filter>: Filter name:= "B"
General filters=>
People matching the <filter>: Filter name:= "C"
General filters=>
People with a name matching <text>: Text:= "Doe"

'''All rules must apply'''

'''<Run Filter D> in Person View.'''

----

[[Category:Gramps Examples]]
[[Category:Filters]]

Installing Gramps for Linux computers

2025-11-22T07:28:03Z

CallMeDave: /* Linux distributions */

{{languages|Installing Gramps for Linux computers}}

{{man warn|Before upgrading your distribution|Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format1]].}}

== Linux distributions ==
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros (Linux distribution(s))].|If your Linux distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology''] Please report any problems with them to the package maintainer.}}
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution if you are unable to use either [[#Flathub|Flatpak]] or [[#Snap_from_Canonical_Snapcraft_Store|Snap]].

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!style="width: 85pt;" | Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''
|Add/Remove Software
|
* Debian 11 ("bullseye"): Gramps 5.1.3 
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6
* Debian 13 ("trixie")(stable): ([https://packages.debian.org/source/trixie/gramps Gramps 6.0.1])
* Debian 14 ("forky")(testing): ([https://packages.debian.org/source/forky/gramps Gramps 6.0.6])
* [http://packages.debian.org/sid/gramps sid (unstable testbed)]: Gramps 6.0.6
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''
|Software Centre
|
* Jammy (22.04): Gramps: 5.1.5
* Noble (24.04LTS): Gramps: 5.1.6
* Oracular (24.10): Gramps: 5.2.2
* Plucky (25.04): Gramps: 5.2.4
* Questing (25.10): Gramps: 6.0.1
* Resolute (Development: 26.04): Gramps: 6.0.6
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])
|-
|[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''
|Software Manager
|
* 20.x(Gramps 5.1.2) 
* 21.x(Gramps 5.1.2) 
* 22.x(Gramps 5.1.2) 
|
* Use the "Software Manager" to install a recent version.
* Manually install the most current version of Gramps using the either of the following suggestions instructions [https://forums.linuxmint.com/viewtopic.php?p=2626875#p2626875 Flatpak newer versions] [https://forums.linuxmint.com/viewtopic.php?t=220159 older versions] from the ''Linux Mint Forums''
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]
|-
|[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''
|Add/Remove Software (Gnome) or Software Management (KDE)
|
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 6.0.6)
* Fedora 43 (Gramps 6.0.5)
* Fedora 42 (Gramps 6.0.5)
* Fedora 41 (Gramps 5.2.4-1)
|[https://packages.fedoraproject.org/pkgs/gramps/gramps/ available versions] (packages.fedoraproject.org) [https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions] (koji Buildsystem)

|-
|'''[https://www.mageia.org/en/ Mageia]'''
||[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|
* Mageia [https://madb.mageialinux-online.org/show?distribution=cauldron&architecture=x86_64&rpm=gramps&repo=&group=&page= Cauldron]: Gramps 6.0.5
* Mageia 9.0: Gramps 5.1.6
* Mageia 8.0: Gramps 5.1.3
|[https://madb.mageialinux-online.org/show?distribution=unspecified&architecture=x86_64&graphical=0&rpm=gramps&exact=0 Mageia App Db - gramps]
|-
|[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|
* openSUSE Tumbleweed: Gramps 6.0.3
* openSUSE Leap 16.0: Gramps 6.0.3
* openSUSE Leap 15.6: Gramps 6.0.1 
|[https://software.opensuse.org/package/gramps available versions] The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository
|-
|[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''
|
|
* 15.0: Gramps 5.2.4 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]
|[https://pkgs.org/search/?q=gramps available versions]
|-
|[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''
| [https://wiki.archlinux.org/index.php/pacman pacman]
|
* Gramps 6.0.5
|[https://archlinux.org/packages/extra/any/gramps/ available versions]
|-
|[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''
|
|
* Gramps 6.0.4
|[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|}

{{-}}

== Debian package ==
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') [{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.ubuntu-24.10.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).

sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb

If you have an error about having unmet dependencies run:

sudo apt-get -f install

to install the dependencies.

If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run

sudo apt install language-pack-gnome-en

to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.

=== Useful command lines ===
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:

* Find out what version you are running, by using this:

dpkg-query -s gramps

that queries the package currently installed on your system and gives you info about it.

The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on
you can compare the required Dependencies with the new version you downloaded with the following command:

dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb

for example, you can get just the two Depends lines to compare using:

dpkg-query -s gramps | grep Depends:
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:

* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :

sudo dpkg -r gramps

this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )

* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:

sudo apt-mark hold gramps

'''Upgrade is then complete.'''

== Flathub ==
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub]. Flatpaks allow installing sandboxed versions of applications, which will work on any linux distribution.
=== Flatpak ===
'''Things to consider regarding the flatpak:'''

1. All flatpaks from Flathub are compiled at Github with their dependencies. If someone wants a dependency for an Addon not supported by the flatpak, then a repository or source install might be a better option. There is a list of dependencies included in the Gramps flatpak at https://github.com/gramps-project/flatpak . If you would like another dependency to be considered for addition to the flatpak, please submit an issue at https://github.com/gramps-project/flatpak/issues

2. Directory access to the Gramps flatpak at Flathub is limited by default to the user's home directory. However, another app named Flatseal can change the sandbox permissions. https://flathub.org/en/apps/com.github.tchx84.Flatseal

3. If you use Fedora, Fedora maintains its own Gramps flatpak in addition to the Gramps flatpak available at Flathub. The Fedora flatpak has a different list of dependencies. Here is the link to Fedora's Gramps flatpak https://koji.fedoraproject.org/koji/packageinfo?packageID=39415

4. '''Support for BSDDB3 got dropped in the Gramps 5.2 flatpak at Flathub.''' If you need to access a BSDDB3 database to convert it to Sqlite, there are a few options. The Fedora flatpak might include BSDDB3, and the archived 5.1.6 Gramps flatpak at the gramps-project github https://github.com/gramps-project/flatpak/releases/tag/v5.1.6-1 includes BSDDB3. However, the archived flatpak at the gramps-project link will eventually stop working because Flathub removes obsolete runtimes after a certain length of time. If neither flatpak option works, then a manual intall of BSDDB3 with a repository or source install of Gramps will be required.

'''Recommended steps to install the Gramps flatpak:'''

1. There are instructions for setting up and enabling Flathub for various distributions at https://flathub.org/setup

2. Use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal:

flatpak install org.gramps_project.Gramps

== Snap from Canonical Snapcraft Store ==
The Gramps snap is a Linux app packages for desktop, cloud and IoT that can be installed from the Canonical Snap Store, the app store for Linux.

To install run:

<code>sudo snap install gramps</code>

It has been bundled with the same packages as our Flatpak:

* ICU
* PIL
* osm-gps-map
* GExiv2
* geocodelib
* goocanvas
* graphviz
* ghostscript
* networkx

These should allow some popular addons to work.

Dictionaries are not currently included. This would be possible, but the package size would obviously increase.

Let us know what you think. Comments from people who already use snaps would be especially welcome.

See also:
* [https://snapcraft.io/gramps snapcraft.io/gramps]
* [https://gramps.discourse.group/t/gramps-is-now-available-as-a-snap/7380 Gramps is now available as a Snap]
** [https://gramps.discourse.group/t/after-snap-install-help-request-on-facebook-group/7387 Snap Feedback]

== Build from source ==
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Linux Live CD ==

{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}}

[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.
{{-}}

== Online Demonstration ==
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project. Beware of giving third parties access to your genealogical data.}}

You can also try an online demonstration of version 5.2.3 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'':

* https://www.rollapp.com/app/gramps

Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''

{{-}}

== Notes ==
Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''GEDCOM 5.5.1''' format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]

You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export...}}]] in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.

See: [[How to make a backup]]

== See also ==
===Installing Gramps for Desktops===
Installation instructions specific to the different OSes are on the [[File:linux_32x32.png|link=Installing_Gramps_for_Linux_computers#Linux_distributions]], [[File:windows_32x32.png|link=Installing_Gramps_for_Windows_computers]],[[File:macos_200x200.png|32px|link=Installing_Gramps_for_macOS_computers]] and [[File:Bsd daemon.png|32px|link=BSD_platforms]] pages.

===GitHub Gramps for Desktops Releases===
:* [{{github_url}}/releases/v{{version}} {{version}} version]
:* [{{github_url}}/releases/ Archive of Gramps releases]
Wiki pages
* [[Previous releases of Gramps]]
* [[:Category:Versions|Versions on various platforms]]

===Installing Gramps Web for online collaboration===
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps.
* [https://www.grampsweb.org/Deployment/ Docker]
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt und Docker Compose]

[[Category:Documentation]]

Installing Gramps for Linux computers

2025-11-15T01:44:26Z

CallMeDave: /* Linux distributions */

{{languages|Installing Gramps for Linux computers}}

{{man warn|Before upgrading your distribution|Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format1]].}}

== Linux distributions ==
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros (Linux distribution(s))].|If your Linux distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology''] Please report any problems with them to the package maintainer.}}
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution if you are unable to use either [[#Flathub|Flatpak]] or [[#Snap_from_Canonical_Snapcraft_Store|Snap]].

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!style="width: 85pt;" | Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''
|Add/Remove Software
|
* Debian 11 ("bullseye"): Gramps 5.1.3 
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6
* Debian 13 ("trixie")(stable): ([https://packages.debian.org/source/trixie/gramps Gramps 6.0.1])
* Debian 14 ("forky")(testing): ([https://packages.debian.org/source/forky/gramps Gramps 6.0.6])
* [http://packages.debian.org/sid/gramps sid (unstable testbed)]: Gramps 6.0.6
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''
|Software Centre
|
* Jammy (22.04): Gramps: 5.1.5
* Noble (24.04LTS): Gramps: 5.1.6
* Oracular (24.10): Gramps: 5.2.2
* Plucky (25.04): Gramps: 5.2.4
* Questing (Development: 25.10): Gramps: 6.0.1
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])
|-
|[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''
|Software Manager
|
* 20.x(Gramps 5.1.2) 
* 21.x(Gramps 5.1.2) 
* 22.x(Gramps 5.1.2) 
|
* Use the "Software Manager" to install a recent version.
* Manually install the most current version of Gramps using the either of the following suggestions instructions [https://forums.linuxmint.com/viewtopic.php?p=2626875#p2626875 Flatpak newer versions] [https://forums.linuxmint.com/viewtopic.php?t=220159 older versions] from the ''Linux Mint Forums''
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]
|-
|[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''
|Add/Remove Software (Gnome) or Software Management (KDE)
|
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 6.0.6)
* Fedora 43 (Gramps 6.0.5)
* Fedora 42 (Gramps 6.0.5)
* Fedora 41 (Gramps 5.2.4-1)
|[https://packages.fedoraproject.org/pkgs/gramps/gramps/ available versions] (packages.fedoraproject.org) [https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions] (koji Buildsystem)

|-
|'''[https://www.mageia.org/en/ Mageia]'''
||[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|
* Mageia [https://madb.mageialinux-online.org/show?distribution=cauldron&architecture=x86_64&rpm=gramps&repo=&group=&page= Cauldron]: Gramps 6.0.5
* Mageia 9.0: Gramps 5.1.6
* Mageia 8.0: Gramps 5.1.3
|[https://madb.mageialinux-online.org/show?distribution=unspecified&architecture=x86_64&graphical=0&rpm=gramps&exact=0 Mageia App Db - gramps]
|-
|[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|
* openSUSE Tumbleweed: Gramps 6.0.3
* openSUSE Leap 16.0: Gramps 6.0.3
* openSUSE Leap 15.6: Gramps 6.0.1 
|[https://software.opensuse.org/package/gramps available versions] The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository
|-
|[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''
|
|
* 15.0: Gramps 5.2.4 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]
|[https://pkgs.org/search/?q=gramps available versions]
|-
|[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''
| [https://wiki.archlinux.org/index.php/pacman pacman]
|
* Gramps 6.0.5
|[https://archlinux.org/packages/extra/any/gramps/ available versions]
|-
|[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''
|
|
* Gramps 6.0.4
|[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|}

{{-}}

== Debian package ==
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') [{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.ubuntu-24.10.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).

sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb

If you have an error about having unmet dependencies run:

sudo apt-get -f install

to install the dependencies.

If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run

sudo apt install language-pack-gnome-en

to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.

=== Useful command lines ===
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:

* Find out what version you are running, by using this:

dpkg-query -s gramps

that queries the package currently installed on your system and gives you info about it.

The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on
you can compare the required Dependencies with the new version you downloaded with the following command:

dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb

for example, you can get just the two Depends lines to compare using:

dpkg-query -s gramps | grep Depends:
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:

* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :

sudo dpkg -r gramps

this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )

* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:

sudo apt-mark hold gramps

'''Upgrade is then complete.'''

== Flathub ==
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub]. Flatpaks allow installing sandboxed versions of applications, which will work on any linux distribution.
=== Flatpak ===
'''Things to consider regarding the flatpak:'''

1. All flatpaks from Flathub are compiled at Github with their dependencies. If someone wants a dependency for an Addon not supported by the flatpak, then a repository or source install might be a better option. There is a list of dependencies included in the Gramps flatpak at https://github.com/gramps-project/flatpak . If you would like another dependency to be considered for addition to the flatpak, please submit an issue at https://github.com/gramps-project/flatpak/issues

2. Directory access to the Gramps flatpak at Flathub is limited by default to the user's home directory. However, another app named Flatseal can change the sandbox permissions. https://flathub.org/en/apps/com.github.tchx84.Flatseal

3. If you use Fedora, Fedora maintains its own Gramps flatpak in addition to the Gramps flatpak available at Flathub. The Fedora flatpak has a different list of dependencies. Here is the link to Fedora's Gramps flatpak https://koji.fedoraproject.org/koji/packageinfo?packageID=39415

4. '''Support for BSDDB3 got dropped in the Gramps 5.2 flatpak at Flathub.''' If you need to access a BSDDB3 database to convert it to Sqlite, there are a few options. The Fedora flatpak might include BSDDB3, and the archived 5.1.6 Gramps flatpak at the gramps-project github https://github.com/gramps-project/flatpak/releases/tag/v5.1.6-1 includes BSDDB3. However, the archived flatpak at the gramps-project link will eventually stop working because Flathub removes obsolete runtimes after a certain length of time. If neither flatpak option works, then a manual intall of BSDDB3 with a repository or source install of Gramps will be required.

'''Recommended steps to install the Gramps flatpak:'''

1. There are instructions for setting up and enabling Flathub for various distributions at https://flathub.org/setup

2. Use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal:

flatpak install org.gramps_project.Gramps

== Snap from Canonical Snapcraft Store ==
The Gramps snap is a Linux app packages for desktop, cloud and IoT that can be installed from the Canonical Snap Store, the app store for Linux.

To install run:

<code>sudo snap install gramps</code>

It has been bundled with the same packages as our Flatpak:

* ICU
* PIL
* osm-gps-map
* GExiv2
* geocodelib
* goocanvas
* graphviz
* ghostscript
* networkx

These should allow some popular addons to work.

Dictionaries are not currently included. This would be possible, but the package size would obviously increase.

Let us know what you think. Comments from people who already use snaps would be especially welcome.

See also:
* [https://snapcraft.io/gramps snapcraft.io/gramps]
* [https://gramps.discourse.group/t/gramps-is-now-available-as-a-snap/7380 Gramps is now available as a Snap]
** [https://gramps.discourse.group/t/after-snap-install-help-request-on-facebook-group/7387 Snap Feedback]

== Build from source ==
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Linux Live CD ==

{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}}

[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.
{{-}}

== Online Demonstration ==
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project. Beware of giving third parties access to your genealogical data.}}

You can also try an online demonstration of version 5.2.3 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'':

* https://www.rollapp.com/app/gramps

Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''

{{-}}

== Notes ==
Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''GEDCOM 5.5.1''' format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]

You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export...}}]] in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.

See: [[How to make a backup]]

== See also ==
===Installing Gramps for Desktops===
Installation instructions specific to the different OSes are on the [[File:linux_32x32.png|link=Installing_Gramps_for_Linux_computers#Linux_distributions]], [[File:windows_32x32.png|link=Installing_Gramps_for_Windows_computers]],[[File:macos_200x200.png|32px|link=Installing_Gramps_for_macOS_computers]] and [[File:Bsd daemon.png|32px|link=BSD_platforms]] pages.

===GitHub Gramps for Desktops Releases===
:* [{{github_url}}/releases/v{{version}} {{version}} version]
:* [{{github_url}}/releases/ Archive of Gramps releases]
Wiki pages
* [[Previous releases of Gramps]]
* [[:Category:Versions|Versions on various platforms]]

===Installing Gramps Web for online collaboration===
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps.
* [https://www.grampsweb.org/Deployment/ Docker]
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt und Docker Compose]

[[Category:Documentation]]

Installing Gramps for Linux computers

2025-11-15T01:42:32Z

CallMeDave: /* Linux distributions */

{{languages|Installing Gramps for Linux computers}}

{{man warn|Before upgrading your distribution|Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format1]].}}

== Linux distributions ==
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros (Linux distribution(s))].|If your Linux distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology''] Please report any problems with them to the package maintainer.}}
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution if you are unable to use either [[#Flathub|Flatpak]] or [[#Snap_from_Canonical_Snapcraft_Store|Snap]].

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!style="width: 85pt;" | Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''
|Add/Remove Software
|
* Debian 11 ("bullseye"): Gramps 5.1.3 
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6
* Debian 13 ("trixie")(stable): ([https://packages.debian.org/source/trixie/gramps Gramps 6.0.1])
* Debian 14 ("forky")(testing): ([https://packages.debian.org/source/forky/gramps Gramps 6.0.6])
* [http://packages.debian.org/sid/gramps sid (unstable testbed)]: Gramps 6.0.6
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''
|Software Centre
|
* Jammy (22.04): Gramps: 5.1.5
* Noble (24.04LTS): Gramps: 5.1.6
* Oracular (24.10): Gramps: 5.2.2
* Plucky (25.04): Gramps: 5.2.4
* Questing (Development: 25.10): Gramps: 6.0.1
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])
|-
|[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''
|Software Manager
|
* 20.x(Gramps 5.1.2) 
* 21.x(Gramps 5.1.2) 
* 22.x(Gramps 5.1.2) 
|
* Use the "Software Manager" to install a recent version.
* Manually install the most current version of Gramps using the either of the following suggestions instructions [https://forums.linuxmint.com/viewtopic.php?p=2626875#p2626875 Flatpak newer versions] [https://forums.linuxmint.com/viewtopic.php?t=220159 older versions] from the ''Linux Mint Forums''
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]
|-
|[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''
|Add/Remove Software (Gnome) or Software Management (KDE)
|
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 6.0.5)
* Fedora 43 (Gramps 6.0.5)
* Fedora 42 (Gramps 6.0.5)
* Fedora 41 (Gramps 5.2.4-1)
|[https://packages.fedoraproject.org/pkgs/gramps/gramps/ available versions] (packages.fedoraproject.org) [https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions] (koji Buildsystem)

|-
|'''[https://www.mageia.org/en/ Mageia]'''
||[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|
* Mageia [https://madb.mageialinux-online.org/show?distribution=cauldron&architecture=x86_64&rpm=gramps&repo=&group=&page= Cauldron]: Gramps 6.0.5
* Mageia 9.0: Gramps 5.1.6
* Mageia 8.0: Gramps 5.1.3
|[https://madb.mageialinux-online.org/show?distribution=unspecified&architecture=x86_64&graphical=0&rpm=gramps&exact=0 Mageia App Db - gramps]
|-
|[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|
* openSUSE Tumbleweed: Gramps 6.0.3
* openSUSE Leap 16.0: Gramps 6.0.3
* openSUSE Leap 15.6: Gramps 6.0.1 
|[https://software.opensuse.org/package/gramps available versions] The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository
|-
|[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''
|
|
* 15.0: Gramps 5.2.4 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]
|[https://pkgs.org/search/?q=gramps available versions]
|-
|[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''
| [https://wiki.archlinux.org/index.php/pacman pacman]
|
* Gramps 6.0.5
|[https://archlinux.org/packages/extra/any/gramps/ available versions]
|-
|[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''
|
|
* Gramps 6.0.4
|[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|}

{{-}}

== Debian package ==
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') [{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.ubuntu-24.10.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).

sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb

If you have an error about having unmet dependencies run:

sudo apt-get -f install

to install the dependencies.

If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run

sudo apt install language-pack-gnome-en

to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.

=== Useful command lines ===
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:

* Find out what version you are running, by using this:

dpkg-query -s gramps

that queries the package currently installed on your system and gives you info about it.

The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on
you can compare the required Dependencies with the new version you downloaded with the following command:

dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb

for example, you can get just the two Depends lines to compare using:

dpkg-query -s gramps | grep Depends:
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:

* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :

sudo dpkg -r gramps

this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )

* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:

sudo apt-mark hold gramps

'''Upgrade is then complete.'''

== Flathub ==
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub]. Flatpaks allow installing sandboxed versions of applications, which will work on any linux distribution.
=== Flatpak ===
'''Things to consider regarding the flatpak:'''

1. All flatpaks from Flathub are compiled at Github with their dependencies. If someone wants a dependency for an Addon not supported by the flatpak, then a repository or source install might be a better option. There is a list of dependencies included in the Gramps flatpak at https://github.com/gramps-project/flatpak . If you would like another dependency to be considered for addition to the flatpak, please submit an issue at https://github.com/gramps-project/flatpak/issues

2. Directory access to the Gramps flatpak at Flathub is limited by default to the user's home directory. However, another app named Flatseal can change the sandbox permissions. https://flathub.org/en/apps/com.github.tchx84.Flatseal

3. If you use Fedora, Fedora maintains its own Gramps flatpak in addition to the Gramps flatpak available at Flathub. The Fedora flatpak has a different list of dependencies. Here is the link to Fedora's Gramps flatpak https://koji.fedoraproject.org/koji/packageinfo?packageID=39415

4. '''Support for BSDDB3 got dropped in the Gramps 5.2 flatpak at Flathub.''' If you need to access a BSDDB3 database to convert it to Sqlite, there are a few options. The Fedora flatpak might include BSDDB3, and the archived 5.1.6 Gramps flatpak at the gramps-project github https://github.com/gramps-project/flatpak/releases/tag/v5.1.6-1 includes BSDDB3. However, the archived flatpak at the gramps-project link will eventually stop working because Flathub removes obsolete runtimes after a certain length of time. If neither flatpak option works, then a manual intall of BSDDB3 with a repository or source install of Gramps will be required.

'''Recommended steps to install the Gramps flatpak:'''

1. There are instructions for setting up and enabling Flathub for various distributions at https://flathub.org/setup

2. Use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal:

flatpak install org.gramps_project.Gramps

== Snap from Canonical Snapcraft Store ==
The Gramps snap is a Linux app packages for desktop, cloud and IoT that can be installed from the Canonical Snap Store, the app store for Linux.

To install run:

<code>sudo snap install gramps</code>

It has been bundled with the same packages as our Flatpak:

* ICU
* PIL
* osm-gps-map
* GExiv2
* geocodelib
* goocanvas
* graphviz
* ghostscript
* networkx

These should allow some popular addons to work.

Dictionaries are not currently included. This would be possible, but the package size would obviously increase.

Let us know what you think. Comments from people who already use snaps would be especially welcome.

See also:
* [https://snapcraft.io/gramps snapcraft.io/gramps]
* [https://gramps.discourse.group/t/gramps-is-now-available-as-a-snap/7380 Gramps is now available as a Snap]
** [https://gramps.discourse.group/t/after-snap-install-help-request-on-facebook-group/7387 Snap Feedback]

== Build from source ==
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Linux Live CD ==

{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}}

[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.
{{-}}

== Online Demonstration ==
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project. Beware of giving third parties access to your genealogical data.}}

You can also try an online demonstration of version 5.2.3 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'':

* https://www.rollapp.com/app/gramps

Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''

{{-}}

== Notes ==
Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''GEDCOM 5.5.1''' format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]

You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export...}}]] in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.

See: [[How to make a backup]]

== See also ==
===Installing Gramps for Desktops===
Installation instructions specific to the different OSes are on the [[File:linux_32x32.png|link=Installing_Gramps_for_Linux_computers#Linux_distributions]], [[File:windows_32x32.png|link=Installing_Gramps_for_Windows_computers]],[[File:macos_200x200.png|32px|link=Installing_Gramps_for_macOS_computers]] and [[File:Bsd daemon.png|32px|link=BSD_platforms]] pages.

===GitHub Gramps for Desktops Releases===
:* [{{github_url}}/releases/v{{version}} {{version}} version]
:* [{{github_url}}/releases/ Archive of Gramps releases]
Wiki pages
* [[Previous releases of Gramps]]
* [[:Category:Versions|Versions on various platforms]]

===Installing Gramps Web for online collaboration===
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps.
* [https://www.grampsweb.org/Deployment/ Docker]
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt und Docker Compose]

[[Category:Documentation]]

Addon:ChatWithTree

2025-11-02T22:09:36Z

CallMeDave: /* Issues */

{{Third-party addon}}
{{man warn|You may install the external addon project manually.|See [[#Installation|Installation]]

*The Gramplet is built for Gramps version 6}}
{{man warn|Privacy warning - addon requires Internet access for external LLM models|The {{man label|Chat With Tree}} Gramplet addon uses tools to query your Gramps database, and sends via the Internet the found information to the LLM's. When you use remote LLMs that are running in the cloud on the Internet, for example via OpenRouter, be aware that your local data is sent to those models!

{{man menu|If privacy is your concern, then always ensure to run this tool only with local running LLM models}}, for example using a local setup with tools that enable running LLMs locally. One example of that is with https://www.ollama.com/}}
[[File:chatwithtree-examplechat.png|450px|thumb|right|ChatWithTree Gramplet example]]
The {{man label|Chat With Tree}} Gramplet is an intelligent interpreter to query your family history. It does this by connecting your rich genealogy data directly with the power of a Large Language Model (LLM). This Gramplet transforms your family tree into an interactive chatbot, allowing you to literally "talk with the tree" to ask complex questions about relationships, details, and connections within your Gramps database using natural language queries!

;Features

*Shows a chat like interface
*Select Large Language Model (LLM) models from several different AI providers
**Apart from the free local models using self-started tools (ollama), you can also connect to hosted sites for openai, anthrophic, openrouter etc, all thanks to the llm python model
**You have to create an API key for the model that you want to use
*Start anywhere in your tree using the “search by name” tool
*Person information searches the person notes of Gramps to tell about the people found
*When the AI bot is thinking, it shows the thinking in the chat - showing the strategy to answer difficult questions

== Usage ==

[[#Installation|Add and install]] the external '''ChatWithTree''' project along with the required [[#Prerequisites|''litellm'' Python module prerequisite]] and then [[#Add_ChatWithTree_to_the_Gramps_Dashboard|add]] the {{man label|Chat With Tree}} Gramplet to the Dashboard view.

In the {{man label|Chat With Tree}} Gramplets empty textbox entry field at the bottom of the screen you can:

* Start a chat by typing a text message and pressing the {{man button|Send}} button or
* {{man button|Send}} commands by starting a message with a slash <code>/</code> see the [[#Commands|ChatWithTree Commands]] section.

You always have to select a chat-model first so that the tool knows what LLM is to be used for interacting with the genealogy tree.

When you select a certain chat-model, you will have to have set a valid API key as an environment-variable for that model before starting Gramps!

[[File:chatwithtree-setmodelcommand.png]]

Above example shows what happens when the model does not have a valid API key set. When using local models this is not an issue.

=== Example chat - what chat balloons are visible? ===

When the interaction with a LLM model is successful you can interact with the model:

[[File:chatwithtree-examplechat.png|680px]]

====Legend====
Note the color of the balloons.

*The green balloons are what I have typed above
*The yellow balloons show the “thinking strategy” how the AI model is going to use the tools that are provided - there will always be one balloon showing what local tools have been used to read Gramps database information.
*The last blue balloon is the final answer of the AI model.

=== Commands ===

These commands control the settings of the {{man label|Chat With Tree}} Gramplet addon:

* <code>/help</code> - shows a generic help text
* <code>/history</code> - show the full chat history in JSON format
* <code>/setmodel <model_name></code> - set the model name to use for the LLM
* <code>/setlimit <number></code> - set the tool-calling loop limit (6-20)

==== <code>/help</code> command ====

The <code>/help</code> command shows generic help text.

==== <code>/history</code> command ====

The <code>/history</code> command shows the full chat-history of what {{man label|Chat With Tree}} Gramplet has gathered in memory. This is a very verbose version of the chat, with a some internal ways of showing information like Javascript Object notation (JSON) - mostly interesting if you want to know in detail what conversation the addon has been doing with the LLM

==== <code>/setmodel</code> command ====

With the <code>/setmodel</code> command you select the model the {{man label|Chat With Tree}} Gramplet addon opens up the conversation. Some examples are:

* <code>/setmodel ollama/deepseek-r1:1.5b</code>
* <code>/setmodel openrouter/moonshotai/kimi-k2:free</code>
* <code>/setmodel gemini/gemini-2.0-flash</code>
* <code>/setmodel ollama/gpt-oss:120b-cloud</code>
* <code>/setmodel openrouter/z-ai/glm-4.5-air:free</code>

==== <code>/setlimit</code> command ====

Set the tool calling loop limit (a number between 6 and 20). A low number ensures a quicker final response, preventing certain models to continuously try calling the same tools. For questions that would take a lot of interactions, a limit of 20 might be feasible.

== How does it all work? ==

The {{man label|Chat With Tree}} Gramplet is built in such a way that it sends off a list of "tool names" to the LLM, and based on the message sent, will determine what tools it needs to respond. The tools in the respond execute an interaction with your Gramps database, and the results are then send back to the LLM again, so that the LLM can process the information for an answer.

This interaction between tool calling, thinking of the model, is shown in the ```yellow balloons```.

You will find out that certain models are way better, or smarter, in this tool calling task then other models. As an example, try asking the model a very difficult question. Example:

<blockquote>

From the start person of this genealogy tree, can you tell me all names going back in time by following the mother, then the father, then the mother, then the father, and so on, until you do not find a person anymore? Name all these people with their birth dates, and based on the birth locations, and occupations of these people, based on your own knowledge of these places, can you tell me the most likely family heritage we are looking into?


</blockquote>

== Privacy warning ==

Privacy warning. The {{man label|Chat With Tree}} Gramplet addon uses tools to query your Gramps database, and sends off the found information to the LLM's. When you use remote LLMs that are running in the cloud, for example via OpenRouter, be aware that your local data is send to those models! If privacy is of your concern, then always ensure to run this tool only with local running models, for example using a local setup with tools that enable running LLMs locally. One example of that is with https://www.ollama.com/

== Installation ==

You can install the Addon gramplet by adding a new project via {{man menu|Edit->Addon-manager}} {{man label|Projects}} tab.

Add the following Project to the projects tab:

Summary: '''ChatWithTree'''

URL: '''<nowiki>https://raw.githubusercontent.com/MelleKoning/addons/refs/heads/myaddon60/gramps60/</nowiki>'''

The URL points to the source of the addon.

[[File:chatwithtree-addonproject.png]]

Next is to select the addon in the list of addons:

[[File:chatwithtree-selectaddon.png]]

The addon is now installed, but not yet visible in Gramps.

=== Prerequisites ===
The following prerequisite is required before you can install the addon.
* [https://pypi.org/project/litellm/ litellm] Python module

Enable the {{checkbox|1}}{{man label|Allow Gramps to install required python modules}} option on the Addon Managers - [[Gramps_6.0_Wiki_Manual_-_Navigation#General|Settings tab]]

=== Add ChatWithTree to the Gramps Dashboard ===

After installing the addon via the Addon Manager, go to the Dashboard and {{man menu|Add a gramplet > Chat With Tree Interactive Addon}}. by right clicking and installing in the Dashboard View.

[[File:chatwithtree-addtodashboard.png]]

= Issues =
* {{bug|???}} MS-Windows AIO is unable to install litellm Python prerequisite "ModuleNotFoundError: No module named 'ctypes.wintypes'" (see hidden comment for full error message)
** same error message as {{bug|0013921}} S3 Media Uploader [ ImportError: cannot import name 'wintypes' from 'ctypes' (C:...\lib\library.zip\ctypes__init.pyc) ]
** already mentioned by PQYPLZXHGF on PR see https://github.com/gramps-project/addons-source/pull/762#issuecomment-3239587788


=See also=
* [https://gramps.discourse.group/t/chatwithtree-gramplet-addon/8251 ChatWithTree gramplet addon] 2025/08/31 - introduction message of Gramps forum.
* [https://github.com/gramps-project/addons-source/pull/762 ChatWithTree gramplet addition]

[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Prerequisites]]

Addon:ChatWithTree

2025-11-02T22:09:14Z

CallMeDave: /* Issues */

{{Third-party addon}}
{{man warn|You may install the external addon project manually.|See [[#Installation|Installation]]

*The Gramplet is built for Gramps version 6}}
{{man warn|Privacy warning - addon requires Internet access for external LLM models|The {{man label|Chat With Tree}} Gramplet addon uses tools to query your Gramps database, and sends via the Internet the found information to the LLM's. When you use remote LLMs that are running in the cloud on the Internet, for example via OpenRouter, be aware that your local data is sent to those models!

{{man menu|If privacy is your concern, then always ensure to run this tool only with local running LLM models}}, for example using a local setup with tools that enable running LLMs locally. One example of that is with https://www.ollama.com/}}
[[File:chatwithtree-examplechat.png|450px|thumb|right|ChatWithTree Gramplet example]]
The {{man label|Chat With Tree}} Gramplet is an intelligent interpreter to query your family history. It does this by connecting your rich genealogy data directly with the power of a Large Language Model (LLM). This Gramplet transforms your family tree into an interactive chatbot, allowing you to literally "talk with the tree" to ask complex questions about relationships, details, and connections within your Gramps database using natural language queries!

;Features

*Shows a chat like interface
*Select Large Language Model (LLM) models from several different AI providers
**Apart from the free local models using self-started tools (ollama), you can also connect to hosted sites for openai, anthrophic, openrouter etc, all thanks to the llm python model
**You have to create an API key for the model that you want to use
*Start anywhere in your tree using the “search by name” tool
*Person information searches the person notes of Gramps to tell about the people found
*When the AI bot is thinking, it shows the thinking in the chat - showing the strategy to answer difficult questions

== Usage ==

[[#Installation|Add and install]] the external '''ChatWithTree''' project along with the required [[#Prerequisites|''litellm'' Python module prerequisite]] and then [[#Add_ChatWithTree_to_the_Gramps_Dashboard|add]] the {{man label|Chat With Tree}} Gramplet to the Dashboard view.

In the {{man label|Chat With Tree}} Gramplets empty textbox entry field at the bottom of the screen you can:

* Start a chat by typing a text message and pressing the {{man button|Send}} button or
* {{man button|Send}} commands by starting a message with a slash <code>/</code> see the [[#Commands|ChatWithTree Commands]] section.

You always have to select a chat-model first so that the tool knows what LLM is to be used for interacting with the genealogy tree.

When you select a certain chat-model, you will have to have set a valid API key as an environment-variable for that model before starting Gramps!

[[File:chatwithtree-setmodelcommand.png]]

Above example shows what happens when the model does not have a valid API key set. When using local models this is not an issue.

=== Example chat - what chat balloons are visible? ===

When the interaction with a LLM model is successful you can interact with the model:

[[File:chatwithtree-examplechat.png|680px]]

====Legend====
Note the color of the balloons.

*The green balloons are what I have typed above
*The yellow balloons show the “thinking strategy” how the AI model is going to use the tools that are provided - there will always be one balloon showing what local tools have been used to read Gramps database information.
*The last blue balloon is the final answer of the AI model.

=== Commands ===

These commands control the settings of the {{man label|Chat With Tree}} Gramplet addon:

* <code>/help</code> - shows a generic help text
* <code>/history</code> - show the full chat history in JSON format
* <code>/setmodel <model_name></code> - set the model name to use for the LLM
* <code>/setlimit <number></code> - set the tool-calling loop limit (6-20)

==== <code>/help</code> command ====

The <code>/help</code> command shows generic help text.

==== <code>/history</code> command ====

The <code>/history</code> command shows the full chat-history of what {{man label|Chat With Tree}} Gramplet has gathered in memory. This is a very verbose version of the chat, with a some internal ways of showing information like Javascript Object notation (JSON) - mostly interesting if you want to know in detail what conversation the addon has been doing with the LLM

==== <code>/setmodel</code> command ====

With the <code>/setmodel</code> command you select the model the {{man label|Chat With Tree}} Gramplet addon opens up the conversation. Some examples are:

* <code>/setmodel ollama/deepseek-r1:1.5b</code>
* <code>/setmodel openrouter/moonshotai/kimi-k2:free</code>
* <code>/setmodel gemini/gemini-2.0-flash</code>
* <code>/setmodel ollama/gpt-oss:120b-cloud</code>
* <code>/setmodel openrouter/z-ai/glm-4.5-air:free</code>

==== <code>/setlimit</code> command ====

Set the tool calling loop limit (a number between 6 and 20). A low number ensures a quicker final response, preventing certain models to continuously try calling the same tools. For questions that would take a lot of interactions, a limit of 20 might be feasible.

== How does it all work? ==

The {{man label|Chat With Tree}} Gramplet is built in such a way that it sends off a list of "tool names" to the LLM, and based on the message sent, will determine what tools it needs to respond. The tools in the respond execute an interaction with your Gramps database, and the results are then send back to the LLM again, so that the LLM can process the information for an answer.

This interaction between tool calling, thinking of the model, is shown in the ```yellow balloons```.

You will find out that certain models are way better, or smarter, in this tool calling task then other models. As an example, try asking the model a very difficult question. Example:

<blockquote>

From the start person of this genealogy tree, can you tell me all names going back in time by following the mother, then the father, then the mother, then the father, and so on, until you do not find a person anymore? Name all these people with their birth dates, and based on the birth locations, and occupations of these people, based on your own knowledge of these places, can you tell me the most likely family heritage we are looking into?


</blockquote>

== Privacy warning ==

Privacy warning. The {{man label|Chat With Tree}} Gramplet addon uses tools to query your Gramps database, and sends off the found information to the LLM's. When you use remote LLMs that are running in the cloud, for example via OpenRouter, be aware that your local data is send to those models! If privacy is of your concern, then always ensure to run this tool only with local running models, for example using a local setup with tools that enable running LLMs locally. One example of that is with https://www.ollama.com/

== Installation ==

You can install the Addon gramplet by adding a new project via {{man menu|Edit->Addon-manager}} {{man label|Projects}} tab.

Add the following Project to the projects tab:

Summary: '''ChatWithTree'''

URL: '''<nowiki>https://raw.githubusercontent.com/MelleKoning/addons/refs/heads/myaddon60/gramps60/</nowiki>'''

The URL points to the source of the addon.

[[File:chatwithtree-addonproject.png]]

Next is to select the addon in the list of addons:

[[File:chatwithtree-selectaddon.png]]

The addon is now installed, but not yet visible in Gramps.

=== Prerequisites ===
The following prerequisite is required before you can install the addon.
* [https://pypi.org/project/litellm/ litellm] Python module

Enable the {{checkbox|1}}{{man label|Allow Gramps to install required python modules}} option on the Addon Managers - [[Gramps_6.0_Wiki_Manual_-_Navigation#General|Settings tab]]

=== Add ChatWithTree to the Gramps Dashboard ===

After installing the addon via the Addon Manager, go to the Dashboard and {{man menu|Add a gramplet > Chat With Tree Interactive Addon}}. by right clicking and installing in the Dashboard View.

[[File:chatwithtree-addtodashboard.png]]

= Issues =
* {{bug|???}} MS-Windows AIO is unable to install litellm Python prerequisite "ModuleNotFoundError: No module named 'ctypes.wintypes'" (see hidden comment for full error message)
** same error message as {{bug|0013921}} S3 Media Uploader [ ImportError: cannot import name 'wintypes' from 'ctypes' (C:...\lib\library.zip\ctypes__init.pyc) ]
** already mention on PR see https://github.com/gramps-project/addons-source/pull/762#issuecomment-3239587788


=See also=
* [https://gramps.discourse.group/t/chatwithtree-gramplet-addon/8251 ChatWithTree gramplet addon] 2025/08/31 - introduction message of Gramps forum.
* [https://github.com/gramps-project/addons-source/pull/762 ChatWithTree gramplet addition]

[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Prerequisites]]

Addon:ChatWithTree

2025-11-02T22:08:16Z

CallMeDave: /* See also */

{{Third-party addon}}
{{man warn|You may install the external addon project manually.|See [[#Installation|Installation]]

*The Gramplet is built for Gramps version 6}}
{{man warn|Privacy warning - addon requires Internet access for external LLM models|The {{man label|Chat With Tree}} Gramplet addon uses tools to query your Gramps database, and sends via the Internet the found information to the LLM's. When you use remote LLMs that are running in the cloud on the Internet, for example via OpenRouter, be aware that your local data is sent to those models!

{{man menu|If privacy is your concern, then always ensure to run this tool only with local running LLM models}}, for example using a local setup with tools that enable running LLMs locally. One example of that is with https://www.ollama.com/}}
[[File:chatwithtree-examplechat.png|450px|thumb|right|ChatWithTree Gramplet example]]
The {{man label|Chat With Tree}} Gramplet is an intelligent interpreter to query your family history. It does this by connecting your rich genealogy data directly with the power of a Large Language Model (LLM). This Gramplet transforms your family tree into an interactive chatbot, allowing you to literally "talk with the tree" to ask complex questions about relationships, details, and connections within your Gramps database using natural language queries!

;Features

*Shows a chat like interface
*Select Large Language Model (LLM) models from several different AI providers
**Apart from the free local models using self-started tools (ollama), you can also connect to hosted sites for openai, anthrophic, openrouter etc, all thanks to the llm python model
**You have to create an API key for the model that you want to use
*Start anywhere in your tree using the “search by name” tool
*Person information searches the person notes of Gramps to tell about the people found
*When the AI bot is thinking, it shows the thinking in the chat - showing the strategy to answer difficult questions

== Usage ==

[[#Installation|Add and install]] the external '''ChatWithTree''' project along with the required [[#Prerequisites|''litellm'' Python module prerequisite]] and then [[#Add_ChatWithTree_to_the_Gramps_Dashboard|add]] the {{man label|Chat With Tree}} Gramplet to the Dashboard view.

In the {{man label|Chat With Tree}} Gramplets empty textbox entry field at the bottom of the screen you can:

* Start a chat by typing a text message and pressing the {{man button|Send}} button or
* {{man button|Send}} commands by starting a message with a slash <code>/</code> see the [[#Commands|ChatWithTree Commands]] section.

You always have to select a chat-model first so that the tool knows what LLM is to be used for interacting with the genealogy tree.

When you select a certain chat-model, you will have to have set a valid API key as an environment-variable for that model before starting Gramps!

[[File:chatwithtree-setmodelcommand.png]]

Above example shows what happens when the model does not have a valid API key set. When using local models this is not an issue.

=== Example chat - what chat balloons are visible? ===

When the interaction with a LLM model is successful you can interact with the model:

[[File:chatwithtree-examplechat.png|680px]]

====Legend====
Note the color of the balloons.

*The green balloons are what I have typed above
*The yellow balloons show the “thinking strategy” how the AI model is going to use the tools that are provided - there will always be one balloon showing what local tools have been used to read Gramps database information.
*The last blue balloon is the final answer of the AI model.

=== Commands ===

These commands control the settings of the {{man label|Chat With Tree}} Gramplet addon:

* <code>/help</code> - shows a generic help text
* <code>/history</code> - show the full chat history in JSON format
* <code>/setmodel <model_name></code> - set the model name to use for the LLM
* <code>/setlimit <number></code> - set the tool-calling loop limit (6-20)

==== <code>/help</code> command ====

The <code>/help</code> command shows generic help text.

==== <code>/history</code> command ====

The <code>/history</code> command shows the full chat-history of what {{man label|Chat With Tree}} Gramplet has gathered in memory. This is a very verbose version of the chat, with a some internal ways of showing information like Javascript Object notation (JSON) - mostly interesting if you want to know in detail what conversation the addon has been doing with the LLM

==== <code>/setmodel</code> command ====

With the <code>/setmodel</code> command you select the model the {{man label|Chat With Tree}} Gramplet addon opens up the conversation. Some examples are:

* <code>/setmodel ollama/deepseek-r1:1.5b</code>
* <code>/setmodel openrouter/moonshotai/kimi-k2:free</code>
* <code>/setmodel gemini/gemini-2.0-flash</code>
* <code>/setmodel ollama/gpt-oss:120b-cloud</code>
* <code>/setmodel openrouter/z-ai/glm-4.5-air:free</code>

==== <code>/setlimit</code> command ====

Set the tool calling loop limit (a number between 6 and 20). A low number ensures a quicker final response, preventing certain models to continuously try calling the same tools. For questions that would take a lot of interactions, a limit of 20 might be feasible.

== How does it all work? ==

The {{man label|Chat With Tree}} Gramplet is built in such a way that it sends off a list of "tool names" to the LLM, and based on the message sent, will determine what tools it needs to respond. The tools in the respond execute an interaction with your Gramps database, and the results are then send back to the LLM again, so that the LLM can process the information for an answer.

This interaction between tool calling, thinking of the model, is shown in the ```yellow balloons```.

You will find out that certain models are way better, or smarter, in this tool calling task then other models. As an example, try asking the model a very difficult question. Example:

<blockquote>

From the start person of this genealogy tree, can you tell me all names going back in time by following the mother, then the father, then the mother, then the father, and so on, until you do not find a person anymore? Name all these people with their birth dates, and based on the birth locations, and occupations of these people, based on your own knowledge of these places, can you tell me the most likely family heritage we are looking into?


</blockquote>

== Privacy warning ==

Privacy warning. The {{man label|Chat With Tree}} Gramplet addon uses tools to query your Gramps database, and sends off the found information to the LLM's. When you use remote LLMs that are running in the cloud, for example via OpenRouter, be aware that your local data is send to those models! If privacy is of your concern, then always ensure to run this tool only with local running models, for example using a local setup with tools that enable running LLMs locally. One example of that is with https://www.ollama.com/

== Installation ==

You can install the Addon gramplet by adding a new project via {{man menu|Edit->Addon-manager}} {{man label|Projects}} tab.

Add the following Project to the projects tab:

Summary: '''ChatWithTree'''

URL: '''<nowiki>https://raw.githubusercontent.com/MelleKoning/addons/refs/heads/myaddon60/gramps60/</nowiki>'''

The URL points to the source of the addon.

[[File:chatwithtree-addonproject.png]]

Next is to select the addon in the list of addons:

[[File:chatwithtree-selectaddon.png]]

The addon is now installed, but not yet visible in Gramps.

=== Prerequisites ===
The following prerequisite is required before you can install the addon.
* [https://pypi.org/project/litellm/ litellm] Python module

Enable the {{checkbox|1}}{{man label|Allow Gramps to install required python modules}} option on the Addon Managers - [[Gramps_6.0_Wiki_Manual_-_Navigation#General|Settings tab]]

=== Add ChatWithTree to the Gramps Dashboard ===

After installing the addon via the Addon Manager, go to the Dashboard and {{man menu|Add a gramplet > Chat With Tree Interactive Addon}}. by right clicking and installing in the Dashboard View.

[[File:chatwithtree-addtodashboard.png]]

= Issues =
* {{bug|???}} MS-Windows AIO is unable to install litellm Python prerequisite "ModuleNotFoundError: No module named 'ctypes.wintypes'" (see hidden comment for full error message)
** same error message as {{bug|0013921}} S3 Media Uploader [ ImportError: cannot import name 'wintypes' from 'ctypes' (C:...\lib\library.zip\ctypes__init.pyc) ]


=See also=
* [https://gramps.discourse.group/t/chatwithtree-gramplet-addon/8251 ChatWithTree gramplet addon] 2025/08/31 - introduction message of Gramps forum.
* [https://github.com/gramps-project/addons-source/pull/762 ChatWithTree gramplet addition]

[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Prerequisites]]