Timed Text Markup Language

Anatomia di un file

Un documento XML: un'intestazione che nomina stili e regioni, e un corpo di paragrafi, uno per ogni sottotitolo.

<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>

Tempi

TTML scrive un tempo in più modi di qualsiasi altro formato di sottotitoli:

Stili

Uno stile è un insieme di attributi tts:. Il testo li riceve in ordine: dalla sua regione, poi dal body, dal div, dal paragrafo e dallo span che lo contengono. Ogni elemento riceve gli stili che nomina (style="s1 s2", e quelli che questi nominano), poi i propri attributi.

Regioni

Una regione è un riquadro sull'immagine, collocato da tts:origin e dimensionato da tts:extent. Al suo interno, tts:displayAlign pone il testo in alto, al centro o in basso (before, center, after), e tts:textAlign a un lato o al centro.

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

Subtitld calcola dove cade il testo, che la regione sia misurata in percentuali, pixel o celle, e sceglie la più vicina delle nove posizioni che {\an1} fino a {\an9} di SubRip indicano. Quando scrive un file, ogni posizione usata diventa una regione con quel nome: bottom, top, top-left…

Profili

La maggior parte dei TTML è scritta secondo un profilo: un sottoinsieme del linguaggio, con regole proprie. Subtitld legge ciascuno di essi come TTML.

TTML in Subtitld

Aprire un file TTML

Subtitld apre .ttml, .dfxp, .itt e .xml, e:

• legge il TTML in qualunque forma sia scritto: nel suo spazio dei nomi, in quello vecchio di DFXP, o con tt: davanti a ogni elemento;
• legge ogni forma di tempo, ciascuno contato dal div e dal body in cui si trova;
• segue gli stili come li applica TTML, conservando corsivo, grassetto, sottolineato, barrato e qualsiasi colore diverso dal bianco;
• colloca ogni sottotitolo dove lo mostra la sua regione;
• prende gli agenti come parlanti, pronti per il doppiaggio, e lo xml:lang del file come lingua del progetto;
• legge la codifica dichiarata dal file, e le entità HTML come  .

Un file che non è XML ben formato si apre con un messaggio che indica la riga e la colonna. Un file che non è affatto TTML lo dice.

Esportare TTML

Esporta, poi Sottotitoli e TTML o DFXP, offre:

• TestoL'originale, una traduzione, o entrambi, con la traduzione sotto.
• Nomi dei parlantiEsclusi, prima del testo (Thom: …), oppure come agenti (ttm:agent), il modo proprio di TTML.
• FormattazioneMantenuta, oppure rimossa.
• Sposta i tempiOgni sottotitolo anticipato o ritardato della stessa quantità.
• AspettoBianco con contorno nero, oppure come lo disegna l'anteprima di Subtitld: il suo carattere, colore e un riquadro traslucido.

Il file è TTML 1 in UTF-8. I tempi sono scritti come 00:00:23.000, ogni posizione dei sottotitoli come una regione, la formattazione come span e i ritorni a capo come <br/>. Il suo xml:lang è la lingua del testo che contiene. TTML e DFXP ottengono lo stesso file; cambia solo l'estensione.

TTML o WebVTT?

WebVTT per un <track> su una pagina web: i browser lo leggono da soli. TTML per le emittenti, per i servizi di streaming che lo richiedono, e per i player che lo leggono, come dash.js e Shaka Player. La pagina WebVTT contiene il resto.

Curiosità