summaryrefslogtreecommitdiff
path: root/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.tex
blob: 290e417045134c2707029a89a8f11f579cbcc05b (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
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
%!TEX program = SpiX
%$ time cluttex -e xelatex --shell-escape --synctex=1 --tex-option=--8bit --package-support=minted $texname
%%
%% Poorman's Hangul Jamo Input Method
%% pmhanguljamo.sty 사용설명서
%%
%% (C) 2020 Nova de Hi.
%% 		part of pmhanguljamo package.
%%
\documentclass[a4paper,chapter]{oblivoir}

\hypersetup{colorlinks}

\usepackage{fapapersize}
\usefapapersize{*,*,1in,*,1in,*}

\usepackage{kotex-logo}
\usepackage{amssymb}
\usepackage[pmfont={Noto Serif KR}]{pmhanguljamo}
\usepackage{boxedminipage}
\usepackage{tabularray}
\usepackage{amsmath,amssymb}

\usepackage{oblivoir-misc}

\ifXeTeX
\def\fontfeatureoption{Script=Hangul}
\usepackage[normalem]{ulem}
\else\ifLuaTeX
\def\fontfeatureoption{Script=Hangul,RawFeature={mode=harf}}
\fi\fi

%%% [Script=Hangul] is needed to typeset YETHANGUL
\setmainfont{Noto Serif}
\setsansfont{Noto Sans}
%\setmonofont{Droid Sans Mono}
\setmonofont{DejaVu Sans Mono}
\setsansfont{Noto Sans KR}%[\fontfeatureoption]
\setkomainfont(Noto Serif KR)(* Bold)(Noto Sans KR Light)%[\fontfeatureoption]
\setkosansfont(Noto Sans KR)(* Bold)%[\fontfeatureoption]
\setkomonofont(HCR Dotum LVT)[Script=Hangul,Scale=.97]

\usepackage{tcolorbox}
\tcbuselibrary{minted,breakable}
\tcbset{listing engine=minted,colframe=gray,colback=white,size=normal}
\NewDocumentEnvironment {exampleside} {}
  { \tcblisting{listing side text,righthand width=.37\textwidth} }
  { \endtcblisting }
\NewDocumentEnvironment {exampleonly} {}
  { \tcblisting{listing only,breakable} }
  { \endtcblisting }
\NewDocumentEnvironment {examplebelow} {}
  { \tcblisting{breakable} }
  { \endtcblisting }


\newcommand\pkg[1]{%
	\textsf{#1}\index{#1}\index{패키지!#1}%
}

\newcommand\env[1]{%
	\textit{<#1>}\index{환경!#1}\index{#1}%
}

\let\cmda\cmd

\makechapterstyle{obmadsen}{% requires graphicx package
  \chapterstyle{default}
%  \renewcommand*{\chapnamefont}{%
%    \normalfont\Large\scshape\raggedleft}
  \renewcommand*{\prechapternum}{\normalfont\Large\scshape\raggedleft}
  \renewcommand*{\postchapternum}{}
  \renewcommand*{\chaptitlefont}{%
    \normalfont\Huge\bfseries\sffamily\raggedleft}
  \renewcommand*{\chapternamenum}{}
  \renewcommand*{\printchapternum}{%
    \makebox[0pt][l]{\hspace{0.4em}
      \resizebox{!}{4ex}{%
        \chapnamefont\bfseries\sffamily\thechapter}
    }%
  }%
  \renewcommand*{\printchapternonum}{%
    \chapnamefont \phantom{\printchaptername \chapternamenum \printchapternum}
    \afterchapternum %
  }%
  \renewcommand*{\afterchapternum}{%
    \par\hspace{1.5cm}\hrule\vskip\midchapskip}}


%\makeindex
\parindent=0pt

\newcommand\jpwrd[1]{{\fontspec{Noto Sans JP}#1}}

\let\originalobellipsis\obellipsis
\def\obellipsis{{\hangulfontspec{HCR Batang LVT}\originalobellipsis}}

\begin{document}

\title{Poorman's Hangul Jamo Input Method \\ \large pmhanguljamo.sty}
\author{Nova de Hi}
%\date{2020/07/17\quad v0.1}
%\date{2020/07/18\quad v0.1.1}
%\date{2020/07/19\quad v0.2.0}
%\date{2020/01/20\quad v0.2.1}
%\date{2020/01/28\quad v0.3}
%\date{2020/01/30\quad v0.3.1}
%\date{2020/02/05\quad v0.3.2}
%\date{2020/03/09\quad v0.3.3}
%\date{2020/03/15\quad v0.3.4}
%\date{2020/03/10\quad v0.3.5}
%\date{2021/09/20\quad v0.3.6}
%\date{2021/11/28\quad v0.4}
%\date{2022/09/02\quad v0.5}
%\date{2022/09/07\quad v0.5.2}
\date{2023/02/19\quad v1.0}

\maketitle

\begin{exampleside}
\begin{jamotext}
g@/r@;mi p@/r@:ni sai; de/ug; h@i;o/,\\
moy:hi pe/re/h@/ni; gos/bi;ci bvr; bvd/n@n d@s;do/da/.\\
ors/bo;mi bon:d@in sdo; di:na/ga;n@/ni;\\
e/nv; na;ri i; do;ra/gar h@i;o;.
\end{jamotext}
\end{exampleside}

\chapterstyle{obmadsen}

%\vspace{-.5\baselineskip}
\tableofcontents*

\chapter{이 패키지에 관하여}

\section{목적}

\pkg{pmhanguljamo.sty}는 ``Poorman's Hangul Jamo Input Method''에서 따온 이름이다.
알파벳과 몇 개의 기호문자만으로 한글 자모 (첫가끝) 입력을 대신할 수 있게 만든 것이다.
자모 조합 한글을 잘 처리할 수 있는 폰트의 도움을 받아 (\ref{sec:font}절을 보라) `모든' 한글 수백만자를 표현할 수 있다.
한글 패키지 \koTeX 과 함께 쓸 수 있고, 단독으로 사용해도 한글 표현이 가능하다.
외국어를 본문으로 하고 한두 글자의 한글만을 표현할 필요가 있을 때, 별도의 입력기가 없는
상황에서 `옛한글'을 포함하는 문자와 문장을 출력하여야 할 때 쓸 수 있다.

\hologo{XeLaTeX}, \hologo{LuaLaTeX}에서 사용할 수 있고 
\hologo{pdfLaTeX}은 지원하지 않는다.

\section{사용법}

\subsection{패키지 사용 선언}

\begin{boxedverbatim}
\usepackage[<option>]{pmhanguljamo}
\end{boxedverbatim}

\subsection{패키지 옵션}

이 패키지는 세 가지 한글 입력 방법을 지원한다. 이 각각은 서로 호환되지 않으며
한 문서에서 서로 다른 입력 방법을 섞어쓰지 못한다. 각 입력 방법은 패키지의 옵션으로
선언한다. 입력 방법에 따라서 각각 추가 옵션을 줄 수 있으며 이에 대해서는 각 입력 방법을 소개하는 장에서 다룬다.
\begin{description}
\item [pm 입력 방법] \verb|[method=pm]|. 이 패키지에서 고유하게 정의하고 있는 한글 대응 입력 체계이다. 별도의 옵션을 주지 않으면 이 방식이 활성화되며, \ref{chap:pm}장이 이에 대하여 서술한다.

\item [한글 로마자 표기법 방식] \verb|[method=rrk]|, 간단히 \verb|rrk|만을 선언하여도 된다. 대문자 \verb|RRK|로 지정해도 된다.
국가 표준인 한글 로마자 표기법 ``표준 전자법''을 현대 한글 입력 방식으로 하고 약간 확장한 것이다. 
\ref{chap:rrk}장에서 이에 대해 설명한다.

\item [hangul\TeX{} 방식] \verb|[method=frkim]|, 간단히 \verb|frkim|으로 선언한다. 후쿠이 레이의 `hangul\TeX'에서 채택한 후쿠이 레이 방식 한글 로마자 전자법에 기초를 두고 있는 입력 방법이다. \ref{chap:frkim}장에서 설명한다.
\end{description}

다음 두 옵션은 모든 입력 방식에 공통으로 적용된다.

\begin{description}
\item [\ttfamily [pmfont=<fontname>{]}] 알파벳으로 입력되는 한글 자모 문자는 적절한 폰트의
도움을 받아 한글로 출력된다. 어떤 폰트가 사용가능한지에 대해서는 \ref{chap:fonts}장에서 상세히 설명한다. 이 옵션은 한글 문자를 식자할 폰트를 미리 설정해주는 것이다.
폰트 이름(\texttt{<fontname>})은 \pkg{fontspec}이 인식할 수 있는 이름을
전달해준다.

\item [\ttfamily [pmfontfeature=<fontfeature>{]}] 폰트 식자 시에 전달해줄 font feature를 지정한다. 디폴트로 ``\texttt{Ligatures=TeX,Renderer=OpenType,Script=Hangul}''이 선언되어 있으므로 대부분의 경우 이를 변경할 필요가 없을 것이다.
\end{description}

다음 옵션은 이전 버전과의 호환성 때문에 들여온 것이다. \pageref{sec:compat}페이지를 보라.
\begin{description}
	\item[\ttfamily [compat=0.5{]}] 1.0 이전 버전의 대응 문자가 동작하게 한다. \texttt{method=pm}일 때만 유효하다.
\end{description}

\subsection{명령과 환경}

입력 방법의 선택에 무관하게 다음 하나의 명령과 하나의 환경이 한글을 입력하는
명령(환경)으로 제공된다. 각 입력 방법의 구현에 따라 다른 보조적인 명령이 더
있을 수 있으나 이 두 가지가 이 패키지가 제공하는 핵심 명령이다.

\paragraph{명령 \ttfamily \cs{jamoword}}
\cs{par}가 포함되지 않은 하나의 인자를 취하여 알파벳 문자를 한글로 변환하여
출력한다. 이 명령의 인자 범위에 만약 알파벳 아닌 것, 예를 들어 한자, 카나문자, 부호 등이 온다면 변환하지 않고 그대로 출력한다. 매크로의 경우는 인자를 취하지 않는 protect된 매크로는 그대로 출력한다. 그러나 매크로의 인자는 거기에 알파벳이 포함되어 있기 때문에 제대로 해석하지 못하므로 인자를 취하는 매크로는 오지 못하는 것으로 간주하여야 한다.
문장부호는 (입력 방식에 따라 차이가 있지만) 마침표, 쉼표 등 기본적인 문장부호를 쓸 수 있다. 따옴표의 경우, \TeX{} 방식의 큰따옴표는 이 명령의 범위 밖에 두는 것이 안전할 것이다. 다만 패키지가 내부적으로 사용하는 몇 가지 특별한 문자(입력 방식마다 다르므로 각각 설명을 제공한다)는 주의하여 사용해야 할 때가 있다.

\paragraph{환경 \ttfamily jamotext}
\cs{par}를 포함하는 둘 이상의 문단의 범위를 한글로 식자한다.
영어와 같은 외국어와 어울러쓰는 때가 많은 우리 문장에서 한글로 된 문단의 중간에 한글이 아닌 알파벳이 놓일 때 이를 처리하는 것이 어렵기 때문에 \env{jamotext} 환경은
(rrk를 제외하고) 아스키 에스케이핑 트릭을 가능하게 해두었으나, 대체로 한글만
온전하게 있는 문장을 식자할 때 사용할 것을 권장한다. 영어 등 다른 언어와의 스위칭이
많다면 \cs{jamoword}를 써서 한글 부분만 표현하는 쪽이 좋다.

\section{문서 작성}

이 절에서는 pm 입력 방법을 예시로 들겠다. 자모 입력된 부분의 입력 방법을 다른 방법으로 바꾸더라도
결과는 같다.

\subsection{몇 단어\cntrdot 문단의 한글}

한국어가 주언어(main language)가 아니고 한글 입력이 몇 단어(인명, 지명 등)나 몇 문단(인용문) 수준으로
필요한 경우라고 하자. 한국어를 위한 별도의 패키지를 로드할 필요가 없이 \pkg{pmhanguljamo}만으로 필요한 단어를 입력할 수 있다.
이 때 필요한 것은, (1) \XeLaTeX\ 또는 \LuaLaTeX 으로 컴파일하는 문서여야 한다는 것, (2) \pkg{fontspec}이 로드되어야 한다는 것, 두 가지이다.

\begin{exampleonly}
\documentclass{article}

\usepackage{fontspec}
\usepackage[pmfont={Noto Serif KR}]{pmhanguljamo}

\begin{document}
Jikji (\jamoword{jig/ji/sim/cei/yo/jer}) is the world's oldest 
extant book printed with movable metal type.
\end{document}
\end{exampleonly}

다만, 이 때에는 \cs{jamoword}로 입력되는 부분에서 행나눔이 원만하게 일어나지 않을 수 있다.
비교적 인용되는 문장이 길어서 한글에 맞는 행나눔이 필요한 경우라면 \pkg{polyglossia}와 같은
패키지를 이용하고 한국어 선언을 하는 방법이 있다. 

\begin{exampleonly}
\documentclass{article}
\usepackage{polyglossia}
\setmainlanguage{english}
\setotherlanguage{korean}
\newfontfamily\hangulfont{HCR Batang LVT}[Script=Hangul]
\usepackage[pmfont={Noto Serif KR}]{pmhanguljamo}

\begin{document}
\begin{korean}
\jamoword{mo/dvn in/ryu gu/seq/uen/vi cen/bu/vi jon/em/seq/goa
doq/dvq/ha/go yaq/do/har su ebs/nvn guen/ri/rvr in/jeq/ha/nvn ges/i
sei/gyei/vi ja/yu/, jeq/vi mic pyeq/hoa/vi gi/co/i/mye/,
in/guen/ei dai/han mu/si/oa gyeq/myer/i in/ryu/vi yaq/sim/vr
gyeg/bun/si/ki/nvn man/haiq/vr co/rai/ha/yess/v/mye/,}
\end{korean}
\end{document}
\end{exampleonly}

이 예에서 \cs{jamoword}를 \env{korean} 환경 안에 넣은 이유는 행나눔이 원활하게 일어나게
하기 위한 것이다. 만약 \texttt{pmfont}를 별도로 지정하지 않는다면 \cs{hangulfont}로
선언된 폰트가 쓰일 것이므로 \texttt{Script=Hangul} feature를 부여하는 데 주의해야 한다. 만약
\texttt{pmfont}를 지정한다면(위의 예에서와 같이) \cs{jamoword} 부분은 해당 폰트와 feature로
식자하므로 별도로 신경쓰지 않아도 좋다.

\subsection{\koTeX\ 문서}

주언어가 한국어이든 아니든 \koTeX (\XeTeX-\ko, \LuaTeX-\ko)이 로드되는 상황을
이 패키지는 잘 지원한다. 

\begin{exampleonly}
\documentclass{article}
\usepackage{kotex}
\usepackage[pmfont={Noto Serif KR}]{pmhanguljamo}

\begin{document}
\jamoword{mo/dvn in/ryu gu/seq/uen/vi cen/bu/vi jon/em/seq/goa
doq/dvq/ha/go yaq/do/har su ebs/nvn guen/ri/rvr in/jeq/ha/nvn ges/i
sei/gyei/vi ja/yu/, jeq/vi mic pyeq/hoa/vi gi/co/i/mye/,
in/guen/ei dai/han mu/si/oa gyeq/myer/i in/ryu/vi yaq/sim/vr
gyeg/bun/si/ki/nvn man/haiq/vr co/rai/ha/yess/v/mye/,}
\end{document}
\end{exampleonly}

\paragraph{한국어가 주언어인 문서} 주로 키보드 직접 입력이 번거로운 옛한글을 위하여
\pkg{pmhanguljamo}를 쓰게 될 것이다. 이 때 본문의 폰트와 jamo 부분 폰트를 같게 할 
것인지 다르게 할 것인지를 결정해야 한다. 만약 동일한 폰트를 쓰게 하려 한다면 \texttt{pmfont}
옵션을 별도로 주지 않고 그 대신 \cs{setmainhangulfont}에 \texttt{[Script=Hangul]}
또는 \texttt{[Script=Hangul,Renderer=OpenType]}을 부여하여야 한다. 반면 
서로 다른 폰트를 쓰는 경우라면 \texttt{pmfont}를 지정하는 것이 간단하다.
상세한 사항은 \ref{chap:fonts}장을 참고하라.

\paragraph{한국어가 주언어가 아닌 문서} \texttt{pmfont}로
한글이 식자될 폰트를 지정하는 것으로 충분하다.


\section{입력 방법의 예시}

이 패키지가 의도하는 바에 대한 이해를 돕기 위해 동일한 문장을 입력하는 방법의 예시를 들어둔다. 

\paragraph{pm 입력} 셋 중에서 옛한글을 완전하게 표현할 수 있는 방식이다. 예시는 현대 한글.

\begin{exampleonly}
\jamoword{sei/gyei/in/guen/sen/en}
\begin{jamotext}
mo/dvn in/ryu gu/seq/uen/vi cen/bu/vi jon/em/seq/goa
doq/dvq/ha/go yaq/do/har su ebs/nvn guen/ri/rvr in/jeq/ha/nvn ges/i
sei/gyei/vi ja/yu/, jeq/vi mic pyeq/hoa/vi gi/co/i/mye/,
in/guen/ei dai/han mu/si/oa gyeq/myer/i in/ryu/vi yaq/sim/vr
gyeg/bun/si/ki/nvn man/haiq/vr co/rai/ha/yess/v/mye/,
\end{jamotext}
\end{exampleonly}

\paragraph{RRK 방식} 일반적으로 한국어 사용자에게 가장 친숙한 방식이다. (옛한글은\expldash 이 패키지가 확장한 몇 가지를 제외하면\expldash 일반적으로 사용하기 어렵다.)

\begin{exampleonly}
\jamoword{segye-ingwonseon-eon}
\begin{jamotext}
modeun inlyu guseong-won-ui cheonbu-ui jon-eomseonggwa
dongdeunghago yangdohal su eobsneun gwonlileul injeonghaneun
geos-i segye-ui ja-yu, jeong-ui mich pyeonghwa-ui gicho-imyeo,
ingwon-e daehan musi-wa gyeongmyeol-i inlyu-ui yangsim-eul
gyeogbunsikineun manhaeng-eul cholaeha-yeoss-eumyeo,
\end{jamotext}
\end{exampleonly}

\paragraph{frkim 방식} 다음과 같다.

\begin{exampleonly}
\jamoword{seigiei'inguensen'en}
\begin{jamotext}
modyn inriu guseq'uen'yi cenbu'yi jon'emseqgoa
doqdyqhago iaqdohar su ebsnyn guenriryr injeqhanyn ges'i
seigiei'yi ja'iu, jeq'yi mic pieqhoa'yi gico'imie,
inguen'ei daihan musi'oa gieqmier'i inriu'yi iaqsim'yr
giegbunsikinyn manhaiq'yr coraiha'ieS'ymie,
\end{jamotext}
\end{exampleonly}

어떤 입력 방식이든, 결과는 다음과 같이 나타난다.

\begin{quote}
\jamoword{sei/gyei/in/guen/sen/en}
\begin{jamotext}
	mo/dvn in/ryu gu/seq/uen/vi cen/bu/vi jon/em/seq/goa
	doq/dvq/ha/go yaq/do/har su ebs/nvn guen/ri/rvr in/jeq/ha/nvn ges/i
	sei/gyei/vi ja/yu/, jeq/vi mic pyeq/hoa/vi gi/co/i/mye/,
	in/guen/ei dai/han mu/si/oa gyeq/myer/i in/ryu/vi yaq/sim/vr
	gyeg/bun/si/ki/nvn man/haiq/vr co/rai/ha/yess/v/mye/,
\end{jamotext}
\end{quote}

%\item \verb|pmfont={<fontname>}|.
%식자할 폰트를 지정한다. 이 옵션이 주어지지 않으면 문서의 mainfont (\koTeX\ 패키지의
%경우는 mainhangulfont)를 따른다. 지정할 수 있는 폰트에 대해서는 \ref{sec:font} \titleref{sec:font}\를, 이 옵션에 대한 설명은 \ref{font:set}\를 보라.
%\item \verb|pmfontfeagure=<fontfeature>|.
%pmfont 옵션으로 지정하는 폰트에 추가 속성을 부여하려 할 때. \ref{font:set}\을 보라.
%\end{enumerate}

\section{주의사항}

이 패키지의 목적은 한글 자모를 입력하여 한글이 표현되게 하는 것이다.
글자가 먼저 만들어지고 거기에 대해서 어떤 명령을 수행할 수 있는 것이므로 예를 들어
\begin{verbatim}
    \textbf{\jamoword{<args>}}
\end{verbatim}
이것은 원하는 결과를 내지만
\begin{verbatim}
    \jamoword{\textbf{<args>}}
\end{verbatim}
이렇게 하면 오류가 발생한다.

\paragraph{이전 버전과의 호환성}\label{sec:compat}
이 패키지 1.0버전에서 \texttt{[method=pm]}의 한글 대응 문자 세 개의 설정값이 달라졌다.\marginpar{\fbox{\footnotesize v1.0}}
그 내역은 다음과 같다.

\medskip
\begin{tabular}{lll}
	대응 한글 자모 & 1.0 버전 & 0.6 이전 버전 \\
	ㅇ & \texttt{q} & \texttt{x} \\
	\char"3181 & \texttt{f} & \texttt{q} \\
	\char"3186 & \texttt{x} & \texttt{f} \\
\end{tabular}

\medskip
이 개편은 \texttt{[method=frkim]}이 도입되면서 이루어졌는데 가장 큰 변화는 이응(ㅇ)을 \texttt{x}가
아니라 \texttt{q}로 적게 한 것이다.

이러한 변화로 인하여 이전 버전에서 입력한 텍스트가 의도와 달리 출력될 수 있다. 패키지 옵션으로 
\texttt{[compat=0.5]}를 부여하면 새로운 대응 문자가 아니라 0.6 이전 버전에서의 대응 문자가 
여전히 동작하게 해두었다. 

\chapter{폰트}\label{chap:fonts}

\section{사용가능한 글꼴}\label{sec:font}

자모 조합 한글을 출력하려면 이를 해낼 수 있는 글꼴이 필요하다. 소위 `옛한글' 글꼴이라지만 PUA 옛한글
5000여자의 사용자 영역 글자만을 가지고 있는 글꼴로는 이 패키지에서 말하는 옛한글을 식자할 수 없다. 새바탕\cntrdot 새굴림과 같은 한양 옛한글
폰트, 전주완판본체, 제주폰트 등이 모두 옛한글에 사용할 수 없는 폰트에 해당한다.

자모 조합 한글을 구현할 수 있는 몇몇 글꼴을 테스트해보겠다. 

\unusepmfont
\begin{boxedverbatim}
sa:r@m/ma:da; h@i:qqye; su:bqi; ni/gye;
\end{boxedverbatim}

\newcommand\teststr{\jamoword{sa:r@m/ma:da; h@i:qqye; su:bqi; ni/gye;
}}

\newcommand\testfont[1]{%
	\begingroup
	\begin{adjustwidth}{2em}{2em}
	\adhochangulfont[\fontfeatureoption]{#1}\teststr
	\end{adjustwidth}
	\endgroup
}

함초롬 바탕 \testfont{HCR Batang LVT}

은 바탕 \testfont{UnBatang}

본명조 또는 Noto Korean \testfont{Noto Serif KR}

나눔명조옛한글 \testfont{NanumMyeongjo-YetHangul.ttf}

KoPubWorld 바탕 \testfont{KoPubWorldBatangMedium}

함초롬 돋움 \testfont{HCR Dotum LVT}

본고딕 또는 Noto Sans \testfont{Noto Sans KR}

나눔바른고딕옛한글 \testfont{NanumBarunGothic-YetHangul.ttf}

맑은 고딕 \testfont{Malgun Gothic}

KoPubWorld 돋움 \testfont{KoPubWorldDotumMedium}

%한컴훈민정음세로쓰기\footnote{이 폰트는 방점의 위치가 정확하게 나타나지 않는다. 방점이 없는 글자에 대해서만 사용할 수 있을 
%것이다.}
%\testfont{Hancom Hoonminjeongeum_V}

\medskip

옛한글을 무리없이 표현하는 것은 현재 이 정도인 것 같다.
각 폰트는 특정한 문자에 대해서 약간의 차이를 보이기도 한다. 참고로 이 문서에서는
본문과 옛한글에 Noto Serif KR을 사용하였다.

\hologo{LuaTeX}으로 컴파일하는 경우에는 위에 든 폰트들, 즉 \texttt{Script Hangul} 속성을 
가진 폰트만 사용 가능하다. \hologo{LuaTeX}과 이 패키지의 관계에 대해서 
\pageref{sec:luatex}페이지를 참고하라.

\ifXeTeX

\bigskip

한글 자모 영역의 글리프를 가지고 있는 글꼴이 있다. 성조표지를 잘 처리하지 못하는 경우가 있고 옛한글
글자꼴이 반듯하지 않지만 어쨌든 글자가 나오기는 할 것이다. 이것은 \texttt{Script Hangul} 속성을 갖고
있는 것은 아니며 단지 한글 자모 영역 글리프를 영리하게 배열한 것이다. 방점 없이 테스트해보겠다.

\medskip

\renewcommand\teststr{\jamoword{sa/r@m/ma/da h@i/qqye su/bqi ni/gye}}

은 자모바탕 \testfont{UnJamoBatang}

은 돋움 \testfont{UnDotum}

\medskip
그러나 자모 영역 자면이 있다 하더라도 글리프가 잘 조성되어 있지 않은 글꼴에서는
다음과 같이 모아쓰기가 되지 않는 형태로 출력된다. 이런 글꼴은 옛한글에 사용할 수 없다.

\medskip
전주완판본 순L \testfont{TSTJJWanSunL}

\medskip

\textbf{현대 한글 음절문자}는 적어도 \hologo{XeLaTeX}에서는 모두 제대로 표현될 것이다.
자모 코드로부터 한글 음절을 (유니코드 표준을 따라) 구성하는 일을 폰트가 아니라 \hologo{XeTeX}이 하고 있음을 짐작할 수 있다.\footnote{이 패키지의 입력 방법으로 \hologo{XeLaTeX} 컴파일하여 만들어진 현대 한글 음절 영역 문자를 pdf로부터
복사하여 편집기에 붙여넣기하면 자모 코드가 아니라 음절 코드로 들어가는 것을 확인할 수 있다.}
현대 한글만을 표기하려 한다면 폰트의 제약이 줄어든다고 하겠다.

\begin{boxedverbatim}
o/dvq/vn ja/ey a jo/sen/vi dog/rib/gug/im/goa
\end{boxedverbatim}

\renewcommand\teststr{\jamoword{o/dvq/vn ja/ey a jo/sen/vi dog/rib/gug/im/goa}}

백묵 바탕 \testfont{batang.ttf}

Adobe 명조 \testfont{AdobeMyungjoStd-Medium.otf}

전주완판본 순L \testfont{TSTJJWanSunL}

제주한라산 \testfont{JejuHallasan.ttf}

\fi

\usepmfont

\section{폰트의 지정}\label{font:set}

\subsubsection{Script Hangul Feature}

\cmda{\jamoword}와 \env{jamotext} 인자 범위 내에서 한글을 식자하려 할 때에는
주어진 (한글) 폰트의 \textsf{Script Hangul} 속성을 활성화하여야 한다.\footnote{이것은 
폰트가 가지고 있는 오픈타입 속성을 활성화하여 자모 한글을 제대로 출력하도록 지정하는 역할을 한다. 자모 한글을
처리하는 기능을 가지고 있지 않은 글꼴에서는 아무 역할도 하지 않고 컴파일 시 콘솔에 경고 메시지를 보일 것이다.}%
\textsuperscript{, }\footnote{\hologo{LuaTeX}에서는 약간의
추가 옵션(\texttt{Renderer=Harfbuzz} 또는 \texttt{Renderer=OpenType})이 더 필요할 수 있다. 이 문서의 이후 \texttt{[Script=Hangul]}을 주라고 하는 때에
모두 동일하다. \pageref{sec:luatex}페이지의 부록 B를 보라.\label{fn:fontoption}}

그러므로 \pkg{fontspec} 방식으로 폰트를 지정할 때 반드시
\begin{verbatim}
\set...font{<fontname>}[Script=Hangul]
\end{verbatim}
또는 Lua\TeX 이라면
\begin{verbatim}
\set...font{<fontname>}[Script=Hangul,Renderer=OpenType]
\end{verbatim}
을 지정하여야 한다.

이 패키지는 \texttt{[pmfont=]} 옵션을 제공하여 이런 번거로움을 피해갈 수 있게 하였다.
즉 \cs{jamoword}로 주어지는 한글에 적용할 폰트를 별도로 지정함으로써
위에 언급한 feature를 붙여 식자하게 하였다. 다음 절에서 이에 대해 부연한다.

\subsection{패키지 옵션 \texttt{pmfont}}

\leavevmode{\marginpar{\fbox{\footnotesize v5.0}}}
패키지 옵션 \verb|pmfont=|가 주어지지 않았을 때는 아무 일도 하지 않는다.
이것이 의미하는 것은 현재 활성화된 기본 폰트가 pm 자모 식자에 이용된다는 뜻이다.
mainfont로 식자할 것인지, 또는 별도의 폰트를 \cmda{\newfontfamily}로
설정하여 식자할 것인지 사용자에게 맡겨져 있고, 이것이 디폴트이다.

만약 \verb|pmfont=| 옵션이 예컨대 다음과 같이 주어졌다고 가정하자.
\begin{verbatim}
    \usepackage[pmfont={Noto Serif KR}]{pmhanguljamo}
\end{verbatim}
이 때에는 \cmda{\jamoword}와 \env{jamotext}의 인자 범위에서 pm 자모 입력된
한글 문자에 대해서 지정된 폰트가 (필요한 속성(feature)이 자동으로 주어져서)
적용된다.

필요할 적에 활용할 수 있도록 \texttt{pmfont}에 관련된
두 개의 매크로가 정의되어 있다. \verb|\usepmfont|는 명령이 주어진 위치부터
\verb|\setpmhangulfont|에 의하여 지정되는 폰트를 자모 식자에 사용한다.
\begin{verbatim}
  \usepmfont
  \setpmhangulfont{HCR Batang LVT}
\end{verbatim}
옵션 \verb|pmfont={HCR Batang LVT}|는 이 두 매크로를 문서의 맨처음부터
설정하는 것과 동일하다.

거의 쓸 일이 있을 것으로 생각하지 않지만 자모 한글을 식자할 때 pmfont에 의하지
않고 본문 기본 한글 글꼴(이 때 한글 글꼴에는 반드시 \texttt{Script=Hangul}이
주어져 있어야 한다)로 식자하도록 되돌리려 할 때
\begin{verbatim}
  \unusepmfont
\end{verbatim}
를 선언할 수 있다.\footnote{단 \texttt{method=frkim} 방식에서는 폰트 지정 방식이
	독자적으로 되어 있어서 \cs{unusepmfont} 명령의 효력이 없다.}
본문 글꼴 설정에서 \texttt{Script=Hangul} 옵션이 주어져 있지 않으면 
다음과 같은 결과를 얻게 될 것이다.
\unusepmfont
\jamoword{na/ras;mar:ss@/mi;}
\usepmfont

\subsection{패키지 옵션 pmfontfeature} \marginpar{\fbox{\footnotesize{v0.5.1}}}
자모 한글을 식자하는 폰트(pmfont)에 추가적인 fontfeature를 부여하려면 이 옵션을
쓸 수 있다.\footnote{이 패키지가 \texttt{pmfont}에 default로 부여하는 속성은 \texttt{Ligatures=TeX},
\texttt{Script=Hangul}, 그리고 \texttt{Renderer=OpenType}이다.}
다음은 \koTeX\ 한글 폰트 속성 FakeStretch를 부여한 예이다.

\begin{verbatim}
  \usepackage[pmfont={HCR Batang LVT},pmfontfeature={FakeStretch=0.9}]
  {pmhanguljamo}
\end{verbatim}

\cmda{\setpmhangulfont} 명령의 옵션으로 fontfeature를 부여할 수도 있다.

\begin{verbatim}
  \setpmhangulfont{Noto Serif KR}[FakeStretch=0.9]
\end{verbatim}

이미 부여한 속성을 기본값으로 되돌리려면 \cmda{\setpmhangulfont}를 옵션 없이
선언하여야 한다.

\begin{exampleside}
\setpmhangulfont{HCR Batang LVT}[Color=blue,FakeStretch=0.8]
\jamoword{moi/koa g@/r@m/sbun is/go}\\
\setpmhangulfont{Noto Serif KR}
\jamoword{moi/koa g@/r@m/sbun is/go}
\end{exampleside}



\chapter{method=pm}\label{chap:pm}

\section{轉字 규칙} \label{sec:pmrule}

이 패키지는 아래에서 설명하는 바 독특한 입력 문자 대응 규칙을 정의하여 쓴다. 이 방법을
편의상 ‘pm 전자 규칙’이라고 부르기로 한다. 이 방법은 \ref{sec:rrk}절에서 설명할 RRK 입력 규칙과
다르고 둘 중 하나를 선택하여 써야 한다. 소실된 한글 옛문자를 
완벽하게 식자하려면 pm 입력 방식으로만 가능하다.

\subsection{성조표지와 음절}

입력에는 로마자 알파벳과 \verb|@| 부호, 그리고 세 개의 성조표지(방점) 기호 \verb|/|, \verb|;|, \verb|:|를 사용하며, 중성 필러를 표현하기 위하여 \verb|*| 부호를 쓴다.

\emph{성조표지가 와야 음절이 완성된 것으로 본다}. 모든 한글 음절은 반드시 성조표지로 끝난다.
평성이 아닌 성조표지는 (적절한 폰트에서) 한글 음절의 왼편에 찍힌다.

\begin{table}[htpb]
\centering
\caption{성조 표지} \label{tab:tonemarker}
\begin{tblr}{hlines,vlines,
	vline{1,Z}={0pt}
}
\texttt{/} & 평성 & 점 없음 \\
\texttt{;} & 거성 & 점 하나 (\jamoword{m@s;no/p@n; so/ri;}) \\
\texttt{:} & 상성 & 점 둘 \\
\end{tblr}
\end{table}

성조 표기를 하지 않는 경우에도 음절의 완성을 나타내는 \verb|/|를 두어야 한다. 
다만 이 경우에 입력 편의를 위한 예외로서 
그 뒤에 스페이스가 와서 단어 입력이 종료되는 위치(또는 입력 문자열의 마지막)에서는 \verb|/|를 생략할 수 있다. 다음 예를 보아라.

\medskip
\begin{exampleside}
\jamoword{moi/koa/ g@/r@m/sbun/ is/go/}\\
\jamoword{moi/koa g@/r@m/sbun is/go}
\end{exampleside}

스페이스 앞에서 \verb|/|를 생략할 수 있음과 관련하여 스페이스가 아니라면 생략할 수 없음에 주의하라. 예컨대 마침표와 같은 문장부호가 올 때는 그 문장부호 앞에서 \verb|/|를 생략할 수 없다.

\medskip
\begin{exampleside}
\jamoword{jas ans bo/m@i pvr/oa na/mo/sbun gi/peys/do/da/.}
\end{exampleside}

\subsection{알파벳 대응 문자}

알파벳 소문자를 이용하여 한글 자모 영역의 문자를 입력한다. 자음과 모음의 대응 규칙은 다음과 같다.

\subsubsection{자음}

\begin{table}[h]
\centering
\caption{알파벳-자모 대응 규칙: 자음}\label{tab:cons}
\ttfamily
\begin{tblr}{
	colspec={ll|ll|ll|ll|ll},
	hline{1,Z}={1pt},
	hline{Y}={.7pt}
}	
ㄱ & g & ㄴ & n & ㄷ & d & ㄹ & r & ㅁ & m \\
ㅂ & b & ㅅ & s & ㅇ & \SetCell{cyan!30}\textbf{q} & ㅈ & j & ㅊ & c \\
ㅋ & k & ㅌ & t & ㅍ & p & ㅎ & h & & \\ 
\char"3181 & \SetCell{cyan!30}\textbf{f} & \char"317F & \SetCell{cyan!30}\textbf{z} &
\char"3186 & \SetCell{cyan!30}\textbf{x} & \SetCell[c=4]{} \\
\end{tblr}
\end{table}

\begin{enumerate}[1)] \firmlist
\item \texttt{g}, \texttt{n}, \texttt{d}, \texttt{r}, \texttt{m}, \texttt{b}, \texttt{s}, \texttt{j}, \texttt{c}, \texttt{k}, \texttt{t}, \texttt{p}, \texttt{h}는 연상이 가능할 것이므로 따로 설명하지 않는다. \jmcc{R}에 대하여
\verb|r|만을 사용하고 \verb|l|을 쓰지 않는다.
\item `\jmcc{Q}'(이응)에 대하여 \verb|q|를 채택하였다. 
%원래 이것은 오래 전 \pkg{frktex}이라는 패키지에서 첫소리 이응에 대하여 \verb|x|를 썼던 적이 있으므로 그 유래가 아주 없다고 할 수는 없겠다. 다만 이 패키지는 종성 이응 받침도 \verb|x|를 쓴다. 
\item `\jmcc{F}'(옛이응)을 \verb|f|로 한 것은 별다른 선택의 여지가 없어서였다. \ref{chap:frkim}장의 \texttt{frkim} 입력 방식에서는 이것을 대문자 \verb|Q|로 하고 있지만 우리는 대문자를 다른 용도로 할당하였기 때문에 그렇게 할 수 없었다. 
%역시 \pkg{frktex}에서 온 것인데 ``꼭지 달린 이응''이라는 글자 모양이 \verb|q|를 연상시킨다''는 이유였다고 한다. 그럴 법도 하다.
\item 가장 곤란했던 것은 \jmcc{X}(여린히읗)이었다. 사용되지 않은 자판 가운데서 선택할 수밖에 없는데 \texttt{l}, \texttt{v}, \texttt{w}, \texttt{x} 정도가 선택 가능한 범위였다. 알파벳이 아닌 부호문자 중에서 선택하는 것도 생각해보았으나 역시 자판의 윗줄로 올라가는 것은 꺼려져서 \verb|x|로 선택하였다. 마침 \verb|frkim| 방식에서 \verb|X|를 할당하고 있으므로 어느 정도 유사성을 확보했다고 생각하고 싶다.
\item `\jmcc{Z}'(반시옷)을 \verb|z|로 한 것은 납득할 수 있다고 본다. z가 s의 유성음에 대응하기 때문에.

\item `\jamoword{sl@}'나 `\jamoword{slr@}'와 같은 특별한 글자, `\jamoword{jl*/cl*/jjl*/sl*/ss*}, \jamoword{jlr*/clr*/jjlr*/slr*/sslr*}'의 초성 글자들, 즉 훈민정음 언해의 ``\jamoword{dyuq/guyg;so/ri;yeys; ni;sso/ri;}'' 표기에서 쓰이는 齒頭\cntrdot 正齒音을 구분하기 위한 글자들은 \texttt{s}, \texttt{j}, \texttt{c}에 \texttt{l}, \texttt{lr}을 붙여서 표기한다. \verb|l|이 왼쪽(치두음), \verb|lr|이 오른쪽(정치음)이 더 길어지는 글자가 된다.
\item `\jmcc{BQ}', `\jmcc{BBQ}', `\jmcc{MQ}', `\jmcc{PQ}'와 같은 ``\jamoword{ib/si/ur;ga/b@i;ya/bq@n; so/ri;}'' 표기는 \verb|q|를 이어써서 표기한다. 각각, \texttt{bq}, \texttt{bbq}, \texttt{mq}, \texttt{pq}.
\item 겹자음\cntrdot 복자음은 이어쓴다. \texttt{gg} \jmcc{GG}, \texttt{bsg} \jmcc{BSG}, \texttt{bsd} \jmcc{BSD}, \texttt{rx} \jmcc{RX}.
\item `제로자음'인 초성 이응은 생략할 수 있다. 모음으로 시작하면 초성 이응을 식자해준다. \verb|\jamoword{an}| \jamoword{an}. 
\item 정말로 초성을 비우기를 원한다면(즉 초성 필러를 쓰려 한다면) \verb|w|를 그 위치에 쓸 수 있다. 이것은 종성에는 적용되지 않는다. \verb|\jamoword{wan}| \jamoword{wan}.
\end{enumerate}

\subsubsection{모음}

\begin{table}[h]
\centering
\caption{알파벳-자모 대응 규칙: 모음} \label{tab:vow}
\ttfamily
\begin{tblr}{
	colspec={ll|ll|ll|ll|ll},
	rowspec={|[1pt]QQ|Q|QQ|Q|[1pt]}
}
ㅏ & a & ㅓ & e & ㅗ & o & ㅜ & u & ㅡ & \SetCell{cyan!50}\textbf{v} \\
ㅣ & i & \jmcc{@} & \SetCell{cyan!50}\textbf{@}  & & & & & & \\ 
ㅑ & ya & ㅕ & ye & ㅛ & yo & ㅠ & yu & \kern-.3em\jmcc{@}\kern-.6em\jmcc{@} & \SetCell{cyan!50}@@ \\ 
ㅐ & ai,ay & ㅔ & ei,ey & ㅚ & oi,oy & ㅟ & ui,uy & ㅢ & vi,vy \\ 
ㅒ & yai,yay & ㅖ & yei,yey & \jmcc{YOI} & yoi,yoy & \jmcc{YUI} & yui & \jmcc{@I} & @i \\ 
ㅘ & oa & ㅙ & oai,oay & ㅝ & ue & ㅞ & uei,uey & \textit{filler} & \SetCell{cyan!50}{*} \\ 
\end{tblr}
\end{table}

\begin{enumerate}[1)]
\item 기본 모음 ㅏ, ㅓ, ㅗ, ㅜ, ㅡ, ㅣ, \jmcc{@}(\texttt{@})는 한 글자로만 표기한다. ㅑ, ㅕ, ㅛ, ㅠ는 \verb|y|를 앞에 붙인다.
\item `ㅡ'를 영문자의 자음에 해당하는 \verb|v|에 대응시킨 것은 이상하게 보일 수 있다. 그러나 윗 항을 충실하게 지키려다 보니 부득이했다. 실로 이 홀소리 글자의 로마자 표기는 혼란스럽다고 생각하고 있는데, 표준인 \texttt{eu}만이 아니라 \texttt{y}, \texttt{u} 등이 있었고, 다른 어떤 제안에서는 \verb|w|도 있었던 것으로 기억한다. 어차피 마땅한 방법이 없다면 이렇게 약속하고 쓰는 것이 한 방법이라 생각한다. \verb|v|자를 죽 늘리면 `ㅡ'가 되는 것처럼 보이는 연상에서 비롯되었는지 모른다.
\item \texttt{e}를 보통 `에'라고 읽기 때문에 `ㅓ'를 \verb|e|에 할당한 것이 익숙지 않을 수 있다. 이것은 Yale 표기법에 그 기원이 있다.
\item `ㅐ, ㅔ'는 단모음으로 간주되기 때문에 \texttt{ay}, \texttt{ey}라고 쓰도록 하였다. 비슷한 이유에서 \texttt{oy}, \texttt{uy}라고 되었다. 
그러나 이런 음성학적 지식이 표기에 반드시 필요하다면 그것도 불편하다. 그래서 `\texttt{ai}, \texttt{ei}, \texttt{oi}, \texttt{ui}'라고 입력하는 것도 허용하였다. `ㅢ'의 경우에도
\texttt{vy}와 \texttt{vi} 둘 다 가능하다.

\verb|\jamoword{sai/say}| \jamoword{sai/say}.\quad \verb|\jamoword{sei/sey}| \jamoword{sei/sey}. \\
\verb|\jamoword{soi/soy}| \jamoword{soi/soy}.\quad \verb|\jamoword{sui/suy}| \jamoword{sui/suy}. \\
\verb|\jamoword{gvi/gvy}| \jamoword{gvi/gvy}.

그러나 \jmcc{@I}는 단모음으로 인식될 가능성이 없다고 보아 \verb|@i|만을 취하였다. 

\verb|\jamoword{g@i}| \jamoword{g@i}.

\item `쌍아래아(\jmcc{@@})'는 현대의 제주어 표기에서 이따금 필요하다. 모양대로 \verb|@@|로 적으며 \verb|y@|를 취하지 않았다. 현대 국어에서 이 글자의 소리는 잊혀진 것이라서 소리로 연상할 수 없기 때문이다.\\
\verb|\jamoword{@@/nam/vn}| \jamoword{@@/nam/vn}.
\item 표준 로마자 표기법에서 \texttt{wa}, \texttt{wo}, \texttt{we}, \texttt{wi}로 표기할 때 나타나는 반자음 \verb|w|은 채택하지 않았다. `ㅘ, ㅝ, ㅟ'는 생긴 대로 \texttt{oa}, \texttt{ue}, \texttt{ui}로 적는다.
\item 이 패키지는 Unicode 5.2의 한글 자모 확장 A, B를 지원한다. 그러므로 한글 자모 영역([U+11XX])에는 없는 `\jamoword{wuye}'와 같은 모음을 표기할 수 있다. \verb|\jamoword{sa/guye}| \jamoword{sa/guye/}. 물론 폰트가 이를 지원해야 한다.
\item 중성 필러([U+1160])는 \verb|*| 부호로 적을 수 있다. \verb|\jamoword{h*n}| \jamoword{h*n}. 초성과 중성을 모두 filler로 채우는 경우에는 종성이 있어야 한다. \verb|\jamoword{w*x}| \jamoword{w*x}.
\end{enumerate}

\subsection{호환자모 음절} \label{sec:compjamo}

\cmda{\jamoword}나 \env{jamotext} 범위 안에서 호환 자모를 식자하려면 해당하는 자모를 대문자로, 하나의 음절로 입력한다.
별도로 \cmda{\jmcc}를 쓰지 않는다. 그러나 반드시 하나의 자모가 한 음절이어야 한다.

\begin{exampleside}
\jamoword{B/n@n; ib/si/ur;sso/ri;ni;} \\
\jamoword{孟m@if/子j@/I g@r/@/sya/d@i}
\end{exampleside}

\medskip

호환 자모 아래아 `\jmcc{@}'를 \cmda{\jamoword} 인자 안에서 식자하려 할 때는 자모 아래아 `\jamoword{w@}'와
구별하기 위해 대문자 \texttt{W} 또는 \texttt{AA}로 표기해야 한다. \verb|W|(\verb|AA|), \verb|WW|(\verb|AAA|), \verb|WI|(\verb|AAI|)만이 지원된다.

\begin{exampleside}
\jamoword{AA/n@n; 呑t@n/D/字/jj@q; ga/on;d@is;so/ri; g@;t@;ni/ra;.}\\
\jamoword{AAA/nvn jei/ju/e pyo/gi/ei i/yoq/doin/da/.}
\end{exampleside}

%=======
\section{method=pm에서의 명령과 환경}

\subsection{\texttt{\bs jamoword} 명령}

\begin{boxedverbatim}
\jamoword{<several words>}
\end{boxedverbatim}

한글 자모를 알파벳으로 입력하여 출력한다. 
하나 또는 둘 이상의 단어가 올 수 있다.\footnote{단 하나의 단어만을 처리하는 \cmda{\jamotextcmd}라는 명령이
있기는 하나 내부적으로 사용되는 것이다.}
\verb|\par|를 포함하는 문단은 올 수 없다.

\medskip

\begin{exampleside}
\jamoword{na/ras;mar:ss@/mi; dyuf/guig;ei dar/a;} 
\end{exampleside}

\subsection{\env{jamotext} 환경}

\begin{boxedverbatim}
\begin{jamotext} 
<text>
\end{jamotext}
\end{boxedverbatim}

\subsubsection{\env{jamotext}의 아스키 에스케이프}

\env{jamotext} 환경은 여러 문단을 포함하는 긴 문장을 식자할 수 있다.
단 이 환경 안에 오는 모든 텍스트는 문장부호와 몇 가지 예외적인 것 이외에
인자를 취하는 매크로를 포함하지 않고 순수한 한글로만 되어 있어야 한다.

\medskip
\begin{exampleside}
\begin{jamotext}
na/ras;mar:ss@/mi; dyuf/guyg;ey; dar/a;
mun/jj@q;oa;ro; se/rv s@/m@s/di; a/ni;h@r/ss@i;

i;ren jyen/c@;ro; e/rin; 百b@ig;姓syef;i; 
ni/rv/go;jye; horx; bai; i/sye;do;
\end{jamotext}
\end{exampleside}

\leavevmode\marginpar{\footnotesize\fbox{v0.5}}%
\env{jamotext} 환경 내에 긴 문장을 쓰다가 보면 잠시 jamo 입력이
아닌 아스키 입력 상태로 escape하여야 할 때가 있다. 이를 위하여
\begin{verbatim}
    !{<ascii stuffs>}
\end{verbatim}
와 같은 트릭을 쓸 수 있다.
이 때에 \verb|!{|는 반드시 단어의 첫머리여야 하므로 한 단어 안에서
두 번 이상 쓸 수 없다. 문단 구분을 위한 빈 줄도 올 수 없다.

이 아스키 에스케이프 트릭은 \env{jamotext} 환경 내에서만 쓸 수 있고 
\cmda{\jamoword}의 인자 범위에서는 쓸 수 없다.

\medskip
\begin{exampleside}
\begin{jamotext}
in/gan/i pog/jeq/goa eg/ab/ei 
!{tyranny and oppression} 
dai/haq/ha/nvn ma/ji/mag su/dan/v/ro/se 
!{as a last resort}
ban/ran/vr ir/v/ki/do/rog gaq/yo/bad/ji 
anh/v/rye/myen
\end{jamotext}
\end{exampleside}

이를 이용하여 약간의 수식도 \env{jamotext} 안에 둘 수 있다.

\medskip
\begin{exampleside}
\begin{jamotext}
2/ca/baq/jeq/sig/vi gvn/vi goq/sig/,
!{\[ x = \frac{-b\pm\sqrt{b^2-4ac}}{2a} \]}
vr yu/do/ha/ye bo/ja/.
\end{jamotext}
\end{exampleside}

아스키 에스케이프 트릭은 \texttt{method=frkim}이나 \texttt{method=rrk}에서는
쓸 수 없다.

\section{\texttt{\bs jmcc} 명령}

\begin{boxedverbatim}
\jmcc{<single jamo>}
\end{boxedverbatim}

음절이 아니라 한 개의 자모만을 표시할 목적으로 \href{https://en.wikipedia.org/wiki/Hangul_Compatibility_Jamo}{한글 호환 자모}를 식자하려 할 때 사용하는 명령이다.
이 패키지의 기본 명령인 \cmda{\jamoword}로도 호환 자모를 식자할 수 있기 때문에 일반적으로
이 명령을 사용할 필요가 없으나, rrk 입력 방식으로 문서를 작성할 때라든지 오로지 호환 자모만을
표기해야 할 필요가 있다든지 등 부득이한 경우가 있을 수 있다. 
호환 자모를 \cmda{\jamoword} 명령의 인자 안에서 쓰는 방법은 \ref{sec:compjamo}절을 보라. 
인자로 단 하나의 자모만이 와야 한다. 이 명령은 \texttt{method=rrk}일 때도 쓸 수는 있지만
호환 자모를 가리키는 알파벳 부호는 pm 방식의 것만을 지원한다. \texttt{method=frkim}일 때에는
별도의 호환 자모 식자 방법을 제공하고 있다.

쌍아래아는 유니코드 호환 자모에는 정의되어 있지
않으나 편의를 위하여 조판할 수 있도록 해두었다.

\medskip
\begin{exampleside}
\jmcc{BSG} \jmcc{@} \jmcc{UEY} \jmcc{@@}
\end{exampleside}

\section{밑줄 긋기}

\leavevmode\marginpar{\fbox{\footnotesize v0.5.1}}%
밑줄을 긋는 명령 \cmda{\underline}의 인자로 \cs{jamoword}가 오는 것은 문제가 없다.

\begin{exampleside}
\underline{\jamoword{mit/jur/gvs/gi}}
\end{exampleside}

그러나 이 명령은 행자르기가 이루어지지 않는다. \textsf{ulem} 패키지의 \cs{uline}을
쓰면 이 문제를 해결할 수 있으나,
이 패키지의 현재 버전(1.0)은 \textsf{ulem} 패키지와 충돌이 있다. \XeLaTeX 으로
\koTeX 패키지를 활용하는 상황에서 \textsf{ulem}은 오류를 보이거나 의도하지 않은 결과를
산출할 것이다. (RRK 입력 방법에서도 동일하다.)

Lua\LaTeX, 즉 \textsf{luatexko}를 이용하는 경우에는 \textsf{ulem} 없이도 ulem 명령들,
\verb|\uline| 등을 사용할 수 있으며 이 경우에는 에러 없이 잘 동작한다. 그러므로
\cs{uline}과 같은 ulem 명령을 사용하여야 한다면 Lua\LaTeX 으로 컴파일하는 것이 좋다.

그러나 부득이하여 \XeLaTeX 으로 컴파일하여야 하는 경우이고 밑줄 등을 구현하여야 하는 때라면
\cmda{\jamoul} 명령을 이용할 수 있다. 물론 \textsf{ulem} 패키지 등은 preamble에서
선언되어 있어야 한다.\footnote{Lua\LaTeX 과 \koTeX 을 쓸 때는 \textsf{ulem} 패키지를
별도로 로드하지 않는다.}

\begin{boxedverbatim}
   \jamoul{<ulem command name>}{jamo text}
\end{boxedverbatim}

\texttt{<ulem command name>}은 ulem 명령의 이름을 백슬래시 없이 지정한다는 뜻이다.
다음 예를 보라.

\ifxetex
\begin{exampleside}
\jamoword{go/ji nuns/mv/rvr sbv/ri/gey/ko}
\jamoul{uline}{ye/hvi/ye/syu/mvr svr/ho/ni sai}
\jamoul{uwave}{m@/@/m@r}
\jamoword{nor/rai/no/ra}
\end{exampleside}
\else\ifluatex
\begin{exampleside}
\jamoword{go/ji nuns/mv/rvr sbv/ri/gey/ko}
\uline{\jamoword{ye/hvi/ye/syu/mvr svr/ho/ni sai}}
\uwave{\jamoword{m@/@/m@r}}
\jamoword{nor/rai/no/ra}
\end{exampleside}
\fi\fi
%\textsf{oblivoir-misc}의 \cmda{\texthl}도 같은 방법으로 할 수 있다:
%\verb|\jamoul{texthl}{nuns/mvr/r@r sbv/ri/gey/ko}|
%\jamoul{texthl}{nuns/mvr/r@r sbv/ri/gey/ko}

\cs{jamoul}을 이용하여 밑줄을 긋는 기능은 RRK 입력방법과 \texttt{frkim}에서는 구현되지 않았다.
이 때에는 \textsf{luatexko}의 ulem 명령을 사용하여야 할 것이다.

\section{문장 부호, 한자와 음절 한글}

\cmda{\jamoword} 명령과 \env{jamotext} 환경 안에 오는 인자는 다음과 같은 문자에 대하여 예약이 되어 있다.
\begin{itemize}\firmlist
\item 알파벳 문자 --- 한글 자모 문자에 대응한다.
\item \texttt{;}, \texttt{:}, \texttt{/} --- 이 세 개의 부호는 성조표지, 음절완성을 표시하기 위하여 예약되어 있다.
\item \texttt{|} --- 이 한 개의 부호문자는 내부적으로 사용하도록 예약되어 있다.
\end{itemize}
이를 제외한 문자는 입력한 대로 찍힌다. 즉 한글 완성형 음절 문자나 한자 및 숫자와 문장부호가 모두 그대로 출력된다. 예: \verb|\jamoword{``/u/ri/na/ra/"}| \jamoword{``/u/ri/na/ra/''}.\footnote{%
	여기서 \texttt{`}\texttt{`} 입력이 여는 따옴표로 나오는 이유는 \texttt{pmfont}로
	지정하는 폰트에 기본적으로 \texttt{Ligatures=TeX} feature 옵션이 주어지기 때문이다.
	\texttt{pmfont} 옵션에 의하지 않고 별도로 폰트를 설정할 때 이 점을 알아두어야 한다.}
모든 문장 부호는 모두 음절 분리 부호에 의하여 분리되어 있어야 한다는 점에 주의하라.

콜론, 세미콜론, 슬래시는 각각 \cmda{\ColonMark}, \cmda{\SemiColonMark}, \cmda{\SlashMark} 명령을 사용할 수 있게 해두었다. 이밖에 \cmda{\CntrdotMark}는 가운뎃점을 식자한다.

매크로를 쓸 수 없는 것이 원칙이기는 하나,
protect된 단일 매크로는 그대로 출력된다. 그러나 인자를 취하는 매크로는 오류가 발생할 것이므로 
인자 범위 밖에 두도록 하라.

\begin{exampleside}
\jamoword{15 세기 표기\ColonMark{} 國之語音, 우리나라의 말이 
$\Rightarrow$ na/ras/mar/ss@/mi}
\end{exampleside}


%RRK 입력 방식이 활성화되면 매크로 사용은 더욱 제한된다. \cmda{\ColonMark}와 같은 임시 명령도 동작하지 않는다.

\medskip

음절문자뿐 아니라 자모 한글의 입력도 그대로 출력된다. 어디선가 옛한글%
\footnote{1933년 이전 표기법의 한글을 가리킨다.
유니코드의 한글 음절 문자 영역에서 표현되지 않는 한글을 통칭하는 것이나
현대 한국어 중에서 제주어를 기록할 때도 쓰이고, 워드 프로세서 \jamoword{h@n/gvr}의
이름을 적을 때도 쓰이기 때문에 그리 `옛' 것은 아니다.
이 글에서는 관행을 따라 옛한글이라고 부르기로 한다.}
텍스트를 복사해와서 넣을 때 유용할지도.
다음 예에서 이 패키지의 입력 방식과 첫가끝 입력이 혼용되어 있는 것을 볼 수 있다.

\medskip
\begin{exampleside}
\jamoword{b@/r@/mi sb@/r@/mye ha/n@r/hi 놉고 나ᄇᆡ 됫ᄑᆞ라미 슬프니}
\end{exampleside}

\env{jamotext} 환경 안에서 강제 개행 명령(\verb|\\|)을 쓸 때 주의할 점이 있다.
예를 들어 다음과 같은 입력
\begin{verbatim}
  na/ras/mar/ss@/mi\\
  中dyuf/國guig/ei dar/a
\end{verbatim}
여기서 `\verb|mi\\|' 부분은 음절로서 완성되지 않는다. 왜냐하면
슬래시(\verb|/|)를 생략할 수 있는 것은 space 직전이어야 하기 때문이다.
그러므로
\begin{verbatim}
  na/ras/mar/ss@/mi \\
  中dyuf/國guig/ei dar/a
\end{verbatim}
이와 같이 space를 하나 두거나
\begin{verbatim}
  na/ras/mar/ss@/mi/\\
  中dyuf/國guig/ei dar/a
\end{verbatim}
슬래시(성조표지)를 생략하지 않아야 한다.
% 대체로 스페이스를 하나 두는 쪽이 안전하다.
%%%
%%%\subsection{활용}
%%%
%%%특정 언어 패키지나 입력기의 제약 없이 한글 글꼴을 지정하는 것만으로
%%%현대 한글과 옛한글을 모두 표현할 수 있다는 것이 \pkg{pmhanguljamo}의 장점이다.
%%%
%%%\koTeX\ 패키지와 함께 쓸 때와 그렇지 않을 때를 나누어서 간단히 사용법을 보이겠다.
%%%
%%%\subsubsection{\koTeX\ 문서}
%%%만약 \koTeX\ (\pkg{xetexko} 또는 \pkg{luatexko})과 함께 사용하는 경우라면 본문 한글 글꼴을 
%%%다음과 같이 지정한다. 
%%%
%%%
%%%\begin{boxedverbatim}
%%%  \setmainhangulfont{Noto Serif KR}[Script=Hangul]
%%%\end{boxedverbatim}
%%%
%%%또는 \texttt{pmfont} 옵션을 지정한다. 본문과 다른 폰트를 쓰게 하려 할 때에도
%%%이와 같이 한다. \texttt{pmfont} 옵션으로 지정되는 글꼴에는 \texttt{Script=Hangul}이
%%%자동으로 설정되므로 폰트 이름(또는 폰트 파일 이름)만을 주면 된다.
%%%
%%%\begin{boxedverbatim}
%%%  \usepackage[pmfont={HCR Batang LVT}]{pmhanguljamo}
%%%\end{boxedverbatim}
%%%
%%%\ref{sec:summary}절에서 보인 샘플을 참고하라.
%%%
%%%\subsubsection{\koTeX 이 아닐 때}
%%%
%%%\koTeX\ 문서가 아닐 때는 \pkg{fontspec} 패키지를 이용한다. main font를 위의 글꼴 중의 하나로 하거나(이 때에도 \texttt{[Script=Hangul]} 옵션을 반드시 지정하여야 한다.),
%%%\cmda{\newfontfamily}로 글꼴 명령을 만들어 쓰거나,
%%%아니면 %한글이 필요한 부분에만 \cmda{\fontspec}으로 글꼴을 지정해주는 것으로 될 것이다.
%%%%\fref{fig:sample}\는 \pkg{article} 문서의 한 예이다.
%%%\texttt{pmfont} 옵션으로 글꼴을 지정하면 될 것이다.
%%%다음은 \pkg{article} 문서의 한 예이다.\footnote{폰트에 부여하는
%%%옵션에 관하여 각주~\ref{fn:fontoption}\을 볼 것.}
%%%다만 이와 같이 한글 지원 패키지가 전혀 없는 상태에서는 글자 사이의 행나눔이나 양끝맞추기 등 한글 문장 식자에 꼭 필요한 몇 가지 기능이 구현되지 
%%%않을 것이다. 대체로 몇 자 정도의 한글을 넣어야 하는 때에 유용하리라 본다.
%%%
%%%%\begin{figure}
%%%%\centering
%%%%\begin{boxedminipage}{\dimexpr\textwidth-2.5cm\relax}
%%%\begin{exampleonly}
%%%\documentclass{article}
%%%\usepackage{fontspec}
%%%\usepackage[pmfont={Noto Serif KR}]{pmhanguljamo}
%%%\begin{document}
%%%Say `Hello' in Korean, 
%%%\jamoword{an/nyex/ha/sey/yo}.
%%%\end{document}
%%%\end{exampleonly}
%%%%\end{boxedminipage}
%%%%\caption{article에서 pmhanguljamo을 쓰는 예}\label{fig:sample}
%%%%\end{figure}
%%%
%%%\bigskip
%%%
%%%\pkg{polyglossia}와 함께 사용하는 것도 잘 된다.
%%%%\footnote{\pkg{polyglossia}는 \XeLaTeX 에서만 사용 가능하다.}
%%%다음은 이 경우의 한 설정 방법이다.
%%%(이 보기에서는 한국어를 other language로 설정하고 있는데 만약 main language로 설정한다면
%%%\env{korean} 환경 안이 아니라도 한글 폰트가 적용된다.)
%%%\pkg{polyglossia}를 사용하여 \env{korean} 환경에서
%%%쓰게 되면 한국어 조판에 필요한 상당한 지원이 이루어진다.
%%%
%%%\pkg{polyglossia}에서 한국어 설정을 행한 경우에는 \cmda{\hangulfont}로
%%%한글 식자를 행하므로 별도로 \texttt{pmfont}를 설정하지 않아도 된다.
%%%\cmda{\hangulfont}를 지정할 때에 \texttt{[Script=Hangul]}을 빼먹지 않도록 한다.
%%%그러나 한국어가 mainlanguage라면 \texttt{pmfont}를 이용하여 
%%%자모 식자를 하도록 강제할 수 있다.
%%%
%%%
%%%만약에 \env{korean} 환경이 시작되면 그 안에서는 (무조건) pm 자모 입력 모드가 되도록 하려면
%%%다음 코드를 preamble에 두면 된다.
%%%
%%%\begin{boxedverbatim}
%%%\usepackage{etoolbox}
%%%\apptocmd\korean{\begin{jamotext}}{}{}
%%%\pretocmd\endkorean{\end{jamotext}}{}{}
%%%\end{boxedverbatim}
%%%
%%%이제 다음과 같이 간단히 입력할 수 있다.
%%%
%%%\begin{verbatim}
%%%\begin{korean}
%%%na/ras/mar/ss@/mi 
%%%\end{korean}
%%%\end{verbatim}
%%%
%%%%그러나 위의 처방은 이 환경 안의 모든 로마자가 한글이라는 확신이 있을 때만 적용해야 할 것이다.
%%%%\env{korean} 환경 안에서 로마자를 입력해야 할 일이 있을지 모르기 때문이다. 

\section{활용 예문}

\subsection{훈민정음 어제 서문}

훈민정음 어제 서문을 입력한 예를 보여두겠다. 이 예문은 ``\href{http://wiki.ktug.org/wiki/wiki.php/%ED%9B%88%EB%AF%BC%EC%A0%95%EC%9D%8C%EC%96%B8%ED%95%B4}{정본 훈민정음 언해 전자문서화 프로젝트}''의 결과물을 바탕으로 하였다.

\begin{examplebelow}
\begin{jamotext}
	世syeiq;宗jof/御feq;製jyeiq;
	訓hun;民min/正jyef;音xvm
	
	na/ras;mar:ss@/mi;
	中dyuf/國guig;ei; dar/a;
	文mun/字jj@q;oa;ro; se/rv/ s@/m@s/di; a/ni;h@r/ss@i;
	i;ren jyen/c@;ro; e/rin; 百b@ig;姓syef;i; 
	ni/rv/go;jye; horx; bai; i/sye;do;
	m@/c@m;nai: jei bdv;dvr; si/re; pye/di; mod:h@rx no;mi; ha/ni;ra;

	nai; i;r@r; 爲uiq;h@;ya; e:yes/bi; ne/gye;
	sai;ro; sv;mur;ye/dvrb; 字jj@q;r@r; m@if/g@;no/ni;
	sa:ram/ma:da; h@i:qqye; su:bqi; ni/gye; nar;ro; bsu;mei; 
	便bbyen/安xan/kvi; h@/go;jye; h@rx sd@/r@/mi;ni/ra;
\end{jamotext}
\end{examplebelow}

%\begin{quote}
%\begin{jamotext}
%	世syeix;宗joq/御qex;製jyeix;
%	訓hun;民min/正jyeq;音fvm
%	
%	na/ras;mar:ss@/mi;
%	中dyuq/國guig;ei; dar/a;
%	文mun/字jj@x;oa;ro; se/rv/ s@/m@s/di; a/ni;h@r/ss@i;
%	i;ren jyen/c@;ro; e/rin; 百b@ig;姓syeq;i; ni/rv/go;jye; horf; bai; i/sye;do;
%	m@/c@m;nai: jei bdv;dvr; si/re; pye/di; mod:h@rf no;mi; ha/ni;ra;
%
%	nai; i;r@r; 爲uix;h@;ya; e:yes/bi; ne/gye;
%	sai;ro; sv;mur;ye/dvrb; 字jj@x;r@r; m@iq/g@;no/ni;
%	sa:ram/ma:da; h@i:xxye; su:bxi; ni/gye; nar;ro; bsu;mei; 
%	便bbyen/安fan/kvi; h@/go;jye; h@rf sd@/r@/mi;ni/ra;
%\end{jamotext}
%\end{quote}

\subsection{\bnm{문장강화} 예문}

\begin{examplebelow}
\jamoword{sai/mar/vr man/dvr/go sai/mar/vr ssv/nvn/ges/vn yu/haiq/i
a/ni/ra yu/haiq/i/saq em/sug/ha/gei saiq/hoar/ei pir/yo/ha/ni/gga 
na/ta/na/nvn sa/sir/im/vr i/hai/hai/ya har/ges/i/da/. 
ke/qpi/\textemdash/rvr meg/nvn saiq/hoar/bu/te/ga saiq/gi/go}
\dotemph{\jamoword{pe/me/nein/tv}}\jamoword{sig/v/ro
me/ri/rvr ji/ji/nvn saiq/hoar/bu/te/ga saiq/gi/ni/gga ge/gi/ei
jeg/vq/han mar jvg} \snm{\dotemph{\jamoword{ke/qpi/\textemdash}}}
\snm{\dotemph{\jamoword{pe/me/nein/tv}}}\jamoword{ga
saiq/gi/nvn/ges/i/da/.}
\end{examplebelow}

이 예시의 \cs{snm}은 \pkg{oblivoir} 명령이고 \cs{dotemph}는 \koTeX\ 명령이다.


\chapter{method=rrk}\label{chap:rrk}

\section{표준 로마자 표기법 전자법 입력}\label{sec:rrk}

\let\Ajamoword\jamoword
\let\Ajamotext\jamotext
\let\endAjamotext\endjamotext
\let\jamoword\relax
\let\jamotext\relax
\let\endjamotext\relax
\ExplSyntaxOn
\input {pmhanguljamo-rrk.sty}
\ExplSyntaxOff

패키지 옵션으로 \verb|[rrk]| 또는 \verb|[RRK]|가 주어지면 입력 규칙이 표준 로마자 표기법 전자법 방식으로
바뀐다. 전자법(transliteration method, 轉字法)이란 ``국어의 로마자 표기법'' (1998:2000) 제3장 제8항에서
\begin{quote}
학술 연구 논문 등 특수 분야에서 한글 복원을 전제로 표기할 경우에는 한글 표기를 대상으로 적는다. 이때 글자 대응은 제2장을 따르되 ‘ㄱ, ㄷ, ㅂ, ㄹ’은 ‘g, d, b, l’로만 적는다. 음가 없는 ‘ㅇ’은 붙임표(-)로 표기하되 어두에서는 생략하는 것을 원칙으로 한다. 기타 분절의 필요가 있을 때에도 붙임표(-)를 쓴다.
\end{quote}
라 규정한 방법을 말한다.\footnote{\url{https://www.korean.go.kr/front/page/pageView.do?page_id=P000150&mn_id=99}}
RRK는 이 문서의 영어 명칭인 \emph{Revised Romanization of Korean}의 첫 글자를 딴 것이다.
국어의 로마자 표기는 전음법이 원칙이고 전자법은 예외 규정이다. 그러나 한글의 입력 방법으로서 이를 쓰려 하는 한
전음법은 사용할 수 없다.

전자법 입력은 오직 현대어에만 적용된다. 따라서 옛한글은 이 방법으로 입력할 수 없다. (아래아 입력을 가능하게 한 것은
아래를 참조.)

\section{RRK 전자 규칙}

\begin{table}[h]
\centering
\ttfamily
\begin{tblr}{
	colspec={llllllll},
	hline{1,2,Y,Z}={azure3},
	vline{3,5,7}={azure3},
}
\SetCell[c=8]{c}{자음}\\ 
ㄱ & g  & ㄲ & kk & ㅋ & k  & ㄷ & d \\
ㄸ & tt & ㅌ & t  & ㅂ & b  & ㅃ & pp \\
ㅍ & p  & ㅈ & j  & ㅉ & jj & ㅊ & ch \\
ㅅ & s  & ㅆ & ss & ㅎ & h  &    & \\
ㄴ & n  & ㅁ & m  & ㅇ & ng & ㄹ & l \\
\SetCell[c=8]{c}{\phantom{a}}
\end{tblr}\hfil
\begin{tblr}{
	colspec={llllllll},
	hline{1,2,Z}={azure3},
	vline{3,5,7}={azure3}
}
\SetCell[c=8]{c}{모음} \\ 
ㅏ & a  & ㅓ & eo  & ㅗ & o  & ㅜ & u \\
ㅡ & eu & ㅣ & i   & ㅐ & ae & ㅔ & e \\
ㅚ & oe & ㅟ & wi  &   &     &   & \\ 
ㅑ & ya & ㅕ & yeo & ㅛ & yo & ㅠ & yu \\
ㅒ & yae & ㅖ & ye & ㅘ & wa & ㅙ & wae \\
ㅝ & wo & ㅞ & we  & ㅢ & ui &    &  \\ 
\end{tblr}
\end{table}


\begin{enumerate}[(1)] \firmlist
\item 단어의 첫소리 `ㅇ'은 적지 않는다. 그밖의 초성 이응은 \verb|-|로 적는다. \\
\verb|\jamoword{annyeonghase-yo}|. \jamoword{annyeonghase-yo}.\\
\verb|\jamoword{na bogiga yeoggyeo-wo gasil ttae-eneun}| 
\jamoword{na bogiga yeoggyeo-wo gasil ttae-eneun}

\item 표준의 규정 대로 \verb|-|는 음절의 분철을 위해서 입력할 수 있다. 한편,
표준의 규정에는 없지만 음절 구분을 위한 \verb|/|를 사용할 수 있다. 음절 분리자가 쓰인
경우에는 초성 이응을 생략할 수 있다. \\
\verb|\jamoword{iss-eoss-seubnida}|. \jamoword{iss-eoss-seubnida}. \\
\verb|\jamoword{annyeonghase/yo}|. \jamoword{annyeonghase/yo}. \\
\verb|\jamoword{annyeonghase-yo}|. \jamoword{annyeonghase-yo}.

\item 모음과 모음 사이에 `ㅅ'이 세 개 오는 경우에는 쌍시옷 받침과 초성 시옷으로 분해한다. 만약 어떤 이유에선가 이 분철방법을
바꾸어야 한다면 \verb|-|나 음절 분리 부호를 쓰도록 하라. 강제 분철이 필요한 경우에도 마찬가지이다.\\
\verb|\jamoword{haessseubnida}|. \jamoword{haessseubnida}. \\
\verb|\jamoword{gas/sseun, mal/sseum}|. \jamoword{gas/sseun, mal/sseum}. \\
\verb|\jamoword{gas-sseun, mal-sseum}|. \jamoword{gas-sseun, mal-sseum}.

\item 문장 부호는 \texttt{.}, \texttt{,}, \texttt{!}, \texttt{?}, 
\texttt{;}, \texttt{:} 이 여섯 개에 한하여
인자 범위 안에서 입력할 수 있다. 다른 것은 오지 못한다. 특히 줄표(\texttt{-})는 인자 범위 안에 넣으면 안 된다.\\
\verb|\jamoword{swimpyo, machimpyo. a! geulae? olhda.}| \jamoword{swimpyo, machimpyo. a! geulae? olhda.} \\
따옴표는 분리부호를 두면 된다. \verb|\jamoword{``/ulinala/''}| \jamoword{``/ulinala/''}.
%그런데 소위 “스마트 따옴표”를 이용하여 유니코드 따옴표를 입력한다면 음절 분리 부호를 이용하여 다음과 같이 할 수 있다. \\
%\verb|\jamoword{“/ulinala/”}| \jamoword{“/ulinala/”} \\
이 때의 음절 분리 부호는 하이픈 부호로 대치할 수 없다.

\item 현대어만 입력할 수 있는 것이 원칙이지만 이 패키지는 편의를 위해 아래아(와 쌍아래아)를 식자할 수 있게 하였다.
아래아는 \verb|@|로, 쌍아래아는 \verb|@@|로 적는다. 다른 옛한글 문자는 입력할 수 없다. \\
\verb|\jamoword{h@ngeul}| \jamoword{h@ngeul}. \\
\verb|\jamoword{@@nam-eun}| \jamoword{@@nam-eun}. \\
단 `\jamoword{x@}' 글자만으로 한 단어를 이룰 때 \verb|@| 문자의 성격 때문에 음절이 만들어지지 않을 수 있다. 이럴 때는 예외적으로 \verb|x|를 앞에 붙여 \verb|x@|와 같이 입력한다. 받침이 붙거나 다음 음절이 이어지는 때에는 \verb|x|를 붙일 필요 없다.\\
\verb|\jamoword{x@ x@@ @n @@n}|. \jamoword{x@ x@@ @n @@n}.\\
이로써 이 패키지의 RRK 방식
입력으로도 제주어를 적을 수 있다. 
\item 초성 자리에 (실수로) l 대신 r이 오더라도 `ㄹ'이 적히도록 하였다. \\
\verb|\jamoword{ri-eul li-eul}|. \jamoword{ri-eul li-eul}.
\end{enumerate}

\section{현대문 RRK 입력 예제}

\begin{boxedverbatim}
\begin{verse}
\begin{jamotext}
nae salanghali siwol-ui gangmul-eul \\
seog-yang-i jit-eoganeun puleun molaetob \\
jinan nal gajyeossdeon seulpeun yeojeongdeul-eul, adeughan gidaeleul \\
ijeneun hollo nam-a ttatteus-i gidalili.
\end{jamotext}
\end{verse}
\end{boxedverbatim}

\begin{verse}
\begin{jamotext}
nae salanghali siwol-ui gangmul-eul \\
seog-yang-i jit-eoganeun puleun molaetob \\
jinan nal gajyeossdeon seulpeun yeojeongdeul-eul, adeughan gidaeleul \\
ijeneun hollo nam-a ttatteus-i gidalili.
\end{jamotext}
\end{verse}

%비교를 위하여 이 패키지의 고유한 pm 입력 방식으로 제시해보면 다음과 같다.
%
%\begin{verbatim}
%nai sa/rax/ha/ri si/uer/vi gax/mur/vr \\
%seg/yax/i jit/e/ga/nvn pu/rvn mo/rai/tob \\
%ji/nan nar ga/jyess/den svr/pvn ye/jex/dvr/vr/, a/dvg/han gi/dai/rvr \\
%i/jey/nvn hor/ro nam/a dda/ddvs/i gi/da/ri/ri/.
%\end{verbatim}

\section{RRK 입력으로 20세기 초반 문헌 조판}

원칙적으로 RRK 입력은 현대 한글 문자, 즉 1933년 이후 표기법만을 지원하지만
1933년의 `한글마춤법통일안'이 제정되기 직전 시기의 문헌을 이 입력 방법으로 일부
조판할 수 있게 하였다. 이를 위하여 version 0.4에서 다음 조치가 이루어졌다.
\begin{itemize}\oblivoirlist
\item 아래아(\jmcc{W})를 입력할 수 있다. 그리고 제주어 조판을 위하여 쌍아래아(\jmcc{WW})를 지원한다.
\item 된소리 표기를 위한 `ㅅ'을 지원한다. 즉 \texttt{sgos}과 같이 입력하여 `\jamoword{sgos}'을 얻을 수 있다.
\item 종성 자모 일부를 보충하였다.
\end{itemize}
ㅅ-된소리를 적을 때 주의할 점은 어두가 아니라면 그 전에 음절 분리표지(\texttt{-} 또는 \texttt{/})를
붙여아 할 것이라는 점이다. 예컨대 
\begin{verbatim}
jindalnaesgos, jindalnae-sgos
\end{verbatim}
이 두 가지 입력은 각각 \jamoword{jindalnaesgos}, \jamoword{jindalnae-sgos}으로
출력된다.

김소월의 진달래꽃 일부를 1925년 초간 당시 표기법으로 보이면 다음과 같다.

\begin{boxedverbatim}
\begin{jamotext}
nabogiga yeoggyeowo
gasil-sdae-eneun
mal-eobsi gohi bonaedeuli-ulida.
\end{jamotext}
\end{boxedverbatim}

\begin{quote}
\begin{jamotext}
nabogiga yeoggyeowo \\
gasil-sdae-eneun \\
mal-eobsi gohi bonaedeuli-ulida.
\end{jamotext}
\end{quote}

또다른 예로 \cnm{열녀춘향수절가}의 일부이다.

\begin{boxedverbatim}
\begin{jamotext}
chucheon-eul h@lyah@go sangdan-i abse-ugo nalyeo-ol je
nanchogaschi goheun meoli du gwileul nulneo gobge
sda-a geumbongch@ileul jyeongjeh@go na-un-eul dul-un heoli
miyang-ui ganneun beodeul sim-i eobseo dui-un deus
aleumdabgo go-eun t@ido ajanggeoleo heuneulgeolyeo
gamangaman na-ol jeogui jang-im sog-eulo deul-eogani
nog-eumbangcho ugeojyeo geumjandi jwaleuleug sgal-in jye
\end{jamotext}
\end{boxedverbatim}

\begin{quote}
\begin{jamotext}
chucheon-eul h@lyah@go sangdan-i abse-ugo nalyeo-ol je
nanchogaschi goheun meoli du gwileul nulneo gobge
sda-a geumbongch@ileul jyeongjeh@go na-un-eul dul-un heoli
miyang-ui ganneun beodeul sim-i eobseo dui-un deus
aleumdabgo go-eun t@ido ajanggeoleo heuneulgeolyeo
gamangaman na-ol jeogui jang-im sog-eulo deul-eogani
nog-eumbangcho ugeojyeo geumjandi jwaleuleug sgal-in jye
\end{jamotext}
\end{quote}

이런 종류의 문헌을 조판하려면 당연히 \ref{chap:fonts}장에서 설명한 바,
옛한글을 지원하는 글꼴이어야 한다.


\chapter{method=frkim}\label{chap:frkim}

\ExplSyntaxOn
\cs_undefine:N \l_inputword_seq
\cs_undefine:N \l_inputpar_seq
\cs_undefine:N \jamotext
\cs_undefine:N \endjamotext
\cs_undefine:N \jamo_word:nn
\cs_set_eq:NN \frkhangulfont \opt_pmfont_tl 
\cs_set_eq:NN \frkhangulfontfeature \opt_pmfontfeature_tl
\input{pmhanguljamo-frkim.code.tex}
\ExplSyntaxOff

이 장은 원래 독립적으로 작성하였던 문서였다.

\section{후쿠이 레이 로마자 전사법과 \pkg{hangul\protect\TeX}}

\href{https://ja.wikipedia.org/wiki/%E7%A6%8F%E4%BA%95%E7%8E%B2}{\hg{후쿠이 레이(福井玲)}} \hg{교수가 
고안한 한국어(조선어) 로마자 표기법을 ``후쿠이 레이 로마자 전사법\rq\rq 이라 한다.}\footnote{\url{http://www.tufs.ac.jp/ts/personal/choes/korean/middle/Nfukui.html}}
우리나라의 국가 표준인 한국어 로마자 표기법과는 그 목적을 달리하여 학술적 목적에 쓰기 위한 것이다.
한국어의 `음성\rq 이 아니라 `문자 표기\rq 를
로마자로 나타내는 것이라서 소위 `전자법(轉字法)\rq 과 그 목적이 같다. 한국어 한글 표기의 철자를 축자적으로(\emph{literally}) 
로마자 표기하는 것이다.

이 표기법은 현대 한국어와 중세 한국어 한글 표기를 모두 포괄한다.

축자적 표기법이기 때문에 이를 한국어 입력의 대응 문자로 쓸 수 있다. 실제로 이를 \TeX 으로 구현한 것이
후쿠이 레이 교수 자신이 만든 hangul\TeX{} (1993)이라는 것이었다.\footnote{\url{http://www.vector.co.jp/vpack/filearea/dos/writing/tex/koreatex/index.html}. 이 한글 매크로 패키지의 이름은 \jpwrd{ハングル\,TeX}이다. 이를  Korean\TeX 이라고 하기도 했던 모양이나 이 글에서는 `hangul\TeX'이라고 지칭한다. 현재 찾아볼 수 있는 1.2.1 버전은 1994년 4월에 공개되었던 것이며 \LaTeX{} 2.0.9에서 동작했다.} 
필자가 이를 \LaTeXe 용으로 수정하여 테스트한 바도 있다.\footnote{frk\TeX 에 대하여는 \url{http://faq.ktug.org/faq/pLaTeX}.}

\section{사용법}

\subsection{패키지 활성화와 명령}

이 패키지는 단독으로 로드할 수 있다.

\begin{exampleonly}
\usepackage[<options>]{pmhanguljamo-frkim}
\end{exampleonly}

또는 pmhanguljamo 패키지의 옵션으로 부를 수 있다(\pkg{pmhanguljamo} version 0.6 이상).

\begin{exampleonly}
\usepackage[method=frkim,<options>]{pmhanguljamo}
\end{exampleonly}

\verb|<options>| 자리에 올 수 있는 옵션은 다음과 같고, 각 내용은 해당
절에서 설명한다.
\begin{description}
\item [\ttfamily zeroisx] 초성의 zero 자음을 \verb|x|로 표현하게 하는 것이다. default는 false.
\item [\ttfamily hangulfont] \cs{hg} 명령으로 식자되는 한글 폰트를 지정한다.
\item [\ttfamily hangulfontfeature] 한글 폰트에 주어지는 feature이다.
\item [\ttfamily frcccmds] 호환 자모 식자를 위한 명령을 미리 activate하도록 하는 옵션이다.
\end{description}

\bigskip

이 패키지의 핵심 명령은 다음 두 가지이다.
\begin{description}
\item [\cs{hg}] 한글 자모를 알파벳으로 입력하는 명령이다. \cs{jamoword}와 같다.
\item [\cs{hangul}, \cs{endhangul}] 여러 문단에 대하여 \cs{hg}를 실행하는 것과 같다.
\item [\env{jamotext}] 환경 형식으로 쓸 수 있다.
\end{description}

\cs{hg}와 \cs{hangul}은 \pkg{hangul\TeX} 호환 명령이다. 예전 \pkg{hangul\TeX} 또는
\pkg{frktex}으로 입력된 텍스트를 수정없이 식자하기 위하여 작성된 것으로서, 다른 입력 방식에서는
제공하지 않는다. 한편, \cs{jamoword}와 \env{jamotext}는 \texttt{method=frkim}에서도
동작한다.

\pkg{pmhanguljamo}의 기본 입력 방식인 \texttt{method=pm}에 비하여, 아스키 에스케이프 트릭이 없으며 \XeLaTeX 에서의 밑줄 긋기가 원활하지 않다\footnote{밑줄이 반드시 필요하면 \LuaLaTeX 으로 컴파일하라.}는 차이가 있다.

\bigskip

다음 명령들은 편의를 위하여 제공하는 부수 명령들이며, 각각 해당 절에서 설명한다.
\begin{description}
\item [\cs{frcc}] 한글 호환 자모 한 개를 식자하는 명령이다. 인자로는 한글 자모를 나타내는 기호가 온다. 이 명령은 \cs{hg} 명령의 인자 안에서 쓰이면 안 되고 반드시 \cs{hg}의 인자 범위 밖에 놓여야 한다.
\item [\cs{rq}] right quote를 인쇄하는 명령이다. \cs{hg} 인자 내부에 닫는 따옴표를 쓸 필요가 있으면 이 매크로를 사용한다.
\item [\cs{zeroisx}, \cs{zeroisrq}] 초성의 zero 자음을 어떤 부호로 식자할 것인지를 나타낸다. \cs{zeroisrq} 상태가 디폴트이다.
\item [\cs{frdash}, \cs{frendash}, \cs{fremdash}] \verb|-|(dash) 부호를 특별하게 처리하기 때문에 이를 대용하기 위하여 마련한 명령이다.
\item [\cs{frkhangulfont}] 자모 한글을 식자하는 폰트이다. Noto Serif KR 폰트가 디폴트이다. 
\item [\cs{frkhangulfontfeature}] \cs{hg} 명령의 인자로 주어지는 한글을 식자하기 위한 \cs{frkhangulfont}에 부여되는 font feature이다. ``{\ttfamily Script=Hangul,Renderer=OpenType,Ligatures=TeX}''이 디폴트로 선언되어 있다.
\end{description}


\subsection{한글 입력 체계}

\begin{table}[h]
\centering\small
\caption{\pkg{hangul\TeX}\hg{'yi hangyr romaja dai'yq giucig}}\label{tab:ktex}
\ttfamily
\begin{tblr}{
	colspec={llllllllll},
	hline{1,Z}={1pt},
	hline{2-Y}={\normalrulethickness},
	vline{3,5,7,9}={\normalrulethickness},
}
\SetCell[c=10]{c,bg=azure5,fg=white}자음 &&&&&&&&&\\
ㄱ & g & ㄴ & n & ㄷ & d & ㄹ & r & ㅁ & m \\
ㅂ & b & ㅅ & s & ㅇ & 'x & ㅇ & q & ㅈ & j \\
ㅊ & c & ㅋ & k & ㅌ & t & ㅍ & p & ㅎ & h  \\
ㄲ & G & ㄸ & D & ㅃ & B & ㅆ & S & ㅉ & J \\
ㅸ & v & ㅿ& z & ㆁ & Q & ㆆ & X & & \\
\SetCell[c=10]{l} &&&&&&&&& \\
\end{tblr}
\hfil
\begin{tblr}{
	colspec={llllllll},
	hline{1,Z}={1pt},
	hline{2-Y}={\normalrulethickness},
	vline{3,5,7,9}={\normalrulethickness},
}
\SetCell[c=8]{c,fg=white,bg=azure5}모음 &&&&&&&\\
ㅏ & a  & ㅓ & e   & ㅗ & o   & ㅜ & u  \\
ㅡ & y  & ㅣ & i   & ㆍ & @   & ㅑ & ia  \\
ㅕ & ie & ㅛ & io  & ㅠ & iu  & ㅐ & ai \\
ㅔ & ei & ㅒ & iai & ㅖ & iei & ㅘ & oa \\
ㅙ & oai & ㅚ & oi & ㅝ & ue  & ㅞ & uei \\
ㅟ & ui  & ㅢ & yi & ㆎ & @i  &    &  \\
\end{tblr}
\end{table}

이 패키지는 \tref{tab:ktex}에 보인 \pkg{hangul\TeX}의 입력 방식을 채택하고 있으며,
한글 문자에 해당하는 부분을 \cs{hg} 명령의 인자로 전달하는 것도 같다.
여기에 다음과 같은 몇 가지 부수적인 규칙을 추가하였다.

\begin{enumerate}[\quad(1)]
\item 초성 위치에 오는 `\texttt{ㅇ}' 즉 zero 자음을 right quote(\texttt{'})로 
표현하는 것이 디폴트이다. 이럴 경우에 right quote 자리에 \cs{rq} 명령을 쓸 수 있다.
만약 right quote를 써야 할 일이 많아서 zero 자음을 \texttt{x}로 대용하고 싶다면
\cs{zeroisx}를 선언한다. \cs{zeroisrq} 명령으로 이를 되돌릴 수 있다. 이상은 \pkg{hangul\TeX}에서와 동일하다.
\verb|\hg{u'eq}| \hg{u'eq}, \verb|\zeroisx\hg{xuxeq}| \hg{xuxeq}.

\activatefrcccmds
\item 받침(종성) `\texttt{ㅇ}'은 \texttt{q}로 쓴다. 옛이응(\texttt{\frccQ})은 \texttt{Q}. 초성 자리에 올 때에도 같다.

\item 단어의 첫머리에 오는 zero 자음은 생략할 수 있다. 즉 \texttt{'annieq}과 \texttt{annieq}은 그 결과가 같다($\implies$\hg{annieq}). 그러나 단어 중간의 초성 \texttt{ㅇ}은 생략할 수 없다.

\item \pkg{hangul\TeX}에서는 자음이나 모음만을 \cs{hg} 명령으로 표현할 수 있었으나 이 패키지에서는 반드시 모음이 존재하여 음절을 채워야 한다. 그래서 하나의 초성 또는 중성만을 표현하려면 중성 또는 초성을 filler 문자로 채워주어야 하는데, 초성 filler는 \texttt{w}, 중성 filler는 \texttt{*} 문자를 쓴다. (이것은 \pkg{pmhanguljamo}에서와 같다.) \verb|\hg{g*}| $\implies$ \hg{g*}, \verb|\hg{wa}| $\implies$ \hg{wa}. 모음만을 표시하려 할 때 초성 필러를 써야 하는 이유는 모음으로 시작하는 단어에
zero 자음 \texttt{ㅇ}을 넣는 규칙 때문이다.

\item \pkg{hangul\TeX}에 비하여 좀더 확장된 옛한글 표현을 지원한다. 옛한글 입력과 관련하여 초성에 복자음이 오는 경우에, 그 복자음은 (단어 첫머리가 아니라면) 반드시 \verb|-|로 그 시작 위치를 밝혀주어야 한다. 단어의 첫머리 자리에서는 이것을 생략할 수 있다. \verb|\hg{gy bsgyi}| $\implies$ \hg{gy bsgyi}, \verb|\hg{gy-bsgyi'iei}| $\implies$ \hg{gy-bsgyi'iei}. 이 대시 부호를 생략하면 다음과 같이 잘못된 결과가 나타난다. \hg{gybsgyi'iei}.

\item 문장 중에 \verb|-|(dash)를 프린트해야 한다면 \cs{frdash} 명령을 쓴다.\\ \verb|\hg{ga\frdash na\frendash da\fremdash ra}| $\implies$ \hg{ga\frdash na\frendash da\fremdash ra}

\item 옛한글의 방점(성조점)은 지원하지 않는다. 더 자세한 사항은 \pageref{para:bangjeom} 페이지를 볼 것.

\item 제주어 표기를 위한 `\hg{w@@}'를 추가하였다. 이 글자는 \verb|@@|로 쓴다. 예: \verb|\hg{@@nam'yn}| $\implies$ \hg{@@nam'yn}.

\item 숫자, 한자 등 알파벳이 아닌 문자와 인자를 취하지 않는 protected 매크로는 투명하게 전달되고 처리된다. 다만 인자를 취하는 명령은 그렇지 않으므로 주의를 요한다.

\end{enumerate}

\section{용례}

\paragraph{현대 한글} 현대 한글의 입출력 예를 보인다.

\begin{examplebelow}
\hg{caig'yr hanguen gajigo iS'eSji'io. Gaman pioji'ei 
	sonbadagmanhan jag'yn caig'iji'io. cesjaq'yr nemgimien
	nun'i nairigon haji'io.}

\hg{baramdo jamdyn supsog, jamdyn hiensasinamudyr tumieqhan
	murgoanman Gai'e iS'eSji'io. gajaq kygo uramhan sasinamu 
	mit'ei daqsin'yn memcu'eSji'io. daqsin'i namuduqci'ei 
	dyq'yr gidaija biroso nun'i nairigi sijaghaiSji'io.
	edi'eidyn dahgiman hamien nog'aberinyn nun.
	gyDaiJym haise Gocnun'i Gai'enaSgeiSji'io.}
\end{examplebelow}

\cs{hangul}을 이용하여 입력한 예.

\begin{examplebelow}
\hangul
nydas'ebs'i hoiram'i morgo'on pamun'yn 'yi'oiro simgaghan 
ges'i'ese goanrigoa samusir'yi 'ohu najer'yr 'oanjenhi 
gierDannai noh'aSda. goanrigoa jig'uendyr'i GiriGiri mo'ie 
juqgunanbaq'yro Sod'a noh'yn mardyr'yn doro ju'uedam'a 
bomien daicuq 'ui'oa gat'yn nai'ioq'i doigeiSnyndei, 
murron gy ga'undeinyn mindosig'i Siburiedain burpieqdo
saqdaq bubun'yr cajihago 'iS'eSda.

mindosig'yn juro 'os'i nargairanyn jenrai'yi sogdam'yr 
dyr'e gyren joqriu'yi nargairyr dargonyn seisaq'yr huerhuer
nar'adanir su 'ebs'ym'yr nunu'i gaqjohanyn pien'i'eSda. 
gy'yi mar'yn sasaiqhoar'i 'ebs'ejinyn seim'iranyn coqgag
sa'uen 'ugihoan'yi jujaqgoa majbaro toqhaiSda.
\endhangul
\end{examplebelow}

위의 예문은 \emph{hangulTeX}의 사용설명서에 있던 예문을 그대로 가져온 것이다.
이 패키지의 방식으로는 단어 첫머리의 quote를 다 생략할 수 있으니 조금 더 수고가 줄어든다.

\paragraph{\cs{rq}의 사용}

닫는 따옴표는 \cs{rq} 매크로를 써야 한다. \cs{zeroisx}는 기억을 위한 코드일 뿐이고
내부적으로 사실상 \verb|x|와 \verb|'|를 거의 동일하게 취급하기 때문이다.
그러나 되도록 따옴표와 같은 문장부호는 \cs{jamoword}(=\cs{hg}) 명령 밖에 두는 것이 좋다.

\begin{examplebelow}
\hg{``'erin'inyn nara'yi bobai'ibnida\rq\rq{} sopa 
`baqjeqhoan\rq{} sensaiqnim'i hasin marSym'ida.}
\end{examplebelow}

\paragraph{19세기--1933년 이전 표기법}
주로 `아래아'와 몇 가지 복자음이 쓰이는 문헌의 예이다.

\begin{examplebelow}
\hg{nagpo'yi sdar'irnienni bando jinsaq oggieq gasda 
	goaqhanjien'yisie jiegsoqja masna mijinjieqhoi
	h@'orca'yi simanh@mi joiga doi'ia siaqjiei d@irohasa
	jintoi'yi n@icisim@i gar ba'yr mornadeni du'iusan
	sir'ieqgieisie bu'in-sd@ig'yro jisih@giro oassa'oni
    e'iebbi iegisosie}
\end{examplebelow}

\paragraph{성조점이 있는 옛한글}\label{para:bangjeom}

\texttt{[method=pm]}에서와 달리 성조점(방점)을 직접 지원하지는 않지만 이를 활용하고자 한다면 다음과 같은 방법이 
가능하다. \verb|:|와 \verb|;| 두 글자의 catcode를 바꾸는 것이므로 텍스트에 이 부호가
들어 있지 않아야 한다는 점에 주의해야 한다. %이 부호의 사용은 \pkg{pmhanguljamo}에서와 같다.

\begin{examplebelow}
\catcode`\:=\active \catcode`\;=\active
\def:{\char"302F}\def;{\char"302E}
\hg{naras;mar:S@mi; 中diuQ國guig;'ei; dar'a;
    文mun字J@q;'oa;ro; sery s@m@sdi; ani;h@rS@i;
    i;ren jienc@;ro; erin; 百b@ig;姓sieQ;'i nirygo;jie;
    horX; bai; isie;do m@c@m;nai: jei bdy;dyr 
    sire; piedi; mod:h@rX no;mi; hani;ra.}
\end{examplebelow}

\paragraph{호환 자모를 사용하는 경우}

호환 자모는 \cs{frcc} 명령으로 식자할 수 있으나 \cs{hg} 인자 범위 밖에 놓여야 한다는 사실을 기억하자. 다음 예를 보라.

\begin{examplebelow}
\hg{niei 洞庭(doqjeq)}\frcc{s}\ \hg{myryr dyddani},\\
\hg{on@r 岳陽樓('ag'iaqru)'yi or'ora}.
\end{examplebelow}

또는, \cs{hg} 명령의 인자 안에 ``인자를 취하지 않는 단독 매크로''가 오는 것은 문제없음을 이용하여, 자주쓰는 몇 가지 호환 자모를 미리 하나의 매크로로 정의하여 쓰는 방법도 있다.
\cs{activatefrcccmds}를 선언하면 이런 종류의 매크로를 한꺼번에 만들어준다.
패키지 옵션으로 \verb|[frcccmds]|를 부여하면 문서의 처음부터 \cs{activatefrcccmds} 상태가 된다.

\begin{examplebelow}
\activatefrcccmds
\hg{m@iQj@\frcci\ g@r'@siad@i}\\
\hg{\frccg n@n emSorini}\\
\hg{g*n@n emSorini}
\end{examplebelow}

위의 마지막 예는 호환 자모를 쓰지 않고 낱자를 나타낸 것이다. 대체로 이것으로 된다고 생각하기 때문에 \cs{activatefrcccmds}를
디폴트로 활성화시켜 두지 않은 것이다.

\section{폰트}

\paragraph{\pkg{pmhanguljamo}에서 옵션으로 부르는 경우}
\texttt{[pmfont]}로 설정한 폰트가 \cs{frkhangulfont}가 된다.

\paragraph{단독 패키지로 로드한 경우}

다른 글꼴로 식자하려 한다면 
패키지 옵션으로 \verb|[hangulfont=<fontname>]|\allowbreak 을 부여한다.

\paragraph{문서 중에서}

\cs{setpmhangulfont}를 이용하면 폰트와 폰트 속성을 모두 바꿀 수 있다.
(단독 패키지를 로드하였다면 간단히 \cs{frkhangulfont} 매크로를 재정의하여도 된다.)

\begin{examplebelow}
\setpmhangulfont{HCR Dotum LVT}[Color=azure3,FakeStretch=0.7]
\hg{g@r@mi p@r@ni sai de'ug h@i'o / 
    moihi pereh@ni gosbici byrbydn@n d@sdoda /
    orsbomi bond@in sdo dinagan@ni / 
    eny nari i doragar h@i'o}
\end{examplebelow}


\chapter{입력 방법 요약}

세 가지 입력 방법은 서로 비슷한 듯하지만 조금씩 다르다. 조견표를 작성해둔다.

\section*{자음}

\def\AST{\textsuperscript{*}}
\def\DAG{\textsuperscript{$\dag$}}

\activatefrcccmds
\begin{tblr}{
	colspec={llllllllllll},
	hline{1,2,Y}={\normalrulethickness},
	vline{5,9}={1pt},
	vline{2,6,10}={dotted},
	row{odd}={azure8},
}
\SetRow{fg=white,bg=azure2,font=\bfseries}
자모 & pm & rrk & frkim & 자모 & pm & rrk & frkim & 자모 & pm & rrk & frkim \\
ㄱ  & g  & g   & g & ㄲ  & gg & kk & G & ㄴ  & n  & n   & n \\
ㄷ  & d  & d   & d  & ㄸ  & dd & tt  & D & ㄹ  & r  & l\AST & r \\
ㅁ  & m  & m   & m & ㅂ  & b  & b   & b & ㅃ  & bb & pp  & B  \\
ㅅ  & s  & s   & s & ㅆ  & ss & ss  & S & ㅇ(초) & (q)\DAG & -\DAG & '\DAG \\
ㅇ(종) & q & ng & q & ㅈ & j & j & j & ㅉ & jj & jj & J \\
ㅊ & c & ch & c & ㅋ & k & k & k & ㅌ & t & t & t \\
ㅍ & p & p & p & ㅎ & h & h & h & \frccQ & f & & Q \\
\frccz & z & & z & \frccX & x & & X & \frccv & bq & & v \\
\SetCell[c=12]{l}{\small\AST\ 초성 자리에서 l 대신 r을 쓸 수 있음\quad
\DAG\ 어두에 생략 가능} &&&&&&&&&&& \\
\end{tblr}

\section*{모음}

\begin{tblr}{
	colspec={llllllllllll},
	hline{1,2,Y}={\normalrulethickness},
	vline{5,9}={1pt},
	vline{2,6,10}={dotted},
	row{odd}={azure8},
}
\SetRow{fg=white,bg=azure2,font=\bfseries}
자모 & pm & rrk & frkim & 자모 & pm & rrk & frkim & 자모 & pm & rrk & frkim \\
ㅏ & a  & a   & a & ㅐ  & ay\AST & ae & ai & ㅑ  & ya &  ya  & ia \\
ㅒ & yay\AST & yae & iai & ㅓ & e & eo & e & ㅔ & ey\AST & e & ei \\
ㅕ & ye & yeo & ie & ㅖ & yey\AST & ye & iei & ㅗ & o & o & o \\
ㅘ & oa & wa & oa & ㅙ & oay\AST & wae & oai & ㅚ & oy\AST & oe & oi \\
ㅛ & yo & yo & io & ㅜ & u & u & u & ㅝ & ue & wo & ue \\
ㅞ & uey\AST & we & uei & ㅟ & uy\AST & wi & ui & ㅠ & yu & yu & iu \\
ㅡ & v & eu & y & ㅢ & vy\AST & ui & yi & ㅣ & i & i & i \\
\jmcc{AA} & @ & @\DAG & @ & \jmcc{AAI} & @i & @i\DAG & @i & \jmcc{AAA} & @@ & @@\DAG & @@ \\
\SetCell[c=12]{l}{\small \AST\ 말미의 y는 i로 대신할 수 있음(ay=ai, ey=ei, \ldots) \\
\DAG\ 국가 표준 로마자 표기법에는 없음} & &&&&&&&&&& \\
\end{tblr}



\chapter{제주어}

현대 제주어를 표기하려면 아래아(\jmcc{W})가 필요하다. 이 패키지를 
이용하여 제주어를 식자하는 예를 보이겠다.

\begin{boxedverbatim}
\jamoword{bu/jeis/jib/i/nan joq/nvm/der h@n @@/nam/vn d@r/aq sar/gog/.}
\end{boxedverbatim}

RRK 입력 방식으로는 다음과 같이 된다.

\begin{boxedverbatim}
\jamoword{bujesjib-inan jongneumdeol h@n @@nam-eun d@l-ang salgog.}
\end{boxedverbatim}

frkim 방식으로는,

\begin{boxedverbatim}
\jamoword{bujeisjib'inan joqnymder h@n @@nam'yn d@r'aq sargog.}
\end{boxedverbatim}

다음과 같은 결과를 얻는다.

\begin{quote}
\jamoword{bujeisjib'inan joqnymder h@n @@nam'yn d@r'aq sargog.}
(부잣집이니까 종놈들 한 여남은 데리고 살고)
\end{quote}

제주특별자치도에서 배포하는 제주서체는 (안타깝지만) 이 패키지와 더불어 사용할 수 없다.
왜냐하면 제주서체의 아래아 음절은 사용자 정의 영역(PUA)에 완성형 글자로 들어 있기
때문이다. 그것을 꺼내쓰기 위해서는 폰트의 사용자 영역을 열어놓고 필요한 글자를 가져다 쓰는
수밖에 없다. 폰트 설계가 만족스럽지 않다고밖에 말할 수 없겠다.

\chapter{결어와 후기}

\section{贅辭}

이 패키지를 만들게 된 사연이 이러하다.
Kubuntu 리눅스에서 옛한글이 사용되는 문서를 작성할 일이 있었다. \texttt{fcitx} 입력기가 기본으로 설치되어 있었는데
옛한글 입력이 되는 입력기를 설정하는 문제로 골머리를 썩이는 경험을 하게 된 것이다.
세벌식 자판 배열은 이미 잊은 지 오래. \texttt{nabi}는 크롬이나
QT에서 뭔가 이상하게 동작하거나 아예 한글 입력이 안 되거나\obellipsis.
\LaTeX\ 문서인데 굳이 입력기가 필요한가 생각이 들어 간단히 로마자 대응 입력(transliteration)으로 한글과 옛한글을
입력하도록 하면 이 문제로 시간낭비하지 않아도 되지 않을까 싶어 시작하게 된 일이었다.
(그리고 입력기 설치보다 더 많은 시간과 {\hangulfontspec{Noto Serif KR}[Script=Hangul]\jamotextcmd{ke}\jamotextcmd{qpi}}\textemdash\footnote{이 표기를
이태준 (1940), \ccnm{文章講話} (경성 종로, 文章社), p.~23에서 보았다. `{\hangulfontspec{Noto Serif KR}[Script=Hangul]\jamotextcmd{pqi}}'가
아니라 
`{\hangulfontspec{Noto Serif KR}[Script=Hangul]\jamotextcmd{qpi}}'이다. 부록의 \fref{fig:mun} 참조.
인쇄 상태로 미루어보면 
`{\hangulfontspec{Noto Serif KR}[Script=Hangul]\jamotextcmd{qpi}}'자 활자가 있었던 것 같지는 않고 `피'를 식자한 후에 왼편에
조그마한 고리를 달아 인쇄한 것으로 보인다.
한편, 정약용의 원본에 지석영이 영어 단어와 음을 붙여 발행했다고 하는  \ccnm{아학편} (1909)에서도 이와 같은 표기법이 쓰이고 있다.}%
를 소비하였다.)

옛한글 입력과 관련하여, Mac OS에서는 구름 입력기가 있더라. 한글 Windows 10은 시스템 자체에
옛한글 입력기가 있는 것 같고 여전히 새나루나 날개셋도 있다.
그러나 어떤 것이든 시스템 설정을 바꾸거나 새로운 앱을 설치하거나 해야 하는 것으로 귀찮음을 감수할 수밖에 없다.

만들어놓고 보니 아예 한글 입력 자체가 불가능한 상황,
즉 시스템 설정을 건드릴 수도 없고 새로운 프로그램을 설치할 수도 없거나
한글 입력기 자체가 없거나,
서버에 접속하여 문서를 작성하는 상황이라도 한글과 옛한글을 포함한 문서를 작성할 수 있게 되었다.
\emph{실용적으로 쓸 일이 있을까} 싶기는 하지만 버리기도 아까워서 기능을 보완하고 정리해두기로 하였다.

이 ``한글 대응 입력'' 방식이라는 것은 나름 그 유래가 있다. \href{https://www.yudit.org/}{Yudit}이라는 편집기의 
옛한글 입력 방식이 그러하고 \pkg{frktex}에서도 역시 이런 식으로 한글을 입력했다.
한글 로마자 입력기(워드 프로세서에 내장된 것도 있고 시스템 입력기의 입력 방식 중의 하나인 경우도 있다)들은
특히 \texttt{eu}, \texttt{eo} 모음 때문에 너무나 많은 키를 눌러야 해서 내가 그리 좋아하지 않았지만.

그리고 옛한글 입력기가 있다 하더라도 두벌식 옛한글 입력이 필연적으로 겪게 되는 음절 경계의 문제는 피할 수 없다.
모음과 모음 사이에 최대 6개의 자음이 올 수 있는 조건에서 음절 경계의 판별을 완전히 자동화하는 것은
불가능하다고 생각한다. 이 패키지에서도 그런 문제를 고려하여 처음부터 음절 경계를 입력하도록
하였다. 약간의 번거로움은 피할 수 없지만 그 때문에 구현이 아주 간단해졌고 예외 처리를 위한
고민을 해소할 수 있었다.
이와 관련하여 종성을 대문자로 입력하는 방안(Yudit 방식)을 유력하게 고려하였지만 쉬프트 누르기를 싫어하는
나는 이를 채택하지 않았다. ``쉬프트를 누르느니 슬래시를 한 번 치고 말겠다.''

\bigskip

이 패키지를 만들다보니 참 세상 편해졌다는 생각을 안 할 수가 없었다. 
Expl3는 내가 원하는 일을 너무나 간단하게 구현할 수 있게 해주었다. \hologo{XeTeX}, \hologo{LuaTeX} 엔진의 유니코드 처리 기능은 한글 사용자에게 참 많은 혜택을 주었다고 생각한다.
십수 년 전에 옛한글 폰트와 구현을 만들려고 했던 여러 시도를 기억하는 입장에서는 당시 고민했던 문제가 말끔하게
해결되어 있는 현재 상황이 믿어지지 않을 정도이다.
모든 한글을 잘 표현하는 좋은 폰트를 가지게 된 것은 무엇보다 반가운 일이다. 그런 폰트가 더 많아지기를 바란다.

\subsection*{frkim 방식에 대한 첨언}

필자는 \pkg{pmhanguljamo}를 만들고 꽤 만족하고 있었다. 그런데 이 패키지의 표준 입력 방식은
흔히 알려진 로마자 표기법을 어느 것도 따르지 않는 것으로
모든 음절을 `/'로 구분하게 하는 것이 (그 장점에도 불구하고) 번거롭게 여겨지는 바가 없지 않았다. 
이에 대한 대책으로 표준 로마자 표기법의 전자법을 사용하게 한 RRK 방식이 구현되어 있으나 그 입력 방식을 필자 자신이 그다지 즐겨하지 않는 데다가 현대 한글만을 표현할 수 있다는 표현상의 제약이 존재하였다.

그러던 차, \pkg{hangul\TeX}에 다시 주목하게 되었는데, 나는 이 한글--로마자 대응을 expl3로 다시 써보려고 하였고 그 과정에서
이 패키지가 나오게 되었다. 처음의 목표는 \pkg{hangul\TeX}을 똑같이 따라하는 것이었으며
상당히 쉽게 구현할 수 있었다. 그 결과는 \href{http://www.ktug.org/xe/index.php?mid=KTUG_open_board&document_srl=261141}{KTUG::261141(2022/11/30)}에 발표하고 있다.
이 발표에서 옛한글을 \pkg{hangul\TeX} 방식으로 입력하는 데 대해 언급한 것이 있는데 그 부분을
보충하여 이 패키지를 완성한 것이다.

대체로 세 가지가 갖추어진 현재, frkim이 가장 효율적이다. pm 방식은 현재 유니코드로 조합할 수 있는
모든 문자가 다 가능하다는 점과 아스키 에스케이핑같은 몇 가지 유용한 기능이 있으므로 이 패키지의 표준
입력 방식의 지위를 내놓지는 않겠지만, 아마도 나 자신 일상적으로는 frkim을 쓰지 않을까 싶다.

\section{변경 이력}

\textbullet\ v0.1 (2020/01/17): 첫 릴리스.

\textbullet\ v0.1.1 (2020/01/18): 호환자모 `\jmcc{@}' 입력 버그 수정.

\textbullet\ v0.1.2 (2020/01/18): \hologo{LuaTeX} 컴파일 관련 수정. 문서 갱신.

\textbullet\ v0.2.0 (2020/01/19): \texttt{pmhanguljamo}로 명칭 변경.

\textbullet\ v0.2.1 (2020/01/20): \verb|\ColonMark| bug fix. thanks to yihoze.

\textbullet\ v0.3 (2020/01/28): 표준 로마자 표기법 전자법 입력 추가.

\textbullet\ v0.3.1 (2020/01/30): RRK 입력 방법에서 한글 음절 문자 구성 방법 개선. 일부 문장부호 추가.

\textbullet\ v0.3.2 (2020/02/05): RRK에서도 \verb|\jmcc|를 쓸 수 있게 하고 \verb|\jmcc|의 인자로 \verb|@@|를 허용함.

\textbullet\ v0.3.3 (2020/03/09): RRK에서 \verb|X-ss| 입력 처리의 버그 수정.

\textbullet\ v0.3.4 (2020/03/15): PM방식 xetexko에서 단어 내 행나눔.

\textbullet\ v0.3.5 (2021/03/10): 유지보수.

\textbullet\ v0.3.6 (2021/09/20): 중성 필러 \verb|*| 추가.

\textbullet\ v0.4 (2021/11/28): 빠진 자모 추가, 훈민정음체 코멘트 추가. RRK 아래아입력 보완.

\textbullet\ v0.5 (2022/09/02): 패키지 옵션 \texttt{pmfont} 추가. jamotext 환경 
내에서 아스키 에스케이핑.

\textbullet\ v0.5.1 (2022/09/06): 버그 수정 및 ulem. 패키지 옵션  \texttt{pmfontfeature}.

\textbullet\ v0.5.2 (2022/09/07): \texttt{pmhanguljamo-kdoc.pdf} 문서의 오류 수정. \cmda{\jamoul} 버그 수정.


\textbullet\ v0.6 (2022/11/30): \texttt{frkim.sty}의 작성

\textbullet\ v0.7.1 (2022/12/25): \texttt{frkim}과 통합 및 q/f/x의 대응 문자를 바꿈.

\textbullet\ v1.0 (2023/02/18): version 1.0으로 릴리스.


%%% APPENDICES
\ExplSyntaxOn
\int_new:N \l_appsec_int
\newcounter{tmpa}
\NewDocumentCommand \appsec {}
{
	\int_gincr:N \l_appsec_int
	\int_to_Alph:n { \l_appsec_int }
}

\ExplSyntaxOff


\newpage

\section*{부록 \appsec. 이 문서 컴파일에 필요한 폰트}
\addcontentsline{toc}{section}{\protect\numberline{}부록}

이 문서의 한글과 한자 부분에 다음과 같은 폰트를 사용하였다.
모두 설치되어 있어야 컴파일할 수 있다.

\begin{description} \firmlist
\item[Noto Korean] Noto Serif Korean, Noto Sans Korean 폰트. \href{https://fonts.google.com}{Google Fonts}.
Adobe사의 \href{https://source.typekit.com/source-han-serif/kr/}{본명조(Source Han Serif)}\cntrdot \href{https://github.com/adobe-fonts/source-han-sans/tree/release/}{본고딕(Source Han Sans)}과 거의 같다.
\item[함초롬 LVT] 함초롬 바탕 LVT, 함초롬 돋움 LVT. 한글과컴퓨터 \& 한국텍학회. \href{http://wiki.ktug.org/wiki/wiki.php/%ED%95%A8%EC%B4%88%EB%A1%AC%EC%B2%B4LVT}{KTUG:함초롬체 LVT}.
\item[나눔 옛한글] 나눔명조 옛한글, 나눔바른고딕 옛한글. \href{https://hangeul.naver.com/2014/archaicword}{네이버 한글한글아름답게}.
\item[KoPubWorld] KoPubWorld 바탕, KoPubWorld 돋움. \href{https://www.kopus.org/biz-electronic-font2/}{한국출판인회의}.
\item[맑은 고딕] Windows 8 이후 한글 Windows 폰트. 마이크로소프트. 
\item[은 글꼴] 은 바탕 \TeX\,Live 배포 서체.
%\item[한컴 훈민정음 세로쓰기체] 한컴 배포 서체.
\end{description}

\ifXeTeX
\hologo{XeTeX}으로 컴파일하는 상황에서는 다음 폰트들이 더 사용되었다.

\begin{description} \firmlist
\item[은 글꼴] 은 자모바탕, 은 돋움. 
\item[백묵 글꼴] 백묵 바탕. \TeX\,Live 배포 서체.
\item[전주완판본체] 전주완판본 순L. \href{http://www.jeonju.go.kr/index.9is?contentUid=9be517a75cfc1850015d0becebbf4672}{전주시청}.
\item[제주서체] 제주한라산. \href{https://www.jeju.go.kr/jeju/symbol/font/hallasan.htm}{제주특별자치도}.
\item[Adobe 명조] Adobe Reader 배포 서체. 
\end{description}
\fi

\section*{부록 \appsec. \hologo{LuaLaTeX} 컴파일을 위한 주석}\label{sec:luatex}

\hologo{LuaLaTeX}으로 컴파일하는 경우를 위한 메모.

(이 메모는 version 0.1 당시의 것으로 현재는 큰 의미가 없다.)

우선 LuaHB\TeX 의 \LaTeX\ 포맷을 이용하는 것이 좋다. 
\pkg{harfbuzz} 라이브러리를 활용하므로 더 바람직한 결과를 얻을 수 있을 것으로 기대한다.
이 패키지는 LuaHB\TeX\ 1.11.2를 기준으로 테스트하였다. 
\TeX\,Live 2020에 있는 1.12에서 문제없이 실행될 것이다.

폰트 설정 시에 옵션으로 다음을 부여한다. 
\begin{verbatim}
[Script=Hangul,Renderer=Harfbuzz]
\end{verbatim}
\verb|Harfbuzz| 대신 \verb|Renderer=OpenType|으로 할 수 있다.
이 설정은 \pkg{luatexko}와 함께 쓰는 경우든 아니든 필요하다.

\hologo{LuaTeX}에서 이 패키지와 함께 사용할 수 있는 폰트는 \texttt{Script Hangul} 속성을 가진 폰트로
제한된다. 이 속성을 가지지 않은 일반적인 폰트로는 자모 입력으로부터 한글 음절 문자를 얻어낼 수 없는 
것으로 보인다. \ref{sec:font}절에서 어떤 폰트가 사용가능한지 확인할 수 있다.


\section*{부록 \appsec. 유니코드의 한글}

이 글에서 사용한 다음 용어를 설명한다.

\begin{description} \firmlist
\item[한글 자모] 유니코드 블럭 \textsf{[U+1100]}--\textsf{[U+11FF]}에 정의된 한글 자모(\emph{Hangul Jamo}).
\item[한글 자모 확장 A] 유니코드 블럭 \textsf{[U+A960]}--\textsf{[U+A97C]}에 정의된 한글 자모(\emph{Hangul Jamo Extended-A}).
\item[한글 자모 확장 B] 유니코드 블럭 \textsf{[U+D780]}--\textsf{[U+D7FB]}에 정의된 한글 자모(\emph{Hangul Jamo Extended-B}).
\item[한글 음절 문자] 유니코드 블럭 \textsf{[U+AC00]}--\textsf{[U+D7A3]}에 정의되어 있는, 한글 음절 문자(\emph{Hangul Syllables}. Precomposed syllables). 여기에 정의되어 있는 11,172개의 음절 문자는 한글 자모의 조합으로 구성할 수 있어야 하고, 이 문자 각각을 완성형 음절 문자로 간주할 수 있다. 한글 폰트는 이 영역의 글리프만을 가지고 있는 경우가 많고 현대 한국어 문자 생활에서 이 글자만으로 대부분 충족된다.
\item[한글 호환 자모] 유니코드 블럭 \textsf{[U+3131]}--\textsf{[U+318E]}에 정의되어 있는 한글 자모(\emph{Hangul Compatibility Jamo}). KS X 1001:1998 표준과의 호환을 위하여 마련된 영역인데 여기에 나오는 한글 자모는 조합에 활용하지 않으며 각 자모를 독립된 문자로 간주한다.
\end{description}

\paragraph*{완성형과 조합형}
1980년대와 90년대의 이른바 \href{https://namu.wiki/w/%EC%A1%B0%ED%95%A9%ED%98%95%20%EC%99%84%EC%84%B1%ED%98%95%20%EB%85%BC%EC%9F%81}{조합형\cntrdot 완성형 논쟁}은
한글 전산화, 한글 코드의 표준 제정을 둘러싼 논쟁이었다.
유니코드 2.0 이후 이것은 더이상 `논쟁'이 아니게 되었다. 오늘날 `완성형'이란
한글 표현에 한글 음절 문자 영역의 코드를 사용한다는 의미에 가깝고, `조합형'이란 한글 자모 코드를 사용하여 한글을
표현하는 것을 의미하게 되었다.
예를 들어 ``한글과 텍''이라는 문자를 음절 문자 코드로 표현하면 
\begin{verbatim}
[D55C] [AE00] [ACFC] [0020] [AC4D]
\end{verbatim}
처럼 되는데 이것을 자모 조합 코드로 표현하면
\begin{verbatim}
[1112] [1161] [11AB] % 한
[1100] [1173] [11AF] % 글
[1100] [116A]        % 과
[0020]               % space
[1110] [1166] [11A8] % 텍
\end{verbatim}
로 된다. 특히 자음은 초성과 중성에 서로 다른 코드가 할당되어 있어서
이를 두고 ``첫가끝(LVT)'' 코드\footnote{LVT라는 것은
leading consonant, vowel, trailing consonant의 첫 자를 딴 것이다.}%
라고 부르기도 한다.
자모 조합 코드는 음절 문자 코드에 비하여 몇 배 이상의 정보량을 요구하는 단점이 있으나
(UTF-8로 인코딩하면 그 격차는 더 벌어진다. UTF-8의 3바이트면 한글 음절 문자 한 자를
표현할 수 있지만 초중종성이 모두 있는 글자라면 무려 9바이트가 필요하다.)
음절 문자로는 표현할 수 없는 한글을 기록하기 위해서는 이 방법밖에 없다.
그래서 이른바 `옛한글'을 첫가끝 코드로 표현하는 것이다.

\paragraph*{폰트 기술의 발전}
코드가 그렇게 할당되었다 하더라도 이를 출력(표시)하는 것은 또다른 문제이다.
폰트라는 관점에서 생각하였을 때 
한글 음절 영역 코드라면 각 코드에 글리프를 할당하면 되므로 비교적 간단한 편이고
이것이면 문자 생활에 큰 불편이 없기 때문에 대부분의 한글 폰트가 이런 정도의 기능만을 가지고 있다.\footnote{유니코드의 한글
음절 영역 문자 11,172자를 모두 자면으로 갖춘 폰트가 등장한 것도 실은 오랜 일이 아니다.
그 전에는 소위 완성형 한글이라 불리는 2350자 글리프를 갖춘 것도 많았다.
그런데 생각해보면 우리의 문자 생활이 과연 만자 정도를 필요로 하는가? 아마 수천 자
안팎이면 거의 문제가 없을 것이라 생각한다. 음절 문자도 충분히 많은 수이다.}
그런데 자모 조합의 경우에는 여러 코드를 조합하여
이를 한 음절로 또는 한 음절처럼 표현하는 능력을 폰트가 갖추고 있어야 한다. 
이 글의 본문에서 간간이 ``\texttt{Script Hangul} 속성을 갖춘 글꼴''이라는 표현을 썼는데
자모 조합 코드로부터 한글 음절을 식자하는 것이 가능한 폰트를 말하는 것이었다.
GSUB/GPOS라는 트루타입 오픈의 속성을 이용하여
이것이 가능하게 된 것은 21세기 들어서의 일이다. 이것을 거의 최초로 가능하게 하였던
글꼴인 ``은 바탕''\footnote{이를 실험하고 구현한 신정식, 박원규 제씨의 기여는 기억할 가치가 있다.}의 역사적 의미는
실로 적지 않다 하겠다. 그 후로 함초롬, 본명조와 같은 좋은 폰트들이 많아졌고,
이제 우리는 고품위의 ``한글 표현에 제약이 없는'' 훌륭한 자유 폰트를 여럿 가지게 되었다. 

\paragraph*{텍 엔진의 발전}
이와 더불어 \TeX 에는 \hologo{XeTeX} (그리고 \hologo{LuaTeX})의 새로운
시대가 열렸다. 유니코드를 자유롭게 다룰 수 있게 되었다. 

\bigskip

이 간단한 패키지는 이러한 기술적 발전을 그 배경으로 하고 있다. 

\paragraph*{여담: 두벌식과 세벌식}
이 문제는 키보드 자판 배열 디자인에 관한 문제이고 여기서 다루는 것과 직접 관련이 있지는 않다.
그러나 가끔 첫가끝 코드와 세벌식을 혼동하는 경우가 있어 여기 간략히 언급하기로 한다.
어쨌든 세벌식은 초성과 종성에 다른 키를 할당하는 것이고 첫가끝 코드는 초성과 종성에 다른 코드를
할당하는 것이니 연관이 없다고 할 수도 없겠다.

세벌식을 선호하는 사람들이 가끔 하는 말 중에 ``한글 창제 원리에 맞다''는 것이 있다. 키보드는 익숙함의
문제가 더 큰 것이라서 어떤 것이 더 좋다거나 나쁘다거나 말하는 것이 큰 의미가 없다고 생각하지만
이 말에 대해서는 생각해볼 것이 있다. 아마도 초/중/종성을 구분하여 입력하는 것이, 초성과 중성, 종성을
합하여 한 글자를 이룬다는 것과 상통한다는 말인 듯하다.
그런데 훈민정음에서는 ``무릇 글자는 모름지기 어울려서 소리가 된다''고 하고 있는 한편,
``종성에는 초성자를 다시 사용한다''고도 하고 있다. 이 소위 終聲復用初聲의 원리를 키보드에 (억지로)
적용하면 ``종성 입력에는 초성 키를 다시 사용한다''라고 못할 것은 무엇인가?
즉 두벌식이냐 세벌식이냐와 훈민정음 창제 원리는 아무 상관이 없는 것이다.

내가 생각할 때 세벌식의 가장 큰 장점은 첫가끝 코드와 키보드의 입력 키를 ``직결''시킬 
수 있다는 점일 듯하다. 코드가 다르면 다른 키를 누른다는 것이다.
매우 안심이 된다. 입력기를 설계하는 입장에서도 세벌식이라면 첫가끝 (자모 코드) 입력을 
더 편하게 구현할 수 있을 것 같다.
그러나 사실상 현대 문자 생활에서 첫가끝 코드를 쓰는 일이 거의 없으므로 이 장점이 크게 부각되지
못한 측면이 있다.

여기까지 쓰고 보니 소위 ``직결식 글꼴''에도 생각이 미치는데 현재 알려진 직결식 글꼴이란 것은
한글 자모 코드를 쓰는 것이 아니라 그저 폰트에서 영문자 알파벳이 놓일 위치에 한글을 가져다둔 것일 
뿐이라 별로 언급할 필요를 느끼지 못한다. 다만 공병우 박사가 생전에 이 직결 글꼴의 아이디어로
한글 문자생활을 했다는 이야기가 흥미롭다.

\newpage

\section*{부록 \appsec. \ccnm{문장강화}의 한 페이지}

\begin{figure}[hp]
\centering
\includegraphics[width=9cm]{munjangganghwa}
\caption{이태준의 \ccnm{문장강화}의 한 페이지}\label{fig:mun}
\end{figure}

%\printindex

\end{document}