15,091
edits
Changes
→Add Windows OS Menu Item
== Preferences ==
[[File:EditPreferencesTabsOnly-overview-5152.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all 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...}}.
The tabs on the top display the available option categories as follows:
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Data|Data]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#General|General]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#DisplayImport|DisplayImport]]}}*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Limits|Limits]]}}*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Colors|Colors]]}}*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Text|Text]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#ID_FormatsWarnings|ID Formats]]}}*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Dates|DatesWarnings]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Researcher|Researcher]]}}
Also ''other'' additional tabs maybe shown from any [[5.2_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== General Data === [[File:EditPreferences-GeneralData-tab-exampledefault-5152.png|Rightright|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} General Menu: "Edit -> Preferences (Linux)]] This tab contains two sections containing preferences relevant to the general operation of the program. Sections and options are: ==== General Gramps settings ====*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_5.2_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" "Data" tab defaults]] reference to the imported file. '''Note - Adding a default source can significantly slow down the importing of your GEDCOM data.'''*{{checkbox|0}}The {{man label|Add tag on importData}}: Checkbox (Default: <code>Imported %Y/%m/%d %H:%M:%S</code> ) '''Note - Adding a [[Gramps_Glossary#tag|Tag]] on import can significantly slow down the importing of your data.''' {{man tooltip|Specified tag will be added on import. Clear tab contains preferences relevant to set default value.}}*{{checkbox|0}}{{man label|Enable spelling checker}}: This checkbox option controls the enabling and disabling of the spelling checker for notes. The '''gtkspell''' package must be loaded for this to have an effect. ( Seefollowing two sections: [[Troubleshoot Spellcheck]] )*{{checkbox|0}}{{man label|Display Tip of the Day}}: This checkbox option controls the enabling and disabling of the {{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Tip_of_the_Day_dialogDisplay_Options|Tip of the DayDisplay Options]]}} dialog at startup. {{man tooltip|Show useful information about using Gramps on startup.}}*{{checkbox|0}}{{man label|Remember last view displayed}}: This checkbox option controls the enabling and disabling of the 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.}}*{{man label|Max generations for relationships:}} You can enter the number of generations used to determine relationships. The default value is '''<code>15</code>'''.*{{man label|Base path for relative media paths:}} Here you can fill in a base path for the media objects. Selecting the {{man button|Directory}} button gives you a {{man label|Select media directory}} editor where you can fill in the required path. ==== Third party addons management ====*{{man label|Check for addon updates:}} Select the frequency that Gramps checks for updates to [[5.2_Addons#Installing_Addons_in_Gramps|Addons]]. Default: ''Never''*{{man label|What to check:}} Default: ''New addons only''*{{man label|Where to check:}} (Gramps compatible Addon servers): ''Default'' - Gramps project: <code>https://raw.githubusercontent.com/gramps-project/addons/master/gramps51</code>: Isotammi project: <code>https://raw.githubusercontent.com/Taapeli/isotammi-addons/master/addons/gramps</code>*{{checkbox|1}}{{man label|Do not ask about previously notified addons}}: Checkbox selected by default*{{man button|Check for updated addons now}}: Button to force a check for Addons, if Addons are available you will then be presented the {{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Available_Gramps_Updates_for_AddonsInput_Options|Available Gramps Updates for AddonsInput Options]]}} window where you choose and install them from.
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-52.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:
** Clicking on the right hand side {{man button|Edit...}} button will bring up a {{man label|[[Gramps_5.2_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=Note|2=Besides this database-wide setting Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_5.2_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)''' (Defaultdefault) - 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
** DAY MON YEAR
*{{man label|Age display precision(requires *:}} {{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 warnlabel|Round the year}} {{new|Reported Bug in version 5.2.1 Fixed in version 5.2.2}}*{{checkbox|1}}{{man label|Changes made in the "Age Display Precision" in the Preferences Display tab cannot be saved in this version of ages for events after death *}} {{man menu|Please note that once changed, it is necessary to restart Gramps. <br><br>A manual workaround is detailed in to see the Bug Reportchange.<br>''See'' bug report }} {{Bugnew|11384}}5.1}}
*{{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_5.2_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}} {{new|5.2.0}}
*<span id="surname guessing">{{man label|Surname GuessingStatus bar:}}<span> This option affects controls the initial family name of a child when they are added to information displayed in the family treestatus bar. The default {{man label|Father's surname}} will use This can be either the family name of the father. Selecting {{man label|None}} means that no surname guessing will be attempted. Selecting {{man label|Combination of mother's and father's surname}} will use the father's name followed by the mother's name. Finally, {{man label[[Gramps_Glossary#active_person|[https://wikipedia.org/wiki/Icelandic_name Icelandic styleActive Person]]}} will use the father's given name followed by the "sson" suffix and ID''' (e.g. the son of Edwin will be guessed as Edwindefault) or '''Relationship to [[Gramps_Glossary#home_person|home person]]'sson'').
*{{man tiplabel|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=Tip .6 and earlier. {{new|5.2.0}} ===== Place Format Editor =====The {{man labelnote|See|Surname Guessing:[[Hierarchical Place Structure]]}} option only affects the initial family name guessed by Gramps when the {{man label|[[Gramps_5.2_Wiki_Manual_File:EditPreferences-Data-tab-Display-section-PlaceFormatEditor-dialog-_Entering_and_editing_data:_detailed_default-_part_152.png|right|thumb|450px|Fig. {{#Edit_Person_dialog|Edit Person]]var:chapter}} dialog is launched from a .{{man label#vardefineecho:figure|Family Editor{{#expr:{{#var:figure}}+1}}}} windowPlace Format Editor - dialog (default) from Menu: "Edit>Preferences.You can modify that name any way you see fit. Set this Preferences [[Gramps_5.2_Wiki_Manual_" -_Settings#Display|"Data" tab "Display tab" section]] option to the value that you will most frequently use, as it will save you a lot of typing.
*{{man label|Default family relationshipName:}} A unique name for the place format.** '''Unknown'''{{man label|Levels:}} 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 (defaulte.g. p+1 or p-2)** Married ** Unmarried ** Civil Union.
*{{man label|Status barStreet format:}} "None" (default), "Number Street" or "Street Number". This option controls Option to concatenate the information displayed number and street in order to suppress the status barcomma. This can be either For this option to work, the street must have the [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''Active person's name ]] ''Street'' and IDhouse number must have the '''(default) or Type''''Relationship to home person'Number''.*{{man label|Language:}} (Empty by Default) A two-digit language code.*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)
See also:*{{checkbox|1}}{{man label|Show text label beside Navigator buttons (requires restart)}} ''checked'' (default) This checkbox controls whether or not a text description is displayed next to the icon in the [[Gramps_5.2_Wiki_Manual_-_Main_Window_Entering_and_editing_data:_detailed_-_part_2#NavigatorPlace_Editor_dialog|NavigatorPlace Editor dialog]] in the * [[Gramps_5.2_Wiki_Manual_-_Main_Window_Entering_and_editing_data:_detailed_-_part_2#Main_WindowPlace_Name_Editor_dialog|Main WindowPlace Name Editor dialog]]. 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.-}}
=====Display Name Editor=====
{{man note|1=Note|2=Custom name display formats are stored in the Family Trees, thus before loading any Family Tree the {{man label|Custom format details}} expander is disabled.}}
[[File:EditPreferences-DisplayData-tab-DisplayOptions-section-DisplayNameEditor-dialog-exampledefault-5052.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor - dialog (exampledefault) from Menu: "Edit>Preferences..." - "Data" tab > "DisplayOptions" - tabsection]]
The following keywords are replaced with the appropriate name parts:
* <b>Given</b> - given name (first name)
* <b>Suffix</b> - suffix (Jr., Sr.)
* <b>Nickname</b> - nick name
* <b>Common</b> - nick nameas first option if it exists, Call as second option, otherwise first of Given
* <b>Prefix</b> - all prefixes (von, de)
* <b>Notpatronymic</b>- all surnames, except pa/matronymic & primary
All the fields in the Example 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 & Display controls, Date range controls for using a particular name.
<!-- mention the three buttons at the bottom-->
{{-}}
==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-52.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Input Options" section defaults]]
*<span id="surname guessing">{{man label|Surname guessing:}}<span> 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_5.2_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_5.2_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_culture Category:Names by culture], From Wikipedia, the free encyclopedia}}
*{{man label|Default family relationship:}} - used by the {{man label|[[Gramps_5.2_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_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|person]] and [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS_2|family]] editors}}: Latter Days Saints {{new|5.2.0}}
{{-}}
=== General ===[[File:EditPreferences-General-tab-EnviromentSettings-section-default-52.png|Right|thumb|450px|Fig. {{stub#var:chapter}}<!-.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} General Preferences - mention the three buttons at the bottomEnviroment Settings -section ->(defaults)]]
==== Environment Settings ====*{{checkbox|0}}{{man label|Display Tip of the Day}}: This checkbox option controls the enabling and disabling of the {{man label|[[File:EditPreferences-Display-tab-PlaceFormatEditorGramps_5.2_Wiki_Manual_-_Settings#Tip_of_the_Day_dialog|Tip of the Day]]}} dialog-example-50at startup.png{{man tooltip|rightShow useful information about using Gramps on startup.}}*{{checkbox|thumb|450px|Fig. 0}}{{#var:chapterman 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.*{{#vardefineecho:figurecheckbox|0}}{{man label|Remember last view displayed}}: This checkbox option controls the enabling and disabling of the display of the last [[Gramps_Glossary#expr:view|View]]. Enabling will bring you to the view where you stopped the program the last time. {{#var:figureman tooltip|Remember last view displayed and open it next time.}}+1*{{checkbox|0}}{{man label|Enable spell checker}} Place Format Editor - dialog (example) from Menu: "Edit>PreferencesThis 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- "Display" - tabproject/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 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}} *{{checkbox|0}}{{man label|Show close button in gramplet bar tabs}} ''unchecked''(default) {{man tooltip|Show close button to simplify removing gramplets from bars.}} *{{man label|Markup for invalid date format:}} Default: <code><b>%s</b></code>** Convenience markups are:*** <b><b>Bold</b></b> (Default)*** <big><big>Makes font relatively larger</big></big>*** <i><i>Italic</i></i>*** <s><s>Strikethrough</s></s>*** <sub><sub>Subscript</sub></sub>*** <sup><sup>Superscript</sup></sup>*** <small><small>Makes font relatively smaller</small></small>*** <tt><tt>Monospace font</tt></tt>*** <u><u>Underline</u></u>**** For example: <u><b>%s</b></u> will display <u><b>Underlined bold date</b></u>. *{{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-WhatsThatFor-52.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog]] When enabled in {{man menu|Edit > Preferences}} {{man label|General}} tab contains preferences relevant 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 how Places should be shownthe next tip.*{{man button|Close}} - exit for this session until the Gramps program is restarted.[[Category:Tips]]<!-- 2023/09/08 List of 73 Tips are stored here https://github.com/gramps-project/gramps/blob/maintenance/gramps52/data/tips. xml -->{{-}}
See also:
* [[Gramps_5.2_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* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds experimental support for PostgreSQL databases. Recommended for Experts only! ====Database Settings====*{{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 The ''[[Gramps_Glossary#bsddb|BSDDB]]'' - Legacy Database backend was superseded in the Gramps 5.1 version. ====Database Location====*{{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|Family Tree 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_5.2_Wiki_Manual_-_User_Directory|User Directory]]. ====Backup Management====*{{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 {{new|5.2.0}}** Every day {{new|5.2.0}}{{-}} ====Family Tree's Media path====*{{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_5.2_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_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialogSelect_a_media_object_selector|Place Editor Select a media object selector]]}} dialog. Once checked for the first time it will be remembered for each subsequent media selection.}} See also: *[[Gramps_5.2_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_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed__Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}** {{man label|[[Gramps_5.2_Wiki_Manual_-_part_2_Tools#Place_Name_Editor_dialogConvert_paths_from_absolute_to_relative|Place Name Editor Convert paths from absolute to relative]]}} =====Select media directory dialog===== See [[Gramps_5.2_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}
=== Text ==Missing Media Objects 'broken link' icon of a box with a red 'x'=====
[[File:EditPreferences-Text-tab-default-51Broken Media Path.png|right|450px|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Text" - tab - defaultsMedia object with a broken filepath]]
See also:*{{man label|Missing surname:}} in the input field you can determine how a missing surname should be displayedExample. Default value is '''<code>gramps - [Missing Surname]</code>'''. You can change this to [--] or whatever is most convenient for youExample.*{{man labelgramps#Connecting_to_the_example_Media_Objects|Missing given name}} in Connecting to the input field you can determine how a missing given name should be displayed. Default value is '''<code>[Missing Given Nameexample Media Objects]</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>
{{-}}
=== ID Formats Import ===[[File:EditPreferences-Import-tab-default-52.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:
*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_5.2_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.'''
{{-}}
=== Dates Limits ===[[File:EditPreferences-Limits-tab-default-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Limits" - tab - defaults]]
Settings used for calculation operations. See also:* [[File:EditPreferencesGramps 5.2 Wiki Manual -DatesProbably Alive]]* [[Gramps_5.2_Wiki_Manual_-tab-default_Entering_and_editing_data:_detailed_-51.png|right|thumb|450px|Fig. {{_part_1#var:chapter}}.{{#vardefineecho:figureEditing_dates|{{#expr:{{Editing dates]]* Setting the [[Match_dates#var:figure}}+1}}}} Menu: "Edit>PreferencesChanging_after.2Fbefore.2Fabout_range|date approximation ." - "Dates" - tab - defaultsini]]manually
*{{man label|Markup for invalid date format:}} Default: <code><b>%s</b></code>** Convenience markups areDate 'about' year range:*** <b><b>Bold</b></b> (Defaultdate ± #)*** <big><big>Makes font relatively larger</big></big>*** <i><i>Italic</i></i>*** <s><s>Strikethrough</s></s>*** <sub><sub>Subscript</sub></sub>*** <sup><sup>Superscript</sup></sup>*** <small><small>Makes font relatively smaller</small></small>*** <tt><tt>Monospace font</tt></tt>*** <u><u>Underline</u></u>**** For example: <u><b>%s</b></u> will display <u><b>Underlined bold date</b></u>.*{{man label|Date about range:}} 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|Minimum years between generations:}} Default: <code>13</code>
*{{man label|Average years between generations:}} Default: <code>20</code>
*{{-man label|Max generations for relationships:}}See also:* [[Gramps 5You can enter the number of generations used to determine relationships. The default value is '''<code>15</code>'''.2 Wiki Manual - Probably Alive]]* Limits the scope of features based on the [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1_Tools#Editing_datesRelationship_Calculator|Editing datesRelationship Calculator]]* Setting the [[Match_dates#Changing_after.2Fbefore.2Fabout_range|date approximation .ini]] manually
{{-}}
=== Researcher Colors ==={{man tip|Researcher Information|This contact information is independent of the family trees you create.<br /><br />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-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Researcher" - tab - defaults]]
====Colors for Male persons====*{{checkbox|1}}{{man label|Suppress warning when adding parents to a child.}} Checkbox checked by Default (See Background for Alive: [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference] #Suppress_warning_when_adding_parents_to_a_child|Dialog]])b8cee6*{{checkbox|0}}{{man label|Suppress warning when cancelling with changed data.}} Checkbox unchecked by Default (See Border for Alive: [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference] #Suppress_warning_when_cancelling_with_changed_data|Dialog]])1f4986*{{checkbox|0}}{{man label|Suppress warning about missing researcher when exporting to GEDCOM.}} Checkbox unchecked by Default (See Background for Dead: [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference] #Suppress_warning_about_missing_researcher_when_exporting_to_GEDCOM|Dialog]])b8cee6*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See Border for Dead: [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference] #Module_not_loaded_warnings|Dialog]])000000
====Colors for Female persons====
* Background for Alive: [ ] #feccf0
* Border for Alive: [ ] #861f69
* Background for Dead: [ ] #feccf0
* Border for Dead: [ ] #000000
==== Colors for Unknown persons====* Background for Alive: [ ] #f3dbb6* Border for Alive: [ ] #8e5801* Background for Dead: [ ] #f3dbb6* Border for Dead: [ ] #000000
====Colors for Family nodes====* Default background: [] #eeeeee* Default border: [File] #cccccc* Background for Married:EditPreferences-Colors-tab-default-51.png|right|thumb|450px|Fig. {{[ ] #vareeeeee* Background for Unmarried:chapter}}.{{[ ] #vardefineechoeeeeee* Background for Civil Union:figure|{{[ ] #expreeeeee* Background for Unknown:{{[ ] #vareeeeee* Background for Divorced:figure}}+1}}}} Menu[ ] #eeeeee* Border for Divorced: "Edit>Preferences..." - "Colors" - tab - defaults[ ]]<!-- ignore that color is spelt "colour" in the screenshot as I am using gramps in Australian mode-->#ff7373
{{-}}
{{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-activateddefault-5152.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences tab - activated 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 "use {{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.
* Feature request: {{bug|9098}} Gramps should be able to use genealogy symbols everywhere.
* [[Customize the Genealogical Symbols lookup table]] located in the [[Gramps_5.2_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.<br /><br />See: Python [https://docs.python.org/3/library/string.html#format-specification-mini-language (String) Format Specification Mini-Language]}}
[[File:EditPreferences-IDFormats-tab-default-52.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_5.2_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}
=== Text ===
[[File:EditPreferences-Text-tab-default-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Text" - tab - defaults]]
This tab contains preferences relevant to how missing and private names and records should be shown.
*{{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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]
This tab controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.
*{{checkbox|1}}{{man label|Suppress warning when adding parents to a child.}} Checkbox checked by Default (See [[Gramps_5.2_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_5.2_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_5.2_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 {{new|5.2.0}}
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])
See the [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
{{-}}
=== Researcher ===
{{man tip|Researcher Information|This contact information is independent of the family trees you create.<br /><br />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-52.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 [[Gramps_5.2_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]] tool.
{{-}}
{{man tip|1=Column Editor|2=The {{man label|Column 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:ConfigureTheActiveView-icon-on-toolbar-5152.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selecting the {{man button|Configure View...}} button]]
[[File:ColumnEditor-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Column Editor - Dialog - People default]]
The columns of the list views may be added, removed, or reordered in a {{man label|Column Editor}} dialog.
To use the {{man label|Column Editor }} dialog for the current view, 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_5.2_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.
===Export View===
[[File:Menubar-FamilyTrees-overview-example-5052.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_5.2_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_5.2_Wiki_Manual_-_Navigation#Main_Menus|menu]] command.
The example screenshot shows an export to the '''OpenDocument Spreadsheet''' (ODS format) displayed as a Spreadsheet in Libreoffice Calc.
{{-}}
====CSV Dialect====
<!-- new in Gramps 5.2-->
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".
All list table views have a 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 from:
*excel
*excel-tab
*unix
*Custom
** Delimiter:
*** '.' (default)
*** ';'
*** ':'
*** '|'
*** 'tab'
[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}}. This document outlines 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 3rd 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 [[5.2_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_5.2_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[5.2 Addons|Third-Party Addons]].
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_5.2_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_5.2_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}
====Document Styles dialog====
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|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.
*{{man label|Paragraph options}} : Here you 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===
Used in various places in Gramps; how you access the context menu is dependent on your operating systems:
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_5.2_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]]<!-- screenshot shows UK/Australian spelling of colour, please keep USA spelling for user manual-->
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 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_5.2_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 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.
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_5.2_Wiki_Manual_-_Keybindings|keybinding]].
====Bookmarking file folders====
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 facile 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 rest change the LAN env 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-5.2.3^" gramps.exe"</code>
==== Linux ====
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:
python Gramps.py
==== Mac OS X macOS ====
For Mac OS X 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:Microsoft Window Gramps AIO Installer Choose Components-Selection-5152.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]
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 [[DownloadInstalling_Gramps_for_Windows_computers#MS_WindowsMissing_other_languages]] page.
{{-}}
===Add Windows OS Menu Item===
[[File:Edit-Target-GrampsAIO64-Properties-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for shortcut example.]] To make Gramps work in your selected language (See table below for your [[Gramps_5.2_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:* Using your mouse right button click on the "GrampsAIOxx {{man label|GrampsAIO64 5.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: "GrampsAIOxx {{man label|GrampsAIO64 5.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 "GrampsAIOxx {{man label|GrampsAIO64 5.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(xxx)\GrampsAIOxxGrampsAIO64-5.x.x\grampsw.exe"</code> to:
***<code>%comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"</code>
* Click {{man label|OK and now }} Now when you click on that icon Gramps will start in Danish. {{-}}
===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:
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===
!Notes
|-
| <!--Language--> English-USA (Default)|<!--ISO code--> en_US.UTF-8|<!--Example--> %comspec% /c set LANG=en_US.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> English (British)|<!--ISO code--> en_GB.UTF-8|<!--Example--> %comspec% /c set LANG=en_GB.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Finnish|<!--ISO code--> fi.UTF-8|<!--Example--> %comspec% /c set LANG=fi.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Russian|<!--ISO code--> ru_RU.UTF-8|<!--Example--> %comspec% /c set LANG=ru_RU.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Albanian|<!--ISO code--> sq_AL.UTF-8|<!--Example--> %comspec% /c set LANG=sq_AL.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> German|<!--ISO code--> de_DE.UTF-8|<!--Example--> %comspec% /c set LANG=de_DE.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> French|<!--ISO code--> fr_FR.UTF-8|<!--Example--> %comspec% /c set LANG=fr_FR.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> French Canadian|<!--ISO code--> fr_CA.UTF-8|<!--Example--> %comspec% /c set LANG=fr_CA.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Macedonian|<!--ISO code--> mk_MK.UTF-8 ???|<!--Example--> |<!--Notes-->|-|<!--Language--> Nederlands (Dutch)|<!--ISO code--> nl_NL.UTF-8|<!--Example--> %comspec% /c set LANG=nl_NL.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Dutch| <!--ISO code--> nl_BE.UTF-8|<!--Example--> %comspec% /c set LANG=nl_BE.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Slovak|<!--ISO code--> sk_SK.UTF-8|<!--Example--> %comspec% /c set LANG=sk_SK.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Hebrew|<!--ISO code--> he_IL.UTF-8|<!--Example--> %comspec% /c set LANG=he_IL.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Danish|<!--ISO code--> da_DK.UTF-8|<!--Example--> %comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"|<!--Notes-->|-|<!--Language--> Greek|<!--ISO code--> el_GR.UTF-8|<!--Example--> %comspec% /c set LANG=el_GR.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Italian|<!--ISO code--> it_IT.UTF-8|<!--Example--> %comspec% /c set LANG=it_IT.UTF-8 && start grampsw.exe" |<!--Notes-->|-|<!--Language--> Esperanto|<!--ISO code--> eo.UTF-8 ???|<!--Example--> |<!--Notes-->|-|<!--Language--> Chinese (Simplified)|<!--ISO code--> zh_CN.UTF-8|<!--Example--> %comspec% /c set LANG=zh_CN.UTF-8 && start grampsw.exe"|<!--Notes-->|-|<!--Language--> Chinese (Hong Kong) |<!--ISO code--> zh_HK.UTF-8 ???|<!--Example--> |<!--Notes-->|-|<!--Language--> Chinese (Traditional) |<!--ISO code--> zh_TW.UTF-8|<!--Example--> %comspec% /c set LANG=zh_TW.UTF-8 && start grampsw.exe"|<!--Notes-->|-|<!--Language--> Ukrainian|<!--ISO code--> uk_UA.UTF-8|<!--Example-->|<!--Notes-->|-|<!--Language--> Portuguese|<!--ISO code--> pt_PT.UTF-8|<!--Example--> %comspec% /c set LANG=pt_PT.UTF-8 && start grampsw.exe"|<!--Notes-->|-|<!--Language--> Portuguese (Brazil)|<!--ISO code--> pt_BR.UTF-8|<!--Example--> %comspec% /c set LANG=pt_BR.UTF-8 && start grampsw.exe"|<!--Notes-->|-|<!--Language--> Afrikaans|<!--ISO code--> af_ZA.UTF-8|<!--Example-->|<!--Notes-->|-|<!--Language--> Norwegian Bokmål|<!--ISO code--> nb_NO.UTF-8|<!--Example--> %comspec% /c set LANG=nb_NO.UTF-8 && start grampsw.exe"|<!--Notes-->
|-
| English (British)<!--Language--> Norwegian Nynorsk| en_GB<!--ISO code--> nn_NO.UTF-8|<!--Example--> %comspec% /c set LANG=nn_NO.UTF-8 && start grampsw.exe"|<!--Notes-->
|-
| Finnish<!--Language--> Turkish| fi<!--ISO code--> tr_TR.UTF-8|<!--Example--> %comspec% /c set LANG=tr_TR.UTF-8 && start grampsw.exe"|<!--Notes-->
|-
| French Canadian<!--Language--> Spanish| fr_CA<!--ISO code--> es_ES.UTF-8|<!--Example--> %comspec% /c set LANG=es_ES.UTF-8 && start grampsw.exe"|<!--Notes-->
|-
| Russian<!--Language--> Polish| ru_RU<!--ISO code--> pl_PL.UTF-8|<!--Example--> %comspec% /c set LANG=pl_PL.UTF-8 && start grampsw.exe"|<!--Notes-->
|-
|<!--Language--> Slovenian
|<!--ISO code--> sl_SI.UTF-8
|<!--Example--> %comspec% /c set LANG=sl_SI.UTF-8 && start grampsw.exe"
|<!--Notes-->
|-
|<!--Language-->
|<!--ISO code-->
|<!--Example-->
|<!--Notes-->
|-
|<!--Language-->
|<!--ISO code-->
|<!--Example-->
|<!--Notes-->
|-
|<!--Language-->
|<!--ISO code-->
|<!--Example-->
|<!--Notes-->
|-
|<!--Language-->
|<!--ISO code-->
|<!--Example-->
|<!--Notes-->
|}
*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].
===Advanced manipulation of settings===
{{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!'''}}
* [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
* [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====
<pre>
;; Gramps key file
;; Automatically created at 20202023/0509/13 14:17 15:15:3445
[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps52', True]];;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps51gramps52'
;;autoload=0
;;avg-generation-gap=20
;;check-for-addon-update-types=['new']
;;check-for-addon-updates=0
;;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
;;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']
;;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]
;;backend='sqlite'
;;backup-on-exit=1
;;backup-path='C:\\Users\\[username]\\Documents\\GrampsBackup'
;;compress-backup=1
;;host=''
;;path='C:\\Users\\[username]\\DocumentsAppData\\Roaming\\gramps\\grampsdb'
;;port=''
;;center-lon=0.0
;;lock=0
;;map_service=1
;;path=''
;;personal-map=''
;;show_cross=0
;;use-keypad=1
[interface]
;;dbmanager-horiz-position=12
;;dbmanager-vert-position=85
;;fullscreen=0
;;grampletbar-close=0
;;hide-lds=0
;;ignore-gexiv2=0
;;ignore-osmgpsmap=0
;;statusbar=1
;;surname-box-height=150
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-text=0
;;toolbar-tools=1
;;treemodel-cache-size=1000
;;view=1
[paths]
;;quick-backup-directory='C:\\Users\\[username]\\Documents\\gramps'
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'
;;recent-export-dir='C:\\Users\\[username]\\Documents\\gramps'
;;recent-file=''
;;recent-import-dir='C:\\Users\\[username]\\Documents\\gramps';;report-directory='C:\\Users\\[username]\\Documents\\gramps'
;;website-cal-uri=''
;;website-cms-uri=''
;;website-directory='C:\\Users\\[username]\\Documents\\gramps'
;;website-extra-page-name=''
;;website-extra-page-uri=''
[preferences]
;;age-after-death=1
;;age-display-precision=1
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-default'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;family-relation-type=3
;;family-warn=1
;;february-29=0
;;fprefix='F%04d'
;;hide-ep-msg=0
;;researcher-postal=''
;;researcher-state=''
[spacing]
dbman=[22.605613425925927, 5.877459490740741, 9.856047453703704]
[test]
;;january='January'
[utf8]
;;availablebaptism-fontssymbol='~';;birth-symbol='*';;buried-symbol='[]';;cremated-symbol='⚱';;dead-symbol='✝';;death-symbol=132;;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/gramps51gramps52/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 filenam filename pattern:
*filename
*year
Use the appropriate ~/.gramps/gramps{XX}/gramps.ini key file.
*Gramps version 5.2 :
~/.gramps/gramps51gramps52/gramps.ini
See also:
The look of Gramps can be changed.
* [[Addon:ThemesThemePreferences|Addon:Theme Preferences]]
* [[Windows_AIO_themes]]
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]