Chinese GIF Creator - Copylefted 1998 by Erik Peterson
~~~~~~~~~~~~~~~~~~~

   This file describes how to install the online Chinese GIF creator formerly
available at http://www.erols.com/eepeter/chgif.html (until my server shut it down).
Please refer questions to erik@mandarintools.com.  Please visit 
http://www.mandarintools.com for updates of this distribution.  This code is
made freely available with the condition that I be credited as the original
author.  Enjoy!

Requirements
------------

1.  This zip file, which includes chgif.html, chgif.pl, chinese.gif and blib.
2.  Perl 5
3.  codelib.pl, available from http://www.erols.com/eepeter/download/codelib.zip
4.  CGI.pm perl module (might already come with your perl distribution).
5.  The GD library (a version compiled for Linux is included with this
distribution in the blib directory).
6.  GB/Unicode and Big5/Unicode equivalence files.  Available at
ftp://ftp.unicode.org/Public/MAPPINGS/EASTASIA/GB/GB2312.TXT 
ftp://ftp.unicode.org/Public/MAPPINGS/EASTASIA/OTHER/BIG5.TXT
7.  Four Unicode font files.  Available at:
ftp://ftp.ifcss.org/pub/software/fonts/unicode/hbf/UniHan16.bin.gz
ftp://ftp.ifcss.org/pub/software/fonts/unicode/hbf/UniHan24.bin.gz
ftp://ftp.ifcss.org/pub/software/fonts/unicode/hbf/Wide16.bin.gz
ftp://ftp.ifcss.org/pub/software/fonts/unicode/hbf/Wide24.bin.gz
or at
http://www.erols.com/eepeter/cgi-bin/fonts
8.  Some time and patience.


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

1.  Select a directory to install the required files.  For most users,
    this will be the CGI directory as assigned by the server.  I will
    refer to this directory as CGIDIR below.

2.  Under CGIDIR create a directory called "fonts".  Place the four
    font files (UniHan16.bin, UniHan24.bin, Wide16.bin, Wide24.bin) in
    this directory (be sure to use binary mode for ftp).

3.  Please the BIG5.TXT, GB2312.TXT, chinese.gif, chgif.pl and
    codelib.pl files in CGIDIR.

4.  Next, place the blib directory and its contents under CGIDIR.  Be
    sure to maintain the directory structure.

5.  Make some changes to chgif.html 
 a.  line 18:  Change the ACTION in the FORM to point to the URL used to call
     chgif.pl as a CGI program.

6.  Make some changes to chgif.pl
 a.  line 1:  Change to path of perl on your server
 b.  line 3:  Change "/var/www/htdocs/eepeter/cgi-bin" to the value
     of CGIDIR on your server.

7.  Open chgif.html on your browser and try to run the tool.


Possible Problems
-----------------
   1.  You are not running on a Linux based server.  Get a distribution of
GD for you local operation system.
   2.  