Difference between revisions of "Addon:Graphical Reports"

From Gramps
Jump to: navigation, search
(All reports)
(Options)
 
(31 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Plugins]]
+
{{Third-party plugin}}
[[Category:Developers/General]]
+
{{man note|All sample reports|that are shown are created using Gramps ''[https://raw.githubusercontent.com/gramps-project/gramps/maintenance/gramps50/example/gramps/data.gramps data.gramps]'' file and '''I0024 Smith, Gustaf Sr.''' as the center person/family.}}
There are three reports in this group of reports.  All sample reports that are shown are ran off of the example data and '''I07 Smith, Gustaf Sr.''' as the center person/family.  
+
 
 +
{{man warn|No longer available|Merged into Gramps 3.3+ as the [[Gramps_5.1_Wiki_Manual_-_Reports_-_part_4#Graphical_Reports|Graphical Reports]]}}
 +
 
 +
The Graphical Reports addon creates charts for the active person. The following three similar reports are available:
 +
 
 +
* {{man label|[[Addon:Graphical_Reports#Ancestoral_Report|Ancestoral Report]]}}
 +
* {{man label|[[Addon:Graphical_Reports#Personal_Descendant_Report|Personal Descendant Report]]}}
 +
* {{man label|[[Addon:Graphical_Reports#Familial_Descendant_Report|Familial Descendant Report]]}}
 +
 
 +
=Usage=
  
The updates of these three reports nearly match each other. They are:
+
Select the report you want to use from the menu option {{man menu|Reports -> Graphical Reports -> XXXXX...}}
  
 +
=Tree examples=
 
== Ancestoral Report ==
 
== Ancestoral Report ==
[[Image:Ancestor_chart.png|thumb|Sample Ancestoral chart]]
+
<!-- [[File:xxx.png|thumb|Sample Ancestoral chart]] need image of this report from addon-->
This report contains extensions to the current Ancestor report that is available.  The updates are:
+
This report contains extensions to the builtin [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_4#Ancestor_Tree|Ancestor Tree]] report that is available.  The updates are:
 
#Able to print empty boxes where missing ancestors are
 
#Able to print empty boxes where missing ancestors are
 
#can print spouses of the center person
 
#can print spouses of the center person
Line 13: Line 23:
 
#You can choose the display that Fathers, Mothers, the Center person and his/her spouses use
 
#You can choose the display that Fathers, Mothers, the Center person and his/her spouses use
  
 +
{{-}}
 
== Personal Descendant Report ==
 
== Personal Descendant Report ==
[[Image:personal_descend_tree.png|thumb|Sample Personal Descendant chart]]
+
[[File:personal_descend_tree.png|thumb|Sample Personal Descendant chart]]
 
This report is an extension to the current Descendant Report that is available. The updates are:
 
This report is an extension to the current Descendant Report that is available. The updates are:
  
Line 31: Line 42:
 
the '''Sample Personal Descendant chart''' that is shows was ran with the 'start with the selected persons parents first' option.  Without this option the left column (Gustaf's parents) will not be there and Gustaf's two siblings (Magnes and Emil) on the next column will not print.
 
the '''Sample Personal Descendant chart''' that is shows was ran with the 'start with the selected persons parents first' option.  Without this option the left column (Gustaf's parents) will not be there and Gustaf's two siblings (Magnes and Emil) on the next column will not print.
  
 +
{{-}}
 
== Familial Descendant Report ==
 
== Familial Descendant Report ==
 
[[Image:descend-_chart.jpg|thumb|Sample Familiar Descendant chart]]
 
[[Image:descend-_chart.jpg|thumb|Sample Familiar Descendant chart]]
Line 39: Line 51:
 
The '''Sample Familial Descendant chart''' that is shows was ran with the 'start with the selected persons parents first' option.  If Gustaf's wife had parents within the database, they would be shown to the right of her, and any siblings would be displayed below her.
 
The '''Sample Familial Descendant chart''' that is shows was ran with the 'start with the selected persons parents first' option.  If Gustaf's wife had parents within the database, they would be shown to the right of her, and any siblings would be displayed below her.
  
== All reports ==
+
{{-}}
All of these three reports share the following new features:
+
=Options=
#The [[Graphical_Tr_Report|Tree Options tab]] contains the main options on how many columns of people will be shown
+
 
#The [[Graphical_Di_Report|Display tab]] shows the main display that will be used
+
These reports share most the following option tabs unless stated otherwise:  
#The [[Graphical_Se_Report|Secondary [display] tab]] shows secondary display that can/will be used
+
 
#The same [[Graphical_Pr_Report|print features]]
+
== Tree Options tab ==
#Better [[display formatting|Graphical_Substitution]]
+
The Tree Options tab contains the main options on how many columns of people will be shown
 +
 
 +
This is always the starting place of any report. 
 +
 
 +
;The main item of interest is the '''Center Person/Family.'''
 +
:Both the Ancestoral and Personal Descendant reports ask for a center person.
 +
:The Familial Descendant report asks for a center family
 +
 
 +
;Generations
 +
:How many generations (columns) will be shown on the report.
 +
 
 +
;Level of Spouses
 +
:Only available in the Descendant reports.  Whether to show: <br/>
 +
:0 - No spouses, only direct descendants <br/>
 +
:1 - Spouses of the direct descendants <br/>
 +
:2 - Spouses of those spouses <br/>
 +
:3 - etc
 +
 
 +
;Print Entire tree
 +
:Only available in the Ancestoral report.  Fills out the entire tree.  If a grand-parent is unknown, print an empty box.
 +
 
 +
;Compress tree
 +
:Tries to compress the tree to minimize printing space.
 +
 
 +
;Show spouses of the center person
 +
:Only available in the Ancestoral report.  Displays information about the spouses below the center person.  Also allows you to select which display (main/secondary) to use.
 +
 
 +
 
 +
== Tree Display Tab ==
 +
The Tree Display tab shows the main display that will be used
 +
 
 +
This is main (primary) display that will be used within the report.
 +
 
 +
;Personal Display Format
 +
:For the Descendant reports.  This will be used for all direct descendants and main parents of the selected person/family.  Or to better describe it, all Non spouses.
 +
 
 +
;Main Display Format
 +
:For the Ancestoral report.  The center person will always use this display.  Everyone else (spouses of the center person, (grand)-fathers, (grand)-mothers) can choose.
 +
 
 +
 
 +
;Compress Personal and Spousal Display formats
 +
:For the Descendant reports.  If a line has variables on it (ie. 'b. $b $B') and ALL of the variables have nothing to print, then remove the entire line.  This option can help 'compress tree' option on the 'Tree Options' tab.
 +
 
 +
;Compress Main and Secondary Display formats
 +
:For the Ancestoral report.  This is the exact same as above.
 +
 
 +
 
 +
;Use Main/Secondary Display Format for
 +
:For the Ancestoral report.  This specifies whether (grand)-fathers and (grand)-mothers will use the Main Display only, or which half will use the Main while the other half will use the Secondary.
 +
 
 +
;Bold Direct descendants
 +
:For the Descendant reports.  Bold those people that are direct descendants of the center person/family.  This will NOT bold half or step persons.
 +
 
 +
== Secondary [display] tab ==
 +
The Secondary [display] tab shows secondary display that can/will be used
 +
 
 +
This is spousal (secondary) display that will be used within the report.
 +
 
 +
;Use separate display format for spouses
 +
:For the Descendant reports.
 +
 
 +
;Indent spouses
 +
:For the Descendant reports. When showing more than one level of spouses (option on the 'Tree Options' tab), indenting the spouses really helps visually group people so the report is easier to understand.
 +
 
 +
 
 +
;Spousal Display Format
 +
:For the Descendant reports.  This will be used for spouses only.  This does not include the parents of the center person or the parents of the father and mother of the center family.
 +
 
 +
;Secondary Display Format
 +
:For the Ancestoral report.  Spouses of the center person, (grand)-fathers, (grand)-mothers) can choose to use this display format
 +
 
 +
 
 +
;Include Marriage Information
 +
:whether to include a separate box holding marriage information. 
 +
:in the Ancestoral report, anyone can display this information too.  I would personally suggest that (grand)-fathers display this.
 +
:in the Descendant reports, anyone can display this information too.  I would personally suggest that spouses display this.
 +
 
 +
 
 +
;Marriage Display Format
 +
:How you wish to display this information.
 +
 
 +
== Print Tab ==
 +
The same print features
 +
 
 +
;Scale report to fit
 +
#Do not scale report.  This option works great with the 'One Page Report' option.
 +
#Scale report to fit page width only.
 +
#Scale report to fit the size of the page.
 +
;One page report
 +
:Scale up or down the size of the page (whether verticaly or both vertically and horizontally) to fit the natural size of the report.  Note that this WILL most likely make irregular page sizes.  Great for Emailing to relatives and Kinkos can size to print too.
 +
;Include Report Title
 +
:Will display the names of the uppermost parents.
 +
:Grandparents will be displayed if known/shown.  Otherwise the parents will be printed.
 +
;Print a border
 +
:Prints a border around the report if wanted.
 +
;Print Page Numbers
 +
:Page numbers will be printed on the lower right hand corner of the report.
 +
;Include Blank Pages
 +
:on multiple page reports, if nothing is on a page, specify to print the page anyway.
 +
----
 +
The 'Scale Report to fit' and 'One Page Report' options can be done in a couple of neat ways.
 +
 
 +
{| border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse;"
 +
|-
 +
! Scale Report to fit
 +
! One Page Report
 +
! Result
 +
|-
 +
|Do not scale report
 +
|Unchecked
 +
|this is the default options, The report will print on as many pages (both horizontally and vertically) as needed.
 +
|-
 +
|Do not scale report
 +
|Checked
 +
|This will make the page size the size that the report wants to be.  Using zero page margins makes gif/jpeg pictures.
 +
|-
 +
|Scale report to fit page width only
 +
|Unchecked
 +
|this option is most useful when printing landscape.  It is easier to tape together pages vertically only.
 +
|-
 +
|Scale report to fit page width only
 +
|Checked
 +
|My Kinkos has a 36 inch wide printer.  The paper is on a roll, so I use this option to make my LONG wall reports.
 +
|-
 +
|Scale report to fit the size of the page
 +
|both checked and unchecked
 +
|This will scale the report to fit on the page specified in 'Paper Options'
 +
|}
 +
 
 +
==Display formatting  ==
 +
#Better display formatting/Graphical_Substitution
 
##'{' and '}' now encapsulate areas that can be removed if all variables within are unknown
 
##'{' and '}' now encapsulate areas that can be removed if all variables within are unknown
 
##'-' at the start of a line will remove the line if all variables on the line are unknown
 
##'-' at the start of a line will remove the line if all variables on the line are unknown
## a better [[Display_formatting3_3|Graphical_Substitution]] is very close to complete (documentation only now).
+
## a better Display_formatting/Graphical_Substitution is very close to complete (documentation only now).
 
#Missing (unknown) information can now either display nothing or '_____'
 
#Missing (unknown) information can now either display nothing or '_____'
 
#The option to include a personalized Note to the report.
 
#The option to include a personalized Note to the report.
 
##You can print the date by using '$T' in the note.
 
##You can print the date by using '$T' in the note.
  
<br />
+
Many of the graphical reports allow you to customize the information on the display. Variable substitutions are used to substitute personal or marriage information for a particular symbol.
=== The Replace tab ===
+
 
 +
===The Substitution Keys===
 +
{| {{prettytable}}
 +
|-
 +
|$n
 +
|Displays the person's name in the form of FirstName LastName
 +
|-
 +
|$N
 +
|Displays the person's name in the form of LastName, FirstName
 +
|-
 +
|$i
 +
|Displays the GRAMPS ID associated with the person.
 +
|-
 +
|$b
 +
|Displays the person's date of birth
 +
|-
 +
|$B
 +
|Displays the person's place of birth
 +
|-
 +
|$d
 +
|Displays the person's date of death
 +
|-
 +
|$D
 +
|Displays the person's place of death
 +
|-
 +
|$s
 +
|Displays the name of the person's spouse in the form of FirstName LastName
 +
|-
 +
|$S
 +
|Displays the name of the person's spouse in the form of LastName, FirstName.
 +
|-
 +
|$m
 +
|Displays the marriage date of the person and the spouse.
 +
|-
 +
|$M
 +
|Displays the place associated with the marriage of the person and the spouse.
 +
|-
 +
|$v
 +
|Displays the marriage divorce date of the person and the spouse.
 +
|-
 +
|$V
 +
|Displays the place associated with the divorce of the person and the spouse.
 +
|-
 +
|colspan="2"|
 +
|-
 +
| \$
 +
| $
 +
|-
 +
| \}
 +
| }
 +
|-
 +
| \{
 +
| {
 +
|-
 +
| \\
 +
| \
 +
|-
 +
|colspan="2"|
 +
|-
 +
| {
 +
|Starts a conditional printing section.
 +
|-
 +
| }
 +
|Ends a conditional printing section.
 +
 
 +
|-
 +
| {
 +
|(only at the start of a line)
 +
This is a line that is NOT to print if all variables are unknown
 +
|}
 +
 
 +
 
 +
=== Conditional printing ===
 +
'{' and '}' have been added to help define what prints on a line and '{' at the start of a line defines if the line prints at all.  These two are based on these rules:
 +
{| {{prettytable}}
 +
|-
 +
|no variables within closing
 +
|prints everything.
 +
|-
 +
|variables inside and none have information in the database.
 +
ie. '{d. $d $D}' when the person is alive
 +
|prints Nothing
 +
|-
 +
|variables inside and at least one has information in the database.
 +
ie. '{b. $b $B}' and the date is known
 +
|prints everything
 +
|}
 +
 
 +
 
 +
Other Notes:
 +
# The end of a line is the same as a closing '}'
 +
## 'd. $d{ $D} is the same as 'd. $d{ $D'
 +
# Brackets are read from left to right
 +
 
 +
==== Examples ====
 +
$i $n
 +
Born on $b{ at $B}
 +
{d. $d $D {($v)
 +
* The first and second lines always prints. 
 +
* The second line always prints 'Born on '
 +
* The second line may or may not print ' at ' and the place depending on whether the place is known.
 +
* The third line will not be displayed if the person is alive or if BOTH the date and place of death is not known.
 +
 
 +
 
 +
{Born{ on $b}{ at $B
 +
If either the date or place (or both) of birth is known 'Born ' will print with what information is known.  If neither is known a blank line will print. You can replace the first '{' with a '-' to remove the line all together from what displays (for this person)
 +
 
 +
=== Replace missing places/dates with: ===
 +
All reports come with this option to either:
 +
# print nothing at all.  ie ''
 +
# print '_____' (A space to fill in information)
 +
when a place or a date is not known.
 +
 
 +
ie. The first example may display 'Born on _____' if both the date and place are unknown.
 +
 
 +
=== See also ===
 +
* [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_2#Substitution_Values]]
 +
 
 +
 
 +
{{-}}
 +
== The Replace tab ==
 
* Note that this tab is only available in the Descendant reports.   
 
* Note that this tab is only available in the Descendant reports.   
Since all of the columns are the same width, the single longest line within the report dictates the entire width of the report.  As such, I have added this feature to help ''replace'' long lines with something smaller.  Examples of use are:<br />
+
Since all of the columns are the same width, the single longest line within the report dictates the entire width of the report.  As such, I have added this feature to help ''replace'' long lines with something smaller.  Examples of use are:
"<br />
+
<pre>
Heard Island and McDonald Islands/HMD<br />
+
"
Democratic People's Republic of Korea/PRK<br />
+
Heard Island and McDonald Islands/HMD
South Georgia and the South Sandwich Islands/SGS<br />
+
Democratic People's Republic of Korea/PRK
The Democratic Republic of Congo/COD<br />
+
South Georgia and the South Sandwich Islands/SGS
United States of America/USA<br />
+
The Democratic Republic of Congo/COD
"<br />
+
United States of America/USA
 +
"
 +
</pre>
 
This also works great on removing/abbreviating long town, county, or state names.
 
This also works great on removing/abbreviating long town, county, or state names.
  
<br />
+
{{-}}
=== The Notes tab ===
+
== The Notes tab ==
 
This tab helps you to display a personalized note somewhere on the report.  The options are whether to print a note, what to print, and where to print in (corners only at this time).  The '$T' variable will now print the date.
 
This tab helps you to display a personalized note somewhere on the report.  The options are whether to print a note, what to print, and where to print in (corners only at this time).  The '$T' variable will now print the date.
 +
 +
[[Category:Plugins|G]]
 +
[[Category:Developers/General]]
 +
[[Category:Reports|G]]

Latest revision as of 23:04, 19 March 2022

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.

Gramps-notes.png
All sample reports

that are shown are created using Gramps data.gramps file and I0024 Smith, Gustaf Sr. as the center person/family.

Gnome-important.png
No longer available

Merged into Gramps 3.3+ as the Graphical Reports

The Graphical Reports addon creates charts for the active person. The following three similar reports are available:

Usage

Select the report you want to use from the menu option Reports -> Graphical Reports -> XXXXX...

Tree examples

Ancestoral Report

This report contains extensions to the builtin Ancestor Tree report that is available. The updates are:

  1. Able to print empty boxes where missing ancestors are
  2. can print spouses of the center person
  3. two separate displays (for fathers and mothers), and a display for marriage information (in a separate box).
  4. You can choose the display that Fathers, Mothers, the Center person and his/her spouses use


Personal Descendant Report

Sample Personal Descendant chart

This report is an extension to the current Descendant Report that is available. The updates are:

  1. Able to start with the selected persons parents first
    1. This will also show all siblings of the selected person
  2. level of spouses that you wish to see
    • 0 - Do not show spouses
    • 1 - Show spouses of the direct descendants
    • 2 - Show spouses of those spouses
    • 3 - etc
  3. able to compress the tree
  4. two separate displays (one for direct descendants and the other for spouses), and a display for marriage information (in a separate box).
  5. able to bold direct descendants
  6. and able to replace text within the report.

the Sample Personal Descendant chart that is shows was ran with the 'start with the selected persons parents first' option. Without this option the left column (Gustaf's parents) will not be there and Gustaf's two siblings (Magnes and Emil) on the next column will not print.


Familial Descendant Report

Sample Familiar Descendant chart

This report is an extension to the Personal Descendant Report in that it is ran off of a family. As such it can have two sets of grandparents.

In the example given (picture to the right), Mom (shown with the bottom arrow) does not have any parents in the database. If she did, they would be displayed to the left of her and all brothers and sisters would be below her.

The Sample Familial Descendant chart that is shows was ran with the 'start with the selected persons parents first' option. If Gustaf's wife had parents within the database, they would be shown to the right of her, and any siblings would be displayed below her.


Options

These reports share most the following option tabs unless stated otherwise:

Tree Options tab

The Tree Options tab contains the main options on how many columns of people will be shown

This is always the starting place of any report.

The main item of interest is the Center Person/Family.
Both the Ancestoral and Personal Descendant reports ask for a center person.
The Familial Descendant report asks for a center family
Generations
How many generations (columns) will be shown on the report.
Level of Spouses
Only available in the Descendant reports. Whether to show:
0 - No spouses, only direct descendants
1 - Spouses of the direct descendants
2 - Spouses of those spouses
3 - etc
Print Entire tree
Only available in the Ancestoral report. Fills out the entire tree. If a grand-parent is unknown, print an empty box.
Compress tree
Tries to compress the tree to minimize printing space.
Show spouses of the center person
Only available in the Ancestoral report. Displays information about the spouses below the center person. Also allows you to select which display (main/secondary) to use.


Tree Display Tab

The Tree Display tab shows the main display that will be used

This is main (primary) display that will be used within the report.

Personal Display Format
For the Descendant reports. This will be used for all direct descendants and main parents of the selected person/family. Or to better describe it, all Non spouses.
Main Display Format
For the Ancestoral report. The center person will always use this display. Everyone else (spouses of the center person, (grand)-fathers, (grand)-mothers) can choose.


Compress Personal and Spousal Display formats
For the Descendant reports. If a line has variables on it (ie. 'b. $b $B') and ALL of the variables have nothing to print, then remove the entire line. This option can help 'compress tree' option on the 'Tree Options' tab.
Compress Main and Secondary Display formats
For the Ancestoral report. This is the exact same as above.


Use Main/Secondary Display Format for
For the Ancestoral report. This specifies whether (grand)-fathers and (grand)-mothers will use the Main Display only, or which half will use the Main while the other half will use the Secondary.
Bold Direct descendants
For the Descendant reports. Bold those people that are direct descendants of the center person/family. This will NOT bold half or step persons.

Secondary [display] tab

The Secondary [display] tab shows secondary display that can/will be used

This is spousal (secondary) display that will be used within the report.

Use separate display format for spouses
For the Descendant reports.
Indent spouses
For the Descendant reports. When showing more than one level of spouses (option on the 'Tree Options' tab), indenting the spouses really helps visually group people so the report is easier to understand.


Spousal Display Format
For the Descendant reports. This will be used for spouses only. This does not include the parents of the center person or the parents of the father and mother of the center family.
Secondary Display Format
For the Ancestoral report. Spouses of the center person, (grand)-fathers, (grand)-mothers) can choose to use this display format


Include Marriage Information
whether to include a separate box holding marriage information.
in the Ancestoral report, anyone can display this information too. I would personally suggest that (grand)-fathers display this.
in the Descendant reports, anyone can display this information too. I would personally suggest that spouses display this.


Marriage Display Format
How you wish to display this information.

Print Tab

The same print features

Scale report to fit
  1. Do not scale report. This option works great with the 'One Page Report' option.
  2. Scale report to fit page width only.
  3. Scale report to fit the size of the page.
One page report
Scale up or down the size of the page (whether verticaly or both vertically and horizontally) to fit the natural size of the report. Note that this WILL most likely make irregular page sizes. Great for Emailing to relatives and Kinkos can size to print too.
Include Report Title
Will display the names of the uppermost parents.
Grandparents will be displayed if known/shown. Otherwise the parents will be printed.
Print a border
Prints a border around the report if wanted.
Print Page Numbers
Page numbers will be printed on the lower right hand corner of the report.
Include Blank Pages
on multiple page reports, if nothing is on a page, specify to print the page anyway.

The 'Scale Report to fit' and 'One Page Report' options can be done in a couple of neat ways.

Scale Report to fit One Page Report Result
Do not scale report Unchecked this is the default options, The report will print on as many pages (both horizontally and vertically) as needed.
Do not scale report Checked This will make the page size the size that the report wants to be. Using zero page margins makes gif/jpeg pictures.
Scale report to fit page width only Unchecked this option is most useful when printing landscape. It is easier to tape together pages vertically only.
Scale report to fit page width only Checked My Kinkos has a 36 inch wide printer. The paper is on a roll, so I use this option to make my LONG wall reports.
Scale report to fit the size of the page both checked and unchecked This will scale the report to fit on the page specified in 'Paper Options'

Display formatting

  1. Better display formatting/Graphical_Substitution
    1. '{' and '}' now encapsulate areas that can be removed if all variables within are unknown
    2. '-' at the start of a line will remove the line if all variables on the line are unknown
    3. a better Display_formatting/Graphical_Substitution is very close to complete (documentation only now).
  2. Missing (unknown) information can now either display nothing or '_____'
  3. The option to include a personalized Note to the report.
    1. You can print the date by using '$T' in the note.

Many of the graphical reports allow you to customize the information on the display. Variable substitutions are used to substitute personal or marriage information for a particular symbol.

The Substitution Keys

$n Displays the person's name in the form of FirstName LastName
$N Displays the person's name in the form of LastName, FirstName
$i Displays the GRAMPS ID associated with the person.
$b Displays the person's date of birth
$B Displays the person's place of birth
$d Displays the person's date of death
$D Displays the person's place of death
$s Displays the name of the person's spouse in the form of FirstName LastName
$S Displays the name of the person's spouse in the form of LastName, FirstName.
$m Displays the marriage date of the person and the spouse.
$M Displays the place associated with the marriage of the person and the spouse.
$v Displays the marriage divorce date of the person and the spouse.
$V Displays the place associated with the divorce of the person and the spouse.
\$ $
\} }
\{ {
\\ \
{ Starts a conditional printing section.
} Ends a conditional printing section.
{ (only at the start of a line)

This is a line that is NOT to print if all variables are unknown


Conditional printing

'{' and '}' have been added to help define what prints on a line and '{' at the start of a line defines if the line prints at all. These two are based on these rules:

no variables within closing prints everything.
variables inside and none have information in the database.

ie. '{d. $d $D}' when the person is alive

prints Nothing
variables inside and at least one has information in the database.

ie. '{b. $b $B}' and the date is known

prints everything


Other Notes:

  1. The end of a line is the same as a closing '}'
    1. 'd. $d{ $D} is the same as 'd. $d{ $D'
  2. Brackets are read from left to right

Examples

$i $n
Born on $b{ at $B}
{d. $d $D {($v)
  • The first and second lines always prints.
  • The second line always prints 'Born on '
  • The second line may or may not print ' at ' and the place depending on whether the place is known.
  • The third line will not be displayed if the person is alive or if BOTH the date and place of death is not known.


{Born{ on $b}{ at $B

If either the date or place (or both) of birth is known 'Born ' will print with what information is known. If neither is known a blank line will print. You can replace the first '{' with a '-' to remove the line all together from what displays (for this person)

Replace missing places/dates with:

All reports come with this option to either:

  1. print nothing at all. ie
  2. print '_____' (A space to fill in information)

when a place or a date is not known.

ie. The first example may display 'Born on _____' if both the date and place are unknown.

See also



The Replace tab

  • Note that this tab is only available in the Descendant reports.

Since all of the columns are the same width, the single longest line within the report dictates the entire width of the report. As such, I have added this feature to help replace long lines with something smaller. Examples of use are:

"
Heard Island and McDonald Islands/HMD
Democratic People's Republic of Korea/PRK
South Georgia and the South Sandwich Islands/SGS
The Democratic Republic of Congo/COD
United States of America/USA
"

This also works great on removing/abbreviating long town, county, or state names.


The Notes tab

This tab helps you to display a personalized note somewhere on the report. The options are whether to print a note, what to print, and where to print in (corners only at this time). The '$T' variable will now print the date.