Difference between revisions of "Addon:DenominoViso"

From Gramps
Jump to: navigation, search
(How do I use it)
(Issues)
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
 +
[[File:DenominoViso-WebReport-Addon-example-50.png|thumb|right|450px|DenominoViso Web Report example output]]
  
[[Image:DenominoVisoWebReport.png|thumb|right|400px|DenominoViso Web Report]]
+
The DenominoViso Addon for Gramps creates an interactive graphical representation of a family tree on a webpage.
  
The DenominoViso plugin for Gramps creates an interactive graphical representation of a family tree on a webpage.
+
== Usage ==
 +
 
 +
The report is available from the menu {{man menu|Reports > Web Pages > DenominoViso}}
 +
{{-}}
 +
=== Options ===
 +
[[File:DenominoViso-WebReport-Addon-DenominoVisoOptions-tab-defaults-50.png|thumb|right|450px|DenominoViso - Web Report - Addon - "DenominoViso Options" tab defaults]]
 +
 
 +
{{stub}}
 +
{{-}}
 +
 
 +
== How the developer uses it ==
 +
 
 +
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 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.
  
 
== Why ==
 
== Why ==
  
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 DenominoViso plugin 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.  
+
If 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 plugin 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 ==
 
== How ==
Line 15: Line 31:
 
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.
 
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.
  
== Additional benefits ==
+
== Features ==
 
# Flat access 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 a person with a single click and some scrolling.
 
# Flat access 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 a person with a single click and some scrolling.
 
# Easy searching. The webpage contains a text entry and a selection field which make it easy to search on names or other properties.  
 
# Easy searching. The webpage contains a text entry and a selection field which make it easy to search on names or other properties.  
 
# 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.
 
# 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.
 
# 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 a color; to the best of my knowledge their is no other report that can display this information.
+
# Fine grained 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 a color; to the best of my knowledge their is no other report that can display this information.
 
 
== What is missing ==
 
# Most notable missing feature is the ability to limit data on living persons. You have to make the right privacy setting in Gramps to exclude them from a page created by DenominoViso.
 
# Repository information is at present not included in the page created by DenominoViso.
 
 
 
== How do I use it ==
 
 
 
The report is available from the menu {{man menu|Reports > Web Pages > DenominoViso}}
 
 
 
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 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.
 
  
 
== What's in a name ==
 
== What's in a name ==
Line 39: Line 42:
  
 
==Version History==
 
==Version History==
This version is just an update of that for Gramps 2.x, to work with the new plugin-architecture of Gramps 3, no new functionality has been added.
+
* Gramps 4 - Update of Gramps 3 version, to support GTK+3 and python 3. No new functionality was added.
 +
* Gramps 3 - An update of the Gramps 2.x version, to work with the new plugin-architecture. No new functionality was added.
  
 
==Issues==
 
==Issues==
* {{bug|6679}} - Does not work on Gramps 4.x
 
** Does not work with python 2 or python 3
 
* {{bug|7095}} - Denomino Viso ( Failure writing D\Uploads [Error 13] Permission denied u:'D\uploads' ) (Gramps 3.4.4)
 
* {{bug|4480}} - DenominoViso vertical time direction produces illegible display (Feature Request)
 
 
* Help URL does not lead here.
 
* Help URL does not lead here.
 +
* {{bug|6486}}: Duplication in graphical reports when first cousins marry
 +
* Repository information is at present not included in the page created by DenominoViso.
  
  

Revision as of 00:30, 21 April 2018

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.

DenominoViso Web Report example output

The DenominoViso Addon for Gramps creates an interactive graphical representation of a family tree on a webpage.

Usage

The report is available from the menu Reports > Web Pages > DenominoViso

Options

DenominoViso - Web Report - Addon - "DenominoViso Options" tab defaults
Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.



How the developer uses it

Some examples of how I use a page created by DenominoViso.

  1. 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.
  2. 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.
  3. 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.

Why

If 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 plugin 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/XHTML/javascript. Such a document can be displayed with standard compliant browsers such as Firefox or Opera (Internet Explorer will not do).

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.

Features

  1. Flat access 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 a person with a single click and some scrolling.
  2. Easy searching. The webpage contains a text entry and a selection field which make it easy to search on names or other properties.
  3. 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.
  4. 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.
  5. Fine grained 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 a color; to the best of my knowledge their is no other report that can display this information.

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".

Version History

  • Gramps 4 - Update of Gramps 3 version, to support GTK+3 and python 3. No new functionality was added.
  • Gramps 3 - An update of the Gramps 2.x version, to work with the new plugin-architecture. No new functionality was added.

Issues

  • Help URL does not lead here.
  • 6486: Duplication in graphical reports when first cousins marry
  • Repository information is at present not included in the page created by DenominoViso.