Difference between revisions of "Gramps 5.1 Wiki Manual - Valeurs de substitution"

From Gramps
Jump to: navigation, search
m (reformulation)
m (Variables de contrôle)
(2 intermediate revisions by the same user not shown)
Line 9: Line 9:
 
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) qui seront substitués, au moment de l'affichage, par des informations spécifiques sur l'individu dans la base de données.
 
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) qui seront substitués, au moment de l'affichage, par des informations spécifiques sur l'individu dans la base de données.
  
{|
+
{| {{prettytable}}
 +
|-
 +
! colspan="2"|Valeurs de substitution
 +
! colspan="2"|Affichera : (l'individu est vivant)
 +
|-
 +
!Line 1
 +
|<code>$n</code>
 +
!Line 1
 +
|Durand, Paul Edouard
 +
|-
 +
!Line 2
 +
|<code>n. $b{ à $B}</code>
 +
!Line 2
 +
|n. 24-05-1961 à Bordeaux, dpt. Gironde, Fr
 
|-
 
|-
|Exemple:
+
!Line 3
|Va afficher: (si la personne est en vie)
+
|<code>d. $d< à >$D</code>
 +
!Line 3
 +
|d.
 
|-
 
|-
|<pre>
 
$n
 
n. $b $B
 
d. $d $D</pre>
 
|<pre>Smith, Edwin Michael
 
n. 1961-05-24 San Jose, Santa Clara Co., CA
 
d.</pre>
 
 
|}
 
|}
  
=== Aperçu des valeurs de substitution===
+
Dans la section suivante une liste des variables disponibles est faite
 +
.
 +
*Si vous voulez afficher différemment les noms, date ou informations sur les lieux, voire la partie chaînes formatées plus bas
 +
*Il y a aussi des variables de contrôle pour afficher des caractères particuliers (comme le signe Dollar).
 +
*Vous pouvez aussi utiliser le regroupement pour afficher les informations. Dans l'exemple ci-dessus, la '''ligne 2''' utilise le regroupement pour afficher '''' à '''' seulement quand le lieu de naissance est connu.
 +
*Avec les évènement vous pouvez imprimer presque n'importe quoi.
 +
*Finalement, les séparateurs pour une information complète. Dans l'exemple ci-dessus, la '''ligne 3''' utilise cela pour afficher '''' à '''' seulement si à la fois la date de naissance et le lieu sont connus.
 +
== Les valeurs de substitution ==
  
 
+
{| {{prettytable}}
{|
 
 
|-
 
|-
| colspan="2"|'''Variables personnelles'''
+
! colspan="2"|Variables personnelles
| colspan="2"|'''Variables familiales'''
+
! colspan="2"|Variables familiales
 
|-
 
|-
|$n
+
!$n
 
|Affiche le nom de l'individu
 
|Affiche le nom de l'individu
|$s
+
!$s
 
|Affiche le nom du conjoint
 
|Affiche le nom du conjoint
 
|-
 
|-
|$i
+
!$i
 
|Affiche l'identifiant GRAMPS ID de l'individu.
 
|Affiche l'identifiant GRAMPS ID de l'individu.
|$j
+
!$j
|Affiche l'identifiant GRAMPS ID du marriage.
+
|Affiche l'identifiant GRAMPS ID du mariage.
 
|-
 
|-
|$b
+
!$b
|Affiche la date de naissance de l'individu.  
+
|Affiche la date de naissance de l'individu   
|$m
+
!$m
|Affiche la date de mariage date de l'individu et de son conjoint.
+
|Affiche la date de mariage de l'individu et de son conjoint.
 
|-
 
|-
|$B
+
!$B
 
|Affiche le lieu de naissance de l'individu.   
 
|Affiche le lieu de naissance de l'individu.   
|$M
+
!$M
 
|Affiche le lieu de mariage de l'individu et de son conjoint.
 
|Affiche le lieu de mariage de l'individu et de son conjoint.
 
|-
 
|-
|$d
+
!$d
 
|Affiche la date de décès de l'individu.   
 
|Affiche la date de décès de l'individu.   
|$v
+
!$v
 
|Affiche la date de divorce de l'individu et de son conjoint.
 
|Affiche la date de divorce de l'individu et de son conjoint.
 
|-
 
|-
|$D
+
!$D
 
|Affiche le lieu de décès de l'individu.   
 
|Affiche le lieu de décès de l'individu.   
|$V
+
!$V
 
|Affiche le lieu de divorce de l'individu et de son conjoint.
 
|Affiche le lieu de divorce de l'individu et de son conjoint.
 
|-
 
|-
|$a
+
!$a
 
|Affiche un attribut de l'individu.
 
|Affiche un attribut de l'individu.
 
voir [[#Attributs|Attributs]] pour plus d'informations.
 
voir [[#Attributs|Attributs]] pour plus d'informations.
|$u
+
!$u
 
|Affiche un attribut sur le mariage.
 
|Affiche un attribut sur le mariage.
 
voir [[#Attributs|Attributs]] pour plus d'informations.
 
voir [[#Attributs|Attributs]] pour plus d'informations.
 
|-
 
|-
|$e
+
!$e
|Affiche une information sur un événement de l'individu.
+
|Affiche une information sur un événement de l'individu.  
 
voir [[#Événements|Événements]] pour plus d'informations.
 
voir [[#Événements|Événements]] pour plus d'informations.
|$t
+
!$t
|Affiche une information sur le mariage.
+
|Affiche une information d'évènement sur le mariage.
 
voir [[#Événements|Événements]] pour plus d'informations.
 
voir [[#Événements|Événements]] pour plus d'informations.
 
|}
 
|}
  
Toutes les variables familiales sont définies par le conjoint préféré, désigné dans Gramps. Si l'individu n'a jamais été marié, alors ces variables n'afficheront rien.
+
Toutes les variables familiales sont définies par le conjoint préféré dans Gramps. Si l'individu n'a jamais été marié, alors ces variables n'afficheront rien.
 +
 
 +
==== Autres valeurs de substitution ====
 +
* <code>$T</code> Affiche la date du jour.
  
 
=== Formats d'affichage par défaut ===
 
=== Formats d'affichage par défaut ===
  
{|
+
{| {{prettytable}}
 
|-
 
|-
|$n $s
+
!$n $s
|Les noms seront affichés selon le 'format du nom', défini dans les Préférences de Gramps, sous Affichage.
+
|Les noms seront affichés selon le 'Format des noms', défini dans les Préférences de Gramps, onglet Affichage.
 
|-
 
|-
|$B $D $M $V
+
!$B $D $M $V
 
|Les lieux affichent le titre du lieu.
 
|Les lieux affichent le titre du lieu.
 
|-
 
|-
|$b $d $m $v
+
!$b $d $m $v
|Les dates seront affichées selon le 'format de date', défini dans les Préférences de Gramps, sous Affichage.
+
|Les dates seront affichées selon le 'Format des dates', défini dans les Préférences de Gramps, onglet Affichage.
 
|-
 
|-
|$e $t
+
!$e $t
 
|Les événements affichent la description par défaut.
 
|Les événements affichent la description par défaut.
 
|}
 
|}
 
{{man tip|Chaînes|Si vous souhaitez afficher les noms, la date, ou l'information sur le lieu différemment, vous devriez plutôt utiliser les [[#Chaînes|chaînes]].}}
 
{{man tip|Variables de contrôle|Il y a aussi des [[#Variables de contrôle|variables de contrôle]] pour afficher des caractères spéciaux (tel que le signe dollar).}}
 
{{man tip|Regroupement|Vous pouvez également utiliser le [[#Regroupement|regroupement]] pour afficher des informations optionnelles ou des lignes complètes.}}
 
{{man tip|Événements|En supplément, les [[#Événements|événements]] permettent d'imprimer le reste.}}
 
{{man tip|Séparateurs|Enfin, les [[#Séparateurs|séparateurs]] permettent d'ajouter la vie complète.}}
 
  
 
=== Variables déclassées ===
 
=== Variables déclassées ===
  
Plusieurs anciennes variables ont été déclassées car des [[#Chaînes|chaînes]] les ont remplacées.
+
Plusieurs anciennes variables ont été déclassées car des [[#Chaînes|chaînes formatées]] les ont remplacées. Voici la liste de ces variables et comment parvenir aux résultats :
  
== Chaînes ==
+
{| {{prettytable}}
 +
|-
 +
!Ancienne variable
 +
!Comment l'afficher maintenant
 +
!Ce qui est affiché
 +
|-
 +
|$f
 +
|$n
 +
|Nom - selon l'affichage Gramps des noms défini dans Préférences
 +
|-
 +
|$n
 +
|$n(g f)
 +
|Nom - Prénom Nom de famille
 +
|-
 +
|$N
 +
|$n(f, g)
 +
|Nom - Nom de famille, Prénom (noter la virgule explicite)
 +
|-
 +
|$nC
 +
|$n(g F)
 +
|Nom - Prénom Nom de famille en CAPITALES
 +
|-
 +
|$NC
 +
|$n(F, g)
 +
|Nom - Nom de famille en CAPITALES, Prénom
 +
|-
 +
|$by
 +
|$b(yyyy)
 +
|Date de naissance, année seulement
 +
|-
 +
|$dy
 +
|$d(yyyy)
 +
|Date de décès, année seulement
 +
|-
 +
|$my
 +
|$m(yyyy)
 +
|Date de mariage préféré, année seulement
 +
|-
 +
|$p
 +
|$s
 +
|Nom d'épouse préféré selon l'affichage Gramps dans Préférences
 +
|-
 +
|$s
 +
|$s(g f)
 +
|Nom d'épouse préféré - Prénom Nom de famille
 +
|-
 +
|$S
 +
|$s(f, g)
 +
|Nom d'épouse préféré - Nom de famille, Prénom
 +
|-
 +
|$sC
 +
|$s(g F)
 +
|Nom d'épouse préféré - Prénom Nom de famille en CAPITALES
 +
|-
 +
|$SC
 +
|$s(F, g)
 +
|Nom d'épouse préféré - Nom de famille en CAPITALES, Prénom
 +
|}
 +
 
 +
== Chaînes formatées==
  
Les formats des chaînes sont utilisés pour afficher les noms et dates différemment que les formats assignés dans les Préférences de Gramps. Voici la syntaxe pour les chaînes:
+
Les chaînes formatées sont utilisés pour afficher les noms et dates différemment des formats assignés dans les Préférences de Gramps. Voici la syntaxe pour les chaînes:
  
$''<span style="background: #c0c0c0">clé</span>''(format de chaîne)
+
${{man label|''clé''}} (chaîne formatée)
    où:  ''<span style="background: #c0c0c0">clé</span>'' est l'un des caractères suivants: 'nsijbmBMdvDVauet'
+
où {{man label|''clé''}} est l'un des caractères suivants: 'nsijbmBMdvDVauet'
  
Un format de chaîne correspond à tout texte, séparateurs ou format de codes (définis plus haut) pour afficher une information sur l'individu.
+
Une chaîne formatée correspond à tout texte, séparateurs ou codes de format (définis plus bas) pour afficher une information sur l'individu.
  
=== Noms ===
+
=== Formater les noms ===
  
Pour les noms ($n $s) vous pouvez utiliser l'un des codes de formatage suivant pour afficher le nom différemment.
+
Pour les noms '''($n $s)''' vous pouvez utiliser l'un des codes de formatage suivant pour afficher le nom différemment.
  
{|
+
{| {{prettytable}}
 
|-
 
|-
|t
+
!t
 
|Titre
 
|Titre
|
+
!f
|f
 
 
|Prénom
 
|Prénom
 
|-
 
|-
|x
+
!x
 
|Prénom commun. Prénom usuel si il existe, sinon le tout premier prénom.
 
|Prénom commun. Prénom usuel si il existe, sinon le tout premier prénom.
|
+
!c
|c
 
 
|Prénom usuel
 
|Prénom usuel
 
|-
 
|-
|n
+
!n
 
|Surnom
 
|Surnom
|
+
!s
|s
 
 
|Suffixe
 
|Suffixe
 
|-
 
|-
|l
+
!l
 
|Nom de famille
 
|Nom de famille
|
+
!g
|g
 
 
|Nom-dit
 
|Nom-dit
 
|}
 
|}
Line 147: Line 213:
 
Ces codes peuvent être saisis en majuscule, les valeurs apparaîtront alors en majuscule.
 
Ces codes peuvent être saisis en majuscule, les valeurs apparaîtront alors en majuscule.
  
{|
+
{| {{prettytable}}
 
|-
 
|-
|Exemple de code
+
!Exemple de code
|Affiche
+
!Affiche
 
|-
 
|-
 
|<pre>$n(L, f) ($n(c)), $n(L, f){ ($n(c))}
 
|<pre>$n(L, f) ($n(c)), $n(L, f){ ($n(c))}
 
$s(f l s)</pre>
 
$s(f l s)</pre>
|<pre>SMITH, Edwin Michael (), SMITH, Edwin Michael
+
|<pre>DUPOND, Édouard Michel (), DUPOND, Édouard Michel
Janice Ann Adams</pre>
+
Suzanne Suzi </pre>
 
|}
 
|}
  
  
{{man note|Remarque:
+
{{man note|Remarque|Si vous souhaitez imprimer un caractère 'c' avec un format de chaîne (ou n'importe quel autre code), vous devrez d'abord ajouter un <code>'&#92;'</code> avant. Voir les [[#Variables de contrôle|variables de contrôle]] pour plus d'informations.}}
Si vous souhaitez imprimer un caractère 'c' avec un format de chaîne (ou n'importe quel autre code), vous devrez d'abord ajouter un '&#92;' avant. Voir les [[#Variables de contrôle|variables de contrôle]] pour plus d'informations.}}
 
  
{{man note|Remarque:
+
{{man note|Remarque|Les crochets <code>{ }</code> sont utilisées pour cacher de l'information. Ici, ils sont utilisées autour de <code>' ($n(c))'</code> pour ne pas afficher <code>' ()'</code> si un individu n'a pas de prénom usuel. Voir le [[#Regroupement|regroupement]] pour plus d'informations.}}
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 ===
+
=== Formater les dates ===
  
 
Pour toutes les variables date ($b $d $m $v) vous pouvez utiliser la codes de formatage suivants :
 
Pour toutes les variables date ($b $d $m $v) vous pouvez utiliser la codes de formatage suivants :
  
{|
+
{| {{prettytable}}
 
|-
 
|-
|yyyy
+
!yyyy
|L'année comme 4 nombres digital
+
|L'année comme un nombre à 4 chiffres
|
+
!yyy
|yyy
+
|L'année, avec un minimum de 3 chiffres
|L'année, avec un minimum de 3 nombres digital
 
 
|-
 
|-
|yy
+
!yy
 
|L'année, de 00 à 99
 
|L'année, de 00 à 99
|
+
!y
|y
 
 
|L'année, de 0 à 99
 
|L'année, de 0 à 99
 
|-
 
|-
|mmmm<BR>
+
!mmmm<BR>
 
MMMM
 
MMMM
 
|Le nom complet du mois<BR>
 
|Le nom complet du mois<BR>
 
Le nom complet en lettres capitales
 
Le nom complet en lettres capitales
|
+
!mmm<BR>
|mmm<BR>
 
 
MMM
 
MMM
 
|Le nom du mois en abrégé<BR>
 
|Le nom du mois en abrégé<BR>
 
Le nom abrégé en lettres capitales
 
Le nom abrégé en lettres capitales
 
|-
 
|-
|mm
+
!mm
 
|Le mois, de 00 à 12
 
|Le mois, de 00 à 12
|
+
!m
|m
 
 
|Le mois, de 0 à 12
 
|Le mois, de 0 à 12
 
|-
 
|-
|dd
+
!dd
 
|Le jour, de 00 à 31
 
|Le jour, de 00 à 31
|
+
!d
|d
 
 
|Le jour, de 0 à 31
 
|Le jour, de 0 à 31
 
|-
 
|-
|o
+
!o
 
|Le type de date (modifier)
 
|Le type de date (modifier)
|
+
!
|
 
 
|
 
|
 
|}
 
|}
  
{|
+
Exemple de code :
 +
{| {{prettytable}}
 
|-
 
|-
|Exemple de code
+
!Code de format
|affiche
+
!affiche
 
|-
 
|-
|<pre>$b(mmm-dd yy)
+
|<pre>$b(mmm-dd yy)</br>
$m(yyyy/mmm/d)
+
$m(yyyy/mmm/d)</br>
$b(mmm-dd yy)</pre>
+
$b(dd-mm-yy)</pre>
|<pre>Mai-24 61
+
|<pre>Mai-24 61</br>
1995/Mai/27
+
1995/Mai/27</br>
Juin-04 85</pre>
+
04-Juin-85</pre>
 
|}
 
|}
  
{{man note| Pour les types de date (modifier) |Seul "avant", "après", et "vers" sont actuellement supportés. Tous les autres n'afficheront rien.<BR>
+
{{man note| Pour les types de date (modifier) |Seul "avant", "après", et "vers" sont pris en charge actuellement. Tous les autres n'afficheront rien.<BR>
Et pour la période, seul la première date est affichée.}}
+
Et pour les intervalles et périodes, seule la première date est affichée.}}
  
=== Lieux ===
+
=== Formater les lieux ===
  
 
Pour toutes les variables lieu ($B $D $M $V) vous pouvez utiliser les codes de formatage suivants:
 
Pour toutes les variables lieu ($B $D $M $V) vous pouvez utiliser les codes de formatage suivants:
  
{|
+
{| {{prettytable}}
 
|-
 
|-
|e
+
!e
 
|Rue
 
|Rue
 
|
 
|
|l
+
!l
 
|Lieu-dit
 
|Lieu-dit
 
|-
 
|-
|c
+
!c
 
|Ville
 
|Ville
 
|
 
|
|u
+
!u
 
|Comté/Département
 
|Comté/Département
 
|-
 
|-
|s
+
!s
 
|Région/Province
 
|Région/Province
 
|
 
|
|p
+
!p
 
|Code lieu
 
|Code lieu
 
|-
 
|-
|n
+
!n
 
|Pays
 
|Pays
 
|
 
|
|t
+
!t
 
|Titre
 
|Titre
 
|-
 
|-
|x
+
!x
 
|Longitude
 
|Longitude
 
|
 
|
|y
+
!y
 
|Latitude
 
|Latitude
 
|}
 
|}
Ces codes peuvent être soulignés pour souligner le résultat.
 
  
{|
+
Ces codes peuvent être utilisés en capitales pour obtenir un résultat en capitales.
 +
 
 +
Par exemple :
 +
{| {{prettytable}}
 
|-
 
|-
|Exemple de code
+
!Format de code
|affiche
+
!affiche
 
|-
 
|-
 
|<pre>$B
 
|<pre>$B
$B(c, s, N)</pre>
+
$B(c, u, N)</pre>
|<pre>St Judes Hospital
+
|<pre>Hôpital La Timone
Carmel, IN, USA</pre>
+
Marseille, Bouches-du-Rhône, France</pre>
 
|}
 
|}
  
 
=== Règles de formatage des chaînes ===
 
=== Règles de formatage des chaînes ===
  
{{man tip|L'affichage|Tout sera imprimé à l'intérieur d'une chaîne.}}
+
*Tout sera imprimé à l'intérieur d'une chaîne formatée.
{{man tip|Extension|Vous aurez besoin d'utiliser les [[#Variables de contrôle|variables de contrôle]] pour afficher des informations telles que ')' et des codes de formatage.}}
+
*Vous aurez besoin d'utiliser les [[#Variables de contrôle|variables de contrôle]] pour afficher des informations telles que '''')'''' et des codes de formatage.}}
{{man tip|Les séparateurs|Les séparateurs peuvent être intégrés à la chaîne.}}
+
*Les séparateurs peuvent être intégrés à la chaîne.
{{man tip|Nombre|Au moins UN code de formatage doit afficher quelque chose pour que la chaîne entière affiche des données.}}
+
*Au moins UN code de formatage doit afficher quelque chose pour que la chaîne entière s'affiche.}}
  
=== Exemples ===
+
Exemples :
  
{|
+
{| {{prettytable}}
 
|-
 
|-
|code
+
!Code de formatage
|donne
+
!affiche
 
|-
 
|-
 
|<pre>$n(g f)
 
|<pre>$n(g f)
b. $b {at $B
+
n. $b {à $B
 
{d. $d $D</pre>
 
{d. $d $D</pre>
|<pre>Edwin Michael Smith
+
|<pre>Édouard Michel Dupond
n. 1961-05-24 at San Jose, Santa Clara Co., CA</pre>Cet individu est en vie (ou n'a pas d'information), ainsi la ligne a été enlevée.
+
n. 24-05-1961 à Lyon, dpt. Rhône, Fr</pre>
 +
 
 +
{{man label|Cet individu est en vie (ou n'a pas d'information), ainsi la ligne décès a été enlevée.}}
 
|}
 
|}
  
Line 306: Line 369:
 
Variables de contrôle
 
Variables de contrôle
  
{|
+
{| {{prettytable}}
 +
|-
 +
!Variable de contrôle
 +
!Résultat
 
|-
 
|-
|&#92;$
+
!&#92;$
 
|Affiche un simple '$'
 
|Affiche un simple '$'
|
+
|-
|&#92;&#92;
+
!&#92;&#92;
 
|Affiche un simple '&#92;'
 
|Affiche un simple '&#92;'
 
|-
 
|-
|&#92;(
+
!&#92;(
 
|Affiche un simple '('
 
|Affiche un simple '('
|
+
|-
|&#92;)
+
!&#92;)
 
|Affiche un simple ')'
 
|Affiche un simple ')'
 
|-
 
|-
|&#92;{
+
!&#92;{
 
|Affiche un simple '{'
 
|Affiche un simple '{'
|
+
|-
|&#92;}
+
!&#92;}
 
|Affiche un simple '}'
 
|Affiche un simple '}'
 +
|-
 +
!&#92;<
 +
|Affiche un simple <code>'<'</code>
 +
|-
 +
!&#92;>
 +
|Affiche un simple <code>'>'</code>
 
|}
 
|}
  
 
Pour résumer, tout ce qui suit '&#92;' sera imprimé.
 
Pour résumer, tout ce qui suit '&#92;' sera imprimé.
  
Remarque:
+
{{man note|Note:|Quand vous êtes dans une chaîne de formatage, vous aurez peut être besoin cela pour afficher un caractère qui est normalement un code de formatage.  }}
Quand vous êtes dans une chaîne de formatage, vous aurez peut être besoin d'afficher un caractère qui est normalement un code de formatage.   
+
 
 +
Par exemple :
  
{|
+
{| {{prettytable}}
 
|-
 
|-
|Exemple:
+
!Code de formatage :
|donnera
+
!affiche
 
|-
 
|-
|<pre>$b(m hi mom)
+
|<pre>$b(m salut maman)
$b(m hi \mo\m)</pre>
+
$b(m \sa\l\u\t \ma\ma\n)</pre>
|<pre>5 hi 5o5
+
|<pre>5 adurand 5a5afrance
5 hi mom</pre>
+
5 salut maman</pre>
 +
{{man label|puisque cet individu est né le 5ème mois de l'année.}}
 
|}
 
|}
 
puisque cet individu est né au 5ème mois.
 
  
 
== Regroupement ==
 
== Regroupement ==
  
Il y a des instances pour lesquelles vous souhaitez afficher un texte spécifique. Regardez cet exemple:
+
Il y a des instances pour lesquelles vous ne voulez pas qu'un certain texte s'affiche. Regardez cet exemple:
  
{|
+
{| {{prettytable}}
 
|-
 
|-
|Code
+
!Code de formatage
|Seul une date est connue
+
!Seule une date est connue
|Seul un lieu est connu
+
!Seul un lieu est connu
 
|-
 
|-
|<pre>décédé(e) le $d à $D</pre>
+
|<code>décédé(e) le $d à $D</code>
|<pre>décédé(e) le 26-06-1975 à </pre>  
+
|<code>décédé(e) le 26-06-1975 à </code>  
|<pre>décédé(e) le à Reno, Washoe Co., NV</pre>
+
|<code>décédé(e) le à Nantes, dpt. Loire-Atlantique, Fr</code>
|-
+
|}
| colspan="3"|Aucun n'est vraiment correct.
+
 
|-
+
Aucun affichage n'est vraiment acceptable.
| colspan="3"|Mais avec les groupes (délimités par {}), vous pouvez optionnellement imprimer une information si la variable contient une information.
+
 
|-
+
Mais avec les regroupements (délimités par {}), vous pouvez optionnellement imprimer une information seulement si la variable contient une information.
| colspan="3"|Par exemple :
+
 
 +
 
 +
{| {{prettytable}}
 
|-
 
|-
|Code
+
!Code de formatage
|Seul une date est connue
+
!Seule une date est connue
|Seul un lieu est connu
+
!Seul un lieu est connu
 
|-
 
|-
|<pre>décédé(e) {le $d }{à $D}</pre>
+
|<code>décédé(e) {le $d }{à $D}</code>
|<pre>décédé(e) le 26-06-1975</pre>
+
|<code>décédé(e) le 26-06-1975</code>
|<pre>décédé(e) à Reno, Washoe Co., NV</pre>
+
|<code>décédé(e) à à Nantes, dpt. Loire-Atlantique, Fr</code>
 
|}
 
|}
  
Line 378: Line 452:
 
=== Règles de regroupement ===
 
=== Règles de regroupement ===
  
Un groupe va seulement s'afficher si il y a au moins une variable à afficher. Ainsi, si un groupe n'a que du texte et/ou des variables sans information, alors le groupe entier ne sera pas imprimé.
+
Un groupe va s'afficher seulement si une variable à quelque chose à afficher. Ainsi, si un groupe n'a que du texte et/ou des variables sans information, alors le groupe entier ne sera pas imprimé.
  
Les groupes peuvent également être imbriqués. Si cela arrive (voir ci-dessous), le groupe externe sera seulement affiché si il y a au moins une variable qui affiche quelque chose dans ce groupe externe ou tout autres sous-groupes.
+
Les groupes peuvent également être imbriqués. Si cela arrive (voir ci-dessous), le groupe externe sera affiché seulement si il y a au moins une variable qui affiche quelque chose dans ce groupe externe ou les sous-groupes.
  
 
Les groupes peuvent également être utilisés pour enlever une ligne entière de l'affichage. Un '-' au début de la ligne enlèvera la ligne entière de l'affichage si la règle précédente est vraie.
 
Les groupes peuvent également être utilisés pour enlever une ligne entière de l'affichage. Un '-' au début de la ligne enlèvera la ligne entière de l'affichage si la règle précédente est vraie.
  
Si vous ne souhaitez pas avoir à modifier le code précédent (pour l'information du décès) et l'afficher (l'individu est vivant, ou vous ne connaissez pas encore l'information), modifiez le code avec ce type de code:
+
Si vous ne souhaitez pas avoir le code précédent affiché (pour l'information du décès ; l'individu est vivant, ou vous ne connaissez pas encore l'information), modifiez le code ainsi :
<pre>{décédé(e) {le $d }{à $D}</pre>
+
*<pre>-{décédé(e) {le $d }{à $D}</pre>
  
  
 
=== Exemples: ===
 
=== Exemples: ===
  
Ceci va cacher '(' et ')' si l'information sur le divorce n'est pas connue (ou toujours mariés) :
+
Ceci va cacher ''''('''' et '''')'''' si l'information sur le divorce n'est pas connue (ou toujours mariés) :
<pre>m. $m $M {- ($v(yyyy))</pre>
+
*<code>m. $m $M {- ($v(yyyy))</code>
 
 
  
 
Affiche seulement certaines informations sur le conjoint si ils sont mariés ou enlève la ligne si jamais mariés :
 
Affiche 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>
+
*<code>{$s $m(yyyy) {- $v(\(yyyy\))}}</code>
  
 
== Attributs ==
 
== Attributs ==
  
Les attributs n'ont pas de format de chaîne. À la place le nom de l'attribut sera placé à l'intérieur []. Voici la syntaxe pour un attribut:
+
Les attributs n'ont pas de format de chaîne. À la place le nom de l'attribut sera placé à l'intérieur '''[]'''. Voici la syntaxe pour un attribut:
  
$''<span style="background: #c0c0c0">clé</span>''[nom de l'attribut] : ''<span style="background: #c0c0c0">clé</span>'' est l'un des caractères suivants: 'au'
+
${{man label|''clé''}} [nom de l'attribut]
 +
où : {{man label|''clé''}} est l'un des caractères suivants : 'au'
  
Exemple:
+
Exemple :
  
{|
+
{| {{prettytable}}
 +
!Code de formatage
 +
!affiche
 
|-
 
|-
|<pre>$a[Social Security Number]
+
|<pre>$a[Profession]
 +
$a[Numéro sécurité social]
 
$a[Total \$ légué]</pre>
 
$a[Total \$ légué]</pre>
 
|<pre>Programmeur
 
|<pre>Programmeur
7A3-29-F1C6
+
125025825789
 
3.00USD</pre>
 
3.00USD</pre>
 
|}
 
|}
Line 416: Line 493:
 
== Événements ==
 
== Événements ==
  
Les événements n'ont pas la même structure de départ que les attributs, $e ou $t et le nom de l'événement dans [] mais les événements ont un format de chaîne supplémentaire après le nom pour afficher la description, la date, le lieu, l'id, et les attributs associés à cet événement. Chacun de ces articles peut être affiché respectivement avec, un 'n', 'd', 'D', 'i', et 'a' dans la chaîne de formatage. Voici la syntaxe pour un événement :
+
Les événements ont la même structure de départ que les attributs, '''$e''' ou '''$t''' et le nom de l'événement entre '''[]''' mais les événements ont un format de chaîne supplémentaire après le nom pour afficher la description, la date, le lieu, l'identifiant et les attributs associés à cet événement. Chacun de ces articles peut être affiché respectivement avec, un 'n', 'd', 'D', 'i', et 'a' dans la chaîne de formatage. Voici la syntaxe pour un événement :
  
$''<span style="background: #c0c0c0">clé</span>''[nom de l'attribut](chaîne de formatage) : ''<span style="background: #c0c0c0">clé</span>'' est l'un des caractères suivants : 'et'
+
${{man label|''clé''}} [nom de l'attribut] (chaîne de formatage)
 +
où : {{man label|''clé''}} est l'un des caractères suivants : 'et'
  
=== Format ===
+
=== Format des chaînes pour les évènements ===
  
La chaîne de formatage de l'événement est utilisé pour afficher l'information sur l'événement. Ici les codes de formatage affichent une partie de l'événement:
+
La chaîne de formatage de l'événement est utilisé pour afficher l'information sur l'événement. Ici les codes de formatage pour afficher une partie de l'événement :
  
{|
+
{| {{prettytable}}
 +
!Code de formatage
 +
!affiche
 +
!
 +
!Code de formatage
 +
!affiche
 
|-
 
|-
|n
+
!n
 
|Description
 
|Description
 
|
 
|
|i
+
!i
|Identifiant de l'événement
+
|ID identifiant de l'évènement
 
|-
 
|-
|d
+
!d
|Date de l'événement&#42;
+
|Date de l'évènement&#42;
 
|
 
|
|D
+
!D
|Lieu de l'événement&#42;
+
|Lieu de l'évènement&#42;
 
|-
 
|-
|a
+
!a
|Un attibut pour l'événement&#42;&#42;
+
|Un attribut pour l'évènement&#42;&#42;
 
|
 
|
 
|
 
|
Line 445: Line 528:
 
|}
 
|}
  
&#42;Ces variables peuvent elle-mêmes avoir des chaînes de formatage. Date et lieu peuvent être formatés avec la chaîne de formatage définie dans les [[#Chaînes|chaînes]].
+
&#42;Ces variables peuvent elle-mêmes avoir des chaînes de formatage. Date et lieu peuvent être formatés avec la chaîne de formatage définie dans les [[#Chaînes|formatage de chaînes]].
  
&#42;&#42;L'attribut a besoin d'avoir un nom d'attribut dans [] et être formaté comme ci-dessus.
+
&#42;&#42;L'attribut a besoin d'avoir un nom d'attribut entre [] et être formaté comme ci-dessus.
  
 
Exemple:
 
Exemple:
  
{|
+
{| {{prettytable}}
 +
!Code de formatage
 +
!affiche
 
|-
 
|-
|<pre>$e[First Communion](d(yyyy-mm-d))
+
|<pre>$e[Première Communion](d(yyyy-mm-d))
 
$e[Bar Mitzvah](n&lt; à &gt; D)
 
$e[Bar Mitzvah](n&lt; à &gt; D)
 
$e[Birth](d(yyyy mm/dd) D)</pre>
 
$e[Birth](d(yyyy mm/dd) D)</pre>
Line 464: Line 549:
 
Et:
 
Et:
  
{|
+
{| {{prettytable}}
 +
!Code de formatage
 +
!
 +
!affiche
 
|-
 
|-
 
|<pre>$b(yyyy-Mmm-dd)
 
|<pre>$b(yyyy-Mmm-dd)
 
$M</pre>
 
$M</pre>
 
|qui est le même que
 
|qui est le même que
|<pre>$e[Birth](d(yyyy-Mmm-dd))
+
|<pre>$e[Naissance](d(yyyy-Mmm-dd))
$t[Marriage](D)</pre>
+
$t[Mariage](D)</pre>
 
|}
 
|}
  
  
{{man tip|Obligation|Les noms des attributs et événements sont obligatoires. '$a' ou '$a[]' n'affichera rien.}}
+
=== Notes pour les attributs et les évènements ===
{{man tip|Caractères spéciaux|Les noms des attributs et des événements peuvent avoir des caractères spéciaux. Plus particulièrement ']' et ')'. Si c'est le cas, vous aurez besoin d'utiliser les [[#Variables de contrôle|variables de contrôle]].}}
+
Les noms des attributs et événements sont obligatoires. ''''$a'''' ou ''''$a[]'''' n'affichera rien.
 +
 
 +
Les noms des attributs et des événements peuvent avoir des caractères spéciaux. Plus particulièrement '''']'''' et '''')''''. Si c'est le cas, vous aurez besoin d'utiliser les [[#Variables de contrôle|variables de contrôle]].
  
 
== Séparateurs ==
 
== Séparateurs ==
  
Les séparateurs sont des groupes intercalés de 'texte' tel que '&lt;' et '&gt;' qui affichent sous conditions un séparateur (comme ', ' ou ' - ') entre deux variables, formats de code ou texte.
+
Les séparateurs sont des groupes intercalés de 'texte seul' entre ''''&lt;'''' et ''''&gt;'''' qui affichent sous conditions un séparateur (comme '''', '''' ou '''' - '''') entre deux groupes, variables, code de formatage ou texte.
  
Les séparateurs sont affichés d'après ces règles:
+
Les séparateurs sont affichés d'après ces règles :
  
# Une variable qui '''affiche rien''' sera enlevée et un séparateur qui se trouvera à la gauche sera affiché.
+
*Une variable qui '''affiche rien''' sera enlevée et un séparateur qui se trouvera à la gauche sera affiché.
# Si il n'y a pas séparateur à la gauche, la même variable sera enlevée et la séparateur à la droite sera affiché.   
+
*S'il n'y a pas séparateur à la gauche, la même variable sera enlevée et la séparateur à la droite sera affiché.   
# Si il y a deux séparateurs simultanés, celui de gauche sera enlevé et seul celui de droite sera affiché.
+
# S'il y a deux séparateurs simultanés, celui de gauche sera enlevé et seul celui de droite sera affiché.
 
# Les séparateurs au début ou à la fin de la ligne à afficher (ou les chaînes de formatage) sont enlevés.
 
# Les séparateurs au début ou à la fin de la ligne à afficher (ou les chaînes de formatage) sont enlevés.
  
=== Exemple: ===
+
Take this example formatting code:
 
+
* <code>$s(f l s)&lt;, &gt;$m(yyyy)&lt; @ &gt;$M&lt; - &gt;$v(&#92;(yyyy&#92;))</code>
$s(g f)&lt;, &gt;$m(yyyy)&lt; @ &gt;$M&lt; - &gt;$v(&#92;(yyyy&#92;))
 
  
 
Voici ce qui peut arriver:
 
Voici ce qui peut arriver:
  
{|
+
{| {{prettytable}}
 +
!Hypothèse
 +
!Sortie
 +
|-
 
|-
 
|-
 
|Si '''aucune''' des variables n'est connue
 
|Si '''aucune''' des variables n'est connue
Line 502: Line 594:
 
|Seulement cette variable sera imprimée. Aucun séparateur ne sera imprimé.
 
|Seulement cette variable sera imprimée. Aucun séparateur ne sera imprimé.
 
|-
 
|-
|Si les noms des conjoints '''ne sont pas''' connus
+
|Si les noms du conjoint '''n'est pas''' connus
 
|Le premier séparateur ne sera pas affiché
 
|Le premier séparateur ne sera pas affiché
 
|-
 
|-
 
|Si seulement la date de mariage '''n'est pas ''' connue
 
|Si seulement la date de mariage '''n'est pas ''' connue
 
|Le premier séparateur ne sera pas affiché. Nous obtiendrons:
 
|Le premier séparateur ne sera pas affiché. Nous obtiendrons:
Jane Doe&lt; - &gt;{ … } Et seulement la date de divorce date a besoin d'être connue pour afficher le second séparateur.
+
Jeanne Carré&lt; - &gt;{ … } Et seulement la date de divorce doit être connue pour afficher le second séparateur.
 
|-
 
|-
 
|Si seulement la date de divorce '''n'est pas''' connue
 
|Si seulement la date de divorce '''n'est pas''' connue
Line 515: Line 607:
  
 
Les séparateurs peuvent être entre les chaînes de format:
 
Les séparateurs peuvent être entre les chaînes de format:
 +
* <code>$n(&lt;0&gt;T&lt; &gt;L&lt;, &gt;f&lt; &gt;s)</code>
  
$n(&lt;0&gt;T&lt; &gt;L&lt;, &gt;f&lt; &gt;s)
+
Contrairement aux groupes, les séparateurs ne peuvent pas se croiser/en dehors des chaînes de format. Ainsi le séparateur '''&lt;0&gt;''' ne sera JAMAIS affiché. Même si il se trouve à la gauche de la variable.
  
Contrairement aux groupes, les séparateurs ne peuvent pas se croiser/en dehors des chaînes de format. Ainsi le séparateur &lt;0&gt; ne sera JAMAIS affiché. Même si il se trouve à la gauche de la variable.
+
Ici un exemple utile :
 +
* <code>{({n. $b}<, >{d. $d})}</code>
  
 +
Ce qui va :
 +
{| {{prettytable}}
 +
|-
 +
|Imprimer seulement ce qui est en dehors des () si la naissance ou le décès sont affichés.<br>
 +
Afficher seulement le séparateur central si les deux dates sont connus.<br>
 +
Ainsi, voici ce qui pourrait s'afficher
 +
{|
 +
|-
 +
|<code>(n. 1970-4-8)</code>
 +
|<code>(d. 2012-3-9)</code>
 +
|<code>(n. 1970-4-8, d. 2012-3-9)</code>
 +
|ou les lignes ne s'affichent pas du tout.
 +
|}
 +
|-
 +
|Nous ne pourront pas voir des choses comme ça :
 +
{|
 +
|-
 +
|<code>()</code>
 +
|<code>(, )</code>
 +
|<code>(n.)</code>
 +
|<code>(n., )</code>
 +
|<code>(d.)</code>
 +
|-
 +
|<code>(, d.)</code>
 +
|<code>(n. 1970-4-8, )</code>
 +
|<code>(n. 1970-4-8, d.)</code>
 +
|<code>(, d. 2012-3-9)</code>
 +
|<code>(n., d. 2012-3-9)</code>
 +
|}
 +
|}
  
<br clear="all"/>
+
{{-}}
  
  

Revision as of 17:33, 12 April 2021

Ces sections décrivent les différents valeurs de substitution disponibles dans GRAMPS.

Gnome-important.png Notice spéciale pour le droit à la copie: Toutes les éditions de cette page ont besoin des deux différentes licences pour la réutilisation:

Ces licences permettent au projet Gramps de maximiser l'utilisation du manuel wiki en tant que contenu libre pour les prochaines versions de Gramps. Si vous êtes en désaccord avec cette double licence, alors n'éditez pas cette page. Vous pouvez ajouter un lien pour cette page, ce dernier sera sous licence GFDL via le lien externe (utilisant la syntaxe: [http://www.gramps-project.org/...]), et non via les liens internes.
Utilisez également les conventions typographiques.


Précédent Index Suivant

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) qui seront substitués, au moment de l'affichage, par des informations spécifiques sur l'individu dans la base de données.

Valeurs de substitution Affichera : (l'individu est vivant)
Line 1 $n Line 1 Durand, Paul Edouard
Line 2 n. $b{ à $B} Line 2 n. 24-05-1961 à Bordeaux, dpt. Gironde, Fr
Line 3 d. $d< à >$D Line 3 d.

Dans la section suivante une liste des variables disponibles est faite .

  • Si vous voulez afficher différemment les noms, date ou informations sur les lieux, voire la partie chaînes formatées plus bas
  • Il y a aussi des variables de contrôle pour afficher des caractères particuliers (comme le signe Dollar).
  • Vous pouvez aussi utiliser le regroupement pour afficher les informations. Dans l'exemple ci-dessus, la ligne 2 utilise le regroupement pour afficher ' à ' seulement quand le lieu de naissance est connu.
  • Avec les évènement vous pouvez imprimer presque n'importe quoi.
  • Finalement, les séparateurs pour une information complète. Dans l'exemple ci-dessus, la ligne 3 utilise cela pour afficher ' à ' seulement si à la fois la date de naissance et le lieu sont connus.

Les valeurs de substitution

Variables personnelles Variables familiales
$n Affiche le nom de l'individu $s Affiche le nom du conjoint
$i Affiche l'identifiant GRAMPS ID de l'individu. $j Affiche l'identifiant GRAMPS ID du mariage.
$b Affiche la date de naissance de l'individu $m Affiche la date de mariage de l'individu et de son conjoint.
$B Affiche le lieu de naissance de l'individu. $M Affiche le lieu de mariage de l'individu et de son conjoint.
$d Affiche la date de décès de l'individu. $v Affiche la date de divorce de l'individu et de son conjoint.
$D Affiche le lieu de décès de l'individu. $V Affiche le lieu de divorce de l'individu et de son conjoint.
$a Affiche un attribut de l'individu.

voir Attributs pour plus d'informations.

$u Affiche un attribut sur le mariage.

voir Attributs pour plus d'informations.

$e Affiche une information sur un événement de l'individu.

voir Événements pour plus d'informations.

$t Affiche une information d'évènement sur le mariage.

voir Événements pour plus d'informations.

Toutes les variables familiales sont définies par le conjoint préféré dans Gramps. Si l'individu n'a jamais été marié, alors ces variables n'afficheront rien.

Autres valeurs de substitution

  • $T Affiche la date du jour.

Formats d'affichage par défaut

$n $s Les noms seront affichés selon le 'Format des noms', défini dans les Préférences de Gramps, onglet Affichage.
$B $D $M $V Les lieux affichent le titre du lieu.
$b $d $m $v Les dates seront affichées selon le 'Format des dates', défini dans les Préférences de Gramps, onglet Affichage.
$e $t Les événements affichent la description par défaut.

Variables déclassées

Plusieurs anciennes variables ont été déclassées car des chaînes formatées les ont remplacées. Voici la liste de ces variables et comment parvenir aux résultats :

Ancienne variable Comment l'afficher maintenant Ce qui est affiché
$f $n Nom - selon l'affichage Gramps des noms défini dans Préférences
$n $n(g f) Nom - Prénom Nom de famille
$N $n(f, g) Nom - Nom de famille, Prénom (noter la virgule explicite)
$nC $n(g F) Nom - Prénom Nom de famille en CAPITALES
$NC $n(F, g) Nom - Nom de famille en CAPITALES, Prénom
$by $b(yyyy) Date de naissance, année seulement
$dy $d(yyyy) Date de décès, année seulement
$my $m(yyyy) Date de mariage préféré, année seulement
$p $s Nom d'épouse préféré selon l'affichage Gramps dans Préférences
$s $s(g f) Nom d'épouse préféré - Prénom Nom de famille
$S $s(f, g) Nom d'épouse préféré - Nom de famille, Prénom
$sC $s(g F) Nom d'épouse préféré - Prénom Nom de famille en CAPITALES
$SC $s(F, g) Nom d'épouse préféré - Nom de famille en CAPITALES, Prénom

Chaînes formatées

Les chaînes formatées sont utilisés pour afficher les noms et dates différemment des formats assignés dans les Préférences de Gramps. Voici la syntaxe pour les chaînes:

$clé (chaîne formatée) où : clé est l'un des caractères suivants: 'nsijbmBMdvDVauet'

Une chaîne formatée correspond à tout texte, séparateurs ou codes de format (définis plus bas) pour afficher une information sur l'individu.

Formater les noms

Pour les noms ($n $s) vous pouvez utiliser l'un des codes de formatage suivant pour afficher le nom différemment.

t Titre f Prénom
x Prénom commun. Prénom usuel si il existe, sinon le tout premier prénom. c Prénom usuel
n Surnom s Suffixe
l Nom de famille g Nom-dit

Ces codes peuvent être saisis en majuscule, les valeurs apparaîtront alors en majuscule.

Exemple de code Affiche
$n(L, f) ($n(c)), $n(L, f){ ($n(c))}
$s(f l s)
DUPOND, Édouard Michel (), DUPOND, Édouard Michel
Suzanne Suzi 


Gramps-notes.png
Remarque

Si vous souhaitez imprimer un caractère 'c' avec un format de chaîne (ou n'importe quel autre code), vous devrez d'abord ajouter un '\' avant. Voir les variables de contrôle pour plus d'informations.

Gramps-notes.png
Remarque

Les crochets { } sont utilisées pour cacher de l'information. Ici, ils sont utilisées autour de ' ($n(c))' pour ne pas afficher ' ()' si un individu n'a pas de prénom usuel. Voir le regroupement pour plus d'informations.

Formater les dates

Pour toutes les variables date ($b $d $m $v) vous pouvez utiliser la codes de formatage suivants :

yyyy L'année comme un nombre à 4 chiffres yyy L'année, avec un minimum de 3 chiffres
yy L'année, de 00 à 99 y L'année, de 0 à 99
mmmm

MMMM

Le nom complet du mois

Le nom complet en lettres capitales

mmm

MMM

Le nom du mois en abrégé

Le nom abrégé en lettres capitales

mm Le mois, de 00 à 12 m Le mois, de 0 à 12
dd Le jour, de 00 à 31 d Le jour, de 0 à 31
o Le type de date (modifier)

Exemple de code :

Code de format affiche
$b(mmm-dd yy)</br>
$m(yyyy/mmm/d)</br>
$b(dd-mm-yy)
Mai-24 61</br>
1995/Mai/27</br>
04-Juin-85
Gramps-notes.png
Pour les types de date (modifier)

Seul "avant", "après", et "vers" sont pris en charge actuellement. Tous les autres n'afficheront rien.
Et pour les intervalles et périodes, seule la première date est affichée.

Formater les lieux

Pour toutes les variables lieu ($B $D $M $V) vous pouvez utiliser les codes de formatage suivants:

e Rue l Lieu-dit
c Ville u Comté/Département
s Région/Province p Code lieu
n Pays t Titre
x Longitude y Latitude

Ces codes peuvent être utilisés en capitales pour obtenir un résultat en capitales.

Par exemple :

Format de code affiche
$B
$B(c, u, N)
Hôpital La Timone
Marseille, Bouches-du-Rhône, France

Règles de formatage des chaînes

  • Tout sera imprimé à l'intérieur d'une chaîne formatée.
  • Vous aurez besoin d'utiliser les variables de contrôle pour afficher des informations telles que ')' et des codes de formatage.}}
  • Les séparateurs peuvent être intégrés à la chaîne.
  • Au moins UN code de formatage doit afficher quelque chose pour que la chaîne entière s'affiche.}}

Exemples :

Code de formatage affiche
$n(g f)
n. $b {à $B
{d. $d $D
Édouard Michel Dupond
n. 24-05-1961 à Lyon, dpt. Rhône, Fr

Cet individu est en vie (ou n'a pas d'information), ainsi la ligne décès a été enlevée.

Variables de contrôle

Les variables de contrôle permettent d'imprimer des caractères qui sont spécifiques aux valeurs de substitution à l'affichage.

Par exemple la caractère dollar '$' est utilisé pour noter le début de la variable. Si vous souhaitez imprimer un caractère dollar vous devrez utiliser la caractère '\$'

Variables de contrôle

Variable de contrôle Résultat
\$ Affiche un simple '$'
\\ Affiche un simple '\'
\( Affiche un simple '('
\) Affiche un simple ')'
\{ Affiche un simple '{'
\} Affiche un simple '}'
\< Affiche un simple '<'
\> Affiche un simple '>'

Pour résumer, tout ce qui suit '\' sera imprimé.

Gramps-notes.png
Note:

Quand vous êtes dans une chaîne de formatage, vous aurez peut être besoin cela pour afficher un caractère qui est normalement un code de formatage.

Par exemple :

Code de formatage : affiche
$b(m salut maman)
$b(m \sa\l\u\t \ma\ma\n)
5 adurand 5a5afrance
5 salut maman

puisque cet individu est né le 5ème mois de l'année.

Regroupement

Il y a des instances pour lesquelles vous ne voulez pas qu'un certain texte s'affiche. Regardez cet exemple:

Code de formatage Seule une date est connue Seul un lieu est connu
décédé(e) le $d à $D décédé(e) le 26-06-1975 à décédé(e) le à Nantes, dpt. Loire-Atlantique, Fr

Aucun affichage n'est vraiment acceptable.

Mais avec les regroupements (délimités par {}), vous pouvez optionnellement imprimer une information seulement si la variable contient une information.


Code de formatage Seule une date est connue Seul un lieu est connu
décédé(e) {le $d }{à $D} décédé(e) le 26-06-1975 décédé(e) à à Nantes, dpt. Loire-Atlantique, Fr

çà ressemble plus au résultat recherché.

Règles de regroupement

Un groupe va s'afficher seulement si une variable à quelque chose à afficher. Ainsi, si un groupe n'a que du texte et/ou des variables sans information, alors le groupe entier ne sera pas imprimé.

Les groupes peuvent également être imbriqués. Si cela arrive (voir ci-dessous), le groupe externe sera affiché seulement si il y a au moins une variable qui affiche quelque chose dans ce groupe externe ou les sous-groupes.

Les groupes peuvent également être utilisés pour enlever une ligne entière de l'affichage. Un '-' au début de la ligne enlèvera la ligne entière de l'affichage si la règle précédente est vraie.

Si vous ne souhaitez pas avoir le code précédent affiché (pour l'information du décès ; l'individu est vivant, ou vous ne connaissez pas encore l'information), modifiez le code ainsi :

  • -{décédé(e) {le $d }{à $D}


Exemples:

Ceci va cacher '(' et ')' si l'information sur le divorce n'est pas connue (ou toujours mariés) :

  • m. $m $M {- ($v(yyyy))

Affiche seulement certaines informations sur le conjoint si ils sont mariés ou enlève la ligne si jamais mariés :

  • {$s $m(yyyy) {- $v(\(yyyy\))}}

Attributs

Les attributs n'ont pas de format de chaîne. À la place le nom de l'attribut sera placé à l'intérieur []. Voici la syntaxe pour un attribut:

$clé [nom de l'attribut] où : clé est l'un des caractères suivants : 'au'

Exemple :

Code de formatage affiche
$a[Profession]
$a[Numéro sécurité social]
$a[Total \$ légué]
Programmeur
125025825789
3.00USD

Événements

Les événements ont la même structure de départ que les attributs, $e ou $t et le nom de l'événement entre [] mais les événements ont un format de chaîne supplémentaire après le nom pour afficher la description, la date, le lieu, l'identifiant et les attributs associés à cet événement. Chacun de ces articles peut être affiché respectivement avec, un 'n', 'd', 'D', 'i', et 'a' dans la chaîne de formatage. Voici la syntaxe pour un événement :

$clé [nom de l'attribut] (chaîne de formatage) où : clé est l'un des caractères suivants : 'et'

Format des chaînes pour les évènements

La chaîne de formatage de l'événement est utilisé pour afficher l'information sur l'événement. Ici les codes de formatage pour afficher une partie de l'événement :

Code de formatage affiche Code de formatage affiche
n Description i ID identifiant de l'évènement
d Date de l'évènement* D Lieu de l'évènement*
a Un attribut pour l'évènement**

*Ces variables peuvent elle-mêmes avoir des chaînes de formatage. Date et lieu peuvent être formatés avec la chaîne de formatage définie dans les formatage de chaînes.

**L'attribut a besoin d'avoir un nom d'attribut entre [] et être formaté comme ci-dessus.

Exemple:

Code de formatage affiche
$e[Première Communion](d(yyyy-mm-d))
$e[Bar Mitzvah](n< à > D)
$e[Birth](d(yyyy mm/dd) D)
2009-11-6
La Bar Mitzah de Jerry à la maison Opas
2007 05/23 la maison des grand-mères


Et:

Code de formatage affiche
$b(yyyy-Mmm-dd)
$M
qui est le même que
$e[Naissance](d(yyyy-Mmm-dd))
$t[Mariage](D)


Notes pour les attributs et les évènements

Les noms des attributs et événements sont obligatoires. '$a' ou '$a[]' n'affichera rien.

Les noms des attributs et des événements peuvent avoir des caractères spéciaux. Plus particulièrement ']' et ')'. Si c'est le cas, vous aurez besoin d'utiliser les variables de contrôle.

Séparateurs

Les séparateurs sont des groupes intercalés de 'texte seul' entre '<' et '>' qui affichent sous conditions un séparateur (comme ', ' ou ' - ') entre deux groupes, variables, code de formatage ou texte.

Les séparateurs sont affichés d'après ces règles :

  • Une variable qui affiche rien sera enlevée et un séparateur qui se trouvera à la gauche sera affiché.
  • S'il n'y a pas séparateur à la gauche, la même variable sera enlevée et la séparateur à la droite sera affiché.
  1. S'il y a deux séparateurs simultanés, celui de gauche sera enlevé et seul celui de droite sera affiché.
  2. Les séparateurs au début ou à la fin de la ligne à afficher (ou les chaînes de formatage) sont enlevés.

Take this example formatting code:

  • $s(f l s)<, >$m(yyyy)< @ >$M< - >$v(\(yyyy\))

Voici ce qui peut arriver:

Hypothèse Sortie
Si aucune des variables n'est connue Aucun des séparateurs ne sera affiché
Si seulement une variable est connue Seulement cette variable sera imprimée. Aucun séparateur ne sera imprimé.
Si les noms du conjoint n'est pas connus Le premier séparateur ne sera pas affiché
Si seulement la date de mariage n'est pas connue Le premier séparateur ne sera pas affiché. Nous obtiendrons:

Jeanne Carré< - >{ … } Et seulement la date de divorce doit être connue pour afficher le second séparateur.

Si seulement la date de divorce n'est pas connue le second séparateur ne sera pas affiché


Les séparateurs peuvent être entre les chaînes de format:

  • $n(<0>T< >L<, >f< >s)

Contrairement aux groupes, les séparateurs ne peuvent pas se croiser/en dehors des chaînes de format. Ainsi le séparateur <0> ne sera JAMAIS affiché. Même si il se trouve à la gauche de la variable.

Ici un exemple utile :

  • {({n. $b}<, >{d. $d})}

Ce qui va :

Imprimer seulement ce qui est en dehors des () si la naissance ou le décès sont affichés.

Afficher seulement le séparateur central si les deux dates sont connus.
Ainsi, voici ce qui pourrait s'afficher

(n. 1970-4-8) (d. 2012-3-9) (n. 1970-4-8, d. 2012-3-9) ou les lignes ne s'affichent pas du tout.
Nous ne pourront pas voir des choses comme ça :
() (, ) (n.) (n., ) (d.)
(, d.) (n. 1970-4-8, ) (n. 1970-4-8, d.) (, d. 2012-3-9) (n., d. 2012-3-9)



Précédent Index Suivant