1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686
|
This is the file INSTALL of the CJK macro package ver. 4.8.5 (16-Oct-2021).
Installation Guide
==================
It is probably a good idea to get a packaged version of CJK---be warned that
installing CJK is *not* trivial.
The easiest solution is to use the TeX Live CD which is distributed among
members of TeX user groups worldwide. It comes with a ready-to-run CJK setup
together with basic CJK fonts (in outline format if freely available) for
almost all encodings. To get a recent snapshot, try the SVN archive. See
http://www.tug.org/texlive/svn/
for more details.
. Using web sites like http://rpmseek.com you can find and download CJK
packages for most GNU/Linux distributions like SuSE or Debian.
. For FreeBSD try this:
http://www.freebsd.org/ports/chinese.html
. MikTeX also provides packages for CJK.
Here a check list for the impatient (experienced) user which tries to show
whether you've done all steps to install the CJK package and fonts. It is
assumed that you want to install both ttf2pk and hbf2gf.
Detailed explanations can be found below.
--- begin checklist ---------------------------------------------------------
. Have you installed a LaTeX 2e version newer or equal to 2001/06/01? The
version of LaTeX is given in each log file produced by LaTeX. For using
CJKutf8.sty you even need version 2003/12/01.
. Have you removed an older version of CJK? If not, do it now but don't
forget to save your FD and other files which you have changed! Don't
forget also to remove the ttf2pk and hbf2gf binaries.
. Can the texinput tree of the CJK package be found by your TeX
implementation? Have you activated subdirectory searching?
. Have you downloaded the needed font packages (either ps, hbf or ttf)? See
also contrib/wadalab/DNP.txt for the Japanese Wadalab fonts. Have you
moved the TFM files into your TFM-tree (or updated TFMINPUTS accordingly)?
Ditto for VF files if needed.
. Have you installed ttf2pk and ttf2tfm from the FreeType 1 package (only
needed for TrueType fonts)? Note that FreeType 2 won't work.
. Have you run ttf2tfm to create the proper TFM files from your TrueType
fonts? This won't be done automatically via mktextfm or MakeTeXTFM!
. Have you updated the ttfonts.map file for ttf2pk? Have you updated the
various hbf2gf config files? Have you copied them to the right places?
Don't forget to install ttf2pk's SFD and other data files which define the
various CJK subfonts and encodings.
. Have you modified and installed the script files for automatic font
generation (not necessary for teTeX 1.0 or newer)?
. If you want Thai support, have you followed the instructions given in
thaifont.txt?
web2c/teTeX users:
. Do you have a C compiler and a make program available for compilation? GNU
gcc and GNU make are recommended.
. Have you updated special.map?
. Have you used the options --with-kpathsea-include=... and
--with-kpathsea-lib=... while calling the configure script of hbf2gf
(or ttf2pk)? Otherwise no file searching library is used which yields
surprising results... Note: Don't use `/usr/include/kpathsea', for
example, but `/usr/include' as an argument to --with-kpathsea-include.
. To check whether kpathsea correctly finds HBF files and configuration
files for hbf2gf, say:
kpsewhich -progname=hbf2gf -format='misc fonts' <your_font>.hbf
kpsewhich -progname=hbf2gf -format='other text files' <your_file>.cfg
The same for TrueType fonts and the ttf2pk config file:
kpsewhich -progname=ttf2pk <your_font>.ttf
kpsewhich -progname=ttf2pk -format='other text files' ttfonts.map
[Recent kpathsea versions (like 3.5.5) which come with the new teTeX or
TeXLive distributions have a new variable `TEXFONTMAPS' for map files;
you should use this test
kpsewhich -progname=ttf2pk -format=map ttfonts.map
instead of the last one.]
. Have you compiled the various *conv utility programs (like bg5conv)? Have
you installed them together with the caller scripts (like bg5latex) in
your path? FOR BIG 5 ENCODING YOU SHOULD ALWAYS USE bg5latex or
bg5pdflatex (except if you use cjk-enc.el). FOR SJIS ENCODING YOU SHOULD
ALWAYS USE sjislatex or sjispdflatex.
. Have you updated and controlled the texmf.cnf configuration file or set
the various environment variables? (TEXINPUTS, TFMFONTS, PKFONTS,
MISCFONTS, TTFONTS, probably TTF2PKINPUTS, TTF2TFMINPUTS, HBF2GFINPUTS)
. ttf2pk and hbf2gf should be in the same directory where your TeX binaries
like `texconfig' or `gftopk' are (or you must set TEXMFCNF and probably
TEXMF in the environment). Soft links won't work!
. Finally, have you run texhash (or mktexlsr) after finishing all other
things?
emTeX users:
. Have you created a LaTeX format file which allows plain 8bit input and
output without using any TeX Code Page (tcp)?
. Have you installed 4DOS (4OS2 or Take Command) for running the file
dvidrv.btm?
. Have you configured dvidrv.btm?
. Have you installed the various *conv utility programs (like bg5conv)?
together with the caller scripts (like bg5latex.bat)? FOR BIG 5 ENCODING
YOU SHOULD ALWAYS USE bg5latex.bat . FOR SJIS ENCODING YOU SHOULD ALWAYS
USE sjisltx.bat .
. Have you created and installed TFM files for fonts not in a CJK font
package?
. Check whether you have updated all needed environment variables (TEXINPUT,
TEXTFM, TTFONTS, TTFCFG, HBFONTS, HBFCFG) and your dvidrv configuration
file or files (+font-files, +virtual-fonts).
In case of errors, verify the list step by step. Detailed information for
each step can be found in the documentation files of CJK. Under web2c or
teTeX, you can set the KPATHSEA_DEBUG environment variable to -1, then all
debugging info is shown and sent to stderr; it is *highly* recommended that
you read the kpathsea.info files. Under emTeX, read the various
documentation files, especially dvidrv.doc and tex.doc, and check the log
file of your dvi driver.
For hbf2gf, read hbf2gf.txt and its manual page (hbf2gf.1 or a formatted
version of it). Similarly, more info on ttf2tfm and ttf2pk can be found in
ttf2pk.doc and the manual pages ttf2pk.1 and ttf2tfm.1 (or a formatted
version).
--- end checklist -----------------------------------------------------------
Unix (web2c and teTeX)
----------------------
. If you can become root, rename the `texinput' directory tree of CJK into
`CJK' or something else and add it to your (local) web2c texinput tree
(for example, /usr/local/share/texmf.local/tex/latex/CJK).
. If you can't become root, modify the TEXINPUTS environment variable
instead so that it includes the CJK directory; use a command similar to
setenv TEXINPUTS :<your CJK directory>//
to let TeX search the standard directories and your CJK tree, e.g.,
setenv TEXINPUTS :/home/joe_user/CJK/4_3.0/texinput//
(Note the leading double colon to append a path, and the double slash to
activate subdirectory searching---for details see the kpathsea info
files.)
[Recent teTeX and TeXLive versions automatically search a TEXMF tree in
your home directory called `texmf'.]
See contrib/wadalab/DNP.txt for the Japanese Wadalab fonts.
. Edit the FD files of the encodings you want to use to specify the fonts
you have. An explanation of the additional size commands CJK provides can
be found in fonts.txt .
Note: Most FD example files from the CJK package are set up for PS fonts
from the TeXLive distribution.
If you use the CJK font packages (see below) no changes are needed.
. [In case you plan to use only outline fonts (PFB, TTF) you can omit the
installation of hbf2gf and HBF fonts.]
If necessary, create TFM (and PK) files from CJK bitmaps with hbf2gf
(found in utils/hbf2gf). This program comes with a configure script; say
`./configure --help' in the utils/hbf2gf directory for configuration
options. You need a compiled kpathsea library and its header files; in
most cases you say
./configure --prefix=/usr/local/TeX \
--with-kpathsea-include=<INCLUDEDIR> \
--with-kpathsea-lib=<LIBDIR>
make
make install
for a normal compilation and installation. Replace `/usr/local/TeX' with a
path to your TeX distribution, and <DIR> with the directory one level
higher than the library and the include files themselves. Example:
libkpathsea.a is in /usr/local/TeX/lib/i686-linux, kpathsea.h is in
/usr/local/TeX/include/kpathsea; then <LIBDIR> should be
`/usr/local/TeX/TeX/lib/i686-linux', and <INCLUDEDIR> should be
`/usr/local/TeX/include' (and not `/usr/local/TeX/include/kpathsea).
See hbf2gf.txt, the man page (hbf2gf.1), and the documentation of the
source file (hbf2gf.dvi) for further details. Usually it is sufficient to
let hbf2gf create a complete set of TFM files; PK fonts are then created
on demand.
Older kpathsea versions need a patched MakeTeXPK or mktexpk script; you
should apply the proper patch(es) from utils/hbf2gf/scripts. No changes to
the script files are necessary for teTeX 1.0 and newer.
The CJK font packages already contain TFM (and VF) files arranged for the
(new) TDS directory structure; add it directly to your TEXMF tree.
. Free Chinese TrueType fonts (for both simplified and traditional Chinese)
with a license similar to the GPL can be found on
ftp://ftp.gnu.org/gnu/nongnu
and its mirrors worldwide. You might also search websites of companies
offering WWW browser; they often come with CJK language packs which
contain CJK TrueType fonts.
Please note that many CJK TrueType fonts only have a Unicode mapping
table. You should use the SFD files from the ttf2pk package starting with
the letter `U' (e.g., UKS.sfd) which maps Unicode fonts to language
specific encoded subfonts as needed by the CJK package.
The ttf2pk package found in the contrib/ttf2pk directory of
ftp://ftp.freetype.org/pub/
freetype/unstable/freetype1-contrib-current.tar.gz
contains the two programs ttf2tfm and ttf2pk for converting TrueType fonts
into TFM and PK fonts, respectively. By the way, this package is not
restricted to CJK TrueType fonts; it works with other TrueType fonts too.
Read the manual pages and the documentation for further information. For
compilation you also need the FreeType 1 package:
ftp://ftp.freetype.org/pub/freetype/unstable/freetype-current.tar.gz
. The font editor `fontforge' (available from http://fontforge.sf.net) is
capable of generating Type 1 subfonts as needed by CJK from other formats
like TTF, OTF or CID (using the subfont definition files from ttf2pk).
Such subfonts should be usable by virtually all platforms.
(Funnnily, fontforge uses the `.sfd' extension also for saving font files
it creates.)
Although fontforge needs the X Window System, it can be compiled without a
graphical interface, using a scripting language to control font
conversion. The directory `utils/subfonts' of the CJK package contains
useful scripts for manipulating subfonts.
. It is recommended to add all CJK fonts which are converted to the PK font
format (either with hbf2gf or ttf2pk) to the file special.map: Assuming
that your PK fonts should be generated in
$TEXMF/fonts/pk/modeless/gb2312/gsfs14/
the proper entries would be
gsfs1401 gb2312 gsfs14
gsfs1402 gs2312 gsfs14
...
. Compile the small preprocessors in the utils subdirectories with
cc -O -s -o bg5conv bg5conv.c
cc -O -s -o sjisconv sjisconv.c
cc -O -s -o cefconv cefconv.c
cc -O -s -o cef5conv cef5conv.c
cc -O -s -o cefsconv cefsconv.c
cc -O -s -o extconv extconv.c
and move them into TeX's bin directory (together with the shell scripts)
or modify the PATH environment variable appropriately. (`cc' can be any C
compiler.)
The script files `...latex' make the use of these programs transparent.
. Move the man pages into your man1 directory tree.
. If you want to use Mule, emacs, or XEmacs together with the CJK package,
you should install cjk-enc.el (in utils/lisp). See cjk-enc.txt for
documentation. Choose the correct cjk-enc.el version---note that the Mule
version has limited capabilities compared to the Emacs version.
Move cjk-enc.el to a place which is searched by Mule (e.g.,
/usr/local/lib/mule/site-lisp) and put the following line into your emacs
file:
(load-library "cjk-enc")
The default directory for emacs is /usr/local/share/emacs/site-lisp.
Note that you don't need cjk-enc.el in case you are editing UTF-8 encoded
files only.
. If you mainly write Chinese or Japanese with Emacs or Mule, consider the
use of cjktilde.el (in utils/lisp). This file contains a minor mode which
exchanges the tilde key with the space key. See the documentation of
\CJKtilde in CJK.txt for the reasons to use `~' in most cases instead of
a space character.
To install, move cjktilde.el to a place which is searched by Emacs or Mule
(e.g., /usr/local/share/emacs/site-lisp) and put the following line into
your .emacs file:
(load-library "cjktilde")
To toggle the CJK tilde mode say
M-x cjk-tilde-mode
You can then assign cjk-tilde-mode to a key, e.g., shift-insert.
. If you use AUCTeX you can try cjkspace.el instead of cjktilde.el; it works
in a similar (but not identical) way and is special to LaTeX buffers. Move
the file to the local lisp directory and put the following lines into your
.emacs file:
(autoload 'CJK-insert-space "cjkspace"
"Insert tildes appropriately in CJK document." t)
(defun my-LaTeX-mode-hook ()
"My personal key definitions for LaTeX mode."
(define-key LaTeX-mode-map " " 'CJK-insert-space))
(add-hook 'LaTeX-mode-hook 'my-LaTeX-mode-hook)
Please read the documentation in the file cjkspace.el .
. For Thai support please follow the instructions given in `thaifont.txt'.
DOS and OS/2 (emTeX)
--------------------
web2c has been ported to MS-DOS. If you use this (which I recommend), follow
the instructions above.
. Note that some Unix specific shell scripts and other files have names
longer than 8 characters. You don't need them. Some of the TeX input files
have lower and uppercase characters in its filenames, but none of the
filenames collide under DOS.
. 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. emTeX allows for
recursively scanned search paths, thus retaining the directory tree is
possible.
Example:
CJK files: c:\emtex\texinput\cjk\...
environment: set emtexdir=c:\emtex
set texinput=%emtexdir%\texinput!!
See contrib/wadalab/DNP.txt for the Japanese Wadalab fonts.
. [In case you plan to use only outline fonts (PFB, TTF) you can omit
this step.]
Compile hbf2gf. You need GNU make and either the emx (DOS and OS/2) or
the djgpp (DOS and Windows) compiler.
Say `make -f Makefile.gnu' to see the possible options; more info can be
found in hbf2gf.txt .
. Compile the utility programs.
cc -O -s -o bg5conv bg5conv.c
cc -O -s -o sjisconv sjisconv.c
cc -O -s -o cefconv cefconv.c
cc -O -s -o cef5conv cef5conv.c
cc -O -s -o cefsconv cefsconv.c
cc -O -s -o extconv extconv.c
. Move the various BAT files (for DOS) and/or the CMD REXX scripts (for
OS/2) into a directory in the path (e.g., c:\emtex\bin).
. Edit the FD files of your encoding(s) to specify the fonts you have. An
explanation of the additional size commands CJK provides can be found in
fonts.txt .
Note: Most FD example files from the CJK package are set up for PS fonts
from the TeXLive distribution.
If you use the CJK font packages (see below) no changes are needed.
. [In case you plan to use only outline fonts (PFB, TTF) you can omit this
step.]
If necessary, create TFM (and PK) files from CJK bitmaps with hbf2gf
(found in utils\hbf2gf). See hbf2gf.txt and the documentation of the
source file (hbf2gf.dvi) for explanation. Usually it is sufficient to let
hbf2gf create a complete set of TFM files; PK fonts are then created on
demand (this is done with the dvidrv.btm shell script of the CJK package).
You need 4DOS or 4OS/2 (these are shareware replacements for command.com)
to run dvidrv.btm.
dvidrv.btm should also work with Take Command/16, Take Command/32, or Take
Command for OS/2.
The CJK font packages already contain TFM (and VF) files (arranged for the
(new) TDS directory structure; unpack the font packages in the root
directory with
gzip -d CJK_font_archive.tgz
tar xvf CJK_font_archive.tar
Rearrange the directory structure as suggested below (to make the file
search mechanism of emTeX faster) and modify the appropriate environment
variables to include the additional directories. The same holds for the
CJK bitmap fonts, its HBF header files and the hbf2gf configuration files.
[Note: Binaries for the gzip and tar archive programs can be found on CTAN
in the `utils' subdirectory.]
Example:
jfs56.tar.gz (should be ftp'ed as jfs56.tgz if you work under DOS
since two dots are not allowed)
suggested final directory structure (after unpacking and rearranging):
c:\texmf\fonts\tfm\gsfs1401.tfm ...
c:\texmf\hbf2gf\gsfs14.cfg
c:\texmf\fonts\hbf\gb2312\jfs56\jfs56.a ...
[ c:\texmf\fonts\pk\modeless\XXXdpi\gsfs1401.pk ... ]
Add these lines to the end of autoexec.bat:
set texmfdir=c:\texmf
set cjkpk=%texmfdir%\fonts\pk
set textfm=%textfm%;%texmfdir%\fonts\tfm
Under OS/2, add similar lines (but with expanded pathnames) to the end
of config.sys:
set texmfdir=c:\texmf
set cjkpk=c:\texmf\fonts\pk
set textfm=<your old textfm path>;c:\texmf\fonts\tfm
Changes in gsfs14.cfg:
pk_directory $texmfdir\fonts\pk\modeless\432dpi\
tfm_directory $texmfdir\fonts\tfm\
Changes in dvidrv.btm:
set pkdir=%texmfdir%\fonts\pk
set ttfcfg=%texmfdir%\ttf2pk
set hbfcfg=%texmfdir%\hbf2gf
set pre_dpi=
set post_dpi=dpi
Changes in a dvi driver configuration file (.cnf) for emTeX:
+font-files:{<your old pk path>,$texmfdir:fonts\modeless}\@Rrdpi\@f.pk
. Free Chinese TrueType fonts (for both simplified and traditiional Chinese)
with a license similar to the GPL can be found on
ftp://ftp.gnu.org/gnu/nongnu and its mirrors worldwide. You might also
search websites of companies offering WWW browser; they often come with
CJK language packs which contain CJK TrueType fonts.
Please note that many CJK TrueType fonts only have a Unicode mapping
table. You should use the SFD files from the ttf2pk package starting with
the letter `U' (e.g., UKS.sfd) which maps Unicode fonts to language
specific encoded subfonts as needed by the CJK package.
The ttf2pk package can be found in the contrib/ttf2pk directory of
ftp://ftp.freetype.org/
freetype/unstable/freetype1-contrib-current.tar.gz
contains the two programs ttf2tfm and ttf2pk for converting TrueType fonts
into TFM and PK fonts, respectively. By the way, this package is not
restricted to CJK TrueType fonts; it works with other TrueType fonts too.
Read the manual pages and the documentation for further information. For
compilation you also need the FreeType 1 package:
ftp://ftp.freetype.org/pub/freetype/unstable/freetype-current.tar.gz
. The font editor `fontforge' (available from http://fontforge.sf.net) is
capable to generate Type 1 subfonts as needed by CJK from other formats
like TTF, OTF or CID (using the subfont definition files from ttf2pk).
Such subfonts should be usable by virtually all platforms.
(Funnnily, fontforge uses the `.sfd' extension also for saving font files
it creates.)
Although fontforge needs the X Window System, it can be compiled without a
graphical interface, using a scripting language to control font
conversion. The directory `utils/subfonts' of the CJK package contains
useful scripts for manipulating subfonts.
. You find the some standard Hangul PK fonts for 300dpi (cx) and 600dpi
(ljfour) resolution in the following archives:
han.300.tar.gz
han1.300.tar.gz
han.600.tar.gz
han1.600.tar.gz
han.tfmvf.tar.gz
han1.tfmvf.tar.gz
It is necessary to rearrange not only the directory structure but the
names of the dpi directories too: The TeX directory standards specifies
`dpiXXX', but emTeX provides by default `XXXdpi'.
The final locations of the packages' files should be
c:\texmf\fonts\tfm\
c:\texmf\fonts\vf\
c:\texmf\fonts\pk\{cx,ljfour}\XXXdpi\
Additionally to the above example you should add this to the end of
autoexec.bat:
set cjkvf=%texmfdir%\fonts\vf
or config.sys for OS/2:
set cjkvf=c:\texmf\fonts\vf
Assuming that you use the 300dpi Hangul PK fonts (for a cx printer) you
should do the following changes in your dvi driver configuration file
(suffix `.cnf') for emTeX (still continuing the above example):
+font-files:{<your old pk path>,$texmfdir:fonts\{modeless,cx}}\@Rrdpi\@f.pk
+virtual-fonts:{<your old vf path>,$texmfdir:fonts}\@f.vf
. For Thai support please follow the instructions given in `thaifont.txt'.
Other systems
-------------
Recent versions of CJK have only been tested with web2c; nevertheless, it
should run on other systems too:
The font editor `fontforge' (available from http://fontforge.sf.net) is
capable to generate Type 1 subfonts as needed by CJK from other formats
like TTF, OTF or CID (using the subfont definition files from ttf2pk).
Such subfonts should be usable by virtually all platforms.
(Funnnily, fontforge uses the `.sfd' extension also for saving font files
it creates.)
Although fontforge needs the X Window System, it can be compiled without a
graphical interface, using a scripting language to control font
conversion. The directory `utils/subfonts' of the CJK package contains
useful scripts for manipulating subfonts.
If no outline fonts are available and you have to use HBF fonts, try to
compile hbf2gf. Since it is written in ANSI C it should be fairly portable
(if patches are needed please send them to the author; most likely you
have to modify the file operating routines). If this fails it is necessary
to build the various PK fonts on a different machine. It has been reported
that older GNU compilers on the NeXT have difficulties with `%i'
formatting parameters in the HBF API (hbf.c): replace all occurrences of
`%i' with `%d'.
If there exists an equivalent to mktexpk (or dvidrv.btm), try to modify it
similar to CJK's changes so that CJK fonts can be created on the fly. If
this fails you can only use precompiled sets of CJK fonts (this is, using
PK fonts generated on another platform).
The rest should be rather trivial for the experienced user; again, please
write the author if you have successfully installed the package and send a
report how to install.
How to get CJK and related software
-----------------------------------
. You 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.dante.de DANTE (Deutsche Anwendervereinigung fuer TeX)
Hamburg (Germany)
ftp.tex.ac.uk Cambridge University
Cambridge (England)
ctan.tug.org TUG (TeX Users Group)
Massachusetts (USA)
You should use the nearest one, or even better, a local mirror of a CTAN
host: The file `CTAN.sites' on CTAN contains a list.
On CTAN, the CJK package itself is unpacked. To receive the complete
package, go to the parent directory of CJK and say
get CJK.zip
or
get CJK.tar.gz
whatever is appropriate for your system.
The CJK directory and all its subdirectories are sent to you in compressed
form. Be aware that not all mirrors of CTAN sites support compression of
directories.
. The documentation bundle of the CJK package is not unpackaged; download it
as
get cjk-4.8.5-doc.tar.gz
or
get cjk-4.8.5-doc.tar.gz cjkdoc.tgz
whatever is appropriate for your system. It contains precompiled versions
(in DVI, PDF, text format) of all documentation and example files.
. PostScript font packages with subfonts which can be directly used by the
CJK package are already available on CTAN:
traditional Chinese:
fonts/arphic/bkai00mp-<version>.tar.gz
fonts/arphic/bsmi00lp-<version>.tar.gz
simplified Chinese:
fonts/arphic/gbsn00lp-<version>.tar.gz
fonts/arphic/gkai00mp-<version>.tar.gz
Japanese:
fonts/wadalab/gothic-0-13-<version>.tar.gz
fonts/wadalab/maru-0-8-<version>.tar.gz
fonts/wadalab/maru-1-8-<version>.tar.gz
fonts/wadalab/mincho-0-12-<version>.tar.gz
fonts/wadalab/mincho-0-8-<version>.tar.gz
fonts/wadalab/mincho-1-8-<version>.tar.gz
Korean:
fonts/korean/HLaTeX/uhc-bom.tar.gz
fonts/korean/HLaTeX/uhc-dinaru.tar.gz
fonts/korean/HLaTeX/uhc-fonts.tar.gz
fonts/korean/HLaTeX/uhc-gothic.tar.gz
fonts/korean/HLaTeX/uhc-graphic.tar.gz
fonts/korean/HLaTeX/uhc-gungseo.tar.gz
fonts/korean/HLaTeX/uhc-jamo.tar.gz
fonts/korean/HLaTeX/uhc-myoungjo.tar.gz
fonts/korean/HLaTeX/uhc-pen.tar.gz
fonts/korean/HLaTeX/uhc-pilgi.tar.gz
fonts/korean/HLaTeX/uhc-pilgia.tar.gz
fonts/korean/HLaTeX/uhc-shinmun.tar.gz
fonts/korean/HLaTeX/uhc-taza.tar.gz
fonts/korean/HLaTeX/uhc-vada.tar.gz
fonts/korean/HLaTeX/uhc-yetgul.tar.gz
You should consult the documentation and the font samplers of those
packages (if available) for more informations.
. Mule 2.3 can be downloaded from this Japanese host:
ftp://ftp.m17n.org/pub/mule/mule-2.3.tar.gz
[Note: You need Mule 2.3 only for right-to-left scripts like Arabic or
Hebrew which aren't yet supported in emacs. Otherwise, I strongly
recommend to get FSF emacs 22 or newer, or XEmacs 21.1 or newer which is
available from ftp.gnu.org (USA) and ftp.xemacs.org, respectively, and
its many mirrors.]
---End of INSTALL---
|