Addon:DenominoViso
|
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager. Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker. |
The DenominoViso 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.
- Features
- Flat access to the data. The DenominoViso 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 example the confidence level of the source of an event can be indicated by a color; to the best of my knowledge their is no other report that can display this information.
Contents
Usage
The DenominoViso report is available from the menu Reports > Web Pages > DenominoViso...
Options
You can change how the report is created by changing options in the following five tabs.
DenominoViso Options tab
- Destination:
~\user\document\outputlocation\DenominoViso.htmlThe destination file for the html-content.- Folder - Select output folder location.
- Central Person: defaults to the active person
- Select Central Person button - to select a different person.
- Title of the webpage empty by default - Any string you wish
- Display mode: - Either plot ancestors or descendants graph
- Ancestor(default)
- Descendant
- Display type: - The type of graph to create.
- Regular (default)
- Fan
- Growth Spiral
- Mandelbrot Tree
- Pythagoras Tree
- Direction of time: - Direction in which times increases.
- right to left (default)
- left to right
- top to bottom
- bottom to top
- Generations
10(default) - The number of generations to include in the tree - Max chart width (%):
50(default) - Width of tree as fraction of the browser window - Max chart height (px):
1000(default) - Height of the tree in pixels. - Closing remarks:
Copyright...(default) - List of strings, free text added at the bottom, for example for a copyright notice.
Include Options tab
- [x] Include private records
- Include Events: [x] - Whether to include a person's events
- [x] Include birth children
- [ ] Include death relatives
- [ ] Include witness note
- Include Attributes: [x] restricted to:
.........(text box empty) - Whether to include a person's attributes- [ ] Include Addresses
- [ ] Include Note
- [ ] Include URL
- [ ] Include URL description
- [ ] Include Sources
Image Options tab
- [ ] Include Photos/Images from Gallery
- Copy Image: [ ] * to directory:
file/path/to/media- Copy the images to the designated image directory button
- Copy Image: [ ] * to directory:
- Images with Attribute:
____equal to___should be Included (default) or Excluded- [ ] Include Image source references
- Source reference attribute:
Style Options tab
- Color of active person:: Yellow
- Color of found persons:: Red
- Color of male persons:: Blue
- Color of female persons:: Black
- Width of rectangle (hrd):: 0.66
- Height of rectangle (hrd):: 0.16
- Vertical distance of rectangles (hrd):: 0.19
- Extra style settings::
span.witnesses {font-size: smaller;}
span-bron {font-size: smaller;}
Advanced Options tab
- Mouse event handler: [x] onclick [ ] onmouseover
- Birth relationship linestyle:
- Source confidence color:
- Very Low - #0000 (Black)
- Low - #0000 (Black)
- Normal - #0000 (Black)
- High - #0000 (Black)
- Very High - #0000 (Black)
- No Source - #0000 (Black)
- Event format:
<date>
<role> at
<type>:
<description>
in <place> - Source format:
<title>
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
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 enter the specific part of the name in the search field and search for "Name".
How the developer uses it
Some examples of how I (Michiel D. Nauta) use web 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 to 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 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 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.
Issues
- Help URL does not lead here. Goes to https://gramps-project.org/wiki/index.php?title=Gramps_6.0_Wiki_Manual_-_Reports#DenominoViso
- 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.
- 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
- Descendant Space Tree addon - more modern version of this report.
