diff options
Diffstat (limited to 'language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex')
-rw-r--r-- | language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex | 82 |
1 files changed, 47 insertions, 35 deletions
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} |