← Back to branch summary

~ubuntu-branches/ubuntu/edgy/tipa/edgy

« back to all changes in this revision

Viewing changes to doc/vowel.tex

  • Committer: Bazaar Package Importer
  • Author(s): Rafael Laboissiere
  • Date: 2003-12-11 10:50:58 UTC
  • Revision ID: james.westby@ubuntu.com-20031211105058-vq8ttydhah3hdzq1
Tags: upstream-1.2
Import upstream version 1.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/vowel.tex
 
1
% vowel.tex
 
2
% Copyright 2002 FUKUI Rei
 
3
%
 
4
% This program may be distributed and/or modified under the
 
5
% conditions of the LaTeX Project Public License, either version 1.2
 
6
% of this license or (at your option) any later version.
 
7
% The latest version of this license is in
 
8
%   http://www.latex-project.org/lppl.txt
 
9
% and version 1.2 or later is part of all distributions of LaTeX 
 
10
% version 1999/12/01 or later.
 
11
%
 
12
% This program consists of all files listed in Manifest.txt.
 
13
%
 
14
 
 
15
\documentclass[a4paper]{article}
 
16
\usepackage{tipa}
 
17
\usepackage{vowel}
 
18
 
 
19
\newcommand{\vowelbox}{\raise1ex\hbox to 2.5cm}
 
20
\newenvironment{texsrc}{\begin{minipage}[t]{7cm}}{\end{minipage}}
 
21
 
 
22
\title{Vowel package manual}
 
23
\author{FUKUI Rei
 
24
  \thanks{{\tt fkr@tooyoo.l.u-tokyo.ac.jp}}\\
 
25
  \textit{Graduate School of Humanities and Sociology}\\
 
26
  \textit{University of Tokyo}}
 
27
\date{28 October 2001}
 
28
 
 
29
\begin{document}
 
30
\maketitle
 
31
 
 
32
\section{Drawing vowel diagrams}
 
33
 
 
34
\subsection{The {\tt vowel} environment}
 
35
 
 
36
The general format of the {\tt vowel} environment is as follows.
 
37
 
 
38
\medskip
 
39
 
 
40
\verb|\begin{vowel}[|{\it option\/}(,{\it option},...)\verb|]|
 
41
 
 
42
{\it commands for inputting vowels}
 
43
 
 
44
\verb|\end{vowel}|
 
45
 
 
46
\medskip
 
47
 
 
48
Options and commands for inputting vowels are explained below.
 
49
 
 
50
\subsection{The shapes of the diagram supported}
 
51
 
 
52
The default shape of the vowel diagram is the one used in the recent
 
53
IPA chart, as shown below.
 
54
 
 
55
\begin{center}
 
56
\begin{tabular}{ll}
 
57
  \begin{vowel}[t]
 
58
  \end{vowel} &
 
59
  \begin{minipage}[t]{5.5cm}
 
60
    \verb|\begin{vowel}|\\
 
61
    \verb|\end{vowel}|
 
62
  \end{minipage}
 
63
\end{tabular}
 
64
\end{center}
 
65
 
 
66
In this diagram, the bottom, back, and top sides are in the proportion
 
67
2:3:4, as was prescribed by Daniel Jones.
 
68
 
 
69
In order to change the shape of an diagram, specify the following
 
70
options.
 
71
 
 
72
\begin{itemize}\itemsep0pt
 
73
\item \texttt{plain}, \texttt{simple}, \texttt{standard},
 
74
  \texttt{ipanew} (=default)
 
75
\item \texttt{rectangle} \quad Draws a rectangular diagram.
 
76
\item \texttt{triangle} \quad Draws a triangular diagram.
 
77
\item \texttt{three} \quad Distinguishes only three levels of vowel
 
78
  height.
 
79
\end{itemize}
 
80
 
 
81
The first group of options are mutually exclusive, i.e., only one them
 
82
can be selected at a time.
 
83
 
 
84
\begin{center}
 
85
\begin{tabular}{ll}
 
86
  \begin{minipage}[t]{5.5cm}{\small
 
87
    \verb|\begin{vowel}|\\
 
88
    \verb|\end{vowel}|\\
 
89
    \emph{or}\\
 
90
    \verb|\begin{vowel}[ipanew]|\\
 
91
    \verb|\end{vowel}|}
 
92
  \end{minipage} &
 
93
  \begin{minipage}[t]{5.5cm}{\small
 
94
    \verb|\begin{vowel}[plain]|\\
 
95
    \verb|\end{vowel}|}
 
96
  \end{minipage} \\
 
97
  \begin{vowel}[t]\end{vowel} &
 
98
  \begin{vowel}[t,plain]\end{vowel}
 
99
\end{tabular}
 
100
 
 
101
\begin{tabular}{ll}
 
102
  \begin{minipage}[t]{5.5cm}{\small
 
103
    \verb|\begin{vowel}[simple]|\\
 
104
    \verb|\end{vowel}|}
 
105
  \end{minipage} &
 
106
  \begin{minipage}[t]{5.5cm}{\small
 
107
    \verb|\begin{vowel}[standard]|\\
 
108
    \verb|\end{vowel}|}
 
109
  \end{minipage} \\
 
110
  \begin{vowel}[t,simple]\end{vowel} &
 
111
  \begin{vowel}[t,standard]\end{vowel}
 
112
\end{tabular}
 
113
\end{center}
 
114
 
 
115
Among the other options, \texttt{rectangle}
 
116
and \texttt{triangle} are mutually exclusive but each can be combined
 
117
with one of the options \texttt{plain}, \texttt{simple} or
 
118
\texttt{ipanew}. And the last option \texttt{three} can be combined
 
119
with one of the options \texttt{plain}, \texttt{simple} or
 
120
\texttt{ipanew}, and with one of the options \texttt{rectangle}
 
121
and \texttt{triangle}.
 
122
 
 
123
\begin{center}
 
124
\begin{tabular}{ll}
 
125
  \begin{minipage}[t]{5.5cm}{\small
 
126
    \verb|\begin{vowel}[rectangle]|\\
 
127
    \verb|\end{vowel}|}
 
128
  \end{minipage} &
 
129
  \begin{minipage}[t]{5.5cm}{\small
 
130
    \verb|\begin{vowel}[plain,rectangle]|\\
 
131
    \verb|\end{vowel}|}
 
132
  \end{minipage} \\
 
133
  \begin{vowel}[t,rectangle]\end{vowel} &
 
134
  \begin{vowel}[t,plain,rectangle]\end{vowel}
 
135
\end{tabular}
 
136
 
 
137
\begin{tabular}{ll}
 
138
  \begin{minipage}[t]{5.5cm}{\small
 
139
    \verb|\begin{vowel}[simple,rectangle]|\\
 
140
    \verb|\end{vowel}|}
 
141
  \end{minipage} &
 
142
  \begin{minipage}[t]{5.5cm}{\small
 
143
    \verb|\begin{vowel}[triangle]|\\
 
144
    \verb|\end{vowel}|}
 
145
  \end{minipage} \\
 
146
  \begin{vowel}[t,simple,rectangle]\end{vowel} &
 
147
  \begin{vowel}[t,triangle]\end{vowel}
 
148
\end{tabular}
 
149
 
 
150
\begin{tabular}{ll}
 
151
  \begin{minipage}[t]{5.5cm}{\small
 
152
    \verb|\begin{vowel}[plain,triangle]|\\
 
153
    \verb|\end{vowel}|}
 
154
  \end{minipage} &
 
155
  \begin{minipage}[t]{5.5cm}{\small
 
156
    \verb|\begin{vowel}[simple,triangle]|\\
 
157
    \verb|\end{vowel}|}
 
158
  \end{minipage} \\
 
159
  \begin{vowel}[t,plain,triangle]\end{vowel} &
 
160
  \begin{vowel}[t,simple,triangle]\end{vowel}
 
161
\end{tabular}
 
162
 
 
163
\begin{tabular}{ll}
 
164
  \begin{minipage}[t]{5cm}{\small
 
165
    \verb|\begin{vowel}[simple,three]|\\
 
166
    \verb|\end{vowel}|}
 
167
  \end{minipage} &
 
168
  \begin{minipage}[t]{6cm}{\small
 
169
    \verb|\begin{vowel}[simple,triangle,three]|\\
 
170
    \verb|\end{vowel}|}
 
171
  \end{minipage} \\
 
172
  \begin{vowel}[t,simple,three]\end{vowel} &
 
173
  \hspace{.5cm}\begin{vowel}[t,simple,triangle,three]\end{vowel}
 
174
\end{tabular}
 
175
\end{center}
 
176
 
 
177
 
 
178
\subsection{Placing vowels on a diagram}
 
179
 
 
180
The following commands are prepared in order to place vowels in the
 
181
vowel diagram.
 
182
 
 
183
\begin{itemize}
 
184
  \item \verb+\putcvowel[l|r]{symbol}{+\emph{cardinal position}\verb+}+
 
185
  \item \verb+\putvowel[l|r]{symbol}{x}{y}+
 
186
\end{itemize}
 
187
 
 
188
The former command is used to place a vowel on a {\it cardinal
 
189
position}, and the latter is used to place a vowel on a point specified
 
190
by {\it x} and {\it y}. In each case, an optional argument \verb|[l]|
 
191
or \verb|[r]| can be given, which specifies to put a symbol (usually a
 
192
dot) that indicates the point and a vowel is placed at the left or
 
193
right of the symbol.
 
194
 
 
195
The next table shows a diagram indicating the cardinal positions and
 
196
an example of a vowel diagram containing the \verb|\putcvowel| commands.
 
197
 
 
198
\begin{center}
 
199
\begin{tabular}{lll}
 
200
  \begin{vowel}[t]
 
201
    \putcvowel{\footnotesize 1}{1}\putcvowel{\footnotesize 2}{2}
 
202
    \putcvowel{\footnotesize 3}{3}\putcvowel{\footnotesize 4}{4}
 
203
    \putcvowel{\footnotesize 5}{5}\putcvowel{\footnotesize 6}{6}
 
204
    \putcvowel{\footnotesize 7}{7}\putcvowel{\footnotesize 8}{8}
 
205
    \putcvowel{\footnotesize 9}{9}\putcvowel{\footnotesize 10}{10}
 
206
    \putcvowel{\footnotesize 11}{11}\putcvowel{\footnotesize 12}{12}
 
207
    \putcvowel{\footnotesize 13}{13}\putcvowel{\footnotesize 14}{14}
 
208
    \putcvowel{\footnotesize 15}{15}\putcvowel{\footnotesize 16}{16}
 
209
  \end{vowel} &
 
210
  \begin{vowel}[t]
 
211
    \putcvowel{i}{1}\putcvowel{e}{2}
 
212
    \putcvowel{\textipa{E}}{3}\putcvowel{a}{4}
 
213
    \putcvowel{\textipa{6}}{5}\putcvowel{\textipa{O}}{6}
 
214
    \putcvowel{o}{7}\putcvowel{u}{8}
 
215
    \putcvowel{\textipa{1}}{9}\putcvowel{\textipa{9}}{10}
 
216
    \putcvowel{\textipa{@}}{11}\putcvowel{\textipa{3}}{12}
 
217
    \putcvowel{\textipa{I}}{13}\putcvowel{\textipa{U}}{14}
 
218
    \putcvowel{\textturna}{15}\putcvowel{\ae}{16}
 
219
  \end{vowel} &
 
220
    \begin{minipage}[t]{4cm}
 
221
{\footnotesize\begin{verbatim}
 
222
  \begin{vowel}
 
223
    \putcvowel{i}{1}
 
224
    \putcvowel{e}{2}
 
225
    \putcvowel{\textipa{E}}{3}
 
226
    \putcvowel{a}{4}
 
227
    ...
 
228
  \end{vowel}
 
229
\end{verbatim}}
 
230
    \end{minipage}
 
231
\end{tabular}
 
232
\end{center}
 
233
 
 
234
The cardinal positions from 1 through 8 are the same with the numbers
 
235
of cardinal vowels determined by Daniel Jones. And the remaining
 
236
numbers (from 9 through 16) are extended cardinal positions that are
 
237
used to indicate the positions of all the remaining vowels that appear 
 
238
in the recent IPA chart, having no relation to the Jonesian system of
 
239
cardinal vowels.
 
240
 
 
241
In the case of the second form of the command. i.e., \verb+\putvowel+,
 
242
the origin is the upper left corner. And it is convenient to use the
 
243
basic units, \verb|\vowelhunit| and \verb|\vowelvunit| in specifying a 
 
244
point in the $x$--$y$ coordinate. the bottom right corner is indicated 
 
245
by a point (\verb|4\vowelhunit|, \verb|3\vowelhunit|). Thus:
 
246
 
 
247
\begin{quote}
 
248
\verb+\putvowel{i}{0pt}{0pt}+ is equivalent to
 
249
\verb+\putcvowel{i}{1}+.
 
250
\end{quote}
 
251
 
 
252
and
 
253
 
 
254
\begin{quote}
 
255
\verb+\putvowel{\textscripta}{4\vowelhunit}{3\vowelvunit}+ is
 
256
equivalent to \verb+\putcvowel{\textscripta}{5}+.
 
257
\end{quote}
 
258
 
 
259
\subsection{Changing the size of a diagram}
 
260
 
 
261
The usual commands for changing the size of text fonts such as
 
262
\verb|\small|, \verb|\large|, \verb|\Large|, etc.\ can be used to
 
263
change the size of a vowel diagram. 
 
264
 
 
265
\begin{center}
 
266
\begin{tabular}{lll}
 
267
\begin{minipage}{3.2cm}
 
268
{\small\begin{verbatim}
 
269
{\small
 
270
\begin{vowel}
 
271
\putcvowel{i}{1}
 
272
...
 
273
\end{vowel}}
 
274
\end{verbatim}}
 
275
\end{minipage} &
 
276
\begin{minipage}{3.2cm}
 
277
{\small\begin{verbatim}
 
278
\begin{vowel}
 
279
\putcvowel{i}{1}
 
280
...
 
281
\end{vowel}
 
282
\end{verbatim}}
 
283
\end{minipage} &
 
284
\begin{minipage}{3.2cm}
 
285
{\small\begin{verbatim}
 
286
{\large
 
287
\begin{vowel}
 
288
\putcvowel{i}{1}
 
289
...
 
290
\end{vowel}}
 
291
\end{verbatim}}
 
292
\end{minipage} \\
 
293
  {\small \begin{vowel}
 
294
    \putcvowel{i}{1}\putcvowel{e}{2}
 
295
    \putcvowel{\textepsilon}{3}\putcvowel{a}{4}
 
296
    \putcvowel{\textscripta}{5}\putcvowel{\textopeno}{6}
 
297
    \putcvowel{o}{7}\putcvowel{u}{8}
 
298
  \end{vowel}} &
 
299
  \begin{vowel}
 
300
    \putcvowel{i}{1}\putcvowel{e}{2}
 
301
    \putcvowel{\textepsilon}{3}\putcvowel{a}{4}
 
302
    \putcvowel{\textscripta}{5}\putcvowel{\textopeno}{6}
 
303
    \putcvowel{o}{7}\putcvowel{u}{8}
 
304
  \end{vowel} &
 
305
    {\large \begin{vowel}
 
306
    \putcvowel{i}{1}\putcvowel{e}{2}
 
307
    \putcvowel{\textepsilon}{3}\putcvowel{a}{4}
 
308
    \putcvowel{\textscripta}{5}\putcvowel{\textopeno}{6}
 
309
    \putcvowel{o}{7}\putcvowel{u}{8}
 
310
  \end{vowel}}
 
311
\end{tabular}
 
312
\end{center}
 
313
 
 
314
It is also possible to change the size of a vowel symbol and the
 
315
size of a diagram independently. 
 
316
 
 
317
In order to change only the size of a vowel symbol, use the commands
 
318
such as \verb|\small|, \verb|\large|, etc.\ within the
 
319
\verb|\putcvowel| command.
 
320
 
 
321
And in order to change only the size of a diagram, give appropriate
 
322
values to the parameters \verb|\vowelhunit| and \verb|\vowelvunit|.
 
323
\verb|\vowelhunit| stands for the horizontal unit length, and
 
324
\verb|\vowelvunit| the vertical unit length.  By default both
 
325
\verb|\vowelhunit| and \verb|\vowelvunit| are equal to 2em. And if
 
326
only the former is modified by an user, the latter is automatically
 
327
adjusted to the same length.
 
328
 
 
329
\begin{quote}
 
330
\begin{tabular}{ll}
 
331
  \vowelbox{\hss
 
332
    \begin{vowel}[t]
 
333
      \putcvowel{i}{1}
 
334
      \putcvowel{\large e}{2}
 
335
      \putcvowel{\Large\textipa{E}}{3}
 
336
      \putcvowel{\huge a}{4}
 
337
    \end{vowel}} &
 
338
\begin{texsrc}
 
339
\begin{verbatim}
 
340
\begin{vowel}
 
341
\putcvowel{i}{1}
 
342
\putcvowel{\large e}{2}
 
343
\putcvowel{\Large\textipa{E}}{3}
 
344
\putcvowel{\huge a}{4}
 
345
\end{vowel}
 
346
\end{verbatim}
 
347
\end{texsrc}
 
348
\end{tabular}
 
349
\end{quote}
 
350
 
 
351
\begin{quote}
 
352
\begin{tabular}{ll}
 
353
  \vowelbox{\hss
 
354
    {\vowelhunit=1em
 
355
      \begin{vowel}[t]
 
356
        \putcvowel{i}{1}
 
357
        \putcvowel{e}{2}
 
358
        \putcvowel{\textipa{E}}{3}
 
359
        \putcvowel{a}{4}
 
360
      \end{vowel}}} &
 
361
\begin{texsrc}
 
362
\begin{verbatim}
 
363
{\vowelhunit=1em
 
364
\begin{vowel}
 
365
\putcvowel{i}{1}
 
366
...
 
367
\end{vowel}}
 
368
\end{verbatim}
 
369
\end{texsrc}
 
370
\end{tabular}
 
371
\end{quote}
 
372
 
 
373
\begin{quote}
 
374
\begin{tabular}{ll}
 
375
  \vowelbox{\hss
 
376
    {\vowelvunit=2.31em
 
377
      \begin{vowel}[t]
 
378
        \putcvowel{i}{1}
 
379
        \putcvowel{e}{2}
 
380
        \putcvowel{\textipa{E}}{3}
 
381
        \putcvowel{a}{4}
 
382
      \end{vowel}}} &
 
383
\begin{texsrc}
 
384
\begin{verbatim}
 
385
{\vowelvunit=2.31em
 
386
\begin{vowel}
 
387
\putcvowel{i}{1}
 
388
...
 
389
\end{vowel}}
 
390
\end{verbatim}
 
391
\end{texsrc}
 
392
\end{tabular}
 
393
\end{quote}
 
394
 
 
395
%In the later works of Daniel Jones, it is reported that he had used
 
396
%such a diagram that the angle of the upper-left corner is 60
 
397
%degrees. In this case, the bottom, right, and top sides are in the
 
398
%proportion of 2:\(\sqrt{12}\):4. %See Ashby.
 
399
 
 
400
\newpage
 
401
\section{Example}
 
402
 
 
403
The next example shows the IPA vowel chart (updated 1996).
 
404
 
 
405
\begin{center}
 
406
{\Large
 
407
\begin{vowel}
 
408
%    \putcvowel[l]{i}{1}
 
409
    \putvowel[l]{i}{0pt}{0pt}
 
410
    \putcvowel[r]{y}{1}
 
411
    \putcvowel[l]{e}{2}
 
412
    \putcvowel[r]{\o}{2}
 
413
    \putcvowel[l]{\textepsilon}{3}
 
414
    \putcvowel[r]{\oe}{3}
 
415
    \putcvowel[l]{a}{4}
 
416
    \putcvowel[r]{\textscoelig}{4}
 
417
    \putcvowel[l]{\textscripta}{5}
 
418
    \putcvowel[r]{\textturnscripta}{5}
 
419
    \putcvowel[l]{\textturnv}{6}
 
420
    \putcvowel[r]{\textopeno}{6}
 
421
    \putcvowel[l]{\textramshorns}{7}
 
422
    \putcvowel[r]{o}{7}
 
423
    \putcvowel[l]{\textturnm}{8}
 
424
    \putcvowel[r]{u}{8}
 
425
    \putcvowel[l]{\textbari}{9}
 
426
    \putcvowel[r]{\textbaru}{9}
 
427
    \putcvowel[l]{\textreve}{10}
 
428
    \putcvowel[r]{\textbaro}{10}
 
429
    \putcvowel{\textschwa}{11}
 
430
    \putcvowel[l]{\textrevepsilon}{12}
 
431
    \putcvowel[r]{\textcloserevepsilon}{12}
 
432
    \putcvowel{\textsci\ \textscy}{13}
 
433
    \putcvowel{\textupsilon}{14}
 
434
    \putcvowel{\textturna}{15}
 
435
    \putcvowel{\ae}{16}
 
436
\end{vowel}
 
437
}
 
438
 
 
439
\bigskip
 
440
\begin{texsrc}
 
441
\begin{verbatim}
 
442
\begin{vowel}
 
443
    \putcvowel[l]{i}{1}
 
444
    \putcvowel[r]{y}{1}
 
445
    \putcvowel[l]{e}{2}
 
446
    \putcvowel[r]{\o}{2}
 
447
    \putcvowel[l]{\textepsilon}{3}
 
448
    \putcvowel[r]{\oe}{3}
 
449
    \putcvowel[l]{a}{4}
 
450
    \putcvowel[r]{\textscoelig}{4}
 
451
    \putcvowel[l]{\textscripta}{5}
 
452
    \putcvowel[r]{\textturnscripta}{5}
 
453
    \putcvowel[l]{\textturnv}{6}
 
454
    \putcvowel[r]{\textopeno}{6}
 
455
    \putcvowel[l]{\textramshorns}{7}
 
456
    \putcvowel[r]{o}{7}
 
457
    \putcvowel[l]{\textturnm}{8}
 
458
    \putcvowel[r]{u}{8}
 
459
    \putcvowel[l]{\textbari}{9}
 
460
    \putcvowel[r]{\textbaru}{9}
 
461
    \putcvowel[l]{\textreve}{10}
 
462
    \putcvowel[r]{\textbaro}{10}
 
463
    \putcvowel{\textschwa}{11}
 
464
    \putcvowel[l]{\textrevepsilon}{12}
 
465
    \putcvowel[r]{\textcloserevepsilon}{12}
 
466
    \putcvowel{\textsci\ \textscy}{13}
 
467
    \putcvowel{\textupsilon}{14}
 
468
    \putcvowel{\textturna}{15}
 
469
    \putcvowel{\ae}{16}
 
470
\end{vowel}
 
471
\end{verbatim}
 
472
\end{texsrc}
 
473
\end{center}
 
474
 
 
475
\end{document}