Difference between revisions of "Addon:Historical Context"

From Gramps
m (Configuration options)
m (Historical Context gramplet)
Line 18: Line 18:
 
{{-}}
 
{{-}}
  
[[File:HistoricalContext-gramplet-options-52.png|thumb|right|450px|Configuration options dialog)]]
+
[[File:HistoricalContext-gramplet-options-52.png|thumb|right|350px|Configuration options dialog)]]
 
== Configuration options ==
 
== Configuration options ==
  
Line 34: Line 34:
 
* Background color items outside lifespan - (#ededed default, light grey) shading
 
* Background color items outside lifespan - (#ededed default, light grey) shading
 
{{-}}
 
{{-}}
[[File:PickAColor-selector-dialog-52.png|right|thumb|250px|"Pick a Color" - palette selector dialog]]
+
=== alternative Color Picker ===
[[File:PickAColor-gradient-dialog-52.png|right|thumb|218px|"Pick a Color" - gradient selector dialog]]
+
Click on any color swatch in the Colors tab of the Edit -> Preferences to show the palette Pick a Color dialog. Then click the + 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.
Click on any color swatch in the Colors tab of the Edit -> Preferences to show the Pick a Color dialog. Then click the + button in the Custom colors at the bottom to show the color picker. Copy the value to the Historical Context options. Cancel the Pick a Color dialog.
+
[[File:PickAColor-selector-dialog-52.png|left|thumb|250px|"Pick a Color" - palette selector dialog]]
 +
[[File:PickAColor-gradient-dialog-52.png|center|thumb|218px|"Pick a Color" - gradient selector dialog]]
 +
=== Custom ===
 +
If you have created a custom Event file (named <code>custom_v1_0.txt</code>) then those Events will be merged into the list.
 
{{-}}
 
{{-}}
  
Line 48: Line 51:
 
** [https://gramps.discourse.group/t/add-option-for-boolean-options-in-gramplet/6371 add option for boolean options in gramplet]
 
** [https://gramps.discourse.group/t/add-option-for-boolean-options-in-gramplet/6371 add option for boolean options in gramplet]
 
** [https://gramps.discourse.group/t/translating-addons/6106 translating addons]
 
** [https://gramps.discourse.group/t/translating-addons/6106 translating addons]
 
==== WikiContributor Help ====
 
* [[:Category:WikiContributors|WikiContributors category]]
 
 
<hr />
 
 
Edit [[Template:Addons{{man version}}]]
 
 
{| class="wikitable sortable"
 
|-
 
! Plugin / Documentation
 
! Type
 
! Image
 
! Description
 
! Use
 
! Rating (out of 4)
 
! Contact
 
! Download
 
|-
 
|<!-- Plugin / Documentation -->[[Addon:Historical Context|Historical Context]]
 
|<!-- Type -->Gramplet
 
|<!-- Image -->[[File:HistoricalContext-gramplet-example-52.png|right|150px]]
 
|<!-- Description -->Lists relevant historical events during the lifetime of a Person
 
|<!-- Use -->All
 
|<!-- Rating (out of 4) -->
 
|<!-- Contact -->[https://gramps-project.org/bugs/my_view_page.php Gramps Bugtracker]<br />Kaj Mikkelsen
 
|<!-- Download -->[https://github.com/gramps-project/addons/blob/master/gramps52/download/HistContext.addon.tgz?raw=true HistContext.addon.tgz]
 
|-
 
|}
 
  
 
[[Category:Addons]]
 
[[Category:Addons]]
 
[[Category:Plugins]]
 
[[Category:Plugins]]

Revision as of 03:47, 12 November 2024


Gramps-notes.png
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager.

Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker.
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.

Gnome-important.png
🚧 Work In Progress

This wikipage is an outline from a template being roughed in. Please don't edit just yet. Instead, contribute suggestions on the Discussion page.

This page is not planned be linked to a public page until about 17 July 2026.

If this notice remains after that date, please feel welcome to remove this notice and consider the content 'fair game' for unlimited editing.

Historical Events for Person from the example.tree

Historical Context gramplet

This gramplet is in development. The documentation is currently in the GitHub (online code development management system) repository of Kaj Mikkelsen. Review the README.md in the HistContext repository.

Available in the Dashboard, People and Relationship category views, this Gramplet displays historical events that occurred within the lifespan of the active person. It references lists which have the start year, end year, the Event descriptions and a URL about that Event.

A double-click on a row will open your preferred browser at the provided Link.

Configuration options dialog)

Configuration options

The View -> Configure... offers a variety of filtering options for the lists of Events.

  • Filter string - excludes Events where the "Text" column starts with a particular exact string
If the string is set to "Cen", then all lines where the text starts with "Cen" will be filtered out. (i.e., "Census" as well as "Century")
  • Use filter - deselected by default,enables the filter if selected
  • Hide outside life span - selected by default, show only those in the life span of the Active Person.
  • Files -
  • Foreground color items in lifespan - (#000000 default, black) text color
  • Background color items in lifespan - (#ffffff default, white) shading
#ffffef pale yellow in screen capture
  • Foreground color items outside lifespan - (#000000 default, black) text color
#a00000 dark red in screen capture
  • Background color items outside lifespan - (#ededed default, light grey) shading


alternative Color Picker

Click on any color swatch in the Colors tab of the Edit -> Preferences to show the palette Pick a Color dialog. Then click the + 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.

"Pick a Color" - palette selector dialog
"Pick a Color" - gradient selector dialog

Custom

If you have created a custom Event file (named custom_v1_0.txt) then those Events will be merged into the list.

See Also