diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/montex/mlsquick.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/montex/mlsquick.tex | 1038 |
1 files changed, 1038 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/montex/mlsquick.tex b/Master/texmf-dist/doc/latex/montex/mlsquick.tex new file mode 100644 index 00000000000..21fd6208f70 --- /dev/null +++ b/Master/texmf-dist/doc/latex/montex/mlsquick.tex @@ -0,0 +1,1038 @@ +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% File: mlsquick.tex +% Author: Oliver Corff +% Date: \VersionDate November 1st, 2001 +% Version: \VersionRelease +% Copyright: Ulaanbaatar, Beijing, Berlin +% +% Description: MonTeX -- Mongolian for LaTeX2e +% Implementation Level \ImplementationLevel +% System Documentation +% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% ----------------- identification ends here ------------------- +% +\documentclass[11pt,a4paper]{article} +\usepackage{longtable} +\IfFileExists{ctib}{% + \usepackage{ctib} +}{} +\usepackage[latin1]{mls} +\input{mtdocmac.tex} +%\usepackage{pslatex} +\usepackage{hyperref} +\begin{document} +\title{\MonTeX\\A Quick Guide\\(\emph{Draft})} +\author{Oliver Corff} +\maketitle +\tableofcontents +\section{General Settings} +In order to access the commands of \MonTeX\ the package must be +loaded in the document preamble by saying + +\begin{verbatim} +\usepackage[<language options>,<encoding options>]{mls} +\end{verbatim} + +The options include choices for the basic document language and +input encodings. + +\subsubsection{Document Language} + +The document language can be set with one of + \verb"bicig", + \verb"bithe", + \verb"buryat", + \verb"english", + \verb"russian" or + \verb"xalx" +like in +\begin{verbatim} +\usepackage[xalx]{mls} +\end{verbatim} +which issues all captions and the date in Modern Mongolian. + +The options \refcmda{bicig} and \refcmda{bithe} are introduced +in part~\ref{BicigandBithe}, ``Full Vertical Text Pages''. + +The options \cmda{buryat}, \cmda{russian} and \cmda{xalx} + produce captions in Buryat, Russian and Modern Mongolian. + +\begin{center} + \begin{tabular}{ll} + \textbf{Buryat} &\BuryatToday\\\label{BuryatToday} + \textbf{Xalx} &\XalxToday\\\label{XalxToday} + \textbf{Russian} &\RussianToday\\\label{RussianToday} + \end{tabular} +\end{center} + + +The option +\cmda{english}, at least as a \verb"\usepackage" option, is +essentially a do-nothing: it sets captions to English (which is +the default of this package anyway). +\section{Cyrillic Text -- \xalx{Kirill "us"ag}} + +\subsection{Cyrillic Text in Transliteration (\LMC) Mode% + \label{section:CyrillicTransliterationMode}} + +\MonTeX\ provides two basic modes of operation: in +\begin{itemize}\label{SetDocumentEncoding} + \item Transliteration Mode (intimately linked to the \LMC\ + encoding) all incoming text is regarded as + transliterated Cyrillic. This allows users to + compose Cyrillic documents on pure ASCII machines. + In contrast, the + \item Immediate Mode does nothing and waits for explicit + Cyrillic characters in the input in order to generate + Cyrillic output. +\end{itemize} +Two commands are used to switch between these modes: +\begin{quote} +\begin{verbatim} +\SetDocumentEncodingLMC +\SetDocumentEncodingNeutral +\end{verbatim} +\end{quote} + +The first command switches to Transliteration Mode, the second +command deactivates the transliteration and thus, by definition, +activates Immediate Mode. + +In the \LMC\ encoding, most Cyrillic characters are mapped directly to +a single Latin character but for some characters there is a text +command which became necessary since there are more Cyrillic than +Latin characters. For convenience, a few ligatures were defined, too. +Details are given in table~\ref{cyralpha}. + +\begin{table} +\begin{center} +\begin{tabular}{|r|cc|cc|ll|} +\hline +%\multicolumn{7}{|c|}{Cyrillic Alphabet Input Methods} \\\hline + &\multicolumn{2}{|c|}{Cyrillic Letter}&\multicolumn{2}{|c|}{\LMC\ +Input}&\multicolumn{2}{|c|}{Generic Command}\\\hline + 1 &\mnr A &\mnr a &\verb"A" &\verb"a" &\verb"\CYRA" &\verb"\cyra" \\\hline + + 2 &\mnr B &\mnr b &\verb"B" &\verb"b" &\verb"\CYRB" &\verb"\cyrb" \\\hline + + 3 &\mnr W &\mnr w &\verb"W" &\verb"w" &\verb"\CYRV" &\verb"\cyrw" \\\hline + + 4 &\mnr G &\mnr g &\verb"G" &\verb"g" &\verb"\CYRG" &\verb"\cyrg" \\\hline + + 5 &\mnr D &\mnr d &\verb"D" &\verb"d" &\verb"\CYRD" &\verb"\cyrd" \\\hline + + 6 &\mnr E &\mnr e &\verb"E" &\verb"e" &\verb"\CYRE"&\verb"\cyre" \\\hline + + 7 &\CYRYO &\cyryo &\texttt{\"E}/\verb'"E'&\texttt{\"e}/\verb'"e'&% + \verb"\CYRYO"&\verb"\cyryo"\rule{0mm}{2.25ex}\\ + & & &\{\verb"\"\}\verb"YO"&\{\verb"\"\}\verb"yo"& & \\\hline + + 8 &\mnr J &\mnr j &\verb"J" &\verb"j" &\verb"\CYRZH" &\verb"\cyrzh" \\\hline + + 9 &\mnr Z &\mnr z &\verb"Z" &\verb"z" &\verb"\CYRZ" &\verb"\cyrz" \\\hline + +10 &\mnr I &\mnr i &\verb"I" &\verb"i" &\verb"\CYRI" &\verb"\cyri" \\\hline + +11 &\CYRISHRT &\cyrishrt &\texttt{\"I}/\verb'"I'&\texttt{\"i}/\verb'"i'&% + \verb"\CYRISHRT"&\verb"\cyrishrt"\rule{0mm}{2.25ex} \\ + & & &\{\verb"\"\}\verb"YI"&\{\verb"\"\}\verb"yi"& & \\\hline + +12 &\mnr K &\mnr k &\verb"K" &\verb"k" &\verb"\CYRK" &\verb"\cyrk" \\\hline + +13 &\mnr L &\mnr l &\verb"L" &\verb"l" &\verb"\CYRL" &\verb"\cyrl" \\\hline + +14 &\mnr M &\mnr m &\verb"M" &\verb"m" &\verb"\CYRM" &\verb"\cyrm" \\\hline + +15 &\mnr N &\mnr n &\verb"N" &\verb"n" &\verb"\CYRN" &\verb"\cyrn" \\\hline + +16 &\mnr O &\mnr o &\verb"O" &\verb"o" &\verb"\CYRO" &\verb"\cyro" \\\hline + +17 &\CYROTLD &\cyrotld &\texttt{\"O}/\verb'"O'&\texttt{\"o}/\verb'"o'&% + \verb"\CYROTLD"&\verb"\cyrotld" \rule{0mm}{2.25ex}\\\hline + +18 &\mnr P &\mnr p &\verb"P" &\verb"p" &\verb"\CYRP" &\verb"\cyrp" \\\hline + +19 &\mnr R &\mnr r &\verb"R" &\verb"r" &\verb"\CYRR" &\verb"\cyrr" \\\hline + +20 &\mnr S &\mnr s &\verb"S" &\verb"s" &\verb"\CYRS" &\verb"\cyrs" \\\hline + +21 &\mnr T &\mnr t &\verb"T" &\verb"t" &\verb"\CYRT" &\verb"\cyrt" \\\hline + +22 &\mnr U &\mnr u &\verb"U" &\verb"u" &\verb"\CYRU" &\verb"\cyru" \\\hline + +23 &\mnr "U &\mnr "u &\texttt{\"U}/\verb'"U'&\texttt{\"u}/\verb'"u'&% + \verb"\CYRY"&\verb"\cyry" \rule{0mm}{2.25ex}\\\hline + +24 &\mnr F &\mnr f &\verb"F" &\verb"f" &\verb"\CYRF" &\verb"\cyrf" \\\hline + +25 &\mnr X &\mnr x &\verb"X" &\verb"x" &\verb"\CYRH" &\verb"\cyrh" \\\hline + +26 &\mnr H &\mnr h &\verb"H" &\verb"h" &\verb"\CYRHSHA" &\verb"cyrhsha" \\\hline + +27 &\mnr C &\mnr c &\verb"C" &\verb"c" &\verb"\CYRC" &\verb"\cyrc" \\\hline + +28 &\mnr Q &\mnr q &\verb"Q" &\verb"q" &\verb"\CYRCH" &\verb"\cyrch" \\ + & & &\verb"\Ch"&\verb"\ch"& & \\\hline + +29 &\mnr\Sh&\mnr\sh&\verb"\Sh"&\verb"\sh"&\verb"\CYRSH"&\verb"\cyrsh"\\ + & & & &\verb"sh" & & \\\hline + +30 &\mnr\Sc&\mnr\sc&\verb"\Sc"&\verb"\sc"&\verb"\CYRSHCH"&\verb"\cyrshch"\\ + & & &\verb"\Qh"&\verb"\qh"& & \\\hline + +31 &\mnr \CYRHRDSN &\mnr \cyrsftsn &\verb"\Y" &\verb"\y" &% + \verb"\CYRHRDSN" &\verb"\cyrhrdsn" \\\hline + +32 &\mnr Y &\mnr y &\verb"Y" &\verb"y" &\verb"\CYRERY" &\verb"\cyrery" \\\hline + +33 &\mnr \CYRSFTSN &\mnr \cyrsftsn &\verb"\I" &\verb"\i" &% + \verb"\CYRSFTSN" &\verb"\cyrsftsn" \\\hline + +34 &\CYREREV &\cyrerev &\texttt{\"A}/\verb'"A'&\texttt{\"a}/\verb'"a'&% + \verb"\CYREREV"&\verb"\cyrerev" \rule{0mm}{2.25ex}\\\hline + +35 &\mnr YU&\mnr yu&\{\verb"\"\}\verb"YU"&\{\verb"\"\}\verb"yu"&% + \verb"\CYRYU"&\verb"\cyryu"\\\hline + +36 &\mnr YA&\mnr ya&\{\verb"\"\}\verb"YA"&\{\verb"\"\}\verb"ya"&% + \verb"\CYRYA"&\verb"\cyrya"\\\hline +\end{tabular} +\caption{Cyrillic Alphabet Input Methods\label{cyralpha}} +\end{center} +\end{table} + +Front vowels can be entered directly using the encoding slot of a +valid and active input encoding, or they can be expressed via an +abbreviated \verb'"'\emph{v} notation where \emph{v} stands for any +desired vowel. In the \LMC\ encoding used by \MonTeX, \verb'"' is not +an active character; selecting the proper letter is done by ligature +statements in the Metafont sources. + +Some letters can be entered with or without a preceding \verb"\", +like \cyryu\ and \cyrya. Both \verb"\yu" and \verb"yu" will produce +a \cyryu. While \verb"yu" is interpreted as a ligature, \verb"\yu" +allows for the character \cyryu\ to be combined with accents. +Accents are not commonly used in Mongolian since there are precise +rules for word stress. This feature is taken from the \textsf{OT2} encoding +and is included mainly for the sake of completeness, convenience and +compatibility\footnote{The magic triple-C!}. + +Here now a sample of Mongolian text: +\exa + {\mnr<<Xalxyn gurwan "ond"or>> + x"am"a"an aldarshsan, Z"u"un xyazgaaryg + toxinuulax sa"id N.~Dugarjaw ardyn + xuw\i sgalyn b"u"ur "ax"an "ue"as + xamgi"in "agz"agt"a"i am\i\ d"u"is"an + alband tomilogdox c"ar"ag da"iny olon + quxal daalgawryg xiq"a"ang"u"il"an + biel"u"ulj yawsan t"u"uxt"a"i x"un.} +\exb +\begin{verbatim} + {\mnr<<Xalxyn gurwan "ond"or>> + x"am"a"an aldarshsan, Z"u"un xyazgaaryg + toxinuulax sa"id N.~Dugarjaw ardyn + xuw\i sgalyn b"u"ur "ax"an "ue"as + xamgi"in "agz"agt"a"i am\i\ d"u"is"an + alband tomilogdox c"ar"ag da"iny olon + quxal daalgawryg xiq"a"ang"u"il"an + biel"u"ulj yawsan t"u"uxt"a"i x"un.} +\end{verbatim} +\exc + +\subsection{Shorthands for embedding words in a different + typeface}\label{typefacecapsules} + +Sometimes it may be necessary to give short portions of text not +only in a different encoding (for which the \cmd{lat}\verb:{...}: +and \cmd{mnr}\verb:{...}: commands are +useful) but it may also be necessary to switch the typeface +temporarily. Usually capsules using \verb'\text'\emph{xx} do the +work if only the typeface is concerned, and building nested commands +like \verb'\textsf{\lat{...}}' is cumbersome if these changes have +to be applied very often. \MonTeX\ provides an abbreviated style +following the rule +\begin{quote} + \texttt{[k|l]}\emph{two letter font style code}\verb'{...}' +\end{quote} +where the font style code is one of + \verb'rm', + \verb'bf', + \verb'it', + \verb'sl', + \verb'sf', + \verb'sc' and + \verb'tt', +like \verb'\ksl{...}', \verb'\lsc{...}', etc. + + +\subsection{Shorthands for writing transliterated texts} + +\MonTeX\ provides shortcuts for writing certain accented symbols +used in conventional transliterating of Mongolian by +haceks, the nasal and the gamma. These shortcuts are essentially +mnemonics replacing the somewhat more tedious accent notation (see +table~\ref{shortcuts}). + +\begin{table} +\begin{center}\begin{tabular}{ll|ll} +%\hline +Letter & Input & Letter & Input \\ + & & &\\ +\hline + & & &\\ +\ch & \verb"\ch" & \Ch & \verb"\Ch" \\ +\jh & \verb"\jh" & \Jh & \verb"\Jh" \\ +\sh & \verb"\sh" & \Sh & \verb"\Sh" \\ +\zh & \verb"\zh" & \Zh & \verb"\Zh" \\ +\ng & \verb"\ng" & \Ng & \verb"\Ng" \\ +\g & \verb"\g" & \G & \verb"\G" \\ +%\hline +\end{tabular}\end{center} +\caption{Shortcuts for Mongolian Transliteration Symbols\label{shortcuts}} +\end{table} + +It must be observed that these commands are by default dependent on +the environment they are used in. \verb"\Sh" yields a \Sh\ when used +in a Latin environment but results in a \mnr\Sh\rnm\ when used in a +Cyrillic context\footnote{The authors wish to thank J.~Knappen for +resolving one instability in the original code for these letters.}: + +\exa + \emph{\Sh agdar} and \emph{\Ch adraa} + are transliterations for + {\mnr\Sh agdar} and {\mnr\Ch adraa}. +\exb + \begin{verbatim} + \emph{\Sh agdar} and \emph{\Ch adraa} + are transliterations for + {\mnr\Sh agdar} and {\mnr\Ch adraa}. + \end{verbatim} +\exc + + +\section{Uighur Mongolian and Manju Input} + +A comprehensive table of the Mongolian alphabet and its MLS +transliteration, the input conventions of the MLS transliteration in +\MonTeX\ and the Simplified Transliteration is given in +table~\ref{table:bcgcagan}. + +\newcommand{\bcgcagan}[4]{% + \mbosoo{#1} & \texttt{#2} & \texttt{#3} & \texttt{#4} %\\ + } + +\begin{table}[h] +\begin{center} +\begin{tabular}{cccc|cccc} +%\hline +Uighur&\multicolumn{2}{c}{MLS} &Simplified + &Uighur&\multicolumn{2}{c}{MLS}&Simplified\\ +Script&Transl.& Input &Input &Script&Transl.& Input&Input\\ +\hline +\bcgcagan{a}{a}{a}{a} & \bcgcagan{s}{s}{s}{s} \\ +\bcgcagan{E}{\"a}{\"a, E}{e} & \bcgcagan{S}{sh}{S}{sh}\\ +\bcgcagan{e}{e}{e}{v} & \bcgcagan{t}{t}{t}{t} \\ +\bcgcagan{i}{i}{i}{i} & \bcgcagan{d}{d}{d}{d, t}\\ +\bcgcagan{o}{o}{o}{u} & \bcgcagan{l}{l}{l}{l} \\ +\bcgcagan{u}{u}{u}{u} & \bcgcagan{m}{m}{m}{m} \\ +\bcgcagan{O}{\"o}{\"o, O}{ui, u}& \bcgcagan{c}{c}{c}{c} \\ +\bcgcagan{U}{\"u}{\"u, U}{ui, u}& \bcgcagan{z}{z}{z}{z} \\ +\bcgcagan{n}{n}{n}{n} & \bcgcagan{y}{y}{y}{y} \\ +\bcgcagan{|ng}{*ng}{ng}{ng} & \bcgcagan{r}{r}{r}{r} \\ +\bcgcagan{x}{x}{x}{x} & \bcgcagan{v}{v}{v}{v} \\ +\bcgcagan{G}{\g}{G}{g} & \bcgcagan{h}{h}{h}{h} \\ +\bcgcagan{k}{k}{k}{k} & \bcgcagan{j}{j}{j}{j} \\ +\bcgcagan{g}{g}{g}{g, k} & \bcgcagan{K}{K}{K}{K} \\ +\bcgcagan{b}{b}{b}{b} & \bcgcagan{Q}{[--]}{Q}{q}\\ +\bcgcagan{p}{p}{p}{p} & \bcgcagan{C}{C}{C}{C} \\ +\bcgcagan{f}{f}{f}{f} & \bcgcagan{Z}{Z}{Z}{Z} \\ +%\hline +\end{tabular} +\end{center} +\caption{Mongolian Script Transliterations\label{table:bcgcagan}} +\end{table} + +The possible combinations of Mongolian writing input methods +and display commands are listed in table~\ref{table:Combinations}. +The columns stand for each possible input encoding, the rows contain +the display command types. Each table cell at the contains the command +that is available for a given combination of input method and +command. + +\newcommand{\ComparisonTable}[4]{% + #1 &% % Command Type + #2 &% % MLS Command + #3 &% % Simplified Command + #4 \\% % Manju Command +} +\begin{table}[h] +\begin{center} +\begin{tabular}{p{2cm}|p{3.25cm}|p{3.25cm}|p{3.25cm}} +Command & \multicolumn{2}{c|}{Mongolian}& Manju \\ +Type & MLS & Simplified & \\ +\hline +\ComparisonTable{Document Encoding} + {only available as font encoding \LMS, not as + document encoding} + {\texttt{LMO}} + {\texttt{LMA}} +\hline +\ComparisonTable{Horizontal Capsules} + {\refcmd{bcg}} + {\refcmd{bicig}} + {\refcmd{bithe}} +\hline +\ComparisonTable{Horizontal Paragraphs} + {not available} + {\refcmda{bicigtext}} + {\refcmda{bithetext}} +\hline +\ComparisonTable{Vertical Capsules} + {\refcmd{mbosoo}} + {\refcmd{mobosoo}} + {\refcmd{mabosoo}} +\hline +\ComparisonTable{Vertical Paragraph Boxes} + {not available} + {\refcmd{mobox}} + {\refcmd{mabox}} +\hline +\ComparisonTable{Vertical Pages} + {not available} + {\refcmda{bicigpage}} + {\refcmda{bithepage}} +%\hline +\end{tabular} +\caption{Mongolian Input and Display Commands\label{table:Combinations}} +\end{center} +\end{table} + +While the input method for the majority of characters matches the +transliteration conventions, some letters require a slightly +different treatment: +\begin{enumerate} + \item Although the diphtong \mobosoo{*aii*} is usually + rendered as \textit{ayi}, it must be entered + as \texttt{aii} in order to produce the desired + effect. + + \item The back vowels \emph{o} and \emph{u} are both rendered + as \texttt{u}. + + \item The front vowels \emph{\"o} and \emph{\"u} are both + rendered as \texttt{ui} in first syllables and as + \texttt{u} in later syllables. + + \item Since \mobosoo{t} means both \emph{t} and \emph{d}, + it is necessary to spell this letter as \texttt{t} + in the beginning of words, and \texttt{d} in the + middle of words, regardless of the actual meaning. + + \item The four consonants \emph{\g}, \emph{g}, \emph{x} + and \emph{k} are constrained with regard to the + following vowels. The Simplified Transliteration + renders these as \texttt{g} (before \emph{a} + and \emph{u} only), \texttt{g} (before \emph{a} + and \emph{u} only), \texttt{x} and \texttt{k}. +\end{enumerate} + + +As it was demonstrated in subsection~\ref{section:CyrillicTransliterationMode}, +it is technically possible to choose between an automatic document encoding +and the neutral mode. In the case of Uighur Mongolian, the mode of choice +activates the Simplified Transliteration Mode and is called with +\begin{quote} +\begin{verbatim} +\SetDocumentEncodingBicig +\end{verbatim} +\end{quote} + + +With +\verb"\SetDocumentEncodingBicig"\label{cmd:SetDocumentEncodingBicig} set, +it is possible to switch to the Simplified Transliteration Mode anywhere +in the document, not only in the preamble. + +\textit{Caveat:} Since switching to Uighur Mongolian text +requires a lot of settings to be effected at the same time, there +are high-level commands available (see below all kinds of Mongolian +and Manju Display Commands) which do all the work, including the definition of the +document encoding. Thus, while \verb|\SetDocumentEncodingBicig| +is indeed classified as a user-level command, it is certainly not +necessary for everyday work. + + +\subsection{Character Variants} + +With the assistance of special, non-printing characters like the +Form Variant Selectors, the appearance of certain characters can be +modified in order to display typographical and orthographical +variants. Notably, the \emph{n} will loose its dot before vowels, +as will \emph{\g}. Let's assume the word ``place'' is written in an +old book as \bicig{g'azar}. It should be understood that this is a +variant of \bicig{gazar} and should be spelled \emph{\g'azar}, not +\emph{xazar}. With vowels, the Form Variant Selectors can change the +shape that is usually required by graphical context. At present, +only the first of two Form Variant Selectors actually does +something, the exact behaviour of the second Form Variant Selector +waits to be implemented. + +The following short example shows a concrete application of this +method. It renders the six syllable mantra \emph{om ma ni padme hum} +(tib. {\tib \om, ma nxi pa\V{de}{ma} \hung}) as it is +displayed on a huge bronze incense burner in front of the Gandan +Monastery in Ulaanbaatar: + +\exa + \mobox{3cm}{\noindent\sffamily + \om uva\\ + \ ma'=a\\ + \ n'i\\ + \ badmi'\\ + \om huu} +\exb + \begin{verbatim} + \mobox{3cm}{\noindent\sffamily + \om uva\\ + \ ma'=a\\ + \ n'i\\ + \ badmi'\\ + \om huu} + \end{verbatim} +\exc + +\subsection{Special Characters\label{section:SpecialMLSCharacters}} + +For the correct operation of retransliterating systems processing +Mongolian script additional symbols are needed. These include +Form Variant Selectors (\textsf{FVS}), the Vowel Separator, and +other symbols like the Mongolian Positional Indicator. As can be +seen from its usage in table~\ref{table:bcgcagan}, entering \verb|*ng| +tells the system to consider this \emph{ng} to be in non-initial +position.\footnote{Unfortunately, though it is now commonly +agreed in the scientific community that these symbols are needed, +their definition is still in a state of flux, and thus the symbols +given here are presented on a preliminary basis.} + +Besides these symbols, table~\ref{table:SpecialMLSCharacters} includes +also some useful punctuation marks etc.\ as they are used in +Mongolian Script. + +\begin{table} +\begin{center} +\begin{tabular}{c|l|l} +%\hline + Symbol & Name & Input \\ + \hline + \bosoo{\glyphbcg{!}} & Exclamation Mark & \verb|!| \\ + \bosoo{\glyphbcg{?}} & Question Mark & \verb|?| \\ + \bosoo{\glyphbcg{!?}} & Exclamation Question Mark& \verb|!?| \\ + \bosoo{\glyphbcg{?!}} & Question Exclamation Mark& \verb|?!| \\ + \bosoo{\glyphbcg{*}} & Mong. Positional Indicator& \verb|*| \\ + \bosoo{\glyphbcg{\char32}} & Mongolian Space & \verb*|-| \\ + \bosoo{\glyphbcg{(}} & Opening Bracket & \verb|(| \\ + \bosoo{\glyphbcg{)}} & Closing Bracket & \verb|)| \\ + \bosoo{\glyphbcg{<}} & Opening Angle Bracket & \verb|<| \\ + \bosoo{\glyphbcg{>}} & Closing Angle Bracket & \verb|>| \\ + \bosoo{\glyphbcg{<<}} & Opening Guillemot & \verb|<<| \\ + \bosoo{\glyphbcg{>>}} & Closing Guillemot & \verb|>>| \\ +% \bosoo{\glyphbcg{\{}} & Opening Parenthesis & \verb|{| \\ +% \bosoo{\glyphbcg{\}}} & Closing Parenthesis & \verb|}| \\ + \bosoo{\glyphbcg{'}} & Form Variant Selector 1& \verb|'| \\ + \bosoo{\glyphbcg{"}} & Form Variant Selector 2& \verb|"| \\ + \bosoo{\glyphbcg{\char43}}& Mong. Vowel Separator & \verb|=| \\ + \bosoo{\glyphbcg{|}} & Mongolian Nuruu & \verb'|' \\ + \bosoo{\glyphbcg{.}} & Period & \verb|.| \\ + \bosoo{\glyphbcg{,}} & Comma & \verb|,| \\ + \bosoo{\glyphbcg{:}} & Colon & \verb|:| \\ + \bosoo{\glyphbcg{;}} & D\"orw\"oljin & \verb|;| \\ + \bosoo{\glyphbcg{..}} & Ellipsis & \verb|..| \\ + \bosoo{\glyphbcg{0}} & Digit zero & \verb|0| \\ + \bosoo{\glyphbcg{1}} & Digit one & \verb|1| \\ + \bosoo{\glyphbcg{2}} & Digit two & \verb|2| \\ + \bosoo{\glyphbcg{3}} & Digit three & \verb|3| \\ + \bosoo{\glyphbcg{4}} & Digit four & \verb|4| \\ + \bosoo{\glyphbcg{5}} & Digit five & \verb|5| \\ + \bosoo{\glyphbcg{6}} & Digit six & \verb|6| \\ + \bosoo{\glyphbcg{7}} & Digit seven & \verb|7| \\ + \bosoo{\glyphbcg{8}} & Digit eight & \verb|8| \\ + \bosoo{\glyphbcg{9}} & Digit nine & \verb|9| \\ +% \hline +\end{tabular} +\end{center} +\caption{Mongolian Script Special Symbols and Punctuation + Marks\label{table:SpecialMLSCharacters}} +\end{table} + +\subsection{Manju Input} + +Manju documents can be compiled with the \refcmda{bithe} option +to the \verb|\usepackage| command, which will create complete +documents in Manju. Anywhere in the document, it is possible to +switch to Manju input (transliteration mode) +with +\verb"\SetDocumentEncodingBithe"\label{cmd:SetDocumentEncodingBithe} which +internally activates the \LMA\label{a:LMA} encoding. + +\textit{Caveat:} Since switching to Manju text +requires a lot of settings to be effected at the same time, there +are high-level commands available (see below) which do all the work, including +the definition of the document encoding. Thus, while +\verb|\SetDocumentEncodingBithe| is indeed classified as a +user-level command, it is certainly not necessary for everyday work. + + +\subsection{Basic Character Set and Romanization} + +Given by dictionary order, the system provides a basic +character set as shown in table~\ref{table:ManjuBasicChars}. + +\newcommand{\MaEntry}[3]{\mabosoo{#1}& #2 & #3 } +\begin{table} +\begin{center} +\begin{tabular}{ccc|ccc|ccc} +Manju&Input&Latin&Manju&Input&Latin&Manju&Input&Latin\\ +\hline +\MaEntry{a}{a}{a} & \MaEntry{h}{h}{h} & \MaEntry{c}{c}{c} \\ +\MaEntry{e}{e}{e} & \MaEntry{b}{b}{b} & \MaEntry{j}{j}{j} \\ +\MaEntry{i}{i}{i} & \MaEntry{p}{p}{p} & \MaEntry{y}{y}{y} \\ +\MaEntry{o*}{o}{o} & \MaEntry{s}{s}{s} & \MaEntry{k'}{k'}{k'} \\ +\MaEntry{u*}{u}{u} & \MaEntry{s'}{s'}{\v s} & \MaEntry{g'}{g'}{g'} \\ +\MaEntry{v}{v}{\={u}} & \MaEntry{t}{t}{t} & \MaEntry{h'}{h'}{h'} \\ +\MaEntry{n}{n}{n} & \MaEntry{d}{d}{d} & \MaEntry{r}{r}{r} \\ +\MaEntry{k}{k}{k} & \MaEntry{l}{l}{l} & \MaEntry{f}{f}{f} \\ +\MaEntry{g}{g}{g} & \MaEntry{m}{m}{m} & \MaEntry{w}{w}{w} \\ +\end{tabular} +\caption{Manju Basic Character Set\label{table:ManjuBasicChars}} +\end{center} +\end{table} + +While the input method for the majority of characters matches the +transliteration conventions, some letters require a slightly +different treatment: +\begin{enumerate} + \item Although the diphtong \mabosoo{*aii*} is + usually rendered as \textit{ai}, it must be entered + as \texttt{aii} in order to produce the desired + effect. + \item The vowel which is conventionally rendered as \textit{\^u} + or \textit{\=u} \mabosoo{v} can be entered as \texttt{v} + or as \verb|\={u}| due to the fact that a character + \textit{\^u} is not readily available on most systems. + \item The consonant \textit{\v s} \mabosoo{s'} can be entered as + \texttt{s'} or as \verb|\v{s}|, but not as *\texttt{sh} + as to avoid undesired mergers of \textit{s} and \textit{h} + like in \textit{ishun} \mabosoo{ishun} which should not be + *\textit{i\v{s}un} \mabosoo{is'un}! +\end{enumerate} + + +\subsection{Small Portions of Mongolian and Manju in Running Text} + +For displaying short Mongolian snippets in running text +use +\begin{itemize} + \item [MLS Romanization] \cmd{bcg}\verb|{...}|. + \item [Simplified Transliteration] \cmd{bicig}\verb|{...}|. +\end{itemize} + +For displaying short Manju snippets in running text +use \cmd{bithe}\verb|{...}|. + +\exa + This is \bicig{munggul bicik}. + + That is \bithe{manju bithe}. +\exb + \begin{verbatim} + This is \bicig{munggul bicik}. + + That is \bithe{manju bithe}. + \end{verbatim} +\exc + +\subsection{Horizontal Paragraphs of Mongolian or Manju Text} + +If one needs more than a few words of Mongolian or Manju but does +not want to change the line orientation, then the environments +\cmda{bicigtext} for Mongolian (which should be entered in +Mongolian Simplified Transliteration) and \cmda{bithetext} for Manju are +useful. + +\exa + \begin{bicigtext} + uindur gegen zanabazar. + + 17..18 d'ugar zagun-u munggul-un + neiigem, ulus tuiru, shasin-u uiiles-tu, + ilangguy=a uralig-un kuikzil-du uncukui + ekurge kuiicedgeksen uindur gegen + zanabazar, cingkis xagan-u aldan + urug-un izagur surbulzidan abadai + saiin nuyan xan-u kuiu tuisiyedu xan + gumbudurzi-yin ger-tu 1635 un-du + tuiruksen.% + \end{bicigtext} +\exb + {\mdoublehyphenon + \begin{verbatim} + \begin{bicigtext} + uindur gegen zanabazar. + + 17..18 d'ugar zagun-u munggul-un + neiigem, ulus tuiru, shasin-u + uiiles-tu, ilangguy=a uralig-un + kuikzil-du uncukui ekurge + kuiicedgeksen uindur gegen + zanabazar, cingkis xagan-u + aldan urug-un izagur surbulzidan + abadai saiin nuyan xan-u kuiu + tuisiyedu xan gumbudurzi-yin + ger-tu 1635 un-du tuiruksen. + \end{bicigtext} + \end{verbatim}} +\exc + + +\exa + \begin{bithetext} + han-i araha sunja + hacin-i hergen kamciha + manju gisun-i buleku + bithe. abkai so\v{s}ohon. + emu hacin. nadan meyen.% + \end{bithetext} +\exb + \begin{verbatim} + \begin{bithetext} + han-i araha sunja + hacin-i hergen kamciha + manju gisun-i buleku + bithe. abkai so\v{s}ohon. + emu hacin. nadan meyen.% + \end{bithetext} + \end{verbatim} +\exc + +\subsection{Vertical Capsules} + +Individual Mongolian and Manju words can be placed vertically +anywhere in otherwise horizontal text like in +the keyword entry of dictionaries.\footnote{Famous dictionaries with + a mixture of vertical and horizontal printing are I.~J.~Schmidt's + Mongolian-Russian-German dictionary (1835) and F.~Lessing's + Mongolian-English dictionary (1960).}.\marginpar{% +\mbosoo{mongGol}\mbosoo{bicig} + + \vspace{2.54mm} + + \raggedright\small + without PostScript support Mongolian text enclosed in + vertical capsules will be printed \emph{horizontally}!} +The capsule containing the +Mongolian or Manju word will automatically request sufficient space +so that ugly overlaps with neighbouring lines will not happen. + +For presenting text given in broad (or MLS) transliteration, use the command +\cmd{mbosoo}\verb|{...}|; when writing in Mongolian Simplified +Transliteration, use \cmd{mobosoo}\verb|{...}|; likewise for Manju, use +\cmd{mabosoo}\verb|{...}|. All these commands are derived from a +command \cmd{bosoo}\verb|{...}| which places text in vertical +capsules but leaves the contents untouched as far as the encoding is +concerned. + +\exa + This is \bosoo{vertical} + \bosoo{text}. + This is \mbosoo{mongGol} + \mbosoo{bicig}, + this is \mobosoo{munggul} + \mobosoo{bicik}, + that is \mabosoo{manju} + \mabosoo{bithe}. +\exb + \begin{verbatim} + This is \bosoo{vertical} + \bosoo{text}. + This is \mbosoo{mongGol} + \mbosoo{bicig}, + this is \mobosoo{munggul} + \mobosoo{bicik}, + that is \mabosoo{manju} + \mabosoo{bithe}. + \end{verbatim} +\exc + + +\subsection{Vertical Text Boxes} + +For presenting individual paragraphs of Mongolian or Manju text in +vertical manner in an otherwise horizontal text, there are the box +commands \cmd{mobox}\verb|{...}{...}| for Mongolian% +\footnote{Mongolian input \emph{must} be coded in Mongolian Simplified + Transliteration; MLS input won't work.} +and +\cmd{mabox}\verb|{...}{...}| +for Manju. These boxes take two arguments. The first argument +indicates the \textit{vertical depth} of the box, or its line +length. The second argument contains the desired text. + +\exa + \mobox{7.5cm}{% +% uindur gegen zanabazar. +% + 17..18 d'ugar zagun-u munggul-un + neiigem, ulus tuiru, shasin-u uiiles-tu, + ilangguy=a uralig-un kuikzil-du uncukui + ekurge kuiicedgeksen uindur gegen + zanabazar, cingkis xagan-u aldan + urug-un izagur surbulzidan abadai + saiin nuyan xan-u kuiu tuisiyedu xan + gumbudurzi-yin ger-tu 1635 un-du + tuiruksen.% + } +\exb + %\vskip-9cm + {\mdoublehyphenon + \begin{verbatim} + \mobox{7.5cm}{% + uindur gegen zanabazar. + + 17..18 d'ugar zagun-u munggul-un + neiigem, ulus tuiru, shasin-u + uiiles-tu, ilangguy=a uralig-un + kuikzil-du uncukui ekurge + kuiicedgeksen uindur gegen + zanabazar, cingkis xagan-u + aldan urug-un izagur surbulzidan + abadai saiin nuyan xan-u kuiu + tuisiyedu xan gumbudurzi-yin + ger-tu 1635 un-du tuiruksen.% + } + \end{verbatim}} +\exc + + +\exa + \mabox{3.75cm}{% + \noindent\raggedleft han-i araha sunja + hacin-i hergen kamciha + manju gisun-i buleku + bithe. abkai so\v{s}ohon. + emu hacin. nadan meyen.% + } +\exb + %\vskip-5.25cm + \begin{verbatim} + \mabox{3.75cm}{% + \raggedleft han-i araha sunja + hacin-i hergen kamciha + manju gisun-i buleku + bithe. abkai so\v{s}ohon. + emu hacin. nadan meyen.% + } + \end{verbatim} +\exc + +\subsection{Full Vertical Text Pages\label{BicigandBithe}} + +If you need several pages of Mongolian output, enclose your text +in an evironment \cmda{bicigpage}, and use \cmda{bithepage} +likewise for Manju texts. Note that Mongolian must be entered in +Simplified Transliteration. + +Finally, if you want the whole document and its basic language to be +Classical, or Uighur Mongolian, say \verb|\usepackage[bicig,...]{mls}|. +Likewise, complete Manju documents are produced with +\verb|\usepackage[bithe,...]{mls}|. + +If you start a document with a \verb|\usepackage[bicig]{mls}| +declaration you can still switch back to Latin by issuing an +\verb|\end{bicigpage}| command. + +Likewise, if you start a document with a \verb|\usepackage[bithe]{mls}| +declaration you can still switch back to Latin by issuing an +\verb|\end{bithepage}| command. + +The following snippet of Mongolian text is presented in full +page mode on the next pages, first in Simplified Transliteration form, then +in Uighur form; in order to achieve this result the text had to be +included in the environment \texttt{bicigpage}. + +\noindent +\begin{figure} +\begin{verbatim} +\begin{bicigpage} +uindur gegen zanabazar. + +17||18 d'ugar zagun-u munggul-un neiigem, ulus tuiru, shasin-u +uiiles-tu, ilangguy=a uralig-un kuikzil-du uncugui ekurge +kuiicedgeksen uindur gegen zanabazar, cingkis xagan-u aldan +urug-un izagur surbulzidan abadai saiin nuyan xan-u kuiu +tuisiyedu xan gumbudurzi-yin ger-tu 1635 un-du tuiruksen. +badu muingke dayan xagan-u 6-d'aki uiy=e-yin kuimun. gurban +nasudai-d'agan num ungsizu enedkek gazar tuibed kele-yi xar=a +ayandagan surcu, keuked axui cag-aca erdem num-un duiri-tei +bulugsan zanabazar 15 nasu-tai-dagan baragun zuu (lhasa) +uruzu tabudugar dalai lam=a-d'u shabilan saguzu, ulamar +zebCundamba-yin xubilgan tudurazei. uran barimalci, zirugaci, +kele sinzigeci, uran barilgaci, kuin uxagandan zanabazar ulan +zagun zil-un daiin tululdugan-d'u nerbekden suliduzu, zugsunggi +baiidal-d'u urugsan dumdadu zagun-u munggul-un suyul uralig-i +serkun manduxu-d'u yeke xubi nemekuri urugulugsan yum. tekun-u +abiyas bilig nuiri yeke kuidelmuri-ber munggul-un uralig nigen +uiy=e tanigdasi uigei uindurlik-tu kuiruksen azei. xarin 1654 +un-d'u neiislel kuiriyen-u tulg=a-yin cilagu-yi tabilcagsan +zanabazar-un uran barilg=a-yin buidugel-ece uinudur-i uizeksen +zuiil barug uigei ni xaramsaldai. zanabazar uindesun-u bicig +uisuk-i kuikzikulku-d'u beyecilen urulcazu, suyungbu uisuk-i +zukiyazu ene uiy=e suyungbu ni man-u tusagar tugdanil-un belge +temdek bulugsagar baiin=a. tere-ber <<cag-i tukinagulugci>> +gedek silukleksen zukiyal-d'agan arad tuimen-u-ben engke +amugulang, saiin saiixan-i imagda kuisen muirugedezu yabudag +sedkil-un-iien uige-i ilerkeiileksen baiidag. uindur gegen +duirsuleku uralig-un xubi-d'u uirun=e-yin sunggudag-ud-tai +eng zergeceku buidugel-tei kuimun abacu basa xari ulus-un +buzar bacir arg=a-d'u abdagdan yabugsan nigen. +... +... more text ... + ... +\end{bicigpage} +\end{verbatim} +\caption{Input Example of a Mongolian text} +\end{figure} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{bicigpage} + uindur gegen zanabazar. + + 17||18 d'ugar zagun-u munggul-un neiigem, ulus tuiru, + shasin-u uiiles-tu, ilangguy=a uralig-un kuikzil-du + uncugui ekurge kuiicedgeksen uindur gegen zanabazar, + cingkis xagan-u aldan urug-un izagur surbulzidan abadai + saiin nuyan xan-u kuiu tuisiyedu xan gumbudurzi-yin + ger-tu 1635 un-du tuiruksen. badu muingke dayan xagan-u + 6-d'aki uiy=e-yin kuimun. gurban nasudai-d'agan num + ungsizu enedkek gazar tuibed kele-yi xar=a ayandagan + surcu, keuked axui cag-aca erdem num-un duiri-tei + bulugsan zanabazar 15 nasu-tai-dagan baragun zuu + (lhasa) uruzu tabudugar dalai lam=a-d'u shabilan + saguzu, ulamar zebCundamba-yin xubilgan tudurazei. uran + barimalci, zirugaci, kele sinzigeci, uran barilgaci, + kuin uxagandan zanabazar ulan zagun zil-un daiin + tululdugan-d'u nerbekden suliduzu, zugsunggi + baiidal-d'u urugsan dumdadu zagun-u munggul-un suyul + uralig-i serkun manduxu-d'u yeke xubi nemekuri + urugulugsan yum. tekun-u abiyas bilig nuiri yeke + kuidelmuri-ber munggul-un uralig nigen uiy=e tanigdasi + uigei uindurlik-tu kuiruksen azei. xarin 1654 un-d'u + neiislel kuiriyen-u tulg=a-yin cilagu-yi tabilcagsan + zanabazar-un uran barilg=a-yin buidugel-ece uinudur-i + uizeksen zuiil barug uigei ni xaramsaldai. zanabazar + uindesun-u bicig uisuk-i kuikzikulku-d'u beyecilen + urulcazu, suyungbu uisuk-i zukiyazu ene uiy=e suyungbu + ni man-u tusagar tugdanil-un belge temdek bulugsagar + baiin=a. tere-ber <<cag-i tukinagulugci>> gedek + silukleksen zukiyal-d'agan arad tuimen-u-ben engke + amugulang, saiin saiixan-i imagda kuisen muirugedezu + yabudag sedkil-un-iien uige-i ilerkeiileksen + baiidag. uindur gegen duirsuleku uralig-un xubi-d'u + uirun=e-yin sunggudag-ud-tai eng zergeceku buidugel-tei + kuimun abacu basa xari ulus-un buzar bacir arg=a-d'u + abdagdan yabugsan nigen. + + munggul-d'u urcigulxu uxagan yeke delgerezu baiigsan ni + man-u erden ba dumdadu uiy=e-yin suyul-un nigen uncalig + azei. erden-u enedkek-un kuin uxagan-u iragu naiirag, + kele bicik-un sudulul, anagaxu uxagan, uralaxu uxagan + zerge tabun uxagan-u zukiyal-i bagdagagsan buikude 334 + budi <<ganzuur>>, <<danzuur>>-i num-un mergen bagsi + kuinggaudsar terikudei 64 erdemden lama urcigulun + neiideleksen baiin=a. 400 zil-un terdege urcigulg=a-yin + iimu eke kuiriyeleng munggul-d'u azillazu baiigsan-i + tuisugelen buduxu-d'u baxadai. munggulcud erden-ece + inagsi daguu xugur-tai buizik nagadum-tai xurdun + kuiluk murid-tai. er=e-yin gurban nagadum-i erkimelen + kuikzilduzu, ide xabu-ban bulgazu ireksen baiin=a. + munggul-un zirgalang ni buizik, xurim bile. xudala-i + xagan-d'u erkumzileged xurxunag-un sagalagar mudun-u + duur=a xabirg=a gazar-i xalcaradal=a, ebuduk gazar-i + uilduredel=e debkecen buiziklezu xurimlaba gesen uige + <<niguca tubciyan>>-d'u bui. munggul arad-un medelge + uxagan erde-ece inagsi mal azu axui, udun urun, + gazar zuii, anagaxu uxagan, baiigali, neiigem-un + ulan salburi-bar kuikzizu irebe. <<aldan tubci>>, + <<erdeni-yin tubci>>, <<bulur tuli>>, <<subud erike>> + medu teuke-yin ulan arban zukiyal gargazei. + + manzu nar <<munggul uyun>>-i muikugeku-yi kedui-ber + uruldubacu uyun bilikdu, cecen celmek, erdem uxagandan + tuduran garugsagar baiiba. 19-d'uger zagun bul + iragu naiiragci dangzirabzai. yeke zukiyalci inzinasi + dangzigvangzil nar-un amidurazu, buidugezu baiigsan + uiy=e bile. +\end{bicigpage} + +\subsection{Pure Uighur Mongolian and Manju Documents} + +Writing a complete document in Mongolian or Manju is as simple and +straightforward as writing a document in English or Xalx Mongolian. + +The example file, \texttt{zanabazr.tex} +(shipped together with this documentation and located in the +directory \texttt{../examples/}) demonstrates how a pure +Mongolian Bicig document can be created. + +\begin{figure}[h] +\begin{verbatim} +\documentclass{article} +\usepackage[bicig]{mls} +\begin{document} +uindur gegen zanabazar. + +17||18 d'ugar zagun-u munggul-un neiigem, ulus tuiru, +shasin-u uiiles-tu, ilangguy=a uralig-un kuikzil-du +... +... more text ... + ... +\end{document} +\end{verbatim} +\end{figure} + +The concept is the same for Manju documents: instead of \cmda{bicig} +one would use the \verb|\usepackage[...]{mls}| option \cmda{bithe} +and enter Manju text. + +\subsection{Font Selection Commands} + +There are two distinct styles of Mongolian script: one style +is typically used for modern print, whereas the other style +appears in old block prints and stone inscriptions. + +Since there is no proper equivalent between Latin and Mongolian +typographical features, a somewhat arbitrary assignment was made +to the effect that the block print style can be activated by +setting the font family sans serif with \cmd{sffamily}. In +contrast, setting the roman default family with \cmd{rmfamily} +switches back to the modern style. + +\exa + \mobox{2cm}{% + \parindent=0pt + \par + munggul\\ + \sffamily munggul\\ + \rmfamily munggul + } +\exb + \begin{verbatim} + \mobox{2cm}{\noindent + munggul\\ + \sffamily munggul\\ + \rmfamily munggul} + \end{verbatim} +\exc + +\end{document} |