summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/cjk-ko/README
blob: 4dbd10f2f2df46caba9b2ec2a50818ff642a41a3 (plain)
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
=======================================
CJK-ko package version 1.1 (2013/03/23)
=======================================

This package supports typesetting modern Korean documents with the help
of LaTeX2e CJK package written by Werner Lemberg.  Unlike CJK package,
however, this package supports UTF-8 input encoding only.  Despite the
restriction, this package 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.


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/


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.


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:
	\은 \는 \이 \가 \을 \를 \와 \과 \로 \으로 \라 \이라

eg:	\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


Author
======
Please report any errors or suggestions to Dohyun Kim <nomos at ktug org>


---END of README---