Ebook Translator 是书伴开发的一款 Calibre 插件，可以将不同格式不同语言的电子书翻译成指定语言（原文译文对照）指定格式的电子书，支持 Google、ChatGPT 和 DeepL 翻译引擎。
在日常的生活、工作或学习中，如果在阅读或翻译外文电子书的过程中需要频繁使用翻译软件，在内容和翻译软件之间来回切换，可能会成为一件颇为痛苦的事。Ebook Translator 插件借力 Calibre 对电子书的强大处理功能和翻译引擎对多种语言的翻译支持，可以轻松将译文添加到原文段落之后，如下图那样形成双语对照，方便辅助对原文的理解或作为译制材料时的参考。
▲ Ebook Translator 插件翻译的电子书效果
借助 Calibre 对多种电子书格式的灵活支持，进行翻译时，你可以自由地选择输入输出格式，比如把 TXT 翻译成为 TXT 或 EPUB，把 PDF 翻译成 PDF 或 DOCX。
Ebook Translator 插件源代码使用 GPL v3 许可证。插件项目托管在GitHub上。
一、功能简介
★ Ebook Translator 插件主要包含以下功能：
支持“批量模式”和“高级模式”两种翻译模式，应用于不同使用场景支持所选翻译引擎所支持的语言（如 Google 翻译支持 134 种）支持多种翻译引擎，包括 Google 翻译、ChatGPT 以及 DeepL支持自定义翻译引擎（支持解析 JSON 和 XML 格式响应）支持所有 Calibre 所支持的电子书格式（输入格式 48 种，输出格式 20 种）支持批量翻译电子书，每本书的翻译过程同时进行互不影响支持缓存翻译内容，在请求失败或网络中断后无需重新翻译提供大量自定义设置，如将翻译的电子书存到 Calibre 书库或指定位置
★ Ebook Translator 插件支持翻译的语言：
Google 翻译支持的语言列表DeepL 翻译支持的语言列表ChatGPT 具体支持语言不详有道翻译支持的语言列表百度翻译支持的语言列表
★ Ebook Translator 插件支持的输入格式：
EPUB,AZW3,AZW4,MOBI,PDF,DOCX,TXT,MARKDOWN,RTF,RECIPE,HTML, HTM, XHTML, XHTM, TXTZ, CB7, ODT, RAR, FBZ, CBC, SHTM, TEXT, SHTML, POBI, UPDB, OPF, TCR, PML, PDB, CHM, SNB, LRF, LIT, RB, DOWNLOADED_RECIPE, CBR, DJV, DJVU, MD, AZW, TEXTILE, DOCM, HTMLZ, PMLZ, CBZ, ZIP, PRC, FB2
★ Ebook Translator 插件支持的输出格式：
EPUB,AZW3,MOBI,KFX,PDF,DOCX,TXT,RTF, OEB, TCR, PDB, SNB, LRF, TXTZ, LIT, RB, HTMLZ, PMLZ, ZIP, FB2
二、安装插件
首先确保你的操作系统已经安装了Calibre，然后通过一下任意方式安装本插件：
【方法一】通过 Calibre 安装
打开 Calibre 并依次点击其菜单【 首选项… → 插件 → 获取新的插件 】；在插件列表中选中 Ebook Translator 然后点击 【 安装 】 按钮（请留意，首次安装此插件时，要选择把图标显示在主工具栏上）；最后关闭并重新打开 Calibre 即可正常使用。【方法二】通过插件文件安装
Ebook Translator 插件下载：GitHub下载｜百度网盘｜本地下载｜Google DriveNAME: Ebook-Translator-Calibre-Plugin_v2.1.1.zipMD5: b569cf072fc93fe4dadbb62cbc334825SHA1: 812bcb51f6bf3ad0d56e8d5f619ec453ad40c2c8
首先在通过以上链接下载插件文件；然后打开 Calibre 并依次点击其菜单【首选项→插件→从文件加载插件】；在弹出的对话框中选择下载的扩展名为 .zip 的插件文件完成安装（请留意，首次安装此插件时，要选择把图标显示在主工具栏上）；最后关闭并重新打开 Calibre 即可正常使用。
如果你想安装最新的插件，可以运行以下命令从 GitHub 仓库中下载最新的插件文件：
git clone /bookfere/Ebook-Translator-Calibre-Plugin.gitcd Ebook-Translator-Calibre-Plugingit archive --format zip --output ../Ebook-Translator-Calibre-Plugin.zip master
如果安装插件后，插件图标未出现在 Calibre 的主工具栏上，可以依次点击 Calibre 的菜单【首选项 →工具与菜单】，在弹出的对话框中点击下拉菜单并选择“主工具栏”，然后在左栏找到并选中插件图标，点击中间的右箭头按钮【>】将其添加到右栏，最后点击【应用】按钮即可。
三、使用方法
Ebook Translator 提供了两种翻译模式，在开启缓存状态下两者共享同一缓存数据。
1、高级模式
在 Calibre 书库中选中要推送的电子书，点击 Calibre 主工具栏上的【翻译书籍】图标按钮，或点击图标下拉菜单选择【高级模式】；在弹出的提示框点击选择“高级模式”（首次打开）；选择“输入格式”和“输出格式”，点击【开始】进入“高级模式”翻译主界面；点击【删除】按钮删除需要忽略翻译的选中段落（可选）；通过以下两种方式进行翻译： 点击【翻译所选】按钮翻译选中的段落点击【翻译全部】按钮翻译全部电子书内容翻译完成后，在右方“校对”区域，通过编辑下方文本并点击【保存】，可以更改翻译结果；点击【输出】按钮，存储翻译完成后的电子书。输出任务将被推送添加到 Calibre 的任务队列。2、批量模式
在 Calibre 书库中选中要推送的电子书，点击 Calibre 主工具栏上的【翻译书籍】图标按钮，或点击图标下拉菜单选择【批量模式】；在弹出的提示框点击选择“批量模式”（首次打开）；进入插件主界面，在这里你可以修改“书名”（作为保存文件时使用的文件名），分别为每一本书选择“输入格式”、“输出格式”、“来源语言”（一般情况下“自动探测”即可满足需求）、“目标语言”（默认使用 Calibre 界面当前所用的语言）；点击下方的【翻译】按钮即可开始翻译。插件会将每本电子书的翻译任务推送添加到 Calibre 的任务队列，你可以通过点击 Calibre 右下角的【任务】查看推送详情，双击任务条目可以进入日志实时查看正在翻译的内容。
三、插件设置
▲ Ebook Translator 通用设置
▲ Ebook Translator 引擎设置
▲ Ebook Translator 内容设置
有关设置内容的详细说明请查阅 Ebook Translator 项目的 Wiki 页面。
/bookfere/Ebook-Translator-Calibre-Plugin/wiki/简体中文#设置说明
五、注意事项
开发 Ebook Translator 插件测试用的 Calibre 版本是 3.48 和最新版版本，因此理论上插件在 3.x 到 6.x 版本的 Calibre 中都能正常使用，但是如果版本低于 3.x，可能无法正常使用。
尽管 Ebook Translator 插件在发布前尽可能做了可用性测试，但是限于用来测试的电子书数量，仍无法保证在任何情况下运行结果不会出现问题。如果你在使用插件的过程中遇到了问题，欢迎留言详述问题。如果有好的建议或想要贡献代码，也欢迎访问 GitHub 上的插件项目。
六、常见问题
1、翻译文件丢失
有些用户反馈翻译完成后无法打开文件，此问题通常发生在 Windows 系统上。在 Windows 系统中，有一个功能叫做 “存储感知”，它会自动清理长时间运行程序的临时文件。你可以尝试关掉此功能，或通过 Calibre 的环境变量CALIBRE_TEMP_DIR为其重新指定一个文件夹。(credit)
2、翻译速度太慢
你可以根据自己的需要和翻译引擎的限制在设置中设定并发请求数量以加快翻译速度。
3、合并翻译效果
在使用 ChatGPT 时合并翻译功能表现较差，这是因为插件会在合并后的文本中添加标记，由于无法保证 ChatGPT 翻译这些文本后仍会保留这些标记，因此无法保证最终的翻译效果。因此，如果要使用的 ChatGPT 翻译电子书，不建议开启合并翻译功能。
