Timed Text Markup Language

Anatomie d'un fichier

Un document XML : un en-tête qui nomme les styles et les régions, et un corps de paragraphes, un par sous-titre.

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

Les temps

TTML écrit un temps de plus de manières que tout autre format de sous-titres :

Styles

Un style est un ensemble d'attributs tts:. Le texte les prend dans l'ordre : depuis sa région, puis depuis le body, la div, le paragraphe et le span qui l'entourent. Chaque élément prend les styles qu'il nomme (style="s1 s2", et ceux que ceux-ci nomment), puis ses propres attributs.

Régions

Une région est une boîte sur l'image, placée par tts:origin et dimensionnée par tts:extent. À l'intérieur, tts:displayAlign place le texte en haut, au milieu ou en bas (before, center, after), et tts:textAlign sur un côté ou au centre.

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

Subtitld détermine où atterrit le texte, que la région soit mesurée en pourcentages, en pixels ou en cellules, et retient le plus proche des neuf emplacements que {\an1} à {\an9} de SubRip désignent. Quand il écrit un fichier, chaque emplacement utilisé devient une région de ce nom : bottom, top, top-left…

Profils

La plupart des TTML sont écrits selon un profil : un sous-ensemble du langage, avec ses propres règles. Subtitld lit chacun d'eux comme du TTML.

Le TTML dans Subtitld

Ouvrir un fichier TTML

Subtitld ouvre .ttml, .dfxp, .itt et .xml, et :

• lit le TTML quelle que soit son écriture : dans son espace de noms, dans l'ancien espace DFXP, ou avec tt: devant chaque élément ;
• lit toutes les formes de temps, chacune comptée depuis la div et le body qui la contiennent ;
• suit les styles comme TTML les applique, en gardant l'italique, le gras, le souligné, le barré et toute couleur autre que le blanc ;
• place chaque sous-titre là où sa région l'affiche ;
• prend les agents comme intervenants, prêts pour le doublage, et le xml:lang du fichier comme langue du projet ;
• lit l'encodage déclaré par le fichier, ainsi que les entités HTML telles que  .

Un fichier qui n'est pas du XML bien formé s'ouvre avec un message indiquant la ligne et la colonne. Un fichier qui n'est pas du tout du TTML le signale.

Exporter en TTML

Exporter, puis Sous-titres et TTML ou DFXP, propose :

• TexteL'original, une traduction, ou les deux, la traduction en dessous.
• Noms des intervenantsOmis, placés avant le texte (Thom : …), ou sous forme d'agents (ttm:agent), la façon propre à TTML.
• Mise en formeConservée, ou supprimée.
• Décalage des tempsChaque sous-titre plus tôt ou plus tard, du même écart.
• ApparenceBlanc avec contour noir, ou tel que l'aperçu de Subtitld le dessine : sa police, sa couleur et sa boîte translucide.

Le fichier est du TTML 1 en UTF-8. Les temps s'écrivent 00:00:23.000, chaque emplacement des sous-titres devient une région, la mise en forme passe par des spans et les retours à la ligne par <br/>. Son xml:lang est la langue du texte qu'il contient. TTML et DFXP donnent le même fichier ; seule l'extension diffère.

TTML ou WebVTT ?

WebVTT pour un <track> sur une page web : les navigateurs le lisent seuls. TTML pour les diffuseurs, pour les services de streaming qui le demandent, et pour les lecteurs qui le lisent, comme dash.js et Shaka Player. La page WebVTT en dit davantage.

Anecdotes