
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 .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).

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/ntu2cjk.doc for further information.

    The ttf2pkl package (found in contrib/ttf2pkl) will convert them into
    .pk fonts on demand using an extension of MakeTeXPK. See
    contrib/ttf2pkl/ttf2pkl.doc 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   You can't use Bg5conv.tex and CEF(5)conv.tex with the web2c inplementation
    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 cefconv cefconv.c
        gcc -O -s -o cef5conv cef5conv.c    .

    The script files bg5latex, cnslatex and cns5latex make the use of these
    programs 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 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 ftp.ifcss.org
        you will find a 24x24 hanja font with HBF header in
        /pub/software/fonts/misc/hbf.

    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.
