Display formatting

From Gramps
Revision as of 02:06, 18 February 2010 by Ander882 (talk | contribs)
Jump to: navigation, search

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.

$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.
$$ $
}} }
{{ {
-- - (only at the start of a line. See below)


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
- (at the start of a line)

when none of the variables have information to print

Line is removed from the display
- (at the start of a line)

when at least one has information in the database.

Line is printed


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
    1. '{{{' is '{{'(print a single '{') and '{'(start a conditional printing section) together

Examples

$i $n
Born on $b{ at $B
-d. $d $D

The first and second lines always prints. The second line may or may not print ' at ' and the place depending on whether the place is known. and 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 the information. 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)