User:Ztlxltl - Revision history

Gioto: add back z

2025-02-03T23:30:17Z

add back z

Ztlxltl at 17:36, 3 February 2025

2025-02-03T17:36:35Z

Ztlxltl: Remove unwanted content

2025-02-03T16:51:20Z

Remove unwanted content

Bamaustin: FTV draft converted from GitHub markdown to MediaWiki markdown

2025-02-02T23:43:50Z

FTV draft converted from GitHub markdown to MediaWiki markdown

Bamaustin at 22:17, 2 February 2025

2025-02-02T22:17:54Z

Bamaustin: placeholder

2025-02-02T22:14:05Z

placeholder

New page

draft new FTV here

[[User:Bamaustin|Bamaustin]] ([[User talk:Bamaustin|talk]]) 22:14, 2 February 2025 (UTC)

← Older revision		Revision as of 23:30, 3 February 2025
Line 5:		Line 5:

	While the developer is working on a draft of the article about the FamilyTreeView addon, you can find it on [[User:Ztlxltl/FamilyTreeView\|this subpage]].		While the developer is working on a draft of the article about the FamilyTreeView addon, you can find it on [[User:Ztlxltl/FamilyTreeView\|this subpage]].
		+
		+	[[Category:User\|z]]

← Older revision	Revision as of 17:36, 3 February 2025
Line 1:	Line 1:
	+	I'm ztlxltl, mainly known for developing the ''FamilyTreeView'' addon.

	+
	+	== FamilyTreeView ==
	+
	+	While the developer is working on a draft of the article about the FamilyTreeView addon, you can find it on [[User:Ztlxltl/FamilyTreeView\|this subpage]].

← Older revision		Revision as of 16:51, 3 February 2025
Line 1:		Line 1:
−	~~draft new FTV docs here~~

−	~~https://github.com/ztlxltl/FamilyTreeView/blob/main/README.md~~
−
−	~~[[User:Bamaustin\|Bamaustin]] ([[User talk:Bamaustin\|talk]]) 22:14, 2 February 2025 (UTC)~~
−
−
−	~~= FamilyTreeView [ =~~
−	~~[[File:gramps-family-tree-view.svg\|64px\|left]]~~
−	~~FamilyTreeView is a third-party addon for Gramps. It provides a navigable tree representation of ancestors, descendants and other related persons.~~
−
−	Note that this addon is currently under development and should not be considered stable. It has not been thoroughly tested and interfaces are likely to change. '''Back up your data before using this addon.'''
−
−	~~== Features ==~~
−	* Tree visualization of relatives of the active person
−	* Info box pop-up with basic information on a person or family (not visible in screenshot below)
−	* Side panel with detailed information on a person or families including a timeline
−	* Expanders to show more (or less) ancestors or descendants of corresponding persons or families (not visible in screenshot below)
−	* Name abbreviation algorithm to fit long names into the fix-sized boxes (<code>AbbreviatedNameDisplay</code>)
−	* Badges for customizable display of interesting / important information (new / custom badges can be [docs/badge_development.md registered])
−	* Intuitive zoom centered at mouse pointer position
−	* Mini map for orientation
−
−	~~== Screenshot ==~~
−	~~https://raw.githubusercontent.com/ztlxltl/FamilyTreeView/refs/heads/main/docs/media/screenshot.png~~
−
−	~~This repository includes the following addons, which are registered individually:~~
−	* FamilyTreeView, the main addon of this repository
−	* FamilyTreeView Example Badges, registers example badges which can be activated in FamilyTreeView's configuration window
−	* FamilyTreeView Panel Gramplet, can be used to move the integrated panel into the sidebar
−	This can be useful if you don't want to hide the sidebar (View -> uncheck Sidebar) because you have other Gramplets open, but you don't want to waste too much of your window/screen width with the panel and the sidebar taking up space.
−	* Children Quick View, quick view/report listing children, used as a callback example for clicking on badges
−	* AbbreviatedNameDisplay Inspector Gramplet, lists the abbreviations of the names of the active person (audience=DEVELOPER)
−
−	~~== Installation ==~~
−	FamilyTreeView uses <code>GooCanvas</code> to draw the tree. If you are using Gramps' Graph View, this requirement is already satisfied. (In contrast to Graph View, FamilyTreeView doesn't require Graphviz.)
−	~~Note that if you have Graph View installed along with FamilyTreeView, the Graph View search bar can be reused and will appear above the FamilyTreeView visualization.~~
−
−	There are two options for adding FamilyTreeView to Gramps. The first lets Gramps know about the provided prebuilds. The second downloads the source code to the right location for Gramps to find. If you have problems with the first option, you can always use the robust alternative of downloading the source code.
−
−	~~'''Back up your data before installing.'''~~
−
−	~~=== Making Gramps aware of the pre-builds ===~~
−	~~# Open Gramps~~
−	~~# Click on the puzzle piece icon to open the Addon Manager~~
−	~~# Go to the "Projects" tab~~
−	~~# Click the plus at the bottom left~~
−	~~# Enter <code>FamilyTreeView</code> as the project name~~
−	~~# Enter the following URL: <code>https://raw.githubusercontent.com/ztlxltl/FamilyTreeView/dist/gramps52</code>~~
−	~~# Click OK, go to the "Addons" tab and select "All statuses" in the last dropdown menu (usually "Stable" is selected). This is necessary because this addon should not be considered stable.~~
−	~~# Select "FamilyTreeView" in the second dropdown menu (usually "All projects" is selected). Alternatively, you can search for FamilyTreeView.~~
−	~~# I recommended to install all three of the addons of this repository (which are explained above). Click the "Install" button of each of the addons.~~
−
−	~~If you have problems, you can always use the robust alternative of downloading the source code:~~
−
−	~~=== Downloading the source code ===~~
−	~~# Find your Gramps user directory. It's usually located here:~~
−	~~#* Linux / MacoOS (built) / other POSIX: <code>~/.gramps</code> (e.g. <code>/home/<username>/.gramps</code>)~~
−	~~#* Windows: <code>%AppData%\gramps</code> (e.g. <code>C:\Users\<username>\AppData\Roaming\gramps</code>)~~
−	~~#* MacOS Application Package: <code>/Users/<username>/Library/Application Support/gramps</code>~~
−	~~# Go to the subdirectory <code>gramps52/plugins</code>, e.g. <code>~/.gramps/gramps52/plugins</code>.~~
−	# Clone or download the repository to this subdirectory, e.g. <code>~/.gramps/gramps52/plugins/FamilyTreeView</code> or <code>C:\Users\<username>\AppData\Roaming\gramps\gramps52\plugins\FamilyTreeView</code>. To do this, click on the green "Code" button on FamilyTreeView's repository on Github and
−	~~#* copy the URL to clone it (I assume you know how to do this if you choose to clone it.)~~
−	~~#* or~~
−	#* click "Download ZIP" to download a ZIP of the source code directly. After the download finished, extract the ZIP file in the subdirectory mentioned above. You can check to make sure that this [https://github.com/ztlxltl/FamilyTreeView/blob/main/README.md README.md] is in the correct location: e.g. <code>~/.gramps/gramps52/plugins/FamilyTreeView/README.md</code> or <code>C:\Users\<username>\AppData\Roaming\gramps\gramps52\plugins\FamilyTreeView\README.md</code>
−
−	~~== ToDo's, ideas & known issues ==~~
−
−	If you have feedback or bug reports that are not listed below or tracked by a Github issue, you can create a new issue or contact me directly (e.g. via the [https://gramps.discourse.group Gramps Forum]).
−
−	* tree:
−	** move siblings closer together if positioning of their descendants allow it
−	** more expanders (expand more relatives of a specific person / family)
−	*** expand parents and siblings of spouse of the active person
−	*** expand other parents of the active person or an ancestor while the main parent's other families are expanded (but not the children of the other families of the main parents)
−	*** expand parents/ancestors of other parents
−	*** maybe more
−	* context menus (edit, add new person as parent, spouse, child etc.)
−	* implement "add relative" button functionality
−	* panel:
−	** more info (persons and families: media overview; persons: e.g. families, spouses and children)
−	** context menu and go to buttons (opt.) next to names in the panel (incl. timeline)
−	** context menu on events in timeline (e.g. edit event)
−	** badges in info box and panel (separately (de)activatable in config)
−	** ticks for negative time (e.g. birth of spouses where marriage is 0)
−	** if birth is uncertain, no range
−	** option to hide large gaps in timeline (x years removed)
−	** better ui design of panel
−	* adaptive canvas padding based on zoom and ScrolledWindow's size
−	* more customization options
−	* height of info box should adjust to content
−	* find a good way to include a search bar (e.g. SearchWidget from graph view), add zoom buttons
−	* better solution for positioning SVGs on canvas
−	* make mini map clickable to jump to a different location
−	* right-to-left direction (similar to pedigree view) as an alternative to top-to-bottom
−	* better info for marriage (and likely other events) in timeline
−	* overlapping lines from families to children appear thicker when zoomed out
−	* badge priority / not too many badges
−	* shadow on hover of person and family boxes
−	* performance test for large trees and possible improvement
−	* tests for AbbreviatedNameDisplay
−	* translation
−	* color coding
−	* alternative centering of single child
−	* generalize UI code to support different styles / themes for different visualizations of persons and families
−	* all the other ToDos in the code
−
−	Once the major open items are resolved and the most important ToDo features are implemented, this addon may be moved to Gramps' official addon repository and bugs as well as feature requests will be tracked in the Gramps bug tracker.

← Older revision		Revision as of 23:43, 2 February 2025
Line 4:		Line 4:

	[[User:Bamaustin\|Bamaustin]] ([[User talk:Bamaustin\|talk]]) 22:14, 2 February 2025 (UTC)		[[User:Bamaustin\|Bamaustin]] ([[User talk:Bamaustin\|talk]]) 22:14, 2 February 2025 (UTC)
		+
		+
		+	= FamilyTreeView [ =
		+	[[File:gramps-family-tree-view.svg\|64px\|left]]
		+	FamilyTreeView is a third-party addon for Gramps. It provides a navigable tree representation of ancestors, descendants and other related persons.
		+
		+	Note that this addon is currently under development and should not be considered stable. It has not been thoroughly tested and interfaces are likely to change. '''Back up your data before using this addon.'''
		+
		+	== Features ==
		+	* Tree visualization of relatives of the active person
		+	* Info box pop-up with basic information on a person or family (not visible in screenshot below)
		+	* Side panel with detailed information on a person or families including a timeline
		+	* Expanders to show more (or less) ancestors or descendants of corresponding persons or families (not visible in screenshot below)
		+	* Name abbreviation algorithm to fit long names into the fix-sized boxes (<code>AbbreviatedNameDisplay</code>)
		+	* Badges for customizable display of interesting / important information (new / custom badges can be [docs/badge_development.md registered])
		+	* Intuitive zoom centered at mouse pointer position
		+	* Mini map for orientation
		+
		+	== Screenshot ==
		+	https://raw.githubusercontent.com/ztlxltl/FamilyTreeView/refs/heads/main/docs/media/screenshot.png
		+
		+	This repository includes the following addons, which are registered individually:
		+	* FamilyTreeView, the main addon of this repository
		+	* FamilyTreeView Example Badges, registers example badges which can be activated in FamilyTreeView's configuration window
		+	* FamilyTreeView Panel Gramplet, can be used to move the integrated panel into the sidebar
		+	This can be useful if you don't want to hide the sidebar (View -> uncheck Sidebar) because you have other Gramplets open, but you don't want to waste too much of your window/screen width with the panel and the sidebar taking up space.
		+	* Children Quick View, quick view/report listing children, used as a callback example for clicking on badges
		+	* AbbreviatedNameDisplay Inspector Gramplet, lists the abbreviations of the names of the active person (audience=DEVELOPER)
		+
		+	== Installation ==
		+	FamilyTreeView uses <code>GooCanvas</code> to draw the tree. If you are using Gramps' Graph View, this requirement is already satisfied. (In contrast to Graph View, FamilyTreeView doesn't require Graphviz.)
		+	Note that if you have Graph View installed along with FamilyTreeView, the Graph View search bar can be reused and will appear above the FamilyTreeView visualization.
		+
		+	There are two options for adding FamilyTreeView to Gramps. The first lets Gramps know about the provided prebuilds. The second downloads the source code to the right location for Gramps to find. If you have problems with the first option, you can always use the robust alternative of downloading the source code.
		+
		+	'''Back up your data before installing.'''
		+
		+	=== Making Gramps aware of the pre-builds ===
		+	# Open Gramps
		+	# Click on the puzzle piece icon to open the Addon Manager
		+	# Go to the "Projects" tab
		+	# Click the plus at the bottom left
		+	# Enter <code>FamilyTreeView</code> as the project name
		+	# Enter the following URL: <code>https://raw.githubusercontent.com/ztlxltl/FamilyTreeView/dist/gramps52</code>
		+	# Click OK, go to the "Addons" tab and select "All statuses" in the last dropdown menu (usually "Stable" is selected). This is necessary because this addon should not be considered stable.
		+	# Select "FamilyTreeView" in the second dropdown menu (usually "All projects" is selected). Alternatively, you can search for FamilyTreeView.
		+	# I recommended to install all three of the addons of this repository (which are explained above). Click the "Install" button of each of the addons.
		+
		+	If you have problems, you can always use the robust alternative of downloading the source code:
		+
		+	=== Downloading the source code ===
		+	# Find your Gramps user directory. It's usually located here:
		+	#* Linux / MacoOS (built) / other POSIX: <code>~/.gramps</code> (e.g. <code>/home/<username>/.gramps</code>)
		+	#* Windows: <code>%AppData%\gramps</code> (e.g. <code>C:\Users\<username>\AppData\Roaming\gramps</code>)
		+	#* MacOS Application Package: <code>/Users/<username>/Library/Application Support/gramps</code>
		+	# Go to the subdirectory <code>gramps52/plugins</code>, e.g. <code>~/.gramps/gramps52/plugins</code>.
		+	# Clone or download the repository to this subdirectory, e.g. <code>~/.gramps/gramps52/plugins/FamilyTreeView</code> or <code>C:\Users\<username>\AppData\Roaming\gramps\gramps52\plugins\FamilyTreeView</code>. To do this, click on the green "Code" button on FamilyTreeView's repository on Github and
		+	#* copy the URL to clone it (I assume you know how to do this if you choose to clone it.)
		+	#* or
		+	#* click "Download ZIP" to download a ZIP of the source code directly. After the download finished, extract the ZIP file in the subdirectory mentioned above. You can check to make sure that this [https://github.com/ztlxltl/FamilyTreeView/blob/main/README.md README.md] is in the correct location: e.g. <code>~/.gramps/gramps52/plugins/FamilyTreeView/README.md</code> or <code>C:\Users\<username>\AppData\Roaming\gramps\gramps52\plugins\FamilyTreeView\README.md</code>
		+
		+	== ToDo's, ideas & known issues ==
		+
		+	If you have feedback or bug reports that are not listed below or tracked by a Github issue, you can create a new issue or contact me directly (e.g. via the [https://gramps.discourse.group Gramps Forum]).
		+
		+	* tree:
		+	** move siblings closer together if positioning of their descendants allow it
		+	** more expanders (expand more relatives of a specific person / family)
		+	*** expand parents and siblings of spouse of the active person
		+	*** expand other parents of the active person or an ancestor while the main parent's other families are expanded (but not the children of the other families of the main parents)
		+	*** expand parents/ancestors of other parents
		+	*** maybe more
		+	* context menus (edit, add new person as parent, spouse, child etc.)
		+	* implement "add relative" button functionality
		+	* panel:
		+	** more info (persons and families: media overview; persons: e.g. families, spouses and children)
		+	** context menu and go to buttons (opt.) next to names in the panel (incl. timeline)
		+	** context menu on events in timeline (e.g. edit event)
		+	** badges in info box and panel (separately (de)activatable in config)
		+	** ticks for negative time (e.g. birth of spouses where marriage is 0)
		+	** if birth is uncertain, no range
		+	** option to hide large gaps in timeline (x years removed)
		+	** better ui design of panel
		+	* adaptive canvas padding based on zoom and ScrolledWindow's size
		+	* more customization options
		+	* height of info box should adjust to content
		+	* find a good way to include a search bar (e.g. SearchWidget from graph view), add zoom buttons
		+	* better solution for positioning SVGs on canvas
		+	* make mini map clickable to jump to a different location
		+	* right-to-left direction (similar to pedigree view) as an alternative to top-to-bottom
		+	* better info for marriage (and likely other events) in timeline
		+	* overlapping lines from families to children appear thicker when zoomed out
		+	* badge priority / not too many badges
		+	* shadow on hover of person and family boxes
		+	* performance test for large trees and possible improvement
		+	* tests for AbbreviatedNameDisplay
		+	* translation
		+	* color coding
		+	* alternative centering of single child
		+	* generalize UI code to support different styles / themes for different visualizations of persons and families
		+	* all the other ToDos in the code
		+
		+	Once the major open items are resolved and the most important ToDo features are implemented, this addon may be moved to Gramps' official addon repository and bugs as well as feature requests will be tracked in the Gramps bug tracker.

← Older revision		Revision as of 22:17, 2 February 2025
Line 1:		Line 1:
−	draft new FTV here	+	draft new FTV docs here
		+
		+	https://github.com/ztlxltl/FamilyTreeView/blob/main/README.md

	[[User:Bamaustin\|Bamaustin]] ([[User talk:Bamaustin\|talk]]) 22:14, 2 February 2025 (UTC)		[[User:Bamaustin\|Bamaustin]] ([[User talk:Bamaustin\|talk]]) 22:14, 2 February 2025 (UTC)