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
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>eSpeak: Pronunciation Dictionaries</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body>
<A href="docindex.html">Back</A>
<hr>
<h2>4. TEXT TO PHONEME TRANSLATION</h2>
<hr>
<h3>4.1 Translation Files</h3>
There is a separate set of pronunciation files for each language, their names starting with the language name.
<p>
There are two separate methods for translating words into phonemes:
<ul>
<li>Pronunciation Rules. These are an attempt to define the pronunciation rules for the language. The source file is:<br>
<strong><em><language>_rules</em></strong> (eg. en_rules)<br>
<p>
<li>
Lookup Dictionary. A list of individual words and their pronunciations and/or various other properties. The source files are:<br>
<strong><em><language>_list</em></strong> (eg. en_list) and optionally <strong><em><language>_extra</em></strong> <br>
</ul>
These two files are compiled into the file
<strong><em><language>_dict</em></strong> in the espeak-data directory (eg. espeak-data/en_dict)
<p> <hr>
<h3>4.2 Phoneme names</h3>
Each of the language's phonemes is represented by a mnemonic of 1, 2, 3, or 4 characters. Together with a number of utility codes (eg. stress marks and pauses), these are defined in the phoneme data file (see *spec not yet available*).
<p>
The utility 'phonemes' are:
<ul><table>
<tbody align="left">
<tr>
<td><strong>' </strong></td>
<td>primary stress</td>
</tr>
<tr>
<td><strong>, </strong></td>
<td>secondary stress</td>
</tr>
<tr>
<td><strong>% </strong></td>
<td>unstressed syllable</td>
</tr>
<tr>
<td><strong>= </strong></td>
<td>put the primary stress on the preceding syllable</td>
</tr>
<tr>
<td><strong>_:</strong></td>
<td>short pause</td>
</tr>
<tr>
<td><strong>_</strong></td>
<td>a shorter pause</td>
</tr>
<tr>
<td><strong>|| </strong></td>
<td>indicates a word boundary within a phoneme string</td>
</tr>
<tr>
<td><strong>| </strong></td>
<td>can be used to separate two adjacent characters, to prevent them from being considered as a multi-character phoneme mnemonic</td>
</tr>
</tbody>
</table>
</ul>
It is not necessary to specify the stress of every syllable. Stress markers are only needed in order to change the effect of the language's default stress rule.
<p>
The phonemes which are used to represent a language's sounds are based loosely on the Kirshenbaum ascii character representation of the International Phonetic Alphabet <a href="http://www.kirshenbaum.net/IPA/ascii-ipa.pdf">www.kirshenbaum.net/IPA/ascii-ipa.pdf</a>
<p> <hr>
<h3>4.3 Pronunciation Rules</h3>
The rules in the <strong><em><language>_rules</em></strong> file specify the phonemes which are used to pronounce each letter, or sequence of letters. Some rules only apply when the letter or letters are preceded by, or followed by, other specified letters.
<p>
To find the pronunciation of a word, the rules are searched and any which match the letters at the in the word are given a score depending on how many letters are matched. The pronunciation from the best matching rule is chosen. The pointer into the source word is then advanced past those letters which have been matched and the process is repeated until all the letters of the word have been processed.
<p>
<h4>4.3.1 Rule Groups</h4>
The rules are organized in groups, each starting with a ".group" line:
<ul><dl>
<dt><strong>.group <character></strong><br><dd>
A group for each letter or character.
<p>
<dt><strong>.group <2 characters></strong><br><dd>
Optional groups for some common 2 letter combinations. This is only needed, for efficiency, in cases where there are many rules for a particular letter. They would not be needed for a language which has regular spelling rules. The first character can only be an ascii character (less than 0x80).
<p>
<dt><strong>.group</strong><br><dd>
A group for other characters which don't have their own group.
<p>
<dt><strong>.L<nn></strong><br><dd>
Defines a group of letter sequences, any of which can match with <strong>Lnn</strong> in a <strong>pre</strong> or <strong>post</strong> rule (see below). <strong>nn</strong> is a 2 digit decimal number in the range 01 to 25. eg:<p>
<code>.L01 b bl br pl pr</code>
<p>
<dt><strong>.replace</strong><br><dd>
See section 4.7 Character Substitution, below.
</dl>
</ul>When matching a word, firstly the 2-letter group for the two letters at the current position in the word (if such a group exists) is searched, and then the single-letter group. The highest scoring rule in either of those two groups is used.
<h4>4.3.2 Rules</h4>
Each rule is on separate line, and has the syntax:
<ul>
[<pre>)] <match> [(<post>] <phoneme string>
</ul>
eg.
<ul><pre>.group o
o 0 // "o" is pronounced as [0]
oo u: // but "oo" is pronounced as [u:]
b) oo (k U
</pre>
</ul> "oo" is pronounced as [u:], but when also preceded by "b" and followed by "k", it is pronounced [U].
<p>
In the case of a single-letter group, the first character of <match> much be the group letter. In the case of a 2-letter group, the first two characters of <match> must be the group letters. The second and third rules above may be in either .group o or .group oo
<p>
Alphabetic characters in the <pre>, <match>, and <post> parts must be lower case, and matching is case-insensitive. Some upper case letters are used in <pre> and <post> with special meanings.
<p>
<h4>4.3.3 Special characters in <phoneme string>:</h4>
<ul><table>
<tbody>
<tr>
<td><strong>_^_<language code> </strong></td>
<td>Translate using a different language.</td>
</tr>
</tbody>
</table>
If this rule is selected when translating a word, then the translation is aborted and the word is re-translated using the specified different language. <language code> may be upper or lower case. This can be used to recognise certain letter combinations as being foreign words and to use the foreign pronunciation for them. eg:
<pre>
th (_ _^_EN
</pre>
indicates that a word which ends in "th" is translated using the English translation rules and spoken with English phonemes.
</ul>
<h4>4.3.4 Special Characters in both <pre> and <post>:</h4>
<ul><table>
<tbody>
<tr>
<td><strong>_</strong></td>
<td>Beginning or end of a word (or a hyphen).</td>
</tr>
<tr>
<td><strong>-</strong></td>
<td>Hyphen.</td>
</tr>
<tr>
<td><strong>A</strong></td>
<td>Any vowel (the set of vowel characters may be defined for a particular language).</td>
</tr>
<tr>
<td><strong>C</strong></td>
<td>Any consonant.</td>
</tr>
<tr>
<td><strong>B H F G Y </strong></td>
<td>These may indicate other sets of characters (defined for a particular language).</td>
</tr>
<tr>
<td><strong>L<nn></strong></td>
<td>Any of the sequence of characters defined as a letter group (see 4.3.1 above).</td>
</tr>
<tr>
<td><strong>D</strong></td>
<td>Any digit.</td>
</tr>
<tr>
<td><strong>K</strong></td>
<td>Not a vowel (i.e. a consonant or word boundary or non-alphabetic character).</td>
</tr>
<tr>
<td><strong>X</strong></td>
<td>There is no vowel until the word boundary.</td>
</tr>
<tr>
<td><strong>Z</strong></td>
<td>A non-alphabetic character.</td>
</tr>
<tr>
<td><strong>%</strong></td>
<td>Doubled (placed before a character in <pre> and after it in <post>.</td>
</tr>
<tr>
<td><strong>/</strong></td>
<td>The following character is treated literally.</td>
</tr>
</tbody>
</table>
</ul>
The sets of letters indicated by A, B, C, E, F G may be defined differently for each language.
<p>
Examples of rules:
<pre> _) a // "a" at the start of a word
a (CC // "a" followed by two consonants
a (C% // "a" followed by a double consonant (the same letter twice)
a (/% // "a" followed by a percent sign
%C) a // "a" preceded by a double consonants
</pre>
<h4>4.3.5 Special characters only in <pre>:</h4>
<ul><table>
<tbody>
<tr>
<td><strong>@ </strong></td>
<td>Any syllable.</td>
</tr>
<tr>
<td><strong>&</strong></td>
<td>A syllable which may be stressed (i.e. is not defined as unstressed).</td>
</tr>
<tr>
<td><strong>V</strong></td>
<td>Matches only if a previous word has indicated that a verb form is expected.</td>
</tr>
</tbody>
</table>
</ul>
eg.
<pre> @@) bi // "bi" preceded by at least two syllables
@@a) bi // "bi" preceded by at least 2 syllables and following 'a'
</pre>
Note, that matching characters in the <pre> part do not affect the syllable counting.
<p>
<h4>4.3.6 Special characters only in <post>:</h4>
<ul><table>
<tbody>
<tr>
<td><strong>@</strong></td>
<td>A vowel follows somewhere in the word.</td>
</tr>
<tr>
<td><strong>+</strong></td>
<td>Force an increase in the score in this rule (may be repeated for more effect).</td>
</tr>
<tr>
<td><strong>S<number> </strong></td>
<td>This number of matching characters are a standard suffix, remove them and retranslate the word.</td>
</tr>
<tr>
<td><strong>P<number></strong></td>
<td>This number of matching characters are a standard prefix, remove them and retranslate the word.</td>
</tr>
<tr>
<td><strong>Lnn</strong></td>
<td><strong>nn</strong> is a 2-digit decimal number in the range 01 to 20<br>
Matches with any of the letter sequences which have been defined for letter group <strong>nn</strong></td>
</tr>
<tr>
<td><strong>N</strong></td>
<td>Only use this rule if the word is not a retranslation after removing a suffix.</td>
</tr>
<tr>
<td><strong>#</strong></td>
<td>(English specific) change the next "e" into a special character "E"</td>
</tr>
<tr>
<td><strong>$w_alt<br>$w_alt2<br>$w_alt3</strong></td>
<td>Only use this rule if the word is found in the *_list file with the <b>$alt</b>, <b>$alt2</b> or <b>$alt3</b> attribute respectively.</td>
</tr>
<tr>
<td><strong>$p_alt<br>$p_alt2<br>$p_alt3</strong></td>
<td>Only use this rule if the part-word, up to and including the pre and match parts of this rule, is found in the *_list file with the <b>$alt</b>, <b>$alt2</b> or <b>$alt3</b> attribute respectively.</td>
</tr>
</tbody>
</table>
</ul>
eg.
<pre> @) ly (_$2 lI // "ly", at end of a word with at least one other
// syllable, is a suffix pronounced [lI]. Remove
// it and retranslate the word.
_) un (@P2 ¬Vn // "un" at the start of a word is an unstressed
// prefix pronounced [Vn]
_) un (i ju: // ... except in words starting "uni"
_) un (inP2 ,Vn // ... but it is for words starting "unin"
</pre>
S and P must be at the end of the <post> string.
<p>
S<number> may be followed by additonal letters (eg. S2ei ). Some of these are probably specific to English, but similar functions could be made for other languages.
<ul><table>
<tbody>
<tr>
<td><strong>q</strong></td>
<td>query the _list file to find stress position or other attributes for the stem, but don't re-translate the word with the suffix removed.</td>
</tr>
<tr>
<td><strong>t</strong></td>
<td>determine the stress pattern of the word <strong>before</strong> adding the suffix</td>
</tr>
<tr>
<td><strong>d </strong></td>
<td>the previous letter may have been doubled when the suffix was added.</td>
</tr>
<tr>
<td><strong>e</strong></td>
<td>"e" may have been removed.</td>
</tr>
<tr>
<td><strong>i</strong></td>
<td>"y" may have been changed to "i."</td>
</tr>
<tr>
<td><strong>v</strong></td>
<td>the suffix means the verb form of pronunciation should be used.</td>
</tr>
<tr>
<td><strong>f</strong></td>
<td>the suffix means the next word is likely to be a verb.</td>
</tr>
</tbody>
</table>
</ul>
<p>
P<number> may be followed by additonal letters (eg. P3v ).
<ul><table>
<tbody>
<tr>
<td><strong>t </strong></td>
<td>determine the stress pattern of the word <strong>before</strong> adding the prefix</td>
</tr>
<tr>
<td><strong>v</strong></td>
<td>the suffix means the verb form of pronunciation should be used.</td>
</tr>
</tbody>
</table>
</ul>
<p> <hr>
<h3>4.4 Pronunciation Dictionary List</h3>
The <strong><em><language>_list</em></strong> file contains a list of words whose pronunciations are given explicitly, rather than determined by the Pronunciation Rules.
The <strong><em><language>_extra</em></strong> file, if present, is also used and it's contents are taken as coming after those in <strong><em><language>_list</em></strong>.
<p>
Also the list can be used to specify the stress pattern, or other properties, of a word.
<p>
If the Pronunciation rules are applied to a word and indicate a standard prefix or suffix, then the word is again looked up in Pronunciation Dictionary List after the prefix or suffix has been removed.
<p>
Lines in the dictionary list have the form:
<ul>
<word> [<phoneme string>] [<flags>]
</ul>eg.
<pre> book bUk
</pre>
Rather than a full pronunciation, just the stress may be given, to change where it would be otherwise placed by the Pronunciation Rules:
<pre> berlin $2 // stress on second syllable
absolutely $3 // stress on third syllable
for $u // an unstressed word
</pre>
<h4>4.4.1 Multiple Words</h4>
A pronunciation may also be specified for a group of words, when these appear together. Up to four words may be given, enclosed in brackets. This may be used for change the pronunciation or stress pattern when these words occur together,
<pre> (de jure) deI||dZ'U@rI2 // note || used as a word break in the phoneme string</pre>
or to run them together, pronounced as a single word
<pre> (of a) @v@
</pre>
or to give them a flag when they occur together
<pre> (such as) sVtS||a2z $pause // precede with a pause
</pre>
Hyphenated words in the <strong><em><language>_list</em></strong> file must also be enclosed within brackets, because the two parts are considered as separate words.
<h4>4.4.2 Special characters in <phoneme string>:</h4>
<ul><table>
<tbody>
<tr>
<td><strong>_^_<language code> </strong></td>
<td>Translate using a different language. See explanation in 4.3.3 above.</td>
</tr>
</tbody>
</table>
</ul>
<h4>4.4.3 Flags</h4>
A word (or group of words) may be given one or more flags, either instead of, or as well as, the phonetic translation.
<ul><table>
<tbody valign="top">
<tr>
<td>$u</td>
<td>The word is unstressed. In the case of a multi-syllable word, a slight stress is applied according to the default stress rules.</td>
</tr>
<tr>
<td>$u1</td>
<td>The word is unstressed, with a slight stress on its 1st syllable.</td>
</tr>
<tr>
<td>$u2</td>
<td>The word is unstressed, with a slight stress on its 2nd syllable.</td>
</tr>
<tr>
<td>$u3</td>
<td>The word is unstressed, with a slight stress on its 3rd syllable.</td>
</tr>
<tr>
<td> </td>
<td> </td>
</tr>
<tr>
<td>$u+ $u1+ $u2+ $u3+</td>
<td>As above, but the word has full stress if it's at the end of a clause.</td>
</tr>
<tr>
<td> </td>
<td> </td>
</tr>
<tr>
<td>$1</td>
<td>Primary stress on the 1st syllable.</td>
</tr>
<tr>
<td>$2</td>
<td>Primary stress on the 2nd syllable.</td>
</tr>
<tr>
<td>$3</td>
<td>Primary stress on the 3rd syllable.</td>
</tr>
<tr>
<td>$4</td>
<td>Primary stress on the 4th syllable.</td>
</tr>
<tr>
<td>$5</td>
<td>Primary stress on the 5th syllable.</td>
</tr>
<tr>
<td>$6</td>
<td>Primary stress on the 6th syllable.</td>
</tr>
<tr>
<td>$7</td>
<td>Primary stress on the 7th syllable.</td>
</tr>
<tr>
<td> </td>
<td> </td>
</tr>
<tr>
<td>$pause</td>
<td>Ensure a short pause before this word (eg. for conjunctions such as "and", some prepositions, etc).</td>
</tr>
<tr>
<td>$brk</td>
<td>Ensure a very short pause before this word, shorter than $pause (eg. for some prepositions, etc).</td>
</tr>
<tr>
<td>$only</td>
<td>The rule does not apply if a prefix or suffix has already been removed.</td>
</tr>
<tr>
<td>$onlys</td>
<td>As $only, except that a standard plural ending is allowed.</td>
</tr>
<tr>
<td>$stem</td>
<td>The rule only applies if a suffix has already been removed.</td>
</tr>
<tr>
<td>$strend</td>
<td>Word is fully stressed if it's at the end of a clause.</td>
</tr>
<tr>
<td>$strend2</td>
<td>As $strend, but the word is also stressed if followed only by unstressed word(s).</td>
</tr>
<tr>
<td>$unstressend </td>
<td>Word is unstressed if it's at the end of a clause.</td>
</tr>
<tr>
<td>$atend</td>
<td>Use this pronunciation if it's at the end of a clause.</td>
</tr>
<tr>
<td>$double</td>
<td>Cause a doubling of the initial consonant of the following word (used for Italian).</td>
</tr>
<tr>
<td>$capital</td>
<td>Use this pronunciation if the word has initial capital letter (eg. polish v Polish).</td>
</tr>
<tr>
<td>$allcaps</td>
<td>Use this pronunciation if the word is all capitals.</td>
</tr>
<tr>
<td>$dot</td>
<td>Ignore a . after this word even when followed by a capital letter (eg. Mr. Dr. ).</td>
</tr>
<tr>
<td>$hasdot</td>
<td>Use this pronunciation if the word is followed by a dot. (This attribute also implies $dot).</td>
</tr>
<tr>
<td>$sentence</td>
<td>The rule only applies if the clause includes end-of-sentence (i.e. it is not terminated by a comma). For example, "$atend $sentence" means that the rule only applies at the end of a sentence.</td>
</tr>
<tr>
<td>$abbrev</td>
<td>This has two meanings.<br> 1. If there is no phoneme string: Speak the word as individual letters, even if it contains a vowel (eg. "abc" should be spoken as "a" "b" "c").<br>2. If there is a phoneme string: This word is capitalized because it is an abbreviation and capitalization does not indicate emphasis (if the "emphasize all-caps" is on).</td>
</tr>
<tr>
<td> </td>
<td> </td>
</tr>
<tr>
<td>$accent</td>
<td>Used for the pronunciation of a single alphabetic character. The character name is spoken as the base-letter name plus the accent (diacritic) name. eg. It can be used to specify that "â" is spoken as "a" "circumflex".</td>
</tr>
<tr>
<td>$combine</td>
<td>This word is treated as though it is combined with the following word with a hyphen. This may be subject to fuither conditions for certain languages.</td>
</tr>
<tr>
<td>$alt $alt2 $alt3</td>
<td>These are language specific. Their use should be described in the language's **_list file</td>
</tr>
<tr>
<tr>
<td> </td>
<td> </td>
</tr>
<tr>
<td>$verb</td>
<td>Use this pronunciation if it's a verb.</td>
</tr>
<tr>
<td>$noun</td>
<td>Use this pronunciation if it's a noun.</td>
</tr>
<tr>
<td>$past</td>
<td>Use this pronunciation if it's past tense.</td>
</tr>
<tr>
<td>$verbf</td>
<td>The following word is probably is a verb.</td>
</tr>
<tr>
<td>$verbsf</td>
<td>The following word is probably is a if it has an "s" suffix.</td>
</tr>
<tr>
<td>$nounf</td>
<td>The following word is probably not a verb.</td>
</tr>
<tr>
<td>$pastf</td>
<td>The following word is probably past tense.</td>
</tr>
<tr>
<td>$verbextend</td>
<td>Extend the influence of $verbf and $verbsf.</td>
</tr>
</tbody>
</table></ul>
The last group are probably English specific, but something similar may be useful in other languages. They are a crude attempt to improve the accuracy of pairs like ob'ject (verb) v 'object (noun) and read (present) v read (past).
<p>
The dictionary list is searched from bottom to top. The first match that satisfies any conditions is used (i.e. the one lowest down the list). So if we have:
<pre>
to t@ // unstressed version
to tu: $atend // stressed version
</pre>
then if "to" is at the end of the clause, we get [tu:], if not then we get [t@].
<p>
<h4>4.4.4 Translating a Word to another Word</h4>
Rather than specifying the pronunciation of a word by a phoneme string, you can specify another "sounds like" word.<p>Use the attribute <b>$text</b> eg.<p>
<pre>
cough coff $text
</pre>
Alternatively, use the command <b>$textmode</b> on a line by itself to turn this on for all subsequent entries in the file, until it's turned off by <b>$phonememode</b>. eg.<p>
<pre>
$textmode
cough coff
through threw
$phonememode
</pre>
This feature cannot be used for the special entries in the <b>_list</b> files which start with an underscore, such as numbers.<p>
Currently "textmode" entries are only recognized for complete words, and not for for stems from which a prefix or suffix has been removed (eg. the word "coughs" would not match the example above).
<p>
<p> <hr>
<h3>4.5 Conditional Rules</h3>
Rules in a <b>_rules</b> file and entries in a <b>_list</b> file can be made conditional. They apply only to some voices. This can be useful to specify different pronunciations for different variants of a language (dialects or accents).<p>
Conditional rules have <b>?</b> and a condition number at the start if the line in the <b>_rules</b> or <b>_list</b> file. This means that the rule only applies of that condition number is specified in a <b>dictrules</b> line in the <a href="voices.html">voice file</a>.<p>
If the rule starts with <b>?!</b> then the rule only applies if the condition number is <b>not</b> specified in the voice file. eg.<p>
<pre>
?3 can't kant // only use this if the voice has: dictrules 3
?!3 rather rA:D3 // only use if the voice doesn't have: dictrules 3
</pre>
<p> <hr>
<h3>4.6 Numbers and Character Names</h3>
<h4>4.6.1 Letter names</h4>
The names of individual letters can be given either in the <b>_rules</b> or <b>_list</b> file. Sometimes an individual letter is also used as a word in the language and its pronunciation as a word differs from its letter name. If so, it should be listed in the <b>_list</b> file, preceded by an underscore, to give the letter name (as distinct from its pronunciation as a word). eg. in English:
<pre> _a eI</pre>
<h4>4.6.2 Numbers</h4>
The operation the TranslateNumber() function is controlled by the language's <code>langopts.numbers</code> option. This constructs spoken numbers from fragments according to various options which can be set for each language. The number fragments are given in the <b>_list</b> file.
<p>
<ul>
<table><tbody align="left">
<tr>
<td>
_0 to _9
<td>The numbers 0 to 9
</tr>
<tr>
<td>_13<td>etc. Any pronunciations which are needed for specific numbers in the range _10 to _99
</tr>
<tr>
<td>_2X _3X<td>Twenty, thirty, etc., used to make numbers 10 to 99
</tr>
<tr>
</tr>
<tr><TD>_0C<td>The word for "hundred"</td>
<tr><TD>_1C _2C<td>Special pronunciation for one hundred, two hundred, etc., if needed.</tr>
<tr><TD>_1C0<td>Special pronunciation (if needed) for 100 exactly</td>
<tr><TD>_0M1<td>The word for "thousand"</tr>
<tr><TD>_0M2<td>The word for "million"</tr>
<tr><TD>_0M3<td>The word for 1000000000</tr>
<tr><TD>_1M1 _2M1<td>Special pronunciation for one thousand, two thousand, etc, if needed</td>
<tr><TD>_0and<td>Word for "and" when speaking numbers (eg. "two hundred and twenty").</tr>
<tr><TD>_dpt<td>Word spoken for the decimnal point/comma</tr>
<tr><TD>_dpt2<td>Word spoken (if any) at the end of all the digits after a decimal point.</tr>
</tbody></table>
</ul>
<p> <hr>
<h3>4.7 Character Substitution</h3>
Character substitutions can be specified by using a <b> .replace </b> section at the start of the <b> _rules </b> file. Each line specified either one or two alphabetic characters to be replaced by another one or two alphabetic characters. This substitution is done to a word before it is translated using the spelling-to-phoneme rules. Only the lower-case version of the characters needs to be specified. eg.<p>
.replace<br>
ô ő // (Hungarian) allow the use of o-circumflex instead of o-double-accute<br>
û ű<p>
cx ĉ // (Esperanto) allow "cx" as an alternative to c-circumflex<p>
fi fi // replace a single character ligature by two characters
<p>
</body>
</html>
|
