Difference between revisions of "Addon:GenealogyTree"

From Gramps
Jump to: navigation, search
m (Linux)
m (Issues)
 
(109 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
 
 
[[File:Menu-trees-gramps50.png|450px|right|thumb|Main menu showing all four reports for Addon:GenealogyTree]]
 
[[File:Menu-trees-gramps50.png|450px|right|thumb|Main menu showing all four reports for Addon:GenealogyTree]]
 
+
The '''GenealogyTree''' addon creates professional looking trees for the active person in the [[Addon:GenealogyTree#Prerequisites|LaTeX genealogytree (the Pedigree and genealogical tree diagrams package)]] file format. The following reports are available:
The '''GenealogyTree''' addon uses [[Addon:GenealogyTree#Prerequisites|LaTeX genealogytree (the Pedigree and genealogical tree diagrams package)]] to create professional looking trees for the active person. The following reports are available:
 
 
* {{man label|[[Addon:GenealogyTree#Ancestor_tree|Ancestor Tree]]}}
 
* {{man label|[[Addon:GenealogyTree#Ancestor_tree|Ancestor Tree]]}}
 
* {{man label|[[Addon:GenealogyTree#Descendant_tree|Descendant Tree]]}}
 
* {{man label|[[Addon:GenealogyTree#Descendant_tree|Descendant Tree]]}}
Line 11: Line 9:
  
 
== Usage ==
 
== Usage ==
 +
From the menu select {{man menu|Reports > Trees > [Xxxxx] Tree...}} where [Xxxxx] is one of the available reports.
  
From the menu select {{man menu|Reports > Trees > [Xxxxx] Tree...}} where [Xxxxx] is one of the available reports.
+
{{man tip|For a large family tree|Make sure to select a large enough paper size in the {{man label|Paper Options}} tab as the reports [[Addon:GenealogyTree#Issues|currently]] do not scale well.}}
 +
 
 +
 
 +
* Output is to {{man label|[https://www.latex-project.org/ LaTeX File]}}(<code>*.tex</code>) by default.  This format is generally intended for print production and may not be suitable for ''viewing'' the resulting tree chart.  Installing an [[Addon:GenealogyTree#Prerequisites|additional program]] to automatically convert to a <code>.pdf</code> format file is highly recommended.
 +
 
 +
See [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_4#Common_options|Common options]]
  
For a large tree you will have to select a large paper size.
+
<!--
  
== Features ==
+
===Legend to Symbols===
 +
##found on page 230 of GenealogyTree documentation pdf##
 +
Legend to symbols used on chart.
  
* Creates professional looking family trees for the active person.
+
* = born, (*) born out of wedlock, +* = stillborn, *+ = died on the birthday,
* Output is only to <code>tex</code> or <code>pdf</code> files.
 
  
{{stub}}
+
-->
  
 
== Tree examples ==
 
== Tree examples ==
Line 33: Line 38:
  
 
===Descendant tree===
 
===Descendant tree===
[[File:xxx.png|450px|right|thumb|Descendant tree - example for Addon:GenealogyTree]]
+
[[File:GenealogyTree-Addon-descendant-example-50.png|450px|right|thumb|Descendant tree - example for Addon:GenealogyTree]]
  
 
Creates a tree chart showing the descendants of the active person.
 
Creates a tree chart showing the descendants of the active person.
Line 39: Line 44:
  
 
===Grandparent tree===
 
===Grandparent tree===
[[File:xxx.png|450px|right|thumb|Grandparent tree - example for Addon:GenealogyTree]]
+
[[File:GenealogyTree-grandparent-example-50.png|450px|right|thumb|Grandparent tree - example for Addon:GenealogyTree]]
 +
Creates a Grandparent tree for the selected person.
 
{{-}}
 
{{-}}
 +
 
===Sandclock tree===
 
===Sandclock tree===
[[File:xxx.png|450px|right|thumb|Sandclock tree - example for Addon:GenealogyTree]]
+
[[File:GenealogyTree-Addon-sandclock-example-51.png|450px|right|thumb|Sandclock tree - example for Addon:GenealogyTree]]
 +
Creates a Sandclock tree for the selected person.
 +
 
 +
A sandclock connects ancestors and descendants starting from a single proband (active person).
 
{{-}}
 
{{-}}
  
 
===Sandclock Tree for a Family===
 
===Sandclock Tree for a Family===
[[File:xxx.png|450px|right|thumb|Sandclock Tree for a Family - example for Addon:GenealogyTree]]
+
[[File:GenealogyTree-Addon-sandclock_family-example-51.png|450px|right|thumb|Sandclock Tree for a Family - example for Addon:GenealogyTree]]
 +
Creates a Sandclock tree for the selected family.
 
{{-}}
 
{{-}}
  
 
== Prerequisites ==
 
== Prerequisites ==
Before any of these reports can be used you will need the following prerequisites installed:
+
Output is only to {{man label|[[Output_formats#LaTeX|LaTex]] File}} (<code>*.tex</code>) which by default is displayed as plain text with layout annotation in the preferred Text viewing application for your OS unless you have installed a LaTex helper application.  The following prerequisite "helper" applications will interpret the layout annotation to view the fully formatted LaTex(*.tex) file or automatically convert it to a <code>pdf</code> file:
* [https://www.tug.org/texlive/ texlive] including the textlive-pictures package which contains [https://ctan.org/pkg/genealogytree LaTeX genealogytree] (the Pedigree and genealogical tree diagrams package)
+
* [https://www.tug.org/texlive/ texlive] including the <code>textlive-pictures</code> package which contains [https://ctan.org/pkg/genealogytree LaTeX genealogytree] (the Pedigree and genealogical tree diagrams package)
  
The texlive-pictures package contains genealogytree.
+
The <code>texlive-pictures</code> package contains <code>genealogytree</code>.
  
The texlive-fontsextra package is required for non-latin fonts.
+
The <code>texlive-fontsextra</code> package is required for non-latin fonts.
 +
 
 +
See specific instructions for your operating system.
 +
* [[Addon:GenealogyTree#Linux|Linux]]
 +
* [[Addon:GenealogyTree#Apple MacOS|Apple MacOS]]
 +
* [[Addon:GenealogyTree#Microsoft Windows|Microsoft Windows]]
  
 
===Linux===
 
===Linux===
{{stub}}
 
  
* for PDF output file format needs LaTex support
+
====Debian/Ubuntu====
* need 'texlive-pictures' package  
+
 
 +
* 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 '[https://www.ctan.org/pkg/genealogytree genealogytree]' for the last version:
 
or download and install '[https://www.ctan.org/pkg/genealogytree genealogytree]' for the last version:
  
Line 73: Line 91:
 
Same for '[https://www.ctan.org/pkg/tcolorbox tcolorbox]', and maybe
 
Same for '[https://www.ctan.org/pkg/tcolorbox tcolorbox]', and maybe
 
for fonts : '[https://www.ctan.org/pkg/libertine libertines]', '[https://www.ctan.org/pkg/mweights mweights], etc ...
 
for fonts : '[https://www.ctan.org/pkg/libertine libertines]', '[https://www.ctan.org/pkg/mweights mweights], etc ...
* need 'texlive-latex-extra' (for xkeyval)
+
 
 +
<code>$ cp ~/texmf/tex/latex/libertine/map/libertine.map ~/.texmf-var/fonts/map/pdftex/updmap/pdftex.map</code>
 +
 
 +
<code>$ updmap --enable Map=~/texmf/tex/latex/libertine/map/libertine.map</code>
 +
 
 +
<code>$ sudo mktexlsr</code>
 +
 
 +
<code>$ sudo updmap-sys --enable Map=~/texmf/tex/latex/libertine/map/libertine.map</code>
 +
 
 +
* need 'texlive-latex-extra' (for xkeyval) and 'latex-tools' (for [https://github.com/T-F-S/csvsimple/issues/1 shellesc]) or install the base [http://mirrors.ctan.org/macros/latex/base.zip]!
 +
* can also update '[https://www.ctan.org/pkg/pdftexcmds pdftexcmds]' and '[https://www.ctan.org/pkg/pgf pgf]'
 +
 
 +
{{stub}}
  
 
===Apple MacOS===
 
===Apple MacOS===
 +
Install the MacTeX distribution.
 +
* https://www.tug.org/mactex/
 
{{stub}}
 
{{stub}}
 +
 
===Microsoft Windows===
 
===Microsoft Windows===
  
Quick instruction how to enable these reports on 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.
  
Install it and run, create one of several type of reports in {{man menu|Reports->Trees}} menu.
+
For our Microsoft Windows TeX/LaTeX environment you will use [https://miktex.org/ MiKTeX] we only need to download the basic installer from:
 +
* https://miktex.org/download/
  
Make sure to select large enough paper size in options as these report currently don't scale well.
+
Start the MiKTeX installer and during install:
 +
* select {{man label|[ ]Install MiKTeX only for me(YOURUSERNAME)}}
 +
* and change {{man label|Install missing packages on-the-fly}} to ''Yes''
 +
after successful installation of MiKTeX do the following once only:
  
You can output PDF(".pdf" extension) and LaTeX(".tex" extension) type files for the reports.
+
Start the [https://www.howtogeek.com/235101/10-ways-to-open-the-command-prompt-in-windows-10/ Microsoft Windows command console prompt] (cmd.exe) and type:
  
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
+
<code>lualatex --version</code>
  
Start the MiKTeX installer and during install select "install for me only" and "Install missing packages on-the-fly"
+
If that works then you are ready to have MiKTex install the additional missing packages, start Gramps and create a one of the {{man menu|Reports > Trees > [Xxxxx] Tree...}} reports and for the LaTeX(".tex" extension). Now in the Microsoft Windows command console prompt (cmd.exe) type:
  
After successful installation of MiKTeX (it can take some time) start the Windows command console (cmd.exe) and type:
+
<code>lualatex FILENAME</code>
  lualatex FILENAME
 
  
where FILENAME is full pathname of .tex file you previously create in Gramps. MiKTeX package manager will automatically download missing  
+
where FILENAME is full pathname of <code>.tex</code> 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.
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.
+
If everything goes well you will now have an additional {{man label|Output format:}} option in Gramps to output the reports to the PDF(".pdf" extension) format and the builtin LaTex(*.tex) format.
  
(Instructions based on https://sourceforge.net/p/gramps/mailman/message/36223716/ )
+
The last optional step is from the Windows StartMenu run the {{man label|MiKTeX Console}} and in {{man label|Settings}} change {{man label|[ ]Always install missing packages on-the-fly}} settings to {{man label|[ ]Ask me}}(recommended) or {{man label|[ ]Never install missing packages on-the-fly}}.
 +
 
 +
{{man tip|PDF's created automatically with lualatex|are output to the PDF Version 1.5 (Acrobat 6.0)format which has a maximum PDF page size of 200" x 200" inches (508cm x 508cm) so choose your custom paper sizes accordingly or Gramps will show the {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Error_and_Warning_Reference#Report_could_not_be_created|Report could not be created]]}} dialog}}
 +
 
 +
==See also==
 +
* Feature request {{bug|10223}} LaTeX genealogytree reports
 +
* https://github.com/gramps-project/gramps/blob/master/gramps/gen/plug/docgen/treedoc.py  (creates the *.tex file and checks for the presence of lualatex.exe on Windows or lualatex on Linux )
 +
*[https://sourceforge.net/p/gramps/mailman/message/36223716/ Original instructions for installing PDF output support for Microsoft Windows]
 +
* [https://ctan.org/pkg/genealogytree LaTeX genealogytree] (the Pedigree and genealogical tree diagrams package) - By Prof. Dr. Dr. Thomas F. Sturm, [http://mirrors.ctan.org/macros/latex/contrib/genealogytree/genealogytree.pdf documentation] & examples ([https://github.com/T-F-S/genealogytree github])- CTAN(Comprehensive TeX Archive Network) -  Pedigree and genealogical tree diagrams are proven tools to visualize genetic and relational connections between individuals. The naming (“tree”) derives from historical family diagrams. However, even the smallest family entity consisting of two parents and several children is hardly a ‘mathematical’ tree — it is a more general graph. The package provides a set of tools to typeset genealogical trees (i.e., to typeset a set of special graphs for the description of family-like structures). The package uses an autolayout algorithm which can be customized, e.g., to prioritize certain paths.
 +
* Questions tagged [https://tex.stackexchange.com/questions/tagged/genealogytree genealogytree] on tex.stackexchange.com
 +
 
 +
'''Discussions on Gramps community support forum (Discourse)'''
 +
* [https://gramps.discourse.group/t/recurring-people-not-visible-on-exported-descendant-graph/4328/5 rendering of cousins marrying] and [[Addon:Family_Tree|Family Tree]] addon report as an alternative.
  
 
== Issues ==
 
== Issues ==
 +
See issues tagged with [https://gramps-project.org/bugs/tag_view_page.php?tag_id=294 GenealogyTree] on the bugtracker.
 
* The diagram doesn't scale to fit the page. For a large tree you will have to select a large paper size.
 
* 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
 
** {{bug|10512}}Sandclock tree generates one page of (possibly) a larger report
 
** {{bug|10512}}Sandclock tree generates one page of (possibly) a larger report
 
* {{bug|10494}} LaTeX report includes full images uncropped
 
* {{bug|10494}} LaTeX report includes full images uncropped
 
* Help button url does not come here.
 
* 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:
+
[[Category:Addons]]
* Feature request {{bug|10223}} LaTeX genealogytree reports
 
 
 
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]

Latest revision as of 20:50, 22 January 2024

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 creates professional looking trees for the active person in the LaTeX genealogytree (the Pedigree and genealogical tree diagrams package) file format. 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 the reports currently do not scale well.


  • Output is to LaTeX File(*.tex) by default. This format is generally intended for print production and may not be suitable for viewing the resulting tree chart. Installing an additional program to automatically convert to a .pdf format file is highly recommended.

See Common options


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.

A sandclock connects ancestors and descendants starting from a single proband (active 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) which by default is displayed as plain text with layout annotation in the preferred Text viewing application for your OS unless you have installed a LaTex helper application. The following prerequisite "helper" applications will interpret the layout annotation to view the fully formatted LaTex(*.tex) file or automatically convert it to a pdf file:

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

Tango-Dialog-information.png
PDF's created automatically with lualatex

are output to the PDF Version 1.5 (Acrobat 6.0)format which has a maximum PDF page size of 200" x 200" inches (508cm x 508cm) so choose your custom paper sizes accordingly or Gramps will show the Report could not be created dialog


See also

  • Feature request 10223 LaTeX genealogytree reports
  • https://github.com/gramps-project/gramps/blob/master/gramps/gen/plug/docgen/treedoc.py (creates the *.tex file and checks for the presence of lualatex.exe on Windows or lualatex on Linux )
  • Original instructions for installing PDF output support for Microsoft Windows
  • LaTeX genealogytree (the Pedigree and genealogical tree diagrams package) - By Prof. Dr. Dr. Thomas F. Sturm, documentation & examples (github)- CTAN(Comprehensive TeX Archive Network) - Pedigree and genealogical tree diagrams are proven tools to visualize genetic and relational connections between individuals. The naming (“tree”) derives from historical family diagrams. However, even the smallest family entity consisting of two parents and several children is hardly a ‘mathematical’ tree — it is a more general graph. The package provides a set of tools to typeset genealogical trees (i.e., to typeset a set of special graphs for the description of family-like structures). The package uses an autolayout algorithm which can be customized, e.g., to prioritize certain paths.
  • Questions tagged genealogytree on tex.stackexchange.com

Discussions on Gramps community support forum (Discourse)

Issues

See issues tagged with GenealogyTree on the bugtracker.

  • 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!