Timed Text Markup Language

Anatomie van een bestand

Een XML-document: een head die stijlen en regio's benoemt, en een body met alinea's, één voor elke ondertitel.

<tt xml:lang="en" …>
<head>styles, regions</head>
<body><div>
<p begin="00:00:23.000"
   end="00:00:24.500">
You're a jerk,<br/>Thom.</p>
</div></body>
</tt>

Tijden

TTML schrijft een tijd op meer manieren dan welk ander ondertitelformaat ook:

Stijlen

Een stijl is een verzameling tts:-attributen. Tekst neemt ze in volgorde over: van zijn regio, dan van de body, de div, de alinea en de span eromheen. Elk element neemt de stijlen over die het noemt (style="s1 s2", en de stijlen die die noemen), en daarna zijn eigen attributen.

Regio's

Een regio is een vak op het beeld, geplaatst met tts:origin en van formaat gemaakt met tts:extent. Binnenin zet tts:displayAlign de tekst bovenaan, in het midden of onderaan (before, center, after), en tts:textAlign aan één kant of in het midden.

<region xml:id="top"
        tts:origin="10% 10%"
        tts:extent="80% 80%"
        tts:displayAlign="before"/>

Subtitld berekent waar de tekst terechtkomt, of de regio nu in procenten, pixels of cellen is gemeten, en kiest de dichtstbijzijnde van de negen plaatsen die {\an1} tot {\an9} van SubRip aangeven. Bij het schrijven van een bestand is elke gebruikte plaats een regio met die naam: bottom, top, top-left…

Profielen

De meeste TTML is geschreven volgens een profiel: een subset van de taal, met eigen regels. Subtitld leest ze allemaal als TTML.

TTML in Subtitld

Een TTML-bestand openen

Subtitld opent .ttml, .dfxp, .itt en .xml, en:

• leest TTML hoe het ook is geschreven: in de eigen namespace, in de oude DFXP-namespace, of met tt: voor elk element;
• leest elke vorm van tijd, elk geteld vanaf de div en body waarin het staat;
• volgt stijlen zoals TTML ze toepast, en behoudt cursief, vet, onderstreping, doorhaling en elke kleur die niet wit is;
• zet elke ondertitel waar zijn regio die toont;
• neemt agenten als sprekers, klaar voor nasynchronisatie, en het xml:lang van het bestand als de taal van het project;
• leest de codering die het bestand opgeeft, en HTML-entiteiten zoals  .

Een bestand dat geen goed gevormd XML is, opent met een melding met de regel en de kolom. Een bestand dat helemaal geen TTML is, zegt dat ook.

TTML exporteren

Exporteren, dan Ondertitels en TTML of DFXP, biedt:

• TekstHet origineel, een vertaling, of beide, met de vertaling eronder.
• Namen van sprekersWeggelaten, voor de tekst (Thom: …), of als agenten (ttm:agent), de eigen manier van TTML.
• OpmaakBehouden, of verwijderd.
• Tijden verschuivenElke ondertitel eerder of later met hetzelfde bedrag.
• LookWit met een zwarte omlijning, of zoals de voorvertoning van Subtitld tekent: het lettertype, de kleur en een doorzichtig vak.

Het bestand is TTML 1 in UTF-8. Tijden worden geschreven als 00:00:23.000, elke plaats waar de ondertitels staan als een regio, opmaak als spans, en regeleindes als <br/>. Het xml:lang is de taal van de tekst die het bevat. TTML en DFXP krijgen hetzelfde bestand; alleen de extensie verschilt.

TTML of WebVTT?

WebVTT voor een <track> op een webpagina: browsers lezen dat zelf. TTML voor omroepen, voor streamingdiensten die erom vragen, en voor spelers die het lezen, zoals dash.js en Shaka Player. De WebVTT-pagina bevat de rest.

Wetenswaardigheden