如何在 Calibre 中使用 Ebook Translator 插件翻译 EPUB
安装并配置 Calibre 社区版 Ebook Translator 插件，翻译测试章节，并检查 EPUB 导航、注释、CSS 和输出结果。
快速回答：Calibre 可以通过社区插件翻译 EPUB
Calibre 本身不会直接翻译 EPUB。你需要安装一个社区插件，例如 Ebook Translator, EPUB，然后再处理整本书。
如果你想要本地控制，并且能够接受管理插件、引擎凭据、缓存和输出设置，就适合使用 Calibre。如果你想要更简单的上传到下载流程，而不想配置桌面端翻译环境，可以使用专门的 EPUB Translator。
Calibre 官方文档区分了一个重要事实：社区插件可以通过它的更新器提供，但它们并不属于 Calibre 本体，相关支持也由插件作者负责。应当把插件、Calibre 和翻译引擎视为三个彼此独立的组件，它们各自都有独立的故障模式。
什么时候适合使用 Calibre，什么时候不适合
在以下情况下，Calibre 很合适：
- 你已经在用 Calibre 管理书库；
- 这本书没有 DRM，且你合法拥有 EPUB 文件；
- 你希望自行选择翻译引擎；
- 你希望在本地检查或编辑 EPUB 包；
- 你接受较技术化的配置和排错流程。
在以下情况下，应选择专门的在线 EPUB 工作流：
- 你不想安装或维护插件；
- 你不想管理引擎密钥或使用额度限制；
- 你需要可预测的浏览器工作流；
- 你想在学习 Calibre 设置之前先快速测试；
- 另一个人必须在没有你本地环境的情况下重复这个流程。
这两种方式并不只是“免费和付费”的区别。Calibre 把更多配置和质量控制责任交给你。浏览器工具则把更多处理过程和产品决策交给服务方。
准备一个无 DRM 的 EPUB
不要一开始就试图把受商店保护的 Kindle 文件强行交给插件处理。你应该获取一个你拥有或获准翻译的无 DRM EPUB。
在导入之前：
- 用至少一个常规阅读应用打开这个 EPUB。
- 检查章节顺序和目录。
- 点击一个脚注及其返回链接。
- 确认图片和图片说明都能正常显示。
- 在 Calibre 书库之外保存一个备份。
这样可以建立源文件基线。如果原始 EPUB 的目录本来就损坏，那么翻译后的文件就无法证明问题是否由插件造成。
你可以使用我们的合成版 EPUB translation stress test。它包含三个章节、嵌套导航、交叉链接、一个脚注、CSS、元数据，以及用于一致性检查的重复虚构名称。
安装并添加 Ebook Translator 插件
Calibre 的菜单标签在不同版本之间可能会变化，但整体流程通常是：
- 打开 Calibre 偏好设置。
- 打开插件或高级插件区域。
- 在插件目录中搜索 Ebook Translator，或按照插件项目文档说明的安装方式进行安装。
- 安装插件，并在提示时重启 Calibre。
- 如果插件操作按钮不可见，就把它添加到主工具栏。
- 在配置引擎之前，确认插件版本和支持页面。
不要从无关镜像站下载插件 ZIP。应使用 Calibre 的更新器、插件的官方项目页面，或其文档说明的支持渠道。
配置翻译引擎和输出模式
翻译引擎决定语言覆盖范围、请求限制、成本，以及大部分措辞质量。插件则决定 EPUB 内容如何被切分、发送、缓存和重新组装。
在完整运行之前，记录这些设置：
- 源语言和目标语言；
- 翻译引擎和模型；
- 引擎认证方式；
- 请求或批处理大小；
- 重试行为；
- 术语表或自定义提示词；
- 单语或双语输出；
- 译文相对于原文的位置；
- 缓存和断点续跑行为；
- 输出文件名和格式。
一开始应使用保守的批处理设置。批次过大时，可能在已经完成大量工作的情况下整体失败；而切分得过小，又可能丢失章节上下文。不存在一个普适的最佳数值；正确设置取决于引擎和书籍本身。
绝不要在截图、日志、EPUB 元数据或共享配置文件中公开引擎密钥。
在整本书之前先翻译一个测试章节
选择一个不仅仅包含普通段落的章节。至少应包含以下之一：
- 斜体或强调；
- 图片和图片说明；
- 脚注；
- 带有重复角色名称的场景；
- 列表或表格；
- 依赖说话者上下文的对话。
运行翻译，把输出保存为新的文件名，并在你实际打算使用的阅读应用中检查结果。
分别检查两个问题：
- 目标语言的准确性是否足以满足这个使用场景？
- 导出的 EPUB 在结构上是否仍然可用？
一个语言流畅但 EPUB 结构损坏的章节，并不算成功的整书翻译。
单语输出与双语输出
普通阅读和最小文件体积适合只输出目标语言。审校或语言学习适合双语输出。
| 输出 | 最适合 | 主要风险 |
|---|---|---|
| 仅目标语言 | 阅读和后续出版处理 | 更难与原文逐句对照 |
| 原文后接译文 | 审校和语言学习 | 文件会变得长得多 |
| 译文后接原文 | 以目标语言为先的学习 | 原文会打断阅读流 |
| 并排显示 | 宽屏对照 | 在小型阅读器上兼容性较差 |
关于设备与 CSS 的取舍，请参阅专门的创建双语 EPUB指南。
检查目录、CSS、脚注和图片
在测试章节之后，以及完整运行之后，检查以下项目：
- EPUB 打开时没有修复警告。
- 目录可以跳转到正确章节。
- 章节顺序与源文件 spine 一致。
- 标题仍然使用标题样式。
- 斜体、粗体和链接都包裹了正确的目标语言短语。
- 脚注链接双向都可用。
- 图片仍然存在，图片说明仍然在附近。
- CSS 没有被重复到让文件变得不稳定。
- 标题、作者、封面和语言元数据正确。
- 重复出现的名称使用同一个已批准译法。
不要只检查 Calibre 的内置阅读器。至少再测试一个其他阅读系统，因为 CSS 和导航行为会有所不同。
常见插件错误与恢复步骤
| 症状 | 可能出问题的层 | 处理方式 |
|---|---|---|
| 请求失败或触发速率限制 | 翻译引擎 | 降低并发，检查凭据和配额 |
| 某些段落仍然保留源语言 | 插件切分、引擎拒绝，或运行中断 | 先查看插件日志并识别模式，再决定是否续跑 |
| 目录打开到错误章节 | EPUB 重建过程 | 将 nav.xhtml 目标与源文件进行对比 |
| 角色名称前后不一致 | 翻译上下文或术语表 | 添加已批准术语表，并重新检查每一章 |
| 竖排或 RTL 源样式仍然不合适 | 源 CSS 和输出方向 | 有意识地调整目标语言 CSS |
| 输出文件能在 Calibre 中打开，但不能在其他阅读器中打开 | EPUB 兼容性 | 校验包结构，并在目标设备上测试 |
不要继续用随机设置反复跑整本书。一次只改一个设置，重复同一个测试章节，并记录结果。
Calibre 与专用在线 EPUB Translator 的对比
| 决策项 | Calibre 插件 | 专用 EPUB 翻译器 |
|---|---|---|
| 配置成本 | 更高 | 更低 |
| 引擎选择 | 通常控制范围更广 | 由产品决定 |
| 本地工作流 | 很强 | 取决于服务 |
| 排错责任归属 | 主要由你承担 | 由产品工作流和支持承担 |
| 团队内可重复性 | 需要共享配置 | 通常更容易 |
| 最适合的人群 | 技术型用户 | 想要简单流程的读者、作者和团队 |
如需更广泛的工具选择，请参阅最佳 EPUB 翻译工具对比。如果你优先考虑免费方案，请查看免费 EPUB 翻译器指南。
常见问题
Calibre 默认会翻译 EPUB 电子书吗？
不会。Calibre 用于管理和转换电子书，但翻译需要社区插件和已配置好的翻译引擎。
Ebook Translator 插件是 Calibre 的一部分吗？
不是。它是一个社区插件。Calibre 可以通过其生态系统提供社区插件，但插件支持、行为和更新都来自插件项目本身。
我可以用 Calibre 免费翻译整本 EPUB 吗？
插件本身可能免费，但你选择的翻译引擎可能有自己的费用、配额、账户要求或速率限制。
Calibre 会保留目录吗？
有可能，但你必须测试导出的 EPUB。导航、脚注、CSS 和章节结构，与句子翻译质量是彼此独立的问题。
我可以把翻译后的 EPUB 发送到 Kindle 吗？
Amazon 目前通过受支持的 Kindle 工作流接受 EPUB，但在依赖它之前，应先验证文件，并在 Kindle Previewer 或你的设备上进行测试。平台要求可能会变化。
