summaryrefslogtreecommitdiff
path: root/language/korean/cjk-ko/cjk-ko-doc.tex
blob: c5a38e4905b17f7b80b0e698e626c39b76d58079 (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
%% cjk-ko-doc.tex
%%
%% This file is in public domain

\ifcase\pdfoutput
\documentclass[dvipdfmx,b5paper]{article}
\else
\documentclass[b5paper]{article}
\fi
\usepackage{geometry}
\usepackage[cjk,hangul,usedotemph]{kotex}
\usepackage{xcolor,hologo,hyperref}
\hypersetup{
  pdftitle={cjk-ko 간단 매뉴얼},
  pdfauthor={Dohyun Kim},
  pdfkeywords={CJK, LaTeX, Korean, ko.TeX}
}

\def\cs#1{\texttt{\color{teal}\char92 \chardef\{=123 \chardef\}=125 #1}}
\def\koTeX{\textsf{k}\kern-.1em\textit{o}.\kern-.1667em\TeX}
\def\cjkko{\mbox{CJK-\textsf{k}\kern-.1em\textit{o}}}

\linespread{1.3}

\title{\cjkko\ 간단 매뉴얼}
\author{Dohyun Kim \normalsize $<$\texttt{nomos at ktug org}$>$ \and
  \normalsize $<$\url{http://github.com/dohyunkim/cjk-ko}$>$}
\date{Version 2.4\quad \today}
\begin{document}
\maketitle

\begin{abstract}
  For introduction in English, please see \verb|README| file in this package.

  본래 \TeX\ Writer라는 iOS 앱을 위해 만들었던 한글 패키지를 \TeX\ Live용으로
  수정했다. 특히 \TeX\ Live 버전에서는 나눔글꼴을 트루타입 대신 Type1
  글꼴---물론 subfont들이다---로 변환해 넣음으로써 다양한 DVI 툴을 이용할 수
  있게 했다.

  1.3 버전부터는 나눔글꼴이 아닌 다른 한글 폰트를 패키지 옵션으로 지정해서 쓸
  수 있다.

  2.1 버전부터는 자동조사가 한글 다음에 올 때도 바르게 동작한다.
\end{abstract}

\tableofcontents

\section{소개}
  \begin{itemize}
    \item CJK 패키지의 \texttt{UTF8} 환경 이용
    \item 복잡한 환경 지시 없이 \texttt{kotex}만 부르면 바로 한글 가능
      \begin{itemize}
        \item[] \hskip2cm \fbox{\vtop{\hsize=.5\textwidth\baselineskip=1.1em
            \cs{begin\{document\}}\par
            \cs{begin\{CJK\}\{UTF8\}\{mj\}}\par
            \leavevmode\llap{불필요 $\rightarrow$\quad}\quad $\cdots$\par
            \cs{end\{CJK\}}\par
            \cs{end\{document\}}}}
      \end{itemize}
    \item 한글 문서에 최적화된 줄바꿈 기능~--- 예: 괄호 앞뒤, 수식 뒤
    \item 영문자와 한글의 조화 추구~--- 예: 한글 글자 크기 조정 허용
    \item 기초적인 자동조사 기능
    \item 오로지 \dotemph{현대 한국어} 문서를 위한 패키지~---
      중세한글, 일본어, 중국어는 지원하지 않는다.
  \end{itemize}

\section{Package options}
  \begin{description}
    \item[불러오기]: \quad\cs{usepackage[cjk]\{kotex\}}
      \medskip
    \item[패키지 옵션] 열거되지 않은 옵션은 CJKutf8 패키지에 그대로 전달된다.
      \begin{itemize}
        \item[\texttt{cjk}] \TeX\ Live에선 이 옵션이 없으면 kotexutf\,가
          로드된다. 단, \verb|kotexutf.sty| 파일을 찾을 수 없다면
          이 옵션이 없더라도 \cjkko\ 패키지를 부른다.
        \item[\texttt{hangul}] 한글 캡션, 줄 간격, 단어 간격, frenchspacing
          등의 조정이 이루어진다. 문서의 주된 언어가 한글이라고 선언하는 옵션
        \item[\texttt{hanja}] \verb|[hangul]| $+$ 한자 캡션
        \item[\texttt{nojosa}] 자동조사 기능 끄기. 이 옵션을 주더라도
          자동조사 명령이 에러를 내는 건 아니다.
        \item[\texttt{usedotemph}] \cs{dotemph} 명령 허용\\
          --- 이 옵션은 ulem 패키지도 부르므로 \uline{밑줄 긋기} 가능.
          단, \cs{normalem} 명령이 선언돼 있으므로 \cs{emph} 명령이
          밑줄긋기로 동작하게 하려면 \cs{ULforem} 선언이 있어야 한다.
        \item[\texttt{usecjkt1font}] 영문자도 한글 글꼴로 식자.
           라틴 알파벳이 거의 없는 소설책 따위에 유용할 수 있다.
        \item[\texttt{mj=<font>}] CJK 명조 글꼴을 지정한다. 예컨대
          \verb|[mj=utbt]|.
        \item[\texttt{gt=<font>}] CJK 고딕 글꼴을 지정한다. ttfamily에도
          이 글꼴이 쓰인다.
        \item[\texttt{truetype}] 트루타입 폰트를 사용자 글꼴로 지시했다면
          이 옵션을 주어야 텍스트 추출이 가능해진다. PDF\LaTeX 에서만 유의미하다.
      \end{itemize}
  \end{description}

\section{User commands}
  \begin{description}
    \item[\cs{CJKscale}] 한글만 글자크기 조정
      \begin{itemize}\leftskip-1cm
        \item 예: \cs{CJKscale\{0.95\}}
        \item \verb|[usecjkt1font]| 옵션과는 같이 쓸 수 없다.
        \item \verb|[hangul]| 옵션 아래서는 단어 간격, 줄 간격,
          들여쓰기 크기도 자동 조정
        \item 전처리부에서만 쓸 수 있다.
      \end{itemize}
    \item[\cs{lowerCJKchar}] 한글만 아래로 끌어내려 식자
      \begin{itemize}\leftskip-1cm
        \item 예: \cs{lowerCJKchar\{-0.07em\} \% 끌어올려 식자}
        \item \verb|[usecjkt1font]| 옵션과는 같이 쓸 수 없다.
        \item 전처리부에서만 쓸 수 있다.
      \end{itemize}
    \item[\cs{dotemph}] \dotemph{드러냄표}
      \begin{itemize}\leftskip-1cm
        \item 예: \cs{dotemph\{드러냄표\}}
        \item \verb|[usedotemph]| 옵션 아래에서만 쓸 수 있다.
        \item \koTeX 과 마찬가지로 \cs{dotemphraise} \cs{dotemphchar} 명령
          재정의 가능
      \end{itemize}
    \item[기타] 사용자 명령은 CJK 패키지 문서를 참조
  \end{description}

\section{자동 조사}
  \begin{itemize}
    \item \koTeX 과 마찬가지로 \cs{은} \cs{는} \cs{이} \cs{가}
      \cs{을} \cs{를} \cs{와} \cs{과} \cs{로} \cs{으로} \cs{라}
      \cs{이라}\,를 쓸 수 있다.
    \item \cs{ref} \cs{pageref} \cs{cite} 뒤에서만 정상 동작
    \item 아스키문자와 한글 뒤에서만 정상 동작
    \item 사용자가 \cs{jong} \cs{jung} \cs{rieul} 명령을
      첨가해 조사 선택을 바로잡을 수 있다.\par
      \begin{itemize}
        \item[예:] \cs{cite\{king\}}\cs{을} \ldots\\
                   \hskip1.3em\ \cs{bibitem[King}\cs{jong]\{king\}}
      \end{itemize}
  \end{itemize}

\section{한글 카운터}

\begin{table}
    \centering
    \def\cs#1{\texttt{\bfseries #1}}
  \begin{tabular}{rl}\\
    \hline
    \cs{jaso}& ㄱ ㄴ ㄷ ㄹ ㅁ ㅂ ㅅ ㅇ ㅈ ㅊ ㅋ ㅌ ㅍ ㅎ\\
    \cs{gana}& 가 나 다 라 마 바 사 아 자 차 카 타 파 하\\
    \cs{ojaso}& ㉠ ㉡ ㉢ ㉣ ㉤ ㉥ ㉦ ㉧ ㉨ ㉩ ㉪ ㉫ ㉬ ㉭\\
    \cs{ogana}& ㉮ ㉯ ㉰ ㉱ ㉲ ㉳ ㉴ ㉵ ㉶ ㉷ ㉸ ㉹ ㉺ ㉻\\
    \cs{pjaso}& ㈀ ㈁ ㈂ ㈃ ㈄ ㈅ ㈆ ㈇ ㈈ ㈉ ㈊ ㈋ ㈌ ㈍\\
    \cs{pgana}& ㈎ ㈏ ㈐ ㈑ ㈒ ㈓ ㈔ ㈕ ㈖ ㈗ ㈘ ㈙ ㈚ ㈛\\
    \cs{onum}&  ① ② ③ ④ ⑤ ⑥ ⑦ ⑧ ⑨ ⑩ ⑪ ⑫ ⑬ ⑭ ⑮\\
    \cs{pnum}& ⑴ ⑵ ⑶ ⑷ ⑸ ⑹ ⑺ ⑻ ⑼ ⑽ ⑾ ⑿ ⒀ ⒁ ⒂\\
    \cs{oeng}& ⓐ ⓑ ⓒ ⓓ ⓔ ⓕ ⓖ ⓗ ⓘ ⓙ ⓚ ⓛ $\cdots$ ⓩ\\
    \cs{peng}& ⒜ ⒝ ⒞ ⒟ ⒠ ⒡ ⒢ ⒣ ⒤ ⒥ ⒦ ⒧ $\cdots$ ⒵\\
    \cs{hnum}& 하나 둘 셋 넷 다섯 여섯 일곱 여덟 아홉 열 열하나 $\cdots$ 스물넷\\
    \cs{Hnum}& 첫 둘 셋 넷 다섯 여섯 일곱 여덟 아홉 열 열한 $\cdots$ 스물넷\\
    \cs{hroman}& ⅰ ⅱ ⅲ ⅳ ⅴ ⅵ ⅶ ⅷ ⅸ ⅹ ⅺ ⅻ\\
    \cs{hRoman}& Ⅰ Ⅱ Ⅲ Ⅳ Ⅴ Ⅵ Ⅶ Ⅷ Ⅸ Ⅹ Ⅺ Ⅻ\\
    \cs{hNum}& 일 이 삼 사 오 육 칠 팔 구 십 십일 십이 $\cdots$ 이십사\\
    \cs{hanjanum}& 一 二 三 四 五 六 七 八 九 十 十一 十二 $\cdots$ 二十四\\
    \hline
  \end{tabular}
  \caption{한글 카운터 목록}\label{hangulcounters}
\end{table}

\koTeX\ 패키지와 동일하다.
표~\ref{hangulcounters}\를 참조.
사용례: \cs{pagenumbering\{onum\}}

\section{\texttt{kotex.sty}}
다양한 \koTeX\ 패키지로의 준자동적인 연결을 담당하는 스타일 파일이다.
\begin{itemize}
  \item \verb|[cjk]| 옵션을 주면 \cjkko\ 패키지를 로드한다.
    다만 \hologo{XeTeX} 혹은 \hologo{LuaTeX} 엔진이 가동되고 있다면
    이 옵션은 무시된다.
  \item \verb|[euc]| 옵션을 주면 \verb|kotex-euc| 패키지를 로드한다.(이
    패키지는 텍라이브에 들어있지 않으므로 KTUG 사설 저장소로부터
    설치해야 한다) \hologo{XeTeX} 엔진 하에서는 이 옵션은 무시된다.
    그러나 \hologo{LuaTeX} 엔진이 가동되고 있다면
    \verb|\luatexuhcinputencoding=1| 명령이 자동으로 실행된다.
  \item 위 두 가지 옵션이 모두 지시되지 않았다면 현재 동작 중인 텍 엔진을
    감지해서 \verb|kotexutf.sty|, \verb|xetexko.sty|, 혹은 \verb|luatexko.sty|
    가운데 하나를 로드한다.  플레인텍에서도 마찬가지로 동작한다.
  \item 어느 경우이든 사용자가 지시한 여타 패키지 옵션들은 새로 불려지는
    패키지에 모두 투명하게 전달된다.
\end{itemize}

\section{License}
\begin{itemize}
  \item GPL~--- \verb|cjkutf8-*| 파일의 라이선스는 CJK 패키지와
    같을 수밖에 없다.
  \item LPPL~--- \verb|ko*| 파일들은 \koTeX\ 패키지에서 유래한다.
\end{itemize}
\nobreak\hfill \fboxsep=-\fboxrule \fbox{\vbox to1em{\hbox to1em{\hss}\vss}}

\end{document}