|
Installation, exécution du logiciel
L'installation sous Windows est très simple, le package est fourni sous forme d'un seul fichier Gedail.exe auto-décompressible. Vous lancez l'installation en double-cliquant sur ce fichier, qui vous affichera quelques informations d'usage, une seule question vous sera posée pour le choix du répertoire d'installation qu'il n'y a sans doute pas de raison de changer, l'installation se termine par l'affichage de la présente documentation.
A l'issue de l'installation, tous les fichiers nécessaires ont été mis dans le répertoire d'installation et ses sous repertoires, aucun fichier n'est installé dans les répertoires systèmes. Un dossier est créé dans le menu démarrer, avec les principaux raccourcis utiles, ceux ci sont par ailleurs déposés dans le dossier JFTools sur le bureau, afin de permettre un glisser déposer aisé des fichiers .ged pour lancer l'exécution du programme.
Pour lancer le programme en mode fenêtres, cliquez sur l'icône Gedail 2, vous serez alors totalement guidé et aidé par l'interface.
Pour lancer le programme en mode commandes, cliquez sur l'icône Gedail. En l'absence de paramètres de lancement, le programme vous assiste dans la localisation précise du fichier.ged, dont vous devez indiquer le chemin complet, si il n'y a pas de fichier .opt défini, les options par défaut seront utilisées.
Trois procédures DOS de type .bat sont livrées avec le logiciel, pour les utiliser, il faudra les modifier si vous avez changé le répertoire d'installation C:\Programs Files\JFtools\. Une procédure Gedmarr.bat sort uniquement la liste des mariages, une procédure Gnet.bat sort uniquement la liste éclair au format geneanet, une procédure Gedail.bat permet le fonctionnement courant.
Ces procédures permettent de lancer l'exécution avec l'Explorateur de fichiers par glisser-déposer du fichier .ged sur celles-ci ou leur icône dans le dossier JFTools (il y aura alors recherche du fichier.opt de même nom, du fichier default.opt, sinon prise d'options par défaut du programme).
Les résultats de l'exécution du programme sont accessibles par le browser, en cliquant sur l'icône "result" du dossier JFTools. Le programme garde mémoire du nom du dernier fichier ged traîté qui devient proposé par défaut pour l'exécution suivante.
Le logiciel est fourni avec un utilitaire de désinstallation qui aura le bon goût de laisser les lieux dans l'état où ils étaient avant l'installation, pourvu qu'il ait le fichier install.log de celle-ci.
Si vous êtes Macintoshien ou Lunixien un tant soit peu au fait de la technique de ces drôles de systèmes, vous pouvez télécharger la version .zip qui ne comprend pas le logiciel Perl qui est la plupart du temps préinstallé avec votre système.
Modification des options
Le fonctionnement du logiciel peut être contrôlé par un ensemble de paramètres répondant à la syntaxe du langage PERL.
Si vous utilisez la version 2 de Gedail, le paramètrage et le lancement se font sous contrôle et aide de l'interface en mode fenêtres.
Ces paramètres peuvent aussi être positionnés dans un fichier de type .opt, dont le nom peut être indiqué de manière explicite dans la ligne de commande :
perl gedail.pm mes_options.opt mon_gedcom.ged
ou de manière implicite si un fichier de type .opt de même nom que le fichier .ged contenant les données généalogiques se trouve dans le même répertoire :
perl gedail.pm mon_gedcom.ged ( un fichier mon_gedcom.opt doit alors exister )
En l'absence d'un tel fichier et d'un fichier default.opt, le logiciel utilise les valeurs par défaut positionnées dans le programme, vous pouvez construire des fichiers .opt personnalisés à partir du fichier default.opt.
La liste des paramètres disponibles est donnée ci dessous, vous pouvez commencer à utiliser le logiciel sans vous en préoccuper, les valeurs par défaut sont indiquées. Pour les paramètres de type oui/non, la valeur 1 représente oui, la valeur 0 non.
Paramètre | Défaut | Fonction |
Options de base |
$file_pref | 'Gedi' | Prefixe pour le nom des fichiers ( 1 à 4 Alphanumeriques ) et nom par défaut du sous-répertoire de sortie. Ceci est utile si vous avez plusieurs généalogies à traîter |
$gen_lang | '' | Langages utilisés dans les pages html générées séparés par une virgule (défaut : langage d'installation, tous : 'fr,en,de,nl' ) |
$tpl_frames | 1 | Modèles avec frames (0:sans) |
$sosa_only | 0 | Option de restriction aux ascendants (1 = oui ) |
$desc_only | 0 | Option de restriction aux descendants selectionnés (1 = oui ) |
$est_date | 1 | Estimation des dates de naissance absentes (1 = oui ) |
$est_place | 1 | Estimation des lieux d'origine absents (1 = oui ) |
$conv_date | 1 | Conversion des dates révolutionnaires |
$css_style | 'choco' | Nom du fichier .css feuille de style |
$cd | 1 | Inclure les fichiers pour création de CD auto exécutable. |
Option de traitement des fiches individuelles |
$ind_opt | 1 | Production de fiches individuelles |
$print_notes | 0 | Affichage des notes individuelles niveau 1, professions et titres |
$print_notes_2 | 0 | Affichage des notes individuelles niveau 2 (événements) |
$print_refn | 0 | Affichage de la référence REFN |
$print_sosa | 1 | Affichage du numéro d'ascendant Sosa-Stradonitz |
$print_desc | 0 | Affichage du numéro de descendant d'Aboville |
$print_events | 1 | Affichage des événements |
$print_sources | 0 | Affichage des sources |
$full_place | 1 | Lieux complets ou seulement ville dans les événements |
$full_date | 1 | Dates complètes ou seulement l'année |
$hide_XX | 1 | Cache les dates des personnes contemporaines |
$hide_XX_pics | 0 | Cache les photos des personnes contemporaines |
$check_images | 1 | Recherche des photos dans le repertoire $photo_dir |
Options de traitement par noms |
$nam_opt | 1 | Production d'index par nom de famille |
$nam_by_letter | 0 | Un fichier Index des noms par lettre |
$name_asis | 0 | Pas de formatage des noms |
Options de traitement par lieux |
$loc_opt | 1 | Production d'index par lieu |
$loc_by_letter | 0 | Un fichier Index des lieux par lettre |
$place_links | 1 | Prise en compte des fichiers liens cartes de Cassini |
$place_format | '' | Format des noms de lieux dans le Gedcom (voir ci dessous) |
$place_index | '2' | Critères de tri des lieux (si omis, nom complet du lieu) |
Options de traitement de l'arbre d'ascendance |
$gen_opt | 1 | Traitement des ascendances |
$gen_number | 20 | Nombre de générations produites (0=aucune) |
$name_root | '' | Prénoms /NOM/ de la racine de l'arbre (ex : 'Jules André /DUPONT/') |
$indi_root | '' | Identifiant de la racine de l'arbre dans le champ INDI (ex : 'I27') |
Options de traitement des descendances |
$dsc_opt | 1 | Traitement des descendances |
$desc_number_min | 0 | Nombre minimum de descendants requis (0 : pas de minimum') |
$desc_name_min | 50 | Nombre minimum de porteurs du patronyme (0 : pas de minimum') |
$desc_sosas_only | 0 | Uniquement descendance des sosas masculins |
$desc_by_name | 1 | Un fichier de descendances par patronyme |
Options de traitement de fichier liste-éclair |
$fli_opt | 1 | Production d'un fichier liste éclair .csv |
$fli_geneanet | 1 | Format Geneanet lieu;région;sous-région;pays |
$fli_fq_only | 1 | Prise en compte des patronymes associés à un lieu uniquement |
$fli_sosa_only | 0 | Uniquement les ascendants |
Options de traitement de fichier des mariages |
$mli_opt | 1 | Production d'un fichier des mariages .csv |
$mli_jftools | 1 | Format Jftools lieu;région;sous-région;pays |
$mli_fq_only | 1 | Prise en compte des mariages en un lieu connu uniquement |
$mli_sosa_only | 0 | Uniquement les ascendants |
Options de personnalisation de la page d'accueil |
$main_page | 1 | Génération d'une page d'accueil généalogie (1:oui) |
$base_title | '' | Titre (pas d'identification si omis) |
$banner_pic | '' | Fichier image .jpg .gif .png pour la bannière |
$banner_url | '' | Lien http pointé par la bannière |
$main_header | '' | Texte haut de page (pas de haut de page si omis) |
$main_footer | '' | Texte bas de page (pas de bas de page si omis) |
$main_left | '' | Texte gauche de page (rien si omis) |
$main_right | '' | Texte droit de page (rien si omis) |
$aut_pic | 'arbre.jpg' | Photo de l'auteur ( de type .jpg, .gif ou .png)) |
$aut_name | '' | Nom de l'auteur ( SUBM NAME dans fichier.ged si omis, rien si à blanc) |
$aut_addr1 | '' | 1ère ligne d'adresse de l'auteur (SUBM ADDR dans fichier.ged si omis) |
$aut_addr2 | '' | 2ème ligne d'adresse de l'auteur (SUBM CONT dans fichier.ged si omis) |
$aut_addr3 | '' | 3ème ligne d'adresse de l'auteur (SUBM CONT dans fichier.ged si omis) |
$aut_addr4 | '' | 4ème ligne d'adresse de l'auteur (SUBM CONT dans fichier.ged si omis) |
$aut_ctry | '' | Pays de l'auteur (SUBM CTRY dans fichier.ged si omis) |
$aut_phone | '' | Numéro de téléphone de l'auteur (SUBM PHON dans fichier.ged si omis) |
$aut_email | '' | Adresse email de l'auteur (SUBM EMAIL dans fichier.ged si omis) |
$aut_file | '' | Texte du lien de téléchargement fichier .ged (pas de téléchargement si omis) |
$counter | 1 | Compteur de visites de la page d'accueil |
$counter_init | 1 | Valeur initiale du compteur |
$home_page | '' | Page de retour au plus haut niveau |
Options de traitement des photos pour Gedpics |
$photo_max_size | '640x480' | Taille d'affichage maximale des photos |
$photo_thumb_size | '56x42' | Taille d'affichage des vignettest |
$photo_gallery | '10x5' | Nombre d'images par lignes x par colonnes |
Options avancées : pour les changer, trouvez une très bonne raison |
$out_dir | '' | Répertoire de sortie pour fichiers .html (\Gedi par défaut) |
$php | 0 | Compression des pages envoyées par le serveur (1 = oui ) |
$place_out | '' | Format d'affichage des lieux (si omis, nom complet du lieu) |
@desc_names | ('') | Liste de patronymes séparés par des virgules (défaut : patronyme de la racine + fréquents, tous : ('*') ) |
@priv_refs | (PRV) | Cacher les informations pour ces REFN |
$priv_name | '' | Texte de masquage du nom des références privées |
$priv_note | '#' | Cacher les notes commençant par ce préfixe |
$priv_string | '(XX°)' | Texte de masquage des données contemporaines |
$sosa_link | '#' | Indicateur d'ascendance |
$line_link | '*' | Indicateur de lignée |
$desc_indent | '- ' | Caractères d'indentation des descendances |
$tpl_dir_frames | 'C001' | Préfixe LNNN du nom de répertoire des modèles (Templates) avec frames |
$tpl_dir_noframes | 'B000' | Préfixe LNNN du nom de répertoire des modèles (Templates) sans frames |
$indf_size | 15 | Nombre d'individus par page |
$namf_size | 100 | Nombre d'individus par page d'index par nom |
$namx_size | 500 | Nombre de patronymes par page d'index des patronymes, si 0 une lettre par page |
$locf_size | 100 | Nombre d'individus par page d'index par lieu |
$locx_size | 500 | Nombre de lieux par page d'index des lieux, si 0 une lettre par page |
$dscf_size | 200 | Nombre d'individus par page de descendances |
$dscx_size | 500 | Nombre de branches par page d'index des descendances |
$genf_size | 64 | Nombre d'individus par page d'index par génération |
$sour_size | 250 | Nombre de lignes par page de sources |
$photo_dir | '' | Répertoire où se trouvent les photos ($out_dir\photos par défaut) |
Options expert : pour les changer, trouvez une très très bonne raison |
$gnetdef_country | 'FRA' | Geneanet : Pays par défaut |
$gnetdef_region | 'NPC' | Geneanet : Région par défaut |
$gnetdef_subregion | '' | Geneanet : Sous-Région par défaut |
$dsc_max_index | '30' | Nombre maximum de noms dans l'index des descendances |
$refn_root | 'root' | Valeur REFN du sosa n°1 |
$charset | 'ANSI' | Type de fichier Gedcom : ANSI, IBMPC, MAC, ANSEL, UFT-8 |
Personnalisation des "templates"
Le logiciel réalise la mise en forme des pages html grâce à un ensemble de fichiers modèles ou "templates". Ces fichiers sont au nombre de 11 et doivent se trouver dans un répertoire dont le nom est donné par le paramètre $tpl_dir qui a par défaut la valeur C001 préfixe correspondant à un jeu de templates avec frames, y est ajouté automatiquement le suffixe de la langue -fr pour le français, -en pour l'anglais, -de pour l'allemand, -nl pour le néerlandais. Si vous voulez un jeu personnalisé, entrez son nom en entier LNNN-ll.
Le découpage en pages HTML, le chaînage entre les pages, la constitution de blocs à l'intérieur des pages, la création d'index sont effectués automatiquement, en s'appuyant sur une structure décrite par des commentaires de type <!!page--> <!!epage--> pour début et fin de page, <!!block--> <!!eblock--> pour début et fin de bloc à l'intérieur d'une page, <!!item--> pour la mise en forme d'un élément.
Une génération conditionnelle en fonction de la valeur d'un paramètre $param est possible pour un bloc encadré par <!!if (paramètre)--> et <!!endif-->, si le paramètre vaut 0 ou '', le bloc n'est pas généré.
Un marqueur supplémentaire <!!FILE suff--> est utilisé pour créer un index multi frames avec le template indi-tpl décrivant la mise en forme de l'index général, le suffixe "suff" est ajouté au préfixe des noms de fichiers dont la valeur est donnée par le paramètre $file_pref qui a par défaut la valeur 'Gedi' pour créer des fichiers secondaires pour les frames.
L'ajout des données généalogiques aux modèles de pages décrits par les templates se fait par substitution de valeur à des variables, de la forme #nom_variable ou <!#nom_variable> ou <!#nom_variable valeur_si_vrai>, ces dernières formes conditionnelles étant utilisée dans quelques cas pour éviter la génération de code inutile, comme par exemple des parenthèses vides. La portée de cette substitution en fonction du template et du paragraphe est décrite dans le tableau ci dessous.
Variables communes à tous les templates sauf indi-tpl |
tous paragraphes | |
| #version | version du logiciel Gedail |
| #curr_date | date de génération JJ/MM/AAAA |
| #curr_hour | heure de génération HH:MM |
| #namx_file | lien index par noms |
| #locx_file | lien index par lieux |
| #genx_file | lien index par générations |
| #home_page | page de retour de plus haut niveau |
| #pref | préfixe des noms de fichiers ($pref) |
<!!page----> | |
| #prev_file | hyperlien page précédente |
| #next_file | hyperlien page suivante |
<!!epage---> | |
| #prev_file | hyperlien page précédente |
| #next_file | hyperlien page suivante |
ind-tpl : template des fiches individuelles |
<!!block---> | |
| #ind_refn | libellé reférence : valeur REFN |
| #ind_sosa | libellé sosa : numéro Sosa |
| #ind_id | numéro d'individu INDI |
| #ind_name | nom complet individu |
| #ind_givname | nom court individut |
| #ind_forname | prénom individu |
| #ind_surname | patronyme individu |
| #ind_photo | lien photo |
| #parents_chart | arbre ascendant |
| #ind_birt_date | date de naissance |
| #ind_birt_place | lieu de naissance |
| #ind_deat_date | date de décès |
| #ind_deat_place | lieu de décès |
<!!item----> | |
| #marr_num | numéro d'ordre du mariage |
| #marr_date | date du mariage |
| #marr_place | lieu du mariage |
| #spouse_ref | hyperlien épouse |
| #children_chart | arbre descendant |
<!!eblock--> | |
| #ind_note | libellé notes : valeur NOTE |
| #ind_titl | libellé titles + valeur TITL |
| #ind_occu | libellé occupations : valeur OCCU |
| #ind_events | libellé événements : voir gedigen.opt |
nam-tpl : template des individus triés par nom |
<!!block---> | |
| #rupture | lettre index du bloc |
<!!item----> | |
| <!#item_ref> | pointeur hyperlien individu |
| #ind_filename | hyperlien individu |
| #ind_surname | nom |
| #ind_forname | prénom |
| #ind_birt_date | date de naissance |
| #ind_birt_year | année de naissance |
| #ind_deat_date | date de décès |
| #ind_deat_year | année de décès |
| #ind_place | lieu d'origine présumé |
| #ind_refn | référence (REFN) |
| #ind_occu | libellé occupations : valeur OCCU |
| #ind_dabo | n° d'Aboville |
nami-tpl : template de l'index des patronymes |
tous paragraphes | |
| #ind_cnt | nombre d'individus |
| #fam_cnt | nombre de familles |
<!!block---> | |
| #rupture | lettre index du bloc |
<!!item----> | |
| #surname_ref | pointeur hyperlien patronyme |
| #surname_id | patronyme |
| <!#surname_count> | nombre d'occurences |
loc-tpl : template des individus triés par lieu |
<!!block---> | |
| #block_ref | pointeur hyperlien lieu |
| #rupture | lieu de référence |
<!!item----> | |
| #ind_filename | hyperlien individu |
| #ind_surname | nom |
| #ind_forname | prénom |
| #ind_birt_year | année de naissance |
| #ind_birt_plac | lieu de naissance |
| #ind_deat_year | année de décès |
| #ind_deat_plac | lieu de décès |
| #ind_marr1_year | année du premier mariage |
| #ind_marr1_plac | lieu du premier mariage |
| #ind_place | lieu d'origine présumé |
| #ind_refn | référence (REFN) |
| #ind_occu | libellé occupations : valeur OCCU |
| #ind_dabo | n° d'Aboville |
loci-tpl : template de l'index des lieux |
tous paragraphes | |
| #ind_cnt | nombre d'individus |
| #loc_cnt | nombre de lieux |
<!!block---> | |
| #rupture | lettre index du bloc |
<!!item----> | |
| #place_ref | hyperlien lieu |
| #place_id | index du lieu complet |
| #place_idn | champ n de l'index du lieu |
| <!#place_count> | nombre d'occurences |
gen-tpl : template des ascendants triés par génération |
<!!block---> | |
| #rupture | N° de génération du bloc |
<!!item----> | |
| #husb_sosa | N° Sosa mari |
| <!#husb_ref> | hyperlien mari |
| #husb_name | nom mari |
| #marr_date | date du mariage |
| #marr_place | lieu du mariage |
| #wife_sosa | N° Sosa épouse |
| <!#wife_ref> | hyperlien épouse |
| #wife_name | nom épouse |
| #husb_occu | libellé occupations du mari |
| #wife_occu | libellé occupations de l'épouse |
| #husb_years | années naissance - décès du mari |
| #wife_years | années naissance - décès de l'épouse |
geni-tpl : template de l'index des générations |
tous paragraphes | |
| #sosa_cnt | nombre d'ascendances |
| #gen_cnt | nombre de générations |
<!!page----> | |
| #root | nom de l'individu racine de l'arbre |
<!!item----> | |
| #gen_ref | pointeur hyperlien génération |
| #gen_id | N° de génération |
| <!#gen_count> | nombre de couples |
dsc-tpl : template des descendances triées par branche |
<!!block---> | |
| #rupture | Identifiant de la branche |
| #branch_name | Nom de l'ancêtre |
| #branch_orig | Origine supposée |
<!!item----> | |
| #desc_ref | hyperlien père |
| #ind_dabo | n° d'Aboville |
| #ind_filename | hyperlien individu |
| #ind_surname | nom individu |
| #ind_forname | prénom individu |
| #ind_dates | années naissance - décès |
| #ind_marrs | mariages de l'individu |
dsci-tpl : template de l'index des descendances |
tous paragraphes | |
| #branch_cnt | nombre de branches |
<!!block----> | |
| #rupture | patronyme de la descendance |
<!!item----> | |
| #branch_ref | pointeur hyperlien descendance |
| #branch_id | prénom de l'ancêtre |
| <!#branch_count> | nombre de descendants |
sour-tpl : template des sources |
<!!item----> | |
| #sour_id | identifiant Gedcom de la source |
| #sour_refn | référence |
| #sour_abbr | abbréviation |
| #sour_titl | titre |
| #sour_auth | auteur |
| #sour_publ | publication |
| #sour_repo | lieu d'archivage |
| #sour_caln | cotation d'archivage |
| #sour_text | description |
| #sour_note | note |
indi-tpl : template de la page d'accueil |
ce template n'a pas de paragraphes hormis <!!FILE suff --> | |
| #csv_file | lien fichier liste-éclair |
| #ind_cnt | nombre d'individus |
| #loc_cnt | nombre de lieux |
| #fam_cnt | nombre de patronymes |
| #base_title | titre pour l'identification de l'auteur |
| #banner_pic | Image bannière |
| #banner_url | Lien bannière |
| #main_header | texte haut de page |
| #main_footer | texte bas de page |
| #root_name | nom de l'individu racine |
| #aut_pic | photo de l'auteur |
| #aut_name | nom de l'auteur |
| #aut_addr1 | 1ère ligne d'adresse de l'auteur |
| #aut_addr2 | 2ème ligne d'adresse de l'auteur |
| #aut_addr3 | 3ème ligne d'adresse de l'auteur |
| #aut_addr4 | 4ème ligne d'adresse de l'auteur |
| #aut_ctry | pays de l'auteur |
| #aut_phone | numéro de téléphone de l'auteur |
| #aut_email | adresse email de l'auteur (cryptée) |
| #compteur | Compteur de visites |
| #home_page | lien page de retour de plus haut niveau |
| #main_page | lien page d'accueil généalogie |
| #nam_index | lien index par noms |
| #loc_index | lien index par lieux |
| #gen_index | lien index par générations |
| #dsc_index | lien index descendances |
<!!FILE suff --> | utilisé uniquement avec frames |
| #pref | préfixe des noms de fichiers pour frames |
| #nam_fram2 | lien page noms en 2 frames |
| #loc_fram2 | lien page lieux en 2 frames |
| #gen_fram2 | lien page générations en 2 frames |
| #dsc_fram2 | lien page descendances en 2 frames |
| #nam_fram3 | lien page noms en 3 frames |
| #loc_fram3 | lien page lieux en 3 frames |
| #gen_fram3 | lien page générations en 3 frames |
| #dsc_fram3 | lien page descendances en 3 frames |
|
Choix de présentation
La présentation des pages est régie par une feuille de style gedi.css ( dont le nom peut être changé par le paramètre $css_style ) : polices, casses, couleur, fonds, aspect des liens, ... .Vous pouvez la changer à loisir ou en créer une personnelle. C'est assez simple, référez vous à un guide des feuilles de style, celui ci par exemple.
Choix du langage
Pour l'instant, quatre langages sont supportés, le français (défaut), l'anglais, l'allemand et le néerlandais, pour en changer, il suffit de fixer le paramètre $gen_lang à 'fr', 'en', 'de', 'nl'. Le fichier gedigen_xx.opt contient des chaînes de caractères dépendant du langage :
Chaîne de caractères | Défaut (fr,en,de) | Fonction |
$str_mois | 'Jan,..,Déc' | Libellés des mois |
%str_daty | 'ABT,AFT,BEF,...' | Libellés des dates |
Pour passer à un autre langage, par exemple, à l'espagnol, il vous faut, d'une part créer un jeu de templates adapté à partir d'une copie d'un jeu existant, et le nommer B000-sp, B001-sp d'autre part fixer les valeurs des paramètres de langage dans un fichier gedigen_sp.opt,
par exemple :
$str_mois = 'Ene,Feb,Mar,Abr,May,Jun,Jul,Ago,Sep,Oct,Nov,Dic'; # used for date format
%str_daty = ('ABT'=>'Cerca','CAL'=>'Calcul.','EST'=>'Estim.','BEF'=>'Antes','AFT'=>'Después',
'BET'=>'Entre','AND'=>'y','FROM'=>'Desde','TO'=>'hasta');
Pour créér un jeu de templates adapté à un langage, un utilitaire adapt est disponible dans le repertoire Tools. Il suffit de créér un fichier de traduction, adapt-sp.txt par exemple, sur le modèle de adapt-fr.txt ou adapt-de.txt et de lancer la procédure adapt.bat en faisant un glisser-déposer de votre fichier de traduction.
Si vous avez une vocation de traducteur, créez vos propres templates, et envoyez les moi pour les intégrer (ou seulement vos fichiers adapt-xx.txt, gedigen_xx.opt et gedimsg_xx.pm).
Le paramètre $gen_lang='xx,xx,xx'; indique les langages générés par le programme, (xx = 'fr', 'en', 'de', 'nl'), selon les fichiers gedigen_xx.pm désirés.
Le paramètre $msg_lang='xx'; influe sur les messages affichés par le programme, (xx = 'fr', 'en', 'de', 'nl'), selon le fichier gedimsg_xx.pm sélectionné.
Format des noms de lieux
Il n'existe pas de réel standard de codification des noms de lieux, le format le plus répandu est :
lieu-dit,commune,code,département,région,pays
Le logiciel permet de spécifier le format de vos données par le paramètre $place_format, le format ci dessus est décrit par $place_format = '1,2,3,4,5,6';
1 | lieu-dit ou paroisse |
2 | ville |
3 | code postal ou INSEE |
4 | département |
5 | région |
6 | pays |
[] | zone facultative |
| un espace |
exemples :
$place_format = "2"; | ville |
$place_format = '2[,0]'; | ville[, ignoré] (défaut) |
$place_format = '2[,1],6'; | ville[,hameau],pays |
$place_format = '1,2,5'; | lieu-dit, ville, région |
$place_format = '1,4,5'; | ville, département, région |
$place_format = '1,2,4,3,5,6'; | hameau ou paroisse, ville, département, code, région, pays |
$place_format = '1 2 3 4 5 6'; | hameau ou paroisse ville code département région pays |
$place_format = '1,2,3,4[,5],6'; | hameau ou paroisse,ville,code,departement[,region],pays |
$place_format = '2,3,4,5,6,1'; | ville,code,département,région,pays,lieu-dit |
$place_format = '2[,3],4,5,6'; | ville[,code],département,région,pays |
$place_format = '1;2;3;4;5;6'; | lieu-dit;ville;code;département;région;pays |
$place_format = '2[,1][ (3)]'; | ville[, paroisse][ (code)] |
$place_format = '2[ (6/5)]'; | ville[ (pays/région)] |
Par défaut, la commune est prise en tête du nom de lieu. Si le fichier .ged contient une description de format par des enregistrements PLAC et FORM, elle est prise en compte.
Ceci influe sur la constitution de l'index des lieux, celui ci peut prendre comme critères de tri une combinaison des zones existantes dans le format, par le paramètre $place_index.
exemples :
$place_index = '2'; | ville (défaut) |
$place_index = '32'; | code ville |
$place_index = '652'; | pays région ville |
$place_index = '65432'; | pays région département code ville |
L'ensemble des zones d'index peuvent être reprises pour affichage dans le template loci-tpl par la variable #place_id, ou seulement des zones sélectionnées par les variables #place_idn ou n est le numéro de 1 à 6 désignant la zone.
exemples :
$place_index = '2'; | #place_id | ville (défaut) |
$place_index = '32'; | #place_id2(#place_id3) | ville(code) |
$place_index = '652'; | #place_id2/#place_id6 | ville/pays |
$place_index = '65432'; | #place_id | pays région département code ville |
Un autre paramètre $place_out permet de contrôler le format d'affichage des lieux dans les pages détail des lieux, par exemple pour éviter les suites ,,,, en cas de zones vides.
exemples :
$place_out = '1 2 3 4 5 6'; | hameau/paroisse ville code département région pays |
$place_out = '2 1 (3) '; | ville hameau/paroisse (code) |
Liens d'information sur les lieux
Le logiciel peut associer à chaque lieu un lien vers une page HTML, une photo ou une carte, celui ci sera indiqué par une icône en forme d'oeil.
Il suffit de créer un fichier de type .csv et de nom placelink-xx dans le repertoire gedail, ( xx suffixe, par exemple un ou plusieurs chiffres ), ce fichier contiendra une ligne par lieu :
nom de lieu;lien; où lien sera une URL :- http://www.site.com/monlieu.html
- ou http://www.site.com/monlieu.jpg
- ou ../photos/monlieu.jpg (si vous mettez la photo sur votre site dans le repertoire photos)
- ou javascript:cassini('N','CC') (un appel à un javascript fourni d'affichage de carte Cassini, N étant le n° de la carte et CC ses coordonnées AA à ZZ sur le site Gallica).
Un fichier placelink-0.csv étant fourni par défaut avec liens javascript sur l'ensemble des cartes Cassini de Gallica. Un ensemble de fichiers placelink-01.csv à placelink-95.csv pour les divers départements est également fourni dans le repertoire placelinks, il suffit de ramener dans le repertoire gedail ceux qui vous concernent.
Codes postaux des pays
Le logiciel utilise des fichiers de codes postaux pour la determination des codes pays, région, sous-région utilisés pour Geneanet, en standard sont fournis les codes de France, de Belgique et du Luxembourg, respectivement codes-FRA.csv, codes-BEL.csv et codes-LUX.csv.
Le format en est :
nom en minuscules sans accents; code postal; sous-région Geneanet; région Geneanet
Ces fichiers relativement volumineux sont utilisés par le programme gedail.pm dès lors qu'il sont dans le même repertoire, évitez de les y mettre si ils sont inutiles pour votre ascendance.
Vous pouvez constituer des fichiers codes-XXX.csv pour d'autres pays, et me les faire parvenir, tout le monde pourra en profiter
Téléchargement de votre site
Si toutes les options sont choisies, le logiciel gedail crée de nombreux fichiers, environ un fichier d'environ 20 Kilo-octets par dizaine d'individus, soit environ 500 fichiers totalisant près de 10 Mega-octets pour une base de données de 5000 individus.
L'index de plus haut niveau a pour nom pref_ind.html où pref est le préfixe choisi ( par défaut Gedi ), vous devez rattacher cette page à la page d'accueil de votre site, qui est par défaut index.html, par un lien du genre <A HREF="pref_ind.html">ma généalogie</A>, si vous n'aviez pas de site web, une page index.html réalisant un lien automatique est générée par Gedail.
Pour charger ces fichiers sur le serveur de votre fournisseur d'accès, vous devez utiliser un logiciel FTP comme les graticiels LeechFTP, SmartFTP ou Filezilla. Si vous avez une connexion à vitesse ordinaire, c'est à dire entre 28kbps et 56kbps, la première fois, vous pouvez mettre près de 3/4 d'heure pour charger toutes les pages HTML générées par Gedail.
Les fois suivantes, le logiciel ne recréant que les fichiers ayant subi des modifications, vous pouvez ne recharger que ces derniers, en triant et selectionnant par rapport à la date de création du fichier.
|