Конвертер CSV в TTML
Или вставьте текст субтитров
Что меняет эта конвертация
В этом направлении ничего не теряется — у каждой возможности исходного формата есть куда перейти в целевом.
Этот список выведен из матрицы возможностей этих двух форматов, а не из загруженного файла. Конкретный файл может потерять больше, если использует возможности, которые формат допускает, а матрица не моделирует.
Здесь субтитры CSV превращаются в TTML: CSV — это таблица, которую открывает любой редактор электронных таблиц, а TTML — XML-формат для вещания и стриминга, где время и оформление заданы атрибутами. CSV записывает интервал (00:00:01.000,00:00:03.500), а TTML хранит его в атрибутах begin="00:00:01.000" и end="00:00:03.500". Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
В этом направлении ничего не теряется: позиционирования в CSV нет, караоке в исходнике отсутствует, полный интервал и многострочный текст TTML хранит, а CSV не содержит ничего, чего TTML не умел бы.
Ни один байт субтитров не уходит в сеть: конвертация выполняется в текущей вкладке, а готовые файлы забираются архивом.
Примеры
Обычный файл CSV, переведённый в TTML
Вход
start,end,text
00:00:01.000,00:00:03.500,The quick brown fox.
00:00:04.000,00:00:06.250,"Jumps over, the lazy dog."
00:00:07.000,00:00:09.000,"Two lines here.
And a second one."
Выход
<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling">
<body>
<p begin="00:00:01.000" end="00:00:03.500">The quick brown fox.</p>
<p begin="00:00:04.000" end="00:00:06.250">Jumps over, the lazy dog.</p>
<p begin="00:00:07.000" end="00:00:09.000">Two lines here.<br/>And a second one.</p> </body>
</tt>
Сравните две стороны: CSV записывает время как 00:00:01.000, TTML — как begin="00:00:01.000"; текст и порядок реплик при этом сохраняются.
Тот же перевод на неаккуратном файле CSV
Вход
id,start,end,note,text
1,00:00:01,000,00:00:04,000,cue one,"Hello there, friend."
2,00:00:05.000,00:00:07.000,cue two,Second line.
bad,notatime,00:00:09.000,cue three,Unreadable start.
4,00:00:10.000,00:00:09.000,cue four,End before start.
5,00:00:12.000,00:00:14.000,cue five,Unquoted comma in text, right here.
Выход
<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling">
<body>
<p begin="00:00:01.000" end="00:00:04.000">Hello there, friend.</p>
<p begin="00:00:05.000" end="00:00:07.000">Second line.</p>
<p begin="00:00:10.000" end="00:00:10.001">End before start.</p>
<p begin="00:00:12.000" end="00:00:14.000">Unquoted comma in text, right here.</p> </body>
</tt>
Второй файл намеренно неровный: BOM, переводы строк CRLF. CSV читает его без падения, а TTML записывается заново, поэтому часть дефектов исчезает, но пропущенные блоки не возвращаются.
Частые вопросы
Какие таймкоды получатся на выходе при переводе CSV в TTML?
CSV записывает интервал (00:00:01.000,00:00:03.500), а TTML хранит его в атрибутах begin="00:00:01.000" и end="00:00:03.500". Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Какие данные CSV не переживут перевод в TTML?
Ничего: позиционирования в CSV нет, караоке в исходнике отсутствует, полный интервал и многострочный текст TTML хранит, а CSV не содержит ничего, чего TTML не умел бы. Текст, интервалы и порядок реплик переносятся один в один, а различие остаётся только в синтаксисе CSV и TTML.
Как сайт понимает колонки CSV при переводе в TTML?
В CSV роли колонок определяются по заголовку: start, end и text, причём допускаются синонимы. Всё, что не опознано как время или текст, не попадает в TTML; строки с нечитаемым временем пропускаются и учитываются в отчёте.
Что произойдёт с многострочными репликами CSV в файле TTML?
Оба формата хранят жёсткий перенос внутри реплики, поэтому две строки CSV останутся двумя строками в TTML; порядок реплик не меняется.
В какой кодировке сохраняется TTML и какое у него расширение при переводе из CSV?
Файл TTML записывается в UTF-8 без BOM с переводами строк LF и расширением .ttml; при чтении CSV сайт сам определяет BOM и стиль переводов строк и нормализует их. Кириллица и другие алфавиты сохраняются без замены символов.
Как реплики CSV выглядят внутри TTML?
TTML — это XML: каждая реплика становится элементом p с атрибутами begin="00:00:01.000" и end="00:00:03.500". Оформление CSV переносится в атрибуты tts и элементы span, а перенос строки — в br.