5,876
edits
Changes
m
{{man warn[[File:DescendantBook-TextReports-addon-ReportOptions-tab-defaults-50.png|thumb|'''CAVEAT''':right|450px|Whilst the report should work against Gramps 3.3. out of the box it hasn't been extensively tested.Most of testing/development is against 3.4. This has not been tested at all against trunk (3.5+), as I do not have a gtk3 system that I can test/develop on. If some kind soul wishes to take up the mantle on that front I'd very muchappreciate it.}}Descendant Book - Text Reports - Addon - Report Options - tab - defaults]]
[[ImageThe "Descendant Books" addon consists of two book type addons:DescendantBook.png* {{man label|thumbDescendant Book}} and * {{man label|rightDetailed Descendant Book}}Both reports are based directly off the [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_6#Descendant_Report|400pxDescendant Report]] and [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_6#Detailed_Descendant_Report|Sample Detailed Descendant Book DialogReport]]'s, the main difference beinginstead of just producing a report based on the Center Person, it allows for the use of a builtin Query or Custom query. This idea is to produce as many descendant reports as is required to satisfy inclusion of all individuals within the given query.
The If for instance "Descendant BooksEntire Database" plugin consists of two book type pluginsis chosen as the query to use. Descendant Book Then the entire database is traversed and Detailed Descendant Book.Both reports are based directly a unique list of Descendant Report ancestors is determined and Detailed Descendant Report, the main difference beinginstead of just producing then a descendant report based on the Center Person, it allows for the use each of a built in Query orCustom query. This idea these ancestors is to produce as many descendant reports as is required to satisfy inclusion of allindividuals within the given queryproduced.
If for instance "Entire Database" As there is chosen as a potential to produce more than one report the query best place to useinclude these reports is under [[Gramps_Glossary#books_report|Books report]]. Then the entire database If more than one report is traversed andproduced a unique list table of ancestors contents is determined and then a descendant report for each of these ancestors is producedgenerated to show how many reports there are.
As there is a potential to produce more than one report the best place to include these reports is under
Books. If more than one report is produced a table of contents is generated to show how many reports there are.
Download Versions for Gramps branches 3.4, 4.x and 5.x are available for installation via Gramps Addon manager. *Gramps 5.x Version: via the appropriate file for your Addon manager*Gramps version 4.x Version: via the Addon managerDownload and [[Plugins4.1#Manually_installed_Addons|manually install]]:
no edit summary
{{Third-party pluginaddon}}
If one only report is produced, no table of contents are generated.
=== Usage ===
* ''Descendant Book'' - menu {{man menu|Reports > Text Reports > Descendant Book}}
* ''Detailed Descendant Book'' - menu {{man menu|Reports > Text Reports > Detailed Descendant Book}}
=== Common uses ===
To date my most common usage is :
==== Entire Database ====
I find that running of either report using the Entire database is really useful for highlighting potential
people in my database that I've not linked up, dangling tree elements etc.
==== Ancestors of <person> ====
Again really useful to get a complete accurate picture of the entire family tree of an individual, pretty
much includes all cousins of this person. Up to now to print this you would first have to determine all the
[[ImageFile:DetailedDescendantBook-TextReports-addon-ReportOptions-tab-defaults-50.png|thumb|right|400px450px|Sample Detailed Descendant Book Dialog- Text Reports - Addon - Report Options - tab - defaults]]
=== Descendant Report, Suppress duplicate families ===
to the "Same as person" output seen at the moment, except it spans reports.
=== Detailed Descendant Report - Report Reference Section ===If an individual appears in more than one report, then a new section is printed under that person indicating . It indicates allthe reports in which this person appears . === Index of Names (Detailed Descendant Report) ===The index of Names is the list of all Names that appear inthe Detailed Descendant Report printed in alphabetical order. Next to each name there are all references to find the person in the single reports. The user can decide whether or not print this index. === Index of Dates (Detailed Descendant Report) ===The index of Dates is the list of all events' dates in the Detailed Descendant Report printed in cronological order with the descriptions. The user can decide whether or not print this index. === Index of Places (Detailed Descendant Report) ===The index of Places is the list of all events' dates and description in the Detailed Descendant Report printed in cronological order. The user can decide whether or not print this index.
== Installation ==
*Gramps 3.4 Version : http://mattman.iflaf.com/familytree/gramps/DescendantBooks-1.0.1.tar.gz
== TODO Issues==* '''Reports don't run very well under gramps 4.x branch''' - Matt Keenan* {{bug|8912}} Gramps crashes when DescendantBooks report runs;Feature request* {{bug|8905}} detailed descendant report - added index of names, dates, places;TODO
# Addition of a title page
# Addition of page numbers to Table of Contents (PDF/ODF only)
# If 2 can be done, then put page numbers in references as well.
[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Reports]]