Debian Codegraph @

texmf-dist/doc/xetex/xetexko/xetexko-doc.tex

raw
1 %% !tex program = xelatex
2 %%
3 %% xetexko-doc.tex
4 %%
5 %% This file is in the public domain
6
7 \documentclass[a4paper]{article}
8 \usepackage[hmargin={3.4cm,4.2cm}]{geometry}
9 \usepackage[hangul]{xetexko}
10 \setmainhangulfont{Noto Serif CJK KR}[
11 UprightFont=* Light, BoldFont=* Bold,
12 Script=Hangul, Language=Korean, AutoFakeSlant,
13 ]
14 \setsanshangulfont{Noto Sans CJK KR}[
15 UprightFont=* DemiLight,
16 Script=Hangul, Language=Korean
17 ]
18 \setmathhangulfont{Noto Sans CJK KR}[
19 SizeFeatures={
20 {Size=-6, Font=* Medium},
21 {Size=6-9, Font=*},
22 {Size=9-, Font=* DemiLight},
23 },
24 Script=Hangul, Language=Korean
25 ]
26 \usepackage{hologo, xcolor, ulem}
27 \usepackage[bookmarksnumbered,hidelinks]{hyperref}
28
29 \AddToHook{cmd/caption/before}{\linespread{1.3}\sffamily}
30 \AddToHook{env/verbatim/begin}{\linespread{1.1}}
31 \AssignSocketPlug{build/column/outputbox}{floats-space-footnotes}
32
33 \def\logoko{\textsf{k}\kern-.2ex\textit{o}}
34 \def\XeTeX{\hologo{XeTeX}}
35 \def\xetexko{\XeTeX\kern-.1ex -\logoko}
36 \def\kotex{\logoko\kern-.1ex .\kern-.1667em \hologo{TeX}}
37 \pdfstringdefDisableCommands{\def\xetexko{XeTeX-ko}}
38 \renewcommand*\descriptionlabel[1]{\hspace\labelsep\ttfamily\bfseries
39 \color{blue!50!black}#1}
40 \def\grayhrule{{\color{white!80!black}\hrule height2pt}}
41 \def\grayvrule{{\color{white!80!black}\vrule width 2pt}}
42 \newenvironment{plaintex}
43 {\par\medskip
44 \setbox0=\vbox\bgroup\kern5pt\leftskip15pt \small
45 \parindent0pt }
46 {\par \kern5pt\egroup
47 \dimen0=\dimexpr\pagegoal-\pagetotal\relax
48 \ifdim\dimen0<\baselineskip\relax \dimen0\maxdimen \fi
49 \ifdim\ht0<\dimen0
50 \hbox{\grayvrule \box0}%
51 \else
52 \setbox2=\vsplit0 to\dimen0
53 \lineskip0pt
54 \ifvoid2 \else\hbox{\grayvrule \box2}\fi
55 \ifvoid0 \else\hbox{\grayvrule \box0}\fi
56 \fi \par\smallskip
57 }
58 \newenvironment{example}
59 {\hbox\bgroup\grayvrule
60 \vbox\bgroup\hsize\dimexpr\textwidth-4pt\relax
61 \grayhrule\kern5pt\leftskip10pt\rightskip10pt
62 }{\par\kern5pt\grayhrule\egroup\grayvrule\egroup}
63 \newenvironment{oldstuff}
64 {
65 \par\smallskip
66 \narrower\small\parindent0pt
67 }
68 {
69 \par\smallskip
70 }
71 \def\cs#1{\texttt{\textbackslash #1}}
72 \def\hemph#1{\textsf{\bfseries #1}}
73 \def\hparen#1{{\small\hangulparens(#1)}}
74 \let\hparens\hparen
75 \def\keyword#1{\cs{#1}\marginpar{\hfuzz\maxdimen
76 \setbox0\hbox{\footnotesize{\color{blue!50!black}\cs{#1}}}\ht0=0pt\dp0=0pt\box0 }}
77 \def\vernote#1{v#1\marginpar{\hfuzz\maxdimen
78 \setbox0\hbox{\footnotesize{\color{red}☜ v#1}}\ht0=0pt\dp0=0pt\box0 }}
79
80 \xetexkostretchshrink{plus .025em minus .015em}
81
82 \hangingpunctuations
83
84 \footnotesep=10pt
85 \begin{document}
86
87 \latinparens
88
89 \title{\xetexko\ 간단 매뉴얼}
90 \author{\normalsize Dohyun Kim <\texttt{nomosnomos at gmail com}> \and
91 \normalsize <\url{http://github.com/dohyunkim/xetexko}>}
92 \date{Version 4.6\quad 2025/08/24}
93 \maketitle
94
95 \begin{quote}\small
96 For a summary introduction in English,
97 please see \verb+README+ file in this package.
98 \end{quote}
99
100 \hangulparens
101
102 \section{입력 인코딩}
103 입력은 원칙적으로 UTF-8으로 한다.
104 BOM (Byte Order Mark)은 있어도 좋고 없어도 좋다.
105 EUC-KR이나 CP949 입력도 지원하는데, 다음과 같은 선언이 있으면 된다.
106 \begin{verbatim}
107 \XeTeXinputencoding="korean"
108 \XeTeXdefaultencoding="korean"
109 \end{verbatim}
110
111 \section{\XeTeX\ 자체 기능}
112 \XeTeX 은 자체적으로 유니코드를 잘 지원하므로 \xetexko 를 사용하지
113 않더라도 한글을 찍는 데 문제가 없다.
114 \begin{verbatim}
115 \usepackage{fontspec}
116 \setmainfont{UnBatang}
117 \setsansfont{UnDotum}
118 \setmonofont{UnTaza}
119 \XeTeXlinebreaklocale="ko"
120 \XeTeXlinebreakpenalty=50
121 \XeTeXlinebreakskip=0pt plus.1ex minus.05ex
122 \end{verbatim}
123 하지만 이렇게 사용하면 영문자와 한글이 같은 글꼴로 식자될 뿐만 아니라,
124 한글 사이 자간이나 영문자와 한글 사이 간격 따위의 \xetexko 가 제공하는
125 기능을 포기해야 할 것이다.
126
127 \section{\xetexko\ 부르기}\label{sec:loading}
128 \xetexko\ 로드하기: \cs{usepackage\{xetexko\}} 혹은 \cs{usepackage\{kotex\}}.
129 이 명령으로 fontspec 패키지도 함께 불러들인다.
130 fontspec에 옵션을 주려면 \xetexko를 부르기 전에 fontspec을 따로 로드하면 된다.
131
132 \begin{plaintex}
133 플레인텍이라면 \verb|\input xetexko.sty| 혹은 \verb|\input kotex.sty|.
134 \end{plaintex}
135
136 패키지 옵션:
137 \begin{description}\hangulquotes
138 \item[ hangul ] `제~1~장' `표' `차례' 등 한글 표제를 이용한다.
139 절 제목 이하에는 한글 표제가 붙지 않고 숫자로만 표현된다.
140 한글이 주된 언어라고 인식하여 줄간격 조정도 수행한다.
141 \item[ hanja ] `第~1~章' `表' `目次' 등 한자 표제를 이용한다.
142 절 제목 이하에는 한자 표제가 붙지 않고 숫자로만 표현된다.
143 한글이 주된 언어라고 인식하여 줄간격 조정도 수행한다.
144 \end{description}
145
146
147 \section{글꼴 명령}\label{sec:fontcmds}
148 \begin{verbatim}
149 \setmainfont {Linux Libertine}
150 \setmainhangulfont{NanumMyeongjo}
151 \setmainhanjafont {UnBatang}
152 \end{verbatim}
153 각 명령의 의미는 이름이 뜻하는 그대로이며, fontspec 매뉴얼에 따라
154 설정한다. 마찬가지로 다음 명령들도 제공한다.
155 \begin{verbatim}
156 \setsansfont \setsanshangulfont \setsanshanjafont
157 \setmonofont \setmonohangulfont \setmonohanjafont
158 \end{verbatim}
159 main/sans hangul/hanja 폰트에는 따로 \verb|Ligatures=TeX| 옵션을 지시하지
160 않더라도 자동으로 주어진다.
161
162 \hemph{프리앰블}에서 한글 폰트를 지정하지 않으면 영문폰트가 한글에도 적용되고
163 한자폰트를 지정하지 않으면 한글폰트가 한자에도 적용된다.
164 영문폰트에 한글·한자 글리프가 없고 한글·한자 폰트도 따로
165 지시하지 않았다면 \hemph{은바탕/은돋움 트루타입}을 한글·한자 글꼴의 기본값으로
166 사용한다.
167
168 \bigskip
169
170 \begin{plaintex}
171 플레인텍에서도 기본값으로 은바탕을 한글에 사용한다. 따로 한글폰트를 지시하려면
172 \begin{verbatim}
173 \font\tenrm="[lmroman10-regular]:mapping=tex-text" at 10pt
174 \hangulfont="[UnBatang]:mapping=tex-text" at 10pt
175 \hanjafont ="Naver Dictionary:mapping=tex-text" at 10pt
176 \end{verbatim}
177 또한 다음과 같은 새로운 명령을 제공한다.
178 \begin{verbatim}
179 \sethangulfont\untaza ="[UnTaza.ttf]" at 10pt
180 \sethanjafont \undotum="[UnDotum.ttf]" at 10pt
181 \expandafter\def\expandafter\tt\expandafter{\tt\untaza\undotum}
182 \end{verbatim}
183 그리하여 예의 \cs{tt} 명령으로 이제 한글, 한자, 영문 글꼴을 동시에 바꿀 수 있게 된다.
184 \end{plaintex}
185
186 \keyword{fallbackhanjafont}를 정의해두면 \hemph{한자 글꼴에도 없는 한자}를
187 이 글꼴에서 찾아 식자한다. \cs{newfontfamily} 명령 등으로 정의한다.
188
189 \section{글꼴 명령 (계속)}
190 \begin{verbatim}
191 \hangulfontspec{NanumGothic}[Ligatures=TeX]
192 \hanjafontspec {UnGungseo}[Ligatures=TeX]
193 \end{verbatim}
194 임시로 사용할 한글·한자 글꼴을 지시한다.
195 \cs{adhochangulfont}와 \cs{adhochanjafont}는 이들 명령의 다른 이름이다.
196
197 \begin{verbatim}
198 \newhangulfontfamily\myhangul{NanumGothic}[Ligatures=TeX]
199 \newhanjafontfamily \myhanja {UnGungseo}[Ligatures=TeX]
200 \newhangulfontface \myhangul{NanumGothic Bold}[Ligatures=TeX]
201 \newhanjafontface \myhanja {UnDotumBold}[Ligatures=TeX]
202 \end{verbatim}
203 fontspec 패키지의 \cs{setfontfamily} \cs{setfontface} 명령에 해당한다.
204
205 \begin{verbatim}
206 \addhangulfontfeature{Color=FF0000,InterHangul=-.1em}
207 \addhanjafontfeature {Color=00FF00}
208 \end{verbatim}
209 fontspec의 \cs{addfontfeature} 명령을 구현한 것이다.
210 fontspec과 마찬가지로 각 명령의 끝에 `s'를 붙여도 된다.
211
212 참고로, 한자와 한글을 같은 글꼴로 식자하고 싶을 때 글꼴 설정을
213 번거롭게 두 번 할 필요 없이 한글 글꼴만 설정한 뒤 간단히
214 \keyword{hanjabyhangulfont}를 선언하면 된다.%
215 \footnote{프리앰블의 main/sans/mono 글꼴 명령들과 달리 새로 지정한 한글 폰트가
216 한자에도 자동으로 적용되지는 않는다는 말이다.}
217
218
219 \section{기호 글꼴 명령}\label{sec:symbolfont}
220 라틴 문자나 CJK 기호를 어떤 폰트로 식자할 것인가를 사용자가 지정할 수 있다.
221 \begin{verbatim}
222 \xetexkofontregime{hangul}[parens=latin, puncts=prevfont]
223 \end{verbatim}
224 모든 라틴 문자와 CJK 기호들을 원칙적으로 한글 폰트로 식자하되,
225 괄호류는 라틴 폰트로 찍고 마침표 따위는 현재 폰트를 따라간다는 의미이다.
226 명령의 인자에는 latin, hangul, hanja, prevfont 중 하나가 올 수 있어서
227 각각 라틴 폰트, 한글 폰트, 한자 폰트로 식자하라는 뜻이며
228 마지막의 prevfont는 \hemph{현재 활성화된 폰트를 그대로 이어받도록} 지시한다.
229 현재 폰트가 직전 문자의 폰트가 아닐 수 있음에 주의할 것.
230
231 옵션 키의 종류와 의미는 다음과 같으며 각 키 값은 인자의 경우와 같다.
232 \begin{description}\itemsep0pt
233 \item[alphs] 라틴 알파벳, 숫자, 아래에 해당않는 모든 non-CJK 문자
234 \item[parens] 라틴 괄호, 중괄호, 대괄호, 꺽쇠, 인용부호 및 그 리거쳐
235 \item[colons] 라틴 콜론, 세미콜론
236 \item[hyphens] 하이픈 및 그 리거쳐, 슬래시, en dash, em dash
237 \item[puncts] 마침표, 물음표, 느낌표, 쉼표
238 \item[cjksymbols] CJK 구두점, 괄호 및 상징기호
239 \end{description}
240
241 \begin{oldstuff}
242 종전에
243 라틴숫자에 적용되던 \verb|nums| 옵션과
244 라틴 인용부호에 적용되던 \verb|quotes| 옵션이
245 v3.0부터는
246 각각 \verb|alphs| 옵션과 \verb|parens| 옵션에 통합되었음에 유의하라.
247 또한 en dash, em dash가 종래 \verb|colons|에 속하던 것이 이제
248 \verb|hyphens|에 속하게 되었다.
249 \end{oldstuff}
250
251 기본값은 다음 명령을 준 것과 동일하다.
252 v3.0부터 괄호류의 기본글꼴이 한글이 되었음도 유의하라.
253 \begin{verbatim}
254 \xetexkofontregime {latin}%
255 [ puncts=prevfont, colons=prevfont,
256 parens=hangul, cjksymbols=hangul ]
257 \end{verbatim}
258 \begin{plaintex}
259 플레인텍에서는 다음 명령을 사용한다. \LaTeX에서도 쓸 수 있다.
260 \begin{verbatim}
261 \latinalphs \hangulalphs \hanjaalphs \prevfontalphs
262 \latinparens \hangulparens \hanjaparens \prevfontparens
263 \latincolons \hangulcolons \hanjacolons \prevfontcolons
264 \latinhyphens \hangulhyphens \hanjahyphens \prevfonthyphens
265 \latinpuncts \hangulpuncts \hanjapuncts \prevfontpuncts
266 \latincjksymbols \hangulcjksymbols \hanjacjksymbols \prevfontcjksymbols
267 \end{verbatim}
268 다음 명령은 이상의 모든 라틴 문자를 식자할 폰트를 지시한다.
269 \begin{verbatim}
270 \latinmarks \hangulmarks \hanjamarks \prevfontmarks
271 \end{verbatim}
272 \end{plaintex}
273
274 \section{글꼴 옵션}\label{sec:fontopts}
275 \hemph{고정폭 글꼴을 제외한} 한글·한자 글꼴 명령에 미세 간격 옵션을
276 쓸 수 있다. 예컨대
277 \begin{verbatim}
278 \setsanshangulfont{NanumGothic}[InterHangul=-.04em]
279 \end{verbatim}
280 이 때 나눔고딕 글꼴에 한글 마이너스 자간이 작동한다.
281
282 허용되는 옵션은 다음과 같다.
283 \begin{description}\itemsep0pt
284 \item[InterLatinCJK, hu]\quad
285 {\addhangulfontfeature{InterLatinCJK=.5em} Latin문자와} 한글 사이 간격을 지시한다.
286 기본값 \verb|0.05em|이며
287 수식과 CJK 문자 사이에는 이 값의 두 배가 적용된다.
288 아래에서 설명할 고문헌조판 모드에서는 기본값이 \verb|0.25em|이며
289 수식 직후에 들어가는 값도 동일하다.
290
291 \item[InterHangul, interhchar]\quad
292 {\addhangulfontfeature{InterHangul=0.3em} 한글자간을} 지시한다.
293 기본값은 \verb|0pt|.%
294 \footnote{한자 자간 옵션은 제공하지 않는다.
295 혹시 한자 자간을 조절하고 싶다면 \cs{XKinterhanjabreak}을 재정의하라.
296 참고로 한글 자간을 조절하는 저수준 명령은 \cs{XKinterhangulbreak} 이다.}
297
298 \item[CharRaise, charraise]\quad
299 글자의 {\addhangulfontfeature{charraise=.5ex}수직 위치}를 조절한다.
300 기본값은 \verb|0pt|.%
301 \footnote{%
302 세로쓰기에서는 이 옵션의 값을 고정길이(가령 pt 단위)로 주어야
303 크기가 다른 폰트들 간에 중앙정렬이 이루어진다.
304 }
305 고정폭 글꼴에서도 이 옵션은 작동한다.
306 \end{description}
307 \begin{oldstuff}
308 v3.0부터는 다음 옵션들이 아무 효과도 가져오지 않게
309 변경되었음을 주의하라.
310 \begin{verbatim}
311 lowerperiod lowerquestion
312 lowerexclamation lowercomma
313 preperiodkern postperiodkern
314 prequestionkern postquestionkern
315 preexclamationkern postexclamationkern
316 precommakern postcommakern
317 quoteraise quotewidth
318 postmathskip PunctRaise
319 \end{verbatim}
320 \end{oldstuff}
321
322 \begin{plaintex}
323 플레인텍에서는 다음과 같은 방법으로 제어할 수 있다. 기본값은 \LaTeX에서와 같다.
324 \begin{verbatim}
325 \def\xetexkohu{0.05em }
326 \def\xetexkointerhchar{-0.04em }
327 \def\xetexkocharraise{-0.1ex }
328 \end{verbatim}
329 이것들을 선언해두고나서 \cs{hangulfont} 명령 등으로 글꼴을
330 지정하면 기 정의된 옵션들이 한글폰트 명령에 자동 포함된다.
331 한자폰트의 경우도 같다. 따라서 한글폰트 옵션과
332 한자폰트 옵션을 서로 달리 지시할 수 있다.
333 \end{plaintex}
334
335 \begin{oldstuff}
336 v3.0부터는
337 과거 한글·한자 글꼴의 옵션 기본값을 지정하던
338 \cs{defaulthangulfontfeatures} 및 \cs{defaulthanjafontfeatures} 명령이
339 아무런 기능을 하지 않게 변경되었음에 유의하라.
340 폰트옵션의 수가 적어졌기 때문에 이 명령의 유용성도 거의 사라졌다고 판단했다.
341 \end{oldstuff}
342
343 \section{그밖의 명령들}\label{sec:etccmds}
344 \begin{description}
345 \item[\cs{xetexkostretchshrink}]
346 \vernote{4.5}부터 한글 및 한자 사이 자간의 늘이기 값과 줄이기 값을 지시할 수 있다.
347 가령 \keyword{xetexkostretchshrink}\allowbreak\verb|{plus .025em minus .015em}|.\footnote{%
348 이 예시값은 Lua\TeX-\textsf{k}\kern-0.0625em\textit{o}의 기본값을 흉내낸 것이다.}
349
350 \item[\cs{xetexkoprehanjaspacing}, \cs{xetexkoposthanjaspacing}]
351 \vernote{4.6}부터 사용자는 이들 매크로를
352 어떤 명령어의 앞과 뒤에 각각 삽입함으로써
353 일반적으로 한자 앞^^b7뒤에 들어가야 할 자간공백을 만들어낼 수 있다.\footnote{%
354 예컨대 \texttt{pxrubrica} 패키지를 이용한다면,
355 \texttt{\cs{AddToHook}\{cmd/jruby/before\}\{\cs{xetexkoprehanjaspacing}\}}\\[-2pt]
356 및
357 \texttt{\cs{AddToHook}\{cmd/pxrr@jepilogue/after\}\{\cs{xetexkoposthanjaspacing}\}}.
358 }
359
360 \item[\cs{everyhangul}, \cs{everyhanja}]
361 한글 또는 한자에 대해 글자마다 지시한 명령을 수행한다. 예컨대
362 \verb|\everyhangul{\fbox{#1}}| 명령은 모든
363 {\everyhangul{\fbox{#1}}\fboxsep=1pt 한글 주위에 박스}를
364 두른다.
365
366 \item[\cs{disablekoreanfonts}]
367 한글폰트를 따로 설정하지 않고 영문 폰트를 따라간다.
368 이 때 \cs{setmainfont} 따위가 한글과 한자에도 적용된다.
369
370 \item[\cs{disablecjksymbolspacing}]
371 CJK 구두점의 폭을 \verb|0.5em|으로 강제설정하는 것을 방지한다.
372 \xetexko는 낡은 고정폭 한글 폰트들을 고려하여 이 기능을 구현하였으나
373 현대적인 한글 폰트는 이러한 과잉친절이 오히려 성가실 경우가 있다.
374
375 \cs{nocompresspunctuations}는 이 명령과 동의어이다.\\
376 반대로
377 \keyword{compresspunctuations}는 반각을 강제하라는 명령이다.
378 이것이 기본값이므로 특별한 경우가 아니면 따로 선언할 필요가 없다.
379
380 \item[\cs{disablehangulspacing}]
381 한글조판에 관련된 모든 미세간격을 영\hparen{零}으로 돌린다. 한글 자간,
382 영문자와 한글 사이 간격, 구두점과 한글^^b7한자 사이 간격 등이 작동하지 않는다.
383 그러나 CJK 글자 사이의 줄바꿈 허용만은 유지된다. 또한
384 \verb|CharRaise|는 자간과 무관하므로 여전히 작동한다.
385
386 \item[\cs{disablehangulspacingandlinebreak}]
387 위 명령과 마찬가지로 모든 간격을 금지할 뿐만 아니라 CJK 글자 사이의
388 줄바꿈까지도 먹지 않게 한다.
389 일부 고급 오픈타입 기능을 사용하기 위해서 이 명령이 필요할 때가 있다.
390 이를테면, 폰트가 지원하는 한글 리거쳐가 동작하지 않을 때 이 명령을
391 선언하면 문제가 해결된다.%
392 \footnote{%
393 이 명령은 그룹 안에서 실행해야 할 것이다. 그렇더라도
394 \cs{enablehangulspacingandlinebreak} 명령을 그룹을 닫고나서 선언해야
395 원래 기능이 완전히 복구된다.
396 }
397
398 \end{description}
399 \begin{oldstuff}
400 v3.0부터는 종전의
401 \cs{disableautojosa} 및 \cs{disablejamoautojosa} 명령이 아무 기능도 하지 않게
402 변경되었음을 유의하라.
403 \end{oldstuff}
404
405 \section{옛한글}
406
407 옛한글을 사용하기 위해선 \verb|Script=Hangul| 옵션을 주는 것으로 족하다.\footnote{%
408 옛한글을 위해서가 아니더라도 \texttt{Script=Hangul}과 \texttt{Language=Korean}은
409 가능하면 항상 주는 것이 권장된다.}
410 옛한글 식자는 고급 오픈타입 기능을 이용하므로
411 폰트가 이런 기능을 제공해야만 가능한 일이다.\footnote{%
412 이런 기능을 제공하는 폰트로는 윈도즈~8에 번들된 맑은고딕이
413 있으며 공개폰트로는 은바탕, 함초롬~LVT, Source Han Sans (본고딕),
414 Source Han Serif (본명조), Noto Sans CJK, Noto Serif CJK,
415 나눔명조옛한글, 나눔바른고딕옛한글, KoPubWorld 바탕, KoPubWorld 돋움 등이 있다.
416 또한
417 \textsf{^^^^1112^^^^119e^^^^11ab글}에 번들된 함초롬 글꼴에도
418 최근 옛한글 지원이 추가되었다.}
419
420 \begin{figure}
421 \begin{example}
422 \sffamily \obeylines\leftskip10em
423 뎨 가ᄂᆞᆫ 뎌 각시 본 듯도 ᄒᆞᆫ뎌이고.
424 天텬上상白ᄇᆡᆨ玉옥京경을 엇디ᄒᆞ야 離니別별ᄒᆞ고
425 ᄒᆡ 다 져믄 날의 눌을 보라 가시ᄂᆞᆫ고
426 \medbreak
427 어와 네여이고 내 ᄉᆞ셜 드러보오.
428 내 얼굴 이 거동이 님 괴얌즉 ᄒᆞᆫ가마ᄂᆞᆫ
429 엇딘디 날 보시고 네로다 녀기실ᄉᆡ
430 나도 님을 미더 군 ᄠᅥ디 전혀 업서
431 이ᄅᆡ야 교ᄐᆡ야 어ᄌᆞ러이 구돗ᄯᅥᆫ디
432 반기시ᄂᆞᆫ ᄂᆞᆺ비치 녜와 엇디 다ᄅᆞ신고.
433 \end{example}
434 \caption{옛한글 조판 보기}\label{fig:yethangul}
435 \end{figure}
436
437 \begin{verbatim}
438 \setmainhangulfont{Malgun Gothic}[ Script=Hangul ]
439 \end{verbatim}
440 \begin{plaintex}
441 플레인텍이라면, \cs{hangulfont="Malgun Gothic:script=hang" at 10pt}.
442 \end{plaintex}
443
444 \section{세로쓰기}\label{sec:verttype}
445
446 세로쓰기를 위한 글꼴 지정은 다음과 같다.
447 역시 고급 오픈타입 기능을 이용하는 것이므로 폰트가 이를 지원해야 한다.
448 \begin{verbatim}
449 \newhangulfontfamily\vertfont{Noto Sans CJK KR}
450 [Vertical=Alternates, RawFeature=vertical]
451 \end{verbatim}
452
453 \begin{itemize}\itemsep=0pt plus1pt minus1pt
454 \item
455 문서 전체를 세로쓰기할 때 \keyword{verticaltypesetting} 을 선언하면
456 면주는 그대로 두고 본문만 세로쓰기한다.\footnote{면주의 글꼴에는
457 \texttt{vertical} 옵션이 없어야 할 것이다.
458 면주 글꼴을 따로 지정하는 것은 사용자의 몫이다. }
459
460 \item
461 몇몇 페이지만 세로쓰기로 조판하려면
462 \verb|verticaltypesetting| 을 환경으로 이용한다.
463 역시 면주는 가로로 조판되며, 환경의 앞뒤에서 쪽나눔이 행해진다.
464
465 \item
466 문서의 일부를 세로쓰기 하려면 \verb|vertical| 환경을 이용한다.
467 vertical 환경에는 세로쓰기 박스의 높이를 인자로 준다.
468 만약 인자가 비어있거나 \cs{empty}이면
469 본문을 한 줄짜리 박스로 식자한다. 이때 높이는 natural height가 된다.
470
471 \begin{figure}
472 \begin{example}
473 \hfil\begin{vertical}{18em}
474 \linespread{1.5}\sffamily
475 \addhangulfontfeatures{Vertical=Alternates,CharRaise=.5ex,RawFeature=vertical}
476 \hanjabyhangulfont
477 \typesetclassic \latinparens
478 \parindent0pt \everypar{\hangindent1em \hangafter1 }
479 \spaceskip=.5em plus .25em minus .125em
480 \quad 님의 침묵 (The Silent Beloved)
481 \smallbreak
482 \hfil\hfil 한 용 운\hfil
483 \bigbreak
484 님은 갓슴니다 아아 사랑하는나의님은 갓슴니다\par
485 푸른산빗을깨치고 단풍나무숩을향하야난 적은길을 거러서 참어떨치고 갓슴니다\par
486 黃金의꽃가티 굿고빗나든 옛盟誓는 차듸찬띠끌이되야서 한숨의 微風에 나러갓슴니다\par
487 날카로은 첫〈키쓰〉의追憶은 나의運命의指針을 돌너노코 뒷거름처서 사러젓슴니다\par
488 \hellipsis\par
489 아아 님은갓지마는 나는 님을보내지 아니하얏슴니다\par
490 제곡조를못이기는 사랑의노래는 님의沈默을 휩싸고돔니다\par
491 \end{vertical}\hfil
492 \end{example}
493 \caption{세로쓰기 보기.
494 Noto Sans CJK KR 글꼴을 이용했다. 이 글꼴의 세로쓰기 어간이 1em으로
495 매우 커서 \cs{spaceskip=0.5em plus.25em minus.125em}을 강제했다.
496 \texttt{CharRaise=.5ex}도 글꼴 옵션에 추가했다.
497 또한 \cs{latinparens}를 선언했는데
498 제목 다음의 괄호가 CJK 괄호가 아니라 아스키 괄호이기 때문이다.
499 }\label{fig:vertical}
500 \end{figure}
501
502 \begin{verbatim}
503 \begin{vertical}{12em}
504 \vertfont
505 \hanjabyhangulfont
506 세로쓰기로 植字할 부분
507 \end{vertical}
508 \end{verbatim}
509
510 \item
511 혹시 세로로 식자되지 않는 라틴문자 부분이 있다면
512 베이스라인이 한글과 어울리지 않을 수 있다. 이를 교정하려면
513 \verb|CharRaise| 옵션을 한글 폰트에 준다.\footnote{%
514 세로쓰기에서는 일반적으로 \texttt{CharRaise} 옵션을 주는 쪽이 권장된다.
515 이 방법이 여의치 않으면 라틴문자 부분을 \cs{vertlatin} 명령으로 감쌀 수도
516 있는데, 이때 인자가 박스로 처리되어 줄바꿈이 일어나지 않는다.}
517
518 \item
519 세로쓰기 도중에 문서의 일부를 가로쓰기로 삽입하려면
520 \verb|horizontal| 환경을 이용한다.
521 horizontal 환경에는 가로쓰기 박스의 너비를 인자로 준다.
522 만약 인자가 비어있거나 \cs{empty}이면
523 본문을 한 줄짜리 박스로 식자한다. 이때 너비는 당연히 natural width가 된다.
524 \end{itemize}
525
526 \begin{plaintex}
527 플레인텍에서 문서 전체를 세로쓰기하려면 문서 첫머리에 \cs{verticaltypesetting}.
528
529 몇몇 페이지만 세로로 쓰려면 \cs{beginverticaltypesetting} \ldots\ \cs{endverticaltypesetting}.
530
531 문서 일부를 세로쓰기하려면 가령,
532 \begin{verbatim}
533 \vertical{}
534 \hangulfont="Noto Sans CJK KR:vertical;+vert"
535 \hanjabyhangulfont
536 세로쓰기로 植字할 부분
537 \endvertical
538 \end{verbatim}
539
540 세로쓰기 중에 잠시 가로로 식자하려면 \cs{horizontal\{\}} \ldots\ \cs{endhorizontal}.
541 \end{plaintex}
542
543 \section{고문헌 조판}
544
545 \verb|typesetclassic| 환경은 고문헌 조판에 적합한 환경이다.
546
547 불필요한 공백을 없애주는 기능은
548 v3.0부터는 자동으로 동작하지 않는다. 사용자가
549 \keyword{removeclassicspaces} 명령을 주어야 CJK 글자간 공백을
550 제거하기 시작한다.
551
552 간단한 일본어, 중국어 문단 정도를 식자하는 데도 이 환경을 이용할 수 있으나
553 각 언어의 전용 패키지들에 비해 기능이 많이 모자란다.\footnote{%
554 그러나 \texttt{japanese}, \texttt{Schinese}, \texttt{Tchinese} 환경이 여전히 제공된다.
555 \texttt{chinese}는 \texttt{Schinese}의 다른 이름이다.
556 특히 중국어 폰트를 사용할 때는 \texttt{Schinese}나 \texttt{Tchinese}를 명시하는 게 좋다.
557 }
558
559 \begin{plaintex}
560 플레인텍에서는 다음 방식으로 사용한다.
561 \begin{verbatim}
562 \begingroup \typesetclassic
563 ...
564 \endgroup
565 \end{verbatim}
566 \end{plaintex}
567
568
569 \keyword{inhibitglue} 명령은
570 해당 지점에 자동 삽입되는 공백을 영\hparen{零}으로 만들어준다.
571
572 현대문서 조판에는 \verb|typesetmodern| 환경이 쓰인다. 이 환경은 기본값이므로
573 특별한 경우가 아니면 따로 선언할 필요가 없다.
574
575 \def\analect{%
576 \removeclassicspaces
577 子曰:「學而時習之,不亦說乎?有朋自遠方來,不亦樂乎?人不知而不慍,不亦君子乎?」\par
578 有子曰:「其爲人也 孝弟,而好犯上者,鮮矣!不好犯上,而好作亂者,未之有也!
579 君子務本,本立而道生;孝弟也者,其爲仁之本與?」\par
580 子曰:「巧言令色,鮮矣仁!」\par
581 曾子曰:「吾日三省吾身:爲人謀,而不忠乎?與朋友交,而不信乎?傳,不習乎?」\par
582 子曰:「道千乘之國,敬事而信,節用而愛人,使民以時。」\par
583 子曰:「弟子入則孝,出則弟;謹而信,汎愛衆;而親仁,行有餘力,則以學文。」
584 }
585 \begin{figure}
586 \begin{example}\linespread{1.3}
587 \sffamily\typesetclassic
588 \analect
589 \end{example}
590 \caption{고문헌 조판 보기.
591 typesetclassic 환경을 이용했으며
592 \cs{removeclassicspaces}도 선언했다.
593 }\label{fig:ancientdoc}
594 \end{figure}
595
596 \begin{figure}
597 \begin{example}\linespread{1.3}
598 \hfil\begin{vertical}{19em}
599 \linespread{1.5}\sffamily\typesetclassic
600 \addhangulfontfeatures{Vertical=Alternates,CharRaise=.5ex,RawFeature=vertical}
601 \hanjabyhangulfont \parindent0pt \everypar{\hangindent1em \hangafter1 }
602 \analect
603 \end{vertical}\hfil
604 \end{example}
605 \caption{고문헌 세로쓰기 조판 보기.
606 vertical 환경을 이용했다.
607 \cs{hangingpunctuations}가 선언되어 있어서 구두점이
608 행 끝에 걸린 것을 볼 수 있다.
609 }\label{fig:ancientdocvertical}
610 \end{figure}
611
612 \section{매달린 구두점}
613 \hemph{하이픈을 제외한} 문장부호들를 판면 바깥에 식자하여 행 끝에 매달리게 만들 수 있다.
614
615 v3.0부터는 \keyword{hangingpunctuations} 명령으로 활성화한다.
616 \cs{hangingpunctuation}은 이 명령과 동의어이다.
617 당분간 xetexko-hanging.sty을 로드하는 것으로도 활성화되도록 해 두었다.
618 이렇게 활성화되면 기본값으로 온점, 반점, 고리점, 모점에 대해서 전부 내밀기가 작동한다.
619
620 v3.2부터는 사용자가 원하는 문장부호를 원하는 만큼 판면 밖으로 내밀 수 있다.
621 \begin{verbatim}
622 \sethangingratio"28=0.5 %
623 \sethangingratio"3002=1 %
624 \end{verbatim}
625 등호 앞의 숫자는 유니코드 코드포인트이고 뒤의 숫자는 글자폭에 대한 비율을 뜻한다.
626 따라서 위 예는 여는괄호(U+0028)를 절반만 내밀고 고리점(U+3002)은 완전히 밀어내라는 지시다.
627 어느 방향으로 내밀지는 \xetexko 가 알아서 판단한다.
628 이러한 지시를 취소하려면,
629 \begin{verbatim}
630 \unsethangingratio"28
631 \unsethangingratio"3002
632 \end{verbatim}
633
634 \begin{oldstuff}
635 microtype 패키지의 protrusion 기능이 잘 작동하지 않는 경우가 있어,%
636 \footnote{%
637 원시명령 \cs{lpcode} \cs{rpcode} 등 엔진이 제공하는 기능을 말한다.
638 이들 원시명령에는 글리프 인덱스를 지시해야 하는데 어떤 글자의 글리프 인덱스를
639 알아내는 일은 간단치가 않다.
640 \XeTeX\ reference guide를 참고하라.
641 }
642 어쩔 수 없이 제공하게 되었으므로 예외적으로만 사용할 것을 권한다.
643 \end{oldstuff}
644
645 %\begin{figure}
646 %\Large
647 %\hangingpunctuation
648 %\setbox0\hbox{줄 끝에 매달린 구두점}
649 %\vbox{\hfil\hbox{\vrule\vbox{\hsize\wd0
650 % 줄 끝에 매달린 구두점.
651 % 줄 끝에 매달린 구두점,
652 % 줄 끝에 매달린 구두점、
653 % 줄 끝에 매달린 구두점。
654 % 줄 끝에 매달린 구두점
655 % }\vrule}\hfil}
656 %\caption{기본값이 적용된 매달린 구두점}\label{fig:hanging}
657 %\end{figure}
658
659 \section{수식 한글}
660 수식 모드에서도 한글을 \hparens{hbox로 감싸지 않고} 직접 입력할 수 있다.
661 \begin{quote}
662 \verb|$가^{나^다}$|\quad$\Rightarrow\quad가^{나^다}$
663 \end{quote}
664 v3.0부터는
665 자동으로 수식한글을 잡아주지 않으므로 사용자가 다음과 같이 명시적으로 선언해야 한다.
666 \begin{verbatim}
667 \setmathhangulfont{Noto Sans CJK KR}[
668 SizeFeatures={ {Size=-6, Font=* Medium},
669 {Size=6-9, Font=*},
670 {Size=9-, Font=* DemiLight} }
671 ]
672 \end{verbatim}
673 \begin{plaintex}
674 플레인텍에서는 \cs{mathhangulfont="[UnBatang.ttf]"}와 같이 설정한다.
675
676 또는 좀 더 그럴듯하게 하려면:\par
677 \leftskip=3em\noindent
678 \begin{verbatim}
679 \font\texthangul="Noto Sans CJK KR DemiLight" at 10pt
680 \font\scripthangul="Noto Sans CJK KR Regular" at 7pt
681 \font\scriptscripthangul="Noto Sans CJK KR Medium" at 5pt
682 \setmathhangulfonts\texthangul\scripthangul\scriptscripthangul
683 \end{verbatim}
684 \end{plaintex}
685
686 현재 한글만 쓸 수 있게 설정되어 있다.
687 한자도 수식에 직접 입력하려면 사용자는
688 \begin{verbatim}
689 \setmathhangulblock{4E00}{9FC3}
690 \end{verbatim}
691 명령으로 유니코드 블럭을 추가 지정해야 한다.
692
693 \section{자동조사}
694 자동조사는 \kotex 의 경우와 대체로 동일하게 동작한다.
695 게다가 문장 중에서도 동작하고
696 플레인텍에서까지 사용할 수 있다.
697 그럼에도 불구하고 사용자가 임의로 제어할 필요가 생긴다면
698 \cs{jong} \cs{jung} \cs{rieul} 중 하나를
699 미리 선언해 둘 수 있다. 이를테면,
700 \begin{verbatim}
701 \def\mypage{페이지\jung}
702 \def\mypage{쪽\jong}
703 \def\mystar{별\rieul}
704 \end{verbatim}
705
706 \section{드러냄표}
707 \keyword{dotemph} 명령을 사용하는
708 \dotemph{드러냄표} 강조도 \kotex 과 대동소이하다.
709 기본은 글자 위에 점을 찍는 형태이나 다음 명령을 이용해 개인적으로 선호하는
710 기호를 드러냄표로 쓸 수 있다.
711 \begin{verbatim}
712 \def\dotemphraise{0.4em }
713 \def\dotemphchar{\bfseries ^^^^02d9}
714 \end{verbatim}
715 전자는 드러냄표를 피강조 글자 위로 끌어올리는 길이를,
716 후자는 드러냄표 기호 자체를 정의한다.
717 \verb|^^^^02d9|는 유니코드 코드포인트를 뜻하는 16진수이고
718 숫자 대신 직접 문자를 입력해도 된다.
719 플레인텍에서도 드러냄표 강조를 사용할 수 있다.
720
721 \section{고아글자 문제}
722 어느 정도는 고아글자가 생기지 않게 만들어 두었으나,
723 \XeTeX 에서는 고아글자를 자동으로 완전히 회피하기는 어렵다.
724 필요하다면 사용자가 적당한 곳에 \cs{nobreak} 명령을 삽입해야 한다.
725
726 \section{한국어 번호}
727 항목 번호를 한국어 기호로 붙일 수 있다. \kotex과 마찬가지로
728 \cs{jaso} \cs{gana} \cs{ojaso} \cs{ogana} \cs{pjaso}
729 \cs{pgana} \cs{onum} \cs{pnum} \cs{oeng} \cs{peng}
730 \cs{hnum} \cs{Hnum} \cs{hroman} \cs{hRoman} \cs{hNum}
731 \cs{hanjanum}
732 따위를 사용한다.
733
734 \section{밑줄긋기}
735 \LaTeX 에서는 \uwave{ulem 패키지}를 로드하는 것만으로 자동 지원된다.%
736 \footnote{%
737 ulem 명령어의 인자 안에서도 \cs{dotemph} 명령을 쓸 수 있다.
738 }
739 \begin{plaintex}
740 \cs{xetexkoulemsupport} 명령이 v3.3부터 부활하였으므로
741 플레인텍에서는 이 명령을 명시해야 할 경우가 있을 것이다.%
742 \end{plaintex}
743
744 \begin{center}
745 *\qquad\qquad *\qquad\qquad *
746 \end{center}
747
748 \section*{주요 변경 이력}
749
750 \begin{small}\linespread{1.2}\selectfont
751 \begin{description}
752 \item[v4.6] 2025-08-24
753 \begin{itemize}
754 \item \hyperref[sec:etccmds]{\cs{xetexkoprehanjaspacing}, \cs{xetexkoposthanjaspacing} 추가}
755 \end{itemize}
756 \item[v4.5] 2025-07-16
757 \begin{itemize}
758 \item \hyperref[sec:etccmds]{\cs{xetexkostretchshrink} 명령 추가}
759 \end{itemize}
760 \item[v4.1] 2022-03-18
761 \begin{itemize}
762 \item U+223C \hparen{\texttt{^^^^223c}}를
763 \verb|cjksymbols|에 할당함으로써
764 한글 폰트로 찍히는 게 기본값이 되었다.
765 \end{itemize}
766 \item[v4.0] 2021-09-06
767 \begin{itemize}
768 \item \xetexko 가 제공하는 대부분의 기능은 폰트 인코딩이
769 유니코드 인코딩(\texttt{TU})이거나 플레인텍처럼 폰트 인코딩 개념이 없는
770 경우에만 동작한다.
771 \end{itemize}
772 \item[v3.6] 2021-06-10
773 \begin{itemize}
774 \item \hyperref[sec:verttype]
775 {\cs{verticaltypesetting}을 환경으로도 쓸 수 있다}.
776 \item \hyperref[sec:verttype]
777 {\texttt{vertical} 및 \texttt{horizontal} 환경의 인자를 비워둘 수 있다}.
778 \end{itemize}
779 \item[v3.4] 2021-05-15
780 \begin{itemize}
781 \item \hyperref[sec:fontcmds]
782 {글꼴 전환 방식의 내부적 변화 및 그에 따른 플레인텍 한글 폰트 명령의 의미 변경}
783 \end{itemize}
784 \item[v3.3] 2021-04-20
785 \begin{itemize}
786 \item \cs{xetexkoulemsupport} 명령 부활
787 \item `㉾' 등 한글기호를 \verb=cjksymbols=에 할당
788 \end{itemize}
789 \item[v3.2] 2021-04-08
790 \begin{itemize}
791 \item 매달린 구두점이 기본값으로 따옴표에는 작동하지 않고 마침표^^b7쉼표에만 작동한다.
792 \item \cs{sethangingratio}, \cs{unsethangingratio} 명령 추가
793 \end{itemize}
794 \item[v3.1] 2021-03-22
795 \begin{itemize}
796 \item 플레인텍 명령 \cs{sethangulfont}, \cs{sethanjafont} 추가
797 \end{itemize}
798 \item[v3.0] 2021-03-20
799 \begin{itemize}
800 \item \verb|typesetclassic|, \verb|typesetmodern| 환경이 추가되었다.
801 \item \cs{removeclassicspaces} 명령이 추가되었다.
802 \item \cs{compresspunctuations}, \cs{nocompresspunctuations} 명령이 추가되었다.
803 \item \cs{hangingpunctuations} 명령이 추가되었다.
804 \item 디폴트 고정폭 한글 폰트의 메트릭을 Latin Modern Mono에
805 맞추어 조정하였다.
806 \item 글꼴옵션이 \verb|InterLatinCJK|, \verb|InterHangul|, \verb|CharRaise|
807 외에는 모두 무력화되었다.
808 \item \cs{xetexkofontregime}의 키값 \verb|nums|와 \verb|quotes|가
809 각각 \verb|alphs|와 \verb|parens|에 통합되었다.
810 \item \cs{xetexkoulemsupport} 명령이 무력화되었다.
811 \item \cs{disableautojosa}, \cs{disablejamoautojosa} 명령이 무력화되었다.
812 \item \cs{defaulthangulfontfeatures} \cs{defaulthanjafontfeatures}
813 명령이 무력화되었다.
814 \item 수식한글을 자동으로 잡아주지 않는다.
815 \end{itemize}
816 \item[v2.23] 2020-02-17
817 \begin{itemize}
818 \item \hyperref[sec:fontcmds]
819 {디폴트 한글 폰트가 나눔글꼴에서 은글꼴로 변경되었다.}
820 \end{itemize}
821 \item[v2.13] 2015-06-16
822 \begin{itemize}
823 \item \hyperref[sec:verttype]
824 {\texttt{horizontal} 환경이 추가되었다.}
825 \end{itemize}
826 \item[v2.10] 2015-01-16
827 \begin{itemize}
828 \item 패키지 옵션 \texttt{[unfonts]}를 더는 지원하지 않는다. 이 옵션을
829 사용한 기존 문서는 기본 글꼴인 은글꼴 트루타입으로 식자될 것이다.
830 \end{itemize}
831 \item[v2.7] 2014-06-17
832 \begin{itemize}
833 \item \hyperref[sec:fontcmds]
834 {main/sans hangul/hanja 글꼴에는 디폴트 옵션
835 \texttt{Ligatures=TeX}이 주어진다.}
836 \item \hyperref[sec:fontopts]
837 {\cs{defaulthangulfontfeatures}와 \cs{defaulthanjafontfeatures}
838 명령이 생겼다.}
839 \end{itemize}
840 \item[v2.4] 2014-02-02
841 \begin{itemize}
842 \item Variation Selector를 이용한 한자 변형 글리프 접근을 허용한다.
843 \end{itemize}
844 \item[v2.2] 2013-12-06
845 \begin{itemize}
846 \item \hyperref[sec:fontopts]
847 {글꼴 옵션 \texttt{CharRaise}를 추가했다.}
848 \item \hyperref[sec:fontcmds]
849 {\cs{fallbackhanjafont} 명령을 인식한다.}
850 \item \hyperref[sec:etccmds]
851 {\cs{everyhangul}, \cs{everyhanja} 명령이 추가되었다.}
852 \item \hyperref[sec:symbolfont]
853 {하이픈 문자를 \hparen{직전 글꼴이 아니라} 라틴 글꼴에서 찾는
854 것이 기본값이 되었다.}
855 \end{itemize}
856 \item[v2.0] 2013-03-27
857 \begin{itemize}
858 \item \hyperref[sec:loading]
859 {플레인텍에서 xetexko.tex이 아니라 xetexko.sty를 불러야 한다.}
860 \item \hyperref[sec:symbolfont]
861 {CJK 기호문자를 \hparen{한자가 아니라} 한글 글꼴에서 찾는 것이
862 기본값이 되었다.}
863 \item \hyperref[sec:fontopts]
864 {\texttt{interpunctskern} 글꼴 옵션을 없애고 \texttt{quoteraise}를
865 추가했다.}
866 \end{itemize}
867 \end{description}
868 \end{small}
869
870 \end{document}