Utilisation du programme Ged2wwwf.exe

ATTENTION !
SI VOUS PASSEZ D'UNE ANCIENNE VERSION A CELLE-CI (cd. VOUS EXECUTEZ LA 1.5 OU LA 1.5.1
POUR LA PREMIERE FOIS), DETRUISEZ LE FICHIER GED2WWW.DAT, OU LE COMPORTEMENT POURRAIT ETRE
INCOHERENT.


Note cre le 7 mars 1998.
Dernire mise  jour: 26 juin 2000.


Principales nouveauts des versions 1.4 et 1.5 f&w
--------------------------------------------
Option de prsentation des pages de donnes sous forme de tableaux.
Option de dcalage  droite de toutes les pages cres.
Option de cration ou non des listes Lieux/Patronymes et Patronymes/Lieux.
Option d'affichage ou non de la rfrence (tag REFN)
Option d'affichage ou non des NOTEs
Option d'affichage ou non des mtiers (tag OCCU)
Tri des lettres accentues (presque) adapt au langues d'Europe occidentale
Possibilit d'affichage des numros 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 gnrale (GNU, General
Public License, publie par la Free Software Foundation).
Les droits d'auteur s'appliquent nanmoins sur ce programme.
Se rfrer au document "Copying" (en anglais), dit par la Free
Software Foundation.

Si vous dsirez disposer des sources de ce programme, vous pouvez les
obtenir auprs de:
Jean-Baptiste Fahy
jbfahy@nordnet.fr

Ce programme a t crit  l'origine par Leslie Howard.

Excution de Gedwwwf.exe
------------------------
Dans sa version actuelle (1.5.4), ce programme tourne uniquement dans une
fentre DOS de Windows 95, 98, NT ou 2000.
Pour l'excuter sous Windows NT ou Windows 2000, assurez-vous de disposer du programme
sort.exe, et que ce programme peut tre excut depuis une fentre DOS.
Sous Windows NT ou 2000, sort.exe se trouve en gnral dans le rpertoire c:\winnt\command.
Ged2wwwf ncessite la prsence du fichier TEXTE.TXT dans le rpertoire de travail,
fichier qui contient les textes dans la langue que vous aurez choisie.
Actuellement, le franais le nerlandais l'allemand, l'anglais, le danois et le sudois 
(partiellemnt) sont disponibles.
Pour le franais, changez FRANCAIS.TXT en TEXTE.TXT
Pour l'anglais, changez ENGLISH.TXT en TEXTE.TXT
Pour le nerlandais, 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 sudois, changez SVENSK.TXT en TEXTE.TXT

Ged2wwwf consomme un fichier au format GEDCOM.
Il cre (s'il n'existe pas dj) un sous-rpertoire nomm HTML, sous le rpertoire
de travail.
Le programme pose une srie de questions, puis gnre les pages html dans le rpertoire HTML.
Les paramtres d'excution peuvent tre sauvegards (dans le fichier ged2www.dat)
pour des excutions ultrieures.

La particularit de Ged2wwwf est de crer 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 tris  votre guise. Voyez la note 'Tri des lieux'.

Ged2wwwf peut intgrer des photos au format JPEG pour tout individu.
Ceci se fait sans dclaration particulire, sur simple test de l'existence
de fichier I<n>.JPG dans le sous-rpertoire HTML, o <n> reprsente le numro
d'individu, au sens du fichier gedcom (exemple: si le fichier I1.jpg
existe, son contenu sera affich  ct de l'individu repr par @I1@ dans le
fichier gedcom). Attention, les fichiers I<n>.jpg doivent figurer dans le mme
rpertoire que vos fichiers html. N'oubliez-pas de les transfrer en mme temps
que vos pages html. D'autre part, l'affichage de photos rclame quelques kilo-octets,
et donc au dtriment de la vitesse d'affichage.

Ged2wwwf intgre galement, s'il est prsent, le fichier BOTTOM.TXT  la fin de chaque
page gnre, 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 prsent, est insr dans chaque page gnre, entre les balises
</title> et </head>.

Vous pouvez grer la taille des pages gnres avec le paramtre
"nombre de groupes de familles par fichier cr". Une petite valeur gnre des fichiers de 
donnes plus petits.

Vous pouvez choisir une image de fond de page, et aussi de dcaler sur la droite les 
informations gnres. Essayez par exemple le fichier "reliure.gif" comme fond de page, et
choisissez Pages dcales  droite.

Liste Eclair
------------
 la demande de plusieurs utilisateurs, la liste clair est remise en service avec la version
1.5.5.
Ged2wwwf gnre, dans le rpertoire par dfaut, le fichier ListeEcl.txt,
liste clair issue de votre fichier au format GEDCOM.
Pour que cette liste clair soit complte, Ged2wwwf requiert que vos
dclarations de lieux dans le fichier GEDCOM soient constitues de la
manire suivante:
<commune> (<dpartement>)
Actuellement, la prsence des parenthses est indispensable pour que
Ged2wwwf puisse isoler la commune du dpartement (ou la commune du pays).


Indication de vos noms, adresse, etc...
---------------------------------------
Toutes les donnes destines  figurer sur les pages cres doivent tre au format HTML:
un "" s'crit "&eacute;"
"Thrse" s'crit "Th&eacute;r&egrave;se"
Consultez une documentation sur le codage html pour plus ample information.

Indication de votre page personnelle
------------------------------------
N'indiquez pas le prfixe 'http://' avant votre adresse. Indiquez par exemple:
home.nordnet.fr/~jbfahy
pour obtenir
http://home.nordnet.fr/~jbfahy

Tri des lieux
-------------
La rponse  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 structurs.
Pour trier vos lieux sur Dpartement/Ville:
- si vos lieux sont cods 'Ville,Dpartement', indiquez '2,1'
- si vos lieux sont cods 'Ville (Dpartement), indiquez '2(1)'
Pour trier sur Pays/Dpartement/Ville et ne pas faire figurer les paroisses,
si vos lieux sont cods 'paroisse,Ville,Dpartement,Pays', indiquez '0,3,2,1'.

0 signifie de ne pas faire figurer un lment.
Les lments  faire figurer peuvent aller de 1  9.
Utilisez comme sparateurs d'lments tout sauf des espaces, des lettres et des chiffres.

La version 1.5 introduit une table des lieux. Elle est compose par les lments 1 et 2
dcrits dans le type de tri des lieux.

La version 1.5 permet de choisir entre un tri externe ou interne. Le tri interne entrane 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 gnrale sur le fichier TEXTE.TXT
-----------------------------
1- La prsence du fichier TEXTE.TXT dans le rpertoire par dfaut 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 gnrer vos pages dans une autre
langue, ou pour changer quelques termes utiliss. Exemple, si vous voulez modifier
l'affichage du sexe des individus, modifiez les lignes 218 et 219 de TEXTE.TXT.
218#<BR>(Femme)
219#<BR>(Homme)
Si vous voulez qu'en plus, cette mention apparaisse sur la mme ligne que le nom,
supprimez les commandes html <BR> des lignes 218 et 219.
3- Si, aprs modification de TEXTE.TXT, le programme ne fonctionne plus correctement,
ne m'crivez pas tout de suite... Repartez du fichier prcdent, et refaites les modifications
une  une, en contrlant bien.
4- Ged2wwwf gnre 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 apparat en franais si, sur la ligne 200 de TEXTE.TXT, le 3 caractre est F.
Il apparat en anglais dans le cas contraire.
5- La ligne 200 est importante: son premier caractre est celui reprsentant OUI (O), son
deuxime 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 caractres de la
ligne 200.
6- L'ordre d'apparition des numros dans TEXTE.TXT n'a pas d'importance. Evitez de mettre deux
fois le mme numro de ligne, seule la dernire dclaration serait prise en compte, et vous
consommeriez inutilement de la mmoire.
7- Ne supprimez JAMAIS un numro 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 franaise contient des caractres accentus, qui sont au format DOS, au format
Windows, ou au format HTML, selon les cas, afin que les lettres accentues apparaissent
correctement dans tous les cas. Ca peut paratre bizzare quant on liste le fichier.
Si vous mettez des caractres accentus dans les lignes 201 et plus, respectez le HTML:
'&eacute;' pour '', etc...
10- Ne vous inqitez pas, il n'est pas difficile de modifier ce fichier. Si vous crez des
versions trangres, vous pouvez me les envoyer si vous dsirez 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 aot 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 ncessaire. 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 rserves (pour l'instant) aux douze mois, mais pourront l'tre
plus tard.

Numro Sosa
-----------
Attention: cette option n'est possible que pour une prsentation en tableau.
Pour afficher les n Sosa, vous devez d'abord choisir l'individu qui aura le n Sosa 1. Ensuite,
vous devez reprer cet individu dans votre Gedcom. Notez son identifiant (ce qui se trouve
entre deux @ sur la ligne 0 @xxx@ INDI qui prcde sa description).
Enfin, lors de l'excution de ged2wwwf, rpondez oui  la question sur l'affichage du numro de
Sosa, puis donnez l'identifiant en rponse  la question suivante, en respectant les majuscules
et minuscules.

Affichage des NOTEs
-------------------
Les NOTEs et les SOURces sont traites de manire identique, et sont affiches au niveau de
l'individu ou du mariage, et non au niveau de l'vnement dans lequel elles figurent.
Les appels indirects de NOTEs ou SOURces ne sont pas grs (exemple: 2 NOTE @N1@).

Si vous affichez les NOTES (et les SOURces), vous pouvez choisir:
1-afficher les NOTEs au milieu des pages de donnes (intressant si vos NOTEs sont toutes
courtes)
2-afficher toutes les NOTEs dans des pages html spares
3-afficher les NOTEs courtes au milieu des pages de donnes, les NOTEs longues dans des pages
html spares.

Pour le cas 1, rpondre 0 (zro) aux 2 questions sur la taille des notes.
Pour le cas 2, rpondre 1 (un) aux 2 questions sur la taille des notes, puis choisissez
le nombre de NOTEs par fichier html spar afin de contrler la taille de ces fichiers.
Pour le cas 3, indiquez le nombre de lignes et le nombre de caractres de NOTEs ou SOURces 
 partir desquels vous dsirez qu'elles soient dans un fichier  part, puis la taille en nombre
de NOTEs des fichiers spars. Les paramtres nombre de lignes et nombre de caractres vous
permettent de choisir au mieux l'aspect de vos pages. Vous pouvez choisir par exemple de mettre
les NOTEs dans un fichier  part ds qu'elles atteignent 5 lignes ou 200 caractres.

Remarques
---------
Les codes de caractres accepts sont ANSI, ANSEL et IBMPC (DOS).


Problmes connus
----------------
NUMERO DUPLIQUE D'INDIVIDU
Si votre Gedcom contient le mme numro de rfrence pour 2 individus, le programme s'arrte.

INCOHERENCES DANS LES FAMILLES
Si votre Gedcom indique que Paul est fils de Jean, mais n'indique pas que Jean est pre de
Paul, Ged2wwwf s'arrtera.

En cas d'incohrence du fichier Gedcom, et depuis la version 1.5, le programme demande de 
frapper une touche avant de s'arrter. Ceci permet d'avoir le temps de comprendre ce qui
se passe.

Maintenance
-----------
Si vous rencontrez des difficults dans l'utilisation de ce programme,
ou si vous dsirez y voir figurer de nouvelles possibilits, n'hsitez
pas  m'crire  jbfahy@nordnet.fr
Si vos requtes sont compatibles avec le temps dont je dispose, elles
seront servies au mieux.

Historique
----------
Version 0.22 du 11 janvier 1998
Rcupration des sources de Leslie Howard (version 0.22).
Francisation du programme.
Correction de bug: maintenant, les personnes sans relation sont affiches.
Gnration 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 dcs dans la liste lieux/patronymes.
Supression de l'affichage des lieux pour les personnes considres comme vivantes.

Version 1.0f&w du 5 juillet 1998
Cration automatique du sous-rpertoire HTML.
Internationalisation: les textes se trouvent dans le fichier TEXTE.TXT
Sauvegarde des paramtres dans le fichier GED2WWW.DAT (merci  Frank Waarsenburg).
Inclusion de photos (merci  Frank Waarsenburg).
Inclusion du fichier BOTTOM.TXT en fin de page cre (Frank Waarsenburg, sur une
ide de John Hitcock.
Suppression des fichiers temporaires en fin d'excution.
Les Y trma majuscules (oui, a existe...) sont maintenant, en principe, traits
correctement (clin d'oeil  Marie-Claire Bauche).
Mise en gras de "Mariage", "Parents", "Enfants", pour une meilleure lisibilit
(sur une ide de Guy Gasiorowski).

Version 1.1f&w du 30 juillet 1998
Cration automatique du sous-rpertoire HTML (cette fois, a marche...) et suppression
des ventuels fichiers *.htm et *.txt de ce rpertoire.
Possibilit de trier les liste Patronymes/Lieux et Lieux/Patronymes.
Code IBMPC (c..d. DOS) support, avec les lettres accentues.

Version 1.2f&w
Traduction des mois (sur une ide de plusieurs personnes, et en particulier de Paul-Marc
Heudre, qui a beaucoup insist ;-))
Seule la premire ligne NAME d'un individu est prise en compte: la ou les suivantes sont
ignores (considre(s) comme le surnom)
Affichage des liens vers les pages d'index dans chaque page d'index (sur une ide de
Jean-Louis Mejecaze).
La liste des patronymes est plus are: saut de ligne sur rupture d'initiale
(sur une ide 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 grs, maintenant.

Version 1.3f&w du 28 novembre 1998
Mariages dans les listes Lieux/Patronymes et Patronymes/Lieux
Baptme, inhumation et occupation dans les pages de donnes
Tri des lieux indiffrent aux majuscules/minuscules (vite d'avoir des lignes diffrentes pour
un mme lieu cod parfois en majuscules, parfois en minuscules)
Accs direct aux individus concerns 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 bta
Possibilit de plusieurs petites pages plutt qu'une grande (index, listes lieux/patronymes,
patronymes/lieux)
Gestion correcte des patronymes d'un seul caractre

Version 1.3.0f&w du 13 dcembre 1998 (correction de petits dysfonctionnements)
Baptme: 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 prnoms pour d'autres) est maintenant bien gre pour les accents.

Version 1.4f&w bta du 3 mars 1999
Correction des versions 1.3 et 1.3.0: tous les individus apparaissent maintenant.
Nouvelle prsentation (en tableau) des pages de donnes.
Dcalage possible  droite de toutes les pages.
Option de cration des pages Lieux/Patronymes et Patronymes/Lieux.
Option d'affichage de la rfrence ("tag" REFN).
Titre des pages de donnes paramtrable.
Inclusion du contenu du fichier "top.txt" (s'il est prsent) en tte de chaque page, pour
permettre par exemple d'inclure un thme.
Alphabet dans la liste des patronymes pour amliorer la prsentation.

Version 1.5, 15 janvier 2000
Possibilit d'excution sans resaisir le nom du fichier gedcom.
Tri des noms cohrent avec les langues d'Europe occidentale (   et  sont quivalents  e,
mais     et  sont des lettres  part entire).
Possibilit d'affichage des numros Sosa ( partir d'un individu choisi comme Sosa 1).
Affichage possible des NOTES.
Index intermdiaire pour les pages Lieux/Patronymes.
Suppression des virgules intempestives gnres par certains logiciels de gnalogie 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 commenant pas par une lettre.
L'extension .ged n'est plus ncessaire 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 caractres, les NOTES peuvent
faire jusqu' 32 kilo-octets, et sont tronques 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 apparatre si choix d'affichage du Sosa.
Correction d'un bogue (crash programme) pouvant survenir  la lecture 1/2 ou 2/2 du fichier
gedcom.
Amlioration de l'affichage des NOTEs, affichage des NOTEs de mariages.
Amlioration du temps de gnration des listes Lieux/Patronymes.

Version 1.5.4 du 13 fvrier 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 prsence tag DIV dans une famille).
Option de tri externe ou interne (ne prendre interne que si les pages lieux/patronymes ne sont
pas gnres).

Version 1.5.5 du 24 juin 2000
Remise en service de la liste clair.
Traitement correct des caractres spciaux tels que     en codage ANSEL.
Si pages dcales  droite, correction de l'affichage du premier sparateur de chaque page.
Correction d'erreurs de pointages vers et dans les index.
Message d'erreur et arrt 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 premire famille de parents (au lieu de la
dernire), et affichage d'un avertissement.