双语书籍制作工具使用教程
1. 项目介绍
bilingual_book_maker 是一个开源的AI翻译工具,它使用 ChatGPT 帮助用户创建多语言版本的 epub/txt/srt 文件和书籍。该工具专为翻译进入公有领域的 epub 书籍设计,不适用于受版权保护的作品。在使用此工具之前,请仔细阅读项目的免责声明。
2. 项目快速启动
首先,确保您的环境中已经安装了 Python 3.8 或更高版本,并且可以访问互联网或配置了代理。
安装
使用以下命令之一安装 bilingual_book_maker:
pip install -r requirements.txt
# 或者
pip install -U bbook_maker
配置
在开始之前,您需要配置 OpenAI API 密钥。您可以使用 --openai_key
选项指定密钥,或者在环境变量中设置 BBM_OPENAI_API_KEY
。
# 使用环境变量
export BBM_OPENAI_API_KEY=您的API密钥
运行
以下是快速启动项目的命令,这里假设您有一个 epub 文件 test_books/animal_farm.epub
:
python3 make_book.py --book_name test_books/animal_farm.epub --openai_key 您的API密钥 --language "简体中文"
此命令会生成一个名为 ${book_name}_bilingual.epub
的双语书籍。
3. 应用案例和最佳实践
翻译风格
您可以通过 --translation_style
选项自定义翻译文本的样式,例如:
python3 make_book.py --book_name test_books/animal_farm.epub --openai_key 您的API密钥 --language "简体中文" --translation_style "color: #808080; font-style: italic;"
上下文翻译
如果使用 GPT-4 模型,您可以通过 --use_context
选项添加上下文段落,以提高翻译的一致性和流畅性:
python3 make_book.py --book_name test_books/animal_farm.epub --model gpt4 --use_context --language "简体中文"
重新翻译
如果需要重新翻译特定部分,可以使用 --retranslate
选项:
python3 make_book.py --book_name test_books/animal_farm.epub --retranslate 'test_books/animal_farm_bilingual.epub' 'index_split_002.html' '开始字符串' '结束字符串'
4. 典型生态项目
目前,bilingual_book_maker 支持多种模型,如 GPT-4、GPT-3.5-turbo、Claude、Palm 等,并且可以通过插件系统扩展更多功能。开源社区中已经有一些基于此项目衍生的项目,例如支持其他格式的文件翻译、增加新的翻译模型等。通过探索这些生态项目,您可以找到更多适用于不同场景的解决方案。