Updated WebVTT spec with region specification

Hi all,

As part of working through
https://www.w3.org/Bugs/Public/show_bug.cgi?id=20348 , I have merged
the region specification into the main specification.

The specification at http://dev.w3.org/html5/webvtt/ now includes the
region specification [1].

The actual diff between the current version and the previous can be seen at:
http://dev.w3.org/cvsweb/html5/webvtt/Overview.html.diff?r1=1.65;r2=1.66;f=h

The previous version can be accessed at
https://dvcs.w3.org/hg/text-tracks/raw-file/27fcd202d32d/webvtt/webvtt.html
.

You can see that I have also reorganised the Table of Contents. It now
exposes more detail into the syntax section and the steps involved in
the parsing section.
This was the ToC previously:

1. Introduction
  1.1 Cues with multiple lines
  1.2 Comments
  1.3 Other features
2. Conformance
  2.1 Dependencies
3. Data model
4. The WebVTT file format
  4.1 Syntax
  4.2 Parsing
  4.3 WebVTT cue text parsing rules
  4.4 WebVTT cue text DOM construction rules
5. Rendering
  5.1 Cues in isolation
  5.2 Cues with video
    5.2.1 Processing model
    5.2.2 Applying CSS properties to WebVTT Node Objects
    5.2.3 CSS extensions
      5.2.3.1 The '::cue' pseudo-element
      5.2.3.2 The ':past' and ':future' pseudo-classes
6. WebVTT API


This is the ToC now:

1. Introduction
  1.1 Cues with multiple lines
  1.2 Comments
  1.3 Other features
2. Conformance
  2.1 Dependencies
3. Data model
  3.1 Text Track Cues
  3.2 Text Track Region
4. The WebVTT file format: Syntax
  4.1 WebVTT file structure
  4.2 WebVTT comments
  4.3 Types of WebVTT cue payload
    4.3.1 WebVTT metadata text
    4.3.2 WebVTT cue text
  4.4 WebVTT cue settings
    4.4.1 WebVTT region definition
    4.4.2 WebVTT cue settings
  4.5 Properties of cue sequences
    4.5.1 WebVTT file using only nested cues
  4.6 Types of WebVTT files
    4.6.1 WebVTT file using metadata content
    4.6.2 WebVTT file using chapter title text
    4.6.3 WebVTT file using cue text
5. WebVTT file format: Parsing
  5.1 WebVTT file parsing
  5.2 WebVTT region settings parsing
  5.3 WebVTT cue timings and settings parsing
  5.4 WebVTT cue text parsing rules
  5.5 WebVTT cue text DOM construction rules
6. Rendering
  6.1 Cues in isolation
  6.2 Cues with video
    6.2.1 Processing model
    6.2.2 Applying CSS properties to WebVTT Node Objects
    6.2.3 CSS extensions
      6.2.3.1 The '::cue' pseudo-element
      6.2.3.2 The ':past' and ':future' pseudo-classes
      6.2.3.3 The '::cue-region' pseudo-element
7. WebVTT API for Browsers
  7.1 WebVTTCue interface
  7.2 Extension of the TextTrack interface for region support
  7.3 Extension of the TextTrackCue interface for region support
  7.4 TextTrackRegion interface
  7.5 TextTrackRegionList interface


Since there were some big changes, feedback would be very welcome.

Thanks,
Silvia.

[1] https://dvcs.w3.org/hg/text-tracks/raw-file/default/608toVTT/region.html

Received on Saturday, 6 July 2013 02:43:15 UTC