summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xetex/xetexko/xetexko-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/xetex/xetexko/xetexko-doc.tex')
-rw-r--r--Master/texmf-dist/doc/xetex/xetexko/xetexko-doc.tex121
1 files changed, 69 insertions, 52 deletions
diff --git a/Master/texmf-dist/doc/xetex/xetexko/xetexko-doc.tex b/Master/texmf-dist/doc/xetex/xetexko/xetexko-doc.tex
index 481a2a0a570..616c9fcc5bc 100644
--- a/Master/texmf-dist/doc/xetex/xetexko/xetexko-doc.tex
+++ b/Master/texmf-dist/doc/xetex/xetexko/xetexko-doc.tex
@@ -41,7 +41,6 @@
{\setbox0=\vbox\bgroup\hsize=\dimexpr\textwidth-12pt\relax
\hrule width0pt\kern5pt\par\small
\parindent0pt }
-% \noindent}
{\par \vskip-\lastskip\kern5pt\hrule width0pt\egroup \par\medskip\par
\dimen0=\dimexpr\pagegoal-\pagetotal\relax
\ifdim\dimen0<2\baselineskip\relax \dimen0\maxdimen \fi
@@ -56,8 +55,8 @@
\newenvironment{example}
{\hbox\bgroup\grayvrule
\vbox\bgroup\hsize\dimexpr\textwidth-4pt\relax
- \grayhrule\kern1em\leftskip1em\rightskip1em
- }{\par\kern1em\grayhrule\egroup\grayvrule\egroup}
+ \grayhrule\kern5pt\leftskip10pt\rightskip10pt
+ }{\par\kern5pt\grayhrule\egroup\grayvrule\egroup}
\def\cs#1{\texttt{\textbackslash #1}}
\def\hemph#1{\textsf{\bfseries #1}}
\def\hparen#1{{\small\hangulparens(#1)}}
@@ -71,7 +70,7 @@
\title{\xetexko\ 간단 매뉴얼}
\author{Dohyun Kim \normalsize <\texttt{nomos at ktug org}> \and
\normalsize <\url{http://github.com/dohyunkim/xetexko}>}
-\date{Version 3.1\quad 2021/03/22}
+\date{Version 3.2\quad 2021/04/08}
\maketitle
\begin{quote}\small
@@ -217,7 +216,7 @@ fontspec과 마찬가지로 각 명령의 끝에 `s'를 붙여도 된다.
현재 폰트가 직전 문자의 폰트가 아닐 수 있음에 주의할 것.
옵션 키의 종류와 의미는 다음과 같으며 각 키 값은 인자의 경우와 같다.
-\begin{description}\itemsep0pt\hangulparens
+\begin{description}\itemsep0pt
\item[alphs] 라틴 알파벳, 숫자, 아래에 해당않는 모든 non-CJK 문자
\item[parens] 라틴 괄호, 중괄호, 대괄호, 꺽쇠, 인용부호 및 그 리거쳐
\item[colons] 라틴 콜론, 세미콜론
@@ -229,15 +228,17 @@ fontspec과 마찬가지로 각 명령의 끝에 `s'를 붙여도 된다.
종전에\vernote{3.0}
라틴숫자에 적용되던 \verb|nums| 옵션과
라틴 인용부호에 적용되던 \verb|quotes| 옵션이
-3.0버전부터는
+3.0 버전부터는
각각 \verb|alphs| 옵션과 \verb|parens| 옵션에 통합되었음에 유의하라.
또한\vernote{3.0} en dash, em dash가 종래 \verb|colons|에 속하던 것이 이제
-\verb|hyphens|에 속하게 되었음도 주의하라.
+\verb|hyphens|에 속하게 되었다.
기본값은 다음 명령을 준 것과 동일하다.
+v3.0부터\vernote{3.0} 괄호류의 기본글꼴이 한글이 되었음도 유의하라.
\begin{verbatim}
\xetexkofontregime {latin}%
- [ puncts=prevfont, colons=prevfont, cjksymbols=hangul ]
+ [ puncts=prevfont, colons=prevfont,
+ parens=hangul, cjksymbols=hangul ]
\end{verbatim}
\begin{plaintex}
플레인텍에서는 다음 명령을 사용한다. \LaTeX에서도 쓸 수 있다.
@@ -255,7 +256,7 @@ fontspec과 마찬가지로 각 명령의 끝에 `s'를 붙여도 된다.
\end{verbatim}
\end{plaintex}
-\section{간격 조정 옵션}\label{sec:fontopts}
+\section{글꼴 옵션}\label{sec:fontopts}
\dotemph{고정폭 글꼴을 제외한} 한글·한자 글꼴 명령에 미세 간격 옵션을
쓸 수 있다. 예컨대
\begin{verbatim}
@@ -282,25 +283,19 @@ fontspec과 마찬가지로 각 명령의 끝에 `s'를 붙여도 된다.
\item[CharRaise, charraise]\quad
글자의 {\addhangulfontfeature{charraise=.5ex}수직 위치}를 조절한다.
기본값은 \verb|0pt|.
+ 고정폭 글꼴에서도 이 옵션은 작동한다.
\end{description}
-3.0버전부터는\vernote{3.0} 다음 옵션들이 아무 효과도 가져오지 않게
+3.0 버전부터는\vernote{3.0} 다음 옵션들이 아무 효과도 가져오지 않게
변경되었음을 주의하라.
\begin{verbatim}
- lowerperiod, PunctRaise
- lowerquestion
- lowerexclamation
- lowercomma
- preperiodkern
- postperiodkern
- prequestionkern
- postquestionkern
- preexclamationkern
- postexclamationkern
- precommakern
- postcommakern
- quoteraise
- quotewidth
- postmathskip
+ lowerperiod lowerquestion
+ lowerexclamation lowercomma
+ preperiodkern postperiodkern
+ prequestionkern postquestionkern
+ preexclamationkern postexclamationkern
+ precommakern postcommakern
+ quoteraise quotewidth
+ postmathskip PunctRaise
\end{verbatim}
\begin{plaintex}
@@ -356,10 +351,12 @@ fontspec과 마찬가지로 각 명령의 끝에 `s'를 붙여도 된다.
줄바꿈까지도 먹지 않게 한다.
일부 고급 오픈타입 기능을 사용하기 위해서 이 명령이 필요할 때가 있다.
이를테면, 폰트가 지원하는 한글 리거쳐가 동작하지 않을 때 이 명령을
- 선언하면 문제가 해결된다.
-
- \cs{enablehangulspacingandlinebreak}는 이 명령의 효력을 원래대로
- 되돌리는 기능을 한다.
+ 선언하면 문제가 해결된다.%
+ \footnote{%
+ 이 명령은 그룹 안에서 실행해야 할 것이다. 그렇더라도
+ \cs{enablehangulspacingandlinebreak} 명령을 그룹을 닫고나서 선언해야
+ 원래 기능이 완전히 복구된다.
+ }
\end{description}
3.0 버전부터는\vernote{3.0} 종전의
@@ -376,8 +373,6 @@ fontspec과 마찬가지로 각 명령의 끝에 `s'를 붙여도 된다.
Source Han Serif (본명조), Noto Sans CJK, Noto Serif CJK,
나눔명조옛한글, 나눔바른고딕옛한글, KoPubWorld 바탕, KoPubWorld 돋움 등이 있다.
또한
-%%% BUG: \char를 이용하여 옛한글을 찍으면 자모가 분리된다.
-%%% 코드 수정 요망.
\textsf{^^^^1112^^^^119e^^^^11ab글}에 번들된 함초롬 글꼴에도
최근 옛한글 지원이 추가되었다.}
@@ -427,12 +422,13 @@ vertical 환경의 인자는 세로쓰기 박스의 세로 길이이다.
\begin{figure}
\begin{example}
\hfil\begin{vertical}{18em}
- \spaceskip=.5em plus .08em minus .04em
- \sffamily\addhangulfontfeatures{Vertical=Alternates,CharRaise=.5ex,
- RawFeature=vertical}
- \hanjabyhangulfont \parindent-1em\leftskip1em
+ \linespread{1.5}\sffamily
+ \addhangulfontfeatures{Vertical=Alternates,CharRaise=.5ex,RawFeature=vertical}
+ \hanjabyhangulfont
\typesetclassic \latinparens
- \noindent 님의 침묵 (The Silent Beloved)
+ \parindent0pt \everypar{\hangindent1em \hangafter1 }
+ \spaceskip=.5em plus .25em minus .125em
+ \quad 님의 침묵 (The Silent Beloved)
\smallbreak
\hfil\hfil 한 용 운\hfil
\bigbreak
@@ -449,7 +445,7 @@ vertical 환경의 인자는 세로쓰기 박스의 세로 길이이다.
세로쓰기 보기.\quad
\sffamily\small
Noto Sans CJK KR 글꼴을 이용했다. 이 글꼴의 세로쓰기 어간이 1em으로
- 매우 커서 \cs{spaceskip=0.5em plus.08em minus.04em}을 강제했다.
+ 매우 커서 \cs{spaceskip=0.5em plus.25em minus.125em}을 강제했다.
\texttt{CharRaise=.5ex}도 글꼴 옵션에 추가했다.
또한 \cs{latinparens}를 선언했는데
제목 다음의 괄호가 CJK 괄호가 아니라 아스키 괄호이기 때문이다.
@@ -540,11 +536,10 @@ horizontal 환경에는 가로쓰기 박스의 너비를 인자로 주어야 한
\begin{figure}
\begin{example}\linespread{1.3}
- \hfil\begin{vertical}{18em}
- \sffamily\typesetclassic
- \addhangulfontfeatures{Vertical=Alternates,CharRaise=.5ex,
- RawFeature=vertical}
- \hanjabyhangulfont \parindent-1em\leftskip1em
+ \hfil\begin{vertical}{19em}
+ \linespread{1.5}\sffamily\typesetclassic
+ \addhangulfontfeatures{Vertical=Alternates,CharRaise=.5ex,RawFeature=vertical}
+ \hanjabyhangulfont \parindent0pt \everypar{\hangindent1em \hangafter1 }
\analect
\end{vertical}\hfil
\end{example}
@@ -557,15 +552,36 @@ horizontal 환경에는 가로쓰기 박스의 너비를 인자로 주어야 한
\end{figure}
\section{매달린 구두점}
-마침표, 쉼표, 인용부호를 판면 바깥에 식자하여 행 끝에 매달리게 만든다.
+\hemph{하이픈을 제외한} 문장부호들를 판면 바깥에 식자하여 행 끝에 매달리게 만들 수 있다.
3.0 버전부터는\vernote{3.0} \keyword{hangingpunctuations}%
\cs{hangingpunctuations} 명령으로 활성화한다.
\cs{hangingpunctuation}은 이 명령과 동의어이다.
-당분간 xetexko-hanging.sty 을 로드하는 것으로도 활성화되도록 해 두었다.
+당분간 xetexko-hanging.sty을 로드하는 것으로도 활성화되도록 해 두었다.
+이렇게 활성화되면 기본값으로 온점, 반점, 고리점, 모점에 대해서 전부 내밀기가 작동한다.
+
+3.2 버전부터는\vernote{3.2} 사용자가 원하는 문장부호를 원하는 만큼 판면 밖으로 내밀 수 있다.
+\begin{verbatim}
+ \sethangingratio"28=0.5 %
+ \sethangingratio"3002=1 %
+\end{verbatim}
+등호 앞의 숫자는 유니코드 코드포인트이고 뒤의 숫자는 글자폭에 대한 비율을 뜻한다.
+따라서 위 예는 여는괄호(U+0028)를 절반만 내밀고 고리점(U+3002)은 완전히 밀어내라는 지시다.
+어느 방향으로 내밀지는 \xetexko 가 알아서 판단한다.
+이러한 지시를 취소하려면,
+\begin{verbatim}
+ \unsethangingratio"28
+ \unsethangingratio"3002
+\end{verbatim}
-글자 내밀기 기본값에 차이가 좀 있긴 하지만,
-microtype 패키지를 로드하는 것으로도 유사한 결과를 얻을 수 있다.
+microtype 패키지의 protrusion 기능이 잘 작동하지 않는 경우가 있어,%
+\footnote{%
+ 원시명령 \cs{lpcode} \cs{rpcode} 등 엔진이 제공하는 기능을 말한다.
+ 이들 원시명령에는 글리프 인덱스를 지시해야 하는데 어떤 글자의 글리프 인덱스를
+ 알아내는 일은 간단치가 않다.
+ \XeTeX\ reference guide를 참고하라.
+ }
+어쩔 수 없이 제공하게 되었으므로 예외적으로만 사용할 것을 권한다.
%\begin{figure}
%\Large
@@ -574,15 +590,11 @@ microtype 패키지를 로드하는 것으로도 유사한 결과를 얻을 수
%\vbox{\hfil\hbox{\vrule\vbox{\hsize\wd0
% 줄 끝에 매달린 구두점.
% 줄 끝에 매달린 구두점,
-% ``줄 끝에 매달린 구두점''
-% `줄 끝에 매달린 구두점'
-% “줄 끝에 매달린 구두점”
-% ‘줄 끝에 매달린 구두점’
% 줄 끝에 매달린 구두점、
% 줄 끝에 매달린 구두점。
% 줄 끝에 매달린 구두점
% }\vrule}\hfil}
-%\caption{매달린 구두점 보기}\label{fig:hanging}
+%\caption{기본값이 적용된 매달린 구두점}\label{fig:hanging}
%\end{figure}
\section{수식 한글}
@@ -661,7 +673,7 @@ microtype 패키지를 로드하는 것으로도 유사한 결과를 얻을 수
따위를 사용한다.
\section{밑줄긋기}
-\LaTeX에서는 \uwave{ulem 패키지}를 로드하는 것만으로 자동 지원된다.
+\uwave{ulem 패키지}를 로드하는 것만으로 자동 지원된다.
3.0 버전부터는\vernote{3.0} \cs{xetexkoulemsupport} 선언이
불필요하게 되었다. 이 명령은 호환성을 위해 남겨두었으나 아무 일도
@@ -675,6 +687,11 @@ microtype 패키지를 로드하는 것으로도 유사한 결과를 얻을 수
\begin{small}\linespread{1.2}\selectfont
\begin{description}\itemsep=0pt
+ \item[v3.2] 2021-04-08
+ \begin{itemize}
+ \item 매달린 구두점이 기본값으로 따옴표에는 작동하지 않고 마침표^^b7쉼표에만 작동한다.
+ \item \cs{sethangingratio}, \cs{unsethangingratio} 명령 추가
+ \end{itemize}
\item[v3.1] 2021-03-22
\begin{itemize}
\item 플레인텍 명령 \cs{sethangulfont}, \cs{sethanjafont} 추가