Blueprints (STLM)

A layerblueprint is a set of parameters used to customize the display of an entity in certain views of Ancestris.

VuesViews utilisantusing les calques blueprints

SeulesOnly lesthe vuesfollowing suivantesviews utilisentuse lesblueprints. calques.For Uneach, exemplean vousexample permetlets deyou voirsee àwhat quoithe ressembleblueprints leslook calques dans chacun des cas.like.

ArbreDynamic dynamique tree

L'ArbreThe dynamiqueDynamic utiliseTree lesuses calquesblueprints pourfor lesindividuals entitésand individusfamilies. etBlueprints familles.are Lesthe calquesareas sontdisplayed lesinside zonethe affichées à l'intérieur des cadres.frames.

Entity Fiche entité card

LaThe FicheEntity entitéCard utiliseuses lesblueprints calquesfor pourall toutescategories lesof catégories d'entités.entities.

OnWe peutcan avoirhave lethe mêmesame calqueindividual individublueprint queas pourfor l'arbrethe dynamique.dynamic Ici,tree. leHere, calquethe individuindividual estblueprint àis l'intérieurinside dethe laEntity fiche Entité.card.

NavigateurExtended étendunavigator

LeThe NavigateurExtended étenduNavigator utiliseuses desblueprints calquesfor pourboth lesindividuals entitésand individus et familles.families.

Ici,Here, lesthe calquesblueprints utilisésused pourfor lesthe individusindividuals duof couplethe sélectionné.selected Vouscouple. pouvezYou remarquermay quenotice cethat nethey sontare pasnot lesthe mêmes.same. LeThe calquespouse dublueprint conjointdoes n'affichenot pasdisplay le numérothe Sosa etnumber afficheand ledisplays numérothe d'entitéentity aunumber dessusabove duthe nom.name.

 

EtAnd voicihere's una calqueblueprint pourfor lathe familleselected sélectionnée.family.

Éditeur Gedcom editor

L'ÉditeurThe Gedcom utiliseEditor lesuses calquesblueprints dansin saits partielower inférieurepart pourfor toutesall lesentity catégories d'entités.categories.

CommeAs pourfor lathe ficheentity entité,card, l'Éditeurthe Gedcom utiliseEditor desuses calquesblueprints d'individusof ouindividuals deor familles,families, maisbut aussialso desof autresother entités.entities.

ParFor exempleexample voicihere unis calquea simple d'uneblueprint entitéof Dépôt.a Repository entity.

OuOr un calquea simple d'uneblueprint entitéof Multimédia.a Multimedia entity.

MaintenantNow quethat vousyou've avezseen vuwhat à quoi ressemble un calque et où ils sont utilisés, voyons comment ça marche.blueprint looks like and where they're used, let's see how it works.

PrincipesGeneral générauxprinciples

UnA calqueblueprint estis una modèletemplate définissantdefining cewhat qu'ilto fautdisplay afficherof d'unean entité,entity, etand commenthow l'afficher.to display it.

UnA calqueblueprint estis attribuéassigned àto unea catégoriegiven d'entitéentity donnéecategory (individu,individual, famille,family, source, etc.) pourfor unea vuegiven donnéeview (ArbreDynamic dynamique,tree, FicheEntity entité,file, etc.).

VousYou pouvezcan utiliserdefine d'autresyour calquesown queblueprints ceuxrather définisthan parusing défautthe etones quialready existentprovided déjà danswithin Ancestris.

PlusieursSeveral calquesblueprints existentexist dansin Ancestris etand sontare déjàalready sélectionnésselected parby défautdefault pourfor chacuneeach desof catégoriesthe d'entité,entity etcategories, dansand chaquein vueeach concernée.view Pourwhere cetteblueprints raison, les calques constituent une simple option d'Ancestris. Vous êtes libre de les ignorer, et rien ne vous oblige à effectuer la moindre modification les concernant.apply.

VousBlueprints pouvezconstitute mêmea définirway vosto proprescustomize calques,Ancestris. c'est-à-direYou d'uneare partfree lesto informationskeep àblueprints afficheras pourthey unare individuor oumodify unethem famille to your needs.

You can define your own blueprints, i.e. both the information to display for an individual or a family (nom,name, adresse,address, etc.) etand pourhow uneto vue,display d'autrethis part l'aspect visuel de ces informationsinformation (couleur,color, police,font, alignement,alignment, mise en page,layout, etc.).

SiIf vousyou souhaitezwant effectuerto certainesmake modificationssome concernantchanges lesregarding calques,the vousblueprints, aurezyou besoinwill d'enneed apprendreto unlearn peua pluslittle àmore leurabout sujet.them. C'estThis l'objetis dethe cesubject quiof suit.the following sections in this page.

Techniquement,Technically, una calqueblueprint estis aussia unpiece morceauof deHTML code auwritten formatinto HTMLa écritfile danslocated unon fichieryour situédisk. surRefer votreto disque.the Reportez-vousparagraph auDirectory paragraphecontaining Répertoirelayers contenantfor lesmore calquesinformation.

pour en savoir plus.

 

GestionManaging des calquesblueprints

LaManaging gestionblueprints desconsists calquesin consisteperforming à effectuer deuxtwo types d'activités.of activities.

• attribuerassign desblueprints calquesto àentities desand entités et à des vuesviews
• construirebuild sesyour propresown calquesblueprints etand endelete supprimerthem

CetteThis gestionis sedone faitusing authe moyenBlueprint de la fenêtre de gestion des calques.window.

IlThe yBlueprint window is specific for each entity category.

This window is the same regardless of the type of entity, but the difference is that it only contains blueprints attached to the given type of entity. Also, the way to access the window starts from the corresponding entity.

To access the Blueprint window for a unegiven fenêtreentity decategory, gestionyou demust calquesuse pourthe chaqueAncestris catégorie d'entité.

Cette fenêtre est la même quelque soit le type d'entité concernée, à l'exception des calques que la fenêtre contient et la manière d'accéder à la fenêtre.

Pour accéder à la fenêtre concernant une catégorie d'entité, il faut utiliser lecontext menu contextuelfrom d'Ancestrisan surentity laof catégoriethe d'entitécorresponding concernée.entity.

• Clic-droitRight-click suron unan individu,individual puisin actionthe Entity card view, then select "ChangerChange l'affichagedisplay desof individus"individuals" pourto ouvriropen lathe fenêtreBlueprint dewindow gestionfor des calques des individusindividual.
• Clic-droitRight-click suron unea famille,family puisin actionthe Entity card view, then select "ChangerChange l'affichagedisplay desof familles"families" pourto ouvriropen lathe fenêtreBlueprint dewindow gestionfor des calques des famillesfamilies.
• IdemDitto pour lesfor Notes, les Sources, lesMultimedia, Multimédias, Les Dépôts,Repositories, etc. CelaThis peutcan sebe fairedone àfrom partirthe deEntity lacard ficheor Entité ou l'Editeurthe Gedcom pourEditor lesfor entitésthe correspondantes.corresponding entities.

VoiciHere commentis accéderhow àto laaccess fenêtrethe deBlueprint gestionwindow desfor calquesindividuals, pourfrom lesthe individus,Entity depuiscard, la fiche Entité,Contextual menu Contextuelby parright-clicking, clic-droit,then puis choisirchoose "ChangerChange l'affichagedisplay desof individus"individuals".

LaThe fenêtreBlueprint dewindow gestionfor desIndividuals calques d'individus apparaît.appears.

QuelleWhatever quethe soitcategory laof catégorieentity, d'entité,the leoperations fonctionnementin dethis cettewindow fenêtreare estthe lesame. mêmeWe etwill noususe décrironsthe l'exempleexample deof lathe gestionBlueprint deswindow calquesfor d'individusindividuals dansin cethe quidescription suit.that follows.

Description 

La fenêtre de gestion des Calques contient les zones suivantes.

• La liste des calques à gauche affiche les calques actuellement disponibles pour la catégorie d'entité préalablement sélectionnée. C'est dans cette liste que l'utilisateur est invité à sélectionner un calque

• La zone de prévisualisation en haut à droite, qui affiche un aperçu du calque sélectionné dans la liste de gauche

• L'éditeur HTML en bas à droite, qui affiche le code HTML du calque sélectionné dans la liste de gauche, et qui permet à l'utilisateur de modifier éventuellement celui-ci. Si vous ne le voyez pas, c'est que la barre horizontale de séparation avec l'aperçu doit être tirée vers le haut avec la souris

• Une série de boutons dans la partie inférieure
  
  • Le bouton Créer un nouveau calque ajoute dans la liste de gauche une copie du calque actuellement sélectionné dans cette même liste, et invite l'utilisateur à attribuer un nom à ce nouveau calque, qui devient alors le calque à modifier
  • Le bouton Effacer un calque supprime de la liste le calque sélectionné
  • Le bouton Insérer une propriété insère une étiquette dans le code HTML actuellement affiché dans l'éditeur HTML, à l'emplacement du curseur
  • Le bouton OK ferme la fenêtre en validant les modifications
  • Le bouton Annuler ferme la fenêtre sans valider les modifications

Cette fenêtre peut s'agrandir en tirant le coin inférieur droit. /!\ TODO : où est le bouton maximiser ?

La zone d'aperçu et la zone de l'Editeur de texte peuvent s'ajuster en déplaçant le séparateur de ces deux zones avec la souris ou en cliquant sur les flèches du séparateur sur la gauche :

Utilisation générale

La fenêtre permet de couvrir les besoins suivants.

• Consultation des calques disponibles. Pour voir ce que donnent les différents calques disponibles sans toutefois les activer (donc, sans refermer le panneau), cliquez successivement sur chacun d'eux dans la liste de gauche, et contrôlez le résultat dans la zone de prévisualisation

• Changement de calque. Pour attribuer un nouveau calque à la catégorie d'entité actuellement sélectionnée dans l'une des vues, cliquer dans la liste de gauche sur le calque choisi et valider en tapant sur le bouton OK

• Modification d'un calque. Par mesure de sécurité, les calques déjà disponibles ne sont pas modificables. Pour modifier un calque existant, il faut d'abord en faire une copie. Sélectionnez celui-ci dans la liste de gauche, cliquez sur Crée un nouvau calque et donnez-lui un nouveau nom. Les différentes modifications devront ensuite lui être affectées dans l'éditeur HTML

• Création d'un calque. Pour créer un nouveau calque, il est recommandé de partir d'un calque existant en sélectionnant celui-ci dans la liste de gauche, puis de cliquer sur le bouton Crée un nouveau calque. Une fois que ce nouveau calque a été nommé, les différentes modifications devront lui être affectées dans l'éditeur HTML

• Suppression d'un calque. Pour supprimer un calque de la liste, sélectionner celui-ci et cliquer sur le bouton Efface un calque.  Vous êtes alors invité à confirmer la suppression du calque en question qui sera définitive.
  
  • Remarque : par mesure de sécurité, les calques déjà disponibles ne peuvent pas être supprimés.

De manière générale, lorsqu'on est sur le point de fermer la panneau en validant les éventuelles modifications au moyen du bouton OK, il faut veiller à sélectionner au préalable dans la liste de gauche le calque retenu pour l'affichage de la catégorie d'entité sélectionnée dans l'Arbre.

Cas pratique

Supposons que nous ayons un calque simple sans photo pour les individus dans l'arbre dynamique, et que voulions insérer sa photo. Les étapes sont les suivantes.

1. Repérer où sont les photos des individus dans les données des entités individus
2. Ouvrir la fenêtre de gestion des calques depuis l'endroit où le calque sera appliqué au final
3. Créer un nouveau calque en copiant un calque simple sans image et le renommant 'MonCalqueIndiArbre'
4. Modifier le calque pour y insérer la propriété photo repérée plus haut, et ajuster sa taille dans le cadre grâce à l'aperçu
5. Sauvegarder le calque et observer le résultat

Repérer où sont les photos des individus

L'ouverture de l'éditeur Gedcom vous permet de repérer où sont les photos pour chaque individu. On voit que c'est dans l'étiquette INDI:OBJE:FILE. C'est ce qu'on voulait savoir.

Ouvrir la gestion des calques depuis l'endroit où le calque sera appliqué

Comme on veut changer le calque des individus pour l'arbre, c'est de là qu'on appelle la fenêtre de gestion de calques.

Donc depuis l'arbre, clic-droit sur un individu. Dans le menu contextuel qui apparaît, on choisit "Changer l'affichage des individus".

Créer un nouveau calque

La fenêtre de gestion voulue apparaît.

Comme on veut faire un nouveau calque, on le crée à partir du calque "Simple" par exemple. C'est plus simple !

Donc on le sélectionne. Dans l'aperçu, on voit alors ce que ce calque affiche pour un individu. Un texte simple sans photo. Nous, ce que l'on veut faire, c'est y rajouter la photo.

Donc on en crée une copie car on ne peut pas modifier celui-là.

Pour cela, on clique sur "Crée un nouveau calque". Apparaît alors cette fenêtre :

On saisit le nom du nouveau calque et on clique sur "OK".

On se retrouve alors sur la fenêtre de gestion précédente avec un nouveau calque modifiable.

On a bien le nouveau calque sélectionné à gauche, le même aperçu en haut à droite, et le code HTML en bas à droite.

On voit que ce calque est modifiable, car les boutons "Efface un calque" et "Insère une propriété" sont cliquables.

On va maintenant changer le code HTML pour y mettre la photo.

Modifier le calque

On voit qu'il y a 4 lignes de propriétés dans le code HTML : le nom, la naissance, le décès, la profession.

La balise HTML <prop> et tout ce qui est à l'intérieur est une spécificité Ancestris. Cela permet de manipuler les données généalogiques du fichier Gedcom.

On veut mettre la photo en dessous, donc on souhaite insérer une autre propriété, celle repérée plus haut : INDI:OBJE:FILE, après les 4 déjà présentes.

On place le curseur sous </table>, étiquette qui marque la fin d'un tableau.

On clique sur le bouton "Insère une propriété" . Une fenêtre apparaît listant un choix de propriétés possibles.

Dans cette fenêtre, on retrouve la ligne Elément Multimédia OBJE, on déplie le clapet pour faire apparaître contenu de OBJE, et on voit la ligne Fichier FILE. On coche la case. Et on fait "OK".

On voit maintenant le calque qui a changé.

Mais ce n'est pas encore ça, car dans l'aperçu, on voit que la photo est trop grande. Et peut-être vaut-il mieux la mettre en haut à droite du texte.

Comme le texte était structuré dans un tableau, il faut en fait mettre l'image dans une case du tableau à créer, à droite du texte. Pour cela on modifie le code HTML comme suit : on déplace la ligne que l'on vient d'insérer dans la structure table en ajoutant une cellule par les balises <td></td>.

Comme on veut également limiter la taille de l'image, on lui ajoute une spécificité Ancestris : on ajoute "max = 20" à la fin, à l'intérieur de la balise <prop ... >,  qui veut dire de limiter la taille de la photo à 20% de la largeur disponible. L'aperçu se modifie en même temps que vous changez le code. C'est bien pratique et permet immédiatement de voir si ce que vous faites est juste. Une fois le code modifié, l'aperçu semble correct, et la fenêtre donne ceci

Le code en bas en jaune fait son office : la photo est dans une cellule de droite du tableau et limitée à 20% de la largeur.

Sauvegarder le calque et observer le résultat

On peut sauvegarder. On clique sur OK et on regarde en même temps l'arbre dynamique. Le calque se modifie.

C'est bon, on a ce qu'on voulait, pour Monsieur, et pour Madame !

Pour aller plus loin

Bien sûr, le plus dur reste donc à connaître le langage HTML d'un part, et à connaître les spécificités ajoutées par Ancestris pour manipuler les données généalogiques.

Pour ce qui est du langage HTML de nombreux sites existent pour vous aider.

Pour ce qui est des spécificités Ancestris, les balises ajoutées au HTML sont

• <prop> ou <ifvalue>
• <name> ou <i18n>
• <media>

Les paragraphes suivants tentent de vous les indiquer tous. 

Balise <prop> ou <ifvalue>

<prop | ifvalue    path="path:to:prop"    [default="path:to:other:prop"]    [format="format"]    [max="n"]    [img="yes"]    [txt="no"]>

Affiche la propriété de l'entité définie par le chemin (path). Si un autre chemin est indiqué, c'est celui qui est utilisé si la première propriété n'est pas trouvé.

Les paramètre format et max sont expliqués ci-dessous.

Le paramètre img peut être mis à 'yes' ou à 'no' pour afficher le picto de la propriété. Par défaut, c'est 'no'.

Le paramètre txt peut être mis à 'yes' ou à 'no' pour afficher la propriété ou non. Par défaut, c'est 'yes'.

Les paramètres entre crochets sont facultatifs.

Cas des noms (propriété NAME)

Pour personnaliser l'affichage du nom, on peut utiliser les sous-propriétés du nom.

Exemple : <prop path=INDI:NAME > dit : <prop path=INDI:NAME:NICK> affichera le nom complet suivi du surnom.

Exemple : DUPONT dit : DUDUCHE

Cas des lieux (propriété PLAC)

Il est possible de forcer précisément le niveau que l'on veut voir affiché pour un lieu.

La syntaxe de la ligne à mettre dans l'éditeur HTML est de la forme suivante

<prop path=INDI:BIRT:PLAC format="2 (7)">

où 2 et 7 sont les rangs des juridictions dans la définition du format des lieux.

Exemple, supposons que nos lieux soient formatés comme suit dans l'étiquette PLAC

Village, Ville, Code_Insee, Code_Postal, Département, Région, Pays

Pour savoir le rang, on compte à partir de 1, donc 2 est la Ville, et 7 est le pays.

Dans ce cas, on peut dire que

• <prop path=INDI:BIRT:PLAC format="2 (7)"> affichera Ville (Pays)
• <prop path=INDI:BIRT:PLAC format="2, 1"> affichera Ville, Village
• <prop path=INDI:BIRT:PLAC format="2 (5)"> affichera Ville (Département)

Autres cas de formatage

• format="$D" : affiche la date complète d'un événement
  • Exemple : <prop path="INDI:BIRT" format="{$D}"> affichera 10 fév 1876.

• format="$y" : affiche l'année de la date d'un événement
  • Exemple : <prop path="INDI:BIRT" format="{$y}"> affichera 1876.

• format="$P" : affiche le lieu complet d'un événement
  • Exemple : <prop path="INDI:BIRT" format="{$P}"> affichera Lyon, 69002, Rhône, France.

• format="$p" : affiche la ville de l'événement
  • Exemple : <prop path="INDI:BIRT" format="{$p}"> affichera Lyon.

• format="$n" : affiche le nom de l'entité liée si elle existe
  
  • Exemple : <prop path="INDI:CHR:XREF" format="{$n}"> affichera Marie STUART, la marraine du baptème.

• format="$N" : affiche le nom complet de l'entité liée si elle existe
  
  • Exemple : <prop path="INDI:CHR:XREF" format="{$N}"> affichera STUART, Marie (° 30 mars 1909 + 16 décembre 2008) (I0298).

• format="$v" : affiche le nom complet de l'entité liée si elle existe avec sa nature
  
  • Exemple : <prop path="INDI:CHR:XREF" format="{$v}"> affichera Marraine : STUART, Marie (° 30 mars 1909 + 16 décembre 2008) (I0298).

• format="$V" : affiche le numéro d'entité uniquement
  • Exemple : <prop path="INDI:CHR:XREF" format="{$V}"> affichera I0298 si l'on reste dans l'exemple ci-dessus.
  • Exemple : <prop path="INDI:BIRT:SOUR" format="{$V}"> affichera S134 l'identifiant de la source de la naissance.

• format="text{$e}" : affiche le texte "text" si la donnée existe, rien sinon.
  
  • Exemple : <prop path="INDI:NAME:SOUR" format="{(*)$e}"> affichera (*) si INDI:NAME:SOUR existe, rien sinon.

• max="n" : limite l'affichage à n% de la largeur disponible. Valable pour une image ou pour du texte.
  
  • Exemple : <prop path="INDI:NAME" max=10"> affichera le nom complet tronqué à 10% de la largeur disponible.

Balise <media>

<media    [path="path:to:media"]    [max="n"]>

Affiche un media de l'entité. Si un chemin est indiqué (path), le media correspondant est utilisé sinon le premier média trouvé est affiché.

Le paramètre "max" limite la taille en largeur comme ci-dessus.

Les paramètres entre crochets sont facultatifs.

Balise <name> ou <i18n>

<name|i18n   [tag="tag"]  [path="path:to:prop"]   [entity="tag"]  >

Affiche le nom de l'étiquette donnée par tag, path ou entity.

Il faut spécifier un des 3 attributs. tag est prioritaire sur path, qui est prioritaire sur entity.

Exemple :

• <name   tag="NAME"> affichera Nom.
• <name   path="INDI:NAME"> affichera Nom.
• <name   entity="SUBM"> affichera Fournisseur d'information.

 

Répertoire contenant les calques

Les calques sont sauvegardés dans le Répertoire utilisateur, dans un sous-répertoire dénommé "ancestris/blueprints".

Le répertoire blueprints, contient lui-même plusieurs sous-répertoires, chacun d'eux ayant l'intitulé de l'étiquette correspondant à l'entité concernée : c'est dans chacun de ces sous-répertoires que se trouvent les différents calques.

• INDI pour les calques des entités individus
• FAM pour les calques des entités familles
• OBJE pour les calques des entités élément multimédias
• NOTE pour les calques des entités notes
• SOUR pour les calques des entités sources
• SUBM pour les calques des entités fournisseurs d'informations
• REPO pour les calques des entités dépôts

Comme ce sont des fichiers au format HTML, vous pouvez les ouvrir avec votre navigateur internet favori.

 

Et vous pouvez même les partager sur la communauté Ancestris ! Merci par avance.

 

 

B-A BA

Il existe un B-A-BA pédagogique sur les calques au format PDF. Vous pouvez le télécharger.