Changes

This glossary gives an overview of terms that appear in [https://gramps-project.org/blog/features/ Gramps], 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]].) 

;<span id="addon">addon</span>: (aka [https://wikipedia.org/wiki/Plug-in_(computing) addonadd-on]) :an optional [[{{man version}}_Addons#Addon_List|'''third-party''' expansion]] to Gramps that leverages Gramps [[#plugin|plugin]] customization framework to add a specific feature. Addons may not conform to design or code quality standards. Use at your own risk!

;<span id="custom">''custom'' Types</span>: This indicates a user -defined typeclassification, as opposed to types 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. 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. <br />Any added ''custom'' Type will remain available in that expanded menu... unless the Tree is exported & re-imported or removed via a [[Third-party_Addons|3rd party addon]] Utility like [[Addon:Types_Cleanup_Tool|Type Cleanup]].<br /><small>'''''custom'' Types''' can be defined for: Event Attributes, Family Attributes, media Attributes, Person Attributes, [[#event_role|Event Roles]], [[Custom_Event_Types|Event types]], Family Relation types, Child Reference Types, Name Origin Types, Names Types, Note Types, Place Types, Repository Types, Source Attributes, source Media Types, URL Types.</small>

#[[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.<br />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.<br />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, ...)

:: '''[[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>

:A [[Gramps_{{Version manual}}_Wiki_Manual_-_Filters|filter]] in a database finds (or hides by 'filtering out') records, displaying only those records that match certain criteria. (The criteria are comparison 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. <br />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. <br />The 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. <br />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.<br />In addition to the [[Gramps_{{man version}}_Wiki_Manual_-_Filters/he#Which_filter_rules_in_which_Category.3F|built-in rules]] for filtering, [[Rule_expansions|addon rules]] are available for Custom Filters.

: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_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Multiple_Surnames|Multiple surnames]] and [[Gramps_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Names|Alternative names]] can be added from the Edit Person dialog.<br />''Available as a standard attribute of [[Names_in_Gramps|Names in Gramps]].''

;<span id="object editor">Object Editor</span> <small>''(aka Edit Object dialogs)''</small>: (''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: <span id="edit person"><span id="person editor">{{icon|peop}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_people|Edit Person]]}}</span></span>, <span id="edit family"><span id="family editor">{{icon|fami}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_relationships|Edit Family]]}}</span></span>, <span id="edit event"><span id="event editor">{{icon|even}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Edit Event]]}}</span></span>, <span id="edit place"><span id="place editor">{{icon|plac}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_places|Edit Place]]}}</span></span>, <span id="edit source"><span id="source editor">{{icon|sour34}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|Edit Source]]}}</span></span>, <span id="edit citation"><span id="citation editor">{{icon|cite}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_source_citations|Edit Citation]]}}</span></span>, <span id="edit repository"><span id="repository editor">{{icon|repo}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_repositories|Edit Repository]]}}</span></span>, <span id="edit media"><span id="media editor">{{icon|medi}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_media_objects|Edit Media]]}}</span></span>, <span id="edit note"><span id="note editor">{{icon|note}}&nbsp;{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_notes|Edit Note]]}}</span></span> ;<span id="officiator">Officiator</span>: (''[[#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. <small><i>Use 'OFFICIATOR' rather than 'Officiant' for [[#gedcom|GEDCOMGEDCOM7]] Roles compatibility.</i></small>

;[[File:Gramps-person.png|right]]<span id="person">Person</span>: ({{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 [[Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_brief#Edit_an_existing_person|Edit Person]] dialog.

:1) * a type of [[Writing_a_plugin|expansion framework that allows Gramps customization]] by providing interface hooks to recognize and use external code. :2) * 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: [[Database_Backends|Database]], 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]], [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_1|Report]], [[Gramps_{{man version}}_Addons_Wiki_Manual_-_Filters#Addon_ListAdd_Rule_dialog|Rule]], [[Gramps_{{man version}}_Wiki_Manual_-_Tools|plugin code modulesTool]] .:Plugins can be enabled built-in (''included with the normal distribution of Gramps'') or disabled an [[{{man version}}_Addons#Addon_List|add-on]] (''installed via a the [[Gramps_{{man version}}_Wiki_Manual_-_Plugin_Manager_Settings#Third_party_addons_management|plugin managerThird party addons management]]in Preferences'').

;<span id="primary_objectpreferences">primary objectPreferences</span>: Primary objects 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|[[Using_database_APIGramps_{{man version}}_Wiki_Manual_-_Settings#General|data structuresGeneral]] at the top level of a }}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Display|Display]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Text|Text]]}}, {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}, {{man label|[[Gramps_Data_ModelGramps_{{man version}}_Wiki_Manual_-_Settings#Dates|hierarchical collection of recordsDates]]. Beside the main structure of data}}, they can contain a hierarchy of {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#secondary_objectResearcher|secondary objectsResearcher]]}}, and can be referenced by other primary or secondary objects. In the Gramps database{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Warnings|Warnings]]}}, 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 {{man label|[[Using_database_APIGramps_{{man version}}_Wiki_Manual_-_Settings#Primary_ObjectsColors|Using database APIColors]]}}, Primary Objects{{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}. A ({{man label|[[Addon:Themes|Themes]] }} tab is available as an addon.)<br/>(see also ''[[#secondary_object{{Man menu|secondary object]]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...}}&nbsp;toolbar icon.)