This section explains how to set up Hevea and Hacha under SWP. You will need a version of unzip that understands long file names.

6  Obtaining the files

You will need:

1. The Hevea Win-32 system (in the file winport.zip) from

   http://facweb.knowlton.ohio-state.edu/pviton/support/winport.zip (corresponds to Hevea 2.05) or http://facweb.knowlton.ohio-state.edu/pviton/support/winport199.zip (corresponds to Hevea 1.99). As noted above, I recommend not using version 1.99 unless you have a specific reason to do so.

   The SWP extensions themselves in the file hevea-swp.zip from

   http://facweb.knowlton.ohio-state.edu/pviton/support/hevea-swp.zip

2. The Hevea manual which can be found at the main Hevea site,

   http://para.inria.fr/~maranget/hevea/

Steve Mayer has produced a nice graphical front-end to Hevea (and other T_EX/L^AT_EX converters). It can be obtained from

http://www.mayer.dial.pipex.com/tex.htm

Appendix G explains how to set up the Converter for Hevea-SWP.

7  Setting up Hevea and Hacha

1. If you are upgrading from a previous release of Hevea, it is safe to simply get the new files and install them over the old ones.
2. Create a directory on your disk for the Hevea files. This directory should not be part of your SWP system directory. In addition, because Hevea is a port of a Unix program, neither the directory name nor the path to it should contain spaces, so do not put the files in c:\Program Files. I suggest c:\hevea.
3. Unzip winport.zip to this directory, preserving subdirectories. You should see five subdirectories (html, text, info, mappings, and test).
4. Unzip the files in hevea-swp.zip to the same directory, preserving subdirectories. Some files may over-write previous ones: this is expected. You should verify that both the html and the text subdirectories contain a file swp.hva. If you’re not interested in the programming to support the \today macro (see section 16.1) you can delete xdate.c and xxdate.cpp.

Next we set up some batch files.

1. Open each .bat file and make sure that the line beginning set heveadir= points to the directory where you installed Hevea. The pointer should not end with a backslash character. If you customized previous versions of the batch files, add your customizations to the new versions.
2. Move the files to some directory in your path: that way you will be able to call the translator from any directory on your hard disk. Delete the batch files from the Hevea directory.

8  Testing the translator

The SWP distribution contains a small test file (heveatest.tex, plus graphics files heveatest.wmf and heveatest.gif) to check that the system is working. To run the test:

• Start a DOS session, change to the \test subdirectory of the main Hevea directory.
• Issue the command hhtml heveatest. Hevea will run, and, aside from a notification that the .hvb file was found (see section 9), there should be no warnings or errors. In a few seconds you will have heveatest.html in your directory. If you’d rather generate heveatest.htm you can say hhtml heveatest -o heveatest.htm (the -o switch controls the output name).

You can now view the result in your browser.