菜单

本地化系统

相关源文件

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 种语言翻译。每个语言文件都包含具有相同键层次结构的完整翻译集。

来源:src/locales/index.ts31-61

翻译键层次结构

翻译系统使用按应用程序功能和 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-Debridenable_real_debrid, real_debrid_api_token_label, debrid_linked_message高级下载加速
TorBoxenable_torbox, torbox_description, torbox_account_linked替代高级服务
Hydra Cloudsubscription_active_until, manage_subscription, become_subscriber云功能订阅

来源:src/locales/es/translation.json269-275 src/locales/es/translation.json348-361 src/locales/es/translation.json324-335