Open main menu

Gramps β

Changes

Addon:DescendantSpaceTree

130 bytes added, 01:40, 20 June 2025
Issues
===== Report Options =====
[[File:DescendantSpaceTree-ReportOptions-60-110.png|thumb|right|450px|DescendantSpaceTree - Web Pages - Addon - "DescendantSpaceTree Options" defaults]]
On the {{man label|Report Options}} tab:
* {{man label|Center Person:}} defaults to the active person.
** ''Matriarchal Line'' - choose the branch that contains the common ancestor who is female to expand.
* {{man label|Maximum display birth year:}} <code>1900</code> (default) - Limits the display of dates for persons born after this year.
* {{man label|Theme preference:}} Generate the web page Space Tree graph canvas with a specific theme:
** '''Dark theme''' (default) - use dark background for graph canvas.
** ''Light theme'' - use a light background for graph canvas.
* {{man label|Destination:}} defaults to the user home directory. The destination directory for the generated HTML file.
** {{man button|The destination path for generated files}} button
* {{man label|Destination File:}} <code>DescendantSpaceTree.html</code> (default) The destination HTML file name.
* {{checkbox|1}}{{man label|Open with default viewer}} - Opens the generated web page with user's default web browser.
{{-}}
=== Web page usage ===
[[File:DescendantSpaceTree-WebPage-Addon-control-closeup-search-example-60.png|thumb|right|450px|Descendant Space Tree Web Page example output - showing search and both the reset and help buttons ]]
[[File:DescendantSpaceTreeDescendantSpaceTree_Browser_Help-WebPage-Addon-help-page60-example-60110.png|thumb|right|450px|DescendantSpaceTree Web Page Help popup]]
The generated HTML file <code>DescendantSpaceTree.html</code> can be published to a web server, or simply opened locally with a web browser or file explorer (Edge, Chrome, Safari, Firefox, Opera, etc.)
 
If you resize your browser window, be sure to reload the web page to ensure that the entire canvas space can be utilized by the space tree graph. Most web browsers have a reload button, or use the keyboard shortcut key Ctrl-R or F5.
The keyboard shortcut to reload the web page may be different depending on the browser you use.
The person chosen as the {{man label|Center Person:}} option will be displayed in yellow, and immediate descendants are expanded. Basic information about the selected person is shown on the left.
Selecting the {{man button|&#10227; Reset}} button displays the graph focused back on the original starting person and graph position.
 
The descendant graph is reset to the starting person whenever the browser window is resized. Resizing or toggling full screen {{man button|F5}} before navigating the descendant tree to is recommended.
The {{man button|&#65311; Help}} button will display usage for the viewer. Click either the {{man button|X - Close}} button or press the {{man button|Escape}} key to close the help window.
* Help button goes to http://gramps-project.org/wiki/index.php?title=Gramps_6.0_Wiki_Manual_-_Reports#Descendant_Space_Tree
* Feature request: Allow selection of canvas background color, perhaps other colors.
* Feature request: Include option to open generated web page with default browser.
* Feature request: Backport to Gramps 5.2
* Feature request: Books mode compatibility
15,091
edits