Il ne sera pas question ici d’expliquer le langage HTML, qui permet de définir la mise en page des données que ce fichier affiche, mais plutôt de présenter les données que l’on peut afficher et les instructions correspondantes, encapsulées dans les balises HTML.
Pour afficher les données uniques de l’individu, (qu’elles soient cliquables ou non), il suffit d’utiliser les éléments suivants et de les intégrer dans les balises html :
Données de l'individu uniques et non-cliquables :
%first_name; : Prénom
%surname; : Patronyme
%public_name; : Nom Public
[.*Sosa] : Sosa
%first_name_key; : prenom
%first_name; : Prénom
%surname_key : patronyme
%occupation; : "Occupation"
%on_birth_date; : le 1er janvier 1900
%birth_place; : Lieu de naissance
%on_baptism_date; : date de Baptême
%baptism_place; : Lieu de Baptême
%on_death_date; : date de décès
%death_place; : Lieu de décès
%age; : âge si la personne est vivante
%on_burial_date; : date d’enterrement
%burial_place; : Lieu d’enterrement
%on_cremation_date;: date d’enterrement
%cremation_place; : Lieu d’enterrement
%death_age; : âge au moment du décès
%consanguinity; : 0,5 %
%notes; : "Notes de Prénom Patronyme"
Données de l'individu uniques et cliquables (option) :
%father; : Prénom Père Patronyme Père
%father.dates; : 1870-1944 (par exemple)
%mother; : Prénom Mère Patronyme Mère
%mother.dates; : 1870-1944 (par exemple)
%sosa; : 16 (par exemple)
Pour rendre ces informations cliquables, il faut construire un lien au format HTML et formé des macros suivantes :
%prefix; : mabase?
%mother.access; : p=prenom+mere;n=patronyme+mere
%father.access; : p=prenom+pere;n=patronyme+pere
%sosa_link; : m=RL;i1=1;i2=1;b1=1;b2=1 (par exemple)
le lien se code de la façon suivante :
<a href="%prefix;%mother.access;">%mother;</a>
ou
<a href="%prefix;m=P;v=%first_name_key;">%first_name;</a>
Certaines données peuvent être multiples pour un même individu. Cela peut être le conjoint, le titre de noblesse, l’enfant, …
Les données de l'individu multiples sont :
%qualifier; : Qualificatif;
%alias; : Alias
%nobility_title; : Titre de Noblesse
%surname_alias; : Patronyme Alias
%first_name_alias; : Prénom Alias
%family; : (sert à définir une condition)
%witnes; : Témoin
%child; : enfant
%father.child; : enfant du père
%mother.title; : Titre de la mère
%relation; : Relations
%related;
%witness_relation; : (sert à définir une condition)
%spouse; : conjoint
%witness.dates; : année de naisance et année de décès du conjoint
%witness.title; : Titre du conjoint
%divorce_date; : date du divorce
%child.child_name; :
%child_name; : Nom de l’enfant
%child.dates; : Année de naissance et année de décès de l’enfant
%source_type; : type de source (naissance, décès, …)
%source; : %source;
Pour écrire les données qui peuvent être multiples, il faut les inclure dans une instruction de type :
%foreach;xxxxxxx;
%xxxxxxx;
%end;
On peut aussi écrire ces données avec un lien qui pointe vers la fiche de la personne citée :
%foreach;child;
<a href="%prefix;%child.access;">%child.child_name;</a>
%end;
on obtient :
- Prénom enfant 1 Patronyme enfant 1
- Prénom enfant 2 Patronyme enfant 2
etc… jusqu’au dernier enfant.
On peut aussi définir un affichage conditionnel :
Il s’écrit avec les instruction « if else end »
Par exemple :
if;child.has_families; (si l’enfant a une famille)
disc (alors l’affichage produit une puce pleine)
%else; (sinon)
circle (l’affichage produit une puce non pleine)
%end (fin de l’instruction conditionnelle)
La plupart du temps, si on n’utilisait pas l’affichage conditionnel, il apparaitrait sur l’écran des caractères xxxxxxx ???, où xxxx sont le nom de l’instruction à faire apparaître. Ce qui n’est pas propre !!
Les conditions que l’on retrouve sont les suivantes :
%if;has_public_name;
%if;has_qualifiers;
%if;is_male;
%if;has_public_name;
%if;cancel_links
%if;(has_sosa or has_qualifiers or has_aliases or has_nobility_titles or
has_public_name or has_surnames_aliases or has_first_names_aliases)
%if;not is_first;
%if;has_nobility_titles;
%if;(has_public_name or has_qualifiers)
%if;not cancel_links;
%if;has_referer;
%if;has_image;
%if;(has_occupation or has_birth_date or has_birth_place or
has_baptism_date or has_baptism_place or is_dead or is_buried or
is_cremated or has_consanguinity)
%if;has_occupation;
%if;has_birth_date;
%if;has_birth_place;
%if;has_baptism_date;
%if;has_baptism_place;
%if;is_dead;
%if;has_death_date;
%if;computable_age;
%if;is_buried;
%if;has_burial_date;
%if;has_burial_place;
%if;is_cremated;
%if;has_cremation_date;
%if;has_cremation_place;
%if;computable_death_age;
%if;(has_consanguinity and cvar_show_consang != "no");
%if;has_parents;
%if;father.has_parents;
%if;(cancel_links or father.is_restricted);
%if;(cancel_links or mother.is_restricted);
%if;are_married;
%if;has_families;
%if;spouse.has_parents;
%if;(on_marriage_date = "")
%if;(cancel_links or spouse.is_restricted);
%if;has_witnesses;
%if;(cancel_links or witness.is_restricted);
%if;has_comment;
%if;are_divorced;
%if;are_separated;
%if;has_children;
%if;child.has_families;
%if;(cancel_links or child.is_restricted);
%if;has_siblings;
%if;is_self;
%if;has_relations;
%if;(has_relation_him and has_relation_her)
%if;(cancel_links or relation_him.is_restricted);
%if;relation_him.has_families;
%if;(cancel_links or relation_her.is_restricted);
%if;has_notes;
%if;has_sources;
%if;not cancel_links;
%if;has_nephews_or_nieces;
%if;is_sibling_before;
%if;is_sibling_after;
%if;wizard;
%if;(evar_opt = "misc")
Exemple : afficher les éventuels enfants d’un individu et les éventuels conjoints de ces enfants :
%if;has_parents;
%foreach;father.child;
<a href="%prefix;%child.access;">%child.child_name;</a>%child.dates;%nl;
<!-- affichage des conjoints-->
%foreach;child.family
& <a href="%prefix;%spouse.access;"><i>%spouse;</i></a>
%spouse.dates;%nl;
%end;
<!--Fin d'affichage des conjoints-->
%end;
%end;
NB : je ne sais pas encore ce que signifie ou à quoi sert l’instruction «%nl; ». Si quelqu’un peut me l’indiquer, j’en serais ravi.