V 4.1.3b

Manuel d'utilisation de KStableau pour publier un arbre graphique
et analyser les liens de parenté

Genealogica
   Grafica

KStableau (V 4.1.3b) crée des tableaux d'ascendance, descendance ou d'implexes.

Le programme KStableau permet de créer des pages HTML,
pour l'affichage et la publication sur le WEB de diagrammes d'ascendance ou de descendance .

Ce programme est un shareware : son utilisation privée est libre; pour une utilisation commerciale, contactez l'éditeur à tdeneef@qolor.nl.
Comme pour un copyright, laissez l'information sur le programme intacte dans vos diagrammes.

Cette version : V 4.1.3b est la dernière version publiée.
La version suivante est Genealogica Grafica

Cette traduction est une mise à jour personnelle de la traduction publiée par Philippe Horemans pour la version V 3,6 sur son site.
Je le remercie publiquement pour son travail qui m'a permis de comprendre le fonctionnement de ce logiciel.

Le programme KStableau est un programme Windows pour réaliser des arbres généalogiques dans le format HTML pour publication sur le WEB.
Il n'est décrit ici que l'utilisation du programme avec un fichier gedcom.
Il y a d'autres options d'entrée, ceux-ci étaient à voir sur la page aide en anglais qui n'est plus accessible, ce programme étant remplacé par une nouvelle version Genealogica Grafica

Le manuel est organisé dans l'ordre chronologique d'utilisation,

• en commençant par le téléchargement du programme KStableaux.
• puis une première généalogie ascendante (Pedigree).
• ensuite des améliorations de présentation.
• ensuite viendront les chapitres spéciaux sur les caractéristiques des arbres descendants (Généalogie).
• et de la visualisation des implexes (inbreeding) et du calcul et de la visualisation de la parenté (Kinship).

Il est recommandé de créer un nouveau dossier C:/Genealogie de sorte que les fichiers d'entrée et de sortie restent ensemble.
• Pour télécharger le programme d'installation cliquez ici.
• Installer KStableau dans Program Files de Windows

Parfois Il est possble de choisir un certain nombre d'options en préparant un fichier gedcom.

• Choisissir seulement les valeurs par défaut en ce qui concerne les paramètres.
• S'il y a une option permettant d'exclure certaines personnes de l'exportation, ne pas la retenir, choisissir d'inclure tout le monde.

Il est possible de placer le fichier gedcom - appellé par exemple 13_05_2006.ged - dans un dossier par exemple celui utilisé par le programme de généalogie ou le nouveau dossier C:/Genealogie.

Sélectionnons 13_05_2006.ged avec le second bouton (Gedcom : Ouvrir). Ainsi, son nom apparaîtra dans le champ à droite. KStableau lira le fichier et fera divers tests sur son intégrité. S'il trouve quelques contradictions, il affichera ces dernières dans le panneau de compte rendu en bas à droite. S'il y a des erreurs, leurs adresses seront indiquées. Mais à moins que la liste soit importante, il est possible de laisser ce travail pour plus tard. Il y a un fichier spécial d' aide des erreurs d'entrée pour nous assister.

Quand il n'y a aucune erreur, le panneau de compte rendu indiquera le format du gedcom et des statistiques. Consultons la page d'aide pour déceler les difficultés avec des caractères exotiques (diacritiques) si plus tard nous constatons que des lettres spéciales (telles que le é) ne sont pas représentées correctement.

Choisissons maintenant la langue (en haut à droite). Ce n'est pas la langue de l'interface utilisateur mais la langue utilisée dans les fichiers de sortie. Quand nous indiquons "français" le résultat d'un mariage se lira "Elle s'est mariée ...", alors qu'en "anglais" il se lirait "She married ...". En général nous choisirons la même langue que celle du gedcom, puisque la généalogie contiendra des informations au sujet du métier d'un individu, etc...

Cliquons maintenant le bouton "Construire".

Le programme établira une liste de personnes pour qui une ascendance pourrait être construite. Pour ne pas surcharger d'information, tous les individus ne seront pas affichés. Quand le gedcom contient des milliers de noms, seulement ceux qui ont 4 ou 5 générations d'ancêtre apparaîtront. Pour de plus petits dossiers, ce seuil sera abaissé à 3 ou 2 générations.

Cette liste sera triée par nom de famille et si l'année de naissance d'une personne est connue elle apparaîtra entre parenthèses. La profondeur de l'arbre pour une personne sera affichée par exemple "<6>"(si le nombre d'ascendants pour cette personne remonte jusque 6 générations).

Le choix peut être fait en double-cliquant, avec la touche "Entrée" au clavier ou en cliquant "OK".

Pour les très gros dossiers, il est possible de ne pas voir le nom recherché si le nombre d'ascendants dépasse 11 générations.

Si l'on quitte sans choix, KStableau choisira le personnage de base avec l'arbre le plus profond.

Tous les noms seront alors visibles.

A noter que l'on peut accéder à une personne en cliquant dans la liste de choix et en tapant les premières lettres du nom.)

Le personnage de base qui est retenu est appeller "De Cujus". Dès lors, la prochaine fois que l'on cliquera à nouveau sur "Construire" , le "De Cujus"sera déjà sélectionné. Il est possible de sauter cette étape de choix en maintenant la touche Ctrl en cliquant le bouton "Construire".

Les calculs déterminent qui est dans l'ascendance et s'il y a des doublons ou pas présents dans l'arbre. Ces calculs ne prendront pas longtemps. Le panneau de compte-rendu indiquera combien de personnes sont dans le gedcom et combien sont dans le diagramme d'ascendance.

Déplacons la souris au-dessus d'un nom et un message de survol montrera l'essentiel sur cette personne

Doule-cliquer sur une boîte contenant un nom : une nouvelle fenêtre s'ouvrira avec les ancêtres, les colatéraux et les descendants immédiats de la personne. Dans cette fenêtre il est possible de continuer à double-cliquer et ainsi nous pouvons nous déplacer dans le gedcom entier. La fenêtre se fermera automatiquement quand nous cliquerons sur le diagramme d'ascendance principal.

S'il y a des implexes (endogamie, consanguinité) dans l'ascendance, les boîte correspondantes apparaitront grises. De telles personnes apparaîtront plusieurs fois. Leurs ancêtres ne seront affichés qu'une fois. Cliquons sur une de ces boîtes grises pour trouver où se trouve l'autre boite dans le diagramme.

Le diagramme a été tracé avec des dimensions par défaut. Elles peuvent ne pas convenir à nos besoins.

Considérons ce cas où des membres de la famille voient leurs noms tronqués, ou si la taille de l'arbre ou celle des boîtes sont trop grandes ou trop petites. Faire les modification dans "Dimension des boîtes"

Quelques remarques :

• Pour un changement de marges ou de couleurs il faut retourner à l'écran principal. L'effet de ces paramètres n'apparaîtra pas dans l'affichage écran de l'ascendance, mais affectent les marges et les couleurs des pages HTML (ce que nous verrons ci-dessous);

• "Longueur nom" indique combien de lettres d'un nom seront affichées. Le reste du nom sera complété par des "... ". Ceci est plus adapté à la création des pages HTML qu'à l'affichage écran puisque la plupart des navigateurs (browsers) agrandiront les cellules, alors qu'à l'écran le nom sera tronqué. Le programme essaiera de condenser de longs noms en abrégeant les éléments non essentiels (comme "vd" au lieu de "van der").

Une solution serait d'augmenter "Largeur de boîte" aussi bien que "Longueur nom" ou de réduire "Taille de police" .

En conclusion, dans la fenêtre "Voir", cliquez sur "Aide" si vous avez oublié quelque chose.

Le tableau d'options ci-dessus permet de choisir la présentation des noms suivant ses désirs.

Remarque importantes : Si le choix se porte sur le format des nom en majuscules, Cette présentation n'exixtera que dans la présentation du détail des personnes, mais pas sur l'arbre généalogique.
Le nom de famille passe avant les prénoms. exemple :
" NOM Prénoms " au lieu de " Prénoms Nom "
D'autre part, si les noms comportent des lettres accentuées, ces lettres restent en minuscules.

En définitif, ce tableau de présentation ne permet pas de faire beaucoup de modification à la présentation.

Revenons à la fenêtre principale et regardons le message qui apparait quand nous survolerons le champ "Structure du nom" avec la souris..

Ce message liste des options de conditions (avec des lettres) et des options d'affichage (avec des chiffres).

La valeur par défaut est la combinaison "n2z1", signifiant
• l'affichage des individus portant le même nom de famille que le "De Cujus" avec l'initiale du prénom + le nom de famille.
• et l'affichage de tous les autres individus avec le nom de famille seulement.

Changons le paramètre de "Structure du nom" en "z1" et regardons le résultat avec "Voir" : Les initiales de prénom ont été abandonnées pour tout le monde.

Quand nous survolons le champ "Structure du nom", une des conditions est "p", "même nom que les parents". Cela s'appliquerait à toutes les personnes qui ont le même nom que leurs parents.
Changons le paramètre de "Structure du nom" en "p2z1" et nous verrons que des filles et les fils avec le même nom de famille qu'un de leurs parents sont affichés avec des initiales tandis que tous les autres le sont juste avec le nom de famille.

La mise en forme du nom fonctionne comme suit. Pour tout les individus dans le diagramme les conditions dans le paramètre sont examinées de gauche à droite.
La première qui est vraie est appliquée. Par conséquent "p2z1" est lu comme
"p" - est-ce que cette personne a le même nom de famille qu'un des parents?
Si oui, appliquer "2" : l'initiale+ le nom de famille.
Si non: "z" - est-ce que cette personne correspond à 'Quelqu'un d'autre'?
C'est naturellement le cas, donc appliquer "1" : montrez le nom de famille.

Ceci montre toute la flexibilité dans la façon dont les noms peuvent apparaître. Mais çà peut ne pas être suffisant. Ainsi, en dernier recours, en faisant un clic droit sur une personne on peut changer le nom manuellement. Ce choix sera limité à une des options de "Structure du nom" .

NOTA : le paramètre "@", présent dans le survol de "Structure du nom" n'est pas applicable aux ascendances.

Le cadre supérieur contient l'arbre d'ascendance avec des couleurs, des tailles et des noms qui ont été choisi précédemment. Le cadre du bas contient le texte; c'est une description des individus de l'ascendance.

Si nous survolons un nom, alors un message avec nom et prénoms et (si connue) l'année de naissance apparaîtra. Quand nous cliquons le nom, le cadre inférieur affichera le texte concernant cette personne.

Pour les implexes, des boîtes pointillées ont remplacé les ancêtres communs en grisés. Le message de survol indiquera que l'alter ego existe mais des lignes de raccordement ne peuvent pas être affichées.

Une petite fenêtre est toujours présente pour faciliter un retour à la fenêtre principale.:

Quelques précisions peuvent encore être apportées. D'abord nous pouvons ne pas aimer les couleurs que nous voyons maintenant pleine page. Revenons à la fenêtre principale et changons-les. La même chose s'applique aux dimensions et aux noms. Si l'affichage des boîtes chevauche le titre, il est possible de modifier les marges.

Il y a encore d'autres paramètres de sortie à considérer. Ils sont dans le panneau "Présentation" de la fenêtre principale.

Si le champ "Titre") n'est pas renseigné, KStableau créera un titre à partir du "De Cujus". Il est possible de le l'indiquer explicitement.
Prendre garde qu'un titre saisi manuellement ne change pas automatiquement avec le changemant de "De Cujus".

Le champ "URL de retour" dans le coin en haut à gauche peut contenir un adresse internet. Si c'est le cas, le diagramme HTML aura un lien à cet URL . Employer ceci pour ramener les visiteurs à la page appelante (page d'accueil).

Le champ "Texte de l'URL" contient le texte qui apparait quand la souris survole le lien "URL de retour".

"Cadre principal" peut prendre les valeurs
• valeur "_ top" (la nouvelle page remplace la fenêtre entière),
• valeur "_ blank" (la page appelante apparaîtra dans une nouvelle fenêtre de l'afficheur)
• ou valeur "_ self" (la page appelante apparaîtra dans le cadre supérieur, laissant le texte visible dans le cadre inférieure).

"Police" est évident. Quelques polices affichent les caractères exotiques (tels que le é) d'une manière ... exotique !

"Nom cadre liens" n'est 'important que quand vous projetez ne pas employer le texte de KStableau produit pour le cadre inférieur mais appeler directement des fiches produites par votre programme de généalogie.
Examinez la FAQ pour plus de détails.

Et finalement , reste à examiner les noms de fichiers . Si le champ "Tableau" est vide, aucun fichier HTML ne sera produit. Si un quelconque des autres est vide, ce dossier particulier ne sera pas créé:

Tableau est le nom de l'arbre HTML.
Liens texte est le dossier avec les détails texte dans le cadre inférieur.
Pages de cadres est le nom du fichier qui contient les cadres supérieur et inférieur. C'est cette page qu'il faut lancer pour afficher l'arbre et le texte dans deux cadres simultanément.
Aperçu est le nom d'un fichier contenant un aperçu, une vue globale de l'arbre. C'est utile quand l'arbre devient très grand. Le lien apparaîtra dans le coin en haut à gauche.

Présentation de la page HTML : coin gauche haut

Dans cet partie d'écran tous les liens sont regroupés.

- Retour ( URL de retour ) commentés ci-dessus.
- Vue d'ensemble ( Aperçu : vue globale de l'arbre ) commentés ci-dessus.
- Info est un lien à la page d'accueil de KStableau de sorte que les visiteurs puissent trouver KStableau (il est là comme copyright).
- Le lien "de Cujus"" apparaîtra dans de grands arbres. Le cliquer centrera le "De Cujus" dans l'écran.

Mais quand nous créerons des diagrammes pour différents personnages de base, alors peut-être que nous voudrons sauvegarder les différents réglages dans différents dossiers de paramètre.

Quand nous rouvrirons KStableau pour reprendre un travail, nous utiliserons le bouton en haut à gauche ( Paramètre Ouvrir ) et nous sélectionnerons notre fichier de paramètres (tel que "bastien.txt". Le programme traitera immédiatement le fichier gedcom et rétablira les paramètres.

Nous ne décrirons pas ici comment créer un page d'accueil ou comment télécharger. Il y a de nombreuses aides sur Internet .

Tout ce que nous devons faire c'est placer les fichiers HTML avec notre page d'accueil. Un lien vers ks.htm sera créé dans la page d'accueil, s'il a été créé une page de cadres (Frames page).
S'il a été créé seulement un arbre, sans texte et sans page de cadres, le lien sera alors avec kstableau.htm (le fichier du champ "Tableau").

Il faut prendre garde au fait que le HTML est sensible à la casse : "KStableau" n'est pas identique a "kstableau".

Les dossiers sont "HTML compatible" comme définis par le "HTML standardization body". Mais parfois, quelques navigateurs internet les interprêteront différemment que d'autres. En particulier l'affichage des boîtes pointillées change (seulement dans le cas d'Implexe). Un navigateur plus ancien ne les montrera pas en pointillé. Sur un Mac, l'alignement des textes peut être différent.

Les programmes de généalogie (voir www.Ancestrologie.com ou www.LegacyFamilyTree.com) peuvent produire un ensemble de fichiers HTML qui sont hyperliés entre eux (une fiche est produite pour chaque personne de la base de données). Ces fiches peuvent contenir des images etc... Chacune de ces fiches html est appelé en utilisant le numéro d'index de l'individu (par exemple: 45.htm). C'est le nombre qui identifie l'individu dans le gedcom. (le NIP dans Ancestrologie).
Si nous voulons lier les boîtes d'un arbre aux fiches généalogiques, plutôt qu'au dossier d'ascendance en texte produit par KStableau, il faudra indiquer où se trouvent ces fiches, par rapport au diagramme de l'arbre. C'est dans"Liens texte" qu'il faut indiquer ce chemin. Si ce champ contient un nom de fichier valide, alors tous les liens de l'arbre pointeront sur ce fichier, tel que "KStekst.htm#I101" pour la personne avec ID=i101. Mais si le nom de fichier contient des informations parasites, ces informations parasites seront remplacées par l'identification de la personne (sans lettre de préfixe), telle que vous l'avez dans la généalogie.

Ainsi, si les dossiers de généalogie ont l'extension ".htm" et sont stockés dans un sous-dossier appelé "subdir" dans le dossier où l'arbre (Tableau) a été enregistré, il faut indiquer"subdir/#.htm" dans "Liens texte". S'ils ont l'extension ".html" et sont stockés dans le même dossier que l'arbre (Tableau), indiquer alors "#.html" dans "Liens texte" etc ...

Il est utile d'employer les conventions DOS pour se diriger dans les dossiers parents. ("../#.htm " pointera sur le dossier parent de l'arbre (Tableau) , etc...)

Si nous renseignons également "Pages de cadres" (ce dont nous n'avions peut-être pas besoin puisque nous utilisons notre dossier de généalogie) alors le cadre inférieur contiendra le fichier du "De Cujus".

Pour exemple, le site de Philippe Horemans . . . . ou le site de mes arrières petits-enfants.

Les explications ci-dessus étaient centrées sur les ascendances. Il est également possible de faire des diagrammes de descendance (genealogy) et celà d'une manière très semblable. Voir ici les particularités.

La première chose à avoir à l'esprit avec les descendances, c'est qu'elles sont souvent beaucoup plus importantes (en termes de volume de fichier) que les ascendances. Quand les fichiers deviennent trop gros, ils perdent de leur intérêt pour Internet et pour la résolution de l'affichage. Aussi, il est souhaitable de dédoubler la descendance en plusieurs parties. Faire deux générations dans un diagramme et puis des diagrammes séparés pour les petits-enfants. Ceci impliquera une préparation que nous ne pouvons pas détailler ici.

Il faudra choisir le type de diagramme : tous les descendants du "De Cujus", ou seulement la lignée masculine, ou seulement la lignée patronymique. Ce choix se fait avec les boutons-radio "inclut les descendants".

(pour l'option "Proper display" et certaines des autres options de la page d'aide était bien utile (en anglais) mais elle n'existe plus.

L'utilisation du champ "Structure du nom" est plus appropriée pour des descendances que pour des ascendances, mais son fonctionnements est identique.

Considérons en particulier l'option d'affichage qui laisse les cellules en blanc si la personne est encore vivante.

Il existe cependant une option supplémentaire dans la mise en forme du nom : nous pouvons fermer la chaine de paramètre avec le symbole "@" . Ceci demandera au programme d'accentuer les branches de l'arbre qui relient les descendants ayant (plus ou moins) le même patronyme que le 'De Cujus". Comme pour l'affichage des noms nous pouront également changer manuellement l'accentuation dans la fenêtre de descendance (Bouton Voir).

Le fichier des textes (dans le cadre inférieur) est légèrement plus complexe que son équivalent en ascendance. Il permet des liens dans le texte, entre les individus : Les nombres derrière les descendant renvoient à leur paragraphe. Les nombres dans la marge gauche renvoient aux parents.

Il est possible de réaliser des pages concernant l'implexe et la parenté avec Genealogica Grafica.
Est-ce suffisant de dire ici que ces diagrammes se comportent à l'affichage comme l'affichage des diagrammes d'ascendance.

Le successeur de KStableau est Genealogica Grafica qui offre les mêmes fonctionnalités que la cartographie KStableau, mais avec des améliorations, telles que :
* une bien meilleure interface utilisateur
* de nouvelles cartes (délais, des arbres)
* carte géographique des lieux de naissance
* capacités pour le phrasé rapport personnalisé
* supérieure des contrôles de cohérence Gedcom
* l'inclusion de notes et sources Gedcom
* édition du tableau
* traduction de l'interface utilisateur dans une autre langue

La dernière version (V4.1.3) de KStableau peut encore être trouvés sur Internet.
Elle est disponible ici en cliquant sur ce lien de KStableau.

Nota :

Genealogica Grafica est disponible ici ou
sur le site Genealogica Grafica V4.1.3