WebVTT

Anatomie van een cue

Een bestand bestaat uit een kop, gevolgd door cues. Elke cue is een blok zoals bij SubRip, met twee optionele delen.

WEBVTT
 
intro
00:00:23.000 --> 00:00:24.500 line:0
<v Celia>You're a jerk,
<i>Thom</i>.
 

De tijdcode

Blokken naast cues

Celtekst

Kleuren

Acht klassen worden zonder enige CSS gekleurd: white, lime, cyan, red, yellow, magenta, blue en black, en dezelfde acht met bg_ voor de achtergrond. Elke andere kleur heeft een eigen klasse nodig en een STYLE-blok:

STYLE
::cue(.gold) { color: #ffd700; }

00:00:30.800 --> 00:00:34.000
<c.gold>Why don't you just admit that</c>

Cue-instellingen

Subtitld leest line, position en align als de plaats van de ondertitel op het scherm, dezelfde negen plaatsen als {\an1} tot {\an9} bij SubRip, en schrijft ze zo terug: line:0 voor boven, line:50%,center voor het midden, position:10% align:start en position:90% align:end voor de zijkanten.

WebVTT in Subtitld

Een WebVTT-bestand openen

Subtitld vindt elke cue via de tijdregel en leest:

• de kop, en de blokken NOTE, STYLE en REGION als wat ze zijn, niet als ondertitels, en cue-identificaties als namen;
• tijden met of zonder uren, met een punt of een komma;
• stemmen als de sprekers van de ondertitels, klaar voor nasynchronisatie;
• de kleurklassen van WebVTT, en de kleuren die een STYLE-blok andere klassen geeft;
• line, position en align als de plaats op het scherm;
• elke codering, hoewel WebVTT om UTF-8 vraagt.

Wat Subtitld er niet voor heeft, laat het weg: regio's, de grootte van een cue, verticale tekst, de lezingen van ruby en karaoke-tijdstempels. De tekst zelf blijft.

WebVTT exporteren

Exporteren, dan Ondertitels en VTT, biedt:

• TekstHet origineel, een vertaling, of beide, met de vertaling eronder.
• Namen van sprekersWeggelaten, voor de tekst (Thom: …), of als stemtags (<v Thom>), de eigen manier van WebVTT.
• OpmaakBehouden, of verwijderd.
• Tijden verschuivenElke ondertitel eerder of later met hetzelfde bedrag.

Het bestand is altijd UTF-8, zoals WebVTT vereist: WEBVTT, dan de cues op volgorde van begin, elke tijd met zijn uren. Tekens die als opmaak zouden worden gelezen, worden als entiteiten geschreven, en lege ondertitels worden weggelaten.

Op een webpagina

<video controls src="tears-of-steel.mp4">
  <track kind="subtitles" src="tears-of-steel.en.vtt"
         srclang="en" label="English" default>
</video>

Serveer het bestand als text/vtt. Vanaf een ander domein heeft de video crossorigin nodig en de server een Access-Control-Allow-Origin-header, anders laadt de browser de track niet.

WebVTT of SubRip?

SubRip voor spelers, editors en uploads; WebVTT voor video op het web. De SubRip-pagina zet ze naast elkaar.

Wetenswaardigheden