Difference between revisions of "Addon:DenominoViso"

From Gramps
Jump to: navigation, search
(Include Options tab)
m
(4 intermediate revisions by 2 users not shown)
Line 56: Line 56:
  
 
==== Image Options tab ====
 
==== Image Options tab ====
 +
 +
* [ ] {{man label|Include Photos/Images from Gallery}}
 +
** {{man label|Copy Image:}} [ ] * {{man label|to directory:}} <code>file/path/to/media</code>
 +
*** {{man button|Copy the images to the designated image directory}} button
 +
* {{man label|Images with Attribute:}} <code>____</code> equal to <code>___</code> should be '''Included''' (default) or ''Excluded''
 +
** [ ] Include Image source references
 +
* {{man label|Source reference attribute:}}
  
 
{{stub}}
 
{{stub}}
 
{{-}}
 
{{-}}
 +
 
==== Style Options tab ====
 
==== Style Options tab ====
 +
 +
* {{man label|Color of active person::}}
 +
* {{man label|Color of found persons::}}
 +
* {{man label|Color of male persons::}}
 +
* {{man label|Color of female persons::}}
 +
* {{man label|Width of rectangle (hrd)::}}
 +
* {{man label|Height of rectangle (hrd)::}}
 +
* {{man label|Vertical distance of rectangles (hrd)::}}
 +
* {{man label|Extra style settings::}}
  
 
{{stub}}
 
{{stub}}
 
{{-}}
 
{{-}}
 +
 
==== Advanced Options tab ====
 
==== Advanced Options tab ====
 +
 +
* {{man label|Mouse event handler:}} [x] onclick [ ] onmouseover
 +
* {{man label|Birth relationship linestyle:}}
 +
* {{man label|Source confidence color:}}
 +
* {{man label|Event format:}}
 +
* {{man label|Source format:}}
  
 
{{stub}}
 
{{stub}}
Line 105: Line 129:
 
* [https://github.com/gramps-project/addons-source/pull/245#issuecomment-543425169 Other minor issues reported on github]
 
* [https://github.com/gramps-project/addons-source/pull/245#issuecomment-543425169 Other minor issues reported on github]
  
 +
==See Also==
 +
* [[Web Solutions for Gramps]]
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Reports]]
 
[[Category:Reports]]

Revision as of 15:36, 16 November 2022

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 web page.

Usage

The 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 tabs.

DenominoViso Options tab

DenominoViso - Web Report - Addon - "DenominoViso Options" tab defaults
  • Destination: ~\user\document\outputlocation\DenominoViso.xhtml The destination file for the xhtml-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
  • Images with Attribute: ____ equal to ___ should be Included (default) or Excluded
    • [ ] Include Image source references
  • Source reference attribute:
Gramps-notes.png

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



Style Options tab

  • Color of active person::
  • Color of found persons::
  • Color of male persons::
  • Color of female persons::
  • Width of rectangle (hrd)::
  • Height of rectangle (hrd)::
  • Vertical distance of rectangles (hrd)::
  • Extra style settings::
Gramps-notes.png

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



Advanced Options tab

  • Mouse event handler: [x] onclick [ ] onmouseover
  • Birth relationship linestyle:
  • Source confidence color:
  • Event format:
  • Source format:
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.
  • Other minor issues reported on github

See Also