Skip to content

Commit d9f1d8b

Browse files
committed
list fixes
1 parent d94c30c commit d9f1d8b

2 files changed

Lines changed: 100 additions & 121 deletions

File tree

css3-speech/Overview.html

Lines changed: 61 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -90,13 +90,13 @@
9090

9191
<h1 id=top>CSS Speech Module</h1>
9292

93-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 26 May 2011</h2>
93+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 06 June 2011</h2>
9494

9595
<dl>
9696
<dt>This version:
9797

9898
<dd>
99-
<!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110526">http://www.w3.org/TR/2011/ED-css3-speech-20110526/</a>-->
99+
<!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110606">http://www.w3.org/TR/2011/ED-css3-speech-20110606/</a>-->
100100
<a
101101
href="http://dev.w3.org/csswg/css3-speech">http://dev.w3.org/csswg/css3-speech</a>
102102

@@ -1740,8 +1740,10 @@ <h3 id=voice-props-voice-family><span class=secno>8.1. </span>The &lsquo;<a
17401740
<p>The &lsquo;<a href="#voice-family"><code
17411741
class=property>voice-family</code></a>&rsquo; property specifies a
17421742
comma-separated, prioritized list of values that designate speech
1743-
synthesis voices (analogous to &lsquo;<code
1744-
class=property>font-family</code>&rsquo; in visual style sheets).
1743+
synthesis voices (analogous to &lsquo;<code class=css><a
1744+
href="#font-family-def"><code
1745+
class=property>font-family</code></a></code>&rsquo; in visual style
1746+
sheets).
17451747

17461748
<p class=note> Note that the functionality provided by this property is
17471749
related to the <a
@@ -2400,19 +2402,21 @@ <h3 id=mixing-props-voice-duration><span class=secno>9.1. </span>The
24002402

24012403
<h2 id=lists><span class=secno>10. </span>List items and counters styles</h2>
24022404

2403-
<p>The &lsquo;<code class=property>list-style-type</code>&rsquo; property
2404-
of <a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> specifies
2405-
three types of list item markers: glyphs, numbering systems, and
2406-
alphabetic systems. The values allowed for this property are also used for
2407-
the counter() function of the &lsquo;<a href="#content-def"><code
2405+
<p>The &lsquo;<code class=css><a href="#list-style-type-def"> <code
2406+
class=property>list-style-type</code></a></code>&rsquo; property of <a
2407+
href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> specifies three
2408+
types of list item markers: glyphs, numbering systems, and alphabetic
2409+
systems. The values allowed for this property are also used for the
2410+
counter() function of the &lsquo;<a href="#content-def"><code
24082411
class=property>content</code></a>&rsquo; property. The CSS Speech module
24092412
defines how to render these styles in the aural dimension, using speech
2410-
synthesis. The &lsquo;<code class=property>list-style-image</code>&rsquo;
2411-
property of <a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
2412-
is ignored, and instead the &lsquo;<code
2413-
class=property>list-style-type</code>&rsquo; is used (if present). When no
2414-
list style is provided, the presentation of list items in the aural
2415-
dimension is not specified by the CSS Speech module.
2413+
synthesis. The &lsquo;<code class=css><a
2414+
href="#list-style-image-def"><code
2415+
class=property>list-style-image</code></a></code>&rsquo; property of <a
2416+
href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> is ignored, and
2417+
instead the &lsquo;<code class=css><a href="#list-style-type-def"><code
2418+
class=property>list-style-type</code></a></code>&rsquo; is used (if
2419+
present).
24162420

24172421
<p class=note> Note that the working draft of the CSS Lists module <a
24182422
href="#CSS3LIST" rel=biblioentry>[CSS3LIST]<!--{{CSS3LIST}}--></a>
@@ -2424,64 +2428,48 @@ <h2 id=lists><span class=secno>10. </span>List items and counters styles</h2>
24242428
<dt> <strong>disc, circle, square</strong>
24252429

24262430
<dd>
2427-
<p> These list item styles are spoken as the equivalent word for the
2428-
shape, in the user's language.</p>
2431+
<p> For these list item styles, the user-agent defines (possibly based on
2432+
user preferences) what equivalent phrase is spoken or what audio cue is
2433+
played. List items with graphical bullets are therefore announced
2434+
appropriately in an implementation-dependent manner.</p>
24292435

2430-
<dt> <strong>decimal</strong>
2436+
<dt> <strong>decimal, decimal-leading-zero, lower-roman, upper-roman,
2437+
georgian, armenian</strong>
24312438

24322439
<dd>
2433-
<p> This list item style corresponds to numbers beginning from 1. These
2434-
numbers are spoken as-is by the speech synthesizer, in the user's
2435-
language.</p>
2436-
2437-
<dt> <strong>decimal-leading-zero</strong>
2440+
<p> For these list item styles, corresponding numbers are spoken as-is by
2441+
the speech synthesizer, and may be complemented with additional audio
2442+
cues or speech phrases in the document's language (i.e. with the same
2443+
TTS voice used to speak the list item content) in order to indicate the
2444+
presence of list items. For example, when using the English language,
2445+
the list item counter could be prefixed with the word "Item", which
2446+
would result in list items being announced with "Item one", "Item two",
2447+
etc.</p>
2448+
2449+
<dt> <strong>lower-latin, lower-alpha, upper-latin, upper-alpha,
2450+
lower-greek</strong>
24382451

24392452
<dd>
2440-
<p> This list item style corresponds to numbers that are padded with
2441-
initial zeros (e.g., 01, 02, 03, ..., 98, 99). These numbers are spoken
2442-
as individual digits, in the user's language (i.e. just as if the
2443-
&lsquo;<a href="#speak-as"><code
2444-
class=property>speak-as</code></a>&rsquo; property had been applied with
2445-
the &lsquo;<code class=property>digits</code>&rsquo; value).</p>
2446-
2447-
<dt> <strong>lower-roman, upper-roman</strong>
2448-
2449-
<dd>
2450-
<p> These list item styles corresponds to numbers written using the roman
2451-
numeral notation (e.g. [i, ii, iii, iv, v, etc.] or [I, II, III, IV, V,
2452-
etc.]). These numbers are spoken as their &lsquo;<code
2453-
class=property>decimal</code>&rsquo; equivalents, but the speech
2454-
synthesizer produces an additional cue in the user's language to
2455-
indicate the lower or upper roman style.</p>
2456-
2457-
<dt> <strong>lower-latin, lower-alpha, upper-latin, upper-alpha</strong>
2458-
2459-
<dd>
2460-
<p> These list item styles correspond to ASCII alphabetical characters
2461-
(e.g. [a, b, c, ... z] or [A, B, C, ... Z]). They are spoken as-is by
2462-
the speech synthesizer, using the document language.</p>
2463-
2464-
<dt> <strong>lower-greek</strong>
2465-
2466-
<dd>
2467-
<p> This list item style correspond to classical Greek characters (e.g.
2468-
[α, β, γ, ...]). They are spoken using speech synthesis as their
2469-
equivalent "alpha", "beta", "gamma" words, in the user's language.</p>
2470-
2471-
<dt> <strong>georgian, armenian</strong>
2472-
2473-
<dd>
2474-
<p> These list item styles are spoken as numeral equivalents (see
2475-
&lsquo;<code class=property>decimal</code>&rsquo;).</p>
2453+
<p> These list item styles are spelled out letter-by-letter by the speech
2454+
synthesizer, in the document language (i.e. with the same TTS voice used
2455+
to speak the list item content). For example, &lsquo;<code
2456+
class=property>lower-greek</code>&rsquo; in English would be read out as
2457+
"alpha", "beta", "gamma", etc. Conversely, &lsquo;<code
2458+
class=property>upper-latin</code>&rsquo; in French would be read out as
2459+
/a/, /be/, /se/, etc. (phonetic notation)</p>
24762460
</dl>
24772461

2478-
<p class=note> Note that screen-readers usually announce well-defined
2479-
structures such as lists or tables regardless of whether special
2480-
information has been authored within the content. These navigation aids
2481-
are typically implementation-dependent. User-agents that support the CSS
2482-
Speech module are expected to handle author-provided aural styles (which
2483-
may or may not announce special structures) whilst continuing to provide
2484-
implementation-specific navigation cues.
2462+
<p class=note> Note that screen-readers tend to generate complementary
2463+
speech cues or audio icons to announce well-defined structures such as
2464+
lists or tables. These navigation aids are implementation-dependent and
2465+
may not necessarily reflect authored content. User-agents that support the
2466+
CSS Speech module are naturally expected to handle author-provided aural
2467+
styles as per the CSS <a href="#cascade-def">cascade</a> mechanism, and
2468+
may continue to provide additional implementation-specific content
2469+
navigation cues for use-cases that are not covered by this specification,
2470+
or as long as this doesn't create redundancies or inconsistencies in the
2471+
speech / audio output (for example: duplicated or different list item
2472+
numbering scheme).
24852473

24862474
<h2 id=pronunciation><span class=secno>11. </span> Pronunciation, phonemes</h2>
24872475

@@ -2976,6 +2964,11 @@ <h2 class=no-num id=property-index>Appendix A &mdash; Property index</h2>
29762964
specifications:
29772965

29782966
<ul>
2967+
<li> <dfn id=cascade-def> <a
2968+
href="http://www.w3.org/TR/CSS21/cascade.html#cascade"> cascade
2969+
</a></dfn> &nbsp;&nbsp; <a href="#CSS21"
2970+
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
2971+
29792972
<li> <dfn id=box-model-def> <a href="http://www.w3.org/TR/CSS21/box.html">
29802973
visual box model </a></dfn> &nbsp;&nbsp; <a href="#CSS21"
29812974
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
@@ -3022,6 +3015,8 @@ <h2 class=no-num id=index>Appendix B &mdash; Index</h2>
30223015

30233016
<li>border, <a href="#border-def" title=border><strong>#</strong></a>
30243017

3018+
<li>cascade, <a href="#cascade-def" title=cascade><strong>#</strong></a>
3019+
30253020
<li>content, <a href="#content-def" title=content><strong>#</strong></a>
30263021

30273022
<li>cue, <a href="#cue" title=cue><strong>7.2.</strong></a>

css3-speech/Overview.src.html

Lines changed: 39 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1382,7 +1382,8 @@ <h3 id="voice-props-voice-family">The 'voice-family' property</h3>
13821382
</tbody>
13831383
</table>
13841384
<p>The 'voice-family' property specifies a comma-separated, prioritized list of values that
1385-
designate speech synthesis voices (analogous to 'font-family' in visual style sheets).</p>
1385+
designate speech synthesis voices (analogous to '<a href="#font-family-def"><code
1386+
class="property">font-family</code></a>' in visual style sheets).</p>
13861387
<p class="note"> Note that the functionality provided by this property is related to the <a
13871388
href="http://www.w3.org/TR/speech-synthesis11/#edef_voice"><code>voice</code> element</a>
13881389
from the SSML markup language [[!SSML]]. </p>
@@ -1988,13 +1989,15 @@ <h3 id="mixing-props-voice-duration">The 'voice-duration' property</h3>
19881989
</dd>
19891990
</dl>
19901991
<h2 id="lists">List items and counters styles</h2>
1991-
<p>The 'list-style-type' property of [[!CSS21]] specifies three types of list item markers:
1992-
glyphs, numbering systems, and alphabetic systems. The values allowed for this property are
1993-
also used for the counter() function of the 'content' property. The CSS Speech module defines
1994-
how to render these styles in the aural dimension, using speech synthesis. The
1995-
'list-style-image' property of [[!CSS21]] is ignored, and instead the 'list-style-type' is
1996-
used (if present). When no list style is provided, the presentation of list items in the aural
1997-
dimension is not specified by the CSS Speech module. </p>
1992+
<p>The '<a href="#list-style-type-def">
1993+
<code class="property">list-style-type</code></a>' property of [[!CSS21]] specifies three
1994+
types of list item markers: glyphs, numbering systems, and alphabetic systems. The values
1995+
allowed for this property are also used for the counter() function of the 'content' property.
1996+
The CSS Speech module defines how to render these styles in the aural dimension, using speech
1997+
synthesis. The '<a href="#list-style-image-def"><code class="property"
1998+
>list-style-image</code></a>' property of [[!CSS21]] is ignored, and instead the '<a
1999+
href="#list-style-type-def"><code class="property">list-style-type</code></a>' is used (if
2000+
present). </p>
19982001
<p class="note"> Note that the working draft of the CSS Lists module [[CSS3LIST]] contains new
19992002
features which are not yet supported in this version of the CSS Speech module. Support for
20002003
these features will be added later, when the CSS Lists draft stabilizes.</p>
@@ -2003,63 +2006,40 @@ <h2 id="lists">List items and counters styles</h2>
20032006
<strong>disc, circle, square</strong>
20042007
</dt>
20052008
<dd>
2006-
<p> These list item styles are spoken as the equivalent word for the shape, in the user's
2007-
language.</p>
2009+
<p> For these list item styles, the user-agent defines (possibly based on user preferences)
2010+
what equivalent phrase is spoken or what audio cue is played. List items with graphical
2011+
bullets are therefore announced appropriately in an implementation-dependent manner. </p>
20082012
</dd>
20092013
<dt>
2010-
<strong>decimal</strong>
2014+
<strong>decimal, decimal-leading-zero, lower-roman, upper-roman, georgian, armenian</strong>
20112015
</dt>
20122016
<dd>
2013-
<p> This list item style corresponds to numbers beginning from 1. These numbers are spoken
2014-
as-is by the speech synthesizer, in the user's language.</p>
2017+
<p> For these list item styles, corresponding numbers are spoken as-is by the speech
2018+
synthesizer, and may be complemented with additional audio cues or speech phrases in the
2019+
document's language (i.e. with the same TTS voice used to speak the list item content) in
2020+
order to indicate the presence of list items. For example, when using the English
2021+
language, the list item counter could be prefixed with the word "Item", which would result
2022+
in list items being announced with "Item one", "Item two", etc. </p>
20152023
</dd>
20162024
<dt>
2017-
<strong>decimal-leading-zero</strong>
2025+
<strong>lower-latin, lower-alpha, upper-latin, upper-alpha, lower-greek</strong>
20182026
</dt>
20192027
<dd>
2020-
<p> This list item style corresponds to numbers that are padded with initial zeros (e.g.,
2021-
01, 02, 03, ..., 98, 99). These numbers are spoken as individual digits, in the user's
2022-
language (i.e. just as if the 'speak-as' property had been applied with the 'digits'
2023-
value).</p>
2024-
</dd>
2025-
<dt>
2026-
<strong>lower-roman, upper-roman</strong>
2027-
</dt>
2028-
<dd>
2029-
<p> These list item styles corresponds to numbers written using the roman numeral notation
2030-
(e.g. [i, ii, iii, iv, v, etc.] or [I, II, III, IV, V, etc.]). These numbers are spoken as
2031-
their 'decimal' equivalents, but the speech synthesizer produces an additional cue in the
2032-
user's language to indicate the lower or upper roman style.</p>
2033-
</dd>
2034-
<dt>
2035-
<strong>lower-latin, lower-alpha, upper-latin, upper-alpha</strong>
2036-
</dt>
2037-
<dd>
2038-
<p> These list item styles correspond to ASCII alphabetical characters (e.g. [a, b, c, ...
2039-
z] or [A, B, C, ... Z]). They are spoken as-is by the speech synthesizer, using the
2040-
document language. </p>
2041-
</dd>
2042-
<dt>
2043-
<strong>lower-greek</strong>
2044-
</dt>
2045-
<dd>
2046-
<p> This list item style correspond to classical Greek characters (e.g. [α, β, γ, ...]).
2047-
They are spoken using speech synthesis as their equivalent "alpha", "beta", "gamma" words,
2048-
in the user's language. </p>
2049-
</dd>
2050-
<dt>
2051-
<strong>georgian, armenian</strong>
2052-
</dt>
2053-
<dd>
2054-
<p> These list item styles are spoken as numeral equivalents (see 'decimal').</p>
2028+
<p> These list item styles are spelled out letter-by-letter by the speech synthesizer, in
2029+
the document language (i.e. with the same TTS voice used to speak the list item content).
2030+
For example, 'lower-greek' in English would be read out as "alpha", "beta", "gamma", etc.
2031+
Conversely, 'upper-latin' in French would be read out as /a/, /be/, /se/, etc. (phonetic
2032+
notation) </p>
20552033
</dd>
20562034
</dl>
2057-
<p class="note"> Note that screen-readers usually announce well-defined structures such as lists
2058-
or tables regardless of whether special information has been authored within the content.
2059-
These navigation aids are typically implementation-dependent. User-agents that support the CSS
2060-
Speech module are expected to handle author-provided aural styles (which may or may not
2061-
announce special structures) whilst continuing to provide implementation-specific navigation
2062-
cues.</p>
2035+
<p class="note"> Note that screen-readers tend to generate complementary speech cues or audio
2036+
icons to announce well-defined structures such as lists or tables. These navigation aids are
2037+
implementation-dependent and may not necessarily reflect authored content. User-agents that
2038+
support the CSS Speech module are naturally expected to handle author-provided aural styles as
2039+
per the CSS <a href="#cascade-def">cascade</a> mechanism, and may continue to provide
2040+
additional implementation-specific content navigation cues for use-cases that are not covered
2041+
by this specification, or as long as this doesn't create redundancies or inconsistencies in
2042+
the speech / audio output (for example: duplicated or different list item numbering scheme). </p>
20632043
<h2 id="pronunciation"> Pronunciation, phonemes </h2>
20642044
<p class="note">Note that this entire section is non-normative.</p>
20652045
<p> CSS does not specify how to define the pronunciation (expressed using a well-defined
@@ -2186,6 +2166,10 @@ <h2 class="no-num" id="property-index">Appendix A &mdash; Property index</h2>
21862166
</ul>
21872167
<p>The following definitions are provided by other modules or specifications:</p>
21882168
<ul>
2169+
<li>
2170+
<dfn id="cascade-def">
2171+
<a href="http://www.w3.org/TR/CSS21/cascade.html#cascade"> cascade </a></dfn> &nbsp;&nbsp;
2172+
[[!CSS21]] </li>
21892173
<li>
21902174
<dfn id="box-model-def">
21912175
<a href="http://www.w3.org/TR/CSS21/box.html"> visual box model </a></dfn> &nbsp;&nbsp;

0 commit comments

Comments
 (0)