Debian Codegraph @

texmf-dist/doc/luatex/luatexko/luatexko-doc.tex

raw
1 %% !TEX program = lualatex
2 %% !TEX encoding = UTF-8
3 %%
4 %% luatexko-doc.tex
5 %%
6 %% written by Dohyun Kim <nomosnomos at gmail com>
7 %% Soojin Nam <jsunam at gmail com>
8 %%
9 %% public domain
10
11 %\DocumentMetadata{
12 % lang=ko,
13 % pdfstandard={UA-2,A-4f},
14 % tagging=on,
15 % tagging-setup={math/setup=mathml-SE, extra-modules=verbatim-alt}
16 %}
17
18 \documentclass[a4paper]{article}
19 \usepackage[hmargin={3.4cm,4.2cm}]{geometry}
20 \usepackage[rgb]{xcolor}
21 \usepackage{luacolor}
22 \usepackage{lum-lmodern}
23 \usepackage[hangul]{luatexko}
24 \directlua{
25 fonts.protrusions.setups.latin = {
26 [0x28] = { 0.5, 0 }, % (
27 [0x29] = { 0, 0.5 }, % )
28 [0x2C] = { 0, 1 }, % ,
29 [0x2E] = { 0, 1 }, % .
30 [0x3A] = { 0, 0.5 }, % :
31 [0x3B] = { 0, 0.5 }, % ;
32 [0xAB] = { 0.5, 0 }, % «
33 [0xBB] = { 0, 0.5 }, % »
34 [0x2018] = { 1, 0 }, % ‘
35 [0x2019] = { 0, 1 }, % ’
36 [0x201C] = { 0.5, 0 }, % “
37 [0x201D] = { 0, 0.5 }, % ”
38 }
39 fonts.protrusions.setups.cjk = {
40 % compresspunctuations 가 이미 반각을 강제했으므로 여기선 0.5만 준다.
41 % +halt, +vhal 따위의 옵션이 주어진 때에도 마찬가지
42 factor = 0.5,
43 [0x3001] = { 0, 1 },
44 [0x3002] = { 0, 1 },
45 [0xFF0C] = { 0, 1 },
46 [0xFF0E] = { 0, 1 },
47 [0xFE10] = { 0, 1 },
48 [0xFE11] = { 0, 1 },
49 [0xFE12] = { 0, 1 },
50 }
51 }
52 \defaultfontfeatures+{Renderer=HarfBuzz}
53 \setmainhangulfont{Noto Serif CJK KR}[
54 Scale=0.98,
55 Script=Hangul,
56 Language=Korean,
57 UprightFont=* Light,
58 BoldFont=* Bold,
59 ItalicFont=Noto Sans CJK KR DemiLight,
60 InterLatinCJK=.125em,
61 CompressPunctuations,
62 Expansion, Protrusion=latin,
63 ]
64 \setsanshangulfont{Noto Sans CJK KR}[
65 Scale=0.98,
66 Script=Hangul,
67 Language=Korean,
68 UprightFont=* DemiLight,
69 BoldFont=* Bold,
70 % ItalicFont=Noto Serif CJK KR Light,
71 InterLatinCJK=.125em,
72 CompressPunctuations,
73 Expansion, Protrusion=latin,
74 ]
75 \setmonofont{Inconsolatazi4}[
76 Scale=0.98,
77 CharRaise=0.125ex,
78 Color=191970, % Color=MidnightBlue,
79 ]
80 \setmonohangulfont{Noto Sans CJK KR}[
81 Scale=0.98,
82 UprightFont=* DemiLight,
83 BoldFont=* Bold,
84 CharRaise=-.125ex,
85 Color=191970, % Color=MidnightBlue,
86 ]
87 \setmathhangulfont{Noto Sans CJK KR}
88 [
89 Script=Hangul,
90 Language=Korean,
91 SizeFeatures={
92 {Size=-6, Font=* Medium},
93 {Size=6-9, Font=* Regular},
94 {Size=9-, Font=* DemiLight},
95 },
96 ]
97 \newhangulfontfamily\verticalhangulfont{Noto Sans CJK KR}[
98 %Renderer=Node,
99 Script=Hangul,
100 Language=Korean,
101 UprightFont=* DemiLight,
102 BoldFont=* Bold,
103 InterLatinCJK=.125em,
104 Vertical=Alternates,
105 RawFeature=vertical,
106 CompressPunctuations,
107 InterCharStretch=1pt,
108 CharRaise=1pt,
109 %CharacterWidth=Full,
110 Protrusion=cjk,
111 ]
112 \usepackage{hologo}
113 \usepackage[hidelinks]{hyperref}
114
115 \AddToHook{cmd/item/before}{\itemsep 0pt plus 1pt minus 1pt}
116 \AddToHook{cmd/caption/before}{\linespread{1.3}\sffamily}
117 \AddToHook{env/verbatim/begin}{\linespread{1.1}}
118 \AssignSocketPlug{build/column/outputbox}{space-floats-footnotes}
119
120 \catcode`|=13 \protected\def|{\verb|\let\\=\textbackslash} %|
121 \protected\def\cs#1{\texttt{\textbackslash\detokenize{#1}}}
122 \protected\def\pkgkwd#1#{\leavevmode
123 \ifx\relax#1\relax \expandafter\luatexkopkgkwd
124 \else \expandafter\luatexkopkgkwdX \fi}
125 \def\luatexkopkgkwd#1{\texttt{\string#1}\luatexkopkgkwdX{#1}}
126 \def\luatexkopkgkwdX#1{\marginpar{%
127 \hfuzz\maxdimen \texttt{\footnotesize \string#1}}}
128 %\def\logoko{\textsf{k}\kern-.0625em\textit{o}} % too slow
129 \ExplSyntaxOn
130 \cs_new_nopar:Npn \actualtag #1 #2
131 {
132 \leavevmode
133 \tag_if_active:TF
134 {
135 \tag_mc_end_push:
136 \tag_struct_begin:n{tag=Span, actualtext=#1}
137 \tag_mc_begin:n{}
138 \SuspendTagging{actualtag}
139 #2
140 \ResumeTagging{actualtag}
141 \tag_mc_end:
142 \tag_struct_end:
143 \tag_mc_begin_pop:n{}
144 }
145 {
146 #2
147 }
148 }
149 \cs_new_nopar:Npn \artifacttag #1
150 {
151 \leavevmode
152 \tag_if_active:TF
153 {
154 \tag_mc_end_push:
155 \tag_mc_begin:n{artifact}
156 \SuspendTagging{artifacttag}
157 #1
158 \ResumeTagging{artifacttag}
159 \tag_mc_end:
160 \tag_mc_begin_pop:n{}
161 }
162 {
163 #1
164 }
165 }
166 \ExplSyntaxOff
167 \def\logoko{\actualtag{ko, phoneme=[ˌkeɪˈəʊ]}{\textsf{k}\kern-.04em $o$}}
168 \def\luatex{\hologo{LuaTeX}\unskip}
169 \def\XeTeX{\hologo{XeTeX}\unskip}
170 \def\luatexko{\luatex\artifacttag{-}\logoko}
171 \def\texlive{\hologo{TeXLive}\unskip}
172 \def\kotex{\actualtag{koTeX, phoneme=[ˌkeɪˈəʊtɛx]}{\logoko\kern-.1ex .\kern-.1667em \TeX}}
173 \def\hemph#1{\textsf{\bfseries #1}}
174 \def\meta#1{\actualtag{<#1>}{$\langle$\textit{#1}$\rangle$\nobreak\inhibitglue}}
175 \makeatletter
176 \def\fakespaceoff#1{\csname tag_spacechar_off:\endcsname#1\csname tag_spacechar_on:\endcsname}
177 \def\hparen#1{\begingroup\fontsize{.9\dimexpr\f@size pt\relax}\z@\selectfont
178 \ifdim\lastskip>\z@\else \ifdim\lastkern>\z@\else
179 \fakespaceoff{\hskip.1em plus.01em\relax}\fi\fi (#1)\futurelet\@let@token\hparenstop}
180 \def\hparenstop{\ifx\@let@token\@sptoken\else
181 \ifx\@let@token\footnote\else\ifx\@let@token ,\else\ifx\@let@token '\else
182 \fakespaceoff{\hskip.1em plus.01em\relax}\fi\fi\fi\fi\endgroup}
183 \newenvironment{plaintex}{%
184 \par\smallskip
185 \linespread{1.1}\small \narrower \parindent=0pt \parskip=2pt plus 1pt
186 \topsep=\smallskipamount \@totalleftmargin=\leftskip
187 \leavevmode\llap{\color{gray}\normalfont\hologo{plainTeX}\unskip\hskip1em}\ignorespaces
188 }{%
189 \par
190 }
191 \newenvironment{sourceandresult}{%
192 \par
193 \if@nobreak \else \ifdim\lastskip>\z@ \else \medskip \fi \fi
194 \narrower \parindent0pt
195 }{%
196 \par\medskip
197 \AddToHookNext{para/begin}{\OmitIndent}%
198 }
199 \def\srcres#1{\leavevmode \texttt{\srcres@#1\stop}\quad ⇒\quad #1\par }
200 \def\srcres@#1#2#3\stop{%
201 \if\noexpand#1\relax \string#1\{#2\}\ifx\empty#3\empty\else\{#3\}\fi
202 \else \detokenize{#1#2#3}\fi
203 }
204 \makeatother
205 \def\ldots{|...|}
206
207 \begin{document}
208 \title{\luatexko\ 간단 매뉴얼}
209 \author{\normalsize Dohyun Kim \small |<nomosnomos at gmail com>| \and
210 \normalsize Soojin Nam \small |<jsunam at gmail com>| \and
211 \normalsize <\url{http://github.com/dohyunkim/luatexko}>}
212 \date{Version 5.7\quad 2026/02/20}
213 \maketitle
214
215 For a summary introduction in English, please see |README| file.
216
217 \smallskip
218
219 \section{부르기}\label{sec:loading}
220
221 \luatexko 를 불러오려면 \cs{usepackage{luatexko}} 혹은 \cs{usepackage{kotex}}.
222
223 입력은 원칙적으로 UTF-8으로 한다.
224 BOM \hparen{Byte Order Mark}은 있어도 좋고 없어도 좋다.
225 CP949 인코딩에 관해서는 제\ref{sec:uhcencoding}절 참조.
226
227 \begin{plaintex}
228 플레인텍에서는 \cs{input luatexko.sty} 혹은 \cs{input kotex.sty}.
229 \end{plaintex}
230
231 \section{패키지 옵션}\label{sec:packageopt}
232
233 패키지 옵션으로 \pkgkwd{hangul}과 \pkgkwd{hanja}가 제공된다.
234 행간격 조정이 행해지며
235 장 제목이나 표·그림 캡션 따위가 한글 또는 한자 방식으로 표시된다.
236 장\hparen{chapter} 제목과 편\hparen{part} 제목에만 ``제\hparen{第}''가 붙어 ``제~1 편''
237 ``제~3 장''과 같은 방식으로 표시되며 절 제목 이하에는 붙지 않는다.
238
239 \section{글꼴명령}\label{sec:fontcmds}
240
241 \luatexko를 부르면 fontspec 패키지도 자동 불러온다. 글꼴 설정은
242 fontspec 문서 참조.
243
244 한국어 글꼴을 위해 새로 마련한 명령은 다음과 같다.
245 %\pkgkwd*{\setmainhangulfont}%
246 %\pkgkwd*{\setsanshangulfont}%
247 %\pkgkwd*{\setmonohangulfont}%
248 %\pkgkwd*{\newhangulfontfamily}%
249 %\pkgkwd*{\newhangulfontface}%
250 %\pkgkwd*{\addhangulfontfeature}%
251 %\pkgkwd*{\hangulfontspec}
252 첫 두 줄, 즉 main/sans 글꼴들에는 |Ligatures=TeX| 옵션이 자동으로 주어진다.%
253 \footnote{%
254 \cs{adhochangulfont} \cs{adhochanjafont} \cs{addhocfallbackfont}는
255 마지막 줄 명령들의 다른 이름들이다. }
256 \begin{verbatim}
257 \setmainhangulfont \setmainhanjafont \setmainfallbackfont
258 \setsanshangulfont \setsanshanjafont \setsansfallbackfont
259 \setmonohangulfont \setmonohanjafont \setmonofallbackfont
260 \newhangulfontfamily \newhanjafontfamily \newfallbackfontfamily
261 \newhangulfontface \newhanjafontface \newfallbackfontface
262 \addhangulfontfeature \addhanjafontfeature \addfallbackfontfeature
263 \hangulfontspec \hanjafontspec \fallbackfontspec
264 \end{verbatim}
265
266 \begin{plaintex}
267 플레인텍에서 한글 글꼴 설정은 다음과 같이 할 수 있다.
268 명시적 설정이 없으면 \hemph{은바탕}을 기본으로 로드한다.
269 \begin{verbatim}
270 \hangulfont=UnDotum\relax
271 \hanjafont="Noto Sans CJK KR" at 10pt
272 \fallbackfont=HanaMinA at 10pt
273 \end{verbatim}
274
275 또한 다음 명령들도 제공한다:
276 \begin{verbatim}
277 \sethangulfont\taza=UnTaza at 12pt
278 \sethanjafont\dotum=UnDotum at 12pt
279 \setfallbackfont\noto={Noto Sans CJK KR} at 12pt
280 \end{verbatim}
281
282 그리하여 다음처럼 지시할 수 있게 된다:
283 \begin{verbatim}
284 \expandafter\def\expandafter\tt\expandafter{\tt\taza\dotum\noto}
285 \end{verbatim}
286 \end{plaintex}
287
288 \section{글꼴 대체}\label{sec:fontswitch}
289
290 원칙적으로 \luatexko는 지시된 글자가 영문폰트에 없으면 한글폰트에서,
291 한글폰트에도 없으면 한자폰트에서, 한자폰트에도 없으면 fallback
292 폰트에서 글자를 찾아 찍는다.%
293 \footnote{%
294 이 기능이 작동하지 않아 한글이 식자되지 않는다면 최후수단으로
295 \cs{luatexkohangulfont}를 선언할 수 있다.
296 당해 지점의 한글폰트를 메인 폰트로 잠시 지정하는 명령이다.
297 \cs{luatexkohanjafont}와 \cs{luatexkofallbackfont}도 각각 상응하는 기능을 한다.
298 }
299 한글폰트가 지정되지 않았고 기본폰트에 한글 글리프가 없다면
300 \hemph{은바탕, 은돋움 트루타입}을 자동으로 불러온다.%
301 \footnote{%
302 은글꼴 트루타입은 \texlive에 포함되어 있다. }
303
304 하지만 \pkgkwd{\hangulbyhangulfont}|=1|을 선언하면 한글은 우선 한글폰트로
305 식자한다. 또한 \pkgkwd{\hanjabyhanjafont}|=1|을 선언하면 한자는 우선 한자폰트로
306 식자한다. 두 경우 모두 |0|을 선언하면 원래 방식으로 되돌아간다.
307 문단 중간에서 사용해도 동작한다. \sout{그러나 루아코드가 실행되므로
308 텍의 그룹에 의해 영향받지 않는 전역적 효과를 가진다.}
309
310 일정한 영문 문장부호들은 한글 폰트로 식자된다.
311 즉, \pkgkwd{\hangulpunctuations}|=1|이 기본으로 작동하고,
312 |0|을 지시해야 이 기능이 비로소 꺼진다.
313 verbatim 코드를 식자할 때는 이 기능이 작동하지 않으며,%
314 \footnote{%
315 정확히 말하자면 |\\language=\\l@nohyphenation| \hparen{플레인텍에서는 \cs{language=-1}인 경우},
316 즉 하이프네이션이 허용 안 되는 상황에서는 작동하지 않는다.
317 부연하건대, |\\language=\\l@nohyphenation| 상황에서 작동하지 않는
318 그밖의 기능은 다음과 같다: 줄바꿈 허용, InterCharacter, InterHangul,
319 InterLatinCJK, CompressPunctuations, RemoveClassicSpaces,
320 한글^^b7한자 다음의 공백 크기 조정 등. 마지막의
321 한글^^b7한자 다음의 공백 크기 조정은 영문자가 고정폭 글꼴일 때에도
322 작동하지 않는다. }
323 문장부호가 고정폭 글꼴이거나 tfm 폰트일 때에도 작동하지 않는다.
324 영향 받는 문장부호들의 기본값은 다음과 같다:
325 \begin{verbatim}
326 [0x21] ! [0x27] ' [0x28] ( [0x29] )
327 [0x2C] , [0x2E] . [0x3A] : [0x3B] ;
328 [0x3F] ? [0x60] ` [0xB7] · [0x2014] —
329 [0x2015] ― [0x2018] ‘ [0x2019] ’ [0x201C] “
330 [0x201D] ” [0x2026] … [0x203B] ※
331 \end{verbatim}
332 다음과 같은 명령으로 이 목록에 문자를 추가하거나 제거할 수 있다.%
333 \pkgkwd*{\registerpunctuations}%
334 \pkgkwd*{\unregisterpunctuations}
335 인자는 콤마로 분리된 숫자 형식으로서 유니코드 코드포인트를 뜻한다.
336 \begin{verbatim}
337 \registerpunctuations{45, "2D, `-}
338 \unregisterpunctuations{"2D, "2015}
339 \end{verbatim}
340 이상 문장부호 관련 명령들은 문단 중간에서도 쓸 수 있지만, 전역적 효과를 가진다.
341 다시 말해서 그룹 안에서 \cs{hangulpunctuations=0}을 선언했더라도
342 \cs{hangulpunctuations=1}을 선언할 때까지는 그룹이 끝나도 영문 문장부호가 찍힌다.
343
344 \section{줄바꿈 허용}\label{sec:break}
345
346 어떤 글자 앞이나 뒤에서 줄바꿈을 허용하고 싶을 때 아래와 같이 명령을 준다.%
347 \pkgkwd*{\registerbreakableafter}%
348 \pkgkwd*{\registerbreakablebefore}
349 이들 명령을 문단 중간에서 사용하면 문단의 처음부터 전역적 효력을 가진다.
350 \begin{verbatim}
351 \registerbreakableafter{"2460, "2461}
352 \registerbreakablebefore{"2460, "2461}
353 \end{verbatim}
354 \luatexko는 다분히 보수적으로 줄바꿈을 허용하고 있다.
355 예시한 유니코드는 `①'과 `②'인데 기본적으로
356 이들 문자 앞뒤 모두에서 줄바꿈이 되지 않는다.
357
358 \section{글꼴 옵션}\label{sec:fontoption}
359
360 fontspec의 글꼴 옵션 외에 \luatexko가 따로 제공하는 것들이 있다.%
361 \footnote{%
362 옛한글 식자를 위해서는 적어도 |Script=Hangul|
363 \hparen{플레인텍이라면 |script=hang|}을 주어야 한다.
364 옛한글이 아니더라도 한글폰트에는 이 옵션과 |Language=Korean|
365 \hparen{플레인텍은 |language=KOR|}을 주는 것이 좋다. }
366
367 \def\hunmintxt{%
368 \noindent\textbf{%
369 世솅〮宗조ᇰ御ᅌᅥᆼ〮製졩〮訓훈〮民민正져ᇰ〮音ᅙᅳᆷ
370 }\par
371 製졩〮ᄂᆞᆫ〮글〮지ᅀᅳᆯ〮씨〮니〮御ᅌᅥᆼ〮製졩〮ᄂᆞᆫ〮님〯금〮지〯ᅀᅳ샨〮그〮리라〮%
372 訓훈〮은〮ᄀᆞᄅᆞ칠〮씨〮오〮民민ᄋᆞᆫ〮百ᄇᆡᆨ〮姓셔ᇰ〮이〮오〮音ᅙᅳᆷ은〮소리〮니〮%
373 訓훈〮民민正져ᇰ〮音ᅙᅳᆷ은〮百ᄇᆡᆨ〮姓셔ᇰ〮ᄀᆞᄅᆞ치〮시논〮正져ᇰ〮ᄒᆞᆫ소리〮라〮
374 \par\medskip
375 \noindent\textbf{%
376 國귁〮之징語ᅌᅥᆼ〯音ᅙᅳᆷ이〮
377 }\par
378 國귁〮ᄋᆞᆫ〮나라〮히라〮之징ᄂᆞᆫ〮입〮겨〮지라〮語ᅌᅥᆼ〯는말〯ᄊᆞ미라〮
379 \par
380 나랏〮말〯ᄊᆞ미〮
381 \par\medskip
382 \noindent\textbf{%
383 異잉〮乎ᅘᅩᆼ中듀ᇰ國귁〮ᄒᆞ〮야〮
384 }\par
385 異잉〮ᄂᆞᆫ〮다ᄅᆞᆯ씨라乎ᅘᅩᆼᄂᆞᆫ〮아〯모〮그ᅌᅦᄒᆞ〮논겨〮체ᄡᅳ〮는字ᄍᆞᆼ〮ㅣ라〮%
386 中듀ᇰ國귁〮ᄋᆞᆫ〮皇ᅘᅪᇰ帝뎽〮겨〯신나라〮히니〮우〮리〮나랏〮常쌰ᇰ談땀애〮%
387 江가ᇰ南남이〮라〮ᄒᆞ〮ᄂᆞ〮니라〮
388 \par
389 中듀ᇰ國귁〮에〮달아〮
390 }
391
392 \begin{figure}
393 \fboxsep=1em
394 \fbox{\parbox{\dimexpr\linewidth-2.1em\relax}{\sffamily
395 \parindent1em
396 \hunmintxt
397 }}
398 \caption{옛한글 조판 보기. Noto Sans CJK KR 폰트에
399 |Script=Hangul|과 |Language=Korean| 옵션을 주었다.
400 비록 이름에 KR이 들어있지만, |Script|와 |Language| 옵션만 적절히 지시한다면
401 이 폰트는 모든 CJK 언어를 잘 지원한다.}\label{fig:yethangul}
402 \end{figure}
403
404 \begin{description}
405 \topsep=6pt plus 1pt minus 1pt
406 \parskip=1pt plus 1pt minus 1pt
407 \def\plaintexoption#1{\par\setbox0\vbox to 0pt{\vskip-2ex\vss
408 \hfill\small\textcolor{gray}{\hologo{plainTeX}\unskip:}\,#1}\par
409 \AddToHookNext{para/begin}{\vadjust{\box0}}}
410 \item[InterHangul] %\pkgkwd*{InterHangul}%
411 {\addhangulfontfeature{InterHangul=.5ex}한글 글자 사이의 자간}.
412 아래는 $-0.04$em 만큼 한글 자간을 지시한다.
413 \plaintexoption{|interhangul=|\meta{dimen}}
414 \begin{verbatim}
415 [InterHangul=-0.04em]
416 \end{verbatim}
417
418 \item[InterLatinCJK] %\pkgkwd*{InterLatinCJK}%
419 한글^^b7한자와 Latin문자 사이의 자간을 설정한다.
420 한글^^b7한자 다음에 라틴 문자가 오는 경우 원래 줄바꿈이 되지 않지만
421 이 옵션을 주면 줄바꿈이 가능해진다.
422 \plaintexoption{|interlatincjk=|\meta{dimen}}
423 \begin{verbatim}
424 [InterLatinCJK=0.25em]
425 \end{verbatim}
426
427 \item[InterCharacter] %\pkgkwd*{InterCharacter}%
428 CJK 글자들 사이의 자간을 지시한다.
429 fontspec의 |LetterSpace| 옵션과 기능이 유사하지만, 옛한글을 깨뜨리는 등의
430 오작동을 하지 않는다. 전술한 자간 옵션들보다 후순위로 동작한다.
431 \plaintexoption{|intercharacter=|\meta{dimen}}
432 \begin{verbatim}
433 [InterCharacter=.125em]
434 \end{verbatim}
435
436 \item[InterCharStretch] %\pkgkwd*{InterCharStretch}%
437 CJK 글자간 가변공백\hparen{글루}의 stretch\hparen{늘이기} 값을 지시한다.
438 \plaintexoption{|intercharstretch=|\meta{dimen}}
439 \begin{verbatim}
440 [InterCharStretch=0.5pt]
441 \end{verbatim}
442
443 \item[InterCharPenalty] %\pkgkwd*{InterCharPenalty}%
444 CJK 글자간 가변공백\hparen{글루} 직전에 삽입되는 penalty의 값을 지시한다.
445 |-10000|부터 |10000|까지의 값을 줄 수 있는데,
446 양수값은 글자간 개행을 억제하고 음수값은 글자간 개행을 권장한다.
447 기본값은 |50|으로, 글자간 개행을 조금 억제하여 단어간 개행을 조금 선호하는 결과를 낳는다.
448 옵션값을 |0|으로 주면 이러한 차이가 사라져 글자간 개행이 더 빈번하게 일어난다.
449 \plaintexoption{|intercharpenalty=|\meta{number}}
450 \begin{verbatim}
451 [InterCharPenalty=0]
452 \end{verbatim}
453
454 \item[CharRaise] %\pkgkwd*{CharRaise}%
455 글자의 세로 위치를
456 {\addhangulfontfeature{CharRaise=.3em} 조절}할 수 있는 기능이다.
457 이로써 주변에 식자되는 다른 글꼴과 조화를 이루게 한다.
458 \plaintexoption{|charraise=|\meta{dimen}}
459 \begin{verbatim}
460 [CharRaise=2pt]
461 \end{verbatim}
462 세로쓰기에서는 모든 글자들을 지정한 값만큼 오른쪽으로 이동시킨다.%
463 \footnote{세로쓰기에서는 이 옵션값을 고정길이\hparen{가령 |pt| 단위}로 주어야
464 크기가 다른 폰트들 간에 중앙정렬이 유지된다. }
465
466 \def\plaintexoption#1#2{{\unskip\nobreak\hfil\penalty50\hskip2em
467 \null\nobreak\hfil\raise#2\hbox{\small\textcolor{gray}{\hologo{plainTeX}\unskip:}\,#1}%
468 \parfillskip=0pt \finalhyphendemerits=0 \par}}
469 \item[RemoveClassicSpaces] %\pkgkwd*{RemoveClassicSpaces}%
470 고문헌 조판시에 CJK 글자들 사이의 공백을 없애준다.
471 \plaintexoption{|+removeclassicspaces|}{2pt}
472
473 \item[CompressPunctuations] %\pkgkwd*{CompressPunctuations}%
474 CJK 구두점\hparen{낫표 따위}의 글자폭을 반각으로 만든다.
475 버전 2.0부터는 사용자가 지시하지 않는 한 글자폭을 자동으로 줄여주지 않는다.
476 이 옵션은 |CharacterWidth=|\allowbreak|AlternateHalf| 내지 \hparen{세로쓰기의 경우}
477 |Vertical=|\allowbreak|HalfMetrics|와 사실상 같은 기능을 한다.%
478 \footnote{플레인텍에서는 각각 |+halt| 및 |+vhal|이다. 이들과 완전 동일하진
479 않다. 가령 U+00B7\hparen{^^b7} 및 고문헌조판 모드에서
480 U+2018\hparen{^^^^2018} U+2019\hparen{^^^^2019} U+201C\hparen{^^^^201c} U+201D\hparen{^^^^201d}
481 처리의 경우 미세한 간격 차이가 있을 수 있다. }
482 그래서 이들 옵션 중 하나가 지시되어 있다면 그것이 우선 적용되고
483 |CompressPunctuations|는 \hparen{설령 명시되었더라도} 아무 작용도 하지 않는다.%
484 \footnote{그러나 HarfBuzz 모드 세로쓰기에서는 |vhal| 대신 |CompressPunctuations|가 사용된다.}
485 \plaintexoption{|+compresspunctuations|}{2pt}
486
487 \item[Protrusion] %\pkgkwd*{Protrusion}%
488 특정 글자가 행 끝에 왔을 때 판면 바깥으로 끌어내는
489 기능이다. \luatex은 기본으로 온점 반점 등을 완전 글자내밀기 한다.
490 |Protrusion|은 |Protrusion=|\allowbreak|default|와 같은 뜻이다.
491 자신만의 설정을 만들어 지정할 수 있다.%
492 \footnote{default 설정을 고치는 방법은 이를테면 다음과 같다%
493 \hparen{또한 이 매뉴얼의 소스 앞부분을 참고하라}:\par
494 \leftskip=3em\noindent
495 \cs{directlua{ fonts.protrusions.setups.default[0x201C] = { 1, 0 } }} }
496 \plaintexoption{|protrusion=default|}{6pt}
497
498 \item[Expansion] %\pkgkwd*{Expansion}%
499 판면의 균일한 조판을 위해 글자들을 미세하게 늘이거나
500 줄이는 기능이다. |Expansion|은 |Expansion=|\allowbreak|default|와 같은 뜻이다.
501 \plaintexoption{|expansion=default|}{0pt}
502
503 \end{description}
504
505 \section{고문헌}\label{sec:classic}
506
507 고문헌 조판을 위해 \pkgkwd{typesetclassic} 환경을 제공한다.
508 전처리부에 \cs{typesetclassic}을 선언할 수도 있다.%
509 \footnote{%
510 |japanese|, |chinese|, |Schinese|, |Tchinese|, |korean| 따위의 환경은
511 지난 버전과의 호환성을 위해 제공되고 있을 뿐이다.
512 그렇더라도 중국어나 일본어 폰트를 사용한다면 이들 환경을 사용하는 것이 좋다.
513 |chinese|는 |Schinese|와 동의어이다. }
514 그림~\ref{fig:gomun} 참조.
515 버전 2.0부터는 고문헌 조판에서 한글^^b7한자와 영문자가 붙어 나오더라도 자동으로
516 간격을 조정해주지 않으므로 사용자가 |InterLatinCJK| 옵션을
517 지정해야 한다.
518 또한 불필요한 공백이 오더라도 자동으로 제거해주지 않으므로
519 사용자가 |RemoveClassicSpaces| 옵션을 주어야 한다.
520
521 \pkgkwd{typesetmodern} 환경은 고문헌 조판 중에 잠깐 현대 한국어를 조판하는 데
522 사용한다.
523
524 고문헌 조판 중 \luatexko가 글자 사이에 삽입하는 미세간격을
525 영\hparen{零}으로 강제하기 위해서는 \pkgkwd{\inhibitglue} 명령을 사용한다.
526
527 \def\analectstext{\addhangulfontfeature{RemoveClassicSpaces}
528 子 曰:「學而時習之,不亦說乎?有朋自遠方來,不亦樂乎?人不知而不慍,不亦君子乎?」\par
529 有子 曰:「其爲人也孝弟,而好犯上者,鮮矣!不好犯上,而好作亂者,未之有也!君子務本,本立而道生;孝弟也者,其爲仁之本與?」\par
530 子 曰:「巧言令色,鮮矣仁!」\par
531 曾子 曰:「吾日三省吾身:爲人謀,而不忠乎?與朋友交,而不信乎?傳,不習乎?」\par
532 子 曰:「道千乘之國,敬事而信,節用而愛人,使民以時。」\par
533 子 曰:「弟子入則孝,出則弟;謹而信,汎愛衆;而親仁,行有餘力,則以學文。」
534 }
535 \begin{figure}
536 \centering
537 \fbox{\parbox{37em}{\typesetclassic\sffamily
538 \analectstext
539 }}
540 \caption{고문헌 조판 보기. typesetclassic 환경을 이용했다.
541 글꼴에 |CompressPunctuations|와 |RemoveClassicSpaces| 옵션을 주었다.
542 }\label{fig:gomun}
543 \end{figure}
544
545 \begin{plaintex}
546 고문헌 조판을 하려면 \hparen{문서 전체에 적용하지 않는다면 그룹 안에서}
547 \cs{typesetclassic}.
548
549 잠깐 현대 한국어를 조판하려면 \hparen{그룹 안에서}
550 \cs{typesetmodern}.
551 \end{plaintex}
552
553 \section{세로쓰기}\label{sec:verttype}
554
555 세로쓰기는 폰트의 고급 오픈타입 속성을 이용하므로 폰트가 이를 지원해야
556 가능한 일이다. 폰트에 |Vertical=Alternates|와 \pkgkwd{RawFeature=vertical}
557 옵션을 준다.%
558 \footnote{%
559 이는 플레인텍에서 |vertical;+vert| 옵션을 주는 것과 같다.
560 사실 |vertical|을 선언하면 |vert|는 자동으로 켜지도록 해 두었다. }\,%
561 \footnote{%
562 |vmtx| 정보를 가지고 있지 않은 글꼴은 세로쓰기에 적합치 않은 글꼴이다.
563 |otfinfo -t| \meta{파일} 명령으로 글꼴에 들어있는 테이블 정보를 알 수 있다. }\,%
564 \footnote{%
565 폰트 옵션 |Renderer=HarfBuzz| 또는 |Renderer=OpenType| 등%
566 \hparen{플레인텍에서는 |mode=harf| 옵션}을 주고
567 컴파일하여 HarfBuzz 모듈을 이용하는 경우에도 세로쓰기가 \hemph{지원된다}.
568 하지만 |Renderer=Node|를 이용한 세로쓰기에 비해 아직은 실험 단계에 머물러 있다.
569 다만, 혹시 |extend| \hparen{\LaTeX에서는 |FakeStretch|}나 |squeeze| 옵션으로
570 글자를 늘이거나 짜부라지게 하려면 이는 현재 HarfBuzz 모드에서만 정상 작동됨에 유의하라.}\,%
571 \footnote{%
572 세로쓰기에서는 \cs{typesetclassic}의 아종인 \cs{typesetvertical}이
573 기본으로 셋팅되어 있다. 일종의 고문헌 조판으로 보는 것이다.
574 }
575 세로쓰기에서 |CharRaise| 옵션의 효과에 대해서는 제\ref{sec:fontoption}절을
576 참조.
577
578 \begin{itemize}
579 \item 문서의 일부를 세로쓰기하려면
580 |\begin{|\pkgkwd{vertical}|}{|\meta{dimen}|}| \ldots\ |\end{vertical}|
581 환경을 이용한다. 인자 \meta{dimen}으로 세로쓰기 박스의 높이를 지시한다.
582 그림~\ref{fig:vertical},~\ref{fig:vertical3} 및 \ref{fig:vertical2} 참조.
583 만약 인자가 비어있거나 \cs{empty}이면 본문을 한 줄짜리 박스로 식자하며,
584 이때 높이는 natural height가 된다.
585
586 \begin{figure}
587 \fboxsep=5pt
588 \framebox[\linewidth]{
589 \begin{vertical}{20em}
590 \linespread{1.5}\sffamily \verticalhangulfont
591 \hunmintxt
592 \end{vertical}
593 }
594 \caption{세로쓰기의 예. 박스 높이 |20em|을 지시했다.
595 권장하지 않는다지만 |Renderer=HarfBuzz|를 세로쓰기 폰트 옵션에 넣어봤다.
596 }\label{fig:vertical}
597 \end{figure}
598
599 \begin{figure}
600 \fboxsep=5pt
601 \framebox[\linewidth]{
602 \begin{vertical}{17em}
603 \linespread{1.5}\sffamily \verticalhangulfont
604 \parindent0pt \everypar{\hangindent1em \hangafter1 }
605 \analectstext
606 \end{vertical}
607 }
608 \caption{세로쓰기의 다른 예. 박스 높이 |17em|을 지시했다.
609 글꼴에 |CompressPunctuations| 및 |RemoveClassicSpaces|와 더불어
610 |InterCharStretch=1pt|를 옵션으로 주었다. 공백이 없는 문서는 자간늘이기 값을
611 넉넉하게 주는 것이 좋다.
612 |Protrusion| 옵션으로 구두점들이 행 끝에 매달린 것도 볼 수 있다.
613 |CompressPunctuations|로 이미 반각이 강제되고 있으므로 글자내밀기 값으로 |0.5|를
614 주어야 전부 내밀기가 된다.
615 }\label{fig:vertical3}
616 \end{figure}
617
618 \begin{figure}
619 \fboxsep=5pt
620 \framebox[\linewidth]{
621 \begin{vertical}{17em}
622 \linespread{1.5}\sffamily \verticalhangulfont
623 \addhangulfontfeature{CharacterWidth=Full}
624 \parindent0pt \everypar{\hangindent1em \hangafter1 }
625 \spaceskip=.5em plus.25em minus.125em
626 \quad 님의 침묵(The Silent Beloved)
627 \smallbreak
628 \hfil\hfil 한 용 운\hfil
629 \bigbreak
630 님은 갓슴니다 아아 사랑하는나의님은 갓슴니다\par
631 푸른산빗을깨치고 단풍나무숩을향하야난 적은길을 거러서 참어떨치고
632 갓슴니다\par
633 黃金의꽃가티 굿고빗나든 옛盟誓는 차듸찬띠끌이되야서 한숨의 微風에
634 나러갓슴니다\par
635 날카로은 첫〈키쓰〉의追憶은 나의運命의指針을 돌너노코 뒷거름처서 사러젓슴니다\par
636 \hellipsis\par
637 아아 님은갓지마는 나는 님을보내지 아니하얏슴니다\par
638 제곡조를못이기는 사랑의노래는 님의沈默을 휩싸고돔니다\par
639 \end{vertical}
640 }
641 \caption{세로쓰기의 또 다른 예. 박스 높이 |17em|을 지시했다.
642 HarfBuzz 모드에서 Noto Sans CJK 글꼴의 세로쓰기 공백은 원래 |1em|,
643 즉 전각크기로 매우 크기 때문에, 여기서는 \cs{spaceskip} 명령을 이용하여
644 반각 크기로 강제했다. 아스키 괄호를 전각으로 바꾸기 위해
645 |CharacterWidth=Full| 옵션도 추가로 지시했는데,
646 이 옵션은 Node 모드에서도 공백 크기에 영향을 미칠 수 있다.
647 }\label{fig:vertical2}
648 \end{figure}
649
650 \item 문서 전체를 세로쓰기한다면
651 \pkgkwd{\verticaltypesetting} 명령을 전처리부에 선언한다.
652 이때 면주는 가로로 식자되며 면주 폰트의 설정은 사용자의 몫이다.
653
654 \item 몇몇 페이지를 세로쓰기로 식자하려면 본문 중에
655 |\begin{|\pkgkwd{verticaltypesetting}|}| \ldots\ |\end{verticaltypesetting}|
656 환경을 이용한다.
657 이때도 면주는 가로로 식자되며, 환경의 시작과 끝에서 쪽나눔이 행해진다.
658
659 \item 세로쓰기 도중에 문서의 일부를 가로쓰기하려면
660 |\begin{|\pkgkwd{horizontal}|}{|\meta{dimen}|}| \ldots\ |\end{horizontal}|
661 환경을 이용한다. \meta{dimen}은 가로쓰기 박스의 너비를 지시한다.
662 만약 인자가 비어있거나 \cs{empty}이면 본문을 한 줄짜리 박스로 식자하며,
663 이때 너비는 당연히 natural width가 된다.
664 \end{itemize}
665
666 \begin{plaintex}
667 문서 일부 세로쓰기는 |\vertical{|\meta{dimen}|}| \ldots\ |\endvertical|.
668 인자는 비워둘 수 있다.
669
670 문서 전체 세로쓰기는 문서 첫머리에 \cs{verticaltypesetting}.
671
672 몇몇 페이지의 세로쓰기는 \cs{beginverticaltypesetting} \ldots\ \cs{endverticaltypesetting}.
673
674 세로쓰기 중 가로쓰기는 |\horizontal{|\meta{dimen}|}| \ldots\ |\endhorizontal|.
675 인자는 비워둘 수 있다.
676 \end{plaintex}
677
678 \section{드러냄표}\label{sec:dotemph}
679
680 \pkgkwd{\dotemph} 명령으로 \dotemph{드러냄표}%
681 를 이용한 강조를 할 수 있다. 기본은 글자 위에 점을 찍는 형태이나
682 다음과 같이 명령을 주어 개인적으로 선호하는 기호를 드러냄표로 쓸 수
683 있다.
684
685 \begin{itemize}
686 \item |\def|\pkgkwd{\dotemphraise}|{0.4em }|:
687 드러냄표를 피강조 글자 위로 끌어올리는 길이
688 \item |\def|\pkgkwd{\dotemphchar}|{\bfseries ^^^^02d9}|: 드러냄표 기호 자체를 정의.
689 \end{itemize}
690
691 \section{루비}\label{sec:ruby}
692
693 루비를 달 수 있다. ruby 패키지가 이미 존재하지만 \luatexko와 궁합이 잘
694 맞지 않아 새로 매크로를 제공한다.%
695 \pkgkwd*{\ruby}
696 \begin{sourceandresult}
697 \srcres{\ruby{漢字}{한자}}
698 \end{sourceandresult}
699 이처럼 글자별로 따로 루비를 달 필요가 없다. 관련 설정은 다음처럼
700 한다.
701
702 \begin{itemize}
703 \item \pkgkwd{\rubyfont}: 루비를 식자할 폰트를 지시해 둔다. 기본값은 현재 폰트%
704 \footnote{%
705 루비는 글자 크기가 작기 때문에 본문 폰트보다 약간 굵은 폰트로
706 지정하는 것이 좋을 수도 있다. }
707
708 \item |\def|\pkgkwd{\rubysize}|{0.6}|:
709 루비 글자 크기를 본문 글자 크기에 대한 비율로 지정%
710 \footnote{%
711 플레인텍에서는 루비의 글꼴크기를 따로 조정해주지 않는다.
712 사용자가 \cs{rubyfont}를 설정할 때 크기도 함께 지시하도록 한다.
713 가령: |\\font\\rubyfont=UnBatang at \\rubysize em| }
714
715 \item |\def|\pkgkwd{\rubysep}|{0.1ex}|: 루비와 본문 글자 사이의 간격을 지정
716
717 \item \pkgkwd{\rubynooverlap}: 루비의 폭이 본문 글자의 폭보다 클 때 루비가 이웃
718 글자들 위로 삐져나가지 못하게 한다. 본문 글자의 흐름을 중시하여
719 \pkgkwd{\rubyoverlap}을 기본값으로 하였으므로 이는 따로 선언할 필요가 없다.
720 \end{itemize}
721
722 한편, 연속된 본문 글자들에 각각 한 글자씩 루비를 달고자 한다면
723 \pkgkwd{\xxruby}|{...}{...}| 명령을 사용한다.\footnote{%
724 |lua-uni-algos| 패키지를 설치해두어야 한다.
725 }
726 글자들 사이에 줄바꿈이 \xxruby{허용}{許容}된다.
727 두 인자의 글자 수가 동일해야 한다.
728
729 \section{밑줄긋기}\label{sec:uline}
730
731 ulem 패키지가 \luatexko와 궁합이 맞지 않아\hparen{줄바꿈에 문제가 있음}
732 명령을 따로 제공한다.
733 %\pkgkwd*{\uline}%
734 %\pkgkwd*{\sout}%
735 %\pkgkwd*{\uuline}%
736 %\pkgkwd*{\xout}%
737 %\pkgkwd*{\uwave}%
738 %\pkgkwd*{\dashuline}%
739 %\pkgkwd*{\dotuline}
740
741 \begin{sourceandresult}
742 \setbox0\hbox{\ttfamily\string\dotuline\{밑줄을 점선으로 긋는다\}}\dimen0=\wd0
743 \def\srcres#1#2{\leavevmode \hbox to\dimen0
744 {\ttfamily\string#1\{#2\}\hss}\quad ⇒\quad #1{#2}\par}
745 \srcres \uline{밑줄을 그을 수 있다}
746 \srcres \uuline{밑줄을 두 줄 긋는다}
747 \srcres \uwave{물결표로 밑줄을 삼는다}
748 \srcres \sout{취소선을 그을 수 있다}
749 \srcres \xout{빗금으로 취소할 수 있다}
750 \srcres \dashuline{대시로 밑줄을 삼는다}
751 \srcres \dotuline{밑줄을 점선으로 긋는다}
752 \end{sourceandresult}
753 참고로, |\uline{\uline{...}}|으로도 \cs{uuline{...}}과 동일한 효과를 볼 수 있으며
754 사실 이쪽이 \cs{uuline}보다 더 \uline{\uline{효율적}}이다.
755
756 이들 명령 가운데 밑줄에 관련된 것에는 다음 설정을 할 수 있다.
757
758 \begin{itemize}
759 \item |\def|\pkgkwd{\ulinedown}|{0.5ex}|: 밑줄을 베이스라인 아래로 끌어내리는 정도
760 \item |\def|\pkgkwd{\ulinewidth}|{0.04em}|: 밑줄의 굵기
761 \end{itemize}
762
763 이상의 밑줄 양식들을 만드는 데는 예외없이
764 \pkgkwd{\markoverwith} 명령이 사용되었다.
765 따라서 사용자는 이를 이용해 원하는 양식을 만들 수 있다.
766 가령 노란색 마커펜을 흉내내려면,%
767 \footnote{%
768 이 명령의 인자로 들어갈 수 있는 것은 box와 rule에 국한된다.
769 예시에서는 박스를 넣었다.}\,%
770 \footnote{%
771 별표 붙은 명령 \cs{markoverwith*}는 \cs{xleaders}를 실행하고,
772 예시처럼 별표가 없으면 \cs{cleaders}를 실행한다. }
773 \begin{verbatim}
774 \def\ymarker{%
775 \markoverwith{%
776 \hbox{{\color{yellow!50}\vrule width 1pt height 9pt depth 2pt}}%
777 }}
778 \end{verbatim}
779
780 \ExplSyntaxOn
781 \tag_if_active:T
782 {
783 \tagpdfsetup
784 {
785 role/new-attribute = {TextDeco-HalfYellowBg}{/O~/Layout~/BackgroundColor~[1.0~1.0~0.5]},
786 }
787 \NewTaggingSocketPlug{luatexko/markoverwith/begin}{yellowmarker}
788 {
789 \leavevmode
790 \tag_mc_end_push:
791 \tag_struct_begin:n{tag=Em, attribute=TextDeco-HalfYellowBg}
792 \tag_mc_begin:n{}
793 }
794 }
795 \cs_new_nopar:Npn \ymarker
796 {
797 \tag_if_active:T
798 {
799 \begingroup
800 \AssignTaggingSocketPlug{luatexko/markoverwith/begin}{yellowmarker}
801 \AddToHookNext{cmd/luatexkomarkoverwith/after}{\endgroup}
802 }
803 \markoverwith{\hbox{{\color{yellow!50}\vrule~width~1pt~height~9pt~depth~2pt}}}
804 }
805 \ExplSyntaxOff
806 \begin{sourceandresult}
807 \srcres{\ymarker{노란색을 칠해서 강조한다}}
808 \end{sourceandresult}
809
810 \section{자동조사}\label{sec:autojosa}
811
812 자동조사는 \kotex 과 동일하게 \cs{은} \cs{는} \cs{이} \cs{가} \cs{을} \cs{를}
813 \cs{와} \cs{과} \cs{로} \cs{으로} \cs{라} \cs{이라} 따위를 사용한다.
814 버전 1.3부터는 \pkgkwd{\josaignoreparens}|=1|이 선언되어 있으면 자동조사는
815 \hemph{괄호 부분을 건너뛰고} 그 앞 글자에 매칭한다.
816 |0|이 선언되면 원래 방식으로 돌아간다.
817 \begin{sourceandresult}
818 \def\setjprn#1{\leavevmode\texttt{\string#1}#1\par}
819 \setjprn{\josaignoreparens=1}
820 \srcres{홍길동(1992)\는}
821 \srcres{홍길동(2001)\로}
822 \setjprn{\josaignoreparens=0}
823 \srcres{홍길동(1992)\는}
824 \srcres{홍길동(2001)\로}
825 \end{sourceandresult}
826
827 \section{루아 모듈의 제거 및 복원}\label{sec:luamodule}
828
829 루아 코드 |luatexko.deactivateall()|은 이상 언급한 \luatexko 의 거의 모든
830 기능을 무력화한다. |luatexko.reactivateall()|은 이를 복원한다.%
831 \footnote{수직 모드\hparen{문단과 문단 사이}에서 사용할 것.
832 수평 모드에서는 정상작동을 보장하지 못한다.}
833 다른 패키지와 충돌할 때 시도해 볼 수 있다.
834 전자의 함수에는 문자열을 인자로 줄 수도 있는데, 해당하는 다른 패키지의
835 모듈들을 잠시 제거할 수 있다.
836
837 \section{수식 한글}\label{sec:mathhangul}
838
839 \begin{sourceandresult}
840 \srcres{$가^{나^다}$}
841 \end{sourceandresult}
842 수식 한글 폰트를 설정하면 수식 모드에서도 한글을 \hparen{hbox로 감싸지 않고}
843 직접 입력할 수 있다.%
844 \footnote{%
845 \cs{hbox}를 쓰지 않고 직접 입력하는 수식 한글이
846 \uline{디스플레이 수식} 안에 사용된 경우,
847 앞서 기술한 드러냄표 강조, 밑줄 강조, 한글 글꼴 옵션 등의 기능이 현재로는
848 전혀 작동하지 않는다. 구현은 비교적 간단하지만, 과연 수식에서
849 저러한 기능을 써야 할 경우가 있을까 의문이기 때문이다.
850 사용자의 요청이 있으면 즉시 반영하겠다.
851 }
852 버전 2.0부터는 자동으로 수식 한글을 잡아주지 않는다.%
853 \pkgkwd*{\setmathhangulfont}
854 \begin{verbatim}
855 \setmathhangulfont{Noto Sans CJK KR}
856 [
857 SizeFeatures={
858 {Size=-6, Font=* Medium},
859 {Size=6-9, Font=* Regular},
860 {Size=9-, Font=* DemiLight},
861 }
862 ]
863 \end{verbatim}
864
865 현재 한글만 쓸 수 있게 설정되어 있다. 한자도 수식에 직접 입력하려면 사용자는
866 다음 명령으로 유니코드 블럭을 추가 지정해야 한다.%
867 \pkgkwd*{\setmathhangulblock}
868 \begin{verbatim}
869 \setmathhangulblock{4E00}{9FC3}
870 \end{verbatim}
871
872 \begin{plaintex}
873 플레인텍에서는 \cs{mathhangulfont=UnBatang}과 같이 설정한다.
874
875 또는 좀 더 그럴듯하게 하려면:
876 \begin{verbatim}
877 \font\texthangul="Noto Sans CJK KR DemiLight" at 10pt
878 \font\scripthangul="Noto Sans CJK KR Regular" at 7pt
879 \font\scriptscripthangul="Noto Sans CJK KR Medium" at 5pt
880 \setmathhangulfonts\texthangul\scripthangul\scriptscripthangul
881 \end{verbatim}
882 \end{plaintex}
883
884 \section{한국어 항목 번호}\label{sec:hangulnums}
885
886 \kotex과 동일하게 항목 번호를 한국어 기호로 붙일 수 있다.
887 가용한 숫자에 제한이 있지만
888 \cs{jaso} \cs{gana} \cs{ojaso} \cs{ogana} \cs{pjaso} \cs{pgana}
889 \cs{onum} \cs{pnum} \cs{oeng} \cs{peng} \cs{hnum} \cs{Hnum}
890 \cs{hroman} \cs{hRoman} \cs{hNum} \cs{hanjanum} 따위를 지원한다%
891 \hparen{|cjk-ko| 문서 참조}.
892
893 이를테면 \cs{onum{page}}라고 하면 현재 쪽의 번호를 \onum{page}\로 찍는다.
894 따라서 가령 제2단계 enumerate 환경의 항목번호 양식을 바꾸려면
895 \cs{def}\allowbreak\cs{labelenumii}\allowbreak|{\onum{enumii}}|처럼 선언할 수 있다.
896 또한 \cs{pagenumbering}\allowbreak|{onum}|처럼 선언해서 쪽번호 양식을 바꿀 수도 있다.
897
898 \section{입력 변환}\label{sec:normalize}
899
900 \pkgkwd{\luatexhangulnormalize}|=1|이라 지시하면 첫가끝 자모를 완성형 음절로,
901 |2|라면 완성형 음절을 첫가끝 자모로 인코딩 변환한다. |0|이 할당되면
902 인코딩 변환 기능이 꺼진다.%
903 \footnote{%
904 변환기능은 |lua-uni-algos| 패키지를 이용하므로
905 이 패키지를 설치해두어야 한다. }\,%
906 \footnote{%
907 HarfBuzz 모드에서는
908 첫가끝 자모로의 입력변환이 효과를 못볼 수도 있으니 유의할 것.
909 }
910 \XeTeX의 \cs{XeTeXinputnormalization} 명령과 유사하다.
911
912 \section{UHC 입력 인코딩}\label{sec:uhcencoding}
913
914 권장하지 않지만 불가피하게 입력 인코딩이 UHC \hparen{Unified Hangul Code}%
915 \footnote{%
916 CP949라고도 하며 EUC-KR을 포함한다. }%
917 로 되어 있는 파일을 처리할 때는 \pkgkwd{\luatexuhcinputencoding}|=1|을 선언한다.
918 |0|을 할당하면 다시 UTF-8 입력으로 간주한다. \XeTeX의 \cs{XeTeXinputencoding}
919 명령과 유사하나, 오직 한국어 문자만 처리할 수 있다.
920
921 \begin{center}
922 \actualtag{본문 끝}{*\qquad *\qquad *}
923 \end{center}
924
925 \section*{주요 변경 이력}
926
927 \begin{itemize}\linespread{1.1}\small
928 \item[v5.5] ------
929 \item \hyperref[sec:fontoption]{글꼴 옵션 |InterCharPenalty| 추가}
930 \item[v5.0] ------
931 \item \hyperref[sec:ruby]{\cs{xxruby} 명령 개선} \hparen{|lua-uni-algos| 패키지 설치 필요}
932 \item[v4.9] ------
933 \item \hyperref[sec:verttype]{HarfBuzz 폰트의 세로쓰기 지원} \hparen{권장하지는 않음}
934 \item[v4.0] ------
935 \item \LaTeX 의 Tagged PDF 기능 지원
936 \item[v3.2] ------
937 \item 한자 뒤에서도 자동조사 기능이 대체로 동작한다.
938 \hparen{|xetexko| 패키지 설치 필요}
939 \item \hyperref[sec:verttype]{|vertical| 및 |horizontal| 환경의 인자를 비워둘 수 있다}.
940 \item \hyperref[sec:verttype]{|verticaltypesetting|을 환경으로도 쓸 수 있다.
941 플레인텍에서는 \cs{beginverticaltypesetting} \cs{endverticaltypesetting}}.
942 \item \hyperref[sec:fontcmds]{플레인텍 명령
943 \cs{sethangulfont} \cs{sethanjafont} \cs{setfallbackfont} 추가}
944 \item[v3.0] ------
945 \item \hyperref[sec:fontoption]{세로쓰기에서 |CharRaise| 옵션은
946 이제 글자들의 \dotemph{추가적인} 이동 길이를 나타낸다.}
947 \item 기본 로드되는 고정폭 한글 폰트\hparen{UnDotum}의 폭을
948 Latin Modern Mono 폰트에 맞추어 조정
949 \item \hyperref[sec:fontswitch]{영문자가 고정폭 글꼴일 때
950 한글^^b7한자 다음에 공백 크기 조정을 하지 않음}
951 \item \cs{actualtext} 명령 제거
952 \item[v2.6] ------
953 \item \hyperref[sec:fontswitch]{\cs{hangulbyhangulfont} 및
954 \cs{hanjabyhanjafont}가 지역적 효력만 가짐}
955
956 \item[v2.5] ------
957 \item LuaHB\TeX\ 지원 \hparen{세로쓰기 제외}
958
959 \item[v2.2] ------
960 \item \hyperref[sec:fontoption]{글꼴옵션 |InterCharStretch| 제공}
961
962 \item[v2.0] ------
963 \item \hyperref[sec:mathhangul]{수식 한글 글꼴을 자동으로 잡아주지 않음}
964 \item \cs{actualtext} 명령 작동 않음. 대신, 옛한글 텍스트 추출 자동 지원%
965 \footnote{%
966 PDF 리더 어플리케이션이 ActualText 기능을 지원해야 가능하다.
967 어도비 리더는 확실히 가능할 것이다. }
968 \item \hyperref[sec:fontoption]{글꼴옵션 |CompressPunctuations|,
969 |RemoveClassicSpaces|, |InterCharacter| 추가}
970 \item \hyperref[sec:break]{\cs{registerbreakableafter},
971 \cs{registerbreakablebefore} 명령 추가}
972 \end{itemize}
973
974 \end{document}