De:Gramps 3.3 Wiki Handbuch - Berichte - Teil 2

From Gramps
Revision as of 13:40, 2 November 2011 by Leonhaeuser (talk | contribs) (Die Platzhalter)
Jump to: navigation, search

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


Gnome-important.png 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.
Außerdem verwende nur die Bekannten Drucktechnische Konventionen


Zurück zur Übersicht der Berichte.

Werte ersetzen

Viele der grafischen Berichte erlauben dir die Informationen, die im Bericht angezeigt werden, anzupassen. Variable Substitution ist die Methode, die verwendet wird, um ein bestimmtes Symbol (Schlüssel) für bestimmte Informationen über die Person aus der Datenbank zu ersetzen.

Beispiele: Wird gezeigt als: (die Person lebt)
$n
* $b $B
† $d $D
Smith, Edwin Michael
* 1961-05-24 San Jose, Santa Clara Co., CA
†

Die Platzhalter

Persönliche Variablen Ehevariablen
$n Zeigt den Namen der Person. $s Zeigt den Namen des/der Partner(in) der Person.
$i Zeigt die Gramps ID der Person. $j Zeigt die Gramps ID für die Hochzeit.
$b Zeigt das Geburtsdatum der Person. $m Zeigt das Hochzeitsdatum der Person und deren Partner(in).
$B Zeigt den Geburtsort der Person. $M Zeigt den Hochzeitsort der Person und deren Partner(in).
$d Zeigt das Todesdatum der Person. $v Zeigt das Scheidungsdatum der Person und deren Partner(in).
$D Zeigt den Sterbeort der Person. $V Zeigt den Scheidungsort der Person und deren Partner(in).
$a Zeigt ein Attribut der Person.

Siehe Attribute für mehr Details

$u Zeigt ein Attribut der Heirat.

Siehe Attribute für mehr Details

$e Zeigt Ereignis Informationen der Person.

Siehe Ereignisse für mehr Details

$t Zeigt Ereignisinformationen der Hochzeit.

Siehe Ereignisse für mehr Details

Alle Ehevariablen durch den in Gramps bevorzugten Partner der Person bestimmt. Wenn diese Person nie eine Partnerschaft hatte, dann zeigen diese Variablen gar nichts.


Standardanzeigeformate

$n $s Namen werden wie im 'Namensformat:' in den Gramps Präferenzen im Anzeigereiter eingestellt angezeigt.
$B $D $M $V Orte zeigen standardmäßig den Ortstitel.
$b $d $m $v Daten werden wie im 'Datumsformat:' in den Gramps Präferenzen im Anzeigereiter eingestellt angezeigt.
$e $t Ereignisse zeigen standardmäßig die Beschreibung.

1 Wenn du Namen, Daten oder Orte anders angezeigt haben willst, kannst du Formatzeichenketten verwenden um dies zu erreichen.
2 Es gibt auch Steuervariablen um spezielle Zeichen z.B. das Dollarzeichen darzustellen.
3 Du kannst auch Gruppieren verwenden um Informationen oder ganze Zeilen optional anzuzeigen.
4 Zusammen mit Ereignissen kannst du nahezu alles ausgeben.
5 Zum Schluss Trennzeichen um ihr Leben zu vervollständigen.

Veraltete Variablen

Einige alte Variablen sind veraltet weil sie durch Formatzeichenketten ersetzt wurden. Hier ist eine Liste dieser Variablen und wie man ihre Ergebnisse erreicht:

alte Variable wie es jetzt angezeigt wird Was angezeigt wird
$f $n Name - wie bei Gramps in den Präferenzen festgelegt.
$n $n(g f) Name - Vorname Nachname
$N $n(f, g) Name - Nachname, Vorname (beachte das explizite Komma).
$nC $n(g F) Name - Vorname NACHNAME in Großbuchstaben
$NC $n(F, g) Name - NACHNAME in Großbuchstaben, Vorname
$by $b(yyyy) Datum der Geburt, nur das Jahr
$dy $d(yyyy) Todesdatum, nur das Jahr
$my $m(yyyy) Heiratsdatum der bevorzugten Ehe, nur das Jahr
$p $s Name des Partners anzeigen wie in Gramps unter Präferenzen angegeben.
$s $s(g f) Name des bevorzugten Partner- Vorname Nachname
$S $s(f, g) Name des bevorzugten Partner - Nachname, Vorname
$sC $s(g F) Name des bevorzugten Partner - Vorname NACHNAME in Großbuchstaben
$SC $s(F, g) Name des bevorzugten Partner - NACHNAME in Großbuchstaben, Vorname

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
Gramps-notes.png
For date types (modifier)

Only "Before", "After", and "About" are supported at this time. all others will not display anything.
And for date span and date ranges, only the starting (first) date is displayed.


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., CA
The 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:

  1. 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.
  2. 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.
  3. If there are two separators together, the left one will be removed from the display line and the right is kept.
  4. 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


Trennzeichen können sich innerhalb von Formatierungszeichenketten befinden:

$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 zur Übersicht der Berichte.

Zurück Index Nächste