Utilisation du programme Ged2wwwf.exe ATTENTION ! SI VOUS PASSEZ D'UNE ANCIENNE VERSION A CELLE-CI (càd. VOUS EXECUTEZ UNE 1.5.x POUR LA PREMIERE FOIS), DETRUISEZ LE FICHIER GED2WWW.DAT, OU LE COMPORTEMENT POURRAIT ETRE INCOHERENT. Note créée le 7 mars 1998. Dernière mise à jour: 26 mai 2001. CECI EST LA DERNIÈRE VERSION DE GED2WWWF (1.5.5 b, du 24 mai 2001). Les développements sont maintenant consacrés à un nouveau programme: GénàToile J'espère qu'il vous plaira autant qu'à moi. Amitiés généalogiques sincères, Jean-Baptiste Principales nouveautés des versions 1.4 et 1.5 f&w -------------------------------------------- Option de présentation des pages de données sous forme de tableaux. Option de décalage à droite de toutes les pages créées. Option de création ou non des listes Lieux/Patronymes et Patronymes/Lieux. Option d'affichage ou non de la référence (tag REFN) Option d'affichage ou non des NOTEs Option d'affichage ou non des métiers (tag OCCU) Tri des lettres accentuées (presque) adapté au langues d'Europe occidentale Possibilité d'affichage des numéros de Sosa Droits d'utilisation -------------------- Ce programme est gratuit; vous pouvez le distribuer et/ou le modifier en respectant les termes de la license publique générale (GNU, General Public License, publiée par la Free Software Foundation). Les droits d'auteur s'appliquent néanmoins sur ce programme. Se référer au document "Copying" (en anglais), édité par la Free Software Foundation. Si vous désirez disposer des sources de ce programme, vous pouvez les obtenir auprès de: Jean-Baptiste Fahy jbfahy@nordnet.fr Ce programme a été écrit à l'origine par Leslie Howard. Exécution de Gedwwwf.exe ------------------------ Dans sa version actuelle (1.5.4), ce programme tourne uniquement dans une fenêtre DOS de Windows 95, 98, NT ou 2000. Pour l'exécuter sous Windows NT ou Windows 2000, assurez-vous de disposer du programme sort.exe, et que ce programme peut être exécuté depuis une fenêtre DOS. Sous Windows NT ou 2000, sort.exe se trouve en général dans le répertoire c:\winnt\command. Ged2wwwf nécessite la présence du fichier TEXTE.TXT dans le répertoire de travail, fichier qui contient les textes dans la langue que vous aurez choisie. Actuellement, le français le néerlandais l'allemand, l'anglais, le danois et le suédois (partiellemnt) sont disponibles. Pour le français, changez FRANCAIS.TXT en TEXTE.TXT Pour l'anglais, changez ENGLISH.TXT en TEXTE.TXT Pour le néerlandais, changez NEDERLND.TXT en TEXTE.TXT Pour l'allemand, changez GERMAN.TXT en TEXTE.TXT Pour le danois, changez DANSK.TXT en TEXTE.TXT Pour le suédois, changez SVENSK.TXT en TEXTE.TXT Ged2wwwf consomme un fichier au format GEDCOM. Il crée (s'il n'existe pas déjà) un sous-répertoire nommé HTML, sous le répertoire de travail. Le programme pose une série de questions, puis génère les pages html dans le répertoire HTML. Les paramètres d'exécution peuvent être sauvegardés (dans le fichier ged2www.dat) pour des exécutions ultérieures. La particularité de Ged2wwwf est de créer une 'liste des lieux et des patronymes qui y apparaissent' et une 'liste des patronymes et lieux où ils apparaissent'. Les lieux de ces listes peuvent être triés à votre guise. Voyez la note 'Tri des lieux'. Ged2wwwf peut intégrer des photos au format JPEG pour tout individu. Ceci se fait sans déclaration particulière, sur simple test de l'existence de fichier I.JPG dans le sous-répertoire HTML, où représente le numéro d'individu, au sens du fichier gedcom (exemple: si le fichier I1.jpg existe, son contenu sera affiché à côté de l'individu repéré par @I1@ dans le fichier gedcom). Attention, les fichiers I.jpg doivent figurer dans le même répertoire que vos fichiers html. N'oubliez-pas de les transférer en même temps que vos pages html. D'autre part, l'affichage de photos réclame quelques kilo-octets, et donc au détriment de la vitesse d'affichage. Ged2wwwf intègre également, s'il est présent, le fichier BOTTOM.TXT à la fin de chaque page générée, sauf la page de garde. Ceci peut aider ceux qui ont des contrats avec leurs fournisseurs d'espace pour pages personnelles, afin d'inclure des annonces commerciales. Le fichier TOP.TXT, s'il est présent, est inséré dans chaque page générée, entre les balises et . Vous pouvez gérer la taille des pages générées avec le paramètre "nombre de groupes de familles par fichier créé". Une petite valeur génère des fichiers de données plus petits. Vous pouvez choisir une image de fond de page, et aussi de décaler sur la droite les informations générées. Essayez par exemple le fichier "reliure.gif" comme fond de page, et choisissez Pages décalées à droite. Liste Eclair ------------ À la demande de plusieurs utilisateurs, la liste éclair est remise en service avec la version 1.5.5. Ged2wwwf génère, dans le répertoire par défaut, le fichier ListeEcl.txt, liste éclair issue de votre fichier au format GEDCOM. Pour que cette liste éclair soit complète, Ged2wwwf requiert que vos déclarations de lieux dans le fichier GEDCOM soient constituées de la manière suivante: () Actuellement, la présence des parenthèses est indispensable pour que Ged2wwwf puisse isoler la commune du département (ou la commune du pays). Indication de vos noms, adresse, etc... --------------------------------------- Toutes les données destinées à figurer sur les pages créées doivent être au format HTML: un "é" s'écrit "é" "Thérèse" s'écrit "Thérèse" Consultez une documentation sur le codage html pour plus ample information. Indication de votre page personnelle ------------------------------------ N'indiquez pas le préfixe 'http://' avant votre adresse. Indiquez par exemple: home.nordnet.fr/~jbfahy pour obtenir http://home.nordnet.fr/~jbfahy Tri des lieux ------------- La réponse à la question 'Donnez le type de tri des lieux' permet de trier les lieux à votre guise dans les listes Lieux/Patronymes et Patronymes/Lieux, à condition que vos lieux soient structurés. Pour trier vos lieux sur Département/Ville: - si vos lieux sont codés 'Ville,Département', indiquez '2,1' - si vos lieux sont codés 'Ville (Département), indiquez '2(1)' Pour trier sur Pays/Département/Ville et ne pas faire figurer les paroisses, si vos lieux sont codés 'paroisse,Ville,Département,Pays', indiquez '0,3,2,1'. 0 signifie de ne pas faire figurer un élément. Les éléments à faire figurer peuvent aller de 1 à 9. Utilisez comme séparateurs d'éléments tout sauf des espaces, des lettres et des chiffres. La version 1.5 introduit une table des lieux. Elle est composée par les éléments 1 et 2 décrits dans le type de tri des lieux. La version 1.5 permet de choisir entre un tri externe ou interne. Le tri interne entraîne des temps de traitement GIGANTESQUES (plusieurs heures si votre fichier contient quelques milliers d'individus). Ne choisissez le tri interne que si les pages lieux/patronymes n'apparaissent pas. Note générale sur le fichier TEXTE.TXT ----------------------------- 1- La présence du fichier TEXTE.TXT dans le répertoire par défaut est indispensable, sinon, vous obtiendrez les messages suivants: Fatal : Fichier des messages manquant Fatal : Missing messages file La lecture de la suite de ce paragraphe n'est utile que si vous voulez modifier le fichier TEXTE.TXT 2- Vous pouvez modifier le contenu de ce fichier, pour générer vos pages dans une autre langue, ou pour changer quelques termes utilisés. Exemple, si vous voulez modifier l'affichage du sexe des individus, modifiez les lignes 218 et 219 de TEXTE.TXT. 218#
(Femme) 219#
(Homme) Si vous voulez qu'en plus, cette mention apparaisse sur la même ligne que le nom, supprimez les commandes html
des lignes 218 et 219. 3- Si, après modification de TEXTE.TXT, le programme ne fonctionne plus correctement, ne m'écrivez pas tout de suite... Repartez du fichier précédent, et refaites les modifications une à une, en contrôlant bien. 4- Ged2wwwf génère un texte de droit d'auteur (copyright) dans la page de garde (ou page principale). Ce message ne figure pas dans TEXTE.TXT Ce message apparaît en français si, sur la ligne 200 de TEXTE.TXT, le 3° caractère est F. Il apparaît en anglais dans le cas contraire. 5- La ligne 200 est importante: son premier caractère est celui représentant OUI (O), son deuxième NON (N). Vous pouvez indiquer les lettres que vous voulez, par exemple SN pour l'italien (SI et NO). CETTE LIGNE DOIT ETRE EN MAJUSCULES. Par ailleurs, n'oubliez pas, pour le confort des utilisateurs, de modifier également les textes des questions: 'Voulez-vous continuer (O/N)' devrait être changé en 'Do you want to continue (Y/N)' si vous mettez YN dans les 2 premiers caractères de la ligne 200. 6- L'ordre d'apparition des numéros dans TEXTE.TXT n'a pas d'importance. Evitez de mettre deux fois le même numéro de ligne, seule la dernière déclaration serait prise en compte, et vous consommeriez inutilement de la mémoire. 7- Ne supprimez JAMAIS un numéro de ligne. Le programme risquerait de ne plus fonctionner. 8- Certaines lignes contiennent des signes comme '%s' ou '%7li'. Laissez ces signes, ils permettent d'afficher le contenu de certaines variables. SURTOUT, n'ajoutez pas de tels signes, le programme risquerait de ne plus fonctionner. 9- La version française contient des caractères accentués, qui sont au format DOS, au format Windows, ou au format HTML, selon les cas, afin que les lettres accentuées apparaissent correctement dans tous les cas. Ca peut paraître bizzare quant on liste le fichier. Si vous mettez des caractères accentués dans les lignes 201 et plus, respectez le HTML: 'é' pour 'é', etc... 10- Ne vous inqiétez pas, il n'est pas difficile de modifier ce fichier. Si vous créez des versions étrangères, vous pouvez me les envoyer si vous désirez que je les mette à disposition sur mes pages personnelles. Comment traduire les mois ------------------------- Les fichiers gedcom comportent souvent des dates telles que 14 AUG 1948. Vous pouvez maintenant les "traduire" en 14 août 1948 (ou 14 August 1948, au choix). Le fichier FRANCAIS.TXT contient les "traductions" pour les 12 mois JAN FEB ... plus ABT (about) BEF (before) et AFT (after). Ces "traductions" se trouvent dans les lignes Mnn du fichier FRANCAIS.TXT (que vous devez renommer en TEXTE.TXT). Vous pouvez y ajouter d'autres traductions si nécessaire. Ex: si vous avez une date de la forme BET 1885 AND 1887 (entre 1885 et 1887), ajouter les lignes suivantes: M16#BET#entre M17#AND#et Vous pouvez utiliser les lignes de M1 à M40. Les lignes M1 à M12 ne sont pas réservées (pour l'instant) aux douze mois, mais pourront l'être plus tard. Numéro Sosa ----------- Attention: cette option n'est possible que pour une présentation en tableau. Pour afficher les n° Sosa, vous devez d'abord choisir l'individu qui aura le n° Sosa 1. Ensuite, vous devez repérer cet individu dans votre Gedcom. Notez son identifiant (ce qui se trouve entre deux @ sur la ligne 0 @xxx@ INDI qui précède sa description). Enfin, lors de l'exécution de ged2wwwf, répondez oui à la question sur l'affichage du numéro de Sosa, puis donnez l'identifiant en réponse à la question suivante, en respectant les majuscules et minuscules. Affichage des NOTEs ------------------- Les NOTEs et les SOURces sont traitées de manière identique, et sont affichées au niveau de l'individu ou du mariage, et non au niveau de l'événement dans lequel elles figurent. Les appels indirects de NOTEs ou SOURces ne sont pas gérés (exemple: 2 NOTE @N1@). Si vous affichez les NOTES (et les SOURces), vous pouvez choisir: 1-afficher les NOTEs au milieu des pages de données (intéressant si vos NOTEs sont toutes courtes) 2-afficher toutes les NOTEs dans des pages html séparées 3-afficher les NOTEs courtes au milieu des pages de données, les NOTEs longues dans des pages html séparées. Pour le cas 1, répondre 0 (zéro) aux 2 questions sur la taille des notes. Pour le cas 2, répondre 1 (un) aux 2 questions sur la taille des notes, puis choisissez le nombre de NOTEs par fichier html séparé afin de contrôler la taille de ces fichiers. Pour le cas 3, indiquez le nombre de lignes et le nombre de caractères de NOTEs ou SOURces à partir desquels vous désirez qu'elles soient dans un fichier à part, puis la taille en nombre de NOTEs des fichiers séparés. Les paramètres nombre de lignes et nombre de caractères vous permettent de choisir au mieux l'aspect de vos pages. Vous pouvez choisir par exemple de mettre les NOTEs dans un fichier à part dès qu'elles atteignent 5 lignes ou 200 caractères. Remarques --------- Les codes de caractères acceptés sont ANSI, ANSEL et IBMPC (DOS). Problèmes connus ---------------- NUMERO DUPLIQUE D'INDIVIDU Si votre Gedcom contient le même numéro de référence pour 2 individus, le programme s'arrête. INCOHERENCES DANS LES FAMILLES Si votre Gedcom indique que Paul est fils de Jean, mais n'indique pas que Jean est père de Paul, Ged2wwwf s'arrêtera. En cas d'incohérence du fichier Gedcom, et depuis la version 1.5, le programme demande de frapper une touche avant de s'arrêter. Ceci permet d'avoir le temps de comprendre ce qui se passe. Maintenance ----------- Si vous rencontrez des difficultés dans l'utilisation de ce programme, ou si vous désirez y voir figurer de nouvelles possibilités, n'hésitez pas à m'écrire à jbfahy@nordnet.fr Si vos requêtes sont compatibles avec le temps dont je dispose, elles seront servies au mieux. Historique ---------- Version 0.22 du 11 janvier 1998 Récupération des sources de Leslie Howard (version 0.22). Francisation du programme. Correction de bug: maintenant, les personnes sans relation sont affichées. Génération des listes des lieux/patronymes et patronymes/lieux. Version 0.1jbf du 2 mars 1998 Ajout de la liste éclair. Version 0.2jbf du 21 mars 1998 Ajout des nombres de naissances et décès dans la liste lieux/patronymes. Supression de l'affichage des lieux pour les personnes considérées comme vivantes. Version 1.0f&w du 5 juillet 1998 Création automatique du sous-répertoire HTML. Internationalisation: les textes se trouvent dans le fichier TEXTE.TXT Sauvegarde des paramètres dans le fichier GED2WWW.DAT (merci à Frank Waarsenburg). Inclusion de photos (merci à Frank Waarsenburg). Inclusion du fichier BOTTOM.TXT en fin de page créée (Frank Waarsenburg, sur une idée de John Hitcock. Suppression des fichiers temporaires en fin d'exécution. Les Y tréma majuscules (oui, ça existe...) sont maintenant, en principe, traités correctement (clin d'oeil à Marie-Claire Bauche). Mise en gras de "Mariage", "Parents", "Enfants", pour une meilleure lisibilité (sur une idée de Guy Gasiorowski). Version 1.1f&w du 30 juillet 1998 Création automatique du sous-répertoire HTML (cette fois, ça marche...) et suppression des éventuels fichiers *.htm et *.txt de ce répertoire. Possibilité de trier les liste Patronymes/Lieux et Lieux/Patronymes. Code IBMPC (c.à.d. DOS) supporté, avec les lettres accentuées. Version 1.2f&w Traduction des mois (sur une idée de plusieurs personnes, et en particulier de Paul-Marc Heudre, qui a beaucoup insisté ;-)) Seule la première ligne NAME d'un individu est prise en compte: la ou les suivantes sont ignorées (considérée(s) comme le surnom) Affichage des liens vers les pages d'index dans chaque page d'index (sur une idée de Jean-Louis Mejecaze). La liste des patronymes est plus aérée: saut de ligne sur rupture d'initiale (sur une idée de Alain Bourreau). Lien de retour à la page principale en fins de listes Lieux/Patronymes et Patronymes/Lieux. Les y accent aigu sont en principe gérés, maintenant. Version 1.3f&w du 28 novembre 1998 Mariages dans les listes Lieux/Patronymes et Patronymes/Lieux Baptême, inhumation et occupation dans les pages de données Tri des lieux indifférent aux majuscules/minuscules (évite d'avoir des lignes différentes pour un même lieu codé parfois en majuscules, parfois en minuscules) Accès direct aux individus concernés depuis les listes Lieux/Patronymes et Lieux/Patronymes Correction de la gestion des couleurs de liens Explication des symboles ° x + dans les listes Lieux/Patronymes et Patronymes/Lieux Acceptation de la lettre bêta Possibilité de plusieurs petites pages plutôt qu'une grande (index, listes lieux/patronymes, patronymes/lieux) Gestion correcte des patronymes d'un seul caractère Version 1.3.0f&w du 13 décembre 1998 (correction de petits dysfonctionnements) Baptême: acceptation du "tag" CHR en plus de BAPM (merci Frank) Liste des patronymes: le lien sur le dernier patronyme est maintenant correct Ligne NAME: la partie à droite du patronyme (le titre pour certains logiciels, les prénoms pour d'autres) est maintenant bien gérée pour les accents. Version 1.4f&w bêta du 3 mars 1999 Correction des versions 1.3 et 1.3.0: tous les individus apparaissent maintenant. Nouvelle présentation (en tableau) des pages de données. Décalage possible à droite de toutes les pages. Option de création des pages Lieux/Patronymes et Patronymes/Lieux. Option d'affichage de la référence ("tag" REFN). Titre des pages de données paramétrable. Inclusion du contenu du fichier "top.txt" (s'il est présent) en tête de chaque page, pour permettre par exemple d'inclure un thème. Alphabet dans la liste des patronymes pour améliorer la présentation. Version 1.5, 15 janvier 2000 Possibilité d'exécution sans resaisir le nom du fichier gedcom. Tri des noms cohérent avec les langues d'Europe occidentale (é è ê et ë sont équivalents à e, mais æ å ä ö et ø sont des lettres à part entière). Possibilité d'affichage des numéros Sosa (à partir d'un individu choisi comme Sosa 1). Affichage possible des NOTES. Index intermédiaire pour les pages Lieux/Patronymes. Suppression des virgules intempestives générées par certains logiciels de généalogie dans les noms de lieux. Correction de l'affichage des photos. Version 1.5.1, 20 janvier 2000 Correction d'un bogue concernant les noms ne commençant pas par une lettre. L'extension .ged n'est plus nécessaire pour la saisie du nom de fichier gedcom. Version 1.5.2, 22 janvier 2000 Correction d'un bogue concernant les NOTEs plus grandes que 1024 caractères, les NOTES peuvent faire jusqu'à 32 kilo-octets, et sont tronquées au-delà. Correction du tri des lieux, maintenant insensible à majuscules/minuscules. "Assainissement" du code html produit. Version 1.5.3 du 31 janvier 2000 Correction d'un bogue (crash programme) pouvant apparaître si choix d'affichage du Sosa. Correction d'un bogue (crash programme) pouvant survenir à la lecture 1/2 ou 2/2 du fichier gedcom. Amélioration de l'affichage des NOTEs, affichage des NOTEs de mariages. Amélioration du temps de génération des listes Lieux/Patronymes. Version 1.5.4 du 13 février 2000 Correction d'un bogue (crash programme) si pas d'affichage des dates sur les pages d'index. Affichage des confirmations (tag CONF). Affichage des divorces (si présence tag DIV dans une famille). Option de tri externe ou interne (ne prendre interne que si les pages lieux/patronymes ne sont pas générées). Version 1.5.5 du 24 juin 2000 Remise en service de la liste éclair. Traitement correct des caractères spéciaux tels que ß Ø Æ Œ en codage ANSEL. Si pages décalées à droite, correction de l'affichage du premier séparateur de chaque page. Correction d'erreurs de pointages vers et dans les index. Message d'erreur et arrêt si plus de 30 enfants par famille, ou plus de 20 mariages pour un individu. En cas de parents multiples, prise en compte de la première famille de parents (au lieu de la dernière), et affichage d'un avertissement. Version 1.5.5a du 13 août 2000 Tri et affichage corrects des noms dans "Liste des Patronymes" er dans les index. Affichage correct de "Page suivante" dans les index. Modification possible du Sosa n° 1 après la première exécution Listes Lieux/Patronymes: utilisation du lieu de baptême si pas de lieu de naissance, idem pour décès et inhumation.