summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/manjutex/manjutex.tex
blob: 24e387a89a514325b182c7f7fdb0ec3e26200782 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
\documentclass[a4paper,11pt]{article}
\usepackage{manju}
\usepackage{ctib}

\newcommand\exa{\nopagebreak \begin{flushleft}\smallskip \nopagebreak
                \begin{minipage}[t]{6cm}\sloppy}
\newcommand\exb{\end{minipage}\kern 1cm\begin{minipage}[t]{8cm}\sloppy }
\newcommand\exc{\end{minipage}\kern -3cm \smallskip\end{flushleft}}

\title{\mabosoo{manju}\mabosoo{late|h'}\\[0.35cm]
	ManjuTeX 0.2\\[0.35cm]
	A Manju Script Package for \LaTeXe}
\author{Oliver Corff}
\date{April 1st, 2001}
\begin{document}
\maketitle
\begin{abstract}
	Manju\TeX\ is a package offering Manju support for \TeX\ and
	\LaTeXe.  This package is founded on Mon\TeX\ and will
	finally merge with Mon\TeX\ in order to provide all
	Mongolian writings. In contrast to the Mongolian Script
	of early Mon\TeX\ versions, the complete retransliteration
	process which generates Manju writing out of romanized input is
	built on the ligature functionality of \TeX\ and Metafont, thus
	effectively eliminating the need for installing any external
	preprocessor.
\end{abstract}
\tableofcontents

\section{Introduction}

As long as a full-fledged support of all Mongolian-based languages
and writing systems (Mongolian, Manju, Tod, Sibe as well as various
transcription systems for Tibetan, Sanskrit and Chinese, also known
as Galig or Ali Gali) is not available for the \TeX\ and \LaTeXe\
community, the author considered it useful to prepare a stand-alone
Manju package which can be used with \TeX\ and \LaTeXe. The package
comes in two varieties: while \TeX\ users can access the Manju
fonts, \LaTeXe\ users enjoy the additional privilege of being able
to typeset vertical capsules of Manju text. Users of both
communities never have to bother with encoding issues or external
preprocessors. Manju is typed in a fairly standard romanization and
is converted to the presentation form automatically.


\section{Installation\label{Installation}}

Installation of this software package is straightforward:
The installation procedure depends on the nature of the actual
\TeX\ system. The directory tree of e.\,g., teTeX is different
from the emtex tree; hence the source archive \texttt{manjutex.zip}
features the following subdirectories the contents of which has to be
placed into appropriate branches of the \TeX\ installation:
\begin{itemize}
	\item \texttt{mfinput} holds the complete Metafont sources 
		for the Tibetan fonts. The suggested path for emtex
		users is \verb"\emtex\mfinput\manju"; for teTeX users
		\verb"$TEXMF/fonts/source/public/manju" is a suitable
		choice.
	\item \texttt{tfm} holds all necessary font metrics files.
	The suggested path for emtex users is \verb"\emtex\tfm\manju";
	for teTeX users \verb"$TEXMF/fonts/tfm/public/manju"
	is a suitable choice.
	\item \texttt{texinput} holds all style files, font encoding
		definitions etc. which are read by \TeX\ and \LaTeXe.
		The suggested path for emtex users is
		\verb"\emtex\texinput\manju"; for teTeX users
		\verb"$TEXMF/tex/latex/manju" is a suitable choice.
	\item \texttt{doc} contains the documentation (the document
		which you are reading right now). It can be placed
		in \verb"\emtex\doc\manju" (for emtex users) or 
		\verb"$TEXMF/doc/latex/manju" (for teTeX users).
\end{itemize}

It may become necessary to rehash the directory database of the
\TeX\ system. When in doubt, consult your system administrator or
local \TeX\ wizard.
On teTeX systems, the command \texttt{texhash} will perform this service.


\section{User Commands\label{UserCommands}}

Manju\TeX\ provides the common command
\verb|\bth| (as in {\bth bithe} \textit{bithe}) to switch to
Manju mode. A Manju font is selected and the Latin input is
automatically interpreted as transliterated Manju. The
transliteration closely follows Hauer's system and is presented in
the next section.

\subsection{Using \ManjuTeX\ with \TeX}

If you only use \LaTeXe\ then you can safely skip reading this
paragraph.

Near the beginning of your \TeX\ document (or before your first
instance of Manju text) you have to input the Manju macros by saying
\begin{verbatim}
	\input manju
\end{verbatim} 
which will provide a size selection command, \verb*-msize-, and the
font switching command \verb*-\bth-.

A complete Manju \TeX\ document could look like this:

\exa
	This is Manju:\\
	{\bth manju bithe}
\exb
	\begin{verbatim}
	\input manju
	\msize
	This is Manju:\\
	{\bth manju bithe}
	\bye
	\end{verbatim}
\exc

In effect, three different font sizes can be selected using
\verb*-msize- (10~points),
\verb*-msizei- (11~points) and
\verb*-msizeii- (12~points).

The commands to toggle between Manju writing and Computer Modern
are \verb*-\bth- and \verb*-\tenrm-, respectively. Please note that
\verb*-\tenrm- is redefined by \ManjuTeX\ to the effect that the size
selection command overrides the 10~point size of \verb*-\tenrm-%
	\footnote{This `feature' was taken from the Tibetan
		package.}.

\subsection{Using \ManjuTeX\ with \LaTeXe}

\LaTeXe\ users activate the Manju package by saying
\begin{verbatim}
	\usepackage{manju}
\end{verbatim} 
in the preamble of the document. The font selection command is
\verb*-\bth-. The size is set through the NFSS system.

A Manju document could contain the following code snippet:

\exa
	This is Manju:\\
	{\bth manju bithe}
\exb
	\begin{verbatim}
	This is Manju:\\
	{\bth manju bithe}
	\end{verbatim}
\exc

\subsubsection{Vertical Text Capsules}

With PostScript support it becomes possible to typeset vertical
capsules of Manju text. Simply issue the command \verb*-\mabosoo{}-,
include a text argument and see how it works:
\exa
	\mabosoo{manju}\mabosoo{bithe}
	is \textit{manju bithe}.
\exb
	\begin{verbatim}
	\mabosoo{manju}\mabosoo{bithe}
	is \textit{manju bithe}.
	\end{verbatim}
\exc

\section{Character Set and Romanization}
Given by dictionary order, the system provides the following basic
character set:

\subsection{Basic Character Set}
\newcommand{\ManjuEntry}[3]{\mabosoo{#1}& #2 & #3 }
\begin{center}
\begin{tabular}{ccc|ccc|ccc}
Manju&Input&Latin&Manju&Input&Latin&Manju&Input&Latin\\
\hline
\ManjuEntry{a}{a}{a}	& \ManjuEntry{h}{h}{h}	& \ManjuEntry{c}{c}{c}	\\
\ManjuEntry{e}{e}{e}	& \ManjuEntry{b}{b}{b}	& \ManjuEntry{j}{j}{j}	\\
\ManjuEntry{i}{i}{i}	& \ManjuEntry{p}{p}{p}	& \ManjuEntry{y}{y}{y}	\\
\ManjuEntry{o*}{o}{o}	& \ManjuEntry{s}{s}{s}	& \ManjuEntry{k'}{k'}{k'}\\
\ManjuEntry{u*}{u}{u}	& \ManjuEntry{s'}{s'}{\v s}& \ManjuEntry{g'}{g'}{g'}\\
\ManjuEntry{v}{v}{\={u}}& \ManjuEntry{t}{t}{t}	& \ManjuEntry{h'}{h'}{h'}\\
\ManjuEntry{n}{n}{n}	& \ManjuEntry{d}{d}{d}	& \ManjuEntry{r}{r}{r}	\\
\ManjuEntry{k}{k}{k}	& \ManjuEntry{l}{l}{l}	& \ManjuEntry{f}{f}{f}	\\
\ManjuEntry{g}{g}{g}	& \ManjuEntry{m}{m}{m}	& \ManjuEntry{w}{w}{w}	\\
\end{tabular}
\end{center}

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{Extended Character Set}
The following special characters listed in major dictionaries are
provided:
\begin{center}
\begin{tabular}{ccc}
Manju	& Input &Latin\\
\ManjuEntry{sy}{sy}{sy}	\\
\ManjuEntry{cy}{cy}{cy}	\\
\ManjuEntry{j'}{j'}{jy}	\\
\ManjuEntry{dz}{dz}{dz}	\\
\ManjuEntry{tsh}{tsh}{tsh}	\\
\ManjuEntry{tshy}{tshy}{tshy}	\\
\ManjuEntry{zr}{zr}{zr}	\\
\end{tabular}
\end{center}

Please note that due to internal limitations of the retransliteration
engine, \textit{jy} \mabosoo{j'} has to be entered as \texttt{j'}.

\subsection{Tibetan Transliteration Character Set}
Besides these characters, an additional small set of special characters
is provided for rendering Tibetan transliterations as given in the
Pentaglot dictionary:

\begin{center}
\begin{tabular}{ccc}
Manju	& Input &Latin	\\
\ManjuEntry{z}{z}{z}		\\
\ManjuEntry{zh}{zh}{zh}	\\
\ManjuEntry{ts}{ts}{ts}	\\
\ManjuEntry{ng'}{ng'}{ng'}	\\
\ManjuEntry{l'}{l'}{l'}		\\
\ManjuEntry{p'}{p'}{p'}		\\
\ManjuEntry{t'}{t'}{t'}		\\
\end{tabular}
\end{center}

It becomes thus possible to spell out the Tibetan alphabet in
Manju writing, as used in the Pentaglot dictionary for Tibetan
and Uighur transliterations:

\newcommand{\MT}[2]{{\tib #1} \textit{#1} \mabosoo{#2}}

\newcommand{\ManjuTibetan}[8]{%
	\tib #1 & \mabosoo{#2}&
		\tib #3 & \mabosoo{#4}&
			\tib #5 & \mabosoo{#6}&
				\tib #7 & \mabosoo{#8}\\
	\tt #1 & \tt #2 &
		\tt #3 & \tt #4 &
			\tt #5 & \tt #6 &
				\tt #7 & \tt #8\\
		}

\begin{center}
\begin{tabular}{cc|cc|cc|cc}
\ManjuTibetan{ka}{g'a}		{kha}{k'a}	{ga}{ga}	{nga}{ng'a}
\hline
\ManjuTibetan{ca}{jiya}		{cha}{cia}	{ja}{ja}	{nya}{niya}
\hline
\ManjuTibetan{ta}{t'a}		{tha}{ta}	{da}{da}	{na}{na}
\hline
\ManjuTibetan{pa}{ba}		{pha}{pa}	{ba}{wa}	{ma}{ma}
\hline
\ManjuTibetan{tsa}{tsa}		{tsha}{tsha}	{dza}{dza}	{wa}{wa}
\hline
\ManjuTibetan{zha}{zha}		{za}{za}	{'}{ea}		{ya}{ya}
\hline
\ManjuTibetan{ra}{ra}		{la}{la}	{sha}{s'a}	{sa}{sa}
\hline
\ManjuTibetan{ha}{h|a}		{a}{a}		{}{}		{}{}
\end{tabular}
\end{center}

Besides these basic representations, certain deviations exist:
\begin{enumerate}
	\item \MT{nga}{ng'a} is used for Tibetan initials and subscripts;
		finals are expressed as \mabosoo{*ng}
	\item While \MT{ha}{h|a} is used for Tibetan initial
		{\tib ha},
		a different form is taken for subscripted
		\textit{ha}, as in \MT{lha}{l'|a}.
\end{enumerate}

\subsection{Special Characters}

Manju\TeX\ and its progenitor Mon\TeX\ share the complete
set of numbers and punctuation marks as well as a few special
characters used for influencing the presentation of the writing.

Provided a word should end with a non-final glyph shape then the Environment
Marker \mabosoo{**} is used which is entered as an asterisque
\verb-*-. This is helpful for writing abbreviated words or marking
non-final vowels, like \mabosoo{o*} which is entered as \verb-o*-.

Whenever the plethora of diacritics used in Manju writing causes
ugly clashes between adjacent letters, then the `backbone' (mong.
\textit{nirugu}), entered as \verb'|', can be used to stretch the
distance between clashing letter elements, like in \mabosoo{h|a}
which should be entered \verb-h|a- rather than \verb-ha- resulting
in \mabosoo{ha}.

\section{Outlook and Desiderata}

Unfortunately, some code positions in the Metafont sources of
\ManjuTeX\ haven't
been frozen yet which implies that documents containing Manju text
should be recompiled once a new version of this software is issued.

In addition, the author is not happy yet with some of the
interaction performed by certain glyph combinations. This will have
to be refined definitely!

With $\Omega$mega lurking around, \ManjuTeX\ should actually be obsolete
work. A unified encoding comprising all Mongolian writings has been
integrated into Unicode 3.0 and ISO 10646. The author needed a quick
solution for ongoing lexicographical work (the Pentaglot database,
that is) and will merge \ManjuTeX\ with the existing Mon\TeX\ system
later. At that point, there will also be full-featured $\Omega$mega
support.

Anyway, whatever the mistakes and the shortcomings are that have 
crept into this Manju system, I can only kindly ask you to blame me.

\vspace{1cm}
\hfill\parbox{4cm}{\it Now go forth and create beautiful Manju text!\\
			Oliver Corff, Shenyang, April 1st, 2001}
\end{document}