summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/cjk-ko/README
blob: 0d36349acc638e9d62feddcf4ecaaba33e85aaa0 (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
155
156
157
158
159
160
161
162
163
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*