21
edits
Changes
→Dates
======Available Gramps Updates for Addons======
[[File:AvailableGrampsUpdatesforAddons-example-listing-5051.png|Right|thumb|550px|"Available Gramps Updates for Addons" window showing example listing output for Gramps 5.1]]
The {{man label|Available Gramps Updates for Addons}} window you will be shown a list broken down by '''Type''' that you can view by selecting the "Select" column expand out each "Type".
=== Display ===
[[File:EditPreferences-Display-tab-default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Display" - tab - defaults]]
*{{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. Several different predefined name formats are available: Given - Prefix Patronymic, Suffix Given - Prefix Surname, Given Patronymic Suffix etc.
*{{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 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
** Years, Months
** Years, Months, Days
{{man warn|Reported Bug in version 5.1.1 Fixed in version 5.1.2|Changes made in the "Age Display Precision" in the Preferences Display tab cannot be saved in this version of Gramps. <br><br>A manual workaround is detailed in the Bug Report.<br>''See'' bug report {{Bug|11384}}.}}
*{{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.1_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).
**** 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 range:}} 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 range:}} 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>
=== 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-51.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 all fields are blank):
*{{man label|Name:}}
*{{man label|Address:}}
[[File:EditPreferences-Colors-tab-default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - defaults]]<!-- ignore that color is spelt "colour" in the screenshot as I am using gramps in Australian mode-->
This tab allows you to set the '''Set the colors used for boxes in the graphical views'''. You can select the* {{stubman label|Colour scheme:}}''Light colours''(default) or ''Dark colours''** {{man button|Restore to defaults}} - restores themes default colors.* Colors for Male persons* Colors for Female persons* Colors for Unknown persons* Colors for Family nodes* Other colors
{{-}}
==== Pick a Color selector ====
{{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:ConfigureView_51winConfigureTheActiveView-icon-on-toolbar-51.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 example]]
[[File:Menubar-FamilyTrees-overview-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example showing "Export View" menu entry]]
On most [[Gramps_5.1_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.1_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 and . The export will contain only the displayed column data (in the same order of exported columns) and be limited to records matching any [[Gramps_5.1_Wiki_Manual_-_Filters|filters]] you have applied.
{{-}}
====Export View as Spreadsheet dialog====
*{{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:
* On Microsoft windows you generally use the right button of your mouse to show the context menu or use the keyboard shortcut "Shift"+"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 "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]
See also:
* [[Gramps 5.1 Wiki Manual - Keybindings]]
== Customizing ==
{{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!'''}}
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 list <code>gramps.ini</code> file has following sub-itemssections:*'''[behavior'''] : typical Key names are: [https://github.com/gramps-project/gramps/blob/master/gramps/gui/grampsgui.py#L502 betawarn], enable-autobackup, use-tips...*'''[colors] : * [database'''] : related to database settings for the Family Tree.*'''[export'''] : export and import dirsfolders/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 dirsfolders/directories *'''[plugin] : * [preferences'''] : keys related to preferences: all the common prefixes , todo -colors..*'''[researcher'''] : all information regarding the researcher* [utf8] :
====Example <code>gramps.ini</code> file====
Example contents of the <code>gramps.ini</code> file:
<pre>
;; Gramps key file
;; Automatically created at 2020/05/17 0915:5415:1234
[behavior]
;;date-after-range=50
;;date-before-range=50
;;do-not-show-previously-seen-addon-updates=1;;generation-depth=15;;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=0translator-needed=0;;use-tips=0;;web-search-url='http://google.com/#&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-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'];;scheme=0;;unknown-alive=['#f3dbb6', '#75507B'];;unknown-dead=['#f3dbb6', '#35103b'] [database];;autobackup=0;;backend='sqlite';;backup-on-exit=1;;backup-path='C:\\Users\\[username]\\Documents\\GrampsBackup';;compress-backup=1;;host='';;path='C:\\Users\\[username]\\Documents\\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='person';;map_service=1;;path='';;show_cross=0;;use-keypad=1;;zoom=0;;zoom_when_center=12 [interface];;dbmanager-height=350;;dbmanager-horiz-position=12;;dbmanager-vert-position=85;;dbmanager-width=780;;dont-ask=0;;filter=0;;fullscreen=0;;grampletbar-close=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;;toolbar-on=1;;toolbar-text=0;;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]\\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='' [plugin];;addonplugins=[];;hiddenplugins=[] [preferences];;age-display-precision=1;;calendar-format-report=0;;cprefix='C%04d';;date-format=0;;default-source=0;;eprefix='E%04d';;family-relation-type=3;;family-warn=1;;fprefix='F%04d';;hide-ep-msg=0;;invalid-date-format='<b>%s</b>';;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='' [utf8];;available-fonts=[];;death-symbol=13;;in-use=0;;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/gramps51/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 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 5.1 :
~/.gramps/gramps51/gramps.ini
See also:
* [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Advanced_settingsBackup_dialog]]* [[Gramps_5.1_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:Themes]]* [[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 5.1 Wiki Manual - Tools|Gramps 5.1 Wiki Manual - Filters|5.1}}
