展开本页目录
开始前准备什么
- 下载到独立练习目录，先运行材料校验，再连接自己的翻译服务。
- 准备 Python 与对应工具的隔离环境；PDF 检查使用 Poppler，翻译版本分别记录。
- 原文均为原创练习材料；密钥只填在本机，不写入下载文件或截图。
- 下载原创三章电子书
- 确认文件结构可读
- 从官方 EPUB 入口上传
- 选择目标语言和可用服务
- 导出双语 EPUB
- 验证实际导出结构
- 在阅读器逐章回看
原创 PDF/CSV/EPUB/HTML、逐步说明、校验脚本与真实离线记录；不含模型译文。
对应本页操作、工具边界与验收范围。
本页截图使用的原始文档。
读取真实材料与文件结构；不请求模型、不读取凭证。
当前材料与脚本的实际运行结果。
本页专用练习材料；运行范围见 README。
1. 下载原创三章电子书
source.epub 包含 Start Small、Keep a Ledger、Review the Result 三章，内容均原创。先打开章节预览与目录，避免拿受限书籍做练习。
bash
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、导航和三章引用可访问。结构检查会给出章数与文字量，但不能自动判断译文语义。
bash
python3 verify.py --epub output/your-bilingual.epub7. 在阅读器逐章回看
点击三处目录链接，检查每章开头结尾、原译对应、段落顺序与离线阅读。若导出工具重组章节，先检查对应映射再修订验收表，不能把任何章节数变化直接当损坏。
怎样确认已经完成
- 源 EPUB 三章、manifest、spine 和目录引用均通过真实结构检查。
- 实际双语导出可以打开，目录链接到正确章节且内容不缺首尾。
- 语义仍需人工复核；当前包未调用翻译服务，没有伪造译本。
常见问题
ZIP 能解压就代表 EPUB 合格吗？
不代表。还要有正确的 mimetype、container、package 路径、spine 与导航引用；本脚本检查这些基础结构，但不是完整 EPUBCheck。
译完为什么目录还是英文？
有的工具对导航标签与正文采用不同处理。应分别核对目录标签与链接目标，并按实际导出能力决定是否另行编辑。