Skip to content

Commit

Permalink
[giow] (0) Captions - Stage 8: MIME registration for text/websrt and …
Browse files Browse the repository at this point in the history 
…minor edits around that.

git-svn-id: http://svn.whatwg.org/webapps@5078 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed May 5, 2010
1 parent fca5042 commit f424227
Show file tree
Hide file tree
Showing 3 changed files with 258 additions and 65 deletions.
113 changes: 88 additions & 25 deletions complete.html
View file
Expand Up @@ -1311,9 +1311,10 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
<li><a href=#application/xhtml+xml><span class=secno>16.3 </span><code>application/xhtml+xml</code></a></li>
<li><a href=#text/cache-manifest><span class=secno>16.4 </span><code>text/cache-manifest</code></a></li>
<li><a href=#text/ping><span class=secno>16.5 </span><code>text/ping</code></a></li>
<li><a href=#application/microdata+json><span class=secno>16.6 </span><code>application/microdata+json</code></a></li>
<li><a href=#ping-from><span class=secno>16.7 </span><code>Ping-From</code></a></li>
<li><a href=#ping-to><span class=secno>16.8 </span><code>Ping-To</code></a></ol></li>
<li><a href=#text/websrt><span class=secno>16.6 </span><code>text/websrt</code></a></li>
<li><a href=#application/microdata+json><span class=secno>16.7 </span><code>application/microdata+json</code></a></li>
<li><a href=#ping-from><span class=secno>16.8 </span><code>Ping-From</code></a></li>
<li><a href=#ping-to><span class=secno>16.9 </span><code>Ping-To</code></a></ol></li>
<li><a class=no-num href=#index>Index</a>
<ol>
<li><a class=no-num href=#elements-1>Elements</a></li>
Expand Down Expand Up @@ -23574,10 +23575,10 @@ <h4 id=the-track-element><span class=secno>4.8.9 </span>The <dfn><code>track</co
<table><thead><tr><th>State
<th>Keywords
<th>Brief description
<tbody><tr><td><dfn id=attr-track-kind-subtitle title=attr-track-kind-subtitle>Subtitles</dfn>
<tbody><tr><td><dfn id=attr-track-kind-subtitles title=attr-track-kind-subtitles>Subtitles</dfn>
<td><dfn id=attr-track-kind-keyword-subtitles title=attr-track-kind-keyword-subtitles><code>subtitles</code></dfn>
<td>Translation of the dialogue, suitable for when the sound is available but not understood (e.g. because the user does not understand the language of the <a href=#media-resource>media resource</a>'s soundtrack).
<tr><td><dfn id=attr-track-kind-caption title=attr-track-kind-caption>Captions</dfn>
<tr><td><dfn id=attr-track-kind-captions title=attr-track-kind-captions>Captions</dfn>
<td><dfn id=attr-track-kind-keyword-captions title=attr-track-kind-keyword-captions><code>captions</code></dfn>
<td>Transcription of the dialogue, suitable for when the soundtrack is unavailable (e.g. because it is muted or because the user is deaf).
<tr><td><dfn id=attr-track-kind-descriptions title=attr-track-kind-descriptions>Descriptions</dfn>
Expand All @@ -23590,7 +23591,7 @@ <h4 id=the-track-element><span class=secno>4.8.9 </span>The <dfn><code>track</co
<td><dfn id=attr-track-kind-keyword-metadata title=attr-track-kind-keyword-metadata><code>metadata</code></dfn>
<td>Tracks intended for use from script.
</table><p>The attribute may be omitted. The <i>missing value default</i> is
the <span title=attr-track-kind-captions>captions</span> state.</p>
the <a href=#attr-track-kind-captions title=attr-track-kind-captions>captions</a> state.</p>

<p>The <dfn id=attr-track-src title=attr-track-src><code>src</code></dfn> attribute
gives the address of the time track data. The value must be a
Expand All @@ -23601,7 +23602,7 @@ <h4 id=the-track-element><span class=secno>4.8.9 </span>The <dfn><code>track</co
attribute gives the language of the time track data. The value must
be a valid BCP 47 language tag. This attribute must be present if
the element's <code title=attr-track-kind><a href=#attr-track-kind>kind</a></code> attribute is
in the <span title=attr-track-kind-subtitles>subtitles</span>
in the <a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>subtitles</a>
state. <a href=#refsBCP47>[BCP47]</a></p>

<p>The <dfn id=attr-track-label title=attr-track-label><code>label</code></dfn>
Expand Down Expand Up @@ -23713,22 +23714,10 @@ <h4 id=media-elements><span class=secno>4.8.10 </span>Media elements</h4>
- add stream(s) to play at end of current stream
- pause playback upon reaching a certain time
- playlists, with the ability to get metadata out of them (e.g. xspf)
* control over closed captions:
- enable, disable, select language
- event that sends caption text to script
* in-band metadata and cue points to allow:
- Chapter markers that synchronize to playback (without having to poll
the playhead position)
- Annotations on video content (i.e., pop-up video)
- General custom metadata store (ratings, etc.)
* notification of chapter labels changing on the fly:
- onchapterlabelupdate, which has a time and a label
* cue points that trigger at fixed intervals, so that
e.g. animation can be synced with the video
* general meta data, implemented as getters (don't expose the whole thing)
- getMetadata(key: string, language: string) => HTMLImageElement or string
- onmetadatachanged (no context info)
* external captions support (request from John Foliot)
- general custom metadata store (ratings, etc.)
* video: applying CSS filters
* an event to notify people of when the video size changes
(e.g. for chained Ogg streams of multiple independent videos)
Expand Down Expand Up @@ -26201,6 +26190,9 @@ <h6 id=cue-events><span class=secno>4.8.10.10.5 </span>Event definitions</h6>

<h5 id=websrt><span class=secno>4.8.10.11 </span>WebSRT</h5>

<p>The WebSRT format (Web Subtitle Resource Tracks) is a format
intended for marking up external timed track resources.</p>

<h6 id=syntax-0><span class=secno>4.8.10.11.1 </span>Syntax</h6>

<p class=XXX>...
Expand Down Expand Up @@ -86892,9 +86884,75 @@ <h3 id=text/ping><span class=secno>16.5 </span><dfn><code>text/ping</code></dfn>
<code><a href=#text/ping>text/ping</a></code> resources.</p>
<!--PING-->

<h3 id=text/websrt><span class=secno>16.6 </span><dfn><code>text/websrt</code></dfn></h3>

<p>This registration is for community review and will be submitted
to the IESG for review, approval, and registration with IANA.</p>

<h3 id=application/microdata+json><span class=secno>16.6 </span><dfn><code>application/microdata+json</code></dfn></h3>
<!--
To: ietf-types@iana.org
Subject: Registration of media type text/cues
-->

<dl><dt>Type name:</dt>
<dd>text</dd>
<dt>Subtype name:</dt>
<dd>websrt</dd>
<dt>Required parameters:</dt>
<dd>No parameters</dd>
<dt>Optional parameters:</dt>
<dd>No parameters</dd>
<dt>Encoding considerations:</dt>
<dd>Always UTF-8.</dd>
<dt>Security considerations:</dt>
<dd>
<p>Timed track files themselves pose no immediate risk unless
sensitive information is included within the
data. Implementations, however, are required to follow specific
rules when processing timed tracks, to ensure that certain
origin-based restrictions are honored. Failure to correctly
implement these rules can result in information leakage,
cross-site scripting attacks, and the like.</p>
</dd>
<dt>Interoperability considerations:</dt>
<dd>
Rules for processing both conforming and non-conforming content
are defined in this specification.
</dd>
<dt>Published specification:</dt>
<dd>
This document is the relevant specification.
</dd>
<dt>Applications that use this media type:</dt>
<dd>
Web browsers and other video players.
</dd>
<dt>Additional information:</dt>
<dd>
<dl><dt>Magic number(s):</dt>
<dd>No sequence of bytes can uniquely identify a WebSRT timed
track file.</dd>
<dt>File extension(s):</dt>
<dd>"<code title="">srt</code>"</dd>
<dt>Macintosh file type code(s):</dt>
<dd>No specific Macintosh file type codes are recommended for this type.</dd>
</dl></dd>
<dt>Person &amp; email address to contact for further information:</dt>
<dd>Ian Hickson &lt;ian@hixie.ch&gt;</dd>
<dt>Intended usage:</dt>
<dd>Common</dd>
<dt>Restrictions on usage:</dt>
<dd>No restrictions apply.</dd>
<dt>Author:</dt>
<dd>Ian Hickson &lt;ian@hixie.ch&gt;</dd>
<dt>Change controller:</dt>
<dd>WHATWG</dd>
</dl><p>Fragment identifiers have no meaning with
<code><a href=#text/websrt>text/websrt</a></code> resources.</p>



<h3 id=application/microdata+json><span class=secno>16.7 </span><dfn><code>application/microdata+json</code></dfn></h3>


<p>This registration is for community review and will be submitted
Expand Down Expand Up @@ -86963,7 +87021,7 @@ <h3 id=application/microdata+json><span class=secno>16.6 </span><dfn><code>appli


<!--PING-->
<h3 id=ping-from><span class=secno>16.7 </span><dfn title=http-ping-from><code>Ping-From</code></dfn></h3>
<h3 id=ping-from><span class=secno>16.8 </span><dfn title=http-ping-from><code>Ping-From</code></dfn></h3>

<p>This section describes a header field for registration in the
Permanent Message Header Field Registry. <a href=#refsRFC3864>[RFC3864]</a></p>
Expand All @@ -86982,7 +87040,7 @@ <h3 id=ping-from><span class=secno>16.7 </span><dfn title=http-ping-from><code>P
</dd>
<dt>Related information</dt>
<dd>None.</dd>
</dl><h3 id=ping-to><span class=secno>16.8 </span><dfn title=http-ping-to><code>Ping-To</code></dfn></h3>
</dl><h3 id=ping-to><span class=secno>16.9 </span><dfn title=http-ping-to><code>Ping-To</code></dfn></h3>

<p>This section describes a header field for registration in the
Permanent Message Header Field Registry. <a href=#refsRFC3864>[RFC3864]</a></p>
Expand Down Expand Up @@ -88747,8 +88805,8 @@ <h3 class=no-num id=element-content-categories>Element content categories</h3>
<tr><th> <code title="">kind</code>
<td> <code title=attr-track-kind><a href=#attr-track-kind>track</a></code>
<td> The type of timed track
<td> "<code title=attr-track-kind-subtitles>subtitles</code>";
"<code title=attr-track-kind-captions>captions</code>";
<td> "<code title=attr-track-kind-subtitles><a href=#attr-track-kind-subtitles>subtitles</a></code>";
"<code title=attr-track-kind-captions><a href=#attr-track-kind-captions>captions</a></code>";
"<code title=attr-track-kind-descriptions><a href=#attr-track-kind-descriptions>descriptions</a></code>";
"<code title=attr-track-kind-chapters><a href=#attr-track-kind-chapters>chapters</a></code>";
"<code title=attr-track-kind-metadata><a href=#attr-track-kind-metadata>metadata</a></code>"
Expand Down Expand Up @@ -90993,6 +91051,11 @@ <h3 class="no-num">Reflecting IDL attributes</h3>
allowing us to use their mistakes as a guide for designing the
microdata feature.</p>

<p>Thanks to the SubRip community, including in particular Zuggy and
ai4spam, for their work on the SubRip software program whose SRT
file format was used as the basis for the WebSRT timed track file
format.</p>

<div class=impl>

<p>Special thanks and $10,000 to David Hyatt who came up with a
Expand Down

0 comments on commit f424227

Please sign in to comment.