Changes

== History Characteristics ==2007: Adam Sampson has written a standalone python script for parsing data.gramps ([[GRAMPS XML]]). [http://offog.org/darcs/misccode/familytree] 2010: this script needs some updates for avoiding minor issues. A modified script is available on the addons repository. [http://gramps-addons.svn.sourceforge.net/viewvc/gramps-addons/trunk/contrib/DescendantsLines/] == Libraries ==The program DescendantsLines, as the script in which it is basedpresents an orthogonal family tree, is written currently in Python, using PyCairo and the Python XML libraryvertical mode only. Many Gramps modules are also used. == Current limitations ==<!-- # No option for name display format --># Partial quoting of xml-syntax-like data. Data which resembles xml syntax (tagsIn DescendantsLines, etc) may cause error.# Script ignores role on event (was added in 2007)# Script ignores localized date handlers (using ISO date formatvertical mode, date quality children in english)# Memory limitation with a large database (DOM parsing)# The last pixel column of each secondary line of each entry is wrong coloured (red instead black)# The addon DescendantsLines does not use the Gramps document interface. (perhaps family are ordered from left to right following the Gramps document interface options should be hidden)# DestinationOption does not have the usual error handling child order; and user checking (e.g. for overwriting files) == Installation ===== Gramps 3.3 version ===The Gramps 3.3 version of DescendantsLines can be installed through the Gramps Plugin Manager. === Gramps 3.4 version ===To use the Gramps 3.4 version of DescendantsLinesfamilies are ordered right to left, on Gramps Trunktop to bottom, now gramps34:# Create the directory $GRAMPSHOME/gramps/gramps34/plugins/DescendantsLines/ .# Copy following the files DescendantsLines.py and DescendantsLines.gpr.py from Gramps-addons trunk svn to the directory $GRAMPSHOME/gramps/gramps34/plugins/DescendantsLines/ family order.

* OL_PAD-

* MIN_C_WIDTH- Minimal width of child cells* TEXT_PAD- Length of text padding* TEXT_LINE_PAD- Length of text line padding

* [[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 Charlemagne GEDCOM at http://www.genealogyforum.com/gedcom/gedr1434.htm.  == Development History ==*2007: Adam Sampson has written a standalone python script for parsing data.gramps ([[Gramps XML]]). [http://offog.org/darcs/misccode/familytree]*2010: this script needs some updates for avoiding minor issues. A modified script is available on the addons repository. [http://sourceforge.net/p/gramps-addons/code/HEAD/tree/trunk/contrib/DescendantsLines/] == Libraries ==The program DescendantsLines, as the script in which it is based, is written in Python, using PyCairo and the Python XML library. Many Gramps modules are also used. == Current limitations ==<!-- # No option for name display format --># Partial quoting of xml-syntax-like data. Data which resembles xml syntax (tags, etc) may cause error.# Script ignores role on event (was added in 2007)# Script ignores localized date handlers (using ISO date format, date quality in english)# Memory limitation with a large database (DOM parsing)# The last pixel column of each secondary line of each entry is wrong coloured (red instead black)# 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)# Size limit: Cairo surface size limit. (32767 for height and 32767 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) == Installation ===== Gramps 4.x version ===Installed through the Gramps Plugin Manager. === Gramps 3.3 version ===The Gramps 3.3 version of DescendantsLines can be installed through the Gramps Plugin Manager. === Gramps 3.4 version ===To use the Gramps 3.4 version of DescendantsLines, on Gramps Trunk, now gramps34:# Create the directory $GRAMPSHOME/gramps/gramps34/plugins/DescendantsLines/ .# Copy the files DescendantsLines.py and DescendantsLines.gpr.py from Gramps-addons trunk svn to the directory $GRAMPSHOME/gramps/gramps34/plugins/DescendantsLines/ . == 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.

Draft version is available on [[Addons_development|Addons]] repository. [httphttps://github.com/gramps-project/addons.svn.sourceforge.net-source/tree/viewvcmaster/grampsDescendantsLines addons-addonssource/trunktree/contribmaster/DescendantsLines/]

# Generate a plugins/docgen/PNGDrawDoc.py file [http://www.gramps-project.org/bugs/view.php?id={{bug|4447]}}

# Have a look at mega-widget request and implementation [http://www.gramps-project.org/bugs/view.php?id={{bug|2393]}}

# Ignore standard Filename option [http://www.gramps-project.org/bugs/view.php?id={{bug|5545]}}

Gramps provides a cli support for running reports and tools [http://www[Gramps 4.gramps2 Wiki Manual -project.org/wiki/index.php?title=Gramps_3.2_Wiki_Manual_-_Command_LineCommand Line]].

* {{bug|4114}}: Would like to use stdin and stdout for command line import/export [http://www.gramps-project.org/bugs/view.php?id=4114]

Feel free to contribute or improve it== See also ==* [[Addon:Family Tree]] - generates horizontal orthogonal graphical trees.* [[Addon:TimelinePedigreeView]] - displays horizontal orthogonal graphical trees.