15,091
edits
Changes
no edit summary
{{Third-party pluginaddon}}{{languages|Addon:GenealogyTree}}
[[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. Four 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.}}
* 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]]
== Features =Legend to Symbols===##found on page 230 of GenealogyTree documentation pdf##Legend to symbols used on chart.
* Creates professional looking family trees for = born, (*) born out of wedlock, +* = stillborn, *+ = died on the active person.* Output is only to <code>tex</code> or <code>pdf</code> files.birthday,
== Tree examples ==
===Descendant tree===
[[File:xxxGenealogyTree-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.
===Grandparent tree===
[[File:xxxGenealogyTree-grandparent-example-50.png|450px|right|thumb|Grandparent tree - example for Addon:GenealogyTree]]Creates a Grandparent tree for the selected person.
{{-}}
===Sandclock tree===
[[File:xxxGenealogyTree-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===
[[File:xxxGenealogyTree-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 ==
The <code>texlive-pictures fonts-extra</code> package contains genealogytreeis required for non-latin fonts.
===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 '[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 maybe
for fonts : '[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-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===
Install the MacTeX distribution.
* https://www.tug.org/mactex/
{{stub}}
===Microsoft Windows===
'''Discussions on Gramps community support forum (Instructions based on Discourse)'''* [https://sourceforgegramps.netdiscourse.group/pt/grampsrecurring-people-not-visible-on-exported-descendant-graph/mailman4328/message/36223716/ )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
** {{bug|10512}}Sandclock tree generates one page of (possibly) a larger report
* {{bug|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!
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Prerequisites|G]]