Difference between revisions of "Addon:GenealogyTree"

From Gramps
Jump to: navigation, search
(Prerequisites)
(Apple MacOS: don't have a mac so but https://www.tug.org/texlive/ recommends this)
Line 97: Line 97:
  
 
===Apple MacOS===
 
===Apple MacOS===
 +
Install the MacTeX distribution.
 +
* https://www.tug.org/mactex/
 
{{stub}}
 
{{stub}}
  

Revision as of 02:12, 15 May 2020

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.

Tango-Dialog-information.png
For a large family tree

Make sure to select a large enough paper size in the Paper Options tab as these reports currently doesn't scale well.


  • Output is only to LaTex File(*.tex) by default (which is generally not suitable for viewing the resulting tree chart) unless you install an additional program to automatically convert it to a pdf file.

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

Creates a Grandparent tree for the selected person.

Sandclock tree

Sandclock tree - example for Addon:GenealogyTree

Creates a Sandclock tree for the selected person.

Sandclock Tree for a Family

Sandclock Tree for a Family - example for Addon:GenealogyTree

Creates a Sandclock tree for the selected family.

Prerequisites

Output is only to LaTex File(*.tex) by default unless you install the following prerequisites to automatically convert it to a pdf.

To view the tex file as a pdf file 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.

See specific instructions for your operating system.

Linux

Debian/Ubuntu

  • TeX support, at least 'texlive-base', 'texlive-binaries', 'tex-common', 'luatex' packages
  • for internal PDF output file format needs LaTex support (e.g., 'texlive-latex-base' package)
  • for genealogytree needs '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

$ sudo mktexlsr

$ sudo updmap-sys --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

Install the MacTeX distribution.

Gramps-notes.png

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


Microsoft Windows

You can enable automatic output to PDF on Microsoft Windows as by default these reports only output to the LaTeX(".tex" extension) file type which are not suitable for viewing.

For our Microsoft Windows TeX/LaTeX environment you will use MiKTeX we only need to download the basic installer from:

Start the MiKTeX installer and during install:

  • select [ ]Install MiKTeX only for me(YOURUSERNAME)
  • and change Install missing packages on-the-fly to Yes

after successful installation of MiKTeX do the following once only:

Start the Microsoft Windows command console prompt (cmd.exe) and type:

lualatex --version

If that works then you are ready to have MiKTex install the additional missing packages, start Gramps and create a one of the Reports > Trees > [Xxxxx] Tree... reports and for the LaTeX(".tex" extension). Now in the Microsoft Windows command console prompt (cmd.exe) type:

lualatex FILENAME

where FILENAME is full pathname of .tex file you previously create in Gramps. The MiKTeX package manager will then automatically download the missing packages. When all is finished pdf file will be created in directory in which you start this command, along with two other files of the same name but with different extensions (*.log) and (*.aux) which you can ignore.

If everything goes well you will now have an additional Output format: option in Gramps to output the reports to the PDF(".pdf" extension) format and the builtin LaTex(*.tex) format.

The last optional step is from the Windows StartMenu run the MiKTeX Console and in Settings change [ ]Always install missing packages on-the-fly settings to [ ]Ask me(recommended) or [ ]Never install missing packages on-the-fly.

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
  • If you install only one of the reports the rest are installed also!

See also: