Hardy2HTML
----------

About this program
------------------

Hardy2HTML converts indexes consisting of diagrams and text cards, into
browsable HTML. Hardy2HTML is written in CLIPS. 

Installation
------------

To install the software on Windows 95 (the only supported platform) you
need a recent version of Hardy for Windows 95 (1.84 or above).

1) If you have installed Hardy 1.85 or above plus the Hardy SDK, you already have
Hardy2HTML, in the subdirectory hardysdk/clips/html. Go to step (3).

2) If you have a zip file, e.g. hrdy2htm.zip, unarchive into a suitable
directory. This will involve something like this in DOS:

 c:\> mkdir hrdy2htm
 c:\> cd hrdy2htm
 c:\hrdy2htm> pkunzip -d hrdy2htm.zip

(the -d tells pkunzip to create subdirectories).

Alternatively, you can use a Windows unarchiver such as WinZip to unzip
into an appropriate directory.

You now have a directory containing:

 - CLIPS and sample files;
 - a subdirectory STANDARD, containing HTML and GIF files;
 - a subdirectory UTILS, containing dcview21.zip.
 
3) Change directory to the UTILS subdirectory and unzip dcview21.zip (no
-d necessary this time). Copy the DOS executable cview.exe into a
directory on your PATH, such as c:\windows. It is needed to convert
Windows bitmaps to GIFs and will be invoked by Hardy2HTML. 

4) You now need to create a shortcut (Program Manager icon in Windows
3.1 parlance) which will invoke Hardy, load the CLIPS code, and
optionally load the required index file. In some Hardy installations
(1.65) you may already have such a shortcut for the Hardy2HTML demo.

Here's an example command line that you might put in your shortcut (the
line breaks are for convenience of illustration only). It loads the
demo index file.

  c:\hardy\hardy.exe
    -def c:\hrdy2htm\diagrams.def
    -f c:\hrdy2htm\demo.ind
    -dir c:\hrdy2htm
    -clips c:\hrdy2htm\loader.clp
    
This length of command line is required because in general, the Hardy
executable, the Hardy2HTML source code and the diagrams to be converted
may all be in different directories, and you have to be explicit about
where they all are. So for example, if your index file is in a
different place from Hardy2HTML, you might have another shortcut:

  c:\hardy\hardy.exe
    -def c:\projects\idef\diagrams.def
    -f c:\projects\idef\demo.ind
    -dir c:\hrdy2htm
    -clips c:\hrdy2htm\loader.clp

You can create as many shortcuts as you need, for different purposes.
If you don't want to open an index file immediately, omit the -f switch.

5) Once you have Hardy2HTML installed, please follow the instructions in
the Hardy2HTML help file (UTILS/HELP.HTM) for running the software.



