Difference between revisions of "De:Gramps 3.3 Wiki Handbuch - Berichte - Teil 2"
Leonhaeuser (talk | contribs) |
Leonhaeuser (talk | contribs) |
||
Line 83: | Line 83: | ||
---- | ---- | ||
− | === | + | === Standardanzeigeformate === |
{| | {| | ||
Line 122: | Line 122: | ||
---- | ---- | ||
− | === | + | === Veraltete Variablen === |
Some of the old variables were deprecated because [[#Format Strings|Format Strings]] have replaced them. So here is a list of those variables and how to achieve their results: | Some of the old variables were deprecated because [[#Format Strings|Format Strings]] have replaced them. So here is a list of those variables and how to achieve their results: | ||
Line 185: | Line 185: | ||
|} | |} | ||
− | == | + | == Formatzeichenketten == |
Format strings are used to display names and dates differently than those assigned under Gramps Preferences. Here is the syntax for a format string: | Format strings are used to display names and dates differently than those assigned under Gramps Preferences. Here is the syntax for a format string: | ||
Line 194: | Line 194: | ||
A format string is any text, separators or format codes (defined below) to display information about the person. | A format string is any text, separators or format codes (defined below) to display information about the person. | ||
− | === | + | === Namen formatieren === |
For names ($n $s) you may use the following formatting codes to display the name differently. | For names ($n $s) you may use the following formatting codes to display the name differently. | ||
Line 247: | Line 247: | ||
---- | ---- | ||
− | === | + | === Daten formatieren === |
For all of the date variables ($b $d $m $v) you may use the following formatting codes: | For all of the date variables ($b $d $m $v) you may use the following formatting codes: | ||
Line 312: | Line 312: | ||
---- | ---- | ||
− | === | + | === Orte formatieren === |
For all of the place variables ($B $D $M $V) you may use the following formatting codes: | For all of the place variables ($B $D $M $V) you may use the following formatting codes: | ||
Line 363: | Line 363: | ||
---- | ---- | ||
− | === | + | === Regeln für Formatzeichenketten === |
{| | {| | ||
Line 382: | Line 382: | ||
---- | ---- | ||
− | === | + | === Beispiele === |
{| | {| | ||
Line 398: | Line 398: | ||
− | == | + | == Steuer Variablen == |
Control variables allow you to print characters that are special to Substitution values within a display. | Control variables allow you to print characters that are special to Substitution values within a display. | ||
Line 447: | Line 447: | ||
− | == | + | == Gruppieren == |
There are instances where you do not want certain text to be displayed. Take the example: | There are instances where you do not want certain text to be displayed. Take the example: | ||
Line 479: | Line 479: | ||
---- | ---- | ||
− | === | + | === Regeln für Gruppen === |
A group will only display if there is at least one variable that displays something. So if a group only has text and/or variables where the information is not known, the entire group will not print. | A group will only display if there is at least one variable that displays something. So if a group only has text and/or variables where the information is not known, the entire group will not print. | ||
Line 493: | Line 493: | ||
---- | ---- | ||
− | === | + | === Beispiele: === |
This will hide '(' and ')' if the divorce information is not known (or still married). | This will hide '(' and ')' if the divorce information is not known (or still married). | ||
Line 505: | Line 505: | ||
− | == | + | == Attribute == |
Attributes do not have a format string. Instead the attribute name is placed inside []. Here is the syntax for an attribute: | Attributes do not have a format string. Instead the attribute name is placed inside []. Here is the syntax for an attribute: | ||
Line 511: | Line 511: | ||
$''<span style="background: #c0c0c0">key</span>''[attribute name] where: ''<span style="background: #c0c0c0">key</span>'' is one of the following characters: 'au' | $''<span style="background: #c0c0c0">key</span>''[attribute name] where: ''<span style="background: #c0c0c0">key</span>'' is one of the following characters: 'au' | ||
− | + | Beispiele: | |
{| | {| | ||
Line 525: | Line 525: | ||
---- | ---- | ||
− | == | + | == Ereignisse == |
Events have the same starting structure as attributes, $e or $t and the event name in [] but events have an extra format string after the name to display the description, date, place, id, and attributes associated with it. Each of these items can be displayed with a , a 'n', 'd', 'D', 'i', and 'a' respectively in the format string. Here is the syntax for an event: | Events have the same starting structure as attributes, $e or $t and the event name in [] but events have an extra format string after the name to display the description, date, place, id, and attributes associated with it. Each of these items can be displayed with a , a 'n', 'd', 'D', 'i', and 'a' respectively in the format string. Here is the syntax for an event: | ||
Line 531: | Line 531: | ||
$''<span style="background: #c0c0c0">key</span>''[attribute name](format string) where: ''<span style="background: #c0c0c0">key</span>'' is one of the following characters: 'et' | $''<span style="background: #c0c0c0">key</span>''[attribute name](format string) where: ''<span style="background: #c0c0c0">key</span>'' is one of the following characters: 'et' | ||
− | === | + | === Ereignis Formatzeichenketten === |
The Event format string is used to display information about the event. Here are the format codes to display parts of the event: | The Event format string is used to display information about the event. Here are the format codes to display parts of the event: | ||
Line 560: | Line 560: | ||
**Attribute needs to have the attribute name in [] and are formatted as above. | **Attribute needs to have the attribute name in [] and are formatted as above. | ||
− | + | Beispiele: | |
{| | {| | ||
Line 573: | Line 573: | ||
− | + | Und: | |
{| | {| | ||
Line 587: | Line 587: | ||
---- | ---- | ||
− | === | + | === Anmerkungen zu Attributen und Ereignissen: === |
{| | {| | ||
Line 598: | Line 598: | ||
|} | |} | ||
− | == | + | == Trennzeichen == |
Separators are special 'text only' groups inside '<' and '>' that conditionally display a separator (like ', ' or ' - ') between two variables, format codes or text. | Separators are special 'text only' groups inside '<' and '>' that conditionally display a separator (like ', ' or ' - ') between two variables, format codes or text. | ||
Line 609: | Line 609: | ||
# Separators at the start or end of the display line (or format strings) are removed | # Separators at the start or end of the display line (or format strings) are removed | ||
− | === | + | === Beispiele: === |
$s(f l)<, >$m(yyyy)< @ >$M< - >$v(\(yyyy\)) | $s(f l)<, >$m(yyyy)< @ >$M< - >$v(\(yyyy\)) |
Revision as of 07:11, 21 October 2011
Dieser Abschnitt beschreibt die Platzhalter die in den Verschiedenen Berichten, die in Gramps verfügbar sind verwendet werden können.
Zurück | Index | Nächste |
Spezielle Copyright Notiz: Alle Änderungen auf dieser Seite müssen unter zwei copyright Lizenzen stehen:
Diese Lizenzen ermöglichen es dem Gramps-Projekt die bestmögliche Verwendung dieses Handbuchs als freien Inhalt in zukünftigen Gramps Versionen. Wenn du mit dieser dual Lizenzierung nicht einverstanden bist, bearbeite diese Seite nicht. Du darfst zu anderen Seiten des Wiki die nur unter die GFDL Lizenz fallen nur über externe Links (verwende die Syntax: [http://www.gramps-project.org/...]), nicht über interne Links verlinken. |
Sprachen: |
English • Deutsch • Nederlands |
Zurück zu Übersicht der Berichte.
Contents
Werte ersetzen
Many of the graphical reports allow you to customize the information that is displayed on the reports. Variable substitution is the method that is used to substitute a particular symbol (key) for specific information about the person in the database.
Beispiele: | Wird gezeigt als: (die Person lebt) |
$n b. $b $B d. $d $D |
Smith, Edwin Michael b. 1961-05-24 San Jose, Santa Clara Co., CA d. |
Die Platzhalter
Personal variables | Marital variables | ||
$n | Displays the person's name | $s | Displays the name of the person's spouse |
$i | Displays the GRAMPS ID for the person. | $j | Displays the GRAMPS ID for the marriage. |
$b | Displays the person's date of birth | $m | Displays the marriage date of the person and the spouse. |
$B | Displays the person's place of birth | $M | Displays the place of the marriage of the person and the spouse. |
$d | Displays the person's date of death | $v | Displays the divorce date of the person and the spouse. |
$D | Displays the person's place of death | $V | Displays the place of the divorce of the person and the spouse. |
$a | Displays an attribute about the person.
see Attributes for more |
$u | Displays an attribute about the marriage.
see Attributes for more |
$e | Displays event information about the person.
See Events for more |
$t | Displays an event information about the marriage.
See Events for more |
All of the Marital variables are defined by the person's preferred spouse in Gramps. If the person has never been married, then these variables will not display anything.
Standardanzeigeformate
$n $s | Names will be displayed as set in 'Name format:' on the Display tab in Gramps preferences |
$B $D $M $V | Places will display the Place title by default |
$b $d $m $v | Dates will be displayed as set in 'Date format:' on the Display tab in Gramps preferences |
$e $t | Events will display the description by default |
1 | If you wish to display names, date, or place information differently, you may use Format Strings to accomplish this. |
2 | There are also Control Variables to display special characters (like the dollar sign). |
3 | You can also use Grouping to optionally display information or whole lines |
4 | Along with Events you can print almost anything. |
5 | Finally, Separators, to make your life complete. |
Veraltete Variablen
Some of the old variables were deprecated because Format Strings have replaced them. So here is a list of those variables and how to achieve their results:
old Variable | how to display it now | What is displayed |
$f | $n | Name - as by Gramps name display under Preferences |
$n | $n(g f) | Name - FirstName LastName |
$N | $n(f, g) | Name - LastName, FirstName (note the explicit comma) |
$nC | $n(g F) | Name - FirstName LastName in UPPER case |
$NC | $n(F, g) | Name - LastName in UPPER case, FirstName |
$by | $b(yyyy) | Date of birth, year only |
$dy | $d(yyyy) | Date of death, year only |
$my | $m(yyyy) | Date of preferred marriage, year only |
$p | $s | Preferred spouse's name as by Gramps name display under Preferences |
$s | $s(g f) | Preferred spouse's name - FirstName LastName |
$S | $s(f, g) | Preferred spouse's name - LastName, FirstName |
$sC | $s(g F) | Preferred spouse's name - FirstName LastName in UPPER case |
$SC | $s(F, g) | Preferred spouse's name - LastName in UPPER case, FirstName |
Formatzeichenketten
Format strings are used to display names and dates differently than those assigned under Gramps Preferences. Here is the syntax for a format string:
$key(format string)
where: key is one of the following characters: 'nsijbmBMdvDVauet'
A format string is any text, separators or format codes (defined below) to display information about the person.
Namen formatieren
For names ($n $s) you may use the following formatting codes to display the name differently.
t | Title | f | Given name | |
x | Common name. Call name if existing, otherwise first first name | c | Call name | |
n | Nick name | s | Suffix | |
l | Surname | g | Family nickname |
These codes can be uppercased to uppercase the result.
Example code | Displays |
$n(L, f) ($n(c)), $n(L, f){ ($n(c))} $s(f l s) |
SMITH, Edwin Michael (), SMITH, Edwin Michael Janice Ann Adams |
Note: If you want to print a character 'c' within the format string (or any one of the other format codes), you will need to first add a '\' in front of it. See Control Variables for more.
Note: the curly brackets { } are used to hide information. Here it is used around ' ($n(c))' to not display ' ()' if the person does not have a call name. See Grouping for more.
Daten formatieren
For all of the date variables ($b $d $m $v) you may use the following formatting codes:
yyyy | The year as a four digit number | yyy | The year, with a minimum of three digits | |
yy | The year, from 00 to 99 | y | The year, from 0 to 99 | |
mmmm MMMM |
The full name of the month The full name IN CAPS |
mmm MMM |
The abbreviated name of the month The abbreviated name IN CAPS | |
mm | The month, from 00 to 12 | m | The month, from 0 to 12 | |
dd | The day, from 00 to 31 | d | The day, from 0 to 31 | |
o | The date type (modifier) |
Example code | displays |
$b(mmm-dd yy) $m(yyyy/mmm/d) $b(mmm-dd yy) |
May-24 61 1995/May/27 Jun-04 85 |
Orte formatieren
For all of the place variables ($B $D $M $V) you may use the following formatting codes:
e | Street | l | Locality | |
c | City | u | County | |
s | State | p | Postal Code | |
n | Country | t | Title | |
x | Longitude | y | Latitude |
These codes can be uppercased to uppercase the result.
Example code | displays |
$B $B(c, s, N) |
St Judes Hospital Carmel, IN, USA |
Regeln für Formatzeichenketten
1 | Anything will print inside a format string |
1a | you will have to use Control Variables to display things like ')' and format codes |
2 | Separators can be within format strings. |
3 | At least ONE format code has to display something for the ENTIRE format string to display |
Beispiele
code | gives |
$n(f l) b. $b {at $B {d. $d $D |
Edwin Michael Smith b. 1961-05-24 at San Jose, Santa Clara Co., CAThe person is still alive (or has no information present) so the line was removed. |
Steuer Variablen
Control variables allow you to print characters that are special to Substitution values within a display.
For example the dollar character '$' is used to note the start of a variable. If you wish to print a dollar character you would use a control character like '\$'
Control Variables
\$ | Displays a single '$' | \\ | Displays a single '\' | |
\( | Displays a single '(' | \) | Displays a single ')' | |
\{ | Displays a single '{' | \} | Displays a single '}' |
Basically anything that comes after a '\' will be printed.
Note: When you are inside a format string, you may need to use this to display a character that would normally be a format code.
Example: | would give |
$b(m hi mom) $b(m hi \mo\m) |
5 hi 5o5 5 hi mom |
as this person was born on the fifth month.
Gruppieren
There are instances where you do not want certain text to be displayed. Take the example:
Code | Only date is known | Only place is known |
died on $d at $D |
died on 1975-06-26 at |
died on at Reno, Washoe Co., NV |
Neither of these are very acceptable. | ||
But with groups (denoted by {}), you can optionally print information if a variable within contains information. | ||
For example: | ||
Code | Only date is known | Only place is known |
died {on $d }{at $D} |
died on 1975-06-26 |
died at Reno, Washoe Co., NV |
which is what we want.
Regeln für Gruppen
A group will only display if there is at least one variable that displays something. So if a group only has text and/or variables where the information is not known, the entire group will not print.
Groups can also be nested. If this happens (like below), the outer group will only display if there is at least one variable that displays something within the outer group or any of the sub groups.
Groups can also be used to remove an entire line from a display. A '{' at the start of a line will remove the entire line from the display if the above rule is true.
If you do not wish to have the display code above (for death information) displayed (the person is alive, or you do not yet know the information), modify the code to look like
{died {on $d }{at $D}
To have an entire line be blank instead of removing the line simply start the line with a space ' {' or make sure there is a space after the group (you will have to close the group first)
Beispiele:
This will hide '(' and ')' if the divorce information is not known (or still married).
m. $m $M {- ($v(yyyy))
Only display some spouse information if married or remove the entire line if never married:
{$s $m(yyyy) {- $v(\(yyyy\))}}
Attribute
Attributes do not have a format string. Instead the attribute name is placed inside []. Here is the syntax for an attribute:
$key[attribute name] where: key is one of the following characters: 'au'
Beispiele:
$a[Profession] $a[Social Security Number] $a[Total \$ bequeathed] |
Programmer 7A3-29-F1C6 3.00USD |
Ereignisse
Events have the same starting structure as attributes, $e or $t and the event name in [] but events have an extra format string after the name to display the description, date, place, id, and attributes associated with it. Each of these items can be displayed with a , a 'n', 'd', 'D', 'i', and 'a' respectively in the format string. Here is the syntax for an event:
$key[attribute name](format string) where: key is one of the following characters: 'et'
Ereignis Formatzeichenketten
The Event format string is used to display information about the event. Here are the format codes to display parts of the event:
n | Description | i | Event ID | |
d | Event Date* | D | Event Place* | |
a | An attributes for the event** |
*These variables can themselves have format strings. Date and a place can be formatted with format string as defined in Format strings.
**Attribute needs to have the attribute name in [] and are formatted as above.
Beispiele:
$e[First Communion](d(yyyy-mm-d)) $e[Bar Mitzvah](n< at > D) $e[Birth](d(yyyy mm/dd) D) |
2009-11-6 Jerry's Bar Mitzah at Opas house 2007 05/23 Grandmothers house |
Und:
$b(yyyy-Mmm-dd) $M |
is the same as | $e[Birth](d(yyyy-Mmm-dd)) $t[Marriage](D) |
Anmerkungen zu Attributen und Ereignissen:
1 | Attribute and event names are mandatory. '$a' or '$a[]' will not display anything. |
2 | Attributes and event names may have special characters within them. Most notably ']' and ')'. If this is the case, you will need to use Control Variables |
Trennzeichen
Separators are special 'text only' groups inside '<' and '>' that conditionally display a separator (like ', ' or ' - ') between two variables, format codes or text.
Separators are displayed conditionally depending on these rules:
- A variable that does not display anything will remove itself and a separator that is to the left of it from the display line only.
- If there is not a separator to the left, the same variable will remove itself and a separator that is to the right of it from the displayed line.
- If there are two separators together, the left one will be removed from the display line and the right is kept.
- Separators at the start or end of the display line (or format strings) are removed
Beispiele:
$s(f l)<, >$m(yyyy)< @ >$M< - >$v(\(yyyy\))
Here are some things that may happen:
If none of the variables are known | None of the separators will display |
If only one variable is known | Only that variable will print. No separators will print. |
If only the spouse's name is not known | The first separator will not display |
If only the marriage date is not known | The first separator does not display. We will be left with:
Jane Doe< - >{ … }And only the divorce date needs to be known to print the second separator. |
If only the divorce date is not known | the second separator will not display |
Separators can be inside format strings:
$n(<0>T< >L<, >f< >s)
Unlike groups, separators can not cross over/out of format strings. So the separator <0> will NEVER display. No matter what is on the left hand side of the variable.
Zurück zu Index der Berichte.
Zurück | Index | Nächste |
Sprachen: |
English • Deutsch • Nederlands |