Addon:GenealogyTree

From Gramps
Revision as of 17:06, 5 December 2019 by Romjerome (talk | contribs) (Issues)
Jump to: navigation, search
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.


Main menu showing all four reports for Addon:GenealogyTree

The GenealogyTree addon uses LaTeX genealogytree (the Pedigree and genealogical tree diagrams package) to create professional looking trees for the active person. The following reports are available:

Usage

From the menu select Reports > Trees > [Xxxxx] Tree... where [Xxxxx] is one of the available reports.

For a large tree you will have to select a large paper size.

Features

  • Creates professional looking family trees for the active person.
  • Output is only to tex or pdf files.
Gramps-notes.png

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


Tree examples

Example output for each tree report.

Ancestor tree

Ancestor tree - example for Addon:GenealogyTree

Creates a tree chart showing the ancestors of the active person.

Descendant tree

Descendant tree - example for Addon:GenealogyTree

Creates a tree chart showing the descendants of the active person.

Grandparent tree

Grandparent tree - example for Addon:GenealogyTree


Sandclock tree

Sandclock tree - example for Addon:GenealogyTree


Sandclock Tree for a Family

Sandclock Tree for a Family - example for Addon:GenealogyTree


Prerequisites

Before any of these reports can be used you will need the following prerequisites installed:

  • texlive including the textlive-pictures package which contains LaTeX genealogytree (the Pedigree and genealogical tree diagrams package)

The texlive-pictures package contains genealogytree.

The texlive-fontsextra package is required for non-latin fonts.

Linux

On debian/Ubuntu

  • for PDF output file format needs LaTex support
  • need 'texlive-pictures' package

or download and install 'genealogytree' for the last version:

$ mkdir -p ~/texmf/tex/latex/genealogytree or /var/lib/texmf, /usr/local/share/texmf

$ cp ./genealogytree/* ~/texmf/tex/latex/genealogytree

$ texhash ~/texmf

Same for 'tcolorbox', and maybe for fonts : 'libertines', 'mweights, etc ...

$ cp ~/texmf/tex/latex/libertine/map/libertine.map ~/.texmf-var/fonts/map/pdftex/updmap/pdftex.map

$ updmap --enable Map=~/texmf/tex/latex/libertine/map/libertine.map

  • need 'texlive-latex-extra' (for xkeyval) and 'latex-tools' (for shellesc) or install the base [1]!
  • can also update 'pdftexcmds' and 'pgf'
Gramps-notes.png

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


Apple MacOS

Gramps-notes.png

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


Microsoft Windows

Quick instruction how to enable these reports on Windows.

Install it and run, create one of several type of reports in Reports->Trees menu.

Make sure to select large enough paper size in options as these report currently don't scale well.

You can output PDF(".pdf" extension) and LaTeX(".tex" extension) type files for the reports.

As our Microsoft Windows TeX/LaTeX environment you will use MiKTeX(from https://miktex.org/ ) The MiKTeX program environment is pretty large so we download the basic installation (190MB in size) from https://miktex.org/download/ctan/systems/win32/miktex/setup/basic-miktex-2.9.6520-x64.exe

Start the MiKTeX installer and during install select "install for me only" and "Install missing packages on-the-fly"

After successful installation of MiKTeX (it can take some time) start the Windows command console (cmd.exe) and type:

  lualatex FILENAME

where FILENAME is full pathname of .tex file you previously create in Gramps. MiKTeX package manager will automatically download missing packages. When all is finished pdf file will be created in directory in which you start this command. I recommend then that you run "MiKTeX Settings" from Windows StartMenu and change "on-the-fly" settings to "No" or "Always ask"

If everything goes well you will now have option in Gramps to create such reports in both latex and pdf format.

(Instructions based on https://sourceforge.net/p/gramps/mailman/message/36223716/ )

Issues

  • The diagram doesn't scale to fit the page. For a large tree you will have to select a large paper size.
    • Only the smallest value on Paper size item will be used
    • 10512Sandclock tree generates one page of (possibly) a larger report
  • 10494 LaTeX report includes full images uncropped
  • Help button url does not come here.
  • No support for localized month names

See also:

  • Feature request 10223 LaTeX genealogytree reports