Hydra 本地化系统为应用程序提供国际化 (i18n) 支持,通过基于 JSON 的分层翻译文件管理 29 种语言。该系统处理整个应用程序中所有面向用户的文本内容,从 UI 组件到通知消息。
有关 UI 组件集成的信息,请参阅UI 组件和前端。有关设置配置,请参阅设置系统。
该本地化系统围绕集中式翻译文件结构构建,包含特定语言的 JSON 文件和统一的导出系统。其架构支持按应用程序功能和组件组织的分层翻译键。
来源:src/locales/index.ts1-61 src/locales/es/translation.json1-513 src/locales/ru/translation.json1-534
该系统通过按 ISO 语言代码组织的独立 JSON 文件维护 29 种语言翻译。每个语言文件都包含具有相同键层次结构的完整翻译集。
翻译系统使用按应用程序功能和 UI 组件组织的分层键结构。每个翻译文件在所有语言中都保持一致的键组织。
| 类别 | 目的 | 示例键 |
|---|---|---|
app | 通用应用程序消息 | successfully_signed_in |
home | 主页内容 | featured, surprise_me, hot |
sidebar | 导航侧边栏 | catalogue, downloads, my_library |
header | 头部栏内容 | search, version_available_install |
game_details | 游戏信息页面 | download_options, requirements, achievements |
downloads | 下载管理 | resume, pause, completed |
settings | 设置和配置 | downloads_path, notifications, language |
notifications | 系统通知 | download_complete, repack_list_updated |
user_profile | 用户账户功能 | display_name, friends, achievements |
achievement | 成就系统 | achievement_unlocked, hidden_achievement_tooltip |
hydra_cloud | 云订阅功能 | subscription_tour_title, cloud_saving |
来源:src/locales/es/translation.json2-513 src/locales/ru/translation.json2-534
翻译系统支持使用双花括号进行变量插值,以插入动态内容。这包括游戏标题、百分比、日期和用户特定信息。
| 模式 | 用途 | 示例 |
|---|---|---|
{{title}} | 游戏标题 | "{{title}} (正在下载元数据…)" |
{{percentage}} | 进度指示器 | "{{title}} ({{percentage}} - 正在下载…)" |
{{eta}} | 时间估算 | "正在完成 {{eta}} - {{speed}}" |
{{date}} | 日期格式 | "上次备份 {{date}}" |
{{count}} | 计数和数字 | "{{count}} 个下载选项" |
{{username}} | 用户识别 | "账户“{{username}}”已链接" |
{{game}} | 游戏引用 | "从库中移除 {{game}}" |
来源:src/locales/es/translation.json20-22 src/locales/es/translation.json46 src/locales/es/translation.json274
本地化系统使用带数字后缀(_zero、_one、_other)的复数规则,以处理不同语言中的各种计数场景。
| 语言 | 零形式 | 单数形式 | 其他形式 |
|---|---|---|---|
| 英语 | "无下载" | "1 个下载" | "5 个下载" |
| 西班牙语 | "Sin descargas" | "1 descarga" | "5 descargas" |
| 俄语 | "Нет загрузок" | "1 загрузка" | "5 загрузок" |
来源:src/locales/es/translation.json68-70 src/locales/ru/translation.json66-68 src/locales/tr/translation.json65-67
该系统按应用程序功能组织翻译,确保相关功能之间术语一致且消息内容符合上下文。
成就系统维护了专门用于游戏术语和进度跟踪的词汇。
来源:src/locales/es/translation.json484-497 src/locales/ru/translation.json505-518
下载相关翻译涵盖从开始到完成的整个下载生命周期。
来源:src/locales/es/translation.json217-246 src/locales/ru/translation.json218-247
设置系统为所有配置选项提供全面的本地化支持,包括高级服务集成和用户偏好。
| 服务 | 配置键 | 描述 |
|---|---|---|
| Real-Debrid | enable_real_debrid, real_debrid_api_token_label, debrid_linked_message | 高级下载加速 |
| TorBox | enable_torbox, torbox_description, torbox_account_linked | 替代高级服务 |
| Hydra Cloud | subscription_active_until, manage_subscription, become_subscriber | 云功能订阅 |
来源:src/locales/es/translation.json269-275 src/locales/es/translation.json348-361 src/locales/es/translation.json324-335