*** README.en ***

Overview:
---------

This is a \LaTeX package for Korean language support.  With this
package, you can run latex on Korean \LaTeX document written in KS X
1001 encoding system or run lambda on Korean \LaTeX written in UTF-8
encoding system.


Installation:
-------------

Below, `TEXMF' indicates the root of TDS (TeX Directory Standard
version 1.1).

1. Install \LaTeXe.
  You can get \LaTeXe package in the CTAN site thru anonymous ftp.
  Most TeX distributions should have already \LaTeXe installed.

2. Get \HLaTeX-1.0 from
       ftp://ftp.dante.de/tex-archive/language/Korean/HLaTeX.tar.gz
  or
       ftp://ftp.ktug.or.kr/pub/ktug/hlatex/HLaTeX-1.0.tar.gz
  if you are in Korea.

   and unpack it.
       tar xzvf HLaTeX-1.0.tar.gz

  Veryfy that you have a file named VERSION-1.0 in the subdirectory of
  "HLaTeX".

3. Copy files as follows:

  - hangul.sty, hfont.tex, euc-kr.tex hfont.sty, josa.tab, hfont.cfg,
    hsw*.fd, hww*.fd, hhw*.fd in the directory "latex" to
       TEXMF/tex/latex/hlatex/

  - u8hangul.tex, uhc-test.tex, uhc*.fd in the directory "lambda" to
       TEXMF/tex/lambda/hlatex/

  - hlatex.otp, hlatex.ocp in the directory "lambda" to
       TEXMF/omega/{otp,ocp}/hlatex/

  - hbibname-k.tex, khyper.sty, showhkeys.sty, showhtags.sty,
    hangulfn.sty, hfn-k.tex in the directory "contrib" to
       TEXMF/tex/latex/hlatex/

  - hbibname-u.tex, hfn-u.tex in the directory "contrib" to
       TEXMF/tex/lambda/hlatex/

  - halpha.bst in the directory "contrib" to
       TEXMF/bibtex/bst/hlatex/

  - hind.ist, hglo.ist in the directory "contrib" to
       TEXMF/makeindex/

  - For UNIX/Linux OS goto "contrib" directory and compile
    hmakeindex.c, hbibtex.c
       gcc -o hmakeindex hmakeindex.c
       gcc -o hbibtex hbibtex.c
    and install hmakeindex and hbibtex to one of the system directory
    to which the environment variable PATH point.

    For Windows OS copy hmakeindex.ex and hbibtex.exe in the
    directory "contrib" to one of the system directory
    to which the environment variable PATH point.

4. Get Korean fonts from
       ftp://ftp.dante.de/tex-archive/fonts/Korean/HLaTeX/
  or
       ftp://ftp.ktug.or.kr/pub/ktug/hlatex/fonts/
  if you are in Korea.

  - uhc-base.map and uhc-extra.map in the file uhc-fonts-1.0.tar.gz
    should go to the directory TEXMF/fonts/map/hlatex/
    and run texhash.

  - uhc-base.map consists of the following font files
       uhc-myoungjo-1.0.tar.gz
       uhc-gothic-1.0.tar.gz
       uhc-taza-1.0.tar.gz
    unpack each file in the directory of TEXMF/fonts/ as follows
       tar xzvf uhc-myoungjo-1.0.tar.gz
       ...

  - uhc-extra.map consists of the following font files
       uhc-shinmun-1.0.tar.gz
       uhc-graphic-1.0.tar.gz
       uhc-gungseo-1.0.tar.gz
       uhc-bom-1.0.tar.gz
       uhc-pen-1.0.tar.gz
       uhc-pilgi-1.0.tar.gz
       uhc-yetgul-1.0.tar.gz
       uhc-jamo-1.0.tar.gz
       uhc-vada-1.0.tar.gz
       uhc-dinaru-1.0.tar.gz
       uhc-pilgia-1.0.tar.gz
    unpack each file in the directory of TEXMF/fonts/ as follows
       tar xzvf uhc-shinmun-1.0.tar.gz
       ...

  - run following commands
       texhash
       updmap-sys --enable Map=uhc-base.map
       updmap-sys --enable Map=uhc-extra.map

5. Update file database.
  If using teTeX run
       texhash
  as system super user.


For Linux OS (Fedora Core 3) only
---------------------------------

 Get RPM files from

       ftp://ktug.or.kr/pub/ktug/hlatex/RPM/hlatex-1.0-4.i386.rpm
       ftp://ktug.or.kr/pub/ktug/hlatex/RPM/hlatex-fonts-base-1.0-1.noarch.rpm
       ftp://ktug.or.kr/pub/ktug/hlatex/RPM/hlatex-fonts-extra-1.0-1.noarch.rpm
 and install with rpm as system super user.  This simplifies the
 installation procedures above.


Usage:
------
 You begin your document with

   \documentclass{article}
   \usepackage{hangul}
   \begin{document}

 and write your document.
 After closing your document with

   \end{document}

 you can process it with latex or lambda depending on the coding
 system used.


Problem:
--------

I appreciate if you report problems in or suggestions for \HLaTeX.

My E-mail address reads

       [email protected]

*** End of README.en ***