Changes

Jump to: navigation, search

Gramps 5.1 Wiki Manual - Valeurs de substitution

2,171 bytes added, 14:32, 12 April 2021
MAJ partielle variables de substitutions
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"|Exemple:Valeurs de substitution! colspan="2"|Va afficherAffichera : (si la personne l'individu est en vievivant)|-!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|-!Line 3|<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>
|}
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.=== Aperçu des Les valeurs de substitution=== 
{|{{prettytable}}
|-
| ! 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 marriagemariage.
|-
|!$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 d'évènement 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. ==== Autres valeurs de substitution ====* <code>$T</code> Affiche la date du jour.
=== Formats d'affichage par défaut ===
{|{{prettytable}}
|-
|!$n $s|Les noms seront affichés selon le 'format du nomFormat des noms', défini dans les Préférences de Gramps, sous 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 de dateFormat des dates', défini dans les Préférences de Gramps, sous onglet 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înesformaté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|}
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:== Chaînes formatées==
$''<span style="background: #c0c0c0">clé</span>''(format 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 chaîne) où: ''<span style="background: #c0c0c0">clé</span>'' est l'un des caractères suivantsGramps. Voici la syntaxe pour les chaînes: 'nsijbmBMdvDVauet'
Un format de ${{man label|''clé''}} (chaîne correspond à tout texte, séparateurs ou format de codes (définis plus hautformatée) pour afficher une information sur où : {{man label|''clé''}} est l'individu.un des caractères suivants: 'nsijbmBMdvDVauet'
=== Noms ===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.
Pour === Formater 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
|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.
{|{{prettytable}}
|-
|!Exemple de code|!Affiche
|-
|<pre>$n(L, f) ($n(c)), $n(L, f){ ($n(c))}
$s(f l s)</pre>
|<pre>SMITHDUPOND, Edwin Michael Édouard Michel (), SMITHDUPOND, Edwin MichaelÉdouard MichelJanice Ann AdamsSuzanne Suzi </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 <code>'&#92;' </code> avant. Voir les [[#Variables de contrôle|variables de contrôle]] pour plus d'informations.}}
{{man note|Remarque:|Les parenthèses crochets <code>{ } </code> sont utilisées pour cacher de l'information. Ici, elles 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.}}
=== Dates Formater les dates ===
Pour toutes les variables date ($b $d $m $v) vous pouvez utiliser la codes de formatage suivants :
{|{{prettytable}}
|-
|!yyyy|L'année comme un nombre à 4 nombres digitalchiffres||!yyy|L'année, avec un minimum de 3 nombres digitalchiffres
|-
|!yy
|L'année, de 00 à 99
||!y
|L'année, de 0 à 99
|-
|!mmmm<BR>
MMMM
|Le nom complet du mois<BR>
Le nom complet en lettres capitales
||!mmm<BR>
MMM
|Le nom du mois en abrégé<BR>
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 :{|{{prettytable}}
|-
|Exemple !Code de codeformat|!affiche
|-
|<pre>$b(mmm-dd yy)</br>$m(yyyy/mmm/d)</br>$b(mmmdd-mm-dd yy)</pre>|<pre>Mai-24 61</br>1995/Mai/27</br>04-Juin-04 85</pre>
|}
{{man note| Pour les types de date (modifier) |Seul "avant", "après", et "vers" sont pris en charge actuellement supportés. Tous les autres n'afficheront rien.<BR>Et pour la périodeles intervalles et périodes, seul 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:
{|{{prettytable}}
|-
|!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.
Ces codes peuvent être utilisés en capitales pour obtenir un résultat en capitales.  Par exemple :{|{{prettytable}}
|-
|Exemple !Format de code|!affiche
|-
|<pre>$B
$B(c, su, N)</pre>|<pre>St Judes HospitalHôpital La TimoneCarmelMarseille, INBouches-du-Rhône, USAFrance</pre>
|}
=== Règles de formatage des chaînes ===
{{man tip|L'affichage|*Tout sera imprimé à l'intérieur d'une chaîneformaté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.}}{{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 s'affiche des données.}}
=== Exemples ===Exemples :
{|{{prettytable}}
|-
|code!Code de formatage|donne!affiche
|-
|<pre>$n(g f)
bn. $b {at à $B
{d. $d $D</pre>
|<pre>Edwin Michael SmithÉdouard Michel Dupondn. 196124-05-24 at San Jose1961 à Lyon, Santa Clara Codpt.Rhône, CAFr</pre> {{man label|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
{|{{prettytable}}|-!Variable de contrôle!Résultat
|-
|!&#92;$
|Affiche un simple '$'
|-|!&#92;&#92;
|Affiche un simple '&#92;'
|-
|!&#92;(
|Affiche un simple '('
|-|!&#92;)
|Affiche un simple ')'
|-
|!&#92;{
|Affiche un simple '{'
|-|!&#92;}
|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é.
Remarque{{man note|Note:|Quand vous êtes dans une chaîne de formatage, vous aurez peut être besoin d'cela pour afficher un caractère qui est normalement un code de formatage. }} Par exemple :
{|{{prettytable}}
|-
|Exemple!Code de formatage :|donnera!affiche
|-
|<pre>$b(m hi momsalut maman)$b(m hi \mosa\ml\u\t \ma\ma\n)</pre>|<pre>5 hi 5o5adurand 5a5afrance5 hi momsalut maman</pre>{{man label|puisque cet individu est né au 5ème mois.}}
|}
puisque cet individu est né au 5ème mois.
== Regroupement ==
Il y a des instances pour lesquelles vous souhaitez afficher ne voulez pas qu'un certain texte spécifiques'affiche. Regardez cet exemple:
{|{{prettytable}}
|-
|!Codede formatage|Seul !Seule une date est connue|!Seul un lieu est connu
|-
|<precode>décédé(e) le $d à $D</precode>|<precode>décédé(e) le 26-06-1975 à </precode> |<precode>décédé(e) le à RenoNantes, Washoe Codpt.Loire-Atlantique, NVFr</precode>|-} | colspan="3"|Aucun affichage n'est vraiment correctacceptable.|-| colspan="3"|Mais avec les groupes regroupements (délimités par {}), vous pouvez optionnellement imprimer une information seulement si la variable contient une information.  {| {{prettytable}}
|-
| colspan="3"|Par exemple :!Code de formatage!Seule une date est connue!Seul un lieu est connu
|-
|Code|Seul une date est connue|Seul un lieu est connu|-|<precode>décédé(e) {le $d }{à $D}</precode>|<precode>décédé(e) le 26-06-1975</precode>|<precode>décédé(e) à Renoà Nantes, Washoe Codpt.Loire-Atlantique, NVFr</precode>
|}
=== Règles de regroupement ===
Un groupe va seulement s'afficher seulement si il y a au moins 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 affiché si il y a au moins une variable qui affiche quelque chose dans ce groupe externe ou tout autres 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 à modifier le code précédent affiché (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 codeainsi :*<pre>-{décédé(e) {le $d }{à $D}</pre>
=== Exemples: ===
Ceci va cacher ''''('''' et '''')'''' si l'information sur le divorce n'est pas connue (ou toujours mariés) :*<precode>m. $m $M {- ($v(yyyy))</precode
Affiche seulement certaines informations sur le conjoint si ils sont mariés ou enlève la ligne si jamais mariés :
*<precode>{$s $m(yyyy) {- $v(\(yyyy\))}}</precode>
== 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:
${{man label|''<span style="background: #c0c0c0">clé</span>''}} [nom de l'attribut] où : {{man label|''<span style="background: #c0c0c0">clé</span>'' }} est l'un des caractères suivantssuivants : 'au'
ExempleExemple :
{|{{prettytable}}!Code de formatage!affiche
|-
|<pre>$a[Social Security NumberProfession]$a[Numéro sécurité social]
$a[Total \$ légué]</pre>
|<pre>Programmeur
7A3-29-F1C6125025825789
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 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'id, 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 :
${{man label|''<span style="background: #c0c0c0">clé</span>''}} [nom de l'attribut](chaîne de formatage) où : {{man label|''<span style="background: #c0c0c0">clé</span>'' }} est l'un des caractères suivants 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 affichent pour afficher une partie de l'événementévénement :
{|{{prettytable}}!Code de formatage !affiche!!Code de formatage !affiche
|-
|!n
|Description
|
|!i|Identifiant ID identifiant de l'événementévènement
|-
|!d|Date de l'événementévènement&#42;
|
|!D|Lieu de l'événementévènement&#42;
|-
|!a|Un attibut attribut pour l'événementévènement&#42;&#42;
|
|
|}
&#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 entre [] et être formaté comme ci-dessus.
Exemple:
{|{{prettytable}}!Code de formatage!affiche
|-
|<pre>$e[First Première Communion](d(yyyy-mm-d))
$e[Bar Mitzvah](n&lt; à &gt; D)
$e[Birth](d(yyyy mm/dd) D)</pre>
Et:
{|{{prettytable}}!Code de formatage!!affiche
|-
|<pre>$b(yyyy-Mmm-dd)
$M</pre>
|qui est le même que
|<pre>$e[BirthNaissance](d(yyyy-Mmm-dd))$t[MarriageMariage](D)</pre>
|}
{{man tip|Obligation|=== Notes pour les attributs et les évènements ===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 ==
798
edits

Navigation menu