#######################################################################
#  README FOR                                                         #
#  HTMLTOTEX VERSION 1.1 and IMGTOPS VERSION: 1.0                     #
#                                                                     #
#  LAST MODIFIED: Dec 8 1997                                         #
#######################################################################

Installation instructions

First uncompress and unpack the file htmltotex.tar.gz.
You must already have done this, since you are reading
this file. Now you may either install the files manually or take
the help of the Makefile provided. The installation procedure is
easy in both the cases.

Manual installation:
    *  cd bin
    *  Check where you have Perl5 and in what name. As an example, let us
       assume that the name of your Perl compiler is
            /usr/bin/perl5
    *  Add the following line
       #!/usr/bin/perl5
       at the beginning of htmltotex and imgtops.
    *  Copy these two files to some public bin directory, say, for
       example, /usr/local/bin/. 
    *  cd ../lib
    *  Create a new file htmltotex.rc specifying the following
       resources:
           *  HTTPD_HOME is the httpd home of your machine. 
           *  PUBLIC_HTML_DIR is the directory for users' homepages
              in your machine. 
           *  LOCAL_HOST is the name of your machine. If your
              machine has more than one names separate the different
              names by colons (:). 
       A sample htmltotex.rc looks like this: (Leave no blank spaces and lines)

       HTTPD_HOME=/usr/local/etc/httpd/htdocs/
       PUBLIC_HTML_DIR=public_html/
       LOCAL_HOST=agastya:agastya.csa:agastya.csa.iisc:agastya.csa.iisc.ernet.in:144.16.67.96

    *  Copy the library files, namely fonts.mac, misc.mac, spl-chars
       and htmltotex.rc to one of the following directories: 
              /usr/local/lib/htmltotex/ 
              /usr/local/htmltotex/ 
              ~/.htmltotex/ 
       If you do not copy the library files to one of these directories, you
       always need them to reside in the current directory for htmltotex
       to work. Alternatively, you may choose any directory for the
       library files. In that case you have to supply the name of this
       directory as an argument to the command line option -L, whenever
       you run htmltotex. It is painful. Better maintain an alias.
    *  cd ..
    *  Copy the man pages, namely, htmltotex.1 and imgtops.1 to section 1
       of your man pages directory (for example, /usr/man/man1).
    *  Copy the html tutorials provided to some directory of your
       prefernce for future referencing and trouble-shooting. This is,
       however, optional.

Use Makefile:

    *  Edit Makefile and incorporate the following changes.

       DIRECTORIES:
       BIN_DIR    - directory for the perl programs (htmltotex and imgtops)
       MAN_DIR    - directory for man pages
       LIB_DIR    - directory for library files; this should better be one of
                    the following:
                    /usr/local/lib/htmltotex/ 
                    /usr/local/htmltotex/ 
                    ~/.htmltotex/
       HTML_DIR   - directory for installing the html tutorials (optional)

       PERL PROGRAM:
       The complete path plus name of your perl5 interpreter. If you do
       not know this, try
          where perl
       or
          whereis perl
       Note that your perl compiler has to be of version 5. Version 4 will
       not do.

       Global resource values:
       These are needed for preparing the file htmltotex.rc as described
       in the section "Manual installation". Specify the following
           *  HTTPD_HOME is the httpd home of your machine. 
           *  PUBLIC_HTML_DIR is the directory for users' homepages
              in your machine. 
           *  LOCAL_HOST is the name of your machine. If your
              machine has more than one names separate the different
              names by colons (:).

    *  This completes the editing of Makefile. Now type:

          make
          make install
          make installman

       If you are interested in installing the html pages, type

          make installhtml

       Finally

          make clean

       cleans all the unnecessary files.

Now try to convert the file test.html using htmltotex. Use commands like
this:
   htmltotex -o test.tex test.html
   tex test

Requirements

htmltotex

    *  Perl 5 
    *  The library files: fonts.mac, misc.mac, spl-chars and
       htmltotex.rc. These are provided in the distribution. 
    *  The image converter program imgtops (if you like to put inline
       images in your TeX document) 
    *  The file epsf.sty for incorporating inline images in TeX files. 

imgtops

    *  The package netpbm
    *  The program djpeg (for jpeg files) 

Author

   Abhijit Das (Barda)
   Department of Computer Science and Automation
   Indian Institute of Science
   Bangalore 560 012
   INDIA
   E-mail: abhij@csa.iisc.ernet.in
   URL: http://www2.csa.iisc.ernet.in/~abhij/

