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.tex291
1 files changed, 248 insertions, 43 deletions
diff --git a/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex b/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex
index 83063ab4b3..2410460662 100644
--- a/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex
+++ b/language/korean/pmhanguljamo/doc/pmhanguljamo-doc.tex
@@ -1,8 +1,3 @@
-%!TEX program = xelatex
-%
-% pmhanguljamo-doc.tex
-%. written by Kangsoo Kim, 2020.
-%
\documentclass[a4paper]{article}
\usepackage{fontspec}
%\setmainfont{Noto Serif}
@@ -35,7 +30,7 @@
\title{Poorman's Hangul Jamo Input Method \\ \Large \texttt{pmhanguljamo.sty} }
\author{Kangsoo Kim}
-\date{20 Jan 2020\quad version 0.2.1}
+\date{30 Jan 2020\quad version 0.3.1}
\maketitle
@@ -47,8 +42,8 @@ This \LaTeX\ package provides Hangul\footnote{%
to write the Korean language. In both South and North Korea,
the standard writing system uses Hangul.}
\emph{transliteration} input method, which
-enables to typeset Korean Letters (Hangul) with the help of proper fonts.
-The name is from ``Poorman's Hangul Jamo Input Method.'' It is mainly for
+allows to typeset Korean Letters (Hangul) with the help of proper fonts.
+The name comes from ``Poorman's Hangul Jamo Input Method.'' It is mainly for
the people who have a system without Korean IM, but want to typeset
Hangul in their document.
Not only modern Hangul, but so-colled ``Old Hangul'' characters
@@ -69,6 +64,14 @@ Put the following line in your preamble:
\usepackage{pmhanguljamo}
\end{verbatim}
+The option \texttt{[RRK]} or \texttt{[rrk]}
+can be fed, 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.
+
\subsection{Commands and Environment Provided}
The main command to typeset Hangul is \verb|\jamoword|.
@@ -92,7 +95,7 @@ jug/nvn nar/gga/ji ha/nvr/vr u/re/re \\
han jem bu/ggv/rem ebs/gi/rvr
ip/sai/ei i/nvn ba/ram/ei/do \\
-na/nvn goi/ro/oa/haiss/da/.
+na/nvn goi/ro/ue/haiss/da/.
\end{jamotext}
\end{verbatim}
The result will be like this:
@@ -103,7 +106,7 @@ jug/nvn nar/gga/ji ha/nvr/vr u/re/re \\
han jem bu/ggv/rem ebs/gi/rvr
ip/sai/ei i/nvn ba/ram/ei/do \\
-na/nvn goi/ro/oa/haiss/da/.
+na/nvn goi/ro/ue/haiss/da/.
\end{jamotext}
\end{korean}
\end{quote}
@@ -167,11 +170,11 @@ Or the ko.\TeX\ package bundle can be used together.
In any case, the option \verb|[Script=Hangul]| should be given
to the font settings for Hangul. For more information, see section~\ref{sec:font}.
-The Korean writing system does not have hyphenation rule.
-The line breaking can arise at the end of mostly every character. Therefore,
+The Korean writing system does not have hyphenation rules.
+The line breaking can occur just after almost every syllable. Therefore,
without Korean language supporting packages the line breaking and
-justification of paragraphs will not be acceptable.
-But when just single or a few Hangul characters are needed, for example in the case of typesetting
+justification of paragraphs will not be satisfactory.
+However when just single or a few Hangul characters are needed, for example in the case of typesetting
the author's name in Hangul, this package provides a casual way to print them out.
@@ -225,12 +228,13 @@ used in the leading and trailing position of a syllable.
\begin{enumerate}
\item The corresponding letters ``g, n, d, m, b, s, j, k, t, p, h'' are
the same as Korean Romanization Method (RRK).\footnote{The \emph{Revised Romanization of Korean} 1995:2000 is the official Korean language romanization system in South Korea.}
-\item The letter for `\textkorean{\jmcc{R}}' is allocated to \texttt{r} not \texttt{l}.
+\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 Note that 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 should be reserved for `\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 `l' and `lr' are for very rare case. In the 15th century Korean, `\textkorean{\jamoword{sla}}' and
+\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.
\item The `light labial consonants', \textkorean{\jmcc{BX}, \jmcc{PX}} in the Old Hangul can be input as `bx, px, bbx, mx'.
\item In the Modern Korean, only `gg, dd, bb, ss, jj' are additionally permitted in the leading consonant position,
@@ -312,7 +316,11 @@ They can be downloaded from the url and used freely. And note that
\end{description}
To use one of these fonts, do not forget to provide
-the \texttt{[Script=Hangul]} option. For example, you can specify
+the \texttt{[Script=Hangul]} option.\footnote{%
+ If the document is processed with \LuaLaTeX, \texttt{[Script=Hangul,Renderer=Harfbuzz]} is recommended.
+ 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}
\newfontfamily\pmjamofont{HCR Batang LVT}[Script=Hangul]
@@ -331,7 +339,7 @@ message at the console and log file,
However, when \XeLaTeX\ is concerned, it is known that the \emph{Modern} Korean Characters (\emph{Hangul Precomposed Syllables} in the Unicode block [U+AC00] -- [U+D7A3]) can be rendered with this kind of font, in spite of the warning message.
-\section{Examples}
+\section{Examples}\label{sec:exam}
Now, we will show a few practical examples, where
the \emph{korean} environment of \pkg{polyglossia} package is used.
@@ -344,41 +352,87 @@ The preamble is like this:
\newfontfamily\hangulfont{UnBatang.ttf}[Script=Hangul]
\end{verbatim}
-\subsection{Modern Hangul}
+\subsection{Modern Hangul}\label{sec:exammodern}
+
+%\begin{verbatim}
+%\begin{korean}
+%\begin{jamotext}
+%e/rin/i/nvn na/ra/oa gye/rey/vi ap/nar/vr i/e/na/gar
+%sai/sa/ram/i/mv/ro gv/dvr/vi mom/goa ma/vm/vr gui/hi
+%ye/gye orh/go a/rvm/dab/go ssig/ssig/ha/gey ja/ra/do/rog
+%him/sse/ya han/da/.
+%\end{jamotext}
+%\end{korean}
+%
+%\begin{enumerate}
+%\item \textkorean{\jamoword{e/rin/i/nvn in/gan/v/ro/se
+%jon/jux/ha/ye/ya ha/mye sa/hoi/vi han sa/ram/v/ro/se
+%or/ba/rv/gey ki/ue/ya han/da/.}}
+%\end{enumerate}
+%\end{verbatim}
+%
+%\begin{quotation}
+%\begin{korean}
+%\begin{jamotext}
+%e/rin/i/nvn na/ra/oa gye/rey/vi ap/nar/vr i/e/na/gar
+%sai/sa/ram/i/mv/ro gv/dvr/vi mom/goa ma/vm/vr gui/hi
+%ye/gye orh/go a/rvm/dab/go ssig/ssig/ha/gey ja/ra/do/rog
+%him/sse/ya han/da/.
+%\end{jamotext}
+%\end{korean}
+%
+%\begin{enumerate}
+%\item \textkorean{\jamoword{e/rin/i/nvn in/gan/v/ro/se
+%jon/jux/ha/ye/ya ha/mye sa/hoi/vi han sa/ram/v/ro/se
+%or/ba/rv/gey ki/ue/ya han/da/.}}
+%\end{enumerate}
+%\end{quotation}
\begin{verbatim}
+\begin{verse}
\begin{korean}
\begin{jamotext}
-e/rin/i/nvn na/ra/oa gye/rey/vi ap/nar/vr i/e/na/gar
-sai/sa/ram/i/mv/ro gv/dvr/vi mom/goa ma/vm/vr gui/hi
-ye/gye orh/go a/rvm/dab/go ssig/ssig/ha/gey ja/ra/do/rog
-him/sse/ya han/da/.
+na bo/gi/ga yeg/gye/ue \\
+ga/sir ddai/ei/nvn \\
+mar ebs/i go/i bo/nai dv/ri/u/ri/da/.
+
+yex/byen/ei yag/san \\
+jin/dar/rai ggoc \\
+a/rvm dda/da ga/sir gir/ei bbu/ri/u/ri/da/.
+
+ga/si/nvn ger/vm ger/vm \\
+noh/in gv ggoc/vr \\
+sa/bbun/hi jv/rye/barb/go ga/si/ob/so/se
+
+na bo/gi/ga yeg/gye/ue \\
+ga/sir ddai/ei/nvn \\
+jug/e/do a/ni nun/mur hvr/ri/u/ri/da/.
\end{jamotext}
\end{korean}
-
-\begin{enumerate}
-\item \textkorean{\jamoword{e/rin/i/nvn in/gan/v/ro/se
-jon/jux/ha/ye/ya ha/mye sa/hoi/vi han sa/ram/v/ro/se
-or/ba/rv/gey ki/ue/ya han/da/.}}
-\end{enumerate}
+\end{verse}
\end{verbatim}
-\begin{quotation}
+\begin{verse}
\begin{korean}
\begin{jamotext}
-e/rin/i/nvn na/ra/oa gye/rey/vi ap/nar/vr i/e/na/gar
-sai/sa/ram/i/mv/ro gv/dvr/vi mom/goa ma/vm/vr gui/hi
-ye/gye orh/go a/rvm/dab/go ssig/ssig/ha/gey ja/ra/do/rog
-him/sse/ya han/da/.
+na bo/gi/ga yeg/gye/ue \\
+ga/sir ddai/ei/nvn \\
+mar ebs/i go/i bo/nai dv/ri/u/ri/da/.
+
+yex/byen/ei yag/san \\
+jin/dar/rai ggoc \\
+a/rvm dda/da ga/sir gir/ei bbu/ri/u/ri/da/.
+
+ga/si/nvn ger/vm ger/vm \\
+noh/in gv ggoc/vr \\
+sa/bbun/hi jv/rye/barb/go ga/si/ob/so/se
+
+na bo/gi/ga yeg/gye/ue \\
+ga/sir ddai/ei/nvn \\
+jug/e/do a/ni nun/mur hvr/ri/u/ri/da/.
\end{jamotext}
\end{korean}
-
-\begin{enumerate}
-\item \textkorean{\jamoword{e/rin/i/nvn in/gan/v/ro/se
-jon/jux/ha/ye/ya ha/mye sa/hoi/vi han sa/ram/v/ro/se
-or/ba/rv/gey ki/ue/ya han/da/.}}
-\end{enumerate}
-\end{quotation}
+\end{verse}
\subsection{pre-1933 Hangul}
@@ -436,15 +490,166 @@ e/nv na/ri i do/ra/gar h@i/o/.
\end{korean}
\end{verse}
+\let\jamoword\relax
+\let\jamotext\relax
+\let\endjamotext\relax
+\ExplSyntaxOn
+\input pmhanguljamo-rrk.tex
+\ExplSyntaxOff
+
+
+\section{The RRK input method} \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.
+
+If the package option \texttt{[RRK]} or \texttt{[rrk]} is given,
+the RRK method is activated. In this case, only `Modern Hangul' can
+be available.
+
+\subsection{Transliteration Rule of RRK}
+
+Table~\ref{tab:rrkcons} and \ref{tab:rrkvow} show the
+RRK transliteration rule.
+
+\begin{table}[h]
+\centering
+\caption{RRK Consonants} \label{tab:rrkcons}
+\fontspec{UnDotum.ttf}
+\begin{tabular}{ll|ll|ll|ll|ll|ll}
+\hline
+ㄱ & g & ㄲ & kk & ㅋ & k & ㄷ & d & ㄸ & tt & ㅌ & t \\
+ㅂ & b & ㅃ & pp & ㅍ & p & ㅈ & j & ㅉ & jj & ㅊ & ch \\
+ㅅ & s & ㅆ & ss & ㅎ & h & & & & & & \\ \hline
+ㄴ & n & ㅁ & m & ㅇ & ng & ㄹ & l & & & & \\ \hline
+\end{tabular}
+\end{table}
+
+\begin{table}[h]
+\centering
+\caption{RRK Vowels} \label{tab:rrkvow}
+\fontspec{UnDotum.ttf}
+\begin{tabular}{ll|ll|ll|ll|ll||ll}
+\hline
+ㅏ & a & ㅓ & eo & ㅗ & o & ㅜ & u & ㅡ & eu & ㅣ & i\\
+ㅐ & ae & ㅔ & e & ㅚ & oe & ㅟ & wi & & & & \\ \hline
+ㅑ & ya & ㅕ & yeo & ㅛ & yo & ㅠ & yu & ㅒ & yae & ㅖ & ye \\
+ㅘ & wa & ㅙ & wae & ㅝ & wo & ㅞ & we & ㅢ & ui & & \\ \hline
+ \end{tabular}
+ \end{table}
+
+\begin{enumerate}
+\item When the leading consonant `{\fontspec{UnBatang}\jmcc{X}}' is placed
+at the head of a word, it can be ommitted. Otherwise the hyphen character (\verb|-|) should be put. For example, \\
+\verb|\jamoword{annyeonghase-yo}| \textkorean{\jamoword{annyeonghase-yo}} \\
+\verb|\jamoword{jung-ang jungang}| \textkorean{\jamoword{jung-ang jungang}} \\
+\verb|\jamoword{ha-yeossseubnida}| \textkorean{\jamoword{ha-yeossseubnida}}
+
+\item The hyphen character \verb|-| can be used to forcibly separate syllables.
+And the special character \verb|/| is taken as another syllable separator.
+They are exchangeable.\\
+\verb|\jamoword{haeb/ssal haeb-ssal}| \textkorean{\jamoword{haeb/ssal haeb-ssal}}
+
+\item The six pucntuation marks, \texttt{.} \texttt{,} \texttt{!} \texttt{?} \texttt{;} \texttt{:} can be located in the Hangul scope.
+The others are not allowed.\\
+\verb|\jamoword{a! malg-eun haneul, si-wonhan baram.}| \\
+\textkorean{\jamoword{a! malg-eun haneul, si-wonhan baram.}}\\
+The \LaTeX\ quotes, \verb|``|, \verb|''|, \verb|`| and \verb|'| cannot be used
+within Hangul input scope. They should be located outside.
+However you can use unicode quotes, \verb|“| and \verb|”|, which can be input
+with syllable separator. For example, \\
+\verb|\jamoword{“/hangeul/”/ilan hangug-eoleul jeogneun geul-ida.}|\\
+\textkorean{\jamoword{“/hangeul/”/ilan hangug-eoleul jeogneun geul-ida.}}\\
+In this case, the syllable separator \verb|/| cannot be replaced by hyphen character.
+
+\item The leading consonant `\textkorean{\jmcc{R}}' is written with
+either \texttt{l} or \texttt{r}, while the trailing one should be \texttt{l}.\\
+\verb|\jamoword{noraereul nolaeleul}| \textkorean{\jamoword{noraereul nolaeleul}}
+
+\item We made it possible to use `Arae-A' with the RRK method.
+Though it is not present in Modern Hangul writing system, typesetting
+`Jeju language' or some pre-1933 Korean texts will be made easy with this.
+The `Arae-A' is to be input as `\texttt{@}' character, and the `Double Arae-A' `\texttt{@@}'. There is one exception. The one word with one letter that
+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 @@nam-eun}}.
+
+\end{enumerate}
+
+\subsection{Examples 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,
+ \url{https://en.wikipedia.org/wiki/Kim_Sowol}.}
+In section~\ref{sec:exammodern}, we showed default way of inputting
+the poem. The \textit{korean} environment and font settings are
+the same as in section~\ref{sec:exam}.
+
+\begin{verbatim}
+\begin{verse}
+\begin{korean}
+\begin{jamotext}
+na bogiga yeoggyeo-wo \\
+gasil ttae-eneun \\
+mal eobs-i go-i bonae deuli-ulida.
+
+yeongbyeon-e yagsan \\
+jindallae kkoch \\
+aleum ttada gasil gil-e ppuli-ulida.
+
+gasineun geol-eum geol-eum \\
+noh-in geu kkoch-eul \\
+sappunhi jeulyeobalbgo gasi-obsoseo
+
+na bogiga yeoggyeo-wo \\
+gasil ttae-eneun \\
+jug-eodo ani nunmul heulli-ulida.
+\end{jamotext}
+\end{korean}
+\end{verse}
+\end{verbatim}
+
+\begin{verse}
+\begin{korean}
+\begin{jamotext}
+na bogiga yeoggyeo-wo \\
+gasil ttae-eneun \\
+mal eobs-i go-i bonae deuli-ulida.
+
+yeongbyeon-e yagsan \\
+jindallae kkoch \\
+aleum ttada gasil gil-e ppuli-ulida.
+
+gasineun geol-eum geol-eum \\
+noh-in geu kkoch-eul \\
+sappunhi jeulyeobalbgo gasi-obsoseo
+
+na bogiga yeoggyeo-wo \\
+gasil ttae-eneun \\
+jug-eodo ani nunmul heulli-ulida.
+\end{jamotext}
+\end{korean}
+\end{verse}
+
+\section{Further Information}
+
+
For more examples and information about this package,
-please read the documentation \texttt{pmhanguljamo-kdoc.pdf}
+please read the documentation
+\href{http://mirrors.ctan.org/language/korean/pmhanguljamo/doc/pmhanguljamo-kdoc.pdf}{\texttt{pmhanguljamo-kdoc.pdf}}
(in Korean).
+
\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.
+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