## Questions fréquemment posées

Chapitre 6.
Précédent | Installation de Java et de GenJ | Suivant

VI - Installation de Java et de GenJ

1. Installation de Java et de GenJ ?

| En cliquant sur la lettre "Q" en rouge située en face de chaque question, vous pouvez remonter au sommaire de ces différentes questions.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
VI - Installation de Java et de GenJ

1. Q - L'installation de Java et de GenJ ?
   R - Voilà un résumé de la manière d'installer le programme Java et GenJ sur votre machine.

   SOMMAIRE Procédure d'installation de Java et GenJ sur votre ordinateur Introduction - A lire en premier lieu. A - Installation sous Windows 1°) Installation de Java 2°) Installation de GenJ B - Installation sous Linux 1°) Installation de Java 2°) Installation de GenJ C - Installation sous Mac 1°) Installation de Java 2°) Installation de GenJ

   Procédure d'installation de Java et GenJ
   Introduction

   Tout d'abord, il convient de savoir sous quel Operating System (Système d'Exploitation) vous êtes. Est-ce Windows, Linux ou Mac ?
   Je suis obligé de laisser de coté OS/2, peut-être quelqu'un sous cet environnement pourra t'il compléter cette page d'Aide.
   On regardera donc les trois environnements, Windows, Linux et Mac, mais tout d'abord, il y a un pré-requis : installer la machine virtuelle Java. Si vous ne disposez pas de Java, pas de salut. Il va falloir vous connecter sur l'Internet sur le site de Sun Microsystem pour trouver la version correspondant à votre environnement. J'essaierai un peu plus loin de vous donner des liens mais peut-être seront-ils obsolètes quand vous lirez ces lignes, si personne n'a pensé à les mettre à jour. En ce qui concerne Mac, allez directement à la section relative à l'installation de Java pour voir les spécificités.
   Remarque : Souvent dans ce document je vous dit de reprendre tel et tel fichiers. Vous pouvez faire plus simple en reprenant un fichier qui comprend tout ce dont vous avez besoin et qui s'appelle genj_arvernes.zip disponible sur mon site Arvernes. Si cependant vous êtes sous Windows, vous devrez d'abord reprendre le fichier genj_win-2.4.2.exe, l'installer, et ensuite seulement mettre le genj_arvernes.zip par dessus.

   A - Installation sous Windows
   1°) - Première étape : installation de Java.
   Comme nous l'avons dit écrit plus haut, il vous faut récupérer la dernière version de Java sur le site de Sun Microsystem. Pour cela essayez cette URL : JRE pour Windows, version 1.5.0.09
   Reprenez le fichier jre-1_5_0_09-windows-i586-p-s.exe (il fait 16,00 Megas et est dénommé Windows (Installation hors ligne) (n'oubliez pas que pour pouvoir le reprendre, il faut que vous acceptiez au préalable la licence, donc cochez la case "Accept Licence Agreement", juste au dessus si cela vous est demandé). Je n'ai aucune expérience windows, mais je pense que c'est ce qui sera le plus facile à installer.
   Une fois que c'est téléchargé, vous l'installez. Je pense que vous savez faire ça, dans l'explorateur de fichier. Si Windows ne vous propose pas de l'installer à la fin du téléchargement, vous ouvrez l'explorateur de fichiers, vous retrouvez l'emplacement que Windows a choisi pour mettre le fichier ci-dessus, et vous cliquez dessus. L'installation du "Runtime Java" va s'effectuer sans problème.
   Retour au Sommaire de la Procédure
   2°) - Deuxième étape : Installation de GenealogyJ.
   1. Téléchargez GenJ (~3MB). A l'heure où je vous parle, vous devriez le trouver là :
      genj_win-2.4.2.exe.
      Maintenant lancer genj_win-2.4.2.exe.
      Vous allez voir apparaître plusieurs fenêtres, il faut confirmer chaque écran par "Next".
      Ensuite l'installateur vous propose de choisir l'emplacement souhaité, je vous conseille de l'installer comme tous les programmes windows, dans "c:\Program Files\GenealogyJ", c'est l'option par défaut, autant la prendre.
      La fenêtre suivante vous permet de sélectionner le langage ("Select Components"), donc à priori, vous choisirez "French Resources" si vous voulez qu'il cause le français notre petit programme.
      L'écran suivant vous permet de sélectionner le menu de GenJ dans --> Démarrage --> Programmes ("Select Menu folder").
      Il vous indique ensuite la récapitulation de vos différents choix pour valider, revenir en arrière ou abandonner. A priori, vous devez cliquer sur "Install".
      Il installe, donc vous n'avez pas le temps d'aller au petit coin, ni de prendre un verre, c'est hyper rapide.
      Logiquement, vous devriez arriver sans problème à ce stade :
   2. Lancez GenealogyJ par l'intermédiaire du raccourci à partir du menu Démarrer.
   3. La première fois que le programme se lance, ou si vous effectuez une mise à jour (vous installez une version plus récente), vous allez voir s'afficher ce qui en anglais s'appelle "Disclaimer" (Avertissement, comme quoi vous utilisez ce programme sous votre responsabilité, etc... enfin si vous ou l'un des membres de votre Equipe venait à être capturé, le gouvernement nierait toute implication - Mission Impossible réminiscences).
   4. Le programme se lance, mais suivant votre système, votre pare-feu peut vous demander une autorisation d'exécuter le programme javaw.exe. Bien sûr il faut lui dire oui sans quoi ben vous resterez avec un joli programme sur votre disque dur mais, mis à part le fait qu'il occupera de la place, vous ne risquerez pas d'en tirer quelque chose.
   5. Maintenant vous remarquerez que bien que vous ayez demandé à ce que GenJ vous cause en français, il s'évertue à vous causer dans la langue de Shakespeare.
      Pas grave, sur l'écran principal de GenJ, vous avez un menu déroulant qui s'appelle Views. Ouvrez-le, et choisissez la ligne "Options". Dans la fenêtre qui s'ouvre vous verrez une option "Language (After Restart)", prenez bien sûr la langue de Molière. Une fois que c'est fait, vous cliquez sur "OK" pour valider votre choix, et vous refermez GenJ. Maintenant si vous le relancez, il vous cause la française mieux que moi ;-).
   6. Vous pouvez aussi pour faciliter les choses, créer un raccourci sur le bureau par "Démarrer - Programmes - GenealogyJ - Genealogy2.4" puis clic droit sur le titre du programme et "Envoyez vers - Bureau (créer un raccourci)".
   7. Maintenant, si vous voulez changer un peu le look de GenJ, il vous faut télécharger une archive supplémentaire que vous trouverez sur mon site Arvernes. Le fichier qu'il faut prendre s'appelle "genj_lnf-xxxx.zip" (là encore, les xxxx sont à remplacer par le numéro de version qui sera disponible quand vous reprendrez le fichier).
      Une fois en votre possession, il vous faudra placer cette archive dans le répertoire "c:\Program Files\GenealogyJ" et le décompacter dans ce répertoire.
      Normalement, il devra se créer un sous-répertoire qui s'appellera "lnf". Ainsi vous aurez quelque chose du genre "c:\Program Files\GenealogyJ\lnf" avec dans ce sous-répertoire, des fichiers et autres sous répertoires.
      Maintenant qu'il est installé, vous pouvez l'effacer, car vous n'en aurez plus besoin.
      Maintenant, pour changer l'aspect de GenJ, quand vous l'aurez lancé, il vous faudra rentrer dans le menu "Visualisations - Options", et faire votre choix sur le look que vous préférez. La ligne qu'il faut regarder est "Aspect (Choisissez un thème)".
      Il est fort possible que la taille de la fenêtre qui s'ouvre soit insuffisante pour que vous puissiez voir les options et la manière de les choisir. Pour ce faire, avec votre souris, il vous faut vous positionner dans le coin droit en bas de ladite fenêtre d'options qui vient de s'ouvrir, et en cliquant avec le bouton gauche, tout en maintenant le bouton de votre souris, l'agrandir à la taille qui vous satisfera.
      Normalement, vous devriez voir le nouveau look de GenJ en activant le thème de votre choix.
      Remarque :
      Il est possible de créer ses propres thèmes, par exemple j'ai créé le thème Skin(arvernesthemepack.zip). N'hésitez pas à voir comment il est fait, et à réaliser quelque chose de votre cru. Si par la suite vous vouliez en faire profiter la communauté des utilisateurs de GenJ, ce serait sympa, merci d'avance.
   8. Il est temps maintenant de mettre à jour votre version avec les derniers développements de GenJ. Pour cela il va falloir que vous alliez sur le site Arvernes et que vous repreniez au moins les fichiers suivants :
      1. genj_app-xxx.zip
      2. genj_fr-xxx.zip
      3. genj_geo-xxx.zip
      4. genj_applet-xxx.zip
      Vous devez commencer par fermer GenJ, vu qu'on va écraser ses fichiers. Il n'aimerait peut être pas rester ouvert.
      Vous allez décompacter TOUS ces fichiers dans le répertoire de genj, donc dans "c:\Program Files\GenealogyJ".
      Si Windows vous demande si vous voulez écraser les fichiers déjà existants, répondez lui "oui".
      Une fois que vous avez fini de bien décompacter ces fichiers, vous pouvez les effacer, vous n'en aurez plus besoin.
   9. Si vous avez déjà un fichier gedcom, je vous conseille de le copier dans "c:\Program Files\GenealogyJ\gedcom", avant de relancer GenJ. Si vous n'en avez pas, on passe cette étape.
      Maintenant, vous pouvez lancer GenJ.
      Je suppose que vous ne savez pas quoi faire avec la fenêtre qui apparaît. Sachez que vous êtes devant ce qu'on appelle le Centre de Contrôle.
      Pour ouvrir un fichier gedcom déjà existant, ou pour en créer un, il vous faut cliquer sur l'icône "Ouvrir", ou choisir "Ouvrir" dans le menu déroulant auquel vous accédez par l'option "Fichier".
      Si vous n'avez pas encore de fichier gedcom ou si vous voulez en créer un nouveau, cliquez sur "Nouveau". Si au contraire vous avez déjà un fichier gedcom, cliquez sur "Local".
      Si vous choisissez de créer un fichier gedcom "Nouveau", GenJ vous demandera le nom que vous voulez lui donner. Deux choses sont nécessaires :
      - D'une part, dans la fenêtre du navigateur qui s'ouvre, vous devez déplacer l'endroit où le fichier va être créé. Placez vous dans "c:\Programs Files\GenealogyJ\gedcom".
      - Ensuite, vous devez lui attribuer le nom de fichier de votre choix, GenJ demande "File name". Attribuez-lui le nom que vous voulez, allons-y pour "jacques_chirac.ged" ou "bernadette.ged".
   10. Maintenant, au stade où vous en êtes, vous devez consulter le chapitre sur le perfectionnement, notamment pour agrémenter la manière dont GenJ vous présente vos données (paragraphe : Agrémenter la présentation selon vos souhaits).
       Je vous conseille de le faire, car vous verrez que vous pourrez lui changer totalement son aspect et ce qui vous aura semblé quelque chose d'un peu rébarbatif, va devenir bien au contraire, trés trés agréable. Bon Vent.
   Retour au Sommaire de la Procédure
   REMARQUE :
   Pour bien comprendre comment Windows installe GenJ, voilà grosso modo les endroits où vous trouverez vos fichiers.
   N.B. Il est possible que les informations que je donne ne soient pas tout à fait exactes, car je ne fais pas tourner Windows, mais Linux, et j'ai l'impression que suivant les versions de Windows, les localisations de ces fichiers sont quelque peu différentes (Windows 98, 2000, XP, XP Pro, ....).
   (J'ai préféré rajouter cette information pour les utilisateurs de Windows, car les choses sont totalement différentes sous Linux) :
   1. Dans C:\Program Files\GenealogyJ, vous devriez trouver :
      - un répertoire contrib\
      - un répertoire doc\
      - un répertoire help\
      - un répertoire lib\
      - un répertoire gedcom\
      - un répertoire report\
      - puis, plusieurs fichiers, à savoir :
      genj.ico, run.jar, unins000.exe, run.bat, run.sh, run.cmd, et unins000.dat.
      Vous pouvez voir qu'il n'apparaît pas le sous-répertoire "lnf" dont je parlais juste au dessus. Tout simplement, parce que quand cette capture d'écran a été faite, le fichier en question n'avait pas encore été installé.
   2. Dans C:\Documents and Settings\votre_repertoire\ vous devriez trouver les éléments suivants (j'ai préféré faire une capture d'écran, plutôt qu'un listing, ce sera plus parlant) :
      Vous voyez qu'il y a au moins deux répertoires intéressants, à savoir :
      - .genj\
        Dedans vous devriez avoir tous les fichiers dont GenJ va avoir besoin pour conserver les paramètres de l'application. Ainsi vous aurez dans ce répertoire :
        1. monfichier.ged.properties
           Ce fichier contient les paramètres d'affichage de votre fichier gedcom ; taille des fenêtres, signets, etc...
        2. genj-reports.properties
           Là, ce fichier contient les paramètres que vous aurez choisis pour les rapports que vous faites tourner.
        3. genj.properties
           Celui-ci est le plus important, car c'est lui qui reprend tous les paramètres de l'application, par exemple, quels sont les fichiers gedcom qui ont été ouverts, la taille du Centre de Controle, etc...
        4. monfichier.geo.properties
           Ce fichier est celui qui va contenir les données géographiques (localisation) des villes, lieudits, etc.... que vous aurez entré manuellement.
           Regardez un peu plus loin ce qui est mis sur le module additionnel à GenJ, le module Geo".
           Sous Windows XP Pro, on m'a dit que ce fichier devait être sous :
           C:\Documents and Settings\Utilisateur\Application Data\Genj
           (Pour rechercher l'endroit où se trouve les fichiers il faut cocher l'option "rechercher dans les fichiers et les dossiers cachés").
        5. genj.log
           Ce fichier est important, car si vous avez des soucis, c'est lui qu'il faudra envoyer aux développeurs, donc ne l'effacez pas, de toutes façons suivant les paramètres que vous allez mettre dans les options, sa taille pourra être limitée à xxx koctets.
      - .java\
        Dedans vous aurez tous vos paramètres de la machine virtuelle java.
      Remarque :
      Sous les versions de Windows un peu anciennes, ce qui est mis au dessus reste vrai, donc le répertoire ".genj" se trouve sous :
      c:\Documents and Settings\nom_d_utilisateur\.genj
      Ce qu'il faut savoir c'est que si ce répertoire n'existe pas sur votre système, l'installation ira se mettre comme indiquée ci-aprés.
      Pour les versions plus récentes de Windows, et si le répertoire cité ci-dessus n'existe pas, vous devriez trouver ce répertoire sous :
      c:\Documents and Settings\nom_d_utilisateur\application data\genj
      Vous voyez qu'il ne s'appelle plus ".genj", mais "genj".
      Le répertoire "geo" lui va se trouver au moins dans deux endroits :
      1. C:\Program Files\GenealogyJ\geo
      2. Et dans l'un de ces trois répertoires :
         - c:\Documents and Settings\username\.genj\geo
         - c:\Documents and Settings\username\application data\genj\geo
         - c:\Documents and Settings\all users\application data\genj\geo
           Ce dernier cas concerne les gens qui veulent partager la même base de données pour la fonction de localisation entre plusieurs utilisateurs sous Windows.
      je suis désolé de ne pouvoir être plus précis sous Windows, mais d'une part je n'ai pas de système Windows, et d'autre part il semble que Windows fasse un peu ce qu'il veut lors d'une installation.
   Je tiens à remercier tout particulièrement Sined (un utilisateur de GenJ), qui m'a aidé à faire toute cette aide sous Windows sans lui, j'aurais été bien incapable d'en arriver là. Toutes les captures d'écran sont de lui, et c'est vraiment sur ses remarques que j'ai rédigé cette partie. Encore merci.
   Retour au Sommaire de la Procédure
   B - Installation sous Linux
   1°) - Première étape : installation de Java proprement dite.
   On l'a dit, il vous faut récupérer la dernière version de Java sur le site de Sun Microsystem. Pour cela essayez cette URL : JRE pour Linux, version 1.5.0.06
   Sur ce site je vous conseille de récupérer le fichier jre-1_5_0_06-linux-i586.bin (Linux self-extracting file). Je sais, ce n'est pas un package RPM, mais vous verrez plus loin pourquoi je vous conseille de le reprendre (n'oubliez pas que pour pouvoir le reprendre, il faut que vous confirmiez au préalable que vous acceptez la licence, donc cochez la case "Accept Licence Agreement", juste au dessus). N'oubliez pas de bien voir où linux place le fichier que vous téléchargez. Si vous n'avez de répertoire temporaire sous votre répertoire personnel, éventuellement, placez-le dans /tmp.
   Maintenant, on va mettre la main dans le cambouis si j'ose dire. Je vais supposer que vous vous appelez Jacques Chirac, que votre mot de passe "root" est "mulot", que vous avez votre répertoire personnel sous /home/elysee, et que vous avez mis le fichier que vous avez téléchargé dans /tmp
   Vous ouvrez un terminal (suivant que vous êtes sous Kde, ou Gnome cela peut être différent, mais par exemple, sous une Fedora Core 4 avec KDE, vous cliquez sur le chapeau rouge (sic) (l'icone qui vous permet de démarrer des applications ou quitter votre bureau), puis "Outils de Système" et "Terminal"), et vous tapez :
   1. cd /tmp (on se place dans le répertoire tmp)
   2. su (on passe "root")
   3. mulot (on tape le mot de passe pour "root")
   4. chmod 755 jre-1_5_0_06-linux-i586.bin (on rend exécutable le fichier)
   5. cp jre-1_5_0_06-linux-i586.bin /usr/local (on copie le fichier au bon endroit)
   6. rm /tmp/jre-1_5_0_06-linux-i586.bin (on efface le fichier puisqu'on l'a ailleurs)
   7. cd /usr/local (on va là où l'on a copié le fichier)
   8. ./jre-1_5_0_06-linux-i586.bin (on exécute le fichier pour qu'il s'installe)
   Là à chaque page de la licence, il vous affiche "Plus" en bas de chaque page, tapez sur la barre d'espacement pour passer à la page suivante. A la fin du texte de la licence, il va vous êtes demandé si vous acceptez cette même licence "Do you agree to the above licence terms? [yes or no]. Bien sûr vous taperez "yes".
   Ca y est, le JRE s'installe pile poil où il faut.
   Il se crée un répertoire jre1.5.0_06, vous pourrez le voir si vous tapez "ls". Dans la liste qui vous est donnée, vous verrez apparaître quelque chose comme ça (ne vous étonnez pas si vous n'avez pas tout à fait les mêmes choses, cela dépend du paramètrage de votre système) :
   drwxr-xr-x 7 root root 4096 aoû 27 03:32 jre1.5.0_06/
   Vous êtes toujours dans le répertoire /usr/local, et vous êtes toujours "root", n'oubliez pas.
   1. ln -s jre1.5.0_06 jre (on crée un lien symbolique)
   2. rm -f jre-1_5_0_06-linux-i586.bin (on efface le fichier)
   3. cd /etc (on passe dans le répertoire /etc)
   Maintenant, il faut savoir quel éditeur vous avez. J'utilise quant à moi toujours les deux mêmes éditeurs, quelque soit la version de Linux que je fais tourner, à savoir "nedit" et "jedit". Dans un premier temps, choisissez vers "nedit" que vous trouverez ici Site officiel de Nedit section "Download" ou alors, une recherche sur le site de RPMFind, donnera peut être de meilleurs résultats, c'est plus facile (si vous ne l'avez pas essayez de le reprendre quelque part, il en vaut vraiment la peine), mais si vous avez un autre éditeur que vous aimez bien, allez-y. Pour la suite de mon installation, je considère que vous avez "nedit".
   Tapez la commande :
   4. nedit bashrc
   Le fichier bashrc va s'ouvrir, vous allez à la fin du texte, et vous insérez les lignes suivantes (faites un copier/coller) :
   # Below this line is what I added when I setted the system up
   export JAVA_HOME=/usr/local/jre
   export PATH=.:$JAVA_HOME/bin:/usr/local/bin:/usr/local/sbin:$PATH
   Vous sauvegardez vos modifications, et vous sortez de l'éditeur. Je sais c'est un peu long, mais on est en train de faire une installation aux petits oignons (je ne veux pas être mauvaise langue, mais c'est autre chose comme installation que sous Windows ;-) non).
   Logiquement, java est installé. Le problème est que votre distribution comporte surement déjà une installation java mais bien incompléte. On va donc faire le nécessaire pour ne laisser que celle qu'on vient d'installer comme installation active. L'autre on la laissera sur notre ordinateur, mais on va la rendre inopérante.
   Je suppose que vous êtes toujours "root", et que vous êtes dans le répertoire /etc.
   cd /usr/bin (on va dans le répertoire /usr/bin)
   ls java* (on regarde ce qu'on a comme fichiers commençant par java)
   Je vais supposer que vous n'avez que deux fichiers, mais si vous en avez plus, ce sera pareil. Moi ici sous une Fedora Core 4, j'ai :
   javac qui pointe vers /etc/alternatives/javac
   et java qui pointe vers /etc/alternatives/java
   Pour ne pas être embété, je vais les renommer.
   mv javac javac.original
   mv java java.original
   Maintenant ouvrez un autre terminal (je précise bien : ouvrez-en un autre, il ne faut pas utiliser celui qui est déjà ouvert), et tapez :
   java -version
   Vous devriez avoir quelque chose comme ça :
   java version "1.5.0_06"
   Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05)
   Java HotSpot(TM) Client VM (build 1.5.0_06-b05, mixed mode, sharing)
   Et voilà, c'est fini ! Ouf ! ;-)
   Retour au Sommaire de la Procédure
   2°) - Installation de GenealogyJ.
   On va tout se faire à la manière des pros, à savoir "tout à la main".
   1. Téléchargez (clic droit et Enregistrer Sous) genj_app-2.4.2.zip (~800KB), ainsi que tous les autres fichiers qui sont nécessaires (voir un peu plus loin).
      Vous pouvez aussi aller sur le site Arvernes.com sur lequel vous trouverez les toutes dernières versions vous permettant d'être à la pointe du développement de GenJ.
      Donc allez sur http://www.arvernes.com, allez dans la section Téléchargement et récupérez les fichiers :
      - genj_app-xxxx.zip (xxxx est à remplacer par le numéro de version que vous trouverez).
      - genj_fr-xxxx.zip
      - genj_geo-xxxx.zip
      - genj_applet-xxxx.zip
   2. Décompactez les archives dans un répertoire en vous assurant que l'arborescence reste intacte (par exemple, vous pouvez mettre genj sous /usr/local/share/genj ou /home/elysee/genj.
      Comme vous faites tourner un système Linux, voilà comment faire :
      (On suppose que vous voulez installer GenJ dans votre répertoire personnel que l'on a appelé, je vous le rappelle /home/elysee)
      D'abord ouvrez une console. Je sais qu'on peut faire ça avec son environnement graphique, mais je suis de la vieille école.
      1. cd (Cela permet de se positionner dans son répertoire personnel donc /home/elysee/)
      2. mkdir genj (On crée le sous-répertoire genj)
      3. cd genj (On se met dans ce sous-répertoire genj)
      4. mkdir gedcom (On crée tout de suite le sous répertoire gedcom dans lequel je vous conseille de mettre et/ou créer vos fichiers gedcom (dans mon exemple, c'est là qu'ira se mettre le fichier jacques_chirac.ged et bernadette.ged))
      5. (Là vous placez l'archive principale, c'est à dire genj_app-xxxx.zip dans ce nouveau répertoire genj). Donc si le fichier genj_app-xxxx.zip se trouve dans /tmp, vous aurez à taper :
         cp /tmp/genj_app-xxxx.zip /home/elysee/genj
         Vous en faites autant pour les trois autres archives, donc genj_fr-xxxx.zip, genj_geo-xxxx.zip et genj_applet-xxx.zip
         cp /tmp/genj_fr-xxxx.zip /home/elysee/genj
         cp /tmp/genj_geo-xxxx.zip /home/elysee/genj
         cp /tmp/genj_applet-xxxx.zip /home/elysee/genj
      6. cd /home/elysee/genj (on se place dans le répertoire contenant toutes les archives qu'on vient de copier)
      7. unzip genj_app-xxxx.zip (On décompacte l'archive principale)
      8. unzip genj_fr-xxxx.zip (On décompacte l'archive contenant les fichiers d'aide et les fichiers en langue française)
      9. unzip genj_geo-xxxx.zip (On décompacte l'archive contenant le module de localisation géographique)
      10. unzip genj_applet-xxxx.zip (On décompacte l'archive contenant l'applet permettant une publication sur internet de sa généalogie)
      11. Maintenant que avez décompacté toutes ces archives, il faut les effacer :
          rm -f genj_app-xxxx.zip genj_fr-xxxx.zip genj_geo-xxxx.zip genj_applet-xxxx.zip
      12. cd /home/elysee/genj (je veux être sûr que vous êtes bien dans la répertoire genj)
      Bien sûr, si les archives possèdent d'un autre nom, vous agissez en conséquence.
      Les fichiers de démarrage vont se mettre dans ce répertoire racine de genj, et des sous-répertoires vont se créer en dessous, comme par exemple genj/doc, genj/lib, genj/report, genj/geo, genj/help, etc...
   3. Maintenant, je vais vous faire créer un fichier de démarrage différent de celui fourni avec GenJ. Je pense que vous serez plus à l'aise avec lui qu'avec celui qui est dans l'archive.
      Donc avec votre éditeur préféré (j'imagine que vous avez enfin repris l'éditeur "Nedit", dont je parle un peu plus haut), vous faites (vous êtes toujours dans le terminal qui vous a permis d'installer GenJ et vous êtes toujours dans le répertoire genj, je vous le rappelle) :
      nedit run
      Là l'éditeur va vous dire qu'il n'y a aucun fichier ou répertoire de ce type, vous cliquez sur "New File".
      Le plus simple maintenant, est de faire un copier/coller du texte qui suit :
      #!/bin/sh
      #
      JAVA_HOME="/usr/local/jre"
      GENJ_HOME=/home/elysee/genj
      GENJ_LIB_DIR=$GENJ_HOME/lib
      GENJ_REPORT_DIR=$GENJ_HOME/report
      GENJ_HELP_DIR=$GENJ_HOME/help
      GENJ_GEDCOM_DIR=$GENJ_HOME/gedcom
      clear
      cd $GENJ_HOME
      export CLASSPATH=$CLASSPATH:$GENJ_LIB_DIR/jfreechart.jar
      $JAVA_HOME/bin/java -Dgenj.debug.file=$GENJ_HOME/genj.log -Dgenj.file.max=100000 -Duser.home=. -Dgenj.gedcom.dir=$GENJ_GEDCOM_DIR -Dgenj.report.dir=$GENJ_REPORT_DIR -Dgenj.help.dir=$GENJ_HELP_DIR -Xms96m -Xmx896m -jar run.jar
      Bien sûr il est possible que le texte que vous voyez soit mis sur plusieurs lignes du fait du formatage de ce document. Mais n'oubliez pas que toutes les lignes, et notamment la dernière commençant par $JAVA_HOME/bin/java ....., doivent être sur une seule ligne.
      ATTENTION : Avant de quitter votre éditeur, vous avez à modifier une ligne, celle commençant par "GENJ_HOME=...", car bien sûr il faut remplacer "elysee", par le nom de votre répertoire personnel.
      Ensuite, vous sauvegardez votre nouveau fichier, et en sortant de l'éditeur, vous allez le rendre exécutable, donc tapez :
      chmod 755 run
      L'avantage de procéder de la sorte, est que l'ensemble des fichiers log, properties, etc... de GenJ vont aller se mettre sous le répertoire de genj lui-même, et non pas sous votre répertoire personnel. Vous verrez que dans la maintenance, et/ou la mise à jour, cette manière de faire vous facilitera la vie énormément.
      Remarque : Grace à cette manière de faire, vous allez voir que va se créer sous ce répertoire genj, un sous répertoire dont le nom commence par un "point" (dans un système Linux, il s'agit d'un fichier ou répertoire caché, et qui s'appelle ".genj" - donc vous aurez un truc du genre : /home/elysee/genj/.genj/.
      Dedans vous pourrez trouver les fichiers suivants par exemple :
      - jacques_chirac.ged.properties
      - genj.properties
      - genj.log
      - genj-reports.properties
      - jacques_chirac.geo.properties
        Ce fichier est celui qui va contenir les données géographiques (localisation) des villes, lieudits, etc.... que vous aurez entré manuellement.
        Regardez un peu plus loin ce qui est mis sur le module additionnel à GenJ, le module Geo".
      - etc...
   4. Maintenant, je vous conseille tout de suite, si vous avez déjà un fichier gedcom (jacques_chirac.ged par exemple) de le mettre là où il le faut.
      Compte tenu que vous êtes sous Linux et avec ce qu'on a fait ci-dessus, vous allez le copier dans le sous répertoire "genj/gedcom/" - Dans mon exemple, le fichier sera positionné comme ça : /home/elysee/genj/gedcom/jacques_chirac.ged.
   5. Lancez le script de démarrage que vous venez de créer à savoir "run", donc tapez :
      ./run
      Je suppose que vous ne savez pas quoi faire avec la fenêtre qui apparaît. Sachez que vous êtes devant ce qu'on appelle le Centre de Contrôle.
      Tout d'abord, il se peut que GenJ vous cause dans la langue de Shakespeare, au lieu du français.
      Pas grave, sur l'écran principal de GenJ, vous avez un menu déroulant qui s'appelle Views. Ouvrez-le, et choisissez la ligne "Options". Dans la fenêtre qui s'ouvre vous verrez une option "Language (After Restart)", prenez bien sûr la langue de Molière. Une fois que c'est fait, vous cliquez sur "OK" pour valider votre choix, et vous refermez GenJ. Maintenant si vous le relancez, il vous cause la française mieux que moi ;-).
      Ceci étant réglé, passons aux choses sérieuses si j'ose dire. Que fait-on devant cet écran ? Voilà une question qu'elle est bonne ?
      Pour ouvrir un fichier gedcom déjà existant, ou pour en créer un, il vous faut cliquer sur l'icone "Ouvrir", ou choisir "Ouvrir" dans le menu déroulant auquel vous accédez par l'option "Fichier".
      Si vous n'avez pas encore de fichier gedcom ou si vous voulez en créer un nouveau, cliquez sur "Nouveau". Si au contraire vous avez déjà un fichier gedcom, cliquez sur "Local".
      Si vous choisissez de créer un fichier gedcom "Nouveau", GenJ vous demandera le nom que vous voulez lui donner. Deux choses sont nécessaires :
      - D'une part, il faut que dans la fenêtre du navigateur qui s'ouvre, vous déplaciez l'endroit où le fichier va être créé. Déplacez vous dans "genj/gedcom" si vous n'y êtes pas déjà.
      - Ensuite, il faut lui mettre le nom du fichier que vous allez lui donner, GenJ demande "File name". Attribuez-lui le nom que vous voulez, allons y pour "jacques_chirac.ged" ou "bernadette.ged".
   6. Maintenant, si vous voulez changer un peu le look de GenJ, il vous faut télécharger une archive supplémentaire que vous trouverez sur mon site Arvernes. Le fichier qu'il faut prendre s'appelle "genj_lnf-xxxx.zip" (là encore, les xxxx sont à remplacer par le numéro de version qui sera disponible quand vous reprendrez le fichier).
      Une fois en votre possession, vous ferez comme décrit plus haut, et donc vous placerez ce fichier dans le répertoire de genj, dans mon exemple : /home/elysee/genj. Une fois dans ce répertoire, vous le décompresserez normalement, à savoir :
      unzip genj_lnf-xxxx.zip
      Il va se créer un sous répertoire sous genj, qui s'appelera "lnf". Ainsi vous aurez quelque chose du genre "/home/elysee/genj/lnf" avec dans ce sous-répertoire, des fichiers et autres sous-répertoires.
      Maintenant, pour changer l'aspect de GenJ, quand vous l'aurez lancé, il vous faudra rentrer dans le menu Visualisations - Options, et faire votre choix sur le look que vous préférez. La ligne qu'il faut regarder est "Aspect (Choisissez un thème)". Après avoir choisi le thème de votre choix, cliquez avec la souris dans un autre endroit de l'écran, ce qui valide votre choix.
      Il est fort possible que la taille de la fenêtre qui s'ouvre soit insuffisante pour que vous puissiez voir les options et la manière de les choisir. Pour ce faire, avec votre souris, il vous faut vous positionner dans le coin droit en bas de ladite fenêtre d'options qui vient de s'ouvrir, et en cliquant avec le bouton gauche, tout en maintenant le bouton de votre souris, l'agrandir à la taille qui vous satisfera.
      Normalement, vous devriez voir le nouveau look de GenJ en activant le thème que vous voulez.
      Remarques :
      - Il est possible de créer ses propres thèmes, par exemple j'ai créé le thème Skin(arvernesthemepack.zip). N'hésitez pas à voir comment il est fait, et à réaliser quelque chose de votre cru. Si par la suite vous vouliez en faire profiter la communauté des utilisateurs de GenJ, ce serait sympa, merci d'avance.
      - Certains thèmes plus spécifiques Windows, n'ont aucun effet sous Linux, donc si vous les choisissez, il n'y aura aucun changement. Prenez en un autre.
   7. Maintenant, au stade où vous en êtes, il vous faut vous pencher vers le chapitre sur le perfectionnement, notamment pour agrémenter la manière dont GenJ vous présente vos données (paragraphe : Agrémenter la présentation selon vos souhaits).
      Je vous conseille de le faire, car vous verrez que vous pourrez lui changer totalement son aspect et ce qui vous aura semblé quelque chose d'un peu rébarbatif, va devenir bien au contraire, trés trés agréable. Bon Vent.
   Bon, ben, ça y est !!
   Voilà, vous avez réussi à accéder à votre boulot de dans deux ans, en moins de 10 minutes, pas mauvais non.
   GenJ et Java sont installés, bon travail sur votre généalogie.
   Retour au Sommaire de la Procédure
   C - Installation sous Mac
   Comme pour les environnements Windows et Linux, on va scinder cette aide en deux parties, d'une part la partie Java proprement dite, et ensuite GenJ.
   Juste pour information, mais plus pour ceux qui, utilisant un autre Operating System, découvriraient Mac en lisant cette aide, on parle de Jaguar (pour Mac OS 10.2), de Panther (pour Mac OS 10.3), et de Tiger (pour Mac OS 10.4) la version actuelle du système.
   1°) - Installation de Java proprement dite.
   Si vous avez une version antérieure à Mac OS X, vous ne pourrez pas faire fonctionner GenJ sur votre Mac. GenJ requiert au moins la version 1.4 de Java, alors que la dernière version de Java pour Mac OS 9 est la 1.1.8.
   Sur Mac OS X (depuis 10.2 - Jaguar), pas de problème. Java a été installé avec le système. Vérifiez cependant que vous avez mis à jour votre système et que vous avez bien la dernière version de Java. Pour cela, après vous être connecté à internet, lancez "Mise à jour de logiciels…" depuis le menu pomme. Si vous utilisez Tiger et si vous préférez rechercher les mises-à-jour "manuellement", il est fortement conseillé de rechercher et télécharger la dernière version de Java sur le site d'Apple.
   Retour au Sommaire de la Procédure
   2°) - Installation de GenealogyJ.
   La version Mac de GenJ n'a pas d'installeur, mais ce n'est pas compliqué d'installer ce logiciel sur votre ordinateur.
   1. Allez dans la section Téléchargement - Plateforme générique de la page de téléchargement de GenJ. Téléchargez le fichier genj_app-2.4.2.zip (~5,3 Mo). Profitez-en pour télécharger le fichier "genj_fr-2.4.zip" (944 Ko) qui renferme la localisation, la contribution et l'aide en français du logiciel.
   2. Ouvrez ces fichiers pour les décompacter. Vous obtenez 2 dossiers du nom des fichiers téléchargés.
   Remarque, pour la lecture de la suite :
   Stéphane, qui m'a aidé à faire cette partie de l'aide pour Mac OS X, me mettait :
   Sous Mac OS X, je n'ai pas réussi à trouver un moyen identique à Linux de décompacter directement dans les dossiers de destination indiqués dans l'archive. Le système crée à chaque fois un dossier du même nom que l'archive et StuffIt Expander se plaint de ne trouver aucun dossier de destination indiqué, puis plante lamentablement quand il voit qu'il y a des dossiers qui portent déjà le même nom.
   Je ne vois pas d'autre solution que de tout décompresser, puis de faire glisser-déposer "à la main" les fichiers dans les bons dossiers, en suivant l'architecture incluse dans chacune des archives (par ex. ce qui est dans le dossier "lib" de l'achive "genj-fr" va dans le dossier "lib" de GenJ, etc). Attention à ne pas remplacer les dossiers de même nom l'un par l'autre.
   3. Ouvrez le dossier "genj_fr-2.4.2" :
      - Sélectionnez le dossier "contrib" et faites-le glisser dans le dossier "genj_app-2.4.2".
      - Sélectionnez le dossier "help" et faites-le glisser dans le dossier "genj_app-2.4.2".
      - Ouvrez le dossier "lib" et faites glisser les fichiers qu'il contient dans le dossier "lib" du dossier "genj_app-2.4.2" ;
   4. C'est fait ? Il ne vous reste plus qu'à placer le dossier "genj_app-2.4.2" (que vous pouvez renommer éventuellement en "GenJ") où vous voulez dans votre dossier Applications. Oualà !
   5. Pour lancer GenJ, il suffit de double-cliquer sur le fichier "run.jar". La première fois que le programme se lance, ou si c'est une mise à jour (vous avez mis une version plus récente), vous allez voir s'afficher ce qui en anglais s'appelle "Disclaimer" (Avertissement, comme quoi vous utilisez ce programme sous votre responsabilité, etc... enfin si vous ou l'un des membres de votre Equipe venait à être capturé, le gouvernement nierait toute implication - Mission Impossible réminiscences).
   6. Peut-être allez-vous remarquer que, bien que vous ayez demandé à ce que GenJ vous cause en français, il s'évertue à vous causer dans la langue de Shakespeare.
      Pas grave, sur l'écran principal de GenJ, vous avez un menu déroulant qui s'appelle Views. Ouvrez le, et choisissez la ligne "Options". Dans la fenêtre qui s'ouvre vous verrez une option "Language (After Restart)", prenez bien sûr la langue de Molière. Une fois que c'est fait, vous cliquez sur "OK" pour valider votre choix, et vous refermez GenJ. Maintenant si vous le relancez, il vous cause la française mieux que moi ;-).
   7. Vous pouvez aussi, pour faciliter les choses, placer le fichier "run.jar" dans le dock, ou bien créer un raccourci sur le bureau par le menu "Fichier > Créer un alias". Il suffit de faire glisser le petit fichier obtenu sur le bureau après l'avoir renommé en "GenJ".
   8. Maintenant, si vous voulez changer un peu le look de GenJ, il vous faut télécharger une archive supplémentaire que vous trouverez sur mon site Arvernes. Le fichier qu'il faut prendre s'appelle "genj_lnf-xxxx.zip" (1,1 Mo) (là encore, les xxxx sont à remplacer par le numéro de version qui sera disponible quand vous reprendrez le fichier).
      Une fois en votre possession, il vous faudra placer cette archive dans le dossier où se trouve GenJ et le décompacter dans ce dossier.
      Normalement, il devra se créer un sous-dossier qui s'appelera "lnf". Ainsi vous aurez quelque chose du genre "MonDisqueDur/Applications/GenJ/lnf" avec dans ce sous-dossier, des fichiers et autres sous-dossiers.
      Maintenant qu'il est installé, vous pouvez effacer l'archive, car vous n'en aurez plus besoin.
      Maintenant, pour changer l'aspect de GenJ, quand vous l'aurez lancé, il vous faudra sélectionner le menu "Visualisations" > "Options", et faire votre choix sur le look que vous préférez. La ligne qu'il faut regarder est "Aspect (Choisissez un thème)".
      Il est fort possible que la taille de la fenêtre qui s'ouvre soit insuffisante pour que vous puissiez voir les options et la manière de les choisir.
      Pour ce faire, avec votre souris, il vous faut cliquer dans le coin droit en bas de ladite fenêtre d'options qui vient de s'ouvrir, et l'agrandir à la taille qui vous satisfera.
      Normalement, vous devriez voir le nouveau look de GenJ en activant le thème que vous voulez.
      Remarque :
      Il est possible de créer ses propres thèmes, par exemple j'ai créé le thème Skin(arvernesthemepack.zip). Ce fichier est dans le dossier "skinlf.themes", lui-même dans le dossier "lnf". N'hésitez pas à voir comment il est fait, et à réaliser quelque chose de votre cru. Si par la suite vous vouliez en faire profiter la communauté des utilisateurs de GenJ, ce serait sympa, merci d'avance.
   9. Il est temps maintenant de mettre à jour votre version avec les derniers développements de GenJ. Pour cela il va falloir que vous alliez sur le site Arvernes et que vous repreniez au moins les fichiers suivants :
      - genj_app-xxx.zip
      - genj_fr-xxx.zip
      - genj_geo-xxx.zip
      - genj_applet-xxx.zip
      Vous devez commencer par fermer GenJ, vu qu'on va écraser ses fichiers. Il n'aimerait peut être pas rester ouvert.
      Vous allez décompacter TOUS ces fichiers dans le dossier qui contient GenJ, donc dans "LeNomDeMonDisqueDur/Applications/GenealogyJ". Pour le fichier de localisation et d'aide, pensez à refaire la procédure indiquée en 3.
      Si Mac OS vous demande si vous voulez écraser les fichiers déjà existants, répondez-lui "oui".
      Une fois que vous avez fini de bien décompacter ces fichiers, vous pouvez effacer l'archive, vous n'en aurez plus besoin.
   10. Sous les autres Operating Systems je vous conseillais si vous aviez déjà un fichier gedcom, de le copier dans un répertoire particulier (on parle de Dossier sous Mac). Sous Mac OS, les documents vont dans le dossier "Documents" du dossier perso (ce dossier perso est celui qui porte l'icône d'une maison). Il n'apparait pas utile de changer cette habitude, et cela ne correspondant pas à la philosophie du Mac on va supprimer cette étape.
       Maintenant, vous pouvez lancer GenJ.
       Je suppose que vous ne savez pas quoi faire avec la fenêtre qui apparaît. Sachez que vous êtes devant ce qu'on appelle le Centre de Contrôle.
       Pour ouvrir un fichier gedcom déjà existant, ou pour en créer un, il vous faut cliquer sur l'icône "Ouvrir", ou choisir "Ouvrir" dans le menu déroulant auquel vous accédez par l'option "Fichier".
       Si vous n'avez pas encore de fichier gedcom ou si vous voulez en créer un nouveau, cliquez sur "Nouveau". Si au contraire vous avez déjà un fichier gedcom, cliquez sur "Local".
       Si vous choisissez de créer un fichier gedcom "Nouveau", GenJ vous demandera le nom que vous voulez lui donner. Deux choses sont nécessaires :
       - D'une part, il faut que dans la fenêtre du navigateur qui s'ouvre, vous déplaciez l'endroit où le fichier va être créé. Déplacez-vous dans "LeNomDeMonDisqueDur/Applications/GenealogyJ/gedcom" ou bien allez dans le dossier Documents dans votre dossier perso..
       - Ensuite, il faut lui mettre le nom du fichier que vous allez lui donner, GenJ demande "File name". Mettez lui le nom que vous voulez, allons y pour "jacques_chirac.ged" ou "bernadette.ged".
   11. Maintenant, au stade où vous en êtes, il vous faut vous pencher vers le Chapitre sur le Perfectionnement, notamment pour agrémenter la manière dont GenJ vous présente vos données (Section : Modifier les paramètrages de GenJ).
       Je vous conseille de le faire, car vous verrez que vous pourrez lui changer totalement son aspect et ce qui vous aura semblé quelque chose d'un peu rébarbatif, va devenir bien au contraire, trés trés agréable. Bon Vent.
   Retour au Sommaire de la Procédure
   REMARQUE : Où sont les fichiers GenJ ?
   Dans le dossier de l'application que vous avez peut-être renommé "GenealogyJ", voilà ce que vous trouverez :
   1. Dans LeNomDeMonDisqueDur/Applications/GenealogyJ/, vous devriez trouver :
      - un dossier /contrib/
      - un dossier /doc/
      - un dossier /help/
      - un dossier /lib/
      - un dossier /gedcom/
      - un dossier /report/
      - puis, les fichiers : run.jar, run.bat, run.sh, run.cmd.
      - Eventuellement les dossiers /lnf/ et /geo/ si vous avez installé ces options.
   2. Au lancement, GenJ installe un dossier invisible (dont le nom commence par un point) ".genj" dans votre dossier personnel (représenté par une maison). Dedans vous devriez avoir tous les fichiers dont GenJ va avoir besoin pour conserver les paramètres de l'application. Ainsi vous aurez dans ce dossier :
      1. monfichier.ged.properties
         Ce fichier contient les paramètres d'affichage de votre fichier gedcom ; taille des fenêtres, signets, etc... Vous aurez autant de fichiers "monfichier.ged.properties" que de fichiers gedcoms ayant été ouverts par GenJ.
      2. genj-reports.properties
         Là, ce fichier contient les paramètres que vous aurez choisis pour les rapports que vous faites tourner.
      3. genj.properties
         Celui-ci est le plus important, car c'est lui qui reprend tous les paramètres de l'application, par exemple, quels sont les fichiers gedcom qui ont été ouverts, la taille du Centre de Controle, etc...
      4. monfichier.geo.properties
         Ce fichier est celui qui va contenir les données géographiques (localisation) des villes, lieudits, etc.... que vous aurez entré manuellement.
         Regardez un peu plus loin ce qui est mis sur le module additionnel à GenJ, le module Geo".
      5. genj.log
         Ce fichier est important, car si vous avez des soucis, c'est lui qu'il faudra envoyer aux développeurs, donc ne l'effacez pas, de toute façon suivant les paramètres que vous allez mettre dans les options, sa taille pourra être limitée à xxx koctets.
      Toujours dans votre dossier personnel se trouve un autre dossier invisible appelé ".java". Il a été installé par le système et est utile à GenJ. Dedans vous aurez tous vos paramètres de la machine virtuelle java.
   Là encore, je remercie très sincèrement Stéphane Lelaure qui utilisateur de GenJ sous Mac, m'a complètement mâché le travail puisque c'est lui qui a écrit toute la partie sur cet Operating System. Je n'ai eu qu'une mise en forme à faire, vu que tout était fait par lui y compris les captures d'écran. Merci encore Stéphane.
   Retour au Sommaire de la Procédure
   Remarques :
   - Chapitre sur le Perfectionnement
   Cet aspect, n'est disponible que sur le Site Arvernes, aussi je vous laisse le soin de vous y reporter. Merci.
   - Chapitre sur le Module Geo
   Cet aspect, n'est disponible que sur le Site Arvernes, aussi je vous laisse le soin de vous y reporter. Merci.
   - Chapitre sur le Paramètrage de GenJ
   Cet aspect, n'est disponible que sur le Site Arvernes, aussi je vous laisse le soin de vous y reporter. Merci.
   - Le site Arvernes
   Ce site est disponible à l'URL suivante :
   http://www.arvernes.com

Précédent | Haut | Suivant
Conseils | Index | Mes Premiers pas avec GenJ