# 沉浸式翻译 EPUB 教程：章节、目录与双语电子书导出

上传原创三章 EPUB，选择翻译服务与双语导出，再检查目录、阅读顺序、段落和电子书封装完整性。

运行范围：原创 PDF/CSV/EPUB/HTML 材料与本地验收已实际执行。没有调用翻译模型、没有连接 Zotero 库、没有填写凭证。官方截图为官方项目示例，不是本练习运行输出。

依赖：Python 3.11+；PDF 验收需 Poppler 的 pdfinfo/pdftotext；OCR 复现需 tesseract 英文语言数据。安装翻译工具时遵循各自官方 Python 要求。

## 1. 下载原创三章电子书

source.epub 包含 Start Small、Keep a Ledger、Review the Result 三章，内容均原创。先打开章节预览与目录，避免拿受限书籍做练习。

```sh
python3 verify.py
```

## 2. 确认文件结构可读

检查 mimetype、META-INF/container.xml、OPF manifest/spine 与 nav.xhtml。verify.py 使用 Python 标准库读取实际 ZIP 与 XML，确认三个章节都在目录与 spine 中。

## 3. 从官方 EPUB 入口上传

按官方文档打开 EPUB 电子书翻译功能，上传 source.epub。官方图展示入口和操作区域，账号权限、大小与额度以实际页面为准；这里没有代登录或调用模型。

## 4. 选择目标语言和可用服务

目标选中文，先测试可用翻译服务，查看当前页面的进度与失败提示。对尚未完成的章节保留状态，不把一个章节的成功当全书完成。

## 5. 导出双语 EPUB

在实际页面选择双语导出并下载到 output/。原书 source.epub 保持不变，译本使用新名称；本教材没有预填人工译文冒充工具产物。

## 6. 验证实际导出结构

对真实导出路径执行验证，确认 OPF、导航和三章引用可访问。结构检查会给出章数与文字量，但不能自动判断译文语义。

```sh
python3 verify.py --epub output/your-bilingual.epub
```

## 7. 在阅读器逐章回看

点击三处目录链接，检查每章开头结尾、原译对应、段落顺序与离线阅读。若导出工具重组章节，先检查对应映射再修订验收表，不能把任何章节数变化直接当损坏。

## 来源

- https://immersivetranslate.com/en/docs/features/epub/

## 教材

原创输入材料可用于学习练习。官方图片版权归原作者，网页中保留来源；ZIP 不打包这些官方图片。