CTAN Comprehensive TeX Archive Network

Directory language/chinese/zhmcjk

README
                          ==================
                            zhmCJK Package
                          ==================

Introduction
------------

zhmCJK is a package written to ease the complex CJK fonts setup.  All CJK
fonts may share the same .tfm metrics.  The package sets the NFSS font
definition and actual font maappings using TeX macros dynamically.  As a
result, zhmCJK provides similar faculties and interface of xeCJK, TrueType CJK
fonts are used to generate PDF output with pdfTeX or DVIPDFMx driver.

This package is licensed under LPPL.

Installation
------------

This package consists of the files zhmCJK.dtx,
                                zhmCJK.ins,
                                zhmCJK.lua,
                                zhmCJK-addmap.pl,
          and the derived files zhmCJK.sty,
                                zhmCJK.pdf,
                                zhmCJK-test.tex,
                                README,                     (from zhmCJK.dtx)
                                zhmCJK.map,
                                texfonts.map.template,
                                zhmCJK.tfm,
                                miktex-tfm/zhm*/zhm**.tfm.  (from zhmCJK.lua)

* Compile zhmCJK.lua with command

      texlua zhmCJK.lua map

  to generate zhmCJK.map, texfonts.map.template, zhmCJK.tfm.

  Or, for MiKTeX only, use

      texlua zhmCJK.lua nomap

  to generate miktex-tfm/zhm*/zhm**.tfm. (32 subdirectories, 8192 TFM files)

* Compile zhmCJK.ins using an 8-bit TeX engine to obtain zhmCJK.sty,
  zhmCJK-test.tex and this README file.

* Compile zhmCJK.dtx using pdflatex or latex+dvipdfmx to obtain the
  documentation zhmCJK.pdf.

* Copy the files into proper directories searched by TeX.
  TDS tree:

    TEXMF/doc/latex/zhmCJK/zhmCJK-test.tex
    TEXMF/doc/latex/zhmCJK/zhmCJK.pdf
    TEXMF/doc/latex/zhmCJK/README
    TEXMF/fonts/map/fontname/zhmCJK.map
    TEXMF/fonts/tfm/zhmCJK/zhmCJK.tfm
    TEXMF/source/latex/zhmCJK/zhmCJK.dtx
    TEXMF/source/latex/zhmCJK/zhmCJK.ins
    TEXMF/source/latex/zhmCJK/zhmCJK.lua
    TEXMF/tex/latex/zhmCJK/zhmCJK.sty

  And merge the file texfonts.map.template into

    TEXMF/fonts/map/fontname/texfonts.map

  Or simply run script zhmCJK-addmap.pl to append this line to the old
  texfonts.map:

    include zhmCJK.map

  Or, for MiKTeX only, instead of copying texfonts.map, zhmCJK.map and
  zhmCJK.tfm, copy all miktex-tfm/zhm*/zhm**.tfm into:

    TEXMF/fonts/tfm/zhmCJK/miktex-tfm/zhm*/zhm**.tfm

* Run texhash to refresh file name data base.

Basic Usage
-----------

zhmCJK provides similar syntax to xeCJK, while the underlying package is CJK
under pdfTeX or DVIPDFMx engine.  A TeX source file is encoded in UTF-8 by
default.

The package provides the following commands to define a CJK font family:

    \setCJKmainfont{ttf-file-name}[options]
    \setCJKsansfont{ttf-file-name}[options]
    \setCJKmonofont{ttf-file-name}[options]
    \setCJKfamilyfont{family}{ttf-file-name}[options]

For example, this setup some Chinese fonts on MS Windows:

    \usepackage{zhmCJK}
    \setCJKmainfont{simsun.ttc}[BoldFont=simhei.ttf, ItalicFont=simkai.ttf]

You can read the PDF document (in Chinese) for more detailed explanations.

Author
------

Leo Liu <leoliu.pku@gmail.com>

If you are interested in the process of development you may observe

    https://github.com/leo-liu/tex-pkg

--- end of README ---

Download the contents of this package in one zip archive (447.8k).

zhmCJK – Simplify configuration of CJK installations for Chinese

The package is designed to ease the complex business of setting up CJK fonts. The package relies on the fact at all CJK fonts share the same metrics; it provides macros that create the NFSS font definition and actual font mappings dynamically.

As a result, zmhCJK provides similar facilities and interfaces to those of xeCJK; TrueType CJK fonts may be used to generate PDF output with pdf or with the DVIPDFMx driver.

PackagezhmCJK
Version0.9c 2016-11-23
LicensesThe Project Public License
Copyright2012 Leo Liu
MaintainerLeo Liu
TDS archivezhmcjk.tds.zip
Contained inMiKTeX as zhmcjk
TopicsCJK Font
Chinese
Font use
...
Guest Book Sitemap Contact Contact Author