summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/diagnose/doc/mls-diag.tex
blob: e40c27f6caecdc2b81422030972327a6a33a82ad (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
\documentclass[a4paper,11pt]{article}
\usepackage{diagnose}

\title{Mon\TeX\ Diagnostics:\\
	System Compatibility Report}
\author{Oliver Corff}

\begin{document}
\maketitle
\begin{abstract}
	Running \LaTeXe\ on this article will give information
	on the status of system software necessary for exploiting
	advanced features of Mon\TeX: RL line orientation, vertical
	text, extended Cyrillic characters for Kazakh and the
	text-mode gamma.
\end{abstract}

\section{Introduction}

Mon\TeX\ relies on numerous functions supplied by the existing
\LaTeXe\ installation for offering advanced services. Before installing
Mon\TeX\ it might be interesting to find out which support is offered
by the system and which additional packages should be supplied in order
to raise Mon\TeX\ to its complete functionality.

This document will tell you which functionality is really available on
your system and
what you should do in case the desired support is missing. Whenever the
text informs you that something from CTAN (the Comprehensive TeX Archive
Network) should be installed then you have the choice to obtain the
required software from CTAN via the Internet or from a CD-ROM with the 
contents of the CTAN site. In short, this will usually be the same source
from which you obtained Mon\TeX.


\section{RL Line Orientation\label{RLSupport}}

If you want to be able to print complete paragraphs of Uighur Mongolian 
texts, and not limit yourself to individual words and phrases, then you
will most certainly require the correct writing direction for Uighur 
Mongolian which starts at the right end of line rather than the left end,
as supplied by Implementation Levels III and IV of Mon\TeX.
Apart from its vertical orientation, Uighur Mongolian is a RL writing
much like Arab and Hebrew. The RL mechanism is provided by modern
\LaTeXe\ installations.

\TokenDiagnostics%
	{\TeXXeTstate}				% Token tested for
	{RLSupportAvailable}			% Associated counter
	{RL Support Available!}			% Yes message
	{RL Support Not Available!}		% No! message

\textbf{Your system status}:
\ifnum\theRLSupportAvailable=1
	Your system is up to date and provides support for RL writings.
	No further action is required.
\else
	During this \LaTeXe\ run, your system did not reveal that it is
	capable of typesetting RL writings correctly.
	
	\textbf{Action required}:
	Please make sure
	\marginpar{\Huge!!!}
	you started \texttt{elatex} instead of \texttt{latex} for calling
	e-\LaTeXe. If this message persists then you should install a
	recent \TeX\ distribution from CTAN.
\fi


\section{Vertical Text\label{VerticalText}}

If you want to mix horizontal and vertical text on one page your
system needs PostScript support. This implies that your \TeX\ 
installation can handle insertions of PostScript commands in
documents (this is done automatically without your interaction);
it does not imply that you can print the results on your printer
if your printing equipment is not PostScript-compatible.

\PackageDiagnostics%
	{rotating.sty}				% Package tested for
	{PostScriptAvailable}			% Associated counter
	{PostScript Support Available!}		% Yes message
	{PostScript Support Not Available!}	% No! message
	
\textbf{Your system status}:
\ifnum\thePostScriptAvailable=1
	Your \TeX\ installation can handle vertical text; if your
	system does not display or print vertical text properly
	then you should check whether you do have a PostScript
	printer or interpreter like GhostScript and GhostView.
\else
	Your \TeX\ installation cannot handle vertical text.

	\textbf{Action required}:
	You should either install a \TeX\ system with pre-configured
	\marginpar{\Huge!!!}
	PostScript support or should install PostScript support
	from CTAN.
\fi
%

\section{Uighur Mongolian Text Pages}

\textbf{Your system status}:
\ifnum\theRLSupportAvailable=0
	Since your system does not offer RL support (see above)
	%\ref{RLSupport})
	this section is meaningless and should be skipped.
\else
	If you want to put Uighur text in vertical pages which
	show the proper orientation without physically rotating
	the paper they are printed on (like in books with a
	mixture of Uighur Mongolian and Modern Mongolian articles)
	you must make sure that your installation has so-called
	landscape orientation support.

	\PackageDiagnostics%
		{lscape.sty}				% Package tested for
		{LandscapeAvailable}			% Associated counter
		{Mongol Bicig Page Support Available!}	% Yes message
		{Mongol Bicig Page Support Not Available!}% No! message

	\ifnum\theLandscapeAvailable=1
		Your system has landscape orientation support and
		does not require any action.
	\else

		\textbf{Action required}:
		You should install landscape orientation support
		(usually this is done together with support for
		vertical text material, see above \ref{VerticalText}).
	\fi
\fi


\section{Extended Cyrillic Support}

Beyond the basic Cyrillic support which is provided by Mon\TeX\ for
writing Modern Xalx Mongolian, Buryat and last but not least, Russian,
Kazakh requires additional Cyrillic characters which are not supplied
by Mon\TeX.

\PackageDiagnostics%
	{x2enc.def}				% Package tested for
	{LHCyrillicAvailable}			% Associated counter
	{Cyrillic Support for Kazakh available!}% Yes message
	{Cyrillic Support for Kazakh Not Available!}% No! message

\textbf{Your system status}:
\ifnum\theLHCyrillicAvailable=1
	Since your installation offers the full range of extended
	Cyrillic characters, it is possible to write Kazakh on your 
	system. No further measures are required.
\else
	Your installation does not offer the extended Cyrillic character
	set necessary for writing Kazakh. You should install the LH
	Cyrillic package from CTAN. Even without this support, your
	Mon\TeX\ package as such is fully functional.
\fi

\section{Gamma Support}

The Greek gamma $\gamma$ is used in transliterations for Uighur 
Mongolian Script. Without support of Modern Greek fonts, only
the slim, italic $\gamma$ used in mathematics is available.
If you want to match its typeface with all Latin and Cyrillic
letters used in Mon\TeX\ then you should make sure the Modern
Greek fonts are installed.
%
\PackageDiagnostics%
	{lgrenc.def}				% Package tested for
	{GreekAvailable}			% Associated counter
	{Greek Support for Gammas available!}% Yes message
	{Greek Support for Gammas Not Available!}% No! message

\textbf{Your system status}:
\ifnum\theGreekAvailable=1
	On this system, the Modern Greek fonts \textit{are} installed.
	There is no further action necessary.
\else
	Your system does not feature the Modern Greek fonts.

	\textbf{Action required}:
	If you use transliterations extensively and need a matching
	typeface for the $\gamma$ then you should get the Modern
	Greek fonts from CTAN and install them now.
\fi
\end{document}