# GenJ - Applet HOWTO

## INTRODUCTION

There are two basic modes of how to package your data for the GenJ applet. You can provide all your Gedcom information and external files (e.g. pictures, .properties) in a directory relative to the applet's HTML page. Alternatively you can also create an archive of all this information (use zip and preserve directory structure).

You can either use ./lib/genj.jar and ./lib/graph.jar coming with the default distribution genj_app-x.y.zip or download genj_applet-x.y.zip and use it's contained smaller libraries (reduced to necessary minimum).

The end-result should look something like this:

## PREPARING APPLET FILES (unzipped)

Follow these steps to provide all necessary files for running GenJ as an applet:

      + place genj.jar + graphj.jar in [directory]

      + place [file].ged and any associated images into [directory]

      + optionally copy [file].ged.properties and the folder blueprints into [directory] to keep custom settings*
         (* the local settings files are stored under ~/.genj or c:/documents and settings/[username]/application data/genj)

      + add a HTML page that includes the following tag

       <applet
         code="genj.applet.Applet.class"
         width="200" height="160"
         archive="./genj.jar, ./graphj.jar"
         alt="GenealogyJ">
        <param name="gedcom" value="./[file.ged]">
       </applet>

      + make sure that the result looks like this

        ./[your-html].html
        ./genj.jar
        ./graph.jar
        ./genj.properties
        ./file.ged
        ./file.ged.properties
        ./image1.jpg
        ./blueprints

## PREPARING APPLET FILES (zipped)

      + zip [file].ged and any associated images into [file].zip

      + optionally add [file].ged.properties and the folder blueprints to keep custom settings*

      + place [file].zip into [directory]

      + add a HTML page that includes the following tag

       <applet
         code="genj.applet.Applet.class"
         width="200"
         height="160"
         archive="./genj.jar, ./graphj.jar"
         alt="GenealogyJ">
        <param name="gedcom" value="./[file.zip]#[file.ged]">
       </applet>

      + make sure that the result looks like this

        ./[your-html].html
        ./graph.jar
        ./genj.jar
        ./file.zip

## MAKING THE APPLET SPEAK YOUR LANGUAGE

      + place the language file of choice genj_xx.jar into [directory]

      + add that jar to the Applet's HTML tag - archive attribute

       <applet
         ...
         archive="./genj.jar, ./graphj.jar, ./genj_xx.jar"
         ...

      <applet
         code="genj.applet.Applet.class"
         width="200"
         height="160"
         archive="./genj.jar, ./graphj.jar"
         alt="GenealogyJ">
        <param name="gedcom" value="./genj_install_exemple.zip#genj_install_exemple.ged">
       </applet>