[[File:HistoricalContext-gramplet-detached-example-5260.png|thumb|right|450px|Example of the detached/undocked "Historical Events Context Gramplet" default output showing unshaded rows for Historical Context during the lifetime of Blanco, Daniel (1752-1805) from the exampleExample.gramps family tree.]]<!-- I1684 -->The {{man label|Historical Context gramplet}} is based on the basic concept is that the events in world history during a Person's lifetime provide context to the other events of their life. So the default lists list of world events might include pandemics, wars and other socio-political pressures. You can edit the lists or add your own. So you might make a list of genealogical record stores that are valuable to be checked for specific eras.

Available to be added on the Dashboard, People and Relationship category views, this Gramplet displays historical events that occurred within the lifespan of the active personActive Person.

It references [[Addon:Historical_Context#Event_Lists|Historical Context event lists]] , which have the start year, end year, the Event descriptions event description and a URL with info about that Eventevent.

A doubleThe default list output shows unshaded rows for historical context during the lifetime of the Active Person. Double-click on clicking a row will open the link in your preferred Internet browser at the provided Link.

[[File:HistoricalContext-gramplet-options-523tab-defaults-60.png|thumb|right|450px|Configuration options dialog for version 0.2.26]]

 * {{man label|Rows starting with this in the text column will be hidden:}} <code>Filter out</code> string - excludes Events where the "Text" column starts with a particular exact string

* {{checkbox|0}} {{man label|Use filter :}} - ''Use filter'' (deselected by default''),enables the filter if selected .* Hide {{man label|Show outside life span:}} {{checkbox|1}} ''Show outside life span - ''(selected by default''), show only those in the life span lifespan of the Active Person. * Files - * {{man label|Foreground color items in lifespan :}} - (black, default) text color * {{man label|Background color items in lifespan :}} - (white, default) shading: #ffffef pale yellow in screen capture* {{man label|Foreground color items outside lifespan :}} - (black, default) text color: #a00000 dark red in screen capture* {{man label|Background color items outside lifespan :}} - (light grey, default) shading* {{man label|Select from files}} - Shows the available [[Addon:Historical_Context#Event_Lists|Event Lists]] Select the {{man button|Save}} button to apply the changes. 

* [https://github.com/gramps-project/addons-source/blob/maintenance/gramps52gramps60/default_data_v1_0.txt <code>default_data_v1_0.txt</code>] - combined list of historic events* [https://github.com/gramps-project/addons-source/blob/maintenance/gramps52gramps60/pandemi_v1_0.txt <code>pandemi_v1_0.txt</code>] - list of Pandemic Events (after 1500 CE)* [https://github.com/gramps-project/addons-source/blob/maintenance/gramps52gramps60/da_DK_data_v1_0.txt <code>da_DK_data_v1_0.txt</code>] - list of Dansk historical events* [https://github.com/gramps-project/addons-source/blob/maintenance/gramps52gramps60/en_US_data_v1_0.txt <code>en_US_data_v1_0.txt</code>] - list of USA Presidential terms * [https://github.com/gramps-project/addons-source/blob/maintenance/gramps52gramps60/HistContext/en_US_involuntary_v1_0.txt <code>uk_UA_data_v1_0.txt</code>] - list of Ukrainian historical events* [https://github.com/gramps-project/addons-source/blob/maintenance/gramps52gramps60/HistContext/en_US_involuntary_v1_0.txt <code>en_US_involuntary_v1_0.txt</code>] - involuntary commitment policies in the USA* [https://github.com/gramps-project/addons-source/blob/maintenance/gramps52gramps60/HistContext/en_US_prejudice_v1_0.txt <code>en_US_prejudice_v1_0.txt</code>] - socio-political prejudice trends in the USA

For Events that only last one year, enter the same year for both start and end date. For ongoing Events, use <code>Today</code> for the end year. If either of the dates are missing, the gramplet assumes a life span lifespan of the Preferences limit for "Maximum age probably alive".

The customizations for this Gramplet are stored in 3 locations: a common <code>HistContext.ini</code> the the gramplet's folder, distributed splitbar <code>.ini</code> files for each view mode (e.g., <code>People_personlistview_sidebar.ini</code> in the <code>gramps/gramps{{Stable_branch}}</code> folder) and the <code>gramps.ini</code> file in the [[Gramps_Glossary#user_directory|Gramps User Directory]].

Click on any color swatch in the Colors tab of the {{man menu|Edit -> Preferences}} to show the palette '''Pick a Color selector''' dialog. Then click the {{man button|+ }} button in the Custom colors at the bottom to show the color picker. Copy the value to the ''Historical Context options''. Cancel the gradient Pick a Color dialogs.[[File:PickAColor-selector-dialog-52.png|left|thumb|450px|"Pick a Color" - palette selector dialog]][[File:PickAColor-gradient-dialog-52.png|center|thumb|450px|"Pick a Color" - gradient selector dialog]]