subtitle library 文档
2026-08-08  / project  / sub-lib

该页面由AI翻译并经过人工校对,你可能想要 查看原文

Subtitle Library

面向语言学习与媒体同步的时间对齐字幕库。GitHub

本仓库只提供字幕,不包含对应音视频——各主题 README 会说明如何下载媒体,以及如何与这些文件配套使用(与媒体同名,播放器即可自动加载)。

目录结构

1
2
3
4
<lang>/<theme>/
README.md
srt/ | txt/ | … # flat themes (e.g. EnglishPod)
S01/E01/srt/ | S01/E01/txt/ … # episodic themes (season → episode)
层级 含义 示例
1 语言 en
2 主题 / 系列 PascalCase,无空格或连字符:EnglishPod、DowntonAbbey
3+ 格式,或 季 → 集 → 格式 srt/,或 S01/E01/srt/

分集路径使用 Sxx/Exx/;字幕文件名仍用 SxxExx… 作为 basename,以便与媒体匹配。分集主题支持整集与 clip 命名;默认只发布 clip。

文件命名(与对应媒体同 basename,播放器可自动加载):

类型 模式 示例
完整单元 {id}.srt englishpod_0001dg.srt、S01E01.srt
Clip(1×) {id}-t{start}.srt S01E01-t001211.srt
Clip + 时长 {id}-t{start}-d{duration}.srt S01E01-t001211-d000200.srt
Clip + 倍速 {id}-t{start}-r{rate}.srt S01E01-t001211-r2.srt
Clip + 两者 {id}-t{start}-d{duration}-r{rate}.srt S01E01-t001211-d000200-r2.srt
字段 含义 何时使用
start clip 在源时间轴上的起点(HHMMSS) clip 一律必填
duration clip 文件时长(HHMMSS),不是源上的跨度 仅当两个 clip 共享同一 start 时
rate 相对源的播放倍速(如 2、1.5) 仅当 ≠ 1× 时

源上的结束时间不写在文件名里:end = start + duration × rate(省略 duration 时用媒体 / srt 长度)。所有主题都支持 clip 命名;短课往往只发完整文件,分集主题默认发 clip。详见 CONTEXT.md。

主题

路径 语言 说明
en/EnglishPod English EnglishPod Dialog 轨字幕
en/DowntonAbbey English 《唐顿庄园》clip 字幕(分集;也支持整集命名)

贡献

目录约定与主题 README 应覆盖的内容,见 CONTEXT.md。