18
edits
Changes
m
DescendantsLines {{man label|Descendants Lines}} has the following option tabs available to change: {{man tip|There are option and tree combinations which may generate overlapping edges and nodes.|If using the <code>inc_marriages</code> option the <code>[[DescendantsLines#S_.26_F_Options|S_DOWN - S_UP]]</code> difference may need to be increased by 5-15 units depending on the tree.}}
** {{man label|[ ] Use d'Aboville descendant numbering System}} - Whether to use [[Genealogical Numbering Systems#d'aboville|d'Aboville]] descendant numbering system.** {{man label|Colour Name by Gender}} - Whether to use colored names indicating person gender in the output.
** {{man label|[ ] Use alternate events if primary events are not found-}} - for example, if there is no Birth event, a Baptism or Christening event may be substituted ==== Replace Options ====[[File:DescendatsLines5_replace. For Death Events, a Burial may be substituted.** {{man labelpng|thumb|right|450px|[ Replace Options] Sort Events by Date}}** {{man label|[ ] Protect People, Images or Events that are marked Private}}* {{man label|Privacy textReplace Display Format 'Replace this'/'with this':}} <code>Private<ie: United States of America/code>(default)USA* {{man label|Text Style:}} - The predefined output style* {{man label|Maximum Note Length:}} - limits the length of notes.
* This page talks about a "inc_marriages" option but none of the option tabs have that setting , was it removed? Or is it now called "Spouse Display Format"
no edit summary
{{Third-party plugin}}
[[ImageFile:DescendantsLinesGalileoGenealogy.png|thumb|right|450px|Descendants Lines of descendants chart]][[Image:DescendantsLines-m-ep-.png|thumb|right|450px|DescendantsLines, Left-aligned text style, Galileo Galilei's Genealogy example Gramps data, inc_marriages and inc_places.]][[Image:JohnShakespeare-DescendantsLines.pngThe {{man label|thumb|right|450px|Shakespeare family tree, DescendantsLines, inc_marriages]][[Image:JohnShakespeare-DescendantsLines-ep.png|thumb|right|450px|Shakespeare family tree, DescendantsLines, Left-aligned text style, including event places]] '''DescendantsLines''' is an Descendants Lines}} Graphical Report addon for Gramps which generates a graphical descendants tree using orthogonal edges and routing ("square edges"). DescendantsLines presents an orthogonal family tree, in vertical mode only. In DescendantsLines, vertical mode, in which 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.
== Usage ==
* Open Gramps
* Select the report using the menu option {{man menu|Reports -> Graphical Reports -> Descendants Lines...}}
* Choose On the Report Options tab choose the output path for the {{man label|Destination:}} <code>$GRAMPSHOME/Descendants Lines.png</code>(default).
** Note: That ''Document Options'' {{man label|Filename:}} option will contain an empty file after the report is run.
* Note: If the script is run in "debug mode" it generates copious terminal output such as "Unknown event type: ..." or "Unknown spouse: ...". These warnings are harmless.
=== Options ===
==== Paper Options ====
See also [[Gramps_{{man version}}_Wiki_Manual_-_Reports - part 4#Common options|common options]]
{{-}}
==== Report Options ====
[[File:DescendantTree_options1_ReportDescendatsLines1_report.png|thumb|right|450px|Report Options]]
* {{man label|Center Person:}}
* {{man label|Output format:}} - The output format (PNG, SVG, PDF or PS)
* {{man label|Destination:}} - <code>$GRAMPSHOME/Descendants Lines.png</code>(default). The output filename
* {{man label|Generations:}} - Maximum number of generations to include. (0 for unlimited)
** {{man label|[ ] Box around PersonUse d's blockAboville descendant numbering System}}** {{man label- Whether to use [[Genealogical Numbering Systems#d'aboville|[ d'Aboville]] Colour blocks by Generation}}* {{man label|Descend block colour intensity:}}* {{man label|Spouse block colour intensity:}}descendant numbering system.
** {{man label|[ ] Include an image}}
* {{man label|Max Image height:}}
* {{man label|Max Image width:}}
* {{man label|Image Location:}}
{{-}}
==== Report Options(2) ====[[File:DescendatsLines2_report2.png|thumb|right|450px|Report Options (2)]]* {{man label|[ ] Colour Name by Gender}} - Whether to use colored names indicating person gender in the output.* {{man label|[ ] Use alternate events if primary events are not found}} - for example, if there is no Birth event, a Baptism or Christening event may be substituted. For Death Events, a Burial may be substituted.* {{man label|[ ] Sort Events by Date}}* {{man label|Text Style:}} - The predefined output style* {{man label|Maximum Note Length:}} - limits the length of notes.{{-}} ==== Display Options ====[[File:DescendantTree_options2_DisplayDescendatsLines3_display.png|thumb|right|450px|Display Options]]* {{man label|[ ] Box around Person's block}}* {{man label|[ ] All Person's blocks have the same height}}* {{man label|[ ] All Person's blocks have the same width}}* {{man label|[ ] Colour blocks by Generation}}* {{man label|Descend block colour intensity:}}* {{man label|Spouse block colour intensity:}}{{-}} ==== Display Formats ====[[File:DescendatsLines4_display-formats.png|thumb|right|450px|Display Formats]]
* {{man label|Name Display Format:}} - The name format. See [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_2|Formatting]] for more detail.
* {{man label|Descendant Display Format:}} - the default settings provide for several event types and their dates and places. By changing the contents of this box, you can elect to include Events of various types, and include the dates or places and their format. See [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_2|Formatting]] for more detail.
* {{man label|Spouse Display Format:}} - the default settings provide for several event types and their dates and places. By changing the contents of this box, you can elect to include Events of various types, and include the dates or places and their format. See [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_2|Formatting]] for more detail.
==== Spouse and Family Options ====
[[File:DescendatsLines6_spouse.png|thumb|right|450px|Spouse and Family Options]]
* {{man label|Vertical edge descendant to spouse-bar}}
* {{man label|Vertical edge spouse-bar to spouse}}
* {{man label|Vertical space spouse-bar to other spouse}}
* {{man label|Horizontal space descendant to spouse}}
* {{man label|Horizontal space family to family}}
* {{man label|Horizontal distance spouse to family edge}}
{{-}}
==== Replace Children Options ====[[File:DescendantTree_options3_ReplaceDescendatsLines7_children.png|thumb|right|450px|Replace Children Options]]* {{man label|Replace Display Format 'Replace this'/'with this':OL_PAD}} - The number of ??? pad* {{man label|Vertical edge spouse-bar to child-bar}}* {{man label|Children distance}}* {{man label|Vertical edge child to child-bar}}* {{man label|MIN_C_WIDTH}}* {{man label|Space around text}} ie: United States * {{man label|Space between lines of America/USAtext}}
{{-}}
==== S & F Header and Footer Options ====[[File:DescendantTree_options4_SFDescendatsLines8_header.png|thumb|right|450px|S F Header and Footer Options]]* S_DOWN - The length of the vertical edges from descendant to spouse-bar{{man label|Title text}}* S_UP - The length of the vertical edges from spouse-bar to spouse{{man label|Footer text}}* S_VPAD - Length of vertical padding spacing between spouse and spouse-bar (?)* SP_PAD - Length of padding spacing between spouses* F_PAD - Length of padding spacing between families (?)* FL_PAD - Length of padding spacing between S_UP edges (vertical edges from spouse-bar to spouse) {{man label|Title and O_DOWN edges (vertical edges from spouse-bar to child-bar)footer coefficient}}
{{-}}
==== O, C & Text Privacy Options ====[[File:DescendantTree_options5_OC-TextDescendatsLines9_privacy.png|thumb|right|450px|O C & Text Privacy Options]]* OL_PAD - The number of ??? pad{{man label|[ ] Protect People, Images or Events that are marked Private}}* 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* MIN_C_WIDTH - Minimal width of child cells* TEXT_PAD - Length of {{man label|Privacy text padding* TEXT_LINE_PAD - Length of text line padding:}} <code>Private</code>(default)
{{-}}
=== Examples ===
[[File:DescendantsLines.png|thumb|right|450px|Lines of descendants chart]]
[[File:DescendantsLines-m-ep-.png|thumb|right|450px|DescendantsLines, Left-aligned text style, example Gramps data, inc_marriages and inc_places.]]
[[File:JohnShakespeare-DescendantsLines.png|thumb|right|450px|Shakespeare family tree, DescendantsLines, inc_marriages]]
[[File:JohnShakespeare-DescendantsLines-ep.png|thumb|right|450px|Shakespeare family tree, DescendantsLines, Left-aligned text style, including event places]]
* [[File:DescendantsLines-m-ep.pdf]] -- DescendantsLines, example Gramps data, inc_marriages and inc_places, PDF output.
* [[File:DescendantsLines-left.pdf]] -- DescendantsLines, Left-aligned text style, example Gramps data, use_colors, inc_marriages and inc_places, PDF output.
* {{bug|5965}} report produced with stale name from previous gramps session
* {{bug|10390}} Display options in DescendantsLines graphical report do not work as advertised
* Help button does not link here.
See: [https://gramps-project.org/bugs/tag_view_page.php?tag_id=275 Tag: DescendantsLines] on Bugtracker
===inc_marriages option?===
This page mentions a "inc_marriages" option but none of the option tabs have that setting , was it removed? Or is it now called "Spouse Display Format"
{{man tip|There are option and tree combinations which may generate overlapping edges and nodes.|If using the <code>inc_marriages</code> option the <code>[[DescendantsLines#S_.26_F_Options|S_DOWN - S_UP]]</code> difference may need to be increased by 5-15 units depending on the tree.}}
== See also ==
