DualSub 双语字幕，助力语言学习

================================================================
博德之门 3 - DualSub
屏幕上同时显示两种字幕语言
================================================================

每一句台词、每一个你可以选择的回复，以及每一个任务和
日志条目，都会附带第二种语言。专为边玩游戏边学习语言的人而设计。

您可以选择两种语言：

第一行 游戏本身设置的语言
第二行 您想要学习的语言

15 种语言中的任意一种都可以出现在任意一行——共 210 种组合，并且
每一种组合都是完整的。日语配西班牙语在下，
土耳其语配俄语，韩语配德语，等等。

此模组本身不包含任何游戏文本。博德之门 3 会为所有玩家安装
全部十五种语言，因此安装程序会读取您自己电脑上的游戏副本，
并在您的 PC 上构建双语言字幕。
这就是为什么下载大小只有 23 KB 而不是 1 GB，为什么所有
组合都可用，以及为什么在游戏更新补丁后它仍然有效。


---------------- 开始之前 ------------------------------

您需要 Python。它是免费的、安全的，由 python.org 制作，您只需安装一次：

WINDOWS https://www.python.org/downloads/ -> 点击大黄色
"Download Python" 按钮。在其安装程序中，务必勾选
"Add python.exe to PATH" 选项，然后再点击 Install。

LINUX 您很可能已经安装了。如果没有：
Ubuntu / Debian / Mint sudo apt install python3
Fedora / Nobara sudo dnf install python3
Arch / CachyOS sudo pacman -S python
Steam Deck 自带 Python - 请使用桌面模式。

此模组是一个 Python 文件。它不会下载任何内容，也不会在您的 PC 上
安装任何东西。它所做的一切都只针对游戏自身的文件，并且它可以
将这些文件完全恢复原样。


---------------- 安装 ---------------------------------------

1. 关闭游戏及其启动器。

2. 将此下载文件解压到您能找到的地方 - 您的桌面
或下载文件夹都可以。

3. 在该文件夹中打开一个命令窗口：

WINDOWS 打开该文件夹，点击窗口顶部的白色地址栏，
输入 cmd 并按下 Enter 键。

LINUX 在该文件夹内右键单击，然后选择“在此处打开终端”
（大多数文件管理器都有此选项）。

4. 输入以下命令并按下 Enter 键：

WINDOWS python dualsub_installer.py
LINUX python3 dualsub_installer.py

5. 仅在第一次运行时，它会询问游戏位置。粘贴包含
bin 和 Data 文件夹的目录路径 - 或者从文件管理器中将该文件夹
拖放到窗口上。它会记住这个答案。

6. 回答三个问题：您玩游戏使用哪种语言，您想学习
哪种语言，以及是否要将日志和书籍也以及
对话一起进行双语化。

7. 大约 20 秒后它会完成，显示 DONE，然后您就可以启动
游戏了。后续安装大约需要 10 秒。

这就是整个安装过程。无需构建任何东西，无需手动
复制，无需 Mod 管理器，也无需替换任何文件。

如果 Windows 提示无法写入游戏文件，则表示游戏位于
Program Files 目录中，需要管理员权限：

* 点击“开始”，输入 cmd
* 右键单击“命令提示符”，选择“以管理员身份运行”
* 输入 cd /d 然后输入空格，再将解压后的文件夹拖放到
窗口上，然后按 Enter 键
* 然后运行： python dualsub_installer.py

安装在另一个驱动器上的游戏（例如 D 盘上的 Steam 库）通常
完全不需要此操作。


---------------- 设置游戏语言 -----------------------

DualSub 会修改一种语言的文本。如果游戏未设置为
该语言，您将看不到任何变化。

安装程序会主动为您设置，并在您移除模组时恢复原状。如果您希望
手动设置，请打开

Baldur's Gate 3\Data\Localization\language.lsx

并修改以下这行内容：



游戏接受的语言拼写必须完全一致：

English French German Italian Spanish LatinSpanish
BrazilianPortuguese Polish Russian Turkish Ukrainian
Chinese ChineseTraditional Japanese Korean

如果您在 Steam 上购买了游戏，并且语言总是被改回去，
请改为在 Steam 中设置：右键点击游戏，选择“属性”，然后在“语言”选项卡中设置。


---------------- 卸载 ----------------------------------------

以相同方式再次运行安装程序，然后按 R 键。

卸载是精确的。该模组仅向游戏文件夹中添加一个文件，
并且从不编辑或删除游戏自带的任何内容，因此
移除模组后，文件夹将与之前逐字节完全一致。如果它更改了游戏的
语言设置，它也会将其恢复。

在 Steam 或 GOG 中验证游戏文件完整性也会移除该模组。


---------------- 哪些组合有效 -----------------------

全部 210 种组合都有效。上方或下方的任意十五种语言中，任意一种
都可以与其他任意一种搭配。

十一种欧洲语言 - 英语、法语、德语、意大利语、
两种西班牙语、巴西葡萄牙语、波兰语、俄语、土耳其语和
乌克兰语 - 都使用一种包含它们所有所需字符的字体绘制，
因此它们可以在任一方向上自由混合。

中文、日文和韩文各自使用自己的字体，并且这些
字体不包含彼此的字符。当您将其中一种语言与
其他文字混合使用时，DualSub 还会加宽界面使用的字体，
以便两种文字都能被绘制出来。它使用的是您的游戏
中已有的字体 - 不会下载任何内容，也不会向您的 PC 添加任何字体文件。

一些欧洲口音字符在亚洲字体中没有对应字形（例如带斜杠的波兰语
ł，德语的 ß）。这些字符会被简化为普通字母，
以保持文本可读。


---------------- 哪些内容会加倍显示 -----------------------------

始终会加倍：
* 每一句台词 - 大约 162,000 句
* 您在对话中可以选择的所有回复

如果您选择更广泛的选项，还会多出约 7,800 条内容：
* 任务和日志条目
* 在世界中发现的书籍、信件和笔记

绝不会加倍：
* 物品名称、法术名称、提示框、菜单和按钮。将这些加倍
会使每个名称都变成两行高，界面看起来就不像游戏了。

语音不会被动过。它会保持游戏录制的原始语言不变。


---------------- 实用信息 ----------------------------------

* 一次只能使用一种组合。在安装程序中选择其他组合会自动切换过去。
* 三种文本类型会根据游戏绘制它们的位置，以三种合适的方式组合：
字幕和对话气泡会将第二种语言直接放在下面一行，
因为在那里留空行只会浪费屏幕空间；
日志条目、书籍和信件会在两种语言之间添加一个空行，
因为它们是段落；
任务标题、任务类别和地图标记会在一行上用斜杠连接，
因为这些控件的设计不支持两行 - 并且其中一些会将标签显示为纯文本。
* 两种语言中完全相同的行会被保留原样，而不会重复打印两次。
专有名词大多属于此类。
* 安装程序会添加一个文件 Data\DualSub.pak，大小约为 45 MB，以及一个
简要的更改记录，以便按 R 键可以撤销更改。仅此而已。
* 首次安装会花费大约十五秒钟来读取您的游戏中的对话台词列表。
它会记住这一结果，因此后续安装会更快。在游戏更新补丁后，
它会自动重新读取。
* 在大多数版本中，仅提供英语配音，因此通常的设置是：
用您阅读流利的语言玩游戏，并将您正在学习的语言放在下方。
* Program Files 中的游戏需要管理员权限。如果安装程序
无法写入，请从以“以管理员身份运行”启动的命令提示符窗口中
再次运行它 - 请参阅 INSTALL 部分的结尾。
* PC 上没有 Python？安装程序会提示您并告诉您
在哪里获取它 - 它是免费的，只需一分钟。请在 Python 自己的
安装程序中勾选“Add python.exe to PATH”选项，然后重新启动此安装程序。
此下载中的任何内容都永远不会从互联网获取任何东西。
* 无论您是从 Larian 启动器、Steam 还是直接运行可执行文件启动游戏，
它的工作方式都是一样的。它不是一个 Mod 管理器模组，
也不会修改 modsettings.lsx。


---------------- 如果出现问题 -----------------------

“python is not recognized”（Windows）
Python 未安装，或者未勾选“Add python.exe to PATH”选项框。
请从 python.org 重新安装并勾选该选项框，
然后关闭并重新打开命令窗口。

“Could not write to ...”
游戏或其启动器仍在运行 - 请关闭它们 - 或者
命令窗口未以管理员身份启动。有关操作方法，请参阅
INSTALL 部分的结尾。

“That folder does not look like Baldur's Gate 3”
请提供游戏自身的安装文件夹 - 即包含 bin 和
Data 的那个文件夹。不是其上层的 Steam 库文件夹，也不是 bin 文件夹本身。
在资源管理器中打开它，点击顶部的地址栏，复制该
路径，然后粘贴进去。

您希望将其指向游戏的不同副本
在语言菜单中按 F 键。新文件夹将替换
之前记住的文件夹。

字幕只显示一种语言
游戏的语言不是您选择作为第一行的语言。
请参阅上面的 SET THE GAME'S LANGUAGE 部分。

有些行只显示一种语言
这些行在两种语言中是相同的，或者第二种语言没有翻译。
DualSub 会保留它们原样，而不会重复显示。

游戏无法启动
从游戏文件夹中删除 Data\DualSub.pak。这一个文件就是
此模组添加的全部内容。

游戏已更新，文本看起来过时了
运行安装程序，按 R 键，然后重新安装。它会根据
打过补丁的游戏文件重新构建。

其他任何问题
如果安装程序遇到意外情况，它会在自身旁边写入 dualsub-error.log。
它绝不会让您的游戏文件处于半更改状态。

---------------- DUALSUB 项目与支持 -----------------
DualSub 的最终目标是通过使双语言字幕成为标准功能，打破游戏中的语言障碍。电子游戏是学习新语言最吸引人、最有效的方式之一，而这个项目的存在就是为了让每个人的这段旅程都顺利、易得且充满乐趣。

因为每个引擎处理文本的方式不同，每个游戏都需要专门的逆向工程。创建新的解析器意味着我需要亲身接触游戏本身，才能在本地测试其文件结构。

如果您相信这个使命，并希望帮助将 DualSub 带到更多游戏：
- 在 Posts 标签中提出请求，以便我知道您渴望用哪些游戏来学习。
- 非常欢迎通过上方官方的 Donation 按钮（PayPal）进行直接捐赠。

每一笔贡献都将直接用于购置新游戏和资助开发工具。虽然支持有助于确定接下来优先研究哪些游戏，但请记住，永远无法保证未来的移植；这完全取决于技术可行性和可用时间。请放心，每个 DualSub 模组将始终 100% 免费提供给所有人。

非常感谢所有下载、分享并使用此模组学习的人。无论您是在掌握第二语言，还是在精进第三语言，您的支持和反馈让整个项目都变得有价值！