雨霖铃
c61b599287
- 新增 .github/copilot-instructions.md：Copilot 指令文件，涵盖构建命令、CI 流水线、项目架构、关键规范 - 新增 .github/CODING_STANDARDS.md：完整的代码编写规范文档（TypeScript、React、样式、错误处理、命名、测试、Hook、i18n、存储等 12 个章节） - 新增 11 个目录的 README.md：components、components/ui、config、entrypoints、i18n、lib、pages、providers、public、src、types、utils - 更新 AGENTS.md：补充页面组件模式说明和 components/ui 目录 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
62 lines
2.2 KiB
Markdown
62 lines
2.2 KiB
Markdown
# i18n/
|
||
|
||
国际化资源目录，管理多语言翻译和 i18next 初始化配置。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
i18n/
|
||
├── index.ts # i18next 初始化配置
|
||
└── locales/
|
||
├── zh/ # 中文翻译（默认语言）
|
||
│ ├── common.json # 通用文案
|
||
│ ├── features.json # 功能模块标题和描述
|
||
│ ├── timestamp.json # 时间戳工具翻译
|
||
│ ├── storageCleaner.json # 存储清理工具翻译
|
||
│ ├── qrCode.json # 二维码工具翻译
|
||
│ ├── textStatistics.json # 文本统计工具翻译
|
||
│ ├── jwt.json # JWT 工具翻译
|
||
│ ├── jsonDiff.json # JSON 差异工具翻译
|
||
│ ├── jsonFormat.json # JSON 格式化工具翻译
|
||
│ ├── base64Converter.json
|
||
│ ├── markdownToHtml.json
|
||
│ ├── htmlToMarkdown.json
|
||
│ └── rightClickRestorer.json
|
||
└── en/ # 英文翻译（结构同上）
|
||
└── ...
|
||
```
|
||
|
||
## index.ts
|
||
|
||
i18next 初始化配置：
|
||
|
||
- 同步加载 `common` 和 `features` 核心命名空间
|
||
- 自定义 `chromeStorage` 语言检测器，从 Chrome Storage 读取语言偏好
|
||
- `normalizeLanguage()` 将任意语言标识归一化为 `zh` 或 `en`
|
||
- 语言变更时同步更新 Day.js 本地化和 localStorage 快照
|
||
|
||
## 翻译键格式
|
||
|
||
- 命名空间：`common`（默认）、`features`、各功能独立命名空间
|
||
- 键格式：`namespace:key`（如 `features:timestamp.title`、`timestamp:unitMs`）
|
||
|
||
## 使用方式
|
||
|
||
```tsx
|
||
// 页面组件 — 懒加载翻译
|
||
import { useLazyTranslation } from '@/utils/useLazyTranslation';
|
||
const { t } = useLazyTranslation('timestamp');
|
||
t('timestamp:title');
|
||
|
||
// 全局组件 — 直接使用
|
||
import { useTranslation } from 'react-i18next';
|
||
const { t } = useTranslation(['common', 'features']);
|
||
t('common:settings');
|
||
```
|
||
|
||
## 添加新翻译
|
||
|
||
1. 在 `locales/{zh,en}/features.json` 添加功能标题和描述
|
||
2. 创建 `locales/{zh,en}/{功能名}.json` 添加功能专属翻译
|
||
3. 在 `utils/useLazyTranslation.ts` 的 `localeModules` 中注册新命名空间
|