Changes

Jump to: navigation, search

Gramps 3.3 Wiki Manual - Valeurs de substitution

1,476 bytes added, 10:11, 16 March 2012
m
no edit summary
Ces sections décrivent les différents rapports valeurs de substitution disponibles dans GRAMPS.
{{grampsmanualcopyright/fr}}
{{man index/fr|Gramps 3.3 Wiki Manual - Reports/fr|Gramps 3.3 Wiki Manual - Reports/fr|3.3}}
{{languages|Gramps_3.3_Wiki_Manual 3_Wiki_Manual_- Reports_Reports - part 2}}
La plupart des rapports graphiques vous permettent de personnaliser les informations à l'affichage. Les variables de substitution sont représentées par des symboles particuliers (clés) pour des informations spécifiques sur l'individu dans la base de données.
|-
|$n $s
|Names will be displayed as set in Les noms seront affichés selon le 'Name format:du nom' on the Display tab in , défini dans les Préférences de Gramps preferences, sous Affichage.
|-
|$B $D $M $V
|Places will display the Place title by defaultLes lieux affichent le titre du lieu.
|-
|$b $d $m $v
|Dates will be displayed as set in Les dates seront affichées selon le 'Date format:de date' on the Display tab in , défini dans les Préférences de Gramps preferences, sous Affichage.
|-
|$e $t
|Events will display the Les événements affichent la description by defaultpar défaut.
|}
{{man tip||-|1Chaînes|If you wish to display namesSi vous souhaitez afficher les noms, la date, or place ou l'information differentlysur le lieu différemment, you may use vous devriez plutôt utiliser les [[#Chaînes|Chaîneschaînes]] to accomplish this.}}{{man tip|-Variables de contrôle|2|There are also Il y a aussi des [[#Variables de contrôle|Variables variables de contrôle]] to display special characters pour afficher des caractères spéciaux (like the tel que le signe dollar sign).}}{{man tip|-|3Regroupement|You can also use Vous pouvez également utiliser le [[#Regroupement|Regroupementregroupement]] to optionally display information or whole linespour afficher des informations optionnelles ou des lignes complètes.}}{{man tip|-Événements|4|Along with En supplément, les [[#Événements|Événementsévénements]] you can print almost anythingpermettent d'imprimer le reste.}}{{man tip|-Séparateurs|5|FinallyEnfin, les [[#Séparateurs|Séparateursséparateurs]], to make your life completepermettent d'ajouter la vie complète.|-|}}
=== Variables déclassées ===
== Chaînes ==
Format strings are used to display names and Les formats des chaînes sont utilisés pour afficher les noms et dates differently than those assigned under différemment que les formats assignés dans les Préférences de Gramps Preferences. Here is the syntax for a format stringVoici la syntaxe pour les chaînes:
$''<span style="background: #c0c0c0">keyclé</span>''(format stringde chaîne) where: ''<span style="background: #c0c0c0">keyclé</span>'' is one of the following charactersest l'un des caractères suivants: 'nsijbmBMdvDVauet'
A Un format string is any textde chaîne correspond à tout texte, separators or séparateurs ou format de codes (defined belowdéfinis plus haut) to display pour afficher une information about the personsur l'individu.
=== Noms ===
For names Pour les noms ($n $s) you may use the following formatting vous pouvez utiliser l'un des codes to display the name differentlyde formatage suivant pour afficher le nom différemment.
{|
|-
|t
|TitleTitre
|
|f
|Given namePrénom
|-
|x
|Common namePrénom commun. Call name if existingPrénom usuel si il existe, otherwise first first namesinon le tout premier prénom.
|
|c
|Call namePrénom usuel
|-
|n
|Nick nameSurnom
|
|s
|SuffixSuffixe
|-
|l
|SurnameNom de famille
|
|g
|Family nicknameNom-dit
|}
These Ces codes can be uppercased to uppercase the resultpeuvent être saisis en majuscule, les valeurs apparaîtront alors en majuscule.
{|
|-
|Example Exemple de code|DisplaysAffiche
|-
|<pre>$n(L, f) ($n(c)), $n(L, f){ ($n(c))}
<blockquote>Note{{man note|Remarque:If you want to print a character Si vous souhaitez imprimer un caractère 'c' within the avec un format string de chaîne (or any one of the other format codesou n'importe quel autre code), you will need to first add a vous devrez d'abord ajouter un '&#92;' in front of itavant. See Voir les [[#Control Variablesde contrôle|variables de contrôle]] for morepour plus d'informations.</blockquote> <blockquote>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.</blockquote>}
{{man note|Remarque:
Les parenthèses { } sont utilisées pour cacher de l'information. Ici, elles sont utilisées autour de ' ($n(c))' pour ne pas afficher ' ()' si un individu n'a pas de prénom usuel. Voir le [[#Regroupement|regroupement]] pour plus d'informations.}}
=== Dates ===
For all of the Pour toutes les variables date variables ($b $d $m $v) you may use the following formatting vous pouvez utiliser la codesde formatage suivants :
{|
|-
|yyyy
|The year as a four digit numberL'année comme 4 nombres digital
|
|yyy
|The yearL'année, with a avec un minimum of three digitsde 3 nombres digital
|-
|yy
|The yearL'année, from de 00 to à 99
|
|y
|The yearL'année, from de 0 to à 99
|-
|mmmm<BR>
MMMM
|The full name of the monthLe nom complet du mois<BR>The full name IN CAPSLe nom complet en lettres capitales
|
|mmm<BR>
MMM
|The abbreviated name of the monthLe nom du mois en abrégé<BR>The abbreviated name IN CAPSLe nom abrégé en lettres capitales
|-
|mm
|The monthLe mois, from de 00 to à 12
|
|m
|The monthLe mois, from de 0 to à 12
|-
|dd
|The dayLe jour, from de 00 to à 31
|
|d
|The dayLe jour, from de 0 to à 31
|-
|o
|The Le type de date type (modifier)
|
|
{|
|-
|Example Exemple de code|displaysaffiche
|-
|<pre>$b(mmm-dd yy)
$m(yyyy/mmm/d)
$b(mmm-dd yy)</pre>
|<pre>MayMai-24 611995/MayMai/27JunJuin-04 85</pre>
|}
{{man note| For Pour les types de date types (modifier) |Only Seul "Beforeavant", "Afteraprès", and et "Aboutvers" are supported at this timesont actuellement supportés. all others will not display anythingTous les autres n'afficheront rien.<BR>and for date span and date rangesEt pour la période, only the starting (first) seul la première date is displayedest affichée.}} 
=== Lieux ===
For all of the place Pour toutes les variables lieu ($B $D $M $V) you may use the following formatting vous pouvez utiliser les codesde formatage suivants:
{|
|-
|e
|StreetRue
|
|l
|LocalityLieu-dit
|-
|c
|CityVille
|
|u
|CountyComté/Département
|-
|s
|StateRégion/Province
|
|p
|Postal Codelieu
|-
|n
|CountryPays
|
|t
|TitleTitre
|-
|x
|Latitude
|}
These Ces codes can be uppercased to uppercase the resultpeuvent être soulignés pour souligner le résultat.
{|
|-
|Example Exemple de code|displaysaffiche
|-
|<pre>$B
Carmel, IN, USA</pre>
|}
 
=== Règles de formatage des chaînes ===
{{man tip|L'affichage|-Tout sera imprimé à l'intérieur d'une chaîne.}}{{man tip|1Extension|Anything will print inside a format string|-|1a|you will have to use Vous aurez besoin d'utiliser les [[#Variables de contrôle|Variables variables de contrôle]] to display things like pour afficher des informations telles que ')' and format et des codesde formatage.}}{{man tip|-Les séparateurs|2|Separators can be within format stringsLes séparateurs peuvent être intégrés à la chaîne.}}{{man tip|-Nombre|3|At least ONE format Au moins UN code has to display something for the ENTIRE format string to display|de formatage doit afficher quelque chose pour que la chaîne entière affiche des données.}}
=== Exemples ===
|-
|code
|givesdonne
|-
|<pre>$n(g f)
{d. $d $D</pre>
|<pre>Edwin Michael Smith
bn. 1961-05-24 at San Jose, Santa Clara Co., CA</pre>The person is still alive Cet individu est en vie (or has no ou n'a pas d'information present) so the line was removed, ainsi la ligne a été enlevée.
|}
== Variables de contrôle ==
Control Les variables allow you to print characters that are special to Substitution values within a displayde contrôle permettent d'imprimer des caractères qui sont spécifiques aux valeurs de substitution à l'affichage.
For example the Par exemple la caractère dollar character '$' is used to note the start of a est utilisé pour noter le début de la variable. If you wish to print a Si vous souhaitez imprimer un caractère dollar character you would use a control character like vous devrez utiliser la caractère '&#92;$'
Control Variablesde contrôle
{|
|-
|&#92;$
|Displays a single Affiche un simple '$'
|
|&#92;&#92;
|Displays a single Affiche un simple '&#92;'
|-
|&#92;(
|Displays a single Affiche un simple '('
|
|&#92;)
|Displays a single Affiche un simple ')'
|-
|&#92;{
|Displays a single Affiche un simple '{'
|
|&#92;}
|Displays a single Affiche un simple '}'
|}
Basically anything that comes after a Pour résumer, tout ce qui suit '&#92;' will be printedsera imprimé.
NoteRemarque:When you are inside a format stringQuand vous êtes dans une chaîne de formatage, you may need to use this to display a character that would normally be a format vous aurez peut être besoin d'afficher un caractère qui est normalement un codede formatage.
{|
|-
|Exemple:
|would givedonnera
|-
|<pre>$b(m hi mom)
|}
as this person was born on the fifth monthpuisque cet individu est né au 5ème mois.
== Regroupement ==
There are Il y a des instances where you do not want certain text to be displayedpour lesquelles vous souhaitez afficher un texte spécifique. Take the exampleRegardez cet exemple:
{|
|-
|Code
|Only Seul une date is knownest connue|Only place is knownSeul un lieu est connu
|-
|<pre>died on décédé(e) le $d at à $D</pre>|<pre>died on 1975décédé(e) le 26-06-26 at 1975 à </pre> |<pre>died on at décédé(e) le à Reno, Washoe Co., NV</pre>
|-
| colspan="3"|Neither of these are very acceptableAucun n'est vraiment correct.
|-
| colspan="3"|But with groups Mais avec les groupes (denoted by délimités par {}), you can optionally print vous pouvez optionnellement imprimer une information if a si la variable within contains contient une information.
|-
| colspan="3"|For examplePar exemple :
|-
|Code
|Only Seul une date is knownest connue|Only place is knownSeul un lieu est connu
|-
|<pre>died décédé(e) {on le $d }{at à $D}</pre>|<pre>died on 1975décédé(e) le 26-06-261975</pre>|<pre>died at décédé(e) à Reno, Washoe Co., NV</pre>
|}
which is what we wantçà ressemble plus au résultat recherché.
=== Règles de regroupement ===
A group will only display if there is at least one Un groupe va seulement s'afficher si il y a au moins une variable that displays somethingà afficher. So if Ainsi, si un groupe n'a group only has text andque du texte et/or ou des variables where the sans information is not known, the entire group will not printalors le groupe entier ne sera pas imprimé.
Groups can also be nestedLes groupes peuvent également être imbriqués. If this happens Si cela arrive (like belowvoir ci-dessous), the outer group will only display if there is at least one le groupe externe sera seulement affiché si il y a au moins une variable that displays something within the outer group or any of the sub groupsqui affiche quelque chose dans ce groupe externe ou tout autres sous-groupes.
Groups can also be used to remove an entire line from a displayLes groupes peuvent également être utilisés pour enlever une ligne entière de l'affichage. A Un '{' at the start of a line will remove the entire line from the display if the above rule is trueau début de la ligne enlèvera la ligne entière de l'affichage si la règle précédente est vraie.
If you do not wish to have the display Si vous ne souhaitez pas avoir à modifier le code above précédent (for death pour l'informationdu décès) displayed et l'afficher (the person is alivel'individu est vivant, or you do not yet know the ou vous ne connaissez pas encore l'information), modify the modifiez le code to look likeavec ce type de code:<pre>{died décédé(e) {on le $d }{at à $D}</pre>
<blockquote>To have an entire line be blank instead of removing the line simply start the line with a space Pour obtenir une ligne vide ou lieu de l'enlever, commencez simplement la ligne avec un espace ' {' or make sure there is ou soyez certain(e) qu'il y a space after the group un espace après le groupe (you will have to close the group firstvous aurez d'abord besoin de fermer le groupe)</blockquote>
=== Exemples: ===
This will hide Ceci va cacher '(' and et ')' if the si l'information sur le divorce information is not known n'est pas connue (or still marriedou toujours mariés).:
<pre>m. $m $M {- ($v(yyyy))</pre>
Only display some spouse information if married or remove the entire line if never marriedAffiche seulement certaines informations sur le conjoint si ils sont mariés ou enlève la ligne si jamais mariés :
<pre>{$s $m(yyyy) {- $v(\(yyyy\))}}</pre>
== Attributs ==
Attributes do no have a Les attributs n'ont pas de format stringde chaîne. Instead the attribute name is placed inside À la place le nom de l'attribut sera placé à l'intérieur []. Here is the syntax for an attributeVoici la syntaxe pour un attribut:
$''<span style="background: #c0c0c0">keyclé</span>''[attribute namenom de l'attribut] where: ''<span style="background: #c0c0c0">keyclé</span>'' is one of the following charactersest l'un des caractères suivants: 'au'
ExampleExemple:
{|
|-
|<pre>$a[Profession]$a[Social Security Number]$a[Total \$ bequeathedlégué]</pre>|<pre>ProgrammerProgrammeur
7A3-29-F1C6
3.00USD</pre>
|}
 
----
== Événements ==
Events have the same starting Les événements n'ont pas la même structure as attributesde départ que les attributs, $e or ou $t and the event name in et le nom de l'événement dans [] but events have an extra mais les événements ont un format string after the name to display the de chaîne supplémentaire après le nom pour afficher la description, la date, placele lieu, l'id, and attributes associated with itet les attributs associés à cet événement. Each of these items can be displayed with a Chacun de ces articles peut être affiché respectivement avec, a un 'n', 'd', 'D', 'i', and et 'a' respectively in the format stringdans la chaîne de formatage. Here is the syntax for an eventVoici la syntaxe pour un événement :
$''<span style="background: #c0c0c0">keyclé</span>''[attribute namenom de l'attribut](format stringchaîne de formatage) where: ''<span style="background: #c0c0c0">keyclé</span>'' is one of the following charactersest l'un des caractères suivants : 'et'
=== Format ===
The Event format string is used to display La chaîne de formatage de l'événement est utilisé pour afficher l'information about the eventsur l'événement. Here are the format Ici les codes to display parts of the eventde formatage affichent une partie de l'événement:
{|
|
|i
|Event IDIdentifiant de l'événement
|-
|d
|Event Datede l'événement&#42;
|
|D
|Event PlaceLieu de l'événement&#42;
|-
|a
|An attributes for the eventUn attibut pour l'événement&#42;&#42;
|
|
|}
&#42;These Ces variables can themselves have format stringspeuvent elle-mêmes avoir des chaînes de formatage. Date and a place can be formatted with format string as defined in et lieu peuvent être formatés avec la chaîne de formatage définie dans les [[#Chaînes|Chaîneschaînes]].
&#42;&#42;Attribute needs to have the attribute name in L'attribut a besoin d'avoir un nom d'attribut dans [] and are formatted as aboveet être formaté comme ci-dessus.
Exemple:
|-
|<pre>$e[First Communion](d(yyyy-mm-d))
$e[Bar Mitzvah](n&lt; at à &gt; D)
$e[Birth](d(yyyy mm/dd) D)</pre>
|<pre>2009-11-6
Jerry's La Bar Mitzah at de Jerry à la maison Opas house2007 05/23 Grandmothers housela maison des grand-mères</pre>
|}
|<pre>$b(yyyy-Mmm-dd)
$M</pre>
|is the same asqui est le même que
|<pre>$e[Birth](d(yyyy-Mmm-dd))
$t[Marriage](D)</pre>
---- === Notes for attributes and events: === {{man tip||-|1Obligation|Attribute and event names are mandatoryLes noms des attributs et événements sont obligatoires. '$a' or ou '$a[]' will not display anythingn'affichera rien.}}{{man tip|-|2Caractères spéciaux|Attributes and event names may have special characters within themLes noms des attributs et des événements peuvent avoir des caractères spéciaux. Most notably Plus particulièrement ']' and et ')'. If this is the caseSi c'est le cas, you will need to use vous aurez besoin d'utiliser les [[#Control Variablesde contrôle|variables de contrôle]]|.}}   
== Separators Séparateurs ==
Separators are special Les séparateurs sont des groupes intercalés de 'text onlytexte' groups inside tel que '&lt;' and et '&gt;' that conditionally display a separator qui affichent sous conditions un séparateur (like comme ', ' or ou ' - ') between two entre deux variables, format codes or textformats de code ou texte.
Separators are displayed conditionally depending on these rulesLes séparateurs sont affichés d'après ces règles:
# A Une variable that does qui '''notaffiche rien''' display anything will remove itself and a separator that is to the left of it from the display line onlysera enlevée et un séparateur qui se trouvera à la gauche sera affiché.# If there is not Si il n'y a separator to the leftpas séparateur à la gauche, the same la même variable will remove itself and a separator that is to the right of it from the displayed linesera enlevée et la séparateur à la droite sera affiché. # If there are two separators togetherSi il y a deux séparateurs simultanés, the left one will be removed from the display line and the right is keptcelui de gauche sera enlevé et seul celui de droite sera affiché.# Separators at the start or end of the display line Les séparateurs au début ou à la fin de la ligne à afficher (or format stringsou les chaînes de formatage) are removedsont enlevés.
=== ExampleExemple: ===
$s(g f)&lt;, &gt;$m(yyyy)&lt; @ &gt;$M&lt; - &gt;$v(&#92;(yyyy&#92;))
Here are some things that may happenVoici ce qui peut arriver:
{|
|-
|If Si '''noneaucune''' of the des variables are knownn'est connue|None of the separators will displayAucun des séparateurs ne sera affiché
|-
|If only one variable Si seulement '''isune''' knownvariable est connue|Only that Seulement cette variable will printsera imprimée. No separators will printAucun séparateur ne sera imprimé.
|-
|If only the spouses name Si les noms des conjoints '''is notne sont pas''' knownconnus|The first separator will not displayLe premier séparateur ne sera pas affiché
|-
|If only the marriage Si seulement la date de mariage '''is notn'est pas '' known' connue|The first separator does not displayLe premier séparateur ne sera pas affiché. We will be left withNous obtiendrons:Jane Doe&lt; - &gt;{ … }And only the Et seulement la date de divorce date needs to be known to print the a besoin d'être connue pour afficher le second separatorséparateur.
|-
|If only the Si seulement la date de divorce date '''is notn'est pas''' knownconnue|the le second separator will not displayséparateur ne sera pas affiché
|}
Separators can be inside Les séparateurs peuvent être entre les chaînes de format strings:
$n(&lt;0&gt;T&lt; &gt;L&lt;, &gt;f&lt; &gt;s)
Unlike groupsContrairement aux groupes, separators can not cross overles séparateurs ne peuvent pas se croiser/out of en dehors des chaînes de format strings. So the separator Ainsi le séparateur &lt;0&gt; will NEVER displayne sera JAMAIS affiché. No matter what is on the left hand side of the Même si il se trouve à la gauche de la variable.
{{man index/fr|Gramps 3.3 Wiki Manual - Reports/fr|Gramps 3.3 Wiki Manual - Reports/fr|3.3}}
[[Category:Fr:Documentation|R]]

Navigation menu