                           ImajeJen User's Guide

                     Copyright  1999 Robert Thivierge

 Note: This document is included in plain text format with ImajeJen and is
also available on-line at http://www.imajejen.com/UsersGuide.html.
ImajeJen's home page is located at ImajeJen.com.

System Requirements:

  1. The Java 2 Run-Time Environment, version 1.2 or better. If you are
     using Windows 95/98 or NT, I recommend you download Sun's version at
     http://java.sun.com/products/jdk/1.2/jre/download-windows.html. For
     further information about Java, you should go to the Java(tm)
     Technology Home Page. Please note that the Java Run-Time Environment
     for running a Java application may not be installed with the built-in
     support that comes with some browsers (i.e. Netscape and IE). You will
     have to get it separately.
  2. Enough hard disk space to make a complete copy of all of your images,
     plus an extra 50-100%. The ImajeJen program files use well under 100K.



Installation on Windows 95/98 and NT 4.0 (other users should also read):

  1. Backup your entire computer before continuing.
  2. Ensure that you have The Java Runtime Environment. It should support
     Java 2, version 1.2 or better.
  3. Create a new file folder (directory) called "C:\ImajeJen".
  4. Download the file ImajeJen.zip from
     http://www.ImajeJen.com/ImajeJen.zip, save it in the folder
     "C:\ImajeJen". In your web browser, right-click on the previous
     highlighted text, and select "Save Target As" or "Save Link As". The
     dialog box that comes up will let you create and select the folder.
  5. Unzip the ImajeJen.zip file into this folder. You can use PKZip or any
     compatible program. Other programs you can use are WinZip and
     Info-Zip.
  6. Minimize or close all active windows.
  7. On the Windows desktop, right-click an open area.
  8. Select "New/Shortcut". A dialog box labeled "Create Shortcut" will
     appear.
  9. Under "Command Line" input "javaw" and click Next. If you're told "the
     file javaw.exe cannot be found", you might not have the correct Java
     Run-Time Environment installed.
 10. On the next screen you will be asked to enter a name for the shortcut.
     Type in "ImajeJen".
 11. Click on "Finish". You should now see a new shortcut (icon) on your
     Windows Desktop.
 12. Now right-click the shortcut (icon) you just created and select
     properties.
 13. Next to "Start In", input "C:\ImajeJen".
 14. Add the following to the end of the command line (Target): -cp
     ImajeJen.jar com.ImajeJen.ImajeJen
 15. The command line (Target) should look something like:
     "c:\windows\system\javaw.exe" -cp ImajeJen.jar ImajeJen
 16. Remember, Java and ImajeJen are case-sensitive, so be very careful
     typing. The word "ImajeJen" is always spelled with mixed case. You may
     want to copy and paste the appropriate text from this document, to
     avoid retyping.
 17. Click OK to save your changes.
 18. ImajeJen should be installed properly now. A sample short-cut file,
     called "ImajeJen.lnk", is included in the ImajeJen.zip file.



Running ImajeJen in Windows 95/98 and NT 4.0 (other users should also
read):

  1. If this is your first time running ImajeJen, please test it out with a
     small collection of pictures at first.
  2. Close all other active programs. Save and backup all of your other
     work.
  3. Double click on the "ImajeJen" shortcut.
  4. Fill in all the fields you see.
  5. You must type in the Source and Destination folders exactly. There is
     no dialog box for selecting them. If the Destination Folder does not
     exist, it will be created. If it does exist, it's contents will be
     overwritten.
  6. Optionally, you may edit image descriptions by pressing the "Edit
     Descriptions" button.
  7. You can click the save button, if you want to preserve your layout
     changes.
  8. Click on "Generate" to create the web site.
  9. You will now see a warning about files that will be overwritten. This
     is your last chance to avoid overwriting existing files. After this,
     ImajeJen will overwrite files without further confirmations. If your
     know what you're doing click OK. A status bar should appear indicating
     the programs progress. You can use the "Cancel" button to safely abort
     the operation. Otherwise, wait patiently.
 10. When done, select File/Exit to terminate the program.
 11. ImajeJen creates a new file in the Destination Folder, called
     "index.html". By opening this file in your web browser, you can access
     all pages and other files created by ImajeJen.
 12. That's it. You should be able to open a file called "index.html" in
     the destination folder, using your web browser.
 13. At this point, you may made need to transport (i.e. FTP) your files to
     your web server. When doing this, remember to only move the Target
     Folder, not the Source Folder. ImajeJen copies all files, so there are
     no references to the source images



Installing and Running ImajeJen on UNIX

  1. Create a new directory, exclusively for ImajeJen.
  2. Use "unzip" to uncompress ImajeJen.zip. A free version of unzip is
     available from the Info-Zip Home Page. ImajeJen must be placed in its
     own directory.
  3. Ensure the "java" command is in your path.
  4. Start X-Windows if it's not already running. This version of ImajeJen
     requires a GUI. Future versions will also work from the command-line.
  5. Start an xterm window.
  6. Go to your ImajeJen directory.
  7. Type in the following command: java -cp ImajeJen.jar ImajeJen



After you create a web site, please let me know at info@ImajeJen.com. Also,
please add links from your web site to ImajeJen.com. If enough site traffic
is generated, I will be able to keep producing ImajeJen as freeware.

The following details are for advanced users doing troubleshooting.

Technical Details:

  Object File Name                                 ImajeJen.jar

  Initial Class, which contains main()             ImajeJen

  Initial Class's Package                          com.ImajeJen

  Qualified Initial Class name                     com.ImajeJen.ImajeJen

  External Packages other than those that are      None
  standard (as of Java 2 v 1.2).

  Class Path                                       ImajeJen.jar

  Java Version                                     1.1 or better

  Event Model                                      AWT 1.1 event dispatching model

  Recommend Java Runtime Environment               Sun's Java Runtime Environment (TM) 1.2.

  Program Type                                     Application (i.e. not an applet)

  Security                                         As a Java Application, ImajeJen does not run
                                                   under security controls, like an Applet does.
                                                   ImajeJen has full access to all of your
                                                   computer's files and other resources.



                 Send comments to mailto:info@ImajeJen.com
