*** README.eng ***

Overview:
---------
This is a \LaTeX package to use Hangul with \LaTeX.
With this package, you can run latex on KSC 5601 based Korean LaTeX
file to produce a professionally looking Korean documents. You can
typeset all Korean characters defined in KSC 5601, including Korean
Symbol, Hangul and Hanja.

Overview(0.92e):
---------------
This is \HLaTeX-0.92e, a co-work of Baek, Yunju (H\LaTeX-0.91) and Un,
Koaunghi (jhtex-0.7).  With this you can process Korean \LaTeX
documents written in KSC5601 Symbol, Hangul and Hanja codes. This
version was intended to be a combined \HLaTeX version of the above two
authors, named \HLaTeX-0.92, but since the middle of December(1995)
last year I (Un) couldn't reach Mr. Baek. -- He was finishing his
laboratory at KAIST --  At that time, we've made a test version
\HLaTeX-0.92d, which was ready to be released after two possible
corrections. Because "We" couldn't finish it, I made these corrections
alone and decided to release this package as \HLaTeX-0.92e.

With this version, compared with the old, we now don't need htex,
ks-to-tex converter, and we doesn't use Japanese Kanji fonts.  See the
file changelog.ks for the changes in this version. This files is
written in KS code. Starting from version 0.93, I provide a set of
Hangul/Hanja/Symbol source for MetaFont, from which you must generate
PK fonts for printing/priviewing \HLaTeX document. The standard Wansung
arrangement of fonts requires large storage space for the fonts, e.g.
150MB for 300dpi printers. If you don't have such a large free space,
you can still use the old Hangul pk fonts, which can only be used for
300dpi or 600dpi printers.

I have been making Hangul Johab fonts as well, which take less storage
space. Some unfinished results are provided with \HLaTeX-0.96, which
looks not so good, but usable. So if the storage space is important
for you, you can use these fonts with \HLaTeX.

The file hlguide.ps is a PostScript file generated from
hlguide.dvi by latex'ing hlguide.tex, in which you can get
some informations for using and installing \HLaTeX in Hangul. This
file is also written in KS code. A notes for processing hlguide.tex
for your self: After the release of web2c-7.0, TeX can use maxial 2000
font register in a document. Former version of TeX can use only 256
font register in a document. hlatex.tex uses more than ca. 370
fonts. So if your TeX is older than web2c-7.0, you can't process
hlguide.tex.

This package provides no pre-made fonts, that you need to use this
package. You can make PK fonts with standard mf program. The MetaFont
sources or PostScript fonts can be found at:

CTAN: ~ftp/tex-archive/fonts/korean/HLaTeX

or

cair-archive.kaist.ac.kr: ~ftp/pub/hangul/tex/HLaTeX/fonts

Installation:
-------------
Below, 'texmf' indicates the root of TDS (TeX Directory Standard).
1. Install LaTeX2e.
   You can get LaTeX2e package in the CTAN site thru anonymous ftp,
   e.g.
	ftp.dante.de
   or
	cair-archive.kaist.ac.kr
   if you are in Korea.

2. Get and unpack \HLaTeX-0.98.

   	mkdir hlatex-0.98
   	cd hlatex-0.98
   	ftp ftp.dante.de
   	ftp> cd tex-archive/languages/korean/
   	ftp> get HLaTeX.tar.gz
   	ftp> quit
   	zcat HLaTeX.tar.gz | tar xvf -

   There is a file named VERSION?.?? in the directory of
   HLaTeX, from which you can take the version of \HLaTeX you are
   getting.

3. copy hfont.tex, hangul.sty, hfont.sty, hfontold.tex, josa.tab,
   oldhan.tab, h*.fd, hfont.cfg, hltx209.cfg and hsfonts.def to
   /texmf/tex/latex/local.

	mkdir texmf/tex/latex/hlatex
        cp hangul.sty texmf/tex/latex/hlatex
	cp ...

4. Install Hangul fonts.
   emTeX users may read emtex/readme first.
   (a) For MetaFont
       First get the MetaFont sources from CTAN, e.g. ftp.dante.de,
       ftp.uni-stuttgart.de, cair-archive.kaist.ac.kr,...

       	ftp ftp.dante.de
       	ftp> cd tex-archive/fonts/korean/HLaTeX
       	ftp> bin
       	ftp> get wsmj.tar.gz
       	ftp> ...
       	ftp> bye

      The basic fonts are:
       	wsmj.tar.gz (Hangul myoungjo)
       	wsgt.tar.gz (Hangul gothic)
	taza.tar.gz (Hangul/Hanja/Symbol taza)
       	hanja-myoungjo.tar.gz (Hanja myoungjo)
       	hanja-gothic.tar.gz (Hanja gothic)
       	hsym.tar.gz (Hangul symbol: myoungjo, gothic)

      There is a important global macro files in this package:
       	common.tar.gz (common driver)

      There are many other fonts, which you can also use with \HLaTeX:
	taza.tar.gz (Hangul taza)
        wsgr.tar.gz (Hangul graphic)
       	wsgs.tar.gz (Hangul gungseo)
       	wsmg.tar.gz (Hangul mokgak)
        wsyt.tar.gz (Hangul yetgul)
        wssm.tar.gz (Hangul new myoungjo)
        wspg.tar.gz (Hangul pilgi)
        wspn.tar.gz (Hangul pen: upright, italic)
        wsbm.tar.gz (Hangul bom)
        wsol.tar.gz (Hangul outline)
       	jamo.tar.gz (jamo based Hangul: myoungjo, gothic, sora, novel)
       	hanja-gungseo.tar.gz (Hanja gungseo)

      If you make slides in LaTeX's compatibility mode, you need this:
       	hslide.tar.gz

   (a-1) If you install only pre-made pk fonts from these mf sources,
      unpack the sources in the fonts subdirectory.

       	cd fonts
       	gzip -cd ../wsmj.tar.gz | tar xvf -
       	...

      Edit Makefile, and compile as described in the Makefile.
      (Note: all fonts files in the file hslide.tar.gz are made
       using virtual font technique. You don't need to (or can't)
       make pk files from this. All you do, is to unpack this file
       in the TeX's fonts directory.

       	 cd texmf/fonts
       	 gzip -cd ..../hslide.tar.gz | tar xvf - )

   (a-2) If you rely on the MakeTeXPK script to make pk files
      automatically from the installed mf sources
      unpack mf sources in the texmf/fonts directory.

       	cd texmf/fonts
       	gzip -cd ..../wsmj.tar.gz | tar xvf -
       	...

      If your TeX is older than web2c-7.0,
      append special.map in the directory of fonts/config to the
      TeX's special.map.

       	cat fonts/config/special.map >> texmf/fontname/special.map

      From this file, MakeTeXPK gets the information, where the
      produced pk files go to. If this information is not provided,
      MakeTeXPK assumes it as unknown/unknown. In case of web2c-7.0
      the location of directory for the newly made pk fonts is the same
      as the location of mf source.

      After finishing to install fonts, some TeX distribution need to
      update ls-R database file. e.g. teTeX and web2c-7.0 ...

       	texhash		(in case of teTeX)
       	MakeTeXls-R	(in case of web2c-7.0)

   (b) For PostScript
       get PostScript fonts from CTAN:

       	ftp ftp.dante.de
       	ftp> cd tex-archive/fonts/korean/HLaTeX
       	ftp> bin
       	ftp> get pkmj.tar.gz
       	ftp> ...

       The basic fonts are:
       	pkmj.tar.gz (Hangul myoungjo)
       	pkgt.tar.gz (Hangul gothic)
	ptaza.tar.gz (Hangul/Hanja/Symbol taza)
       	pshanja-myoungjo.tar.gz (Hanja myoungjo)
       	pshanja-gothic.tar.gz (Hanja gothic)
       	phsym.tar.gz (Hangul symbol: myoungjo, gothic)

       There are many other fonts, which you can also use with \HLaTeX:
	ptaza.tar.gz (Hangul taza)
        pkgr.tar.gz  (Hangul graphic)
       	pkgs.tar.gz  (Hangul gungseo)
       	pkmg.tar.gz  (Hangul mokgak)
        pkyt.tar.gz  (Hangul yetgul)
        pksm.tar.gz  (Hangul new myoungjo)
        pkpg.tar.gz  (Hangul pilgi)
        pkpn.tar.gz  (Hangul pen: upright, italic)
        pkbm.tar.gz  (Hangul bom)
        pkol.tar.gz  (Hangul outline)
       	pjamo.tar.gz (jamo based Hangul: myoungjo, gothic, sora, novel)
       	pshanja-gungseo.tar.gz (Hanja gungseo)

       If you make slides in LaTeX's compatibility mode, you need this:
       	phslide.tar.gz

       Unpack these files in texmf/fonts directory.

       	cd texmf/fonts
       	gzip -cd ..../pkmj.tar.gz | tar xvf -
       	...

       In the directory of fonts/config, there are some configuration files
       for using hangul ps fonts in LaTeX:
	special.map:		for TeX preview
	hlatex.upr:		for TeX preview
	psfonts.map:		for TeX print
	hlatex.enc:		encoding vector of pfb files
       	Fontmap:		for ghostscript. used by gsftopk.

       Install special.map as described in the case of MetaFont.
       This step is unnessary for web2c-7.0 or higher, as describe in
       the case of MetaFont.

       	cat fonts/config/special.map >> texmf/fontname/special.map

       Fontmap is for ghostscript. Append this to the Fontmap of
       ghostscript.

	cat fonts/config/Fontmap >> /usr/local/share/ghostscript/4.03/Fontmap

       hlatex.enc is not needed for TeX.

       You need psfonts.map to print dvi file with dvips or to preview it
       with xdvi. append this file to the psfonts.map of dvips.

	cat fonts/config/psfonts.map >> texmf/dvips/psfonts.map

       If you print ps files without ghostscript (directly to PS printer),
       you should download ps fonts to the printer. For this you need to
       edit psfonts.map, append "<???.pfb" at the end of each line. E.g.

      	pkbmm00 Hangul-BomA-Medium <pkbmm0.pfb
      	pkbmm01 Hangul-BomA-Medium " .167 SlantFont " <pkbmm0.pfb

       hlatex.upr is a postscript fonts resource file needed by ps2pk
       version 1.5. verion 1.5 is faster and simpler to use than version
       1.4. The provied file may be edited to set the directory of your
       installation. the directory is set on 6th line. You change
	//usr/teTeX/texmf/fonts
       to
       	//usr/share/texmf/fonts

       You can also make this file for yourself.

	mkpsres -o hlatex.upr /usr/share/texmf/fonts/{afm,type1}/korean

       And then copy hlatex.upr to ps2pk directory

       	cp hlatex.upr texmf/dvips/ps2pk

       After finishing to install fonts, some TeX distribution need to
       update ls-R database file. e.g. teTeX and web2c-7.0 ...

	texhash		(in case of teTeX)
	MakeTeXls-R	(in case of web2c-7.0)

   (c) If you intend to use Johab fonts.
       The fonts are

	johab.tar.gz	(mf fonts: myoungjo, gothic, pen upright)
	pjohab.tar.gz	(ps fonts: myoungjo, gothic, pen upright)

       Install fonts as described (a) or (b). You can use the lacking
       Wansung fonts in addition, if you install the Wansung fonts.

Usage:
------
  You begin your document with
    \documentclass[hanja,...]{article}
    \usepackage{hangul}
    \begin{document}

  and write your document with KS codes including Hangul and Hanja.
  After closing your document with

    \end{document}

  you can process it with latex2e.
  With the option 'hanja', you tell that latex must format
  \tableofcontents, \thechapter.. etc using Hanja. Other options are
  'hardbold', 'pshan' and 'nojosa'. 'hardbold' lets use bold fonts
  made by mf, and 'pshan' enable to use ps fonts instead of mf fonts. 
  If you have memory problem in running TeX, you can try to use option
  'nojosa', to disable the automatic decision of josa.
  Option handling in \LaTeXe compatibility mode is done by making a
  file hltx209.cfg and system-wide configuration of default fonts is
  done by making a file hfont.cfg. Detailed information can be
  retrieved from '\HLaTeX Guide'. These files goes to
  texmf/tex/latex/local.

  If you intend to process hangul characters without the
  hangul formating stuffs, use \usepackage{hfont} instead of
  \usepackage{hangul}.

  The resulting dvi file can be printed or previewed.
  If you encounter some problems in printing Hangul dvi file, try to send
  print jobs with less pages (e.g. 5 pages).
    dvips -Ppslocal -S5 <document>.dvi
  The above command tells, that dvips converts <document>.dvi to a
  postscript file, where each section in the postscript file consists of
  maximum 5 pages, and send this postscript file to the printer named
  pslocal.

  A more detailed description how to use \HLaTeX is in the file
  hlguide.tex.

Problem:
--------
If you encounter some problems or if you have some suggestions, please contact

        koaunghi.un@student.uni-tuebingen.de

*** End ***
