# EPUB 交付说明模板

这是每一本新开卷都可以复用的交付说明模板。使用时只需要替换其中的源 EPUB 路径、小说根目录，必要时再覆盖显示标题即可。

## 适用范围

- 适用于单卷 EPUB 的终交付封装
- 适用于纯译版和中日双语版两种输出
- 适用于当前卷和未来新卷

## 前置条件

1. 该卷的正文翻译已经完成。
2. `final_text/` 中已经存在修复后的最终 HTML。
3. 源 EPUB 文件可用。
4. 小说工程根目录可用。
5. 如果希望输出文件名使用自定义卷名，可以额外传入 `--title`。

## 通用命令

### 同时生成纯译版和双语版

```powershell
$env:PYTHONIOENCODING='utf-8'
$env:SOURCE_EPUB='<源EPUB完整路径>'
$env:NOVEL_ROOT='<小说工程根目录完整路径>'
python '<封装脚本完整路径>' --mode both
```

### 仅生成纯译版

```powershell
$env:PYTHONIOENCODING='utf-8'
$env:SOURCE_EPUB='<源EPUB完整路径>'
$env:NOVEL_ROOT='<小说工程根目录完整路径>'
python '<封装脚本完整路径>' --mode translated
```

### 仅生成双语版

```powershell
$env:PYTHONIOENCODING='utf-8'
$env:SOURCE_EPUB='<源EPUB完整路径>'
$env:NOVEL_ROOT='<小说工程根目录完整路径>'
python '<封装脚本完整路径>' --mode bilingual
```

### 指定显示标题

```powershell
$env:PYTHONIOENCODING='utf-8'
$env:SOURCE_EPUB='<源EPUB完整路径>'
$env:NOVEL_ROOT='<小说工程根目录完整路径>'
python '<封装脚本完整路径>' --title '<显示标题>' --mode both
```

## 输出约定

- 纯译版 EPUB：仅保留中文译文
- 双语版 EPUB：原文显示为灰色，译文显示为正常颜色
- 输出目录默认写入 `NOVEL_ROOT\deliverables`
- 如果传入 `--title`，输出文件名和书内标题都会使用该标题

## 生成规则

- `生成双语版`：执行双语版输出
- `生成翻译版`：执行纯译版输出
- `终交付封装` 或 `合并为epub交付给我`：执行两种输出