跳至主要內容
SubtitleMatrix

CSV 轉 TTML

或者貼上字幕文字

這次轉換會改變什麼

這個方向不會遺失內容 —— 來源格式的每一項特性在目標格式裡都有地方可去。

這份清單來自這兩種格式的能力矩陣,而不是你載入的這份具體檔案。如果具體檔案用到了格式允許、但矩陣沒有建模的特性,可能會遺失更多。

這一頁把 CSV 表格轉成 TTML。表格用表頭認出開始時間、結束時間與正文;沒有表頭時就按 start、end、text 的順序讀。轉換全程在瀏覽器裡完成,不上傳、不需要帳號。

這個方向不丟東西:CSV 能表達的每一項,TTML 都接得住,時間軸、換行與文字都會原樣過去,連引號裡的逗號也不例外。上方清單因此沒有東西可列。

時間碼寫到毫秒;正文裡的逗號會強制整個欄位加上雙引號,換行也留在同一格裡,讀回時才不會被拆成兩條。單檔可以,整季也可以:佇列依序處理,結果打包成一個 ZIP。

範例

一份典型的 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 輸入

輸入

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>

真實檔案常有混合換行、多餘空白與空欄位,這份輸入就是那個樣子;可以對照上面那份乾淨範例,看看解析器容忍到哪裡。

常見問題

CSV 轉成 TTML 的產物長什麼樣子?

TTML 沒有編號:每一條字幕是 <p begin="…" end="…"> 元素,放在 <body>(通常還有 <div>)裡,整份檔案上面有 XML 宣告。CSV 的每一條 cue 依序變成一個 <p>。

CSV 轉 TTML 時,時間碼會失真嗎?

不會。CSV 與 TTML 都寫 00:00:04.126,時間碼逐字相同,不會四捨五入。

CSV 裡同一條字幕的兩行,轉成 TTML 後還綁在一起嗎?

CSV 轉 TTML:還是一條。兩行之間放 <br/>,這在同一個 <p> 裡就是硬換行,播放器會一起顯示。

CSV 的 cue 順序在 TTML 檔裡會重排嗎?

會按開始時間排序,最早的在前。CSV 的每一條字幕進到 TTML 都照這個順序寫;若原檔本來是亂的,產物會把它們排回正確順序——改的是結構,不是內容,這也是本站每個格式共用的讀檔順序。

把 TTML 轉回 CSV 會丟東西嗎?

會。TTML 能存樣式、定位與格式私有內容(XML 宣告、body/div 分組),這些在 CSV 裡都沒有落點;去程無損,回程不是。

CSV 轉 TTML 的產物用什麼編碼與換行?

一律是 UTF-8、Unix 換行(LF)、不帶 BOM,不管 CSV 原檔用什麼。若輸入是 UTF-16 或 Windows 單一位元編碼,讀入時會先解碼,結果面板會說明;TTML 產物永遠是同一種 UTF-8。

相關工具