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

================================================================ GTA: SAN ANDREAS - DualSub v1.0
屏幕同时显示两种字幕语言
================================================================

每一句台词对话都会在其下方增加一行第二语言字幕，颜色较暗，因此你使用的语言会优先被阅读。此模组专为在游戏过程中学习语言的人设计。

你可以选择两种语言：

第一行 游戏设置的语言
第二行 你正在学习的语言，以灰色显示

支持五种语言，共20种组合，每种语言包含约9,000句台词和2,700句任务文本。

所有五种语言均已随游戏附带——英文、法文、德文、意大利文和西班牙文在每份《圣安地列斯》中都有。本下载不捆绑任何内容，也不包含任何游戏文本。


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

你需要安装Python。它是免费的，可从python.org获取，只需安装一次：

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

LINUX 你几乎肯定已经安装。如果没有：
Ubuntu / Debian / Mint sudo apt install python3
Fedora / Nobara sudo dnf install python3
Arch / CachyOS sudo pacman -S python
Steam Deck 已自带，使用桌面模式即可。

此模组是一个Python文件。它不会下载或安装任何东西到你的电脑上。它所做的只是修改游戏自身的文件，并且可以完全恢复原状。

没有其他依赖。不需要IMG工具、脚本钩子、模组管理器或其他程序。圣安地列斯将其文本存储在text文件夹中的五个纯文本文件中，此模组只编辑其中一个，并会先保留副本。


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

1. 关闭游戏。

2. 将此下载解压到一个你能再次找到的位置。保持文件在一起。

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

WINDOWS 点击文件夹窗口顶部的白色地址栏，输入 cmd 并按回车。
LINUX 在文件夹内右键单击 -> “在此处打开终端”。

4. 输入以下命令并按回车：

WINDOWS python dualsub_installer.py
LINUX python3 dualsub_installer.py

5. 仅在第一次运行时，它会询问游戏所在位置。粘贴包含 gta_sa.exe 的文件夹路径——或者将该文件夹拖放到窗口上。它通常能自行找到。

6. 回答三个问题：你玩游戏时使用的语言、你想学习的语言，以及字幕显示位置。按回车接受默认值。

7. 启动游戏。进入 选项 -> 语言，选择你作为第一行所选的语言。这样才能加载模组的文本。

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

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

游戏位于其他驱动器时通常不需要此操作。


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

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

它会将文件完全恢复原状，并移除自身记录。如果自安装以来该文件已被其他程序更改，它会保留不动并告知你。


---------------- 第二语言出现的位置 -------------

步骤3列出了游戏的不同部分。每个部分可以设置为以下三种状态之一：

both 你玩游戏时使用的语言，下方显示另一种语言
only 仅显示另一种语言，替代第一种语言
off 保持游戏原始状态不变

输入数字以循环切换该行的状态：both -> only -> off -> both。

默认两项设置为“both”：

* 台词对话 - 对话场景中的字幕
* 任务文本 - 目标、计数器、提示

默认一项设置为“off”：

* 菜单和名称 - 服装、地点、武器、菜单

该项设为“off”是有原因的。这些文件中的键是数字而非名称，因此文件内部无法区分哪些条目是衬衫名称，哪些是散文。开启此项会使两者都加倍，而在商店中出现重复的服装名称可不是人们想要的。


---------------- 只显示一种语言而非两种 -------------------

有时你不需要两行字幕。你希望游戏整体是英文——菜单、商店、地名——但字幕只使用西班牙语，单独显示，用于那些你无法靠听力捕捉的少数台词。

将台词部分设置为“only”，其余部分保留为“both”。这样你可以在英文任务简报下看到西班牙语字幕，且没有任何重复，而任务目标仍会显示两种语言（在有空间的地方）。

这个决定是逐部分进行的，并且默认情况下不会采用。游戏未翻译的行会保留为你玩游戏时使用的语言，而不会被清空。


---------------- 使用游戏未附带的语言 -------------

圣安地列斯的翻译模组是一个 .gxt 文件，你需要将其放入 text 文件夹。任何存在的此类文件都会与游戏自带的五种语言一起出现在菜单中：

Portuguese - 来自 portuguese.gxt

安装程序会读取每个文件而不是信任其文件名，因此覆盖了 american.gxt 的翻译会被识别为其实际语言，而非英文。你可以将其选择为你正在学习的语言，或作为你玩游戏时使用的语言。两种方向都有效，“only”模式也同样适用。

他们的文本会完全按照原样使用，并且只有你玩游戏所用语言的文件会被写入。请给予你所使用的翻译作者署名——第二行字幕是他们的辛勤工作成果。

某些翻译会自带其字母表——俄语、土耳其语、波兰语等——通过替换游戏的字体和文本实现。圣安地列斯一次只能绘制一种字母表，因此这些语言会被标记为不可用，并附上原因，而不是被提供后却显示为错误的字母。五种附带语言之间的组合不受影响：所有五种语言共享同一字母表，无论你使用哪种语言，游戏都能完整绘制。


---------------- 须知事项 ----------------------------------

* 一次只能使用一种组合。选择另一种会将其覆盖。
* 只有你玩游戏所用语言的文件会被写入。其他四个文件只被读取不会被修改。
* 菜单和商店名称有意保持单一语言，以保证可读性。只有对话和任务文本会被双语言化。
* 第二行字幕为灰色。这是游戏自身的暗色文字颜色，因此你使用的语言仍会被优先阅读。
* 某些台词从未被翻译成某些语言——游戏中根本没有对应条目。这些台词会被保留原样，不会被重复为自身副本。
* 游戏在绘制时动态填充的行（如“Level 1”）会保持单一语言。将其双语言化会导致游戏在只有一个数字时请求两个数字。
* 支持光盘版、Steam版和Rockstar版本，也支持Steam Deck。它读取找到的文件而非版本号。
* 没有Python？安装程序会提示并指向python.org。此下载中的任何内容都不会从互联网获取任何数据。


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

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

Windows不允许写入游戏文件
游戏仍在运行——请关闭它——或者命令窗口未以管理员身份启动。请参阅安装部分末尾。

双击时在编辑器中打开文件
Python未与.py文件关联。请在文件夹中打开命令窗口并输入第4步的命令。

“That folder does not hold gta_sa.exe”
请提供游戏自身的安装文件夹，而不是其父文件夹或启动器的文件夹。打开它，点击地址栏，复制该路径并粘贴进去。

游戏启动但没有显示双语言
游戏语言不是你选择的第一行语言。请检查 选项 -> 语言。如果你将某部分设置为“only”，则该部分不会显示双语言。

字幕底部显示被截断
两种语言需要两倍的空间。将台词部分设置为“only”而非“both”——你可以看到第二语言单独一行，替代第一种语言。

第二语言显示为错误的字母
其他模组替换了游戏字体。请先移除本模组，再移除该模组的字体，然后重新安装。

游戏更新后文本显示异常
验证游戏文件完整性，然后重新运行安装程序。

其他问题
一个名为 dualsub-error.log 的文件会出现在安装程序旁边。请将其附加到模组页面的帖子中。


---------------- DUALSUB 项目与支持 -----------------

DualSub 的目标是通过将双语言字幕设为标准功能，打破游戏中的语言障碍。游戏是学习语言最具吸引力的方式之一，而本项目旨在使其流畅、易用且有趣。

每个引擎处理文本的方式不同，因此每款游戏都需要单独进行逆向工程——这意味着需要亲自访问游戏以在本地测试其文件结构。

如果你想帮助将 DualSub 带到更多游戏：
- 在帖子标签中提出请求，让我知道你想用哪些游戏学习。
- 非常欢迎通过上方捐赠按钮进行捐赠。

每一份贡献都将用于获取新游戏和开发工具。支持有助于确定接下来优先研究哪些游戏，但不能保证未来一定会推出移植版本——这取决于技术可行性和时间。每个 DualSub 模组将始终保持100%免费。

感谢所有下载、分享和使用此模组进行学习的人。无论你是在精通第二语言还是磨练第三语言，你的支持让整个项目都值得。