5,864
edits
Changes
m
[[Image:DenominoVisoWebReport.png|thumb|right|400pxThe {{man label|DenominoViso Web Report]]}} addon creates an interactive graphical representation of an Ancestor or Descendant family tree on a web page in various format like Regular, Fan, Growth Spiral, Mandelbrot Tree and Pythagoras Tree.
If your tree of ancestors/descendents grows a bit bigger, traditional graphical representations run out of space and you are left with viewing only part of your tree. The {{man label|DenominoViso plugin mitigates this by dropping names and other textual details }} report is available from the boxes that make up a tree so that many more boxes, thus a larger section of the tree, can be put in viewmenu {{man menu|Reports > Web Pages > DenominoViso... }}{{-}}=== Options ===
What is seen on the webpage is typically a tree structure consisting of many boxes. Hovering the mouse over a box shows the name of that person on the statusbar (browser settings must allow javascript to set text on the statusline, something which is at present typically switched off by browsers in their standard configuration). Clicking on a box displays the known details about that person==== Include Options tab ====[[File:DenominoViso-WebPages-Addon-IncludeOptions-tab-defaults-60.png|thumb|right|450px|DenominoViso - Web Pages - Addon - "Include Options" tab defaults]]
== Additional benefits ==* {{man label|[x] Include private records}}# Flat access * {{man label|Include Events: [x]}} - Whether to the data. Gramps is very hierarchical opening window after window. This is good for data entry, but not so for data display. A page created by DenominoViso shows all information about include a person with a single click and some scrolling.'s events** {{man label|[x] Include birth children}}** {{man label|[ ] Include death relatives}}** {{man label|[ ] Include witness note}}# Easy searching. The webpage contains a text entry and a selection field which make it easy *{{man label|Include Attributes: [x]}} {{man label|restricted to search on names or other properties:}} <code>. # A single page website. Gramps can create a website, but it is too bulky for my taste. DenominoViso typically puts all textual information in one big file.# Mixing family and person events. Gramps displays family events in another window then personal event. Birth of a child though, would be considered by most people as a major event during their live. DenominoViso can mix family events with personal events and represents them in chronological order.# Finegrained control over what gets included. DenominoViso has many options that control what gets included in the webpage. Some can be included by setting a simple checkbox, others however are very advanced and should only be used by people with some experience. For example the confidence level of the source of an event can be indicated by </code> (text box empty) - Whether to include a color; to the best of my knowledge their is no other report that can display this information.person's attributes** {{man label|[ ] Include Addresses}}** {{man label|[ ] Include Note}}** {{man label|[ ] Include URL}}** {{man label|[ ] Include URL description}}** {{man label|[ ] Include Sources}}{{-}}
== How do I use it ==* [ ] {{man label|Include Photos/Images from Gallery}}Some examples of how I use a page created by DenominoViso.# I am primarily looking for information on ancestors. The large overview shown by a page created by DenominoViso, helps me ** {{man label|Copy Image:}} [ ] * {{man label|to easily find which ancestors are lagging behinddirectory: }} <code>file/path/to/media</code>*** {{man button|Copy the branch is tiny compared with neighboring branches.# Finding death records is harder then birth/baptism and marriage records in Dutch archives. So temporarily I typically set death images to something like "after xxxx". I can now enter "after" in the search box and search for "death events", all people that still miss their real death event show up.designated image directory}} button# Some sources are expected * {{man label|Images with Attribute:}} <code>____</code> equal to contain a considerable <code>___</code> should be '''Included''' (geographicdefault) group of my ancestors, for example tax records. Because in Gramps I have entered the details of that tax record in the description field of the event, I can search on this in the page created by DenominoViso. Those persons not showing up while it is expected, can easily be identified for further research.or ''Excluded''** [ ] Include Image source references* {{man label|Source reference attribute:}}
== What's in a name ==
The name DenominoViso is derived from a use-case I had not realized before I wrote this plugin. It means something like "let's have a look at namegiving". It turns out that in my family not only family names can be traced back over centuries, but also firstnames where children are typically named after their grandparents or great grandparents if there are many of them. Pages created with the DenominoViso plugin are ideal for this, just enter the specific part of the name in the search field and search for "Name".
→See also
{{Third-party pluginaddon}}[[File:DenominoViso-WebPage-Addon-ancestor-example-60.png|thumb|right|450px|DenominoViso Web Page example output - Ancestor (default)]]
;Features:* Flat access to the data. The DenominoViso plugin web page shows all information about a person with a single click and some scrolling.* Easy searching. The web page contains a text entry and a selection field which make it easy to search on names or other properties. * A single page website. DenominoViso typically puts all textual information in one big file.* Mixing family and person events. DenominoViso can mix family events with personal events and represents them in chronological order.* Fine grained control over what gets included. DenominoViso has many options that control what gets included in the webpage. Some options are very advanced for Gramps creates example the confidence level of the source of an interactive graphical representation event can be indicated by a color; to the best of a family tree on a webpagemy knowledge their is no other report that can display this information.
== Why Usage ==
You can change how the report is created by changing options in the following five tabs.* {{man label|[[Addon:DenominoViso#DenominoViso_Options_tab|DenominoViso Options]]}}* {{man label|[[Addon:DenominoViso#Include_Options_tab|Include Options]]}}* {{man label|[[Addon:DenominoViso#Image_Options_tab|Image Options]]}}* {{man label|[[Addon:DenominoViso#Style_Options_tab|Style Options]]}}* {{man label|[[Addon:DenominoViso#Advanced_Options_tab|Advanced Options]]}}{{-}}== How ==DenominoViso Options tab ====[[File:DenominoViso-WebPages-Addon-DenominoVisoOptions-tab-defaults-60.png|thumb|right|450px|DenominoViso - Web Pages - Addon - "DenominoViso Options" tab defaults]]
* {{man label|Destination:}} <code>~\user\document\outputlocation\DenominoViso.html</code> The consequence of this is that destination file for the document needs html-content.** {{man button|Folder}} - Select output folder location.* {{man label|Central Person:}} defaults to be interactive the active person** {{man button|Select Central Person}} button - to determine which box belongs to which select a different person, thus DenominoViso creates a graphical .* {{man label|Title of the webpage }} empty by default - Any string you wish* {{man label|Display mode:}} - Either plot ancestors or descendants graph** '''Ancestor'''(default)** Descendant* {{man label|Display type:}} - The type of graph to create.** '''Regular''' (default)** Fan** Growth Spiral** Mandelbrot Tree** Pythagoras Tree* {{man label|Direction of time:}} - Direction in SVG/XHTML/javascriptwhich times increases. Such a document can be displayed with standard compliant browsers such as Firefox or Opera (Internet Explorer will ** '''notright to left''' do(default)** left to right** top to bottom** bottom to top* {{man label|Generations}} <code>10</code> (default) - The number of generations to include in the tree* {{man label|Max chart width (%):}} <code>50</code> (default) - Width of tree as fraction of the browser window* {{man label|Max chart height (px):}} <code>1000</code> (default)- Height of the tree in pixels.* {{man label|Closing remarks:}} <code>Copyright...</code> (default) - List of strings, free text added at the bottom, for example for a copyright notice.{{-}}
== What is missing == Image Options tab ====# Most notable missing feature is the ability to limit data on living persons[[File:DenominoViso-WebPages-Addon-ImageOptions-tab-defaults-60. You have to make the png|thumb|right privacy setting in Gramps to exclude them from a page created by |450px|DenominoViso.# Repository information is at present not included in the page created by DenominoViso.- Web Pages - Addon - "Image Options" tab defaults]]
{{-}} ==== Style Options tab ====[[File:DenominoViso-WebPages-Addon-StyleOptions-tab-defaults-60.png|thumb|right|450px|DenominoViso - Web Pages - Addon - "Style Options" tab defaults]] * {{man label|Color of active person::}} Yellow* {{man label|Color of found persons::}} Red* {{man label|Color of male persons::}} Blue* {{man label|Color of female persons::}} Black* {{man label|Width of rectangle (hrd)::}} 0.66* {{man label|Height of rectangle (hrd)::}} 0.16* {{man label|Vertical distance of rectangles (hrd)::}} 0.19* {{man label|Extra style settings::}} <code>span.witnesses {font-size: smaller;}<br>span-bron {font-size: smaller;}</code>{{-}} ==== Advanced Options tab ====[[File:DenominoViso-WebPages-Addon-AdvancedOptions-tab-defaults-60.png|thumb|right|450px|DenominoViso - Web Pages - Addon - "Advanced Options" tab defaults]] * {{man label|Mouse event handler:}} [x] onclick [ ] onmouseover* {{man label|Birth relationship linestyle:}}* {{man label|Source confidence color:}}** Very Low - #0000 (Black)** Low - #0000 (Black)** Normal - #0000 (Black)** High - #0000 (Black)** Very High - #0000 (Black)** No Source - #0000 (Black)* {{man label|Event format:}} <code><date><br><role> at<br><type>:<br><description><br>in <place></code>* {{man label|Source format:}} <code><title></code>{{-}} == Why DenominoViso was developed == As your tree of ancestors/descendants grows a bit bigger, traditional graphical representations run out of space and you are left with viewing only part of your tree. The DenominoViso addon mitigates this by dropping names and other textual details from the boxes that make up a tree so that many more boxes, thus a larger section of the tree, can be put in view. ===How =Version History==This The consequence of this is that the document needs to be interactive to determine which box belongs to which person, thus DenominoViso creates a graphical webpage in SVG/HTML/javascript. Such a document can be displayed with standard compliant browsers such as Microsoft Edge, Firefox or Opera (Old version of Internet Explorer will '''not''' work.). What is seen on the web page is typically a tree structure consisting of many boxes. Hovering the mouse over a box shows the name of that person on the statusbar (browser settings must allow javascript to set text on the statusline, something which is at present typically switched off by browsers in their standard configuration). Clicking on a box displays the known details about that person. === What's in a name ===The name DenominoViso is derived from a use-case I had not realized before I wrote this addon. It means something like '''let's have a look at namegiving'''. It turns out that in my family not only family names can be traced back over centuries, but also firstnames where children are typically named after their grandparents or great grandparents if there are many of them. Pages created with the DenominoViso addon are ideal for this, just an update enter the specific part of the name in the search field and search for "Name". === How the developer uses it === Some examples of that how I (Michiel D. Nauta) use web a page created by DenominoViso.* I am primarily looking for Gramps 2information on ancestors.xThe large overview shown by a page created by DenominoViso, helps me to work easily find which ancestors are lagging behind: the branch is tiny compared with neighboring branches.* Finding death records is harder then birth/baptism and marriage records in Dutch archives. So temporarily I typically set death to something like "after xxxx". I can now enter "after" in the new plugin-architecture search box and search for "death events", all people that still miss their real death event show up.* Some sources are expected to contain a considerable (geographic) group of my ancestors, for example tax records. Because in Gramps 3I have entered the details of that tax record in the description field of the event, no new functionality has been addedI can search on this in the page created by DenominoViso. Those persons not showing up while it is expected, can easily be identified for further research.
==Issues==
* Does Help URL does not lead here. Goes to https://gramps-project.org/wiki/index.php?title=Gramps_6.0_Wiki_Manual_-_Reports#DenominoViso* {{bug|6486}}: Duplication in graphical reports when first cousins marry* Some of the '''Display type:''' graph options do not work correctly* Feature Request: Repository information is at present not included in the page created by DenominoViso.* [https://github.com/gramps-project/addons-source/pull/245#issuecomment-543425169 Two remaining issues reported on github](By fxtmtrsine / Date: 2019)** On the "image options" window the "copy image" setting defaults to the program installation folder instead of the media directory in preferences.** Feature: this one more of a suggestion than issue: in the "style options" can the default colors be something a bit more contrasting or brighter? ==See also==* [[Web Solutions for Gramps 4]]* [[Addon:DescendantSpaceTree|Descendant Space Tree]] addon - more modern version of this report.x
[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Reports]]