-----/epub_delivery/epub_delivery_recipe.md

EPUB 交付说明模板

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

适用范围

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

前置条件

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

通用命令

同时生成纯译版和双语版

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

仅生成纯译版

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

仅生成双语版

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

指定显示标题

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

输出约定

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

生成规则

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