/usr/local/doc/tex-inputs/latex/CJK/README

This file created 17 Sept 1995 by Stephen G. Simpson
This file last modified 25 Sept 1995 by Stephen G. Simpson


THE CJK PACKAGE

This directory contains some documentation for CJK, an experimental
LaTeX2e package which enables Chinese, Japanese, and Korean in LaTeX
documents.  Currently we are supporting only Chinese.  We will add
Japanese and Korean if there is interest.

To activate the CJK package, say \usepackage{CJK}.  This provides two
new environments, CJK and CJK*.  A typical move is

   \begin{CJK}{Bg5}{}
   ....
   \end{CJK}

where the CJK environment contains a mixture of English and Big5-coded
Chinese.

Note that Bg5 indicates Big5 character coding.  Currently the only CJK
codings available are Big5 (for traditional, Taiwan-style Chinese) and
GB (for simplified, mainland-style Chinese).

The CJK and CJK* environments are very similar to each other.  They
differ in their handling of spaces and newlines.  Some useful hints
about how to control spacing are in CJK.doc.  See especially the
sections entitled "Possible Errors" and "Embedding non-CJK words into
CJK text".

If you experience strange errors when processing a Big5 document, it
may help to use "bg5latex" instead of "latex".


FONT SHAPES

For Big5 coding, the following font shapes are available: song,
fangsong, kai, li, ming, yuan, jixi.  You can say

   \begin{CJK}{Bg5}{<shape>}

to select a shape initially.  If <shape> is not specified, a default
shape will be selected.  The command

   \CJKshape{<shape>}

is used to switch from one shape to another within a CJK or CJK*
environment.  A table showing the various shapes is in bg5shape.dvi.
To view it, do "xdvi bg5shape".

 song       The default shape.  A normal Chinese font.  In the present
            implementation, song is the same as fangsong.
 
 fangsong   Fang Song.  A light, slanted, brushstroke font.  Only
            the more frequently used Chinese characters are available.
 
 kai        Kai Shu.  A medium, slanted, brushstroke font
 
 li         Li Shu or "scribe".  A heavy, upright, brushstroke font.
            Only the more frequently used Chinese characters are available.

 ming       Ming.  A nice, printed Chinese font.
 
 yuan       A "round" or sans serif Chinese font shape.  This shape is
            available in both medium and boldface, controlled by the
            ordinary LaTeX commands \textmd (\mdseries) and
            \textbf (\bfseries).
 
 jixi       A line font.  Extremely fine.

For GB coding, only one font shape is available.  It is similar to the
Big5 song or fangsong shape.


IMPLEMENTATION NOTE

Our Big5 font shapes for CJK have been implemented by means of the NTU
TrueType font set.  PK fonts are generated automatically by means of
the ttf2pk utility.  Our font mapping is as follows:

   song     --> ntu_fs_m
   fangsong --> ntu_fs_m
   kai      --> ntu_kai
   li       --> ntu_li_m
   ming     --> ntu_mm
   yuan     --> ntu_mr, ntu_br
   jixi     --> ntu_tw

To see a sample of these fonts, do "xv ctlg.gif".  See also ctlg.doc
and ctlg.txt.

Our GB font for CJK has been implemented by means of a 56x56 bitmapped
font, jfs56.hbf.  PK fonts are generated automatically by means of the
hbf2pk utility.