Deployed 94dfb5d6 with MkDocs version: 1.6.1

This commit is contained in:
2026-11-13 21:41:06 +00:00
parent 4496eab53b
commit 5cdd11e13f
3 changed files with 18 additions and 4 deletions
+1 -1
View File
@@ -3019,7 +3019,7 @@ and <code>descriptive</code>. <code>Audio.Codec</code> covers <code>AAC</code>,
(subtitles for the deaf and hard-of-hearing), and <code>forced</code>. A track cannot be both <code>cc</code>
and <code>sdh</code>, and <code>forced</code> cannot combine with either. <code>Subtitle.Codec</code> includes <code>SubRip</code>
(SRT), <code>WebVTT</code> (VTT), <code>SubStationAlpha</code>/<code>SubStationAlphav4</code> (SSA/ASS),
<code>TimedTextMarkupLang</code> (TTML), <code>SAMI</code>, and the box-encapsulated DASH formats <code>fTTML</code>
<code>TimedTextMarkupLang</code> (TTML), <code>SAMI</code>, <code>SCC</code>, and the box-encapsulated DASH formats <code>fTTML</code>
(STPP) and <code>fVTT</code> (WVTT). Subtitles receive post-download normalization
(segment merging, WebVTT sanitization, format conversion, and optional SDH stripping),
all documented for users in <a href="../../guide/subtitles/">Subtitles</a>.</p>
+16 -2
View File
@@ -2541,6 +2541,12 @@ shown in track listings. The <strong>Extension</strong> column is the file exten
<td>TMP</td>
</tr>
<tr>
<td><code>SCC</code></td>
<td>SCC</td>
<td><code>scc</code></td>
<td>Scenarist Closed Captions (CEA-608), read only</td>
</tr>
<tr>
<td><code>fTTML</code></td>
<td>STPP</td>
<td><code>stpp</code></td>
@@ -2588,6 +2594,13 @@ format-appropriate clean-up to make a single, valid file:</p>
output format, unshackle automatically converts any plain TTML track to WebVTT before
muxing (the closest lossless equivalent). Boxed <code>fTTML</code> is likewise unwrapped to TTML
first.</li>
<li><strong>SCC for muxing</strong>: Matroska cannot carry SCC, and no later step can read it. Before
muxing, unshackle converts an SCC track straight to the <code>--sub-format</code> you request
when that is SRT, WebVTT or TTML, and to SRT in all other cases (no <code>--sub-format</code>,
<code>original</code>, or another format, which unshackle then makes from the SRT). Choose
<code>--sub-format vtt</code> to keep the caption rows: WebVTT keeps a top-of-screen caption at
the top, SRT does not. unshackle reads only the CC1 channel. An SCC file with no CC1
captions gives an empty track and a warning.</li>
</ul>
<p>You normally do not need to think about any of this. It gives a clean file.</p>
<h2 id="selecting-and-filtering-subtitles">Selecting and filtering subtitles<a class="headerlink" href="#selecting-and-filtering-subtitles" title="Permanent link">&para;</a></h2>
@@ -2909,8 +2922,9 @@ styling that survives. <code>—</code> means that the backend cannot convert th
</table>
<p>Reading the table:</p>
<ul>
<li><strong>Keep the original</strong>: leaving <code>--sub-format</code> unset (or set to <code>original</code>) never
round-trips the file, so every style survives. Only convert when your player cannot
<li><strong>Keep the original</strong>: leaving <code>--sub-format</code> unset (or set to <code>original</code>) does not
round-trip the file, so every style survives. TTML and SCC are the exceptions, as noted
above. Only convert when your player cannot
read the source format.</li>
<li><strong><code>subtitleedit</code></strong> (SubtitleEdit / <code>seconv</code>): the best choice for anything → SRT. It
is the only backend that carries colour, and it embeds <code>{\an8}</code> tags to preserve
File diff suppressed because one or more lines are too long