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),
unarchive into a suitable directory. If Hardy2HTML is supplied as a zip
file, 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.
 
Change directory to UTILS 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.


It is assumed that you have obtained a recent version of Hardy for Windows
95 (1.85 or above). 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.

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.

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

