diff options
Diffstat (limited to 'language/korean/pmhanguljamo/doc')
-rw-r--r-- | language/korean/pmhanguljamo/doc/pmhanguljamo-doc.pdf | bin | 135349 -> 128727 bytes | |||
-rw-r--r-- | language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex | 82 | ||||
-rw-r--r-- | language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.pdf | bin | 531979 -> 533270 bytes | |||
-rw-r--r-- | language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.tex | 15 |
4 files changed, 58 insertions, 39 deletions
diff --git a/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.pdf b/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.pdf Binary files differindex 300318d574..1f3c519d89 100644 --- a/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.pdf +++ b/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.pdf diff --git a/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex b/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex index b83d5f688f..1bf5a46ffa 100644 --- a/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex +++ b/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex @@ -1,5 +1,6 @@ \documentclass[a4paper]{article} -\usepackage{fontspec} +\usepackage{kotex} +%\usepackage{fontspec} %\setmainfont{Noto Serif} %\setsansfont{Noto Sans} %\setmonofont{Noto Sans Mono} @@ -14,13 +15,16 @@ \usepackage{pmhanguljamo} \usepackage[colorlinks]{hyperref} -\usepackage{polyglossia} -\setotherlanguage{korean} -\newfontfamily\hangulfont{UnBatang.ttf}[Script=Hangul] -%\newcommand*\jamo[1]{\begingroup\hangulfont\jamoword{#1}} -\newcommand*\jamo[1]{\textkorean{\jamoword{#1}}} +%\usepackage{polyglossia} +%\setotherlanguage{korean} +%\newfontfamily\hangulfont{UnBatang.ttf}[Script=Hangul,Renderer=OpenType] +%%\newcommand*\jamo[1]{\begingroup\hangulfont\jamoword{#1}} +\setmainhangulfont{Noto Serif CJK KR}[Script=Hangul,Renderer=OpenType] +\providecommand*\textkorean[1]{#1} +\newenvironment{korean}{}{} +\newcommand*\jamo[1]{\jamoword{#1}} \newcommand*\pkg[1]{\textsf{#1}\index{#1}\index{Package!#1}} \newcommand*\thispkg{\pkg{pmhanguljamo}} @@ -30,7 +34,8 @@ \title{Poorman's Hangul Jamo Input Method \\ \Large \texttt{pmhanguljamo.sty} } \author{Kangsoo Kim} -\date{15 Mar 2020\quad version 0.3.4} +%\date{10 Mar 2021\quad version 0.3.5} +\date{20 Sep 2021\quad version 0.3.6} \maketitle @@ -50,8 +55,8 @@ Not only modern Hangul, but so-colled ``Old Hangul'' characters that uses the lost letters such as `Arae-A'(\textkorean{\jmcc{@}}), `Yet Ieung'(\textkorean{\jmcc{Q}}) or `Pan-Sios'(\textkorean{\jmcc{Z}}) etc.\ can also be typeset. \XeLaTeX\ or \LuaLaTeX\ is required. The legacy pdf\TeX\ is not supported. -The Korean Language supporting packages such as \pkg{xetexko} or \pkg{luatexko} (in the ko.\TeX\ bundle) -or \pkg{polyglossia} under \XeLaTeX\ +The Korean Language supporting packages such as \pkg{xetexko} and \pkg{luatexko} (in the ko.\TeX\ bundle) +or \pkg{polyglossia} package with Korean support %under \XeLaTeX\ are recommended, but without them typesetting Hangul is of no problem with this package \thispkg. @@ -65,12 +70,13 @@ Put the following line in your preamble: \end{verbatim} The option \texttt{[RRK]} or \texttt{[rrk]} -can be fed, in which case the \emph{Standard Korean Romanization Transliteration} +can be given, in which case the \emph{Standard Korean Romanization Transliteration} input method is activated. In section~\ref{sec:rrk}, we will explain about it. Without option, the default input method of this package is used, that is explained in sections~\ref{sec:rule}--\ref{sec:exam}. -They are incompatible with each other. +You are to specify just one of them. Using both methods in one document is +not allowed. \subsection{Commands and Environment Provided} @@ -98,7 +104,7 @@ ip/sai/ei i/nvn ba/ram/ei/do \\ na/nvn goi/ro/ue/haiss/da/. \end{jamotext} \end{verbatim} -The result will be like: +The result: \begin{quote} \begin{korean} \begin{jamotext} @@ -112,7 +118,7 @@ na/nvn goi/ro/ue/haiss/da/. \end{quote} -\subsection{Preamble of Document} +\subsection{Setting up in your Preamble} Without any other packages, you can type Hangul. Be sure that proper fonts should be declared for Hangul, utilizing \pkg{fontspec}. @@ -131,7 +137,7 @@ proper fonts should be declared for Hangul, utilizing \pkg{fontspec}. \texttt{UnBatang.ttf} is a font shipped in \pkg{unfonts-core} package of \TeX\,Live. Not all Korean fonts can be available to typeset so-called `Old Hangul', because they happen to lack -the feature of composing Korean Syllables from conjoining Jamo codes. Fortunately, +the feature of composing Korean syllables from conjoining Jamo codes. Fortunately, we have a few more fonts besides \texttt{UnBatang} that are \emph{proper} and freely available, which are listed in the section~\ref{sec:font}. In \TeX\,Live distribution, \texttt{UnBatang} is the only \emph{proper} one. @@ -178,11 +184,11 @@ However when just single or a few Hangul characters are needed, for example in t the author's name in Hangul, this package provides a casual way to print them out. -\section{Transliteration Rule}\label{sec:rule} +\section{Transliteration Rule of This Package}\label{sec:rule} \subsection{Tone Marks and Syllable Serapator} -This package assumes that every Hangul syllable has Tone Mark which +This package assumes that every Hangul syllable has \emph{Tone Mark} which must be explicitly put at the end of it. Table~\ref{tab:tonemark} shows the input scheme of them. @@ -231,8 +237,9 @@ the same as Korean Romanization Method (RRK).\footnote{The \emph{Revised Romaniz \item The letter for `\textkorean{\jmcc{R}}' is allocated to \texttt{r} not \texttt{l}. The latter is reserved for another purpose, cf. item \ref{itm:llr}. \item The letter `c' is for `\textkorean{\jmcc{C}}'. In the RRK, it is `\texttt{ch}' there. \item The letter for `\textkorean{\jmcc{X}}' is \texttt{x}, which is a bit strange, but commonly accepted `\texttt{ng}' was not to be chosen. It is reserved for another consonant `\textkorean{\jamoword{@ng/}}' -\item And the letters `q, z, f' are more freely selected. These letters are the lost ones in Modern Korean. -\item The letter `w' is chosen to present \emph{Choseong Filler}. +\item The letters `q, z, f' are more freely selected. These letters are the lost ones in Modern Korean. +\item The letter `w' is chosen to present \emph{Choseong Filler}. +%\footnote{\emph{Jungseong Filler} is not provided.} \item\label{itm:llr} The letters `l' and `lr' are prepared for very rare case. In the 15th century Korean, `\textkorean{\jamoword{sla}}' and `\textkorean{\jamoword{slra}}' were distinguishable. `sl' is chosen for the SIOS with left branch being longer, and `slr' means right branch longer. The same is the case `ssl', `sslr', `jl', `jlr' etc. @@ -258,18 +265,20 @@ Table~\ref{tab:vow} shows the transliteration rule for vowels. ㅑ & ya & ㅕ & ye & ㅛ & yo & ㅠ & yu & \kern-.3em\jmcc{@}\kern-.6em\jmcc{@} & @@ \\ \hline ㅐ & ay, ai & ㅔ & ey, ei & ㅚ & oy, oi & ㅟ & uy, ui & ㅢ & vy, vi \\ ㅒ & yay, yai & ㅖ & yey, yei & \jmcc{YOI} & yoi & \jmcc{YUI} & yui & \jmcc{@I} & @i \\ \hline -ㅘ & oa & ㅙ & oay, oai & ㅝ & ue & ㅞ & uey, uei & & \\ \hline +ㅘ & oa & ㅙ & oay, oai & ㅝ & ue & ㅞ & uey, uei & & * \\ \hline \end{tabular} \end{table} \begin{enumerate} -\item The rule for vowels may look unfamiliar. But it is simple and easily rememberable. +\item The rule for vowels may look a bit unfamiliar. But it is simple and easily rememberable. \item The letter `v' is never considered to be a vowel. But this package determined it to stand for the vowel `\textkorean{\jmcc{V}}'. In fact, the roman alphabets fall short of the vowels. This allocation is arbitrary. \item The lost `Arae-A' is allocated to `@', and the rare `Double Arae-A' to `@@', which are forgotten vowels in Modern Korean. + +\item The \emph{Jungseong Filler} ([U+1160]) can be input with \verb|*|. For example, \verb|\jamoword{h*n}| renders \jamoword{h*n}. \end{enumerate} \subsection{Compatibility Jamos} @@ -286,7 +295,8 @@ Because the \verb|@| character has no upper case, write \verb|W| instead of \ver Here is an example: \begin{quote} \begin{verbatim} -\jamoword{W/nvn a/rai/a/ra/go bu/rv/go A/oa bi/svs/ha/gei irg/nvn/da} +\jamoword{W/nvn a/rai/a/ra/go bu/rv/go A/oa + bi/svs/ha/gei irg/nvn/da} \end{verbatim} \textkorean{\jamoword{W/nvn a/rai/a/ra/go bu/rv/go A/oa bi/svs/ha/gei irg/nvn/da}} \end{quote} @@ -311,16 +321,19 @@ They can be downloaded from the url and used freely. And note that \item[KoPub World] free fonts by Korea Publisher Society. \url{http://www.kopus.org/biz/electronic/font.aspx} \item[Malgun Gothic] One of Windows 10 system font. \item[Nanum Yet Hangul] Two font families from Naver. Nanum Myeongjo Yet Hangeul and Nanum Barun Gothic Yet Hangeul. \url{https://hangeul.naver.com/2014/archaicword} -\item[Noto CJK] Google's Noto CJK fonts. Or Adobe's Source Han fonts. \url{https://www.google.com/get/noto/help/cjk/} +\item[Noto CJK or Source Han] Google's Noto CJK fonts. Or Adobe's Source Han fonts. \url{https://www.google.com/get/noto/help/cjk/} \item[Un Batang] \verb|UnBatang.ttf|. on CTAN. \url{https://ctan.org/pkg/unfonts-core} \end{description} To use one of these fonts, do not forget to provide the \texttt{[Script=Hangul]} option.\footnote{% - If the document is processed with \LuaLaTeX, \texttt{[Script=Hangul,Renderer=Harfbuzz]} - or \texttt{[Script=Hangul,Renderer=OpenType]} is recommended. - The \LuaLaTeX\ version should be over 1.11, that is, - the \LaTeX\ format of LuaHB\TeX\ is needed.} + the option should be \\ + \texttt{[Script=Hangul,Renderer=Harfbuzz]}\\ + or\\ + \texttt{[Script=Hangul,Renderer=OpenType]},\\ + when the document is processed with \LuaLaTeX.} +% The \LuaLaTeX\ version should be over 1.11, that is, +% the \LaTeX\ format of LuaHB\TeX\ is needed.} For example, you can specify Hamchorom Batang LVT font as: \begin{verbatim} @@ -499,14 +512,13 @@ e/nv na/ri i do/ra/gar h@i/o/. \ExplSyntaxOff -\section{The RRK input method} \label{sec:rrk} +\section{The RRK Input Method: An Alternative Way} \label{sec:rrk} In chapter 3 section 8 of \emph{Revised Romanization of Korean} (2000), the `transliteration method' of Hangul romanization is declared. It is exceptionally permitted when it is required to restore -the original Hangul writings, while the phonetic transcription method -is standard. -So we can make use of it as an input method. +the original Hangul writings, while standard is the phonetic transcription one. +So we can make use of the former as an input method. If the package option \texttt{[RRK]} or \texttt{[rrk]} is given, the RRK method is activated. In this case, only `Modern Hangul' can @@ -578,11 +590,11 @@ The `Arae-A' is to be input as `\texttt{@}' character, and the `Double Arae-A' ` has only leading `@', i.e., \textkorean{\jamoword{x@}} should be input by `\verb|x@|'. If the syllable has trailing consonants or is part of a word, just \verb|@| is good. \\ -\verb|\jamoword{h@ngeul @@nam-eun}| \textkorean{\jamoword{h@ngeul @@d@b}}. +\verb|\jamoword{h@ngeul @@nam-eun}| \textkorean{\jamoword{h@ngeul @@nam-eun}}. \end{enumerate} -\subsection{Examples of RRK method} +\subsection{Example of RRK method} The text is one of the most famous poem in Korean, \textkorean{\jamoword{jindallaekkoch}} \emph{Azalea} by Kim So-wol.\footnote{% An English translation of this poem can be read in Wikipedia, @@ -649,11 +661,11 @@ please read the documentation \section{Acknowledgement} Thanks go to yihoze at the KTUG board, there he commented, -``The IMs I've tried such as Korean Windows Old Hangul IM or Saenaru IM -were all somewhat inconvenient. \ldots\ +``The IM apps I've tried such as Korean Windows Old Hangul IM or Saenaru IM +were all somewhat inconvenient. $\ldots$\ In my opinion, for the foreign scholar who studies Korean language, especially Middle Age Korean language, this kind of transliteration method may be much more convenient and -confident way of typesetting Korean than the IM solutions.''\footnote{\url{http://www.ktug.org/xe/index.php?mid=KTUG_open_board&document_srl=240134}} +confident way of typesetting Korean than the keyboard IM solutions.''\footnote{\url{http://www.ktug.org/xe/index.php?mid=KTUG_open_board&document_srl=240134}} \end{document} diff --git a/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.pdf b/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.pdf Binary files differindex 13d65b069d..7207343b46 100644 --- a/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.pdf +++ b/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.pdf diff --git a/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.tex b/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.tex index 4de722b9e2..d941140d19 100644 --- a/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.tex +++ b/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.tex @@ -64,7 +64,9 @@ %\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/15\quad v0.3.4} +%\date{2020/03/10\quad v0.3.5} +\date{2021/09/20\quad v0.3.6} \maketitle @@ -186,7 +188,7 @@ mun/jj@x;oa;ro; se/rv s@/m@s/di; a/ni;h@r/ss@i; \subsection{성조표지와 음절} -입력에는 로마자 알파벳과 \verb|@| 부호, 그리고 세 개의 성조표지(방점) 기호 \verb|/|, \verb|;|, \verb|:|를 사용한다. +입력에는 로마자 알파벳과 \verb|@| 부호, 그리고 세 개의 성조표지(방점) 기호 \verb|/|, \verb|;|, \verb|:|를 사용하며, 중성 필러를 표현하기 위하여 \verb|*| 부호를 쓴다. \emph{성조표지가 와야 음절이 완성된 것으로 본다}. 모든 한글 음절은 반드시 성조표지로 끝난다. 평성이 아닌 성조표지는 (적절한 폰트에서) 한글 음절의 왼편에 찍힌다. @@ -249,10 +251,11 @@ mun/jj@x;oa;ro; se/rv s@/m@s/di; a/ni;h@r/ss@i; \item `\jmcc{Q}'(옛이응)을 \verb|q|로 한 것은 역시 \pkg{frktex}에서 온 것인데 ``꼭지 달린 이응''이라는 글자 모양이 \verb|q|를 연상시킨다''는 이유였다고 한다. 그럴 법도 하다. \item `\jmcc{Z}'(반시옷)을 \verb|z|로 한 것은 납득할 수 있다고 본다. z가 s의 유성음에 대응하기 때문에. \item 가장 곤란했던 것은 \jmcc{F}(여린히읗)이었다. 사용되지 않은 자판 가운데서 선택할 수밖에 없는데 \texttt{l}, \texttt{v}, \texttt{w}, \texttt{f} 정도가 선택 가능한 범위였다. 알파벳이 아닌 부호문자 중에서 선택하는 것도 생각해보았으나 역시 자판의 윗줄로 올라가는 것은 꺼려져서 \verb|f|로 선택하였다. 순전히 편의에 의한 대응이다. -\item `\jamotextcmd{sl@}'나 `\jamotextcmd{slr@}'와 같은 특별한 글자, `\jamotextcmd{ssla/sslra/jla/jlra/jjla/jjlra/cla/clra}'의 초성 글자들, 즉 훈민정음 언해의 ``\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 `\jamotextcmd{sl@}'나 `\jamotextcmd{slr@}'와 같은 특별한 글자, `\jamotextcmd{jl*/cl*/jjl*/sl*/ss*}, \jamotextcmd{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{BX}', `\jmcc{BBX}', `\jmcc{MX}', `\jmcc{PX}'와 같은 ``\jamoword{ib/si/ur;ga/b@i;ya/bx@n; so/ri;}'' 표기는 \verb|x|를 이어써서 표기한다. 각각, \texttt{bx}, \texttt{bbx}, \texttt{mx}, \texttt{px}. \item 겹자음\cntrdot 복자음은 이어쓴다. \texttt{gg} \jmcc{GG}, \texttt{bsg} \jmcc{BSG}, \texttt{bsd} \jmcc{BSD}, \texttt{rf} \jmcc{RF}. -\item `제로자음'인 초성 이응은 생략할 수 있다. 모음으로 시작하면 초성 이응을 식자해준다. \verb|\jamoword{an}| \jamoword{an}. 만약 정말로 초성을 비우기를 원한다면(즉 초성 필러를 쓰려 한다면) \verb|w|를 그 위치에 쓰도록 하라. 이것은 종성에는 적용되지 않는다. \verb|\jamoword{wan}| \jamoword{wan}. +\item `제로자음'인 초성 이응은 생략할 수 있다. 모음으로 시작하면 초성 이응을 식자해준다. \verb|\jamoword{an}| \jamoword{an}. +\item 정말로 초성을 비우기를 원한다면(즉 초성 필러를 쓰려 한다면) \verb|w|를 그 위치에 쓸 수 있다. 이것은 종성에는 적용되지 않는다. \verb|\jamoword{wan}| \jamoword{wan}. \end{enumerate} \subsubsection{모음} @@ -292,6 +295,7 @@ mun/jj@x;oa;ro; se/rv s@/m@s/di; a/ni;h@r/ss@i; \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 4.0의 한글 자모 확장 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*f}| \jamoword{w*f}. \end{enumerate} \subsubsection{호환자모 음절} \label{sec:compjamo} @@ -799,6 +803,9 @@ Expl3는 내가 원하는 일을 너무나 간단하게 구현할 수 있게 해 \textbullet\ v0.3.4 (2020/03/15): PM방식 xetexko에서 단어 내 행나눔. +\textbullet\ v0.3.5 (2021/03/10): 유지보수. + +\textbullet\ v0.3.6 (2021/09/20): 중성 필러 \verb|*| 추가. %%% APPENDICES \ExplSyntaxOn \int_new:N \l_appsec_int |