Ebook Translator：用 Calibre 翻译多格式双语对照电子书

更新时间： 编辑：书伴 分类：辅助软件 315 条留言
Ebook Translator：用 Calibre 翻译多格式双语对照电子书
2024.03.15 / 版本更新 / v2.4.0
  1. 自动获取可用的 GenAI 模型列表；
  2. 在引擎中添加新版 Google Translate API；
  3. 添加 ChatGPT 批量翻译功能；
  4. 添加内置引擎 DeepSeek.感谢 @jcodingSpace；
  5. 将 Gemini API 版本更改为 v1beta；
  6. 移除所有兼容 Python 2.x 和 PyQt5 的代码；
  7. 将插件窗口设置存储在 Calibre 插件文件夹中；
  8. 改进各类 GenAI 模型的提示词。感谢 @seidnerj；
  9. 更新西班牙语 UI 翻译。感谢 @Dunhill69；
  10. 支持 Gemini Flash。感谢 @Kentoseth；
  11. 更新 Google Translate 引擎的支持语言；
  12. 更新 DeepL 的支持语言；
  13. 修复导致电子书输出失败的 XML 命名空间错误；
  14. 修复段落换行翻译问题；
  15. 修复 Google Translate ADC 结果中的特殊字符丢失问题；
  16. 其他错误修复和功能增强。（c4808c7…d2583ba）

Ebook Translator 是书伴开发的一款 Calibre 插件，可以将不同格式不同语言的电子书翻译成指定语言（原文译文对照）指定格式的电子书，支持 Google、ChatGPT 和 DeepL 翻译引擎。

在日常的生活、工作或学习中，如果在阅读或翻译外文电子书的过程中需要频繁使用翻译软件，在内容和翻译软件之间来回切换，可能会成为一件颇为痛苦的事。Ebook Translator 插件借力 Calibre 对电子书的强大处理功能和翻译引擎对多种语言的翻译支持，可以轻松将译文添加到原文段落之后，如下图那样形成双语对照，方便辅助对原文的理解或作为译制材料时的参考。

Ebook Translator插件翻译的电子书效果

▲ 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 插件支持翻译的语言：

★ 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，SRT，PGN

★ Ebook Translator 插件支持的输出格式：

EPUB, AZW3, MOBI, KFX, PDF, DOCX, TXT, RTF, OEB, TCR, PDB, SNB, LRF, TXTZ, LIT, RB, HTMLZ, PMLZ, ZIP, FB2，SRT，PGN

二、安装插件

首先确保你的操作系统已经安装了 Calibre，然后通过一下任意方式安装本插件：

【方法一】通过 Calibre 安装

  1. 打开 Calibre 并依次点击其菜单【 首选项… → 插件 → 获取新的插件 】；
  2. 在插件列表中选中 Ebook Translator 然后点击 【 安装 】 按钮（请留意，首次安装此插件时，要选择把图标显示在主工具栏上）；
  3. 最后关闭并重新打开 Calibre 即可正常使用。

【方法二】通过插件文件安装

NAME: Ebook-Translator-Calibre-Plugin_v2.2.0.zip
MD5: 4eda05385bf2f49d1b8a066b9795e3ab
SHA1: e9bcfc0d02c51dc7dd7d9de9a1f4b0c12e3f6ba0
  1. 首先在通过以上链接下载插件文件；
  2. 然后打开 Calibre 并依次点击其菜单【首选项 → 插件 → 从文件加载插件】；
  3. 在弹出的对话框中选择下载的扩展名为 .zip 的插件文件完成安装（请留意，首次安装此插件时，要选择把图标显示在主工具栏上）；
  4. 最后关闭并重新打开 Calibre 即可正常使用。

如果想安装最新版本，可以访问 https://translator.bookfere.com 点击按钮【Rolling Release】下载。注意，最新版本在每次提交代码时自动生成，未经过严格测试，可能会存在错误。

如果安装插件后，插件图标未出现在 Calibre 的主工具栏上，可以依次点击 Calibre 的菜单【首选项 → 工具与菜单】，在弹出的对话框中点击下拉菜单并选择“主工具栏”，然后在左栏找到并选中插件图标，点击中间的右箭头按钮【>】将其添加到右栏，最后点击【应用】按钮即可。

三、使用方法

Ebook Translator 提供了两种翻译模式，在开启缓存状态下两者共享同一缓存数据。

1、高级模式

Ebook Translator 高级模式

  1. 在 Calibre 书库中选中要推送的电子书，点击 Calibre 主工具栏上的【翻译书籍】图标按钮，或点击图标下拉菜单选择【高级模式】；
  2. 在弹出的提示框点击选择“高级模式”（首次打开）；
  3. 选择“输入格式”和“输出格式”，点击【开始】进入“高级模式”翻译主界面；
  4. 点击【删除】按钮删除需要忽略翻译的选中段落（可选）；
  5. 通过以下两种方式进行翻译：
    • 点击【翻译所选】按钮翻译选中的段落
    • 点击【翻译全部】按钮翻译全部电子书内容
  6. 翻译完成后，在右方“校对”区域，通过编辑下方文本并点击【保存】，可以更改翻译结果；
  7. 点击【输出】按钮，存储翻译完成后的电子书。输出任务将被推送添加到 Calibre 的任务队列。

2、批量模式

Ebook Translator 批量模式

  1. 在 Calibre 书库中选中要推送的电子书，点击 Calibre 主工具栏上的【翻译书籍】图标按钮，或点击图标下拉菜单选择【批量模式】；
  2. 在弹出的提示框点击选择“批量模式”（首次打开）；
  3. 进入插件主界面，在这里你可以修改“书名”（作为保存文件时使用的文件名），分别为每一本书选择“输入格式”、“输出格式”、“来源语言”（一般情况下“自动探测”即可满足需求）、“目标语言”（默认使用 Calibre 界面当前所用的语言）；
  4. 点击下方的【翻译】按钮即可开始翻译。

插件会将每本电子书的翻译任务推送添加到 Calibre 的任务队列，你可以通过点击 Calibre 右下角的【任务】查看推送详情，双击任务条目可以进入日志实时查看正在翻译的内容。

三、插件设置

Ebook Translator 通用设置

▲ Ebook Translator 通用设置

Ebook Translator 引擎设置

▲ Ebook Translator 引擎设置

Ebook Translator 内容设置

▲ Ebook Translator 内容设置

有关设置内容的详细说明请查阅 Ebook Translator 项目的 Wiki 页面。

五、注意事项

开发 Ebook Translator 插件测试用的 Calibre 版本是 3.48 和最新版版本，因此理论上插件在 3.x 到 6.x 版本的 Calibre 中都能正常使用，但是如果版本低于 3.x，可能无法正常使用。

尽管 Ebook Translator 插件在发布会尽可能测试，但仍无法保证在任何情况下不会出现问题。

如果你在使用插件的过程中遇到了问题或有好的建议，欢迎报告错误或提交功能请求。

六、常见问题

1、翻译文件丢失

有些用户反馈翻译完成后无法打开文件，此问题通常发生在 Windows 系统上。在 Windows 系统中，有一个功能叫做 “存储感知”，它会自动清理长时间运行程序的临时文件。

为避免此问题，请通过插件的缓存管理器为缓存另外指定文件夹（请勿选择任何临时目录）。

2、翻译速度太慢

普通翻译服务（如 Google Translate）翻译 1000 个段落通常仅需不到 1 分钟的时间。如果你使用的是 ChatGPT 之类的生成式 AI，耗时则有较大的差异，建议根据服务的速率限制在设置中修改并发请求和请求间隔以加快翻译速度。另外，也可开启合并段落功能大幅提升翻译速度。

3、合并翻译效果

在使用 ChatGPT 时合并翻译功能表现较差，这是因为插件会在合并后的文本中添加标记，由于无法保证 ChatGPT 翻译这些文本后仍会保留这些标记，因此无法保证最终的翻译效果。因此，如果要使用的 ChatGPT 翻译电子书，不建议开启合并翻译功能。

七、更新日志：

2025.03.15 / v2.4.0

  1. 自动获取可用的 GenAI 模型列表；
  2. 在引擎中添加新版 Google Translate API；
  3. 添加 ChatGPT 批量翻译功能；
  4. 添加内置引擎 DeepSeek.感谢 @jcodingSpace；
  5. 将 Gemini API 版本更改为 v1beta；
  6. 移除所有兼容 Python 2.x 和 PyQt5 的代码；
  7. 将插件窗口设置存储在 Calibre 插件文件夹中；
  8. 改进各类 GenAI 模型的提示词。感谢 @seidnerj；
  9. 更新西班牙语 UI 翻译。感谢 @Dunhill69；
  10. 支持 Gemini Flash。感谢 @Kentoseth；
  11. 更新 Google Translate 引擎的支持语言；
  12. 更新 DeepL 的支持语言；
  13. 修复导致电子书输出失败的 XML 命名空间错误；
  14. 修复段落换行翻译问题；
  15. 修复 Google Translate ADC 结果中的特殊字符丢失问题；
  16. 其他错误修复和功能增强。（c4808c7…d2583ba）

2024.06.14 / v2.3.5

  1. 添加“开启/关闭”翻译元数据的选项；
  2. 更新土耳其语界面翻译；归功于 @DogancanYr
  3. 修复因缺少命名空间导致的输出错误；
  4. 修复无法重试翻译失败条目的错误；
  5. 修复无法正确显示自定义引擎配置的错误；

+ 展开全部…

© 「书伴」原创文章，转载请注明出处及原文链接：https://bookfere.com/post/1057.html

延伸阅读

给这篇文章写一条留言

提示：带 * 标记的是必填项。您填写的邮箱地址将会被保密。首次留言将会在通过人工审核后显示。如果是提出问题，请务必提供尽可能多信息，这有助于他人更好地理解你所提出的问题。

小伙伴们写下了 315 条留言

  2. chatgpt api 测试的时候 无法解析返回的响应。原始数据： 这问题该怎么解决？

    回复

    • 存在同样的问题：无法解析返回的响应。原始数据：HTTP Error 403: Forbidden

      回复

  3. 碰到了bad escape的问题：
    [自动探测 > Chinese (Simplified)] 翻译 “Capital Wars: The Rise of Global Liquidity”
    InputFormatPlugin: EPUB Input running
    on D:\BOOK\Michael J. Howell\Capital Wars_ The Rise of Global Liq (2)\Capital Wars_ The Rise of Globa – Michael J. Howell.epub
    Found HTML cover OEBPS/html/Cover.xhtml
    Parsing all content…
    Merging user specified metadata…
    Detecting structure…
    Flattening CSS and remapping font sizes…
    Source base font size is 12.00000pt
    Removing fake margins…
    Cleaning up manifest…
    Trimming unused files from manifest…
    Trimming ‘OEBPS/navigation.xhtml’ from manifest
    Trimming ‘OEBPS/toc.ncx’ from manifest
    Trimming ‘OEBPS/css/sidebar.gif’ from manifest
    Creating EPUB Output…
    Translating ebook content … (this will take a while)

    | Input Path: D:\BOOK\Michael J. Howell\Capital Wars_ The Rise of Global Liq (2)\Capital Wars_ The Rise of Globa – Michael J. Howell.epub
    | Output Path: C:\Users\zghsy\AppData\Local\Temp\calibre_8iaonvc5\y5ch9bin.epub

    翻译已完成。
    Traceback (most recent call last):
    File “sre_parse.py”, line 1039, in parse_template
    KeyError: ‘\\D’

    During handling of the above exception, another exception occurred:

    Traceback (most recent call last):
    File “runpy.py”, line 196, in _run_module_as_main
    File “runpy.py”, line 86, in _run_code
    File “site.py”, line 83, in
    File “site.py”, line 78, in main
    File “site.py”, line 50, in run_entry_point
    File “calibre\utils\ipc\worker.py”, line 215, in main
    File “calibre\utils\ipc\worker.py”, line 150, in arbitrary_n
    File “calibre_plugins.ebook_translator.convertion”, line 94, in convert_book
    File “calibre\ebooks\conversion\plumber.py”, line 1281, in run
    File “calibre_plugins.ebook_translator.convertion”, line 88, in convert
    File “calibre_plugins.ebook_translator.element”, line 328, in add_translations
    File “calibre_plugins.ebook_translator.element”, line 118, in add_translation
    File “re.py”, line 209, in sub
    File “re.py”, line 326, in _subx
    File “re.py”, line 317, in _compile_repl
    File “sre_parse.py”, line 1042, in parse_template
    re.error: bad escape \D at position 119

    回复

  5. v2.0.1
    不理解，为什么它只是解释内容而不是翻译内容，我用的是默认的prompt

    原文：Head position
    译文：The position of the head refers to the orientation of the head in space relative to the rest of the body. The head can be in various positions depending on what the individual is doing or what their body needs. Common head positions include upright, tilted, rotated, flexed (chin towards chest), extended (chin lifted up), and turned (looking over the shoulder). Correct head posture is important for maintaining spinal alignment and reducing strain on the neck and back. A neutral head position is typically recommended, with the ears aligned over the shoulders and the chin level with the ground.

    回复

    • 这个问题类似 Issue #20，你可以尝试在设置中修改 ChatGPT 的提示词来调整 ChatGPT 的回复，比如：Translate the content only; do not provide explanations for terms or answer questions.（只翻译内容，不要解释名词或回答问题）

      回复

  6. 完成翻译导出文件时报错:

    calibre, version 6.20.0
    错误： 未处理的异常: KeyError:<calibre.utils.ipc.job.ParallelJob object at 0x000002AFA9A1A980>

    calibre 6.20 embedded-python: True
    Windows-10-10.0.19041-SP0 Windows (’64bit’, ‘WindowsPE’)
    (‘Windows’, ’10’, ‘10.0.19041’)
    Python 3.10.1
    Windows: (’10’, ‘10.0.19041’, ‘SP0’, ‘Multiprocessor Free’)
    Interface language: zh_CN
    Successfully initialized third party plugins: Ebook Translator (2, 0, 1) && Mass Search-Replace (1, 7, 3)
    Traceback (most recent call last):
    File “calibre\gui2\__init__.py”, line 721, in dispatch
    File “calibre_plugins.ebook_translator.components.worker”, line 55, in translate_done
    KeyError:

    回复

      • 我是批量翻译的,如果不报错,那就会正常保存到书库内,但是只要有http429,就会每个文件都翻译完毕保存后报错.还好有缓存

        回复

    • 我也遇到了完成翻译导出文件时报错的问题，使用的是2.02版本的插件：
      ==============================
      翻译已完成。
      Traceback (most recent call last):
      File “sre_parse.py”, line 1039, in parse_template
      KeyError: ‘\\m’

      During handling of the above exception, another exception occurred:

      Traceback (most recent call last):
      File “runpy.py”, line 196, in _run_module_as_main
      File “runpy.py”, line 86, in _run_code
      File “site.py”, line 83, in
      File “site.py”, line 78, in main
      File “site.py”, line 50, in run_entry_point
      File “calibre\utils\ipc\worker.py”, line 215, in main
      File “calibre\utils\ipc\worker.py”, line 150, in arbitrary_n
      File “calibre_plugins.ebook_translator.convertion”, line 94, in convert_book
      File “calibre\ebooks\conversion\plumber.py”, line 1281, in run
      File “calibre_plugins.ebook_translator.convertion”, line 88, in convert
      File “calibre_plugins.ebook_translator.element”, line 328, in add_translations
      File “calibre_plugins.ebook_translator.element”, line 118, in add_translation
      File “re.py”, line 209, in sub
      File “re.py”, line 326, in _subx
      File “re.py”, line 317, in _compile_repl
      File “sre_parse.py”, line 1042, in parse_template
      re.error: bad escape \m at position 63

      回复

  7. 自定义翻译引擎能不能支持将多段原文作为一个数组请求，而返回的译文也是一个数组这种情况呢？火山翻译的API就是这样。或者为合并翻译功能添加一个子选项，如果API原生就支持一次翻译多段文字，就按这种方式构造请求？

    回复

  8. 在使用高级模式时,我有一个很有意思的想法:
    选择合并需要的段落来进行合并翻译,这样得到的翻译质量会更高.特别是DeepL,但是却不知道能不能保证格式段落和图片位置的正确.

    回复

  9. 嗨您好，我点击translate然后显示翻译失败，原因是fail to retrieve data from translate engine API, 请问这个该怎么办呢？

    回复

      • 是这个莫？

        calibre, version 5.44.0 (darwin, embedded-python: True)
        Translation Failed: 失敗: Failed to retreive data from translate engine API. Can not parse returned response. Raw data:

        Traceback (most recent call last):
        File “mechanize/_urllib2_fork.py”, line 1236, in do_open
        File “http/client.py”, line 1255, in request
        File “http/client.py”, line 1301, in _send_request
        File “http/client.py”, line 1250, in endheaders
        File “http/client.py”, line 1010, in _send_output
        File “http/client.py”, line 950, in send
        File “http/client.py”, line 1417, in connect
        File “http/client.py”, line 921, in connect
        File “socket.py”, line 808, in create_connection
        File “socket.py”, line 796, in create_connection
        socket.timeout: timed out

        During handling of the above exception, another exception occurred:

        Traceback (most recent call last):
        File “calibre_plugins.ebook_translator.engines.base”, line 143, in get_result
        self.br.open(request)
        File “mechanize/_mechanize.py”, line 257, in open
        File “mechanize/_mechanize.py”, line 287, in _mech_open
        File “mechanize/_opener.py”, line 193, in open
        File “mechanize/_urllib2_fork.py”, line 425, in _open
        File “mechanize/_urllib2_fork.py”, line 414, in _call_chain
        File “mechanize/_urllib2_fork.py”, line 1283, in https_open
        File “mechanize/_urllib2_fork.py”, line 1240, in do_open
        urllib.error.URLError:

        During handling of the above exception, another exception occurred:

        Traceback (most recent call last):
        File “calibre_plugins.ebook_translator.translation”, line 73, in _translate_text
        return self.translator.translate(text)
        File “calibre_plugins.ebook_translator.engines.google”, line 45, in translate
        return self.get_result(self.endpoint, data, headers)
        File “calibre_plugins.ebook_translator.engines.base”, line 155, in get_result
        raise Exception(
        Exception: Can not parse returned response. Raw data:

        回复

        • 从错误信息看是你的网络无法正常访问翻译引擎，可能需要在设置中填写并开启网络代理？

          回复

  11. 请问在使用chatgpt翻译的时候，经常翻译几段就弹出来“没有可用的api秘钥”，如何解决？

    回复

  12. 更新完之后,速度慢了,比1.3.8慢三倍.经过测试,三千个段落的书籍,原来一小时就可以完成,现在要三小时往上.
    还是回滚老版本了

    回复

    • 这是因为在之前的版本中，设置中的请求间隔没对 ChatGPT 生效。想要和之前的一样，可以前往插件的【设置 → 通用 → HTTP 请求】设置项，把“最大间隔”设为 0。

      回复

  13. v2.0.0 版本的chatgpt翻译不好用，翻译完一句话后总是会带上(Translated from {slang} to {tlang})

    回复

  15. 请问，如果用chatGPT合并翻译之前，先在提示词里告诉它不要吞掉分隔符（{{id_11}}这类符号），它是否就能完美排版了呢？您能教我“ 不能删掉分隔符”具体要怎么表达才能让ChatGPT听懂？

    回复

    • 有一点奇怪的是，我用ChatGPT中译日时，合并翻译设定500字、来源语言自动检测、输出语言日语，翻译完的排班完全不会出错（我让它翻译了五百多条了，排版没乱）。而一旦来源语言设置简体中文，排版就会成为一坨一坨的。同样，以此类推，我发现只要来源或输出语言选择了简体中文或英语，排版都会乱（我只会中英日三门语言，所以只试了三种）。由此可见，排版和提示词不无关系吧。

      回复

      • 插件的 v2.0.0 版本优化了 ChatGPT 的提示词，请下载试用。

        另外，新版本插件还新增 ChatGPT 的 temperature 设置，OpenAI 默认是 1，你可以尝试调低这个数值以防止它吃掉 ID，我测试的时候发现改成 0.5 效果不错。

        回复

          • 新版本发布后通常留一天的时间让用户测试，没有严重问题才会添加 Calibre 插件列表中，因此之前你没能通过 Calibre 的插件管理功能升级。刚刚插件已经上传到了 Calibre 的插件列表中，等一个小时左右应该就可以升级到最新版本了。

            回复

      • 开了代理，还是不行。之前我用DeepL(Free）翻译的字符并不多，只英译中了一篇短篇小说，这也会被限制吗？

        回复

        • 我倒是可以，已经翻了接近两百本书了，虽然经常会断，换个节点又能继续用了

          回复

          • 破案了，只要把目标语言设置成英语（英式）或英语（美式）就不行。如果要翻译成英语的话，目标语言直接选英语就可以了

            回复