konghenfuxue-cpu/heibeixue-epub/txt-to-epub-template

TXT 转 EPUB 模板

使用 scripts/txt_to_epub.py。模板采用透明的阅读器默认正文背景、全页自适应封面、双层卡片简介页和独立制作说明页；不包含参考书正文、封面或专属元数据。默认不嵌入字体，以提高阅读器兼容性。

转换

python scripts/txt_to_epub.py "原稿.txt" --title "书名" --author "作者" --output "书名.epub"

可选参数：

• --cover 封面.jpg：使用指定封面；省略时生成文字 SVG 封面。
• --description "简介"：写入元数据并生成简介页。省略时将第一个章节标题前的文字作为简介。
• --language zh-CN：覆盖默认语言。
• --production-team "黑背雪"：制作团队，默认“黑背雪”。
• --source-provider "网友"：校对版提供者，默认“网友”。
• --edition "1.0"：制作版本，默认“1.0”。
• --production-date "2026.09.28"：制作日期；省略时使用当天日期。
• --layout-reference "鬼鬼、湖心溪露等大佬"：制作说明页底部的排版参考致谢。
• --no-production-note：明确不生成制作说明页。

脚本识别 第…卷、第…章/节/回、尾声、终章、番外…、后日谈、附录、完本感言。卷标题在目录中作为一级节点，后续章节作为子项；无卷结构时使用平级目录。

完成标准

1. 不覆盖已存在的输出文件；需要替换时先让用户明确确认或换名输出。
2. 检查 ZIP 首项为未压缩的 mimetype，并验证 container、OPF、manifest、spine、nav 和所有引用目标。
3. 抽查封面、简介、制作说明、第一章、最后一章及目录跳转；若有 Calibre 或目标阅读器，再进行人工打开确认。
4. 报告识别出的正文分段数量、卷数、输出路径，以及未被识别为标题的异常行（如有）。