summaryrefslogtreecommitdiff
path: root/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex')
-rw-r--r--language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex82
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}