- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Mon, 03 Mar 2014 01:05:39 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/tmp/cvs-serv20061
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit dc674aacb5a08016d248dd018e1fe3a83a5155ac
--- /sources/public/html5/webvtt/Overview.html 2014/03/02 02:07:39 1.115
+++ /sources/public/html5/webvtt/Overview.html 2014/03/03 01:05:39 1.116
@@ -271,7 +271,7 @@
</p>
<h1 class="title p-name" id="title">WebVTT: The Web Video Text Tracks Format</h1>
- <h2 id="draft-community-group-specification-02-march-2014">Draft Community Group Specification <time class="dt-published" datetime="2014-03-02">02 March 2014</time></h2>
+ <h2 id="draft-community-group-specification-03-march-2014">Draft Community Group Specification <time class="dt-published" datetime="2014-03-03">03 March 2014</time></h2>
<dl>
@@ -1215,7 +1215,8 @@
<ol>
- <li>Optionally (required if <var title="">hour</var> is non-zero):
+ <li>
+ Optionally (required if <var title="">hour</var> is non-zero):
<ol>
@@ -1286,7 +1287,8 @@
<ol>
<li>One or more <a href="#dfn-ascii-digits" class="internalDFN">ASCII digits</a>.</li>
- <li>Optionally:
+ <li>
+ Optionally:
<ol>
<li>A U+002E DOT character (.).</li>
<li>One or more <a href="#dfn-ascii-digits" class="internalDFN">ASCII digits</a>.</li>
@@ -1305,9 +1307,11 @@
<ol>
<li>The <a href="#dfn-case-sensitive" class="internalDFN">case-sensitive</a> string "<code title="">NOTE</code>".</li>
- <li>Optionally, the following components, in the given order:
+ <li>
+ Optionally, the following components, in the given order:
<ol>
- <li>Either:
+ <li>
+ Either:
<ul>
<li>A U+0020 SPACE character or U+0009 CHARACTER TABULATION (tab) character.</li>
<li>A <a href="#dfn-webvtt-line-terminator" class="internalDFN">WebVTT line terminator</a>.</li>
@@ -1410,7 +1414,8 @@
<ol>
<li>A <a href="#dfn-webvtt-cue-span-start-tag" class="internalDFN">WebVTT cue span start tag</a> "<code title="">ruby</code>" that disallows an annotation.</li>
- <li>One or more occurrences of the following group of components, in the order given:
+ <li>
+ One or more occurrences of the following group of components, in the order given:
<ol>
<li><a href="#dfn-webvtt-cue-internal-text" class="internalDFN">WebVTT cue internal text</a>, representing the ruby base.</li>
<li>A <a href="#dfn-webvtt-cue-span-start-tag" class="internalDFN">WebVTT cue span start tag</a> "<code title="">rt</code>" that disallows an annotation.</li>
@@ -1455,7 +1460,8 @@
<li>The <var title="">tag name</var>.</li>
- <li>Zero or more occurrences of the following sequence:
+ <li>
+ Zero or more occurrences of the following sequence:
<ol>
@@ -1727,9 +1733,11 @@
<ol>
<li><p>The string "<code title="">line</code>" as the <a href="#dfn-webvtt-cue-setting-name" class="internalDFN">WebVTT cue setting name</a>.</p></li>
<li><p>A U+003A COLON character (:).</p></li>
- <li>As the <a href="#dfn-webvtt-cue-setting-value" class="internalDFN">WebVTT cue setting value</a>:
+ <li>
+ As the <a href="#dfn-webvtt-cue-setting-value" class="internalDFN">WebVTT cue setting value</a>:
<ol>
- <li>a position value, either:
+ <li>
+ a position value, either:
<dl>
<dt>To represent a specific position relative to the video frame</dt>
<dd>
@@ -1744,7 +1752,8 @@
</dd>
</dl>
</li>
- <li>An optional alignment value consisting of the following components:
+ <li>
+ An optional alignment value consisting of the following components:
<ol>
<li>A U+002C COMMA character (,).</li>
<li>One of the following strings: <code title="">start</code>, <code title="">middle</code>,
@@ -1790,10 +1799,12 @@
<ol>
<li><p>The string "<code title="">position</code>" as the <a href="#dfn-webvtt-cue-setting-name" class="internalDFN">WebVTT cue setting name</a>.</p></li>
<li><p>A U+003A COLON character (:).</p></li>
- <li>As the <a href="#dfn-webvtt-cue-setting-value" class="internalDFN">WebVTT cue setting value</a>:
+ <li>
+ As the <a href="#dfn-webvtt-cue-setting-value" class="internalDFN">WebVTT cue setting value</a>:
<ol>
<li>a position value consisting of: a <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</li>
- <li>an optional alignment value consisting of:
+ <li>
+ an optional alignment value consisting of:
<ol>
<li>A U+002C COMMA character (,).</li>
<li>One of the following strings: <code title="">start</code>, <code title="">middle</code>,
@@ -1898,15 +1909,18 @@
tree structure:</p>
<ul>
- <li>WebVTT file
+ <li>
+ WebVTT file
<ul>
- <li>Introduction
+ <li>
+ Introduction
<ul>
<li>Topics</li>
<li>Presenters</li>
</ul>
</li>
- <li>Scrolling Effects
+ <li>
+ Scrolling Effects
<ul>
<li>Achim's Demo</li>
<li>Timeline Panel</li>
@@ -2092,7 +2106,8 @@
<li><p>Let <var title="">regions</var> be a <a href="#dfn-text-track-list-of-regions" class="internalDFN">text track list of regions</a>.</p></li>
- <li><i>Metadata header loop</i>: If <var>line</var> is not the empty string, run the following substeps:
+ <li>
+ <i>Metadata header loop</i>: If <var>line</var> is not the empty string, run the following substeps:
<ol>
@@ -2104,7 +2119,8 @@
<li><p>If <var>line</var> contains the character ":" (A U+003A COLON), then set <a title="WebVTT metadata header name" href="#dfn-webvtt-metadata-header-name" class="internalDFN">metadata's name</a> to the substring of <var>line</var> before the first ":" character and <a title="WebVTT metadata header value" href="#dfn-webvtt-metadata-header-value" class="internalDFN">metadata's value</a> to the substring after this character.</p></li>
- <li><p>If <a title="WebVTT metadata header name" href="#dfn-webvtt-metadata-header-name" class="internalDFN">metadata's name</a> equals "Region":</p>
+ <li>
+ <p>If <a title="WebVTT metadata header name" href="#dfn-webvtt-metadata-header-name" class="internalDFN">metadata's name</a> equals "Region":</p>
<ol>
<li><i>Region creation</i>: Let <var>region</var> be a new <a href="#dfn-text-track-region" class="internalDFN">text track region</a>.</li>
@@ -2153,9 +2169,10 @@
a newline, so we have none of that either, meaning we have nothing.
-->.)</p></li>
- <li><p><i>Cue creation</i>: Let <var title="">cue</var> be a new
- <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> and initialize it with the following
- attribute values:</p>
+ <li>
+ <p><i>Cue creation</i>: Let <var title="">cue</var> be a new
+ <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> and initialize it with the following
+ attribute values:</p>
<ol>
<li><p>Let <var title="">cue</var>'s <a href="#dfn-text-track-cue-identifier" class="internalDFN">text track cue identifier</a> be the empty string.</p></li>
@@ -2298,7 +2315,8 @@
<ol>
<li><p>Let <var>settings</var> be the result of <a title="split a string on spaces" href="#dfn-split-a-string-on-spaces" class="internalDFN">splitting <var>input</var> on spaces</a>.</p></li>
- <li>For each token <var>setting</var> in the list <var>settings</var>, run the following substeps:
+ <li>
+ For each token <var>setting</var> in the list <var>settings</var>, run the following substeps:
<ol>
<li><p>If <var>setting</var> does not contain a U+003D EQUALS SIGN character (=), or if the first U+003D EQUALS SIGN character (=) in <var>setting</var> is either the first or last character of <var>setting</var>, then jump to the step labeled <i>next setting</i>.</p></li>
@@ -2307,7 +2325,8 @@
<li><p>Let <var>value</var> be the trailing substring of <var>setting</var> starting from the character immediately after the first U+003D EQUALS SIGN character (=) in that string.</p></li>
- <li><p>Run the appropriate substeps that apply for the value of <var>name</var>, as follows:</p>
+ <li>
+ <p>Run the appropriate substeps that apply for the value of <var>name</var>, as follows:</p>
<dl>
<dt><p>If <var>name</var> is a <a href="#dfn-case-sensitive" class="internalDFN">case-sensitive</a> match for "<code>id</code>"</p></dt>
@@ -2711,7 +2730,8 @@
</li>
- <li><p>If <var title="">positionSet</var> is false (i.e. the cue box has not been explicitly
+ <li>
+ <p>If <var title="">positionSet</var> is false (i.e. the cue box has not been explicitly
positioned with a position setting), and <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a>
is not <a title="text track cue middle alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">middle alignment</a>, then adjust the
<a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> as follows:</p>
@@ -2727,7 +2747,8 @@
</dl>
</li>
- <li><p>If <var title="">positionAlignSet</var> is false (i.e. the cue box has not been explicitly
+ <li>
+ <p>If <var title="">positionAlignSet</var> is false (i.e. the cue box has not been explicitly
position aligned with a position alignment setting), and <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a>
is not <a title="text track cue middle alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">middle alignment</a>, then adjust the
<a href="#dfn-text-track-cue-text-position-alignment" class="internalDFN">text track cue text position alignment</a> as follows:</p>
@@ -3818,10 +3839,12 @@
<li><p>If <var>reset</var> is false, then, for each <a href="#dfn-text-track-region" class="internalDFN">text track region</a> <var>region</var> in <var>regions</var> let <var>regionNode</var> be a <a href="#dfn-webvtt-region-object" class="internalDFN">WebVTT region object</a>.</p></li>
- <li><p>Apply the following steps for each <var>regionNode</var>:</p>
+ <li>
+ <p>Apply the following steps for each <var>regionNode</var>:</p>
<ol>
- <li><p>Prepare some variables for the application of CSS properties to <var>regionNode</var> as follows:</p>
+ <li>
+ <p>Prepare some variables for the application of CSS properties to <var>regionNode</var> as follows:</p>
<ul>
<li><p>Let <var>regionWidth</var> be the <a href="#dfn-text-track-region-width" class="internalDFN">text track region width</a>. Let <var>width</var> be '<var>regionWidth</var> vw' ('vw' is a CSS unit).<a href="#refsCSSVALUES">[CSSVALUES]</a></p></li>
@@ -3834,7 +3857,8 @@
</ul>
</li>
- <li><p>Apply the terms of the CSS specifications to <var>regionNode</var> within the following constraints, thus obtaining a CSS box <var>box</var> positioned relative to an initial containing block:</p>
+ <li>
+ <p>Apply the terms of the CSS specifications to <var>regionNode</var> within the following constraints, thus obtaining a CSS box <var>box</var> positioned relative to an initial containing block:</p>
<ol>
<li><p>No style sheets are associated with <var>regionNode</var>. (The regionNodes are subsequently restyled using style sheets after their boxes are generated, as described below.)</p></li>
<li><p>Properties on <var>regionNode</var> have their values set as defined in the next section. (That section uses some of the variables whose values were calculated earlier in this algorithm.)</p></li>
@@ -3846,7 +3870,8 @@
</ol>
</li>
- <li><p>If <var>reset</var> is false, then, for each <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> <var>cue</var> in <var>cues</var>: if <var>cue</var>'s <a href="#dfn-text-track-cue-display-state" class="internalDFN">text track cue display state</a> has a set of CSS boxes, then:</p>
+ <li>
+ <p>If <var>reset</var> is false, then, for each <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> <var>cue</var> in <var>cues</var>: if <var>cue</var>'s <a href="#dfn-text-track-cue-display-state" class="internalDFN">text track cue display state</a> has a set of CSS boxes, then:</p>
<ul>
<li><p>If <var>cue</var>'s <a href="#dfn-text-track-cue-region" class="internalDFN">text track cue region</a> is not null, add those boxes to that
@@ -3865,7 +3890,8 @@
cue order</a>, run the following substeps:</p>
<ul>
- <li><p>If <var>cue</var>'s <a href="#dfn-text-track-cue-region" class="internalDFN">text track cue region</a> is null, run the following substeps:</p>
+ <li>
+ <p>If <var>cue</var>'s <a href="#dfn-text-track-cue-region" class="internalDFN">text track cue region</a> is null, run the following substeps:</p>
<ol>
@@ -3881,7 +3907,8 @@
</ol>
</li>
- <li><p>Otherwise, run the following substeps:</p>
+ <li>
+ <p>Otherwise, run the following substeps:</p>
<ol>
<li><p>Let <var>region</var> be <var>cue</var>'s <a href="#dfn-text-track-cue-region" class="internalDFN">text track cue region</a>.</p></li>
@@ -3889,7 +3916,8 @@
<li><p>Let <var>nodes</var> be the <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a> obtained by applying the <a href="#dfn-webvtt-cue-text-parsing-rules" class="internalDFN">WebVTT cue text parsing rules</a> to the <var>cue</var>'s <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a>.</p></li>
- <li><p>Apply the Unicode Bidirectional Algorithm's Paragraph Level steps to the concatenation of the values of each <a href="#dfn-webvtt-text-object" class="internalDFN">WebVTT Text Object</a> in <var>nodes</var>, in a pre-order, depth-first traversal, excluding <a title="WebVTT Ruby Text Object" href="#dfn-webvtt-ruby-text-object" class="internalDFN">WebVTT Ruby Text Objects</a> and their descendants, to determine the <i>paragraph embedding level</i> of the first
+ <li>
+ <p>Apply the Unicode Bidirectional Algorithm's Paragraph Level steps to the concatenation of the values of each <a href="#dfn-webvtt-text-object" class="internalDFN">WebVTT Text Object</a> in <var>nodes</var>, in a pre-order, depth-first traversal, excluding <a title="WebVTT Ruby Text Object" href="#dfn-webvtt-ruby-text-object" class="internalDFN">WebVTT Ruby Text Objects</a> and their descendants, to determine the <i>paragraph embedding level</i> of the first
Unicode paragraph of the cue. <a href="#refsBIDI">[BIDI]</a></p>
<div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_30"><span>Note</span></div><p class="">Within a cue, paragraph boundaries are only denoted by Type B characters, such as U+000A LINE FEED (LF), U+0085 NEXT LINE (NEL), and U+2029 PARAGRAPH SEPARATOR. (This means each line of the cue is reordered as if it was a separate paragraph.)</p></div>
</li>
@@ -3900,12 +3928,14 @@
<li><p>Let <var>offset</var> be the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> multiplied by <var>region</var>'s <a href="#dfn-text-track-region-width" class="internalDFN">text track region width</a> and divided by 100 (i.e. interpret it as a percentage of the region width).</p>
</li>
- <li><p>If <var>direction</var> is 'ltr' and 'text-align' is 'start' or 'left', or if <var>direction</var> is 'rtl' and 'text-align' is 'end' or 'left', let <var>left</var> be <var>offset</var> and let <var>right</var> be 'auto'</p>
+ <li>
+ <p>If <var>direction</var> is 'ltr' and 'text-align' is 'start' or 'left', or if <var>direction</var> is 'rtl' and 'text-align' is 'end' or 'left', let <var>left</var> be <var>offset</var> and let <var>right</var> be 'auto'</p>
<p>If <var>direction</var> is 'ltr' and 'text-align' is 'end' or 'right', or if <var>direction</var> is 'rtl' and 'text-align' is 'start' or 'right', let <var>left</var> be 'auto' and <var>right</var> be <var>offset</var>.</p>
<p>If 'text-align' is 'middle', ignore the <var>offset</var>.</p>
</li>
- <li><p>Apply the terms of the CSS specifications to <var>nodes</var> with the same constraints that are used when they are applied to <var>nodes</var> of a <var>cue</var> that is not part of a region.</p>
+ <li>
+ <p>Apply the terms of the CSS specifications to <var>nodes</var> with the same constraints that are used when they are applied to <var>nodes</var> of a <var>cue</var> that is not part of a region.</p>
<p>Let <var>boxes</var> be the boxes generated as descendants of the initial containing block, along with their positions.</p>
</li>
@@ -4167,8 +4197,9 @@
section. (That section uses some of the variables whose values
were calculated earlier in this algorithm.)</li>
- <li>Text runs must be wrapped according to the CSS
- line-wrapping rules, with the following additional constraints:
+ <li>
+ Text runs must be wrapped according to the CSS
+ line-wrapping rules, with the following additional constraints:
<ul>
@@ -5349,7 +5380,8 @@
</dd>
<dt><var title="">region</var> . <a title="dom-VTTRegion-scroll" href="#dfn-dom-vttregion-scroll" class="internalDFN">scroll</a></dt>
- <dd><p>Returns a string representing the <a href="#dfn-text-track-region-scroll" class="internalDFN">text track region scroll</a> as follows:</p>
+ <dd>
+ <p>Returns a string representing the <a href="#dfn-text-track-region-scroll" class="internalDFN">text track region scroll</a> as follows:</p>
<dl class="switch">
<dt>If it is unset.</dt>
<dd><p>The empty string.</p></dd>
Received on Monday, 3 March 2014 01:05:41 UTC