Changes

{{Third-party pluginaddon}}[[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:* {{man label|[[Addon:GenealogyTree#Ancestor_tree|Ancestor Tree]]}}* {{languagesman label|[[Addon:GenealogyTree#Descendant_tree|Descendant Tree]]}}* {{man label|[[Addon:GenealogyTree#Grandparent_tree|Grandparent Tree]]}}* {{man label|[[Addon:GenealogyTree#Sandclock_tree|Sandclock Tree]]}}* {{man label|[[Addon:GenealogyTree#Sandclock Tree for a Family|Sandclock Tree for a Family]]}}

== 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.}}  * 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]] <!-- ===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,  --> == Tree examples ==Example output for each tree report.{{-}}===Ancestor tree===[[File:MenuGenealogyTree-treesAddon-gramps50AncestorTree-example-50.png|450px|right|Main menu showing all four reports thumb|Ancestor tree - example for Addon:GenealogyTree]] Creates a tree chart showing the ancestors of the active person.{{-}}

The "GenealogyTree" addon uses ===Descendant tree===[[AddonFile:GenealogyTree#Prerequisites-Addon-descendant-example-50.png|LaTeX genealogytree (the Pedigree and genealogical 450px|right|thumb|Descendant tree diagrams package)- example for Addon:GenealogyTree]] to create professional looking trees. Four report are available:* Ancestor* Descendant* Grandparent* Sandclock

===Grandparent tree===[[File:GenealogyTree-grandparent-example-50.png|450px|right|thumb|Grandparent tree - example for Addon:GenealogyTree]]Creates a Grandparent tree for the selected person.{{stub-}}

== Usage =Sandclock tree===[[File:GenealogyTree-Addon-sandclock-example-51.png|450px|right|thumb|Sandclock tree - example for Addon:GenealogyTree]]Creates a Sandclock tree for the selected person.

From the menu select A sandclock connects ancestors and descendants starting from a single proband (active person).{{man menu|Reports > Trees > [Xxxxx] Tree...-}} where [Xxxxx] is one of the available reports:* Ancestor* Descendant* Grandparent* Sandclock

== Features =Sandclock Tree for a Family===[[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.{{stub-}}

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 layout annotation to view the following installedfully 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-pictures fonts-extra</code> package contains genealogytreeis required for non-latin fonts.

The See specific instructions for your operating system.* [[Addon:GenealogyTree#Linux|Linux]]* [[Addon:GenealogyTree#Apple MacOS|Apple MacOS]]* [[Addon:GenealogyTree#Microsoft Windows|Microsoft Windows]] ===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-fontsextra pictures' package is required or download and install '[https://www.ctan.org/pkg/genealogytree genealogytree]' for the last version: <code>$ mkdir -p ~/texmf/tex/latex/genealogytree</code>or ''/var/lib/texmf'', ''/usr/local/share/texmf'' <code>$ cp ./genealogytree/* ~/texmf/tex/latex/genealogytree</code> <code>$ texhash ~/texmf</code> Same for '[https://www.ctan.org/pkg/tcolorbox tcolorbox]', and maybefor nonfonts : '[https://www.ctan.org/pkg/libertine libertines]', '[https://www.ctan.org/pkg/mweights mweights], etc ... <code>$ cp ~/texmf/tex/latex/libertine/map/libertine.map ~/.texmf-latin 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]'

===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 type which 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/ 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: 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: <code>lualatex --version</code> 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: <code>lualatex FILENAME</code> 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. 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. 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 ==