
Installation Guide
==================

o   Move the `texinput' directory tree to a place where TeX scans for input
    files (and rename it to `CJK' or something else). Note that its
    subdirectories are specific to encoding schemes. Most modern TeX
    implementations (like emTeX or web2c) allow for recursively scanned
    search paths, thus retaining the directory tree is possible. If your
    system does not support recursive search paths, move the files in the
    `texinput' directory together with the files of the specific encoding
    subdirectory you want to use to a place where TeX can find them.

    For additional actions needed for Korean see below.

o   Edit the .fd-files of your encoding to specify the fonts you have. An
    explanation of the additional size commands CJK provides will be found
    in CJK.doc .

o   If necessary, create .tfm- (and .pk-files) from CJK bitmaps with hbf2gf
    (found in utils/hbf2gf). See hbf2gf.doc and the documentation of the
    source file (hbf2gf.dvi) for explanation. Precompiled fonts are also
    available (see below). Usually it is sufficient to let hbf2gf create .pk
    fonts only on demand (this will be done with a modified MakeTeXPK shell
    script).

o   For Big 5 encoding, chinese TTF fonts are available at ftp.ifcss.org
    (and its mirrors) in /pub/software/fonts/big5/ms-win.

    The ntu2cjk package (found in contrib/ntu2cjk) will convert them into
    PostScript fonts which can be used with GhostScript. See
    contrib/ntu2cjk/README for further information.

    The ttf2pk package (found in contrib/ttf2pk) will convert them into .pk
    fonts on demand using an extension of MakeTeXPK. See
    contrib/ttf2pk/README for further information.

    Choose the method you prefer.
 
o   You will find the standard hangul fonts in the lj_han and lj_han1
    packages (available at the CTAN host, see below). These are emTeX
    libraries for 300 dpi resolution which can be easily converted back to
    .pk fonts using the fontlib package of emTeX if your TeX implementation
    cannot use emTeX's font libraries (dvips can). If you need different
    resolutions, you must obtain the original metafont sources of the
    hlatex_mf.tar.gz and the jhtex packages. Note that the shapes of Hangul
    elements are not satisfactory.

    You find the needed hangul virtual fonts and virtual metric files in the
    vf and tfm directories of the KS encoding subdirectory. Move the .tfm
    files into a directory TeX will scan. You need a dvi driver which
    understands virtual fonts -- move the .vf files into a directory your
    dvi driver will scan. Again it is advisable to create new subdirectories
    for these files. Don't forget to update the virtual font and tfm paths
    of your dvi driver(s).

o   [UNIX web2c only]
    You can't use Bg5conv.tex and CEF(5)conv.tex with the web2c
    implementation of TeX. Small C programs which are equivalent to these
    converters are in utils/Bg5conv and utils/CEFconv respectively. Compile
    them with

        gcc -O -s -o bg5conv bg5conv.c
        gcc -O -s -o sjisconv sjisconv.c
        gcc -O -s -o cefconv cefconv.c
        gcc -O -s -o cef5conv cef5conv.c

    and move them into TeX's bin directory (together with the shell
    scripts).

    The script files bg5latex, cnslatex and cns5latex make the use of these
    programs transparent.

o   [UNIX only] 
    If you want to use MULE together with the CJK package, you should
    install mule2cjk (in utils/mule2cjk). See mule2cjk.doc for
    documentation.

    Compile mule2cjk with

        gcc -O -s -o mule2cjk mule2cjk.c

    and move it into TeX's bin directory (together with the shell script).

    The script file mulatex makes the use of this program transparent.


How to get CJK and related software
-----------------------------------

    o   You will find CJK and software related to TeX at the CTAN hosts
        (Comprehensive TeX Archive Network). These completely identical ftp
        servers (concerning TeX software) are

            ftp.shsu.edu    Sam Houston University
                            Texas (USA)
            ftp.dante.de    DANTE (Deutsche Anwendervereinigung fuer TeX)
                            Heidelberg (Germany)
            ftp.tex.ac.uk   Cambridge University
                            Cambridge (England)

        You should use the nearest one, or even better, a local mirror of a
        CTAN host.

        CJK will be found unpacked. To receive the complete package, go to
        the parent directory of CJK and say

            get CJK.zip
          or                (whichever is appropriate for your system)
            get CJK.tar.gz 

        The CJK directory and all its subdirectories will be sent to you in
        compressed form. Be aware that not all mirrors of CTAN sites support
        compression of directories.

    o   The main site for Chinese related software is ftp.ifcss.org (USA).
        Mirrors are ftp.edu.tw (Taiwan), cnd.org (USA) and kth.se (Sweden).
        There you find free Chinese fonts, Text editors etc.

    o   The main site for Korean related software is
        cair-archive.kaist.ac.kr (Korea). I don't know any mirror sites of
        this host. At the CTAN servers you will find a 65x65 hanja font
        (without HBF header) in
        /tex-archive/fonts/korean/HLaTeX/src/hanja65.gz .

    o   Unicode fonts and utilities can also be found at ftp.ifcss.org;
        mapping tables are available at unicode.org .

    o   Sam Chiu <ccc11@cus.cam.ac.uk> compiled the fonts jfs56 (GB encoded)
        and ntu_kai48 (Big 5 encoded) for various sizes with 600dpi
        resolution. You will find them (about 22 MByte uncompressed!) at the
        CTAN hosts in /tex-archive/fonts/chinese.



---End of INSTALL---
