Open main menu

Gramps β

Changes

Addon:GenealogyTree

3,335 bytes added, 23:12, 10 November 2025
no edit summary
{{Third-party pluginaddon}} 
[[File:Menu-trees-gramps50.png|450px|right|thumb|Main menu showing all four reports for Addon:GenealogyTree]]
 The '''GenealogyTree''' addon uses creates professional looking trees for the active person in the [[Addon:GenealogyTree#Prerequisites|LaTeX genealogytree (the Pedigree and genealogical tree diagrams package)]] to create professional looking trees for the active personfile format. The following reports are available:
* {{man label|[[Addon:GenealogyTree#Ancestor_tree|Ancestor Tree]]}}
* {{man label|[[Addon:GenealogyTree#Descendant_tree|Descendant Tree]]}}
== Usage ==
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.}}
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 * Output is to select a large enough paper size in the {{man label|Paper Options[https://www.latex-project.org/ LaTeX File]}} tab as these reports (<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#IssuesPrerequisites|currentlyadditional program]] doesn't scale wellto 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]] <!-- ===Legend to Symbols===##found on page 230 of GenealogyTree documentation pdf##Legend to symbols used on chart.
* = born, (*) born out of wedlock, +* = stillborn, *+ = died on the birthday,
* Output is only to {{man label|LaTex File}}(<code-->*.tex</code>) by default unless you install an [[Addon:GenealogyTree#Prerequisites|additional program]] to automatically convert it to a <code>pdf</code> file.
== Tree examples ==
[[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).
{{-}}
== Prerequisites ==
Before any of these reports can be used 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 need interpret the following prerequisites installedlayout 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 <code>textlive-pictures </code> package which contains [https://ctan.org/pkg/genealogytree LaTeX genealogytree] (the Pedigree and genealogical tree diagrams package)
The <code>texlive-pictures </code> package contains <code>genealogytree</code>.
The <code>texlive-fontsextra fonts-extra</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===
===Apple MacOS===
Install the MacTeX distribution.
* https://www.tug.org/mactex/
{{stub}}
 
===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 typewhich are not suitable for viewing.
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/ctan/systems/win32/miktex/setup/windows-x64/basic-miktex-2.9.7417-x64.exe
Start the MiKTeX installer and during install:
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.
I recommend then that If everything goes well you run will now have an additional {{man label|Output format:}} option in Gramps to output the reports to the PDF("MiKTeX Settings.pdf" from Windows StartMenu extension) format and change "on-the-fly" settings to "No" or "Always ask"builtin LaTex(*.tex) format.
If everything goes well you will now have option The last optional step is from the Windows StartMenu run the {{man label|MiKTeX Console}} and in Gramps {{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 to * 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 PDFoutput 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" extensiondocumentation] & examples ([https://github.com/T-F-S/genealogytree github])- CTAN(Comprehensive TeX Archive Network) format - 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 bultin latexsmallest 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) format'''* [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 ==
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.
** Only the smallest value on Paper size item will be used
* If you install only one of the reports the rest are installed also!
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[Category://sourceforge.net/p/gramps/mailman/message/36223716/ Original instructions for installing PDF output support for Microsoft WindowsAddons]] 
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Prerequisites|G]]
Gioto
Administrators
15,091
edits
Retrieved from "https://gramps-project.org/wiki/index.php/Special:MobileDiff/77688...128222"