diff options
Diffstat (limited to 'language/korean/kotex-oblivoir/doc/ob-mathleading-doc.tex')
-rw-r--r-- | language/korean/kotex-oblivoir/doc/ob-mathleading-doc.tex | 174 |
1 files changed, 174 insertions, 0 deletions
diff --git a/language/korean/kotex-oblivoir/doc/ob-mathleading-doc.tex b/language/korean/kotex-oblivoir/doc/ob-mathleading-doc.tex new file mode 100644 index 0000000000..47f8b06dbc --- /dev/null +++ b/language/korean/kotex-oblivoir/doc/ob-mathleading-doc.tex @@ -0,0 +1,174 @@ +% +% arara: xelatex + +\documentclass[a4paper,amsmath]{oblivoir} + +\usepackage{fapapersize} +\usefapapersize{*,*,1in,*,1in,*} + +\setmainfont{Crimson Pro} +\setsansfont{Open Sans} +\setmonofont{Roboto Mono} +\setkomainfont[Noto Serif CJK KR]()( Bold) +\setkosansfont[Noto Sans CJK KR]()( Bold) + +\usepackage[default=false,exception={vmatrix}]{ob-mathleading} +\usepackage{mathtools} + +\newcommand\pkg[1]{\textsf{#1}} + +\usepackage{tcolorbox} +\tcbuselibrary{listings,breakable} + +\begin{document} + +\title{ob-mathleading} +\author{Nova de Hi} +\date{2018/12/25, v0.0.1} + +\maketitle + +\begin{abstract} +\pkg{amsmath} 패키지의 여러 줄 수식 환경의 행 간격을 본문의 행 간격과는 무관하게 일정하게 +고정하거나 임의로 변경할 수 있도록 하는 패키지이다. 본문 행 간격의 기본값이 $1$이 아닌 +한국어 문서에서 활용할 목적으로 제작하였다. +\end{abstract} + +\tableofcontents* + +\section{목적과 기능} + +\pkg{amsmath}의 여러 줄 수식을 \pkg{oblivoir}에서 쓸 적에 한글 문서의 기본 행간의 영향을 받아 +수식의 행간격이 느슨해지는 것을 방지하기 위하여 여러 줄 수식 환경에 대하여 기본 행간격을 주는 것이 +이 패키지의 목적이다. + +본문의 문단과 별행 수식 사이의 간격과 같은 것은 이 패키지가 제어하지 아니하며 ``여러 줄 수식''에 대해서만 +효과가 있다. + +이 패키지를 사용하지 않았을 때 \pkg{oblivoir} 문서를 작성한 결과와 이 패키지를 사용한 결과를 비교하여 보아라. +\[ + \begin{bmatrix} a & b & c \\ p & q & f \\ g & j & i \end{bmatrix}, + \begin{bmatrix} 1 & 0 \\ 0 & 1\end{bmatrix}, + \begin{bmatrix} 1 & 0 & \ast\! \\ 0 & 1 & \ast\! \end{bmatrix}, + \begin{bmatrix} 1 & 0 \\ 0 & 1 \\ 0 & 0 \end{bmatrix}, + \begin{pmatrix} 1 & 0 & 0 \\ 0 & 1 & 0 \\ 0 & 0 & 1 \end{pmatrix} +\] +\begin{obMathLeading} +\[ + \begin{bmatrix} a & b & c \\ p & q & f \\ g & j & i \end{bmatrix}, + \begin{bmatrix} 1 & 0 \\ 0 & 1\end{bmatrix}, + \begin{bmatrix} 1 & 0 & \ast\! \\ 0 & 1 & \ast\! \end{bmatrix}, + \begin{bmatrix} 1 & 0 \\ 0 & 1 \\ 0 & 0 \end{bmatrix}, + \begin{pmatrix} 1 & 0 & 0 \\ 0 & 1 & 0 \\ 0 & 0 & 1 \end{pmatrix} +\] +\end{obMathLeading} + +\section{사용법} + +\subsection{기본적인 사용법} + +문서의 preamble에 패키지의 사용을 선언한다. + +\begin{tcblisting}{listing only} + \usepackage{ob-mathleading} +\end{tcblisting} + +``적절한'' 행간격을 얻기 위해서는 이렇게 선언하는 것으로 충분하다. 패키지의 수식 행간격 기본값은 $1$이다. + +\subsection{명령과 환경} + +일관성있는 문서를 작성하기 위해서는 문서 전체에 걸쳐서 동일한 수식 행간격을 유지하는 것이 바람직하다. +그러나 부득이하게 특정 부분이나 특정 수식에 대해서만 행간을 늘리거나 줄여야 할 필요가 있을 수 있다. +이 패키지는 이럴 경우에 대응하기 위하여 하나의 명령(선언)과 하나의 환경을 제공한다. + +\begin{tcblisting}{listing only} + \obmathleading{<value>} +\end{tcblisting} + +\verb|<value>|에는 stretch 값을 \verb|1.2|, \verb|2|와 같이 준다. 이 선언 이후에는 수식 행간격이 변경되며 이 변경은 지역적(\emph{local})이므로 +현재의 범위(scope) 내에서 유효하다. + +\begin{tcblisting}{listing only} + \begin{obMathLeading}[<value>] + ... + \end{obMathLeading} +\end{tcblisting} + +\verb|obMathLeading| 환경은 이 환경 안에 오는 수식에만 영향을 끼친다. 옵션 인자가 주어지지 않으면 +기본값인 $1$이 사용되며 옵션 인자가 주어지면 그것을 stretch로 사용하여 행간격을 조절한다. +환경 안에는 \pkg{amsmath}의 여러 줄 수식 환경이 올 수 있다. + +\subsection{패키지 옵션} + +\subsubsection{옵션 \texttt{mathleading}} + +문서 전체에 걸쳐 수식 행간격을 임의로 조절하고자 한다면 +\begin{tcblisting}{listing only} + \usepackage[mathleading=<value>]{ob-mathleading} +\end{tcblisting} +\noindent 와 같이 지정한다. \verb|<value>|에는 stretch 값이 온다. 패키지의 기본값은 \verb|1|이다. + +\subsubsection{옵션 \texttt{exception}} + +이 패키지가 영향을 미치는 \pkg{amsmath}의 수식 환경의 리스트는 다음과 같다. + +\begin{quote} +\begin{ttfamily} + array, matrix, pmatrix, bmatrix, Bmatrix, vmatrix, Vmatrix, + cases, align, aligned, alignat, alignedat, gather, gathered, + split, multline, xalignat, xxalignat +\end{ttfamily} +\end{quote} + +이 가운데 행간 조절 적용을 배제하고자 하는 환경의 이름을 쉼표로 분리하고 중괄호로 묶어서 열거할 수 있다. + +\begin{tcblisting}{listing only} + \usepackage[exception={cases,vmatrix}]{ob-mathleading} +\end{tcblisting} + +다만 이 경우에 \texttt{align, alignat, xalignat, xxalignat}는 모두 동일한 +것으로 취급되며 \texttt{align}만을 대표 이름으로 다룬다. \texttt{align}과 \texttt{aligned}는 +서로 다른 환경이므로 별도로 취급된다. + +다음 보기는 \verb|exception={vmatrix}| 옵션을 준 상태의 예시이다. + +\begin{tcblisting}{listing above text} +\begin{obMathLeading} +\[ + \begin{bmatrix} a & b & c \\ p & q & f \\ g & j & i \end{bmatrix}, + \begin{bmatrix} 1 & 0 \\ 0 & 1\end{bmatrix}, + \begin{bmatrix} 1 & 0 & \ast\! \\ 0 & 1 & \ast\! \end{bmatrix}, + \begin{bmatrix} 1 & 0 \\ 0 & 1 \\ 0 & 0 \end{bmatrix}, + \begin{vmatrix} 1 & 0 & 0 \\ 0 & 1 & 0 \\ 0 & 0 & 1 \end{vmatrix} +\] +\end{obMathLeading} +\end{tcblisting} + +\subsubsection{옵션 \texttt{default}} + +일반적인 상황은 아니겠지만 수식 행간격을 조절하는 이 패키지의 기능을 사용하지 않으면서 단지 명령과 환경, \verb|\obmathleading|이나 +\verb|obMathLeading|만을 활용하고자 한다면 +\begin{tcblisting}{listing only} + \usepackage[default=false]{ob-mathleading} +\end{tcblisting} +이와 같이 \verb|[default=false]|를 옵션으로 줄 수 있다. 패키지의 기본값은 \verb|true|이다. + +\subsubsection{옵션 \texttt{noallowdisplaybreaks}} + +이 패키지는 \verb|\allowdisplaybreaks|를 실행해준다. 이 기능을 억제하고자 한다면 +패키지 옵션으로 \verb|[noallowdisplaybreaks]|를 선언한다. 마지막의 \verb|s|를 빠뜨리지 않도록 +유의하라. + +\section{적용 범위} + +이 패키지는 (이름에 나타난 바와 같이) \pkg{oblivoir}를 위하여 작성되기는 하였지만 \pkg{oblivoir} 클래스에 +의존하지 않는다. 그러므로 다른 클래스의 문서에서도 동작할 것이다. + +\pkg{amsmath}는 필수적이며 \pkg{etoolbox}를 로드한다. + +\section{감사의 말} + +테스트 문서와 예제 소스를 제공하신 ktug 게시판의 Progress 님, 패키지 제작의 동기를 제공하신 조인성 교수께 감사드린다. + + +\end{document} |