本地化
概述
本指南涵盖了 Raaghu 组件库的全面国际化和本地化策略，通过支持多种语言、文化和地区实现全球覆盖。
i18n 理念
我们的国际化方法基于以下核心原则：
- 通用设计： 构建可在所有文化和语言中无缝工作的组件
- 性能优先： 翻译的懒加载和高效的包管理
- 开发者体验： 使 i18n 集成变得轻松的简单 API
- 文化敏感性： 支持多样化的文化惯例和偏好
- 无障碍性： 确保 i18n 不会影响无障碍功能
架构概述
核心 i18n 技术栈
{
"react-i18next": "^15.2.0",
"i18next": "^24.2.0",
"i18next-browser-languagedetector": "^8.0.2",
"i18next-http-backend": "^3.0.2",
"i18next-icu": "^2.3.0"
}
附加工具
{
"i18next-scanner": "^4.5.0",
"i18next-parser": "^9.0.2",
"@formatjs/intl": "^2.10.10",
"date-fns": "^4.8.0",
"react-hook-form": "^7.54.2"
}
支持的语言
主要语言（完全支持）
| 语言 | 代码 | RTL | 状态 | 覆盖率 |
|---|---|---|---|---|
| 英语 | en | 否 | ✅ 完成 | 100% |
| 西班牙语 | es | 否 | ✅ 完成 | 100% |
| 法语 | fr | 否 | ✅ 完成 | 100% |
| 德语 | de | 否 | ✅ 完成 | 100% |
| 中文（简体） | zh-CN | 否 | ✅ 完成 | 100% |
| 日语 | ja | 否 | ✅ 完成 | 100% |
| 阿拉伯语 | ar | 是 | ✅ 完成 | 100% |
| 希伯来语 | he | 是 | ✅ 完成 | 100% |
次要语言（部分支持）
| 语言 | 代码 | RTL | 状态 | 覆盖率 |
|---|---|---|---|---|
| 葡萄牙语 | pt | 否 | 🚧 进行中 | 80% |
| 意大利语 | it | 否 | 🚧 进行中 | 75% |
| 俄语 | ru | 否 | 🚧 进行中 | 70% |
| 韩语 | ko | 否 | 📋 计划中 | 0% |
| 印地语 | hi | 否 | 📋 计划中 | 0% |