https://blog.ohtly.com/tags/calibre/ Recent content in Calibre on OHTLY Blog Hugo zh-cn Tue, 28 Jul 2026 14:28:50 +0800 https://blog.ohtly.com/posts/2026-07-28-epub-to-pdf-with-toc-front/ Tue, 28 Jul 2026 14:16:09 +0800 https://blog.ohtly.com/posts/2026-07-28-epub-to-pdf-with-toc-front/ <p>Calibre 的 <code>--pdf-add-toc</code> 会把目录页插在 PDF 末尾，方便打印但不适合电子阅读。EPUB 自带的目录书签完整，但同样落在尾部。</p> <p><code>--use-auto-toc</code> 用 XPath 自动生成目录，效果不稳定，经常只匹配到少量标题。</p> <h2 id="方案"> 方案 <a class="heading-link" href="#%e6%96%b9%e6%a1%88"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>两步处理：</p> <ol> <li>Calibre 转换（不加 <code>--pdf-add-toc</code>，保留 EPUB 自带目录）</li> <li>PyMuPDF 脚本把末尾目录页移到正文前方</li> </ol> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>ebook-convert input.epub output.pdf </span></span></code></pre></div><p>生成的文件目录页在最后两页，用以下脚本移动到第 3 页之后：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span><span style="color:#f92672">import</span> fitz </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>src <span style="color:#f92672">=</span> <span style="color:#e6db74">&#39;某书_with_toc.pdf&#39;</span> </span></span><span style="display:flex;"><span>dst <span style="color:#f92672">=</span> <span style="color:#e6db74">&#39;某书_with_toc_moved.pdf&#39;</span> </span></span><span style="display:flex;"><span>doc <span style="color:#f92672">=</span> fitz<span style="color:#f92672">.</span>open(src) </span></span><span style="display:flex;"><span>total <span style="color:#f92672">=</span> len(doc) </span></span><span style="display:flex;"><span>toc_start <span style="color:#f92672">=</span> total <span style="color:#f92672">-</span> <span style="color:#ae81ff">2</span> <span style="color:#75715e"># 目录页起始位置</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># 页面映射：旧页码 → 新页码</span> </span></span><span style="display:flex;"><span>old_to_new <span style="color:#f92672">=</span> {} </span></span><span style="display:flex;"><span>idx <span style="color:#f92672">=</span> <span style="color:#ae81ff">0</span> </span></span><span style="display:flex;"><span><span style="color:#66d9ef">for</span> old <span style="color:#f92672">in</span> range(<span style="color:#ae81ff">3</span>): <span style="color:#75715e"># 前3页：空白、扉页、格言页</span> </span></span><span style="display:flex;"><span> old_to_new[old] <span style="color:#f92672">=</span> idx; idx <span style="color:#f92672">+=</span> <span style="color:#ae81ff">1</span> </span></span><span style="display:flex;"><span><span style="color:#66d9ef">for</span> old <span style="color:#f92672">in</span> range(toc_start, total): <span style="color:#75715e"># 目录页</span> </span></span><span style="display:flex;"><span> old_to_new[old] <span style="color:#f92672">=</span> idx; idx <span style="color:#f92672">+=</span> <span style="color:#ae81ff">1</span> </span></span><span style="display:flex;"><span><span style="color:#66d9ef">for</span> old <span style="color:#f92672">in</span> range(<span style="color:#ae81ff">3</span>, toc_start): <span style="color:#75715e"># 正文</span> </span></span><span style="display:flex;"><span> old_to_new[old] <span style="color:#f92672">=</span> idx; idx <span style="color:#f92672">+=</span> <span style="color:#ae81ff">1</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>new_doc <span style="color:#f92672">=</span> fitz<span style="color:#f92672">.</span>open() </span></span><span style="display:flex;"><span>new_doc<span style="color:#f92672">.</span>insert_pdf(doc, <span style="color:#ae81ff">0</span>, <span style="color:#ae81ff">2</span>) <span style="color:#75715e"># 前3页</span> </span></span><span style="display:flex;"><span>new_doc<span style="color:#f92672">.</span>insert_pdf(doc, toc_start, total<span style="color:#f92672">-</span><span style="color:#ae81ff">1</span>) <span style="color:#75715e"># 目录页</span> </span></span><span style="display:flex;"><span>new_doc<span style="color:#f92672">.</span>insert_pdf(doc, <span style="color:#ae81ff">3</span>, toc_start<span style="color:#f92672">-</span><span style="color:#ae81ff">1</span>) <span style="color:#75715e"># 正文</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># 修正书签页码</span> </span></span><span style="display:flex;"><span>toc <span style="color:#f92672">=</span> doc<span style="color:#f92672">.</span>get_toc() </span></span><span style="display:flex;"><span>new_toc <span style="color:#f92672">=</span> [[lvl, title, old_to_new[page<span style="color:#f92672">-</span><span style="color:#ae81ff">1</span>]<span style="color:#f92672">+</span><span style="color:#ae81ff">1</span>] <span style="color:#66d9ef">for</span> lvl, title, page <span style="color:#f92672">in</span> toc] </span></span><span style="display:flex;"><span>new_doc<span style="color:#f92672">.</span>set_toc(new_toc) </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>new_doc<span style="color:#f92672">.</span>save(dst) </span></span></code></pre></div><h2 id="结果"> 结果 <a class="heading-link" href="#%e7%bb%93%e6%9e%9c"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <ul> <li>目录页位于扉页/格言页之后，正文之前</li> <li>书签数量不变，页码自动修正，点击跳转正确</li> </ul> <h2 id="注意事项"> 注意事项 <a class="heading-link" href="#%e6%b3%a8%e6%84%8f%e4%ba%8b%e9%a1%b9"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <ul> <li><code>--use-auto-toc</code> 的 <code>--level1-toc=&quot;//h:h1&quot;</code> 等 XPath 对 EPUB 内部结构依赖大，优先用自带目录</li> <li><code>set_toc</code> 需在 <code>insert_pdf</code> 完成后调用，页码为 1-based</li> <li>如果目录页不在末尾，需先确认 <code>toc_start</code> 位置（通过 <code>get_toc()</code> 或观察页内容）</li> </ul>