4
edits
Changes
m
{{Third-party plugin}}Some additional documentation is currently in the GitHub (online code development management system) repository of addon developer Kaj Mikkelsen. Review the [https://github.com/kajmikkelsen/HistContext/blob/master/README.md README.md] in the [https://github.com/kajmikkelsen/HistContext HistContext] repository.
{{man warn|1=🚧 Work In Progress|2=This wikipage is an outline from a template being roughed in. Please don't edit '''''just yet'''''. Instead, contribute suggestions Usage==Available to be added on the Discussion page. <br /><br />This page is not planned be linked to a public page until about {{safesubst<noinclude/>:CURRENTDAY}} {{safesubst<noinclude/>:CURRENTMONTHNAMEGEN}} {{safesubst<noinclude/>:CURRENTYEAR}}. <br /><br />If Dashboard, People and Relationship category views, this notice remains after Gramplet displays historical events that date, please feel welcome to remove this notice and consider occurred within the lifespan of the content 'fair game' for unlimited editingActive Person.}}
=Historical Context gramplet=The default list output shows unshaded rows for historical context during the lifetime of the Active Person.
This gramplet is === File locations ===The ''Event Lists'' can be saved in development. the following location:* file path: gramps\gramps60\plugins\HistContext==== Event Lists ====The documentation is currently in Historical Context event lists are CSV lists of dated Historical Events (with the semicolon as the delimiter) that are loaded and compared against the GitHub lifespan (online birth year through death year) of the Active Person. These seven files come with the addon and can be changed with any editor that saves in plain text:* [https://github.com/gramps-project/addons-source/blob/maintenance/gramps60/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/gramps60/pandemi_v1_0.txt <code development management system>pandemi_v1_0.txt</code>] - list of Pandemic Events (after 1500 CE) repository * [https://github.com/gramps-project/addons-source/blob/maintenance/gramps60/da_DK_data_v1_0.txt <code>da_DK_data_v1_0.txt</code>] - list of Kaj MikkelsenDansk historical events* [https://github. Review the com/gramps-project/addons-source/blob/maintenance/gramps60/en_US_data_v1_0.txt <code>en_US_data_v1_0.txt</code>] - list of USA Presidential terms * [https://github.com/kajmikkelsengramps-project/addons-source/blob/maintenance/gramps60/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/mastermaintenance/READMEgramps60/HistContext/en_US_involuntary_v1_0.md READMEtxt <code>en_US_involuntary_v1_0.mdtxt</code>] - involuntary commitment policies in the USA* [https://github.com/kajmikkelsengramps-project/addons-source/blob/maintenance/gramps60/HistContext HistContext/en_US_prejudice_v1_0.txt <code>en_US_prejudice_v1_0.txt</code>] repository- socio-political prejudice trends in the USA* If you have created a custom Event file (named <code>custom_v1_0.txt</code>) it will be shown.
Available in the Dashboard, People ===== CSV format =====You can create a custom Event file (named <code>custom_v1_0.txt</code>) and Relationship category views, this Gramplet displays historical events that occurred within the lifespan of those Events will be merged into the active personlist. It references lists which have {{man menu|After creating the start year, end yearcustom Event file, adding it as a Media object means the file will be included in backups with media. And if the Event descriptions and default viewer for .txt files is a text editor instead of a URL about that Eventsimple view, then you can use Gramps to add or remove Events from its historical event list.}}
A doubleThe format is one Event per line, each line. Short lines or those with too few (less than 3) delimiters will be skipped: <code>start date;end date;description;URL hotlink</code> 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 lifespan of the Preferences limit for "Maximum age probably alive". When entering a URL from services like Wikipedia, remove the subdomain language (i.e., <code>en.</code> for English) or platform (e.g., <code>m.</code> for mobile indicator subdomain). This allows Wikipedia to adapt to the target machine. ==== configuration options ====The customizations for this Gramplet are stored in 3 locations: a common <code>HistContext.ini</code> 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]]. The undocked size options are saved independently in the <code>.ini</code> files for the splitbars in each view mode. The <code>gramps.ini</code> file merely has the window position for the undocked dashboard gramplet. <pre>[HistContext]name=HistContextheight=20expand=Truedetached_width=602detached_height=496state=maximizedhelp_url=Addon:Historical_Contextnavtypes=['Person', 'Dashboard']page=3</pre> Configuration options are saved in the HistContext.ini found in the addon's subdirectory in the gramps/gramps{{Stable_branch}}/HistContext.ini file. Once the {{man menu|View -click on a row > Configuration}} is uses and saved, there will open your preferred browser at be <code>HistContext.ini</code> in the addon folder with the provided Linkoptions: <pre>[myopt];;bg_sel_col='#ffffff';;bg_usel_col='#ededed';;fg_sel_col='#000000';;fg_usel_col='#000000';;files='custom_v1_0.txt';;filter_text='String in beginning of text';;hide_outside_span=1;;use_filter=0</pre>
[[File:HistoricalContext=== Alternative Color Picker ===Click on any color swatch in the Colors tab of the {{man menu|Edit -gramplet-options-52> Preferences}} to show the palette '''Pick a Color selector''' dialog.pngThen click the {{man button|thumb|right|450px|Configuration +}} button in the Custom colors at the bottom to show the color picker. Copy the value to the ''Historical Context options dialog)]]== Configuration options ==''. Cancel the gradient Pick a Color dialogs.
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 stringSee also: 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[[Gramps_{{-man version}}[[File:PickAColor_Wiki_Manual_-selector-dialog-52.png|right|thumb_Settings#Pick_a_Color_selector|250px|"Pick a Color" - palette selector dialog]][[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 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.
==== WikiContributor Help ====* [[Addon:House_Timeline_Gramplet|House Timeline]] - addon person gramplet* [[Addon:Category:WikiContributorsHistorical_Context|WikiContributors categoryHistorical Context]]- addon person gramplet <hr /> Edit * [[Template:AddonsGramps_{{man version}}_Wiki_Manual_-_Reports_-_part_4#Timeline_Chart|Timeline Chart]]builtin Report {| class="wikitable sortable"* [[Addon:Timeline_Pedigree_Report|Timeline Pedigree Report]] -addon Web pages Report! Plugin / Documentation! Type! Image! Description! Use! Rating (out of 4)! Contact! Download* [[Addon:TimelinePedigreeView|Timeline Pedigree]] -addon Charts view mode|<!-- Plugin / Documentation -->* [[Addon:Historical ContextTimeLinesMap|Historical ContextTimelines Map]]|<!-- Type -->Grampletaddon Geography view mode|<!-- Image -->* [[FileAddon:HistoricalContext-gramplet-example-52.png|rightTimeline_Quickview|150pxTimeline]]|<!-- Description -->Lists relevant historical events during the lifetime of a Personaddon Quick view for Persons|<!-- Use -->All|<!-- Rating (out of 4) -->|<!-- Contact -->* [[httpsAddon://gramps-project.org/bugs/my_view_page.php Gramps BugtrackerCombinedView#Timeline_tab|Timeline tab]]<br />Kaj Mikkelsen|<!-- Download -->[https://github.com/gramps-project/addons/blob/master/gramps52/download/HistContext.of the Combined view mode addon.tgz?raw=true HistContext.addon.tgz]|-|}in Relationships category
minor grammar corrections
{{languages|Addon:Historical_Context}}
{{Third-party addon}}
[[File:HistoricalContext-gramplet-detached-example-60.png|thumb|right|450px|Example of the detached/undocked "Historical Context Gramplet" default output showing unshaded rows for Historical Context during the lifetime of Blanco, Daniel (1752-1805) from the Example.gramps family tree.]]<!-- I1684 -->
The {{man label|Historical Context gramplet}} is based on the basic concept that the events in world history during a Person's lifetime provide context to the other events of their life. So the default 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.
It references [[FileAddon:HistoricalContext-gramplet-example-52.png|thumb|right|450pxHistorical_Context#Event_Lists|Historical Events for Person from Context event lists]], which have the examplestart year, end year, event description and URL with info about that event.tree]]
Double-clicking a row will open the link in your preferred Internet browser.
{{-}}
=== Configuration options ===
[[File:HistoricalContext-gramplet-options-tab-defaults-60.png|thumb|right|450px|Configuration options dialog]]
The {{man menu|View -> Configure...}} offers a variety of filtering options for the lists of Events.
* {{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
: 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")
* {{checkbox|0}} {{man label|Use filter:}} - ''Use filter'' (deselected by default),enables the filter if selected.
* {{man label|Show outside life span:}} {{checkbox|1}} ''Show outside life span'' (selected by default), show only those in the lifespan of the Active Person.
* {{man label|Foreground color items in lifespan:}} - (black, default) text color
* {{man label|Background color items in lifespan:}} - (white, default) shading
* {{man label|Foreground color items outside lifespan:}} - (black, default) text color
* {{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://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]
** Discourse tag: [https://gramps.discourse.group/tag/timeline timeline]
* MantisBT
** Feature Requests {{bug|13498}}: To be implemented in Historical Context gramplet
[[Category:Addons]]
[[Category:Plugins]]