Difference between revisions of "Gramps 3.3 Wiki Manual - Valeurs de substitution"
(→Attributs) |
(→Événements) |
||
Line 416: | Line 416: | ||
== É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 : | |
− | $''<span style="background: #c0c0c0">clé</span>''[ | + | $''<span style="background: #c0c0c0">clé</span>''[nom de l'attribut](chaîne de formatage) où: ''<span style="background: #c0c0c0">clé</span>'' est l'un des caractères suivants : 'et' |
=== Format === | === 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: | |
{| | {| | ||
Line 430: | Line 430: | ||
| | | | ||
|i | |i | ||
− | | | + | |Identifiant de l'événement |
|- | |- | ||
|d | |d | ||
− | | | + | |Date de l'événement* |
| | | | ||
|D | |D | ||
− | | | + | |Lieu de l'événement* |
|- | |- | ||
|a | |a | ||
− | | | + | |Un attibut pour l'événement** |
| | | | ||
| | | | ||
Line 445: | Line 445: | ||
|} | |} | ||
− | * | + | *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: | Exemple: | ||
Line 457: | Line 457: | ||
$e[Birth](d(yyyy mm/dd) D)</pre> | $e[Birth](d(yyyy mm/dd) D)</pre> | ||
|<pre>2009-11-6 | |<pre>2009-11-6 | ||
− | + | La Bar Mitzah de Jerry à la maison Opas | |
− | 2007 05/23 | + | 2007 05/23 la maison des grand-mères</pre> |
|} | |} | ||
Revision as of 09:28, 16 April 2011
Ces sections décrivent les différents valeurs de substitution disponibles dans GRAMPS.
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. |
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) pour des informations spécifiques sur l'individu dans la base de données.
Exemple: | Va afficher: (si la personne est en vie) |
$n n. $b $B d. $d $D |
Smith, Edwin Michael n. 1961-05-24 San Jose, Santa Clara Co., CA d. |
Contents
Aperçu des 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 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 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 sur le mariage.
voir É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. |
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. |
Variables de contrôle Il y a aussi des variables de contrôle pour afficher des caractères spéciaux (tel que le signe dollar). |
Regroupement Vous pouvez également utiliser le regroupement pour afficher des informations optionnelles ou des lignes complètes. |
Événements En supplément, les événements permettent d'imprimer le reste. |
Séparateurs Enfin, les 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 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 |
$n(L, f) ($n(c)), $n(L, f){ ($n(c))} $s(f l s) |
SMITH, Edwin Michael (), SMITH, Edwin Michael Janice Ann Adams |
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. |
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 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 |
$b(mmm-dd yy) $m(yyyy/mmm/d) $b(mmm-dd yy) |
Mai-24 61 1995/Mai/27 Juin-04 85 |
Pour les types de date (modifier) Seul "avant", "après", et "vers" sont actuellement supportés. Tous les autres n'afficheront rien. |
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 |
$B $B(c, s, N) |
St Judes Hospital Carmel, IN, USA |
Règles de formatage des chaînes
L'affichage Tout sera imprimé à l'intérieur d'une chaîne. |
Extension Vous aurez besoin d'utiliser les variables de contrôle pour afficher des informations telles que ')' et des codes de formatage. |
Les séparateurs Les séparateurs peuvent être intégrés à la chaîne. |
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 |
$n(g f) b. $b {at $B {d. $d $D |
Edwin Michael Smith n. 1961-05-24 at San Jose, Santa Clara Co., CACet 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 |
$b(m hi mom) $b(m hi \mo\m) |
5 hi 5o5 5 hi mom |
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 |
décédé le $d à $D |
décédé le 26-06-1975 à |
décédé le à Reno, Washoe Co., NV |
Aucun n'est vraiment correct. | ||
Mais avec les groupes (délimités par {}), vous pouvez optionnellement imprimer une information si la variable contient une information. | ||
Par exemple : | ||
Code | Seul une date est connue | Seul un lieu est connu |
décédé {le $d }{à $D} |
décédé le 26-06-1975 |
décédé à Reno, Washoe Co., NV |
çà 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:
{décédé(e) {le $d }{à $D}
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)
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:
$a[Social Security Number] $a[Total \$ légué] |
Programmeur 7A3-29-F1C6 3.00USD |
É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.
**L'attribut a besoin d'avoir un nom d'attribut dans [] et être formaté comme ci-dessus.
Exemple:
$e[First 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:
$b(yyyy-Mmm-dd) $M |
qui est le même que | $e[Birth](d(yyyy-Mmm-dd)) $t[Marriage](D) |
Obligation Les noms des attributs et événements sont obligatoires. '$a' ou '$a[]' n'affichera rien. |
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. |
Séparateurs
Separators are special 'text only' groups inside '<' and '>' that conditionally display a separator (like ', ' or ' - ') between two variables, format codes or text.
Separators are displayed conditionally depending on these rules:
- A variable that does not display anything will remove itself and a separator that is to the left of it from the display line only.
- If there is not a separator to the left, the same variable will remove itself and a separator that is to the right of it from the displayed line.
- If there are two separators together, the left one will be removed from the display line and the right is kept.
- Separators at the start or end of the display line (or format strings) are removed
Exemple:
$s(g f)<, >$m(yyyy)< @ >$M< - >$v(\(yyyy\))
Here are some things that may happen:
If none of the variables are known | None of the separators will display |
If only one variable is known | Only that variable will print. No separators will print. |
If only the spouses name is not known | The first separator will not display |
If only the marriage date is not known | The first separator does not display. We will be left with:
Jane Doe< - >{ … }And only the divorce date needs to be known to print the second separator. |
If only the divorce date is not known | the second separator will not display |
Separators can be inside format strings:
$n(<0>T< >L<, >f< >s)
Unlike groups, separators can not cross over/out of format strings. So the separator <0> will NEVER display. No matter what is on the left hand side of the variable.
Précédent | Index | Suivant |