CJK-ko package version 1.2 (2013/07/03)
=======================================

This package supports typesetting modern Korean documents with the help
of LaTeX2e CJK package written by Werner Lemberg. Though this package
supports, unlike CJK package, only UTF-8 input encoding, it provides
some enhanced features focused on Korean typesetting culture, for
instance: linebreak is allowed between Latin and CJK characters; users
can scale and/or lower CJK characters for their need; and automatic Josa
selection is implemented.

Currently this package requires nanumtype1 package as well.


Author
------

Please report any errors or suggestions to
	Dohyun Kim <nomos at ktug org>
or leave messages in the issue tracker at:
	<http://github.com/dohyunkim/cjk-ko>.


License
-------

### GPL (Gnu General Public License):

	cjkutf8-ko.sty
	cjkutf8-josa.sty
	cjkutf8-nanummjhanja.sty
These files are derivatives of CJK package or written by the author.

### LPPL (LaTeX Project Public License):

	kotex.sty
	konames-utf.sty
	kolabels-utf.sty
These files are copied or modified from ko.TeX package.

### Public domain:

	cjk-ko-doc.tex
	README
	ChangeLog

See each file for more details.


Files
-----

### TeXinputs

	cjkutf8-ko.sty			-> tex/latex/cjk-ko/
	cjkutf8-josa.sty		-> tex/latex/cjk-ko/
	cjkutf8-nanummjhanja.sty	-> tex/latex/cjk-ko/
	kotex.sty			-> tex/latex/cjk-ko/
	kolabels-utf.sty		-> tex/latex/cjk-ko/
	konames-utf.sty			-> tex/latex/cjk-ko/

### Documents

	cjk-ko-doc.tex			-> doc/latex/cjk-ko/
	cjk-ko-doc.pdf			-> doc/latex/cjk-ko/
	README				-> doc/latex/cjk-ko/
	ChangeLog			-> doc/latex/cjk-ko/


Loading of the package
----------------------

	\usepackage{cjkutf8-ko}
or

	\usepackage[cjk]{kotex}


### package options

	[cjk]
Option for kotex.sty.  If this option is not given and if kotexutf.sty
does exist, kotexutf package will be loaded instead.

	[hangul]
Load Hangul captions. line/word spacing is adjusted as well.

	[hanja]
Load Hanja captions. same as [hangul] option for line/word spacing.

	[nojosa]
Disable automatic Josa selection

	[usedotemph]
Enable \dotemph command. CJKfntef.sty and CJKulem.sty will be loaded
as well.

	[usecjkt1font]
Latin characters are typeset by CJK font. Only Nanum T1 font is
currently available.


User commands
-------------

	\CJKscale
- scale font size of CJK character
- eg: \CJKscale{0.95}
- cannot be used with [usecjkt1font] option
- allowed only in the preamble
- under [hangul] option, line/word spacing and indent size are
  adjusted automatically

	\lowerCJKchar
- lower CJK characters
- eg: \lowerCJKchar{0.1em}
- cannot be used with [usecjkt1font] option
- allowed only in the preamble

	\dotemph
- emphasize Hangul or Hanja by putting dot above
- eg: \dotemph{드러냄표}
- available only when [usedotemph] option is given
- users can redefine these commands:

	\def\dotemphchar{\Unicode{"02}{"D9}}
	\def\dotemphraise{0.2em}

For other commands see CJK package documents.


Automatic Josa selection
------------------------

Josa commands:

	\은 \는 \이 \가 \을 \를 \와 \과 \로 \으로 \라 \이라

example:

	\label{fig:aaa} ... \ref{fig:aaa}\을
	\label{fig:aaa} ... \pageref{fig:aaa}\을
	\cite{hong}\을 ... \bibitem[홍길동\jong]{hong}

Automatic Josa selection works correctly only after
\ref \pageref \cite commands and after ascii characters.
For other cases these commands are available:

	\jung:  keyword is terminated by Jungseong
	\jong:  keyword is terminated by Jongseong
	\rieul: keyword is terminated by Jongseong Rieul


Korean counters
---------------

Same as ko.TeX package:

	\jaso \gana \ojaso \ogana \pjaso \pgana \onum \pnum \oeng \peng
	\hnum \Hnum \hroman \hRoman \hNum \hanjanum


*END of README*
