15,091
edits
Changes
→Issues
[[File:DescendantSpaceTree-WebPage-Addon-example-60.png|thumb|right|450px|DescendantSpaceTree Web Page example output]]
The {{man label|Descendant Space Tree}} addon creates an graphical space efficient display with interactive navigationon a web page, even with large families.
;Features
===== 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-helpcontrol-closeup-search-pageexample-60.png|thumb|right|450px|Descendant Space Tree Web Page exampleoutput - showing search and both the reset and help buttons ]][[File:DescendantSpaceTree_Browser_Help-60-110.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.)
Selecting the {{man button|⟳ 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|？ 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.
=== Duplicate branches from inter-family marriages ===
In the case of an inter-family marriages (i.e., such of that of a marriage of cousins), there would otherwise be two branches of descendants. DescendantSpaceTree only expands the descendants from such families in one branch, while the other branch is pruned. The choice is made by the setting of the '''''{{man label|Branch to expand when duplicated''''' :}} option. During report generation, the common ancestor of the two parents is found. The branch that contains the selected line (Patriarchal or Matriarchal) will be further expanded.
An extra button will be displayed in these cases in the bottom left of the window. When the branch is that of the selected line, the button will
==See also==
* [https://gramps.discourse.group/t/descendantspacetree-addon-initial-development/7764 DescendantSpaceTree addon - initial development] announcement 2025/05/31 - Gramps Discourse forum.
** Descendant Space Tree is based on the original paper [https://www.cs.umd.edu/projects/hcil/spacetree/ SpaceTree: a novel node-link tree browser] by the Human-Computer Interaction Lab (HCIL) at the University of Maryland, USA
* [[Addon:DenominoViso|DenominoVisio...]] (addon) - Almost identical report.
* [[Addon:D3_Ancestral_and_Descendant_Charts#Ancestral_Collapsible_Tree|Ancestral Collapsible Tree...]] (D3 addon)
* 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 Backport to open generated web page with default Gramps 5.2* Feature request: Books mode compatibility* Feature request: Automatically resize the space tree graph when browserwindow is resized.
If you have trouble displaying the report on your local computer see the following: