4,861
edits
Changes
m
; Known issuesThere is a problem with people who appear both as spouses # Size limit: Cairo surface size limit. (32767 for height and descendants with the inc_marriages option, where there can be confusion regarding marriage events32767 for width [http://comments.gmane.org/gmane.comp.lib.cairo/21068])# Some PDF output size limit (currently crossing this limit will result in an empty PDF file)
Gramps XML
[[Image:DescendantsLines.png|thumb|300px|Lines of descendants chart]]
[[Image:DescendantsLines-m-ep-.png|thumb|300px|DescendantsLines, Left-aligned text style, example Gramps data, inc_marriages and inc_places.]]
[[Image:JohnShakespeare-DescendantsLines.png|thumb|300px|Shakespeare family tree, DescendantsLines, inc_marriages]][[Image:JohnShakespeare-DescendantsLines-ep.png|thumb|300px|Shakespeare family tree, DescendantsLines, Left-aligned text style, including event places]]
'''DescendantsLines''' is an in-development addon for Gramps which generates a graphical descendants tree using orthogonal edges and routing ("square edges").
== Characteristics ==
DescendantsLines presents an orthogonal family tree, currently in vertical mode only. In DescendantsLines, vertical mode, children in a family are ordered from left to right following the Gramps child order; and families are ordered right to left, top to bottom, following the Gramps family order.
== History ==
2007: Adam Sampson has written a standalone python script for parsing data.gramps ([[GRAMPS Gramps XML]]). [http://offog.org/darcs/misccode/familytree]
2010: this script needs some updates for avoiding minor issues.
# The addon DescendantsLines does not use the Gramps document interface. (perhaps the Gramps document interface options should be hidden)
# DestinationOption does not have the usual error handling and user checking (e.g. for overwriting files)
== Installation ==
* S_VPAD - Length of vertical padding spacing between spouse and spouse-bar (?)
* FL_PAD - Length of padding spacing between S_UP edges (vertical edges from spouse-bar to spouse) and O_DOWN edges (vertical edges from spouse-bar to child-bar)
* OL_PAD-
* O_DOWN - The length of the vertical edges from spouse-bar to child-bar
* C_PAD - Length of padding spacing between children
* C_UP - The length of the vertical edges from child to child-bar
* SP_PAD - Length of padding spacing between spouses
* MIN_C_WIDTH- Minimal width of child cells* TEXT_PAD- Length of text padding* TEXT_LINE_PAD- Length of text line padding
* output_fmt - The output format (PNG, SVG, PDF or PS)
* output_fn - The output filename
* inc_places - Whether to include event places in the output
* inc_marriages - Whether to include marriage information in the output
* inc_dnum - Whether to use d'Aboville descendant numbering system
* style - The predefined output style
* [[File:DescendantsLines-left.pdf]] -- DescendantsLines, Left-aligned text style, example Gramps data, use_colors, inc_marriages and inc_places, PDF output.
* [[File:Charlemagne-DescendantsLines.pdf]] -- DescendantsLines addon, inc_marriages and inc_places, PDF output, presenting a family tree of Charlemagne starting from Chloderic King of Cologne.
* [[File:PepinOfHerstal-DescendantsLines-left-dnum.pdf]] --DescendantsLines Gramps addon, Left-aligned text style, d'Aboville numbering (inc_dnum), descendants of Pepin of Herstal or Pepin II, PDF output. Data from http://www.genealogyforum.com/gedcom/gedr1434.htm.
== Tree compression and or modification==
SVG format trees can be compressed and or modified manually using the program Inkscape, using the select and path tools; or using other SVG manipulating program. PNG format trees can be compressed manually by manipulating the image.
== Development ==
* Make the XML export smaller. Use filter. (done in Gramps-addons)
* Add option for output format. (PNG, SVG, PDF or PS) (done in Gramps-addons)
* Add boolean option use_colors. (done in Gramps-addons)
* Use gen.display.name.displayer. (done in Gramps-addons)
* Add option for name display format. (done in Gramps-addons trunk)
* Add style variables and option, ref. text alignment, etc. (done in Gramps-addons)
* Use Gramps family order. (done in Gramps-addons)
* Add option to use d'Aboville descendants numbering system. (done in Gramps-addons trunk)
* Think of optional tree compression algorithms.
* Add option to include divorces.
* Add option to include spouse ancestries.
** Add option to include arbitrary spouse ancestries.
* Add option to include arbitrary ancestries.
* Add option to include notes.
* Add option to include sources.
* Add option to include images.
* Add horizontal mode.
* Add optional text wrap width.
* Add optional text width with use of ellipses.
* Cairo provides hyperlink support. Names could be hyperlinks to html complete individual reports or to web report pages.
* This addon may with time become a general orthogonal family tree drawing resource for Gramps, for a View, etc., and outside Gramps as well. The PyCairo code can be connected to a view.
The hardcoded number option limits can be altered by users, by altering the code.
# Use a DestinationOption
# Ignore standard Filename option[http://www.gramps-project.org/bugs/view.php?id=5545]
== Command Line Interface ==
Gramps provides a cli support for running reports and tools [http://www.gramps-project.org/wiki/index.php?title=[Gramps_3.2_Wiki_Manual_4_Wiki_Manual_-_Command_Line]. * use stdin and stdout for command line import/export [http://www|Gramps 3.gramps4 Wiki Manual -projectCommand Line]].org/bugs/view.php?id=4114]
* {{bug|4114}}: Would like to use stdin and stdout for command line import/export.
Feel free to contribute or improve it.
== See also ==
* [[Addon:Family Tree]] - generates horizontal orthogonal graphical trees.
* [[Addon:TimelinePedigreeView]] - displays horizontal orthogonal graphical trees.
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Reports]]
