16,602
edits
Changes
m
Some of the old variables were deprecated because Einige alte Variablen sind veraltet weil sie durch [[#Format StringsFormatzeichenketten|Format StringsFormatzeichenketten]] have replaced themersetzt wurden. So here is a list of those variables and how to achieve their resultsHier ist eine Liste dieser Variablen und wie man ihre Ergebnisse erreicht:
Format strings are used to display names and dates differently than those assigned under Formatzeichenketten werden verwendet, um Namen und Daten anders darzustellen als es in den Gramps PreferencesPräferenzen festgelegt ist. Here is the syntax for a format stringHier ist die Syntax für eine Formatzeichenkette:
A format string is any textEine Formatzeichenkette ist ein beliebiger Text, separators or format codes Trennzeichen oder Formatschlüssel (defined belowFestlegung weiter unten) to display information about the personum Informationen über die Person anzuzeigen.
For names Für Namen ($n $s) you may use the following formatting codes to display the name differentlykannst du folgende Formatschlüssel verwenden um den Namen verschieden darzustellen.
These codes can be uppercased to uppercase the resultDiese Schlüssel können GROSS geschrieben werden um das Ergebnis in GROSSBUCHSTABEN zu erhalten.
<blockquote>Note:If you want to print a character {{man note|Hinweis|Wenn du einen Buchstaben 'c' within the format string in deiner Formatzeichenkette ausgeben willst (or any one of the other format codesoder jeden anderen Formatschlüssel), you will need to first add a musst du erst ein '\\' in front of itdavor setzen. See Siehe [[#Control VariablesSteuervariablen |Control VariablesSteuervariablen]] for morefür mehr Details.</blockquote>}}
<blockquote>Note:the curly brackets {{man note|Hinweis|Die geschweiften Klammern { } are used to hide informationdienen dazu Informationen zu verstecken. Here it is used around Hier wird es um ' ($n(c))' to not display verwendet um ' ()' if the person does not have a call namenicht anzuzeigen, wenn die Person keinen Rufnamen besitzt. See Siehe [[#GroupingGruppieren|GroupingGruppieren]] for morefür mehr Details.</blockquote>}}
For all of the date variables Für alle Datumsvariablen ($b $d $m $v) you may use the following formatting codeskannst du die folgenden Formatschlüssel verwenden:
For all of the place variables Für alle Ortsvariablen ($B $D $M $V) you may use the following formatting codeskannst du die folgenden Formatschlüssel verwenden:
These codes can be uppercased to uppercase the resultDiese Schlüssel können GROSS geschrieben werden um das Ergebnis in GROSSBUCHSTABEN zu erhalten.
== Steuer Variablen ==Zum Beispiel wird das Dollarzeichen '$' verwendet, um den Beginn einer Variable zu markieren. Wenn du ein Dollarzeichen ausgeben willst würdest du ein Steuerzeichen wie '\$' verwenden.
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 VariablesSteuervariablen
Basically anything that comes after a Grundsätzlich wird alles was direkt nach einem '\' will be printedfolgt ausgegeben.
Note:{{man note|Hinweis|When you are inside a format stringWenn du dich in einer Formatzeichenkette befindest, you may need to use this to display a character that would normally be a format codekann es sein, das du den '\' benötigst, um ein Zeichen auszugeben, welches normalerweise ein Formatschlüssel ist. }}
as this person was born on the fifth monthda diese Person im fünften Monat geboren wurde.
There are instances where you do not want certain text to be displayedEs gibt Umstände, in denen du nicht willst, das bestimmter Text angezeigt wird. Take the exampleNimm das Beispiel:
which is what we wantwas ist was wir wollen.
A group will only display if there is at least one variable that displays somethingEine Gruppe wird nur angezeigt, wenn sie mindestens eine Variable enthält, die etwas anzeigt. So if a group only has text andWenn eine Gruppe nur Text und/or variables where the information is not knownoder Variablen mit unbekannten Informationen enthält, the entire group will not printwird die komplette Gruppe nicht ausgegeben.
Groups can also be nestedGruppen können auch verschachtelt werden. If this happens Wenn dies passiert (like belowwie unten), 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 groupswird die äußere Gruppe nur angezeigt, wenn es mindestens eine Variable, die etwas anzeigt, in der äußeren oder einer der Untergruppen vorhanden ist.
Groups can also be used to remove an entire line from a displayGruppen können auch verwendet werden, um eine komplette Zeile aus einer Anzeige zu entfernen. A Eine '{' at the start of a line will remove the entire line from the display if the above rule is trueam Beginn der Zeile entfernt die gesamte Zeile von der Ausgabe, wenn die obere Regel wahr ist.
If you do not wish to have the display code above Wenn du nicht den Anzeigeschlüssel von oben (for death informationfür Todesinformationen) displayed angezeigt haben möchtest (the person is alivedie Person lebt oder du kennst die Informationen noch nicht), or you do not yet know the information)ändere den Schlüssel, modify the code to look likedas er wie folgt aussieht<pre>{died starb {on am $d }{at in $D}</pre>
<blockquote>To have an entire line be blank instead of removing the line simply start the line with a space {{man note|Bei fehlenden Informationen eine Leerzeile ausgeben|Um eine leere Zeile zu erhalten anstatt sie komplett zu entfernen, beginne sie mit einem Leerzeichen ' {' or make sure there is a space after the group oder stelle sicher, das sich ein Leerzeichen nach der Gruppe befindet (you will have to close the group firstdu musst erst die Gruppe schließen)</blockquote>}}
This will hide Dies versteckt '(' and und ')' if the divorce information is not known wenn die Scheidungsinformationen nicht bekannt sind (or still marriedoder noch verheiratet).
Only display some spouse information if married or remove the entire line if never marriedZeig nur ein paar Partnerinformationen wenn verheiratet oder entferne die komplette Zeile wenn nie verheiratet:
Attributes do not have a format stringAttribute haben keine Formatzeichenkette. Instead the attribute name is placed inside Stattdessen wird der Name des Attribut in []gesetzt. Here is the syntax for an attributeHier die Syntax für ein Attribut:
Events have the same starting structure as attributes, Ereignisse haben die selbe Struktur am Start wie Attribute $e or oder $t and the event name und der Ereignisname in [] but events have an aber Ereignisse haben eine extra format string after the name to display the descriptionFormatzeichenkette nach dem Namen um die Beschreibung, dateDatum, placeOrt, id, and attributes associated with itID und Attribute die mit ihnen verbunden sind anzuzeigen. Each of these items can be displayed with a , a Jedes dieser beiden kann mit einem 'n', 'd', 'D', 'i', and und 'a' respectively in the format stringder Formatzeichenkette dargestellt werden. Here is the syntax for an eventHier ist die Syntax für ein Ereignis:
The Event format string is used to display information about the eventDie Ereignisformatzeichenkette wird verwendet, um Informationen über das Ereignis anzuzeigen. Here are the format codes to display parts of the eventHier die Formatschlüsse zum am Teile des Ereignis anzuzeigen:
Separators are special Trennzeichen sind spezielle 'text onlynur Text' groups inside Gruppen innerhalb von '<' and und '>' that conditionally display a separator die bedingte Trennzeichen (like wie ', ' or oder ' - ') between two variableszwischen zwei Variablen, format codes or textFormatschlüsseln oder Text anzuzeigen.
Separators are displayed conditionally depending on these rulesTrennzeichen werden bedingt abhängig von diesen Regeln angezeigt:
Here are some things that may happenHier einige Dinge, die passieren können:
Unlike groups, separators can not cross overAnders als Gruppen können Trennzeichen nicht über/out of format stringsaus Formatzeichenketten gehen. So the separator Also wird das Trennzeichen <0> will NEVER displayNIE angezeigt. No matter what is on the left hand side of the variableEgal was sich links oder in der Variable befindet.
[[Category:Plugins]]
no edit summary
|3
|Du kannst auch [[#Gruppieren|Gruppieren]] verwenden um Informationen oder ganze Zeilen optional anzuzeigen.
|-
|4
|Zusammen mit [[#Ereignissen|Ereignissen]] kannst du nahezu alles ausgeben.
|-
|5
|Zum Schluß Schluss [[#Trennzeichen|Trennzeichen]] um ihr Leben zu vervollständigen.
|-
|}
=== Veraltete Variablen ===
{|{{prettytable}}
|-
!old alte Variable!how to display it nowwie es jetzt angezeigt wird!What is displayedWas angezeigt wird
|-
|$f
|$n
|Name - as by wie bei Gramps name display under Preferencesin den Präferenzen festgelegt.
|-
|$n
|$n(g f)
|Name - FirstName LastNameVorname Nachname
|-
|$N
|$n(f, g)
|Name - LastNameNachname, FirstName Vorname (note the explicit commabeachte das explizite Komma).
|-
|$nC
|$n(g F)
|Name - FirstName LastName Vorname NACHNAME in UPPER caseGroßbuchstaben
|-
|$NC
|$n(F, g)
|Name - LastName NACHNAME in UPPER caseGroßbuchstaben, FirstNameVorname
|-
|$by
|$b(yyyy)
|Date of birthDatum der Geburt, year onlynur das Jahr
|-
|$dy
|$d(yyyy)
|Date of deathTodesdatum, year onlynur das Jahr
|-
|$my
|$m(yyyy)
|Date of preferred marriageHeiratsdatum der bevorzugten Ehe, year onlynur das Jahr
|-
|$p
|$s
|Preferred spouse's name as by Name des Partners anzeigen wie in Gramps name display under Preferencesunter Präferenzen angegeben.
|-
|$s
|$s(g f)
|Preferred spouse's name Name des bevorzugten Partner- FirstName LastNameVorname Nachname
|-
|$S
|$s(f, g)
|Preferred spouse's name Name des bevorzugten Partner - LastNameNachname, FirstNameVorname
|-
|$sC
|$s(g F)
|Preferred spouse's name Name des bevorzugten Partner - FirstName LastName Vorname NACHNAME in UPPER caseGroßbuchstaben
|-
|$SC
|$s(F, g)
|Preferred spouse's name Name des bevorzugten Partner - LastName NACHNAME in UPPER caseGroßbuchstaben, FirstNameVorname
|}
== Formatzeichenketten ==
$''<span style="background: #c0c0c0">keySchlüssel</span>''(format stringFormatzeichenkette) wherewobei: ''<span style="background: #c0c0c0">keySchlüssel</span>'' is one of the following characterseins der folgenden Zeichen ist: 'nsijbmBMdvDVauet'
=== Namen formatieren ===
{|
|-
|t
|TitleTitel
|
|f
|Given nameVorname
|-
|x
|Common nameGebräuchliche Name. Wenn vorhanden Rufname sonnst erste Vorname. Call name if existing, otherwise first first name
|
|c
|Call nameRufname
|-
|n
|Nick nameSpitzname
|
|s
|-
|l
|SurnameNachname
|
|g
|Family nicknameFamilienspitzname
|}
{|
|-
|Example codeBeispiel Schlüssel|DisplaysZeigt
|-
|<pre>$n(L, f) ($n(c)), $n(L, f){ ($n(c))}
----
=== Daten formatieren ===
{|
|-
|yyyy
|The year as a four digit numberDas Jahr als vierstellige Zahl
|
|yyy
|The year, with a minimum of three digitsDas Jahr mit mindestens drei Stellen
|-
|yy
|The year, from Das Jahr von 00 to bis 99
|
|y
|The year, from Das Jahr von 0 to bis 99
|-
|mmmm<BR>
MMMM
|The full name of the monthDer komplette Name des Monats<BR>The full name IN CAPSDer komplette Name des Monats in GROSSBUCHSTABEN
|
|mmm<BR>
MMM
|The abbreviated name of the monthDer verkürzte Name des Monats<BR>The abbreviated name IN CAPSDer verkürzte Name des Monats in GROSSBUCHSTABEN
|-
|mm
|The month, from Der Monat von 00 to 12bis 11
|
|m
|The month, from Der Monat von 0 to bis 12
|-
|dd
|The day, from Der Tag von 00 to bis 31
|
|d
|The day, from Der Tag von 0 to bis 31
|-
|o
|The date type Der Datumstyp (modifierBestimmung)
|
|
{|
|-
|Example codeBeispiel Schlüssel|displayszeigt
|-
|<pre>$b(mmm-dd yy)
|}
{{man note| For date types Für Datumstypen (modifierBestimmung) |Only Nur "Beforevor", "Afternach", and und "Aboutum" are supported at this timewird zur Zeit unterstützt. all others will not display anythingalles andere zeigt nichts an.<BR>And for date span and date ranges, only the starting Und für Zeitspannen und Zeiträume wird nur das Startdatum (firsterste) date is displayedangezeigt.}}
----
=== Orte formatieren ===
{|
|-
|e
|StreetStraße
|
|l
|LocalityLokalität
|-
|c
|CityOrt
|
|u
|CountyKreis
|-
|s
|StateBundesland
|
|p
|Postal CodePostleitzahl
|-
|n
|CountryLand
|
|t
|TitleTitel
|-
|x
|LongitudeLängengrad
|
|y
|LatitudeBreitengrad
|}
{|
|-
|Example codeBeispiel Schlüssel|displayszeigt
|-
|<pre>$B
|-
|1
|Anything will print inside a format stringAlles innerhalb einer Formatzeichenkette wird ausgegeben.
|-
|1a
|you will have to use Du musst [[#Control VariablesSteuervariablen|Control VariablesSteuervariablen]] to display things like verwenden um Sachen wie ')' and format codesund Formatschlüssel anzuzeigen.
|-
|2
|Separators can be within format stringsTrennzeichen können sich innerhalb von Formatzeichenketten befinden.
|-
|3
|At least ONE format code has to display something for the ENTIRE format string to displayMindestens EIN Formatschlüssel muss etwas anzeigen damit die gesamte Formatzeichenkette dargestellt wird.
|}
{|
|-
|codeSchlüssel|givesergibt
|-
|<pre>$n(f l)
b. $b {at $B}{d. $d $D}</pre>
|<pre>Edwin Michael Smith
b. 1961-05-24 at San Jose, Santa Clara Co., CA</pre>The person is still alive Die Person lebt (or has no information presentoder es waren keine Informationen verfügbar) so the line was removedalso wurde die Zeile entfernt.
|}
== Steuervariablen ==
Steuervariablen ermöglichen dir Zeichen auszugeben, die in der Ausgabe eine Ersetzungsfunktion haben.
{|
|-
|\$
|Displays a single Zeigt ein einzelnes '$'
|
|\\
|Displays a single Zeigt einen einzelnen '\'
|-
|\(
|Displays a single Zeigt eine einzelne '('
|
|\)
|Displays a single Zeigt eine einzelne ')'
|-
|\{
|Displays a single Zeigt eine einzelne '{'
|
|\}
|Displays a single Zeigt eine einzelne '}'|-|\<|Zeigt eine einzelnes '<'||\>|Zeigt eine einzelnes '>'
|}
----
{|
|-
|ExampleBeispiele:|would giveergibt
|-
|<pre>$b(m hi mom)
|}
== Gruppieren ==
{|
|-
|CodeSchlüssel|Only date is knownNur Datum ist bekannt|Only place is knownNur Ort ist bekannt
|-
|<pre>died on starb am $d at in $D</pre>|<pre>died on starb am 1975-06-26 at in </pre> |<pre>died on at starb am in Reno, Washoe Co., NV</pre>
|-
| colspan="3"|Neither of these are very acceptableKeine von ihnen ist sehr akzeptabel.
|-
| colspan="3"|But with groups Aber mit Gruppen (denoted by gekennzeichnet durch {})kannst du Informationen optional ausgeben, you can optionally print information if a variable within contains informationwenn die Variable innerhalb Daten enthält.
|-
| colspan="3"|For exampleZum Beispiel:
|-
|CodeSchlüssel|Only date is knownNur Datum ist bekannt|Only place is knownNur Ort ist bekannt
|-
|<pre>died starb {on am $d }{at in $D}</pre>|<pre>died on starb am 1975-06-26</pre>|<pre>died at starb in Reno, Washoe Co., NV</pre>
|}
----
=== Regeln für Gruppen ===
----
=== Beispiele: ===
<pre>m. $m $M {- ($v(yyyy))</pre>
<pre>{$s $m(yyyy) {- $v(\(yyyy\))}}</pre>
== Attribute ==
$''<span style="background: #c0c0c0">keySchlüssel</span>''[attribute nameAttributname] wherewobei: ''<span style="background: #c0c0c0">keySchlüssel</span>'' is one of the following characterseines der folgenden Zeichen ist: 'au'
Beispiele:
{|
|-
|<pre>$a[ProfessionBeruf]
$a[Social Security Number]
$a[Total Gesamt \$ bequeathedhinterlassen]</pre>|<pre>ProgrammerProgrammierer
7A3-29-F1C6
3.00USD</pre>
----
== Ereignisse ==
$''<span style="background: #c0c0c0">keySchlüssel</span>''[attribute nameAttributname](format stringFormatzeichenkette) wherewobei: ''<span style="background: #c0c0c0">keySchlüssel</span>'' is one of the following characterseines der folgenden Zeichen ist: 'et'
=== Ereignis Formatzeichenketten ===
{|
|-
|n
|DescriptionBeschreibung
|
|i
|Event Ereignis ID
|-
|d
|Event DateEreignis Datum*
|
|D
|Event PlaceEreignis Ort*
|-
|a
|An attributes for the eventEin Attribut für ein Ereignis**
|
|
|}
*These variables can themselves have format stringsDiese Variablen können selbst Formatzeichenketten enthalten. Date and a place can be formatted with format string as defined Datum und Ort können wie in [[#Format stringsFormatzeichenketten|Format stringsFormatzeichenketten]]beschrieben formatiert werden.
**Attribute needs to have the attribute name benötigen den Attributnamen in [] and are formatted as aboveund sind wie oben formatiert.
Beispiele:
|-
|<pre>$e[First Communion](d(yyyy-mm-d))
$e[Bar Mitzvah](n< at in > D)$e[BirthGeburt](d(yyyy mm/dd) D)</pre>
|<pre>2009-11-6
Jerry's Bar Mitzah at in Opas house
2007 05/23 Grandmothers house</pre>
|}
|<pre>$b(yyyy-Mmm-dd)
$M</pre>
|is the same asist das gleiche wie|<pre>$e[BirthGeburt](d(yyyy-Mmm-dd))$t[MarriageHochzeit](D)</pre>
|}
|-
|1
|Attribute and event names are mandatoryAttribut- und Ereignisnamen sind obligatorisch. '$a' or oder '$a[]' will not display anythingzeigen gar nichts.
|-
|2
|Attributes and event names may have special characters within themAttribut- und Ereignisnamen können Sonderzeichen enthalten. Most notably Vor allem ']' and und ')'. If this is the caseWenn dies der Fall ist, you will need to use musst du [[#Control VariablesSteuervariablen|Control VariablesSteuervariablen]]verwenden.
|}
== Trennzeichen ==
# A variable that does Eine Variable die '''notnichts''' display anything will remove itself and a separator that is to the left of it from the display line onlyanzeigt, entfernt nur sich selbst und ein Trennzeichen links von ihr aus der Anzeigezeile.# If there is not a separator to the leftWenn sich kein Trennzeichen links von ihr befindet, the same variable will remove itself and a separator that is to the right of it from the displayed lineentfernt die selbe Variable sich selbst und ein Trennzeichen rechts von sich aus der angezeigten Zeile. # If there are two separators togetherWenn es zwei Trennzeichen zusammen gibt, the left one will be removed from the display line and the right is keptwird das linke entfernt und das rechte in der Anzeigezeile beibehalten.# Separators at the start or end of the display line Trennzeichen am Beginn oder Ende der Anzeigezeile (or format stringsoder Formatzeichenkette) are removedwerden entfernt.
=== Beispiele: ===
$s(f l)<, >$m(yyyy)< @ >$M< - >$v(\(yyyy\))
{|
|-
|If Wenn '''nonekeine''' of the variables are knownder Variablen bekannt ist|None of the separators will displayKeines der Trennzeichen wird angezeigt.
|-
|If only one variable Wenn nur eine Variable bekannt '''isist''' known|Only that variable will printNur die Variable wird ausgegeben. No separators will printEs werden keine Trennzeichen ausgegeben.
|-
|If only the spouseWenn nur der Partnername 's name ''nicht bekannt'is not''' knownist|The first separator will not displayDas Erste Trennzeichen wird nicht angezeigt
|-
|If only the marriage date Wenn nur das Hochzeitsdatum '''is notnicht bekannt''' knownist|The first separator does not displayDas erste Trennzeichen wird nicht angezeigt. We will be left withEs bleibt übrig::Jane DoeLischen Müller< - >{ … }And only the divorce date needs to be known to print the second separatorUnd nur das Scheidungsdatum wird benötigt, um das zweite Trennzeichen auszugeben.
|-
|If only the divorce date Wenn nur das Scheidungsdatum '''is notnicht bekannt''' knownist|the second separator will not displayDas zweite Trennzeichen wird nicht angezeigt
|}
$n(<0>T< >L<, >f< >s)
{{-}}
[[Category:De:Documentation]]
