Deployed b8824b8 with MkDocs version: 1.6.1

This commit is contained in:
2026-08-02 16:58:22 +00:00
parent ff93cb6ba1
commit c567003838
12 changed files with 376 additions and 170 deletions
+11 -7
View File
@@ -6471,7 +6471,9 @@ It provides convenience functions for listing, sorting, and selecting tracks.</p
<a href="#unshackle.core.tracks.Tracks.sort_subtitles" class="headerlink" title="Permanent link">&para;</a></h3>
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">sort_subtitles</span><span class="p">(</span><span class="n">by_language</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">type_priority</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">sort_subtitles</span><span class="p">(</span>
</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a> <span class="n">by_language</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">type_priority</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">group_by</span><span class="o">=</span><span class="kc">None</span>
</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="p">)</span>
</span></code></pre></div>
<div class="doc doc-contents ">
@@ -6489,18 +6491,20 @@ You may optionally provide a sequence of languages to prioritize to the top.</p>
</ul>
</details>
<details class="language-group-order" open>
<summary>Language Group Order</summary>
<details class="type-order" open>
<summary>Type Order</summary>
<ul>
<li>Forced</li>
<li>Normal</li>
<li>Hard of Hearing (SDH/CC)
(Least to most captions expected in the subtitle)</li>
</ul>
</details> <p>type_priority overrides the Language Group Order with an explicit ranking of
"forced", "normal", and "sdh" (cc counts as sdh); unlisted types fall to the end.
The first track after sorting receives the default flag at mux time, so this also
controls which subtitle type becomes default.</p>
</details> <p>type_priority overrides the Type Order with an explicit ranking of "forced",
"normal", and "sdh" (cc counts as sdh); unlisted types fall to the end.</p>
<p>group_by sets the major key. "type" (default) keeps every forced track together,
then every normal, then every SDH, each block ascending by language. "language"
groups by language instead, so Finnish sits next to Finnish SDH, with the Type
Order applied inside each language.</p>
</div>