Romjerome at 10:11, 16 March 2012

2012-03-16T10:11:39Z

Romjerome: /* Exemple: */

2011-04-19T18:34:26Z

‎Exemple:

New page

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

{{grampsmanualcopyright/fr}}

{{man index/fr|Gramps 3.4 Wiki Manual - Reports/fr|Gramps 3.4 Wiki Manual - Reports/fr|3.4}}

{{languages|Gramps_3.4_Wiki_Manual_-_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.

{|
|-
|Exemple:
|Va afficher: (si la personne est en vie)
|-
|<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===

{|
|-
| colspan="2"|'''Variables personnelles'''
| colspan="2"|'''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 marriage.
|-
|$b
|Affiche la date de naissance de l'individu.
|$m
|Affiche la date de mariage date 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|Attributs]] pour plus d'informations.
|$u
|Affiche un attribut sur le mariage.
voir [[#Attributs|Attributs]] pour plus d'informations.
|-
|$e
|Affiche une information sur un événement de l'individu.
voir [[#Événements|Événements]] pour plus d'informations.
|$t
|Affiche une information sur le mariage.
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.

=== Formats d'affichage par défaut ===

{|
|-
|$n $s
|Les noms seront affichés selon le 'format du nom', défini dans les Préférences de Gramps, sous Affichage.
|-
|$B $D $M $V
|Les lieux affichent le titre du lieu.
|-
|$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.
|-
|$e $t
|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 ===

Plusieurs anciennes variables ont été déclassées car des [[#Chaînes|chaînes]] les ont remplacées.

== Chaînes ==

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:

$''clé''(format de chaîne)
où: ''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.

=== 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
|-
|<pre>$n(L, f) ($n(c)), $n(L, f){ ($n(c))}
$s(f l s)</pre>
|<pre>SMITH, Edwin Michael (), SMITH, Edwin Michael
Janice Ann Adams</pre>
|}

{{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 '\' avant. Voir les [[#Variables de contrôle|variables de contrôle]] pour plus d'informations.}}

{{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 ===

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

{|
|-
|yyyy
|L'année comme 4 nombres digital
|
|yyy
|L'année, avec un minimum de 3 nombres digital
|-
|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
|affiche
|-
|<pre>$b(mmm-dd yy)
$m(yyyy/mmm/d)
$b(mmm-dd yy)</pre>
|<pre>Mai-24 61
1995/Mai/27
Juin-04 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. 
Et pour la période, seul la première date est affichée.}}

=== 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 soulignés pour souligner le résultat.

{|
|-
|Exemple de code
|affiche
|-
|<pre>$B
$B(c, s, N)</pre>
|<pre>St Judes Hospital
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|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.}}
{{man tip|Les séparateurs|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.}}

=== Exemples ===

{|
|-
|code
|donne
|-
|<pre>$n(g f)
b. $b {at $B
{d. $d $D</pre>
|<pre>Edwin Michael Smith
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.
|}

== 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

{|
|-
|\$
|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é.

Remarque:
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.

{|
|-
|Exemple:
|donnera
|-
|<pre>$b(m hi mom)
$b(m hi \mo\m)</pre>
|<pre>5 hi 5o5
5 hi mom</pre>
|}

puisque cet individu est né au 5ème mois.

== Regroupement ==

Il y a des instances pour lesquelles vous souhaitez afficher un texte spécifique. Regardez cet exemple:

{|
|-
|Code
|Seul une date est connue
|Seul un lieu est connu
|-
|<pre>décédé(e) le $d à $D</pre>
|<pre>décédé(e) le 26-06-1975 à </pre>
|<pre>décédé(e) le à Reno, Washoe Co., NV</pre>
|-
| colspan="3"|Aucun n'est vraiment correct.
|-
| colspan="3"|Mais avec les groupes (délimités par {}), vous pouvez optionnellement imprimer une information si la variable contient une information.
|-
| colspan="3"|Par exemple :
|-
|Code
|Seul une date est connue
|Seul un lieu est connu
|-
|<pre>décédé(e) {le $d }{à $D}</pre>
|<pre>décédé(e) le 26-06-1975</pre>
|<pre>décédé(e) à Reno, Washoe Co., NV</pre>
|}

çà ressemble plus au résultat recherché.

=== 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é.

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 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:
<pre>{décédé(e) {le $d }{à $D}</pre>

<blockquote>Pour obtenir une ligne vide ou lieu de l'enlever, commencez simplement la ligne avec un espace ' {' ou soyez certain(e) qu'il y a un espace après le groupe (vous aurez d'abord besoin de fermer le groupe)</blockquote>

=== Exemples: ===

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>

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>

== 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:

{|
|-
|<pre>$a[Social Security Number]
$a[Total \$ légué]</pre>
|<pre>Programmeur
7A3-29-F1C6
3.00USD</pre>
|}

== É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 :

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

=== Format ===

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:

{|
|-
|n
|Description
|
|i
|Identifiant de l'événement
|-
|d
|Date de l'événement*
|
|D
|Lieu de l'événement*
|-
|a
|Un attibut 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 [[#Chaînes|chaînes]].

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

Exemple:

{|
|-
|<pre>$e[First Communion](d(yyyy-mm-d))
$e[Bar Mitzvah](n< à > D)
$e[Birth](d(yyyy mm/dd) D)</pre>
|<pre>2009-11-6
La Bar Mitzah de Jerry à la maison Opas
2007 05/23 la maison des grand-mères</pre>
|}

Et:

{|
|-
|<pre>$b(yyyy-Mmm-dd)
$M</pre>
|qui est le même que
|<pre>$e[Birth](d(yyyy-Mmm-dd))
$t[Marriage](D)</pre>
|}

{{man tip|Obligation|Les noms des attributs et événements sont obligatoires. '$a' ou '$a[]' n'affichera rien.}}
{{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]].}}

== Séparateurs ==

Les séparateurs sont des groupes intercalés de 'texte' tel que '<' et '>' qui affichent sous conditions un séparateur (comme ', ' ou ' - ') entre deux variables, formats de code 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é.
# 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é.
# Si 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.

=== Exemple: ===

$s(g f)<, >$m(yyyy)< @ >$M< - >$v($yyyy$)

Voici ce qui peut arriver:

{|
|-
|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 des conjoints '''ne sont 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:
Jane Doe< - >{ … } Et seulement la date de divorce date a besoin d'ê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.

 

{{man index/fr|Gramps 3.4 Wiki Manual - Reports/fr|Gramps 3.4 Wiki Manual - Reports/fr|3.4}}

[[Category:Fr:Documentation]]

← Older revision		Revision as of 10:11, 16 March 2012
Line 526:		Line 526:
	{{man index/fr\|Gramps 3.4 Wiki Manual - Reports/fr\|Gramps 3.4 Wiki Manual - Reports/fr\|3.4}}		{{man index/fr\|Gramps 3.4 Wiki Manual - Reports/fr\|Gramps 3.4 Wiki Manual - Reports/fr\|3.4}}

−	[[Category:Fr:Documentation]]	+	[[Category:Fr:Documentation\|R]]

Gramps 3.4 Wiki Manual - Valeurs de substitution - Revision history

Romjerome at 10:11, 16 March 2012

Romjerome: /* Exemple: */