Timed Text Markup Language

Budowa pliku

Dokument XML: nagłówek, który nazywa style i regiony, oraz treść z akapitami, po jednym na każdy napis.

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

Czasy

TTML zapisuje czas na więcej sposobów niż jakikolwiek inny format napisów:

Style

Styl to zbiór atrybutów tts:. Tekst przyjmuje je w kolejności: z regionu, a potem z body, div, akapitu i otaczającego go span. Każdy element przyjmuje style, które wskazuje (style="s1 s2", oraz te, do których one odsyłają), a potem własne atrybuty.

Regiony

Region to pole na obrazie, umieszczone przez tts:origin i dopasowane przez tts:extent. Wewnątrz niego tts:displayAlign ustawia tekst u góry, pośrodku lub na dole (before, center, after), a tts:textAlign z boku lub na środku.

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

Subtitld ustala, gdzie trafia tekst, niezależnie od tego, czy region jest mierzony w procentach, pikselach czy komórkach, i wybiera najbliższe z dziewięciu miejsc, które nazywają {\an1} do {\an9} w SubRip. Zapisując plik, każde użyte miejsce zapisuje jako region o tej nazwie: bottom, top, top-left…

Profile

Większość TTML jest zapisana w profilu: podzbiorze języka z własnymi regułami. Subtitld czyta każdy z nich jako TTML.

TTML w Subtitld

Otwieranie pliku TTML

Subtitld otwiera pliki .ttml, .dfxp, .itt i .xml oraz:

• czyta TTML niezależnie od zapisu: w jego przestrzeni nazw, w starej przestrzeni DFXP albo z tt: przed każdym elementem;
• czyta każdą postać czasu, liczoną od div i body, w których się znajduje;
• stosuje style tak, jak robi to TTML, zachowując kursywę, pogrubienie, podkreślenie, przekreślenie i każdy kolor inny niż biały;
• umieszcza każdy napis tam, gdzie pokazuje go jego region;
• bierze agentów jako mówców, gotowych do dubbingu, a xml:lang pliku jako język projektu;
• odczytuje zadeklarowane w pliku kodowanie oraz encje HTML, takie jak  .

Plik, który nie jest poprawnym XML, otwiera się z komunikatem podającym wiersz i kolumnę. Plik, który w ogóle nie jest TTML, zgłasza to wprost.

Eksport TTML

Eksportuj, a następnie Napisy i TTML lub DFXP, oferuje:

• TekstOryginał, tłumaczenie lub oba, z tłumaczeniem pod spodem.
• Nazwy mówcówPominięte, przed tekstem (Thom: …) albo jako agenci (ttm:agent), we własnym sposobie TTML.
• FormatowanieZachowane albo usunięte.
• Przesunięcie czasuKażdy napis wcześniej lub później o tyle samo.
• WyglądBiały z czarnym obrysem albo taki, jak rysuje go podgląd Subtitld: jego czcionka, kolor i półprzezroczyste tło.

Plik to TTML 1 w UTF-8. Czasy zapisane są jako 00:00:23.000, każde miejsce napisów jako region, formatowanie jako span, a podziały wierszy jako <br/>. Jego xml:lang to język tekstu, który zawiera. TTML i DFXP dostają ten sam plik; różni się tylko rozszerzenie.

TTML czy WebVTT?

WebVTT dla <track> na stronie internetowej: przeglądarki czytają go same. TTML dla nadawców, dla serwisów strumieniowych, które go wymagają, oraz dla odtwarzaczy, które go czytają, na przykład dash.js i Shaka Player. Strona WebVTT opisuje resztę.

Ciekawostki