summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/cjk-ko/README
blob: 69e4eeca7d5facc4e345d9c6724479458ccb83a9 (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
164
165

=======================================
CJK-ko package version 1.0 (2013/02/27)
=======================================

This package supports typesetting modern Korean documents
with the help of LaTeX2e CJK package written by Werner Lemberg. 

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/


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

See each file for more details.


Features
========

* only modern Korean script is supported  

* only UTF-8 input encoding is supported

* no need to declare \begin{CJK} ... \end{CJK} environment

* linebreak may occur at more places than CJK package
	- between CJK character and Latin alphabet/opening
	- betwern Latin alphabet/numbers/closing and CJK character

* allow scaling and/or lowering CJK characters

* automatic Josa selection


Loading of the package
======================

	\usepackage[cjk]{kotex} 


package options
---------------

cjk		
	Required option to load CJK-ko.
	If not given, kotexutf package may be loaded.

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

hanja		
	[hangul] + hanja (Chinese characters) captions

nojosa		
	Disable automatic Josa selection

usedotemph
	Enable \dotemph command.
	CJKfntef.sty and CJKulem.sty are loaded as well

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


User commands
=============

\CJKscale
	- scale CJK character font size
	- 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 CJK characters 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 or kr>.


---END of README---