- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 05 Feb 2011 12:03:31 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech In directory hutz:/tmp/cvs-serv31166 Modified Files: Overview.html Overview.src.html Log Message: removed the "mark" property, as per working group resolution. added the "speakability" property, removed the "none" value for "speak". added the "auto" value for "voice-volume" in order to inherit from "visibility" (just like "speakability" inherits from "display"). Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css3-speech/Overview.html,v retrieving revision 1.19 retrieving revision 1.20 diff -u -d -r1.19 -r1.20 --- Overview.html 22 Jan 2011 12:05:04 -0000 1.19 +++ Overview.html 5 Feb 2011 12:03:29 -0000 1.20 @@ -24,8 +24,6 @@ caption dfn { font-size: 120% } *:target { - color: #000000; - background-color: #F8F8F8; border: 1px dashed #66CC66; } /*]]>*/ @@ -40,13 +38,13 @@ <h1 id=top>CSS3 Speech Module</h1> - <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 22 January + <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 05 February 2011</h2> <dl> <dt>This version: - <dd><!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110122">http://www.w3.org/TR/2011/ED-css3-speech-20110122</a>--> + <dd><!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110205">http://www.w3.org/TR/2011/ED-css3-speech-20110205</a>--> <a href="http://dev.w3.org/csswg/css3-speech">http://dev.w3.org/csswg/css3-speech</a> @@ -164,11 +162,9 @@ CR period if there has not been enough interest from implementers: <ul> - <li><a href="#issue-phonemes">phonemes</a> - - <li><a href="#issue-mark">mark</a> - - <li><a href="#issue-speak_none">speak:none</a> + <li><a href="#issue-phonemes">phonemes</a></li> + <!-- li><a href="#issue-mark">mark</a></li --> + <!-- li><a href="#issue-speak_none">speak:none</a></li --> </ul> <p>The CSS WG maintains an <a @@ -192,12 +188,14 @@ class=property>voice-balance</code>’</a> <li><a href="#speaking-props"><span class=secno>5. </span>Speaking - properties: ‘<code class=property>speak</code>’</a> + properties: ‘<code class=property>speakability</code>’, + ‘<code class=property>speak</code>’</a> <li><a href="#pause-props"><span class=secno>6. </span>Pause properties: ‘<code class=property>pause-before</code>’, ‘<code class=property>pause-after</code>’ and ‘<code - class=property>pause</code>’, collapsing pauses</a> + class=property>pause</code>’ + <!-- a href="#collapsing">collapsing pauses</a --> </a> <ul class=toc> <li><a href="#collapsing"><span class=secno>6.1. </span>Collapsing pauses</a> @@ -213,12 +211,7 @@ class=property>cue-after</code>’ and ‘<code class=property>cue</code>’</a> - <li><a href="#mark-props"><span class=secno>9. </span>Mark properties: - ‘<code class=property>mark-before</code>’, ‘<code - class=property>mark-after</code>’ and ‘<code - class=property>mark</code>’</a> - - <li><a href="#voice-char-props"><span class=secno>10. </span>Voice + <li><a href="#voice-char-props"><span class=secno>9. </span>Voice characteristic properties: ‘<code class=property>voice-family</code>’, ‘<code class=property>voice-rate</code>’, ‘<code @@ -226,18 +219,18 @@ class=property>voice-pitch-range</code>’ and ‘<code class=property>voice-stress</code>’</a> - <li><a href="#duration-props"><span class=secno>11. </span>Duration + <li><a href="#duration-props"><span class=secno>10. </span>Duration property: ‘<code class=property>voice-duration</code>’</a> - <li><a href="#phonetic-props"><span class=secno>12. </span>Phonetics: + <li><a href="#phonetic-props"><span class=secno>11. </span>Phonetics: ‘<code class=property>phonemes</code>’ and ‘<code class=css>@phonetic-alphabet</code>’</a> <ul class=toc> - <li><a href="#phonetic-alphabet"><span class=secno>12.1. + <li><a href="#phonetic-alphabet"><span class=secno>11.1. </span>@phonetic-alphabet</a> </ul> - <li><a href="#content"><span class=secno>13. </span>Inserted and replaced + <li><a href="#content"><span class=secno>12. </span>Inserted and replaced content <!-- div class="issue"> <p>ISSUE: should there be a CSS equivalent to the SSML <sub> element? This gives the author the means to replace one string with @@ -400,8 +393,8 @@ <p><img alt="A graph depicting the aural 'box' model." id=aural-box src=aural-box.png> - <p>where <dfn id=element>element</dfn> is the selected element to which the - properties from the Speech Module apply. + <p>where <dfn id=ltelementgt><element></dfn> is the selected element + to which the properties from the Speech Module apply. <h2 id=mixing-props><span class=secno>4. </span>Mixing properties: ‘<a href="#voice-volume"><code @@ -418,13 +411,13 @@ <tr> <td width="20%"><em>Value:</em> - <td><non-negative number> | <percentage> | silent | x-soft | - soft | medium | loud | x-loud | inherit + <td>auto | <non-negative number> | <percentage> | silent | + x-soft | soft | medium | loud | x-loud | inherit <tr> <td width="20%"><em>Initial:</em> - <td>medium + <td>auto <tr> <td width="20%"><em>Applies to:</em> @@ -460,6 +453,15 @@ <p>Values have the following meanings: <dl> + <dt><strong>auto</strong> + + <dd> Resolves to a used value of ‘<code + class=property>medium</code>’ when the computed value of the + ‘<code class=property>visibility</code>’ property is + ‘<code class=property>visible</code>’ (see <a href="#CSS3BOX" + rel=biblioentry>[CSS3BOX]<!--{{CSS3BOX}}--></a>), otherwise resolves to a + used value of ‘<code class=property>silent</code>’. + <dt><strong><non-negative number></strong> <dd>An integer or floating point number in the range ‘<code @@ -497,6 +499,20 @@ (speakers, headphones), and the environment (in car, home theater, library) and personal preferences. + <p>Note the difference between an element whose ‘<a + href="#voice-volume"><code class=property>voice-volume</code></a>’ + property has a value of ‘<code class=property>silent</code>’ + and an element whose ‘<a href="#speakability"><code + class=property>speakability</code></a>’ property has the value + ‘<code class=property>none</code>’. 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 (note that descendants may override + the ‘<a href="#voice-volume"><code + class=property>voice-volume</code></a>’ value and may therefore + generate audio output). The latter requires no time and is not rendered in + the aural dimension (including its descendants, which cannot override the + inherited ‘<code class=property>none</code>’ value). + <table class=propdef summary="name: syntax"> <tbody> <tr> @@ -597,7 +613,9 @@ <em>does</em> apply to <a href="#cue-props">audio cues</a>. <h2 id=speaking-props><span class=secno>5. </span>Speaking properties: - ‘<a href="#speak"><code class=property>speak</code></a>’</h2> + ‘<a href="#speakability"><code + class=property>speakability</code></a>’, ‘<a + href="#speak"><code class=property>speak</code></a>’</h2> <!-- <p>An additional speech property, speak-header, is described in the CSS module covering tables.</p> --> @@ -606,18 +624,17 @@ <tr> <td>Name: - <td><dfn id=speak>speak</dfn> + <td><dfn id=speakability>speakability</dfn> <tr> <td width="20%"><em>Value:</em> - <td>none | normal | spell-out | digits | literal-punctuation | - no-punctuation | inherit + <td>auto | none | normal | inherit <tr> <td width="20%"><em>Initial:</em> - <td>normal + <td>auto <tr> <td width="20%"><em>Applies to:</em> @@ -640,43 +657,104 @@ <td>speech </table> - <p>This property specifies whether text will be rendered aurally and if so, - in what manner. + <p>This property specifies whether text will be rendered aurally. <p>Values have the following meanings: <dl> + <dt><strong>auto</strong> + + <dd> Resolves to a used value of ‘<code + class=property>none</code>’ when the computed value of the + ‘<a href="#display-def"><code + class=property>display</code></a>’ property is ‘<code + class=property>none</code>’ (see <a href="#CSS3BOX" + rel=biblioentry>[CSS3BOX]<!--{{CSS3BOX}}--></a>), otherwise resolves to a + used value of ‘<code class=property>normal</code>’. Note that + although the ‘<code class=property>none</code>’ value of the + ‘<a href="#display-def"><code + class=property>display</code></a>’ property cannot be overridden by + descendants of the affected element, the ‘<code + class=property>auto</code>’ value of ‘<a + href="#speakability"><code class=property>speakability</code></a>’ + can however be overridden by either of ‘<code + class=property>none</code>’ or ‘<code + class=property>normal</code>’. In the case of ‘<code + class=property>normal</code>’, this would result in descendants + being rendered in the aural dimension even though they would not rendered + in the visual space. To ensure that an element and its descendants do not + get rendered in the aural dimension, use the ‘<code + class=property>none</code>’ value for the ‘<a + href="#speakability"><code class=property>speakability</code></a>’ + property. Also note that the value of the ‘<code + class=property>visibility</code>’ property (see <a href="#CSS3BOX" + rel=biblioentry>[CSS3BOX]<!--{{CSS3BOX}}--></a>) may affect the computed + value of ‘<a href="#voice-volume"><code + class=property>voice-volume</code></a>’, but do not affect the + ‘<a href="#speakability"><code + class=property>speakability</code></a>’ property. + <dt><strong>none</strong> - <dd>Suppresses aural rendering so that the element requires no time to - render. Note, however, that descendants may override this value and will - be spoken. (To be sure to suppress rendering of an element and its - descendants, use the ‘<a href="#display-def"><code - class=property>display</code></a>’ property <a href="#CSS3BOX" - rel=biblioentry>[CSS3BOX]<!--{{CSS3BOX}}--></a>). - <p class=issue id="issue-speak_none">ISSUE: ‘<code - class=css>speak:none</code>’ is arguably unnecessary, as it can be - fully realized using ‘<code class=css>display:none</code>’. - The function of ‘<a href="#speak"><code - class=property>speak</code></a>’ should primarily be to specify - *how* to speak text content, not to control *if* it should be spoken. - There is also a concern about accessibility good practices, in - particular with regards to whether this specification should allow - authors to "hide" text in the aural dimension, when it is actually - visible on the graphical canvas. Note that "display:none" is different - than "visibility:hidden". The former effectively ‘<code - class=property>deactivates</code>’ an element (so to speak) - whereas the latter is more similar to "voice-volume:0%". In other words, - "visibility:hidden" preserves the visual space that the element would - normally occupy if it was visible (resulting in an empty or transparent - area that still takes part in the page layout), and conversely - "voice-volume:0%" results in an audio silence lasting as long as the - duration of non-silent TTS playback. There is a <a - href="http://lists.w3.org/Archives/Public/www-style/2011Jan/0355.html">related - discussion</a> on the public mailing-list.</p> + <dd> This value causes an element (including pauses, cues, rests and + actual content) to not be rendered (i.e., the element has no effect in + the aural dimension). Descendant elements do not get rendered either; + this behavior cannot be overridden by setting the ‘<a + href="#speakability"><code class=property>speakability</code></a>’ + property on the descendants. <dt><strong>normal</strong> + <dd> The element is rendered aurally. Note that this property value can be + overridden by descendant elements, using either of "auto" or "none". + </dl> + + <table class=propdef summary="name: syntax"> + <tbody> + <tr> + <td>Name: + + <td><dfn id=speak>speak</dfn> + + <tr> + <td width="20%"><em>Value:</em> + + <td>normal | spell-out | digits | literal-punctuation | no-punctuation | + inherit + + <tr> + <td width="20%"><em>Initial:</em> + + <td>normal + + <tr> + <td width="20%"><em>Applies to:</em> + + <td>all elements + + <tr> + <td width="20%"><em>Inherited:</em> + + <td>yes + + <tr> + <td width="20%"><em>Percentages:</em> + + <td>N/A + + <tr> + <td width="20%"><em>Media:</em> + + <td>speech + </table> + + <p>This property specifies in what manner text gets rendered aurally. + + <p>Values have the following meanings: + + <dl> + <dt><strong>normal</strong> + <dd>Uses language-dependent pronunciation rules for rendering an element and its children. Punctuation is not to be spoken, but instead rendered naturally as various pauses. @@ -707,16 +785,6 @@ punctuation is not to be spoken nor rendered as various pauses. </dl> - <p>Note the difference between an element whose ‘<a - href="#voice-volume"><code class=property>voice-volume</code></a>’ - property has a value of ‘<code class=property>silent</code>’ - and an element whose ‘<a href="#speak"><code - class=property>speak</code></a>’ property has the value ‘<code - class=property>none</code>’. 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. The latter requires no time and is not rendered - (though its descendants may be). - <p>Speech synthesizers are knowledgeable about what is and what is not a number. The ‘<a href="#speak"><code class=property>speak</code></a>’ property gives authors the means to @@ -728,8 +796,8 @@ href="#pause-before"><code class=property>pause-before</code></a>’, ‘<a href="#pause-after"><code class=property>pause-after</code></a>’ and ‘<a - href="#pause"><code class=property>pause</code></a>’, <a - href="#collapsing">collapsing pauses</a></h2> + href="#pause"><code class=property>pause</code></a>’ + <!-- a href="#collapsing">collapsing pauses</a --></h2> <table class=propdef summary="name: syntax"> <tbody> @@ -1384,201 +1452,172 @@ techniques</a> to insert additional auditory cues based on text instead of audio icons.</p> <!-- Add something here about gc --> + <!-- h2 id="mark-props"><span class="secno">9. </span>Mark properties: +‘<code class=property>mark-before</code>’, +‘<code class=property>mark-after</code>’ and +‘<code class=property>mark</code>’</h2> - <h2 id=mark-props><span class=secno>9. </span>Mark properties: ‘<a - href="#mark-before"><code class=property>mark-before</code></a>’, - ‘<a href="#mark-after"><code - class=property>mark-after</code></a>’ and ‘<a - href="#mark"><code class=property>mark</code></a>’</h2> - - <table class=propdef summary="name: syntax"> - <tbody> - <tr> - <td>Name: - - <td><dfn id=mark-before>mark-before</dfn> - - <tr> - <td width="20%"><em>Value:</em> - - <td><string> - - <tr> - <td width="20%"><em>Initial:</em> - - <td>none - - <tr> - <td width="20%"><em>Applies to:</em> - - <td>all elements - - <tr> - <td width="20%"><em>Inherited:</em> - - <td>no - - <tr> - <td width="20%"><em>Percentages:</em> - - <td>N/A - - <tr> - <td width="20%"><em>Media:</em> - - <td>speech - </table> - - <p> - - <table class=propdef summary="name: syntax"> - <tbody> - <tr> - <td>Name: - - <td><dfn id=mark-after>mark-after</dfn> - - <tr> - <td width="20%"><em>Value:</em> - - <td><string> - - <tr> - <td width="20%"><em>Initial:</em> - - <td>none - - <tr> - <td width="20%"><em>Applies to:</em> - - <td>all elements - - <tr> - <td width="20%"><em>Inherited:</em> - - <td>no - - <tr> - <td width="20%"><em>Percentages:</em> - - <td>N/A - - <tr> - <td width="20%"><em>Media:</em> - - <td>speech - </table> - - <p>The mark properties allow named markers to be attached to the audio - stream. For compatibility with SSML, this must conform to the <a - href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#token">xsd:token</a> - datatype as defined in XML Schema. Synthesis processors must do one or - both of the following when encountering a mark: +<table class="propdef" summary="name: syntax"> +<tbody> +<tr> +<td>Name:</td> +<td><dfn id="mark-before">mark-before</dfn></td> +</tr> +<tr> +<td width="20%"><em>Value:</em></td> +<td><string></td> +</tr> +<tr> +<td width="20%"><em>Initial:</em></td> +<td>none</td> +</tr> +<tr> +<td width="20%"><em>Applies to:</em></td> +<td>all elements</td> +</tr> +<tr> +<td width="20%"><em>Inherited:</em></td> +<td>no</td> +</tr> +<tr> +<td width="20%"><em>Percentages:</em></td> +<td>N/A</td> +</tr> +<tr> +<td width="20%"><em>Media:</em></td> +<td>speech</td> +</tr> +</tbody> +</table> - <ul> - <li>Inform the hosting environment with the value of the mark's name with - information allowing the platform to retrieve the corresponding position - in the rendered output. +<p> </p> - <li>When audio output of the SSML document reaches the mark, issue an - event that includes the required name attribute of the element. The - hosting environment defines the destination of the event. - </ul> +<table class="propdef" summary="name: syntax"> +<tbody> +<tr> +<td>Name:</td> +<td><dfn id="mark-after">mark-after</dfn></td> +</tr> +<tr> +<td width="20%"><em>Value:</em></td> +<td><string></td> +</tr> +<tr> +<td width="20%"><em>Initial:</em></td> +<td>none</td> +</tr> +<tr> +<td width="20%"><em>Applies to:</em></td> +<td>all elements</td> +</tr> +<tr> +<td width="20%"><em>Inherited:</em></td> +<td>no</td> +</tr> +<tr> +<td width="20%"><em>Percentages:</em></td> +<td>N/A</td> +</tr> +<tr> +<td width="20%"><em>Media:</em></td> +<td>speech</td> +</tr> +</tbody> +</table> - <p>The mark properties have no audible effect on the speech and instead - just serve to mark points in the stream. +<p>The mark properties allow named markers to be attached to the +audio stream. For compatibility with SSML, this must conform to the +<a href= +"http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#token">xsd:token</a> +datatype as defined in XML Schema. Synthesis processors must do one +or both of the following when encountering a mark:</p> - <p>Values have the following meanings: +<ul> +<li>Inform the hosting environment with the value of the mark's +name with information allowing the platform to retrieve the +corresponding position in the rendered output.</li> +<li>When audio output of the SSML document reaches the mark, +issue an event that includes the required name attribute of +the element. The hosting environment defines the destination +of the event.</li> +</ul> - <dl> - <dt><strong><string></strong> +<p>The mark properties have no audible effect on the speech +and instead just serve to mark points in the stream.</p> + +<p>Values have the following meanings:</p> - <dd>A string to be used as the name of the mark. - </dl> +<dl> +<dt><strong><string></strong></dt> - <p>A good way of adding the marking properties could be by means of using - the attr() function. +<dd>A string to be used as the name of the mark.</dd> +</dl> - <div class=example> - <p>Examples:</p> +<p>A good way of adding the marking properties could be by +means of using the attr() function.</p> - <pre> +<div class="example"> +<p>Examples:</p> +<pre> h1 {mark-before: "section"} p {mark-before: attr(id) } </pre> - </div> - - <table class=propdef summary="name: syntax"> - <tbody> - <tr> - <td>Name: - - <td><dfn id=mark>mark</dfn> - - <tr> - <td width="20%"><em>Value:</em> - - <td>[ <‘<a href="#mark-before"><code - class=property>mark-before</code></a>’> || <‘<a - href="#mark-after"><code - class=property>mark-after</code></a>’> ] - - <tr> - <td width="20%"><em>Initial:</em> - - <td>not defined for shorthand properties - - <tr> - <td width="20%"><em>Applies to:</em> - - <td>all elements - - <tr> - <td width="20%"><em>Inherited:</em> - - <td>no - - <tr> - <td width="20%"><em>Percentages:</em> - - <td>N/A - - <tr> - <td width="20%"><em>Media:</em> +</div> - <td>speech - </table> +<table class="propdef" summary="name: syntax"> +<tbody> +<tr> +<td>Name:</td> +<td><dfn id="mark">mark</dfn></td> +</tr> +<tr> +<td width="20%"><em>Value:</em></td> +<td>[ <‘<code class=property>mark-before</code>’> || <‘<code class=property>mark-after</code>’> ]</td> +</tr> +<tr> +<td width="20%"><em>Initial:</em></td> +<td>not defined for shorthand properties</td> +</tr> +<tr> +<td width="20%"><em>Applies to:</em></td> +<td>all elements</td> +</tr> +<tr> +<td width="20%"><em>Inherited:</em></td> +<td>no</td> +</tr> +<tr> +<td width="20%"><em>Percentages:</em></td> +<td>N/A</td> +</tr> +<tr> +<td width="20%"><em>Media:</em></td> +<td>speech</td> +</tr> +</tbody> +</table> - <p>The ‘<a href="#mark"><code class=property>mark</code></a>’ - property is a shorthand for setting ‘<a href="#mark-before"><code - class=property>mark-before</code></a>’ and ‘<a - href="#mark-after"><code class=property>mark-after</code></a>’. If - two values are given the first value is ‘<a - href="#mark-before"><code class=property>mark-before</code></a>’ and - the second is ‘<a href="#mark-after"><code - class=property>mark-after</code></a>’. If only one value is given, - it applies to both properties. +<p>The ‘<code class=property>mark</code>’ property is a shorthand for setting ‘<code class=property>mark-before</code>’ +and ‘<code class=property>mark-after</code>’. If two values are given the first value is +‘<code class=property>mark-before</code>’ and the second is ‘<code class=property>mark-after</code>’. If only one value +is given, it applies to both properties.</p> - <div class=example> - <p>The following two rules are equivalent:</p> +<div class="example"> +<p>The following two rules are equivalent:</p> - <pre> -div {mark-before: "start"; mark-after: "end" }<br> +<pre> +div {mark-before: "start"; mark-after: "end" }<br /> div {mark: "start" "end" } -</pre> - </div> +</pre></div> - <p class=issue id=issue-mark>ISSUE: in SSML, the ‘<a - href="#mark"><code class=property>mark</code></a>’ element acts as a - destination anchor and as a mean to raise an event when the point is - reached within the speech stream. This functionality arguably isn't purely - of stylistic nature (if at all), so it is judged "at risk" of being - removed from this specification draft. There is a <a - href="http://lists.w3.org/Archives/Public/www-style/2010Dec/0239.html">related - discussion</a> on the public mailing-list. +<p class="issue" id="issue-mark">ISSUE: in SSML, the ‘<code class=property>mark</code>’ element acts as a destination anchor +and as a mean to raise an event when the point is reached within the speech stream. +This functionality arguably isn't purely of stylistic nature (if at all), so it is judged "at risk" of being removed from this specification draft. +There is a <a href="http://lists.w3.org/Archives/Public/www-style/2010Dec/0239.html">related discussion</a> on the public mailing-list. +</p --> - <h2 id=voice-char-props><span class=secno>10. </span>Voice characteristic + <h2 id=voice-char-props><span class=secno>9. </span>Voice characteristic properties: ‘<a href="#voice-family"><code class=property>voice-family</code></a>’, ‘<a href="#voice-rate"><code class=property>voice-rate</code></a>’, @@ -2009,7 +2048,7 @@ phrase "going to" is reduced it may be spoken as "gonna". </dl> - <h2 id=duration-props><span class=secno>11. </span>Duration property: + <h2 id=duration-props><span class=secno>10. </span>Duration property: ‘<a href="#voice-duration"><code class=property>voice-duration</code></a>’</h2> @@ -2069,7 +2108,7 @@ positive numbers are allowed.</p> </dl> - <h2 id=phonetic-props><span class=secno>12. </span>Phonetics: ‘<a + <h2 id=phonetic-props><span class=secno>11. </span>Phonetics: ‘<a href="#phonemes"><code class=property>phonemes</code></a>’ and <a href="#phonetic-alphabet">‘<code class=css>@phonetic-alphabet</code>’</a></h2> @@ -2132,7 +2171,7 @@ href="http://lists.w3.org/Archives/Public/www-style/2011Jan/0248.html">related discussion</a> on the public mailing-list. - <h3 id=phonetic-alphabet><span class=secno>12.1. </span>@phonetic-alphabet</h3> + <h3 id=phonetic-alphabet><span class=secno>11.1. </span>@phonetic-alphabet</h3> <p> A phonetic alphabet is a collection of symbols that represent the sounds of one or more human languages. The default alphabet for the @@ -2177,7 +2216,7 @@ to my mind as a widely used ASCII alternative to IPA, but then: SAMPA is language dependent, and it might be better to have X-SAMPA.</p --> - <h2 id=content><span class=secno>13. </span>Inserted and replaced content + <h2 id=content><span class=secno>12. </span>Inserted and replaced content <!-- div class="issue"> <p>ISSUE: should there be a CSS equivalent to the SSML <sub> element? This gives the author the means to replace one string with @@ -2436,52 +2475,6 @@ <td>speech <tr valign=baseline> - <td><a class=property href="#mark">mark</a> - - <td>[ <‘mark-before’> || - <‘mark-after’> ] - - <td>not defined for shorthand properties - - <td>all elements - - <td>no - - <td>N/A - - <td>speech - - <tr valign=baseline> - <td><a class=property href="#mark-after">mark-after</a> - - <td><string> - - <td>none - - <td>all elements - - <td>no - - <td>N/A - - <td>speech - - <tr valign=baseline> - <td><a class=property href="#mark-before">mark-before</a> - - <td><string> - - <td>none - - <td>all elements - - <td>no - - <td>N/A - - <td>speech - - <tr valign=baseline> <td><a class=property href="#pause">pause</a> <td>[ <‘pause-before’> || @@ -2595,8 +2588,8 @@ <tr valign=baseline> <td><a class=property href="#speak">speak</a> - <td>none | normal | spell-out | digits | literal-punctuation | - no-punctuation | inherit + <td>normal | spell-out | digits | literal-punctuation | no-punctuation | + inherit <td>normal @@ -2609,6 +2602,21 @@ <td>speech <tr valign=baseline> + <td><a class=property href="#speakability">speakability</a> + + <td>auto | none | normal | inherit + + <td>auto + + <td>all elements + + <td>yes + + <td>N/A + + <td>speech + + <tr valign=baseline> <td><a class=property href="#voice-balance">voice-balance</a> <td><number> | left | center | right | leftwards | rightwards | @@ -2723,10 +2731,10 @@ <tr valign=baseline> <td><a class=property href="#voice-volume">voice-volume</a> - <td><non-negative number> | <percentage> | silent | x-soft | - soft | medium | loud | x-loud | inherit + <td>auto | <non-negative number> | <percentage> | silent | + x-soft | soft | medium | loud | x-loud | inherit - <td>medium + <td>auto <td>all elements @@ -2777,15 +2785,8 @@ <li>documents, <a href="#document" title=documents><strong>#</strong></a> - <li>element, <a href="#element" title=element><strong>3.</strong></a> - - <li>mark, <a href="#mark" title=mark><strong>9.</strong></a> - - <li>mark-after, <a href="#mark-after" - title=mark-after><strong>9.</strong></a> - - <li>mark-before, <a href="#mark-before" - title=mark-before><strong>9.</strong></a> + <li><element>, <a href="#ltelementgt" + title="<element>"><strong>3.</strong></a> <li>pause, <a href="#pause" title=pause><strong>6.</strong></a> @@ -2795,7 +2796,7 @@ <li>pause-before, <a href="#pause-before" title=pause-before><strong>6.</strong></a> - <li>phonemes, <a href="#phonemes" title=phonemes><strong>12.</strong></a> + <li>phonemes, <a href="#phonemes" title=phonemes><strong>11.</strong></a> <li>renderer, <a href="#renderer" title=renderer><strong>#</strong></a> @@ -2812,6 +2813,9 @@ <li>speak, <a href="#speak" title=speak><strong>5.</strong></a> + <li>speakability, <a href="#speakability" + title=speakability><strong>5.</strong></a> + <li>style sheet, <a href="#style-sheet" title="style sheet"><strong>#</strong></a> <ul> @@ -2828,22 +2832,22 @@ title=voice-balance><strong>4.</strong></a> <li>voice-duration, <a href="#voice-duration" - title=voice-duration><strong>11.</strong></a> + title=voice-duration><strong>10.</strong></a> <li>voice-family, <a href="#voice-family" - title=voice-family><strong>10.</strong></a> + title=voice-family><strong>9.</strong></a> <li>voice-pitch, <a href="#voice-pitch" - title=voice-pitch><strong>10.</strong></a> + title=voice-pitch><strong>9.</strong></a> <li>voice-pitch-range, <a href="#voice-pitch-range" - title=voice-pitch-range><strong>10.</strong></a> + title=voice-pitch-range><strong>9.</strong></a> <li>voice-rate, <a href="#voice-rate" - title=voice-rate><strong>10.</strong></a> + title=voice-rate><strong>9.</strong></a> <li>voice-stress, <a href="#voice-stress" - title=voice-stress><strong>10.</strong></a> + title=voice-stress><strong>9.</strong></a> <li>voice-volume, <a href="#voice-volume" title=voice-volume><strong>4.</strong></a> @@ -3106,11 +3110,28 @@ <h2 class=no-num id=changes>Appendix F — Changes from previous draft</h2> <ul> + <li>Removed the "mark" property, see the <a + href="http://lists.w3.org/Archives/Public/www-style/2011Feb/0029.html">Working + Group resolution</a> + + <li>Added the ‘<a href="#speakability"><code + class=property>speakability</code></a>’ property and removed the + ‘<code class=property>none</code>’ value of the ‘<a + href="#speak"><code class=property>speak</code></a>’ property, as + per this <a + href="http://lists.w3.org/Archives/Public/www-style/2011Jan/0483.html">discussion</a> + <li>Fixed ‘<a href="#voice-family"><code class=property>voice-family</code></a>’ grammar as per <a href="http://lists.w3.org/Archives/Public/www-style/2010Dec/0231.html">this discussion</a> + <li>Added the default ‘<code class=property>auto</code>’ value + for the ‘<a href="#voice-volume"><code + class=property>voice-volume</code></a>’ property, in order to + inherit aural rendering behavior from the ‘<code + class=property>visibility</code>’ property. + <li>Added "HTML" to "CSS defines aural properties that give control over rendering XML to speech" in the abstract. Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v retrieving revision 1.20 retrieving revision 1.21 diff -u -d -r1.20 -r1.21 --- Overview.src.html 22 Jan 2011 12:05:04 -0000 1.20 +++ Overview.src.html 5 Feb 2011 12:03:29 -0000 1.21 @@ -22,8 +22,6 @@ caption dfn { font-size: 120% } *:target { - color: #000000; - background-color: #F8F8F8; border: 1px dashed #66CC66; } /*]]>*/ @@ -101,8 +99,8 @@ implementers: <ul> <li><a href="#issue-phonemes">phonemes</a></li> -<li><a href="#issue-mark">mark</a></li> -<li><a href="#issue-speak_none">speak:none</a></li> +<!-- li><a href="#issue-mark">mark</a></li --> +<!-- li><a href="#issue-speak_none">speak:none</a></li --> </ul> </p> @@ -202,7 +200,7 @@ <p><img id="aural-box" src="aural-box.png" alt="A graph depicting the aural 'box' model."/></p> -<p>where <dfn>element</dfn> is the selected element to which the properties +<p>where <dfn><element></dfn> is the selected element to which the properties from the Speech Module apply.</p> <h2 id="mixing-props"><span class="secno">4. </span>Mixing properties: @@ -217,12 +215,12 @@ </tr> <tr> <td width="20%"><em>Value:</em></td> -<td><non-negative number> | <percentage> | silent | x-soft | soft | +<td>auto | <non-negative number> | <percentage> | silent | x-soft | soft | medium | loud | x-loud | inherit</td> </tr> <tr> <td width="20%"><em>Initial:</em></td> -<td>medium</td> +<td>auto</td> </tr> <tr> <td width="20%"><em>Applies to:</em></td> @@ -253,12 +251,18 @@ <p>Values have the following meanings:</p> <dl> +<dt><strong>auto</strong></dt> +<dd> +Resolves to a used value of 'medium' when the computed value of the 'visibility' property is 'visible' (see [[CSS3BOX]]), otherwise resolves to a used value of 'silent'. +</dd> + <dt><strong><non-negative number></strong></dt> <dd>An integer or floating point number in the range '0' to '100'. '0' represents silence (the <em>minimum</em> level), and 100 corresponds to the <em>maximum</em> level. The volume scale is -linear amplitude.</dd> +linear amplitude. +</dd> <dt><strong><percentage></strong></dt> @@ -289,6 +293,18 @@ headphones), and the environment (in car, home theater, library) and personal preferences.</p> +<p>Note the difference between an element whose 'voice-volume' +property has a value of 'silent' and an element whose 'speakability' +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 +(note that descendants may override the 'voice-volume' value +and may therefore generate audio output). +The latter requires no time and +is not rendered in the aural dimension +(including its descendants, which cannot override the inherited 'none' value).</p> + + <table class="propdef" summary="name: syntax"> <tbody> <tr> @@ -369,25 +385,25 @@ <em>does</em> apply to <a href="#cue-props">audio cues</a>.</p> <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties: -'speak'</h2> +'speakability', 'speak'</h2> <!-- <p>An additional speech property, speak-header, is described in the CSS module covering tables.</p> --> + <table class="propdef" summary="name: syntax"> <tbody> <tr> <td>Name:</td> -<td><dfn id="speak">speak</dfn></td> +<td><dfn id="speakability">speakability</dfn></td> </tr> <tr> <td width="20%"><em>Value:</em></td> -<td>none | normal | spell-out | digits | literal-punctuation | -no-punctuation | inherit</td> +<td>auto | none | normal | inherit</td> </tr> <tr> <td width="20%"><em>Initial:</em></td> -<td>normal</td> +<td>auto</td> </tr> <tr> <td width="20%"><em>Applies to:</em></td> @@ -408,25 +424,78 @@ </tbody> </table> -<p>This property specifies whether text will be rendered aurally -and if so, in what manner.</p> +<p>This property specifies whether text will be rendered aurally.</p> <p>Values have the following meanings:</p> <dl> +<dt><strong>auto</strong></dt> +<dd> +Resolves to a used value of 'none' when the computed value of the 'display' property is 'none' (see [[CSS3BOX]]), +otherwise resolves to a used value of 'normal'. +Note that although the 'none' value of the 'display' property cannot be overridden by descendants of the affected element, +the 'auto' value of 'speakability' can however be overridden by either of 'none' or 'normal'. +In the case of 'normal', this would result in descendants being rendered in the aural dimension even though they would not rendered in the visual space. +To ensure that an element and its descendants do not get rendered in the aural dimension, +use the 'none' value for the 'speakability' property. +Also note that the value of the 'visibility' property (see [[CSS3BOX]]) +may affect the computed value of 'voice-volume', but do not affect the 'speakability' property. +</dd> + <dt><strong>none</strong></dt> +<dd> +This value causes an element +(including pauses, cues, rests and actual content) +to not be rendered (i.e., the element has no effect in the aural dimension). +Descendant elements do not get rendered either; +this behavior cannot be overridden by setting the 'speakability' property on the descendants. +</dd> -<dd>Suppresses aural rendering so that the element requires no time -to render. Note, however, that descendants may override this value -and will be spoken. (To be sure to suppress rendering of an element -and its descendants, use the 'display' property [[CSS3BOX]]). +<dt><strong>normal</strong></dt> +<dd> +The element is rendered aurally. +Note that this property value can be overridden by descendant elements, using either of "auto" or "none". +</dd> -<p class="issue" id="issue-speak_none">ISSUE: 'speak:none' is arguably unnecessary, as it can be fully realized using 'display:none'. The function of 'speak' should primarily be to specify *how* to speak text content, not to control *if* it should be spoken. There is also a concern about accessibility good practices, in particular with regards to whether this specification should allow authors to "hide" text in the aural dimension, when it is actually visible on the graphical canvas. Note that "display:none" is different than "visibility:hidden". The former effectively 'deactivates' an element (so to speak) whereas the latter is more similar to "voice-volume:0%". In other words, "visibility:hidden" preserves the visual space that the element would normally occupy if it was visible (resulting in an empty or transparent area that still takes part in the page layout), and conversely "voice-volume:0%" results in an audio silence lasting as long as the duration of non-silent TTS playback. -There is a <a href="http://lists.w3.org/Archives/Public/www-style/2011Jan/0355.html">related discussion</a> on the public mailing-list. -</p> +<table class="propdef" summary="name: syntax"> +<tbody> +<tr> +<td>Name:</td> +<td><dfn id="speak">speak</dfn></td> +</tr> +<tr> +<td width="20%"><em>Value:</em></td> +<td>normal | spell-out | digits | literal-punctuation | +no-punctuation | inherit</td> +</tr> +<tr> +<td width="20%"><em>Initial:</em></td> +<td>normal</td> +</tr> +<tr> +<td width="20%"><em>Applies to:</em></td> +<td>all elements</td> +</tr> +<tr> +<td width="20%"><em>Inherited:</em></td> +<td>yes</td> +</tr> +<tr> +<td width="20%"><em>Percentages:</em></td> +<td>N/A</td> +</tr> +<tr> +<td width="20%"><em>Media:</em></td> +<td>speech</td> +</tr> +</tbody> +</table> -</dd> +<p>This property specifies in what manner text gets rendered aurally.</p> + +<p>Values have the following meanings:</p> +<dl> <dt><strong>normal</strong></dt> <dd>Uses language-dependent pronunciation rules for rendering an @@ -458,13 +527,6 @@ nor rendered as various pauses.</dd> </dl> -<p>Note the difference between an element whose 'voice-volume' -property has a value of 'silent' and an element whose 'speak' -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. The latter requires no time and -is not rendered (though its descendants may be).</p> - <p>Speech synthesizers are knowledgeable about what is and what is not a number. The 'speak' property gives authors the means to control how the synthesizer renders the numbers it discovers in the source @@ -474,8 +536,9 @@ <h2 id="pause-props"><span class="secno">6. </span>Pause properties: 'pause-before', 'pause-after' and -'pause', -<a href="#collapsing">collapsing pauses</a></h2> +'pause' +<!-- a href="#collapsing">collapsing pauses</a --> +</h2> <table class="propdef" summary="name: syntax"> <tbody> @@ -1016,7 +1079,7 @@ <!-- Add something here about gc --> -<h2 id="mark-props"><span class="secno">9. </span>Mark properties: +<!-- h2 id="mark-props"><span class="secno">9. </span>Mark properties: 'mark-before', 'mark-after' and 'mark'</h2> @@ -1179,7 +1242,7 @@ and as a mean to raise an event when the point is reached within the speech stream. This functionality arguably isn't purely of stylistic nature (if at all), so it is judged "at risk" of being removed from this specification draft. There is a <a href="http://lists.w3.org/Archives/Public/www-style/2010Dec/0239.html">related discussion</a> on the public mailing-list. -</p> +</p --> <h2 id="voice-char-props"><span class="secno">10. </span>Voice characteristic properties: @@ -2167,7 +2230,11 @@ <h2 class="no-num" id="changes">Appendix F — Changes from previous draft</h2> <ul> +<li>Removed the "mark" property, see the <a href="http://lists.w3.org/Archives/Public/www-style/2011Feb/0029.html">Working Group resolution</a></li> +<li>Added the 'speakability' property and removed the 'none' value of the 'speak' property, +as per this <a href="http://lists.w3.org/Archives/Public/www-style/2011Jan/0483.html">discussion</a></li> <li>Fixed 'voice-family' grammar as per <a href="http://lists.w3.org/Archives/Public/www-style/2010Dec/0231.html">this discussion</a></li> +<li>Added the default 'auto' value for the 'voice-volume' property, in order to inherit aural rendering behavior from the 'visibility' property.</li> <li>Added "HTML" to "CSS defines aural properties that give control over rendering XML to speech" in the abstract.</li> <li>Removed unused normative links to CSS3 Modules (actually moved to informative references), now the only dependency is CSS3 Values and Units.</li>
Received on Saturday, 5 February 2011 12:03:33 UTC