csswg-drafts/css2/aural.src at 47c3caa1459c0dda4bf644911a38f3017304dbb3 · w3c/csswg-drafts · GitHub

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
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<!-- $Id: aural.src,v 2.0 1998-02-02 18:43:28 bbos Exp $ -->
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<TITLE>Aural style sheets</TITLE>
</HEAD>
<BODY>
<H1 align="center"><a name="aural">Aural style sheets</a></H1>

<H2>Introduction to aural style sheets</H2>

<p>The aural rendering of a document, already commonly used by the
blind and print-impaired communities, combines speech synthesis and
<span class="index-def" title="audio icon">"audio icons"</span> Often
such aural presentation occurs by converting the document to plain
text and feeding this to a <span class="index-def" title="screen
reader"><dfn>screen reader</dfn></span> -- software or hardware that
simply reads all the characters on the screen.  This results in less
effective presentation than would be the case if the document
structure were retained.  Style Sheet properties for aural presentation
may be used together with visual properties (mixed media) or as an
aural alternative to visual presentation.

<p>Besides the obvious accessibility advantages, there are other large
markets for aural presentation, including in-car use, industrial and
medical documentation systems (intranets), home entertainment, and to
help illiterate users.

<!-- Talk about aural canvas here. Space, time, frequency, etc. -IJ
-->

<!-- Give examples! -->


<H2><a name="volume-props">Volume properties</a>: <span
class="propinst-volume">'volume'</span></H2>

<!-- #include src=properties/volume.srb -->

<P><span class="index-def" title="volume">Volume</span> refers to the
median volume of the waveform. In other words, a highly inflected
voice at a volume of 50 might peak well above that. The overall values
are likely to be human adjustable for comfort, for example with a
physical volume control (which would increase both the 0 and 100
values proportionately); what this property does is adjust the dynamic
range.


<P>Values have the following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;number&gt;"><span
		class="value-inst-number"><strong>&lt;number&gt;</strong>
</span></span>
<dd>Any number between '0' and '100'.
'0' represents the <em>minimum audible</em>
volume level and 100 corresponds to the
<em>maximum comfortable</em> level.
<dt><span class="index-inst" title="&lt;percentage&gt;"><span class="value-inst-percentage"><strong>&lt;percentage&gt;</strong></span></span>
<dd>Percentage values are calculated relative to the inherited value,
and are then clipped to the range '0' to '100'.
<dt><strong>silent</strong>
<dd>No sound at all. <strong>Note.</strong> The value '0' does not mean
the same as 'silent'.
<dt><strong>x-soft</strong>
<dd>Same as '0'.
<dt><strong>soft</strong>
<dd>Same as '25'.
<dt><strong>medium</strong>
<dd>Same as '50'.
<dt><strong>loud</strong>
<dd>Same as '75'.
<dt><strong>x-loud</strong>
<dd>Same as '100'.
</dl>

<p>User agents should allow the values corresponding to '0' and '100'
to be set by the listener. No one setting is universally applicable;
suitable values depend on the equipment in use (speakers, headphones),
the environment (in car, home theater, library) and personal
preferences. Some examples:</p>

<ul>
<li>A browser for in-car use has a setting for when there is lots of
background noise. '0' would map to a fairly high level and '100' to a
quite high level. The speech is easily audible over the road noise but
the overall dynamic range is compressed. Cars with better
insulation might allow a wider dynamic range.

<li>Another speech browser is being used in an apartment, late at
night, or in a shared study room. '0' is set to a very quiet level and
'100' to a fairly quiet level, too. As with the first example, there
is a low slope; the dynamic range is reduced. The actual volumes are
low here, whereas they were high in the first example.

<li>In a quiet and isolated house, an expensive hi-fi home theater
setup. '0' is set fairly low and '100' to quite high; there is wide
dynamic range.
</ul>

<p>The same author style sheet could be used in all cases, simply by
mapping the '0' and '100' points suitably at the client side.

<H2><a name="speaking-props">Speaking properties</a>: <span
class="propinst-speak">'speak'</span></H2>

<!-- #include src=properties/speak.srb -->

<P>This property specifies whether text will be rendered aurally and
if so, in what manner (somewhat analogous to the <span
class="propinst-display">'display'</span> property). The possibles
values are:

<dl>
<dt><strong>none</strong></dt>
<dd>Suppresses aural rendering so that, unless overridden recursively,
the element and its children require no time to render.

<dt><strong>normal</strong></dt>
<dd>Uses regular language-dependent pronunciation rules for rendering
an element and its children.

<dt><strong>spell-out</strong></dt>
<dd>Spells the text one letter at a time (useful for acronyms and
abbreviations).
</dl>

<p>Note the difference between an element whose <span
class="propinst-volume">'volume'</span> property has a value of
'silent' and an element whose <span
class="propinst-speak">'speak'</span> property has the value 'none'.
The former takes up the same time as if it had been spoken, including
any pause before and after the element, but no sound is
generated. This may be used in language teaching applications, for
example. A pause is generated for the pupil to speak the element
themselves. Note that since the value of this property is inherited,
child elements will also be silent.  Child elements may however set
the volume to a non-silent value and will then be spoken.  On the
other hand, elements for which the <span
class="propinst-speak">'speak'</span> property has the value 'none'
are not spoken and take no time. Child elements may however override
this value and may be spoken normally.

<!-- There is an anomaly between 'display' and 'speak' since
'display' cannot be overridden by children -->

<H2><a name="pause-props">Pause properties</a>: <span
class="propinst-pause-before">'pause-before'</span>, <span
class="propinst-pause-after">'pause-after'</span>, and <span
class="propinst-pause">'pause'</span></H2>

<!-- #include src=properties/pause-before.srb -->

<!-- #include src=properties/pause-after.srb -->


<P>These properties specify a pause to be observed before (or after)
speaking an element's content.  Values have the following
meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;time&gt;"><span class="value-inst-time"><strong>&lt;time&gt;</strong></span></span>
<dd>Expresses the pause in absolute time units (seconds and milliseconds).
<dt><span class="index-inst" title="&lt;percentage&gt;"><span class="value-inst-percentage"><strong>&lt;percentage&gt;</strong></span></span>
<dd>Refers to the inverse of the value of the
<span class="propinst-speech-rate">'speech-rate'</span> property.
For example, if the speech-rate is 120 words per minute
(i.e., a word takes half a second, or 500ms) then a <span
class="propinst-pause-before">'pause-before'</span> of 100% means a
pause of 500 ms and a <span
class="propinst-pause-before">'pause-before'</span> of 20% means
100ms.
</dl>

<p>Authors should use relative units to create more robust style
sheets in the face of large changes in speech-rate.</p>

<!-- #include src=properties/pause.srb -->

<P>The <span class="propinst-pause">'pause'</span> property is a
shorthand for setting <span
class="propinst-pause-before">'pause-before'</span> and <span
class="propinst-pause-after">'pause-after'</span>.  If two values are
given, the first value is <span
class="propinst-pause-before">'pause-before'</span> and the second is
<span class="propinst-pause-after">'pause-after'</span>. If only one
value is given, it applies to both properties.

<div class="example"><P>
Examples:
<PRE>
  H1 { pause: 20ms } /* pause-before: 20ms; pause-after: 20ms */
  H2 { pause: 30ms 40ms } /* pause-before: 30ms; pause-after: 40ms */
  H3 { pause-after: 10ms } /* pause-before: ?; pause-after: 10ms */
</PRE>
</div>

<H2><a name="cue-props">Cue properties</a>: <span
class="propinst-cue-before">'cue-before'</span>, <span
class="propinst-cue-after">'cue-after'</span>, and <span
class="propinst-cue">'cue'</span></H2>

<!-- #include src=properties/cue-before.srb -->

<!-- #include src=properties/cue-after.srb -->

<P>Auditory icons are another way to distinguish semantic
elements. Sounds may be played before, and/or after the element to
delimit it. Values have the following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;uri&gt;"><span class="value-inst-uri"><strong>&lt;uri&gt;</strong></span></span>
<dd> The URI designates an audio icon resource.
<dt><strong>none</strong>
<dd> No audio icon is specified.
</dl>

<div class="example"><P>
For example:
<PRE>
  A {cue-before: url(bell.aiff); cue-after: url(dong.wav) }
  H1 {cue-before: url(pop.au); cue-after: url(pop.au) }
</pre>
</div>

<!-- #include src=properties/cue.srb -->

<P>The <span class="propinst-cue">'cue'</span> property is a shorthand
for setting <span class="propinst-cue-before">'cue-before'</span>
and <span class="propinst-cue-after">'cue-after'</span>.  If two
values are given, the first value is <span
class="propinst-cue-before">'cue-before'</span> and the second is
<span class="propinst-cue-after">'cue-after'</span>. If only one
value is given, it applies to both properties.</p>

<div class="example"><P>
The following two rules are equivalent:
<PRE>
  H1 {cue-before: url(pop.au); cue-after: url(pop.au) }
  H1 {cue: url(pop.au) }
</pre>
</div>

<!-- What do UAs do when the audio icon is not found
or they cannot render the audio icon? -IJ -->


<H2><a name="mixing-props">Mixing properties</a>: <span
class="propinst-play-during">'play-during'</span></H2>

<!-- #include src=properties/play-during.srb -->

<p>Similar to the <span
class="propinst-cue-before">'cue-before'</span> and <span
class="propinst-cue-after">'cue-after'</span> properties, this
property specifies a sound to be played as a background
while an element's content is spoken.
Values have the following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;uri&gt;"><span class="value-inst-uri"><strong>&lt;uri&gt;</strong></span></span>
<dd>The sound designated by this <span class="index-inst"
title="&lt;uri&gt;"><span
class="value-inst-uri">&lt;uri&gt;</span></span> is played
as a background while the element's content is spoken.
<dt><strong>mix</strong>
<dd>When present, this keyword means that
the sound inherited from the parent element's <span
class="propinst-play-during">'play-during'</span> property continues
to play and the sound designated by the <span
class="index-inst" title="&lt;uri&gt;"><span
class="value-inst-uri">&lt;uri&gt;</span></span> is mixed with it. If
'mix' is not specified, the sound replaces the sound of the parent
element.
<dt><strong>repeat</strong>
<dd>When present, this keyword means that the sound will repeat if it is
too short to fill the entire duration of the element. Otherwise,
the sound plays once and then stops. This is similar to the
background repeat properties in CSS2. If the sound is too long for the
element, it is clipped once the element is spoken.
<dt><strong>auto</strong>
<dd>The sound of the parent element continues to play
(it is not restarted, which would have been the case if this property
had been inherited).
<dt><strong>none</strong>
<dd>Means that there is silence - the sound of the
parent element (if any) is silent during the current element and
continues after the current element.
</dl>

<div class="example"><P>
Examples:
<PRE>
  BLOCKQUOTE.sad {play-during: url(violins.aiff) }
  BLOCKQUOTE Q {play-during: url(harp.wav) mix}
  SPAN.quiet {play-during: none }
</pre>
</div>

<P>If a stereo icon is dereferenced, the central point of the stereo
pair should be placed at the azimuth for that element and the left and
right channels should be placed to either side of this position.

<H2><a name="spatial-props">Spatial properties</a>: <span
class="propinst-azimuth">'azimuth'</span> and
<span class="propinst-elevation">'elevation'</span>
</H2>

<p>Spatial audio is an important stylistic property for aural
presentation. It provides a natural way to tell several voices apart,
as in real life (people rarely all stand in the same spot in a
room). Stereo speakers produce a lateral sound stage. Binaural
headphones or the increasingly popular 5-speaker home theater setups
can generate full surround sound, and multi-speaker setups can create
a true three-dimensional sound stage. VRML 2.0 also includes spatial
audio, which implies that in time consumer-priced spatial audio
hardware will become more widely available.</p>

<!-- #include src=properties/azimuth.srb -->

<P>Values have the following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;angle&gt;"><span class="value-inst-angle"><strong>&lt;angle&gt;</strong></span></span>
<dd>Position is described in terms of degrees, within
the range '-360deg' to '360deg'.
The value '0deg' means directly ahead in the center of the sound
stage.  '90deg' is to the right, '180deg' behind, and '270deg' (or,
equivalently and more conveniently, '-90deg') to the left.
<dt><strong>left-side</strong>
<dd>Same as '270deg'. With 'behind', '270deg'.
<dt><strong>far-left</strong>
<dd>Same as '300deg'. With 'behind', '240deg'.
<dt><strong>left</strong>
<dd>Same as '320deg'. With 'behind', '220deg'.
<dt><strong>center-left</strong>
<dd>Same as '340deg'. With 'behind', '200deg'.
<dt><strong>center</strong>
<dd>Same as '0deg'. With 'behind', '180deg'.
<dt><strong>center-right</strong>
<dd>Same as '20deg'. With 'behind', '160deg'.
<dt><strong>right</strong>
<dd>Same as '40deg'. With 'behind', '140deg'.
<dt><strong>far-right</strong>
<dd>Same as '60deg'. With 'behind', '120deg'.
<dt><strong>right-side</strong>
<dd>Same as '90deg'. With 'behind', '90deg'.
<dt><strong>leftwards</strong>
<dd>Moves the sound
to the left, relative to the current angle.
More precisely, subtracts 20 degrees.
Arithmetic is carried out modulo 360 degrees. Note that
'leftwards' is more accurately described as "turned
counter-clockwise," since it <em>always</em> subtracts 20 degrees,
even if the inherited azimuth is already behind the listener (in which
case the sound actually appears to move to the right).
<dt><strong>rightwards</strong>
<dd>Moves the sound
to the right, relative to the
current angle. More precisely, adds 20 degrees. See 'leftwards'
for arithmetic.
</dl>

<p>This property is most likely to be implemented by mixing the same
signal into different channels at differing volumes.  It might also
use phase shifting, digital delay, and other such techniques to
provide the illusion of a sound stage.  The precise means used to
achieve this effect and the number of speakers used to do so are
user agent-dependent; this property merely identifies the desired end
result.

<div class="example"><P>
Examples:
<PRE>
  H1   { azimuth: 30deg }
  TD.a { azimuth: far-right }          /*  60deg */
  #12  { azimuth: behind far-right }   /* 120deg */
  P.comment { azimuth: behind }        /* 180deg */
</PRE>
</div>

<p>If spatial-azimuth is specified and the output device cannot
produce sounds <em>behind</em> the listening position, user agents
should convert values in the rearwards hemisphere to forwards
hemisphere values.  One method is as follows:</p>

<ul>
    <li>if 90deg &lt; x &lt;= 180deg then x := 180deg - x
    <li>if 180deg &lt; x &lt;= 270deg then x := 540deg - x
</ul>

<!-- #include src=properties/elevation.srb -->

<P>Values of this property have the following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;angle&gt;"><span class="value-inst-angle"><strong>&lt;angle&gt;</strong></span></span>
<dd>Specifies the elevation as an angle, between '-90deg' and '90deg'.
'0deg' means on the forward horizon, which loosely means level with
the listener.  '90deg' means directly overhead and '-90deg' means directly
below.
<dt><strong>below</strong>
<dd>Same as '-90deg'.
<dt><strong>level</strong>
<dd>Same as '-0deg'.
<dt><strong>above</strong>
<dd>Same as '90deg'.
<dt><strong>higher</strong>
<dd>Adds 10 degrees to the current elevation.
<dt><strong>lower</strong>
<dd>Subtracts 10 degrees from the current elevation.
</dl>

<P>The precise means used to achieve this effect and the
number of speakers used to do so are undefined.  This property merely
identifies the desired end result.

<div class="example"><P>
Examples:
<PRE>
  H1   { elevation: above }
  TR.a { elevation: 60deg }
  TR.b { elevation: 30deg }
  TR.c { elevation: level }
</pre>
</div>

<h2><a name="voice-char-props">Voice characteristic properties</a>: <span
class="propinst-speech-rate">'speech-rate'</span>, <span
class="propinst-voice-family">'voice-family'</span>,
<span class="propinst-pitch">'pitch'</span>,
<span class="propinst-pitch-range">'pitch-range'</span>,
<span class="propinst-stress">'stress'</span>, and
<span class="propinst-richness">'richness'</span></H2>

<!-- #include src=properties/speech-rate.srb -->

<P>This property specifies the speaking rate. Note that both absolute
and relative keyword values are allowed (compare with <span
class="propinst-font-weight">'font-weight'</span>). Values have
the following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;number&gt;"><span
class="value-inst-number"><strong>&lt;number&gt;</strong></span></span>
<dd>Specifies the speaking rate in words per minute, a quantity that varies
somewhat by language but is nevertheless widely supported by speech
synthesizers.
<dt><strong>x-slow</strong>
<dd>Same as ?
<dt><strong>slow</strong>
<dd>Same as ?
<dt><strong>medium</strong>
<dd>Same as ? Refers to the user's preferred
speech-rate setting.
<dt><strong>fast</strong>
<dd>Same as ?
<dt><strong>x-fast</strong>
<dd>Same as ?
<dt><strong>faster</strong>
<dd>Adds ? to current speech rate.
<dt><strong>slower</strong>
<dd>Subtracts ? to current speech rate.
</dl>

<!-- These need completion! -IJ -->

<!-- #include src=properties/voice-family.srb -->

<P>The value is a comma-separated, prioritized list of voice family
names (compare with <span
class="propinst-font-family">'font-family'</span>). Values have the
following meanings:</P>

<dl>
<dt><span class="index-def" title="&lt;generic-voice&gt;,
definition of"><a
name="value-def-generic-voice"><strong>&lt;generic-voice&gt;</strong></a></span>
<dd>Values are voice families (e.g., male, female, child).
<dt><span class="index-def" title="&lt;specific-voice&gt;::definition of"><a name="value-def-specific-voice"><strong>&lt;specific-voice&gt;</strong></a></span>
<dd>Values are specific instances (e.g., comedian, trinoids, carlos, lani).
</dl>

<div class="example"><P>
Examples:

<pre>
  H1 { voice-family: announcer, male }
  P.part.romeo  { voice-family: romeo, male }
  P.part.juliet { voice-family: juliet, female }
</pre>
</div>

<!-- Needs work! -IJ -->

<!--
<p class=comment>Should the properties of these family names be
described, using an @-rule, to allow better client-side matching (like
fonts). If so, what are the values that describe these voice families
in a way that is independent of speech synthesizer?
-->

<!-- #include src=properties/pitch.srb -->

<p>Specifies the average pitch of the speaking voice.
Values have the following meanings:</P>

<dl>
<dt><span class="index-inst" title="&lt;frequency&gt;"><span class="value-inst-frequency"><strong>&lt;frequency&gt;</strong></span></span>
<dd>Specifies the average pitch of the speaking voice in hertz (Hz).
<dt><strong>x-low</strong>
<dd>Same as ?
<dt><strong>low</strong>
<dd>Same as ?
<dt><strong>medium</strong>
<dd>Same as ?
<dt><strong>high</strong>
<dd>Same as ?
<dt><strong>x-high</strong>
<dd>Same as ?
</dl>

<!-- Needs completion! -IJ -->

<!-- #include src=properties/pitch-range.srb -->

<p>Specifies variation in average pitch. Values have the
following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;number&gt;"><span class="value-inst-number"><strong>&lt;number&gt;</strong></span></span>
<dd>A pitch range of 0 produces
a flat, monotonic voice. A pitch range of 50 produces normal
inflection.  Pitch ranges greater than 50 produce animated voices.
</dl>

<!-- Needs completion -IJ -->

<!-- #include src=properties/stress.srb -->

<p>Specifies the level of stress (assertiveness or emphasis) of the
speaking voice.  English is a <strong>stressed</strong> language, and
different parts of a sentence are assigned primary, secondary or
tertiary stress. The value of <span
class="propinst-stress">'stress'</span> controls the amount of
inflection that results from these stress markers. Values
have the following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;number&gt;"><span class="value-inst-number"><strong>&lt;number&gt;</strong></span></span>
<dd>Increasing the value of this property results in the speech being
more strongly inflected.  It is, in a sense, a companion to the <span
class="propinst-pitch-range">'pitch-range'</span> property and is
provided to allow developers to exploit higher-end auditory displays.
</dl>

<!-- Needs completion -IJ -->

<!-- #include src=properties/richness.srb -->

<P>Specifies the richness (brightness) of the speaking voice.
Values have the following meanings:</p>

<dl>
<dt><span class="index-inst" title="&lt;number&gt;"><span class="value-inst-number"><strong>&lt;number&gt;</strong></span></span>
<dd>The effect of increasing richness is to produce a voice that
<em>carries</em>. Reducing richness produces a soft, mellifluous
voice.
</dl>

<!-- Needs completion -IJ -->

<H2><a name="speech-props">Speech properties</a>:
<span class="propinst-speak-punctuation">'speak-punctuation'</span>,
<span class="propinst-speak-date">'speak-date'</span>,
<span class="propinst-speak-numeral">'speak-numeral'</span>, and
<span class="propinst-speak-time">'speak-time'</span>
</h2>

<div class="note"><P>
<em><strong>Note.</strong>
The following four properties are preliminary and
discussion on them is invited.
</em>
</div>

<p>An additional speech property, <a
href="tables.html#propdef-speak-header">speak-header</a>, is
described in the chapter on <a href="tables.html">tables</a>

<!-- #include src=properties/speak-punctuation.srb -->

<P>This property specifies how punctuation is spoken.  Values have the
following meanings:</p>

<dl>
<dt><strong>code</strong>
<dd>Punctuation such as semicolons,
braces, and so on are to be spoken literally.
<dt><strong>none</strong>
<dd>Punctuation is not to be spoken, but instead rendered
naturally as various pauses.
</dl>

<!-- #include src=properties/speak-date.srb -->


<p>This property controls how dates are spoken.
Values have the following meanings:</p>

<dl>
<dt><strong>mdy</strong>
<dd>Month-Day-Year (common in the United States).
<dt><strong>dmy</strong>
<dd>Day-Month-Year (common in Europe).
<dt><strong>ymd</strong>
<dd>Year-Month-Day.
</dl>

<div class="xml-example"><P>
This property would be useful, for example, when combined with an XML
element used to identify dates, such as:

<pre>
   &lt;PARA&gt;The campaign started on &lt;DATE value="1874-10-21"/&gt;
    and finished &lt;DATE value="1874-10-28/"&gt;&lt;/PARA&gt;
</pre>
</div>

<!-- #include src=properties/speak-numeral.srb -->

<p>This property controls how numerals are spoken.  Values have the
following meanings:</P>

<dl>
<dt><strong>digits</strong>
<dd>Speak the numeral as individual digits. Thus, "237" is spoken
"Two Three Seven".
<dt><strong>continuous</strong>
<dd>Speak the numeral as a full number. Thus, "237" is spoken
"Two hundred thirty seven". Word representations are language-dependent.
<dt><strong>none</strong>
<dd>[What does this mean?]
</dl>

<!-- Needs completion! -IJ -->

<!-- #include src=properties/speak-time.srb -->

<p>This property controls how times are spoken.  Values have the
following meanings:</p>

<dl>
<dt><strong>24</strong>
<dd>Use the 24-hour time system.
<dt><strong>12</strong>
<dd>Use the 12-hour am/pm time system.
<dt><strong>none</strong>
<dd>[What does this mean?]
</dl>

<!-- Needs completion! -IJ -->

<P>When used in combination with the <span
class="propinst-speak-date">'speak-date'</span> property, this allows
elements with an attribute containing an ISO 8601 format date/time
attribute to be presented in a flexible manner.

</BODY>
</HTML>