@harmonyos-arkts/d2h 0.1.10 → 0.1.12

package/skills/arkts-i18n/references/language-codes.md

@@ -1,104 +1,104 @@
-# 语言代码对照表
-
-> HarmonyOS 支持的语言代码规范，包括 ISO 标准和使用示例
-
----
-
-## 两种命名方案
-
-### 方案 1：仅使用语言代码（推荐用于简单应用）
-
-```
-resources/
-├── base/      # 默认资源（fallback）
-├── en/        # 英文
-├── zh/        # 中文
-├── ja/        # 日文
-└── ko/        # 韩文
-```
-
-**优点**：
-- 简单直观
-- 适配所有区域（en 匹配 en_US, en_GB, en_AU 等）
-
-**缺点**：
-- 无法区分 zh_CN（简体）和 zh_TW（繁体）
-
----
-
-### 方案 2：使用语言+区域代码（推荐用于多区域应用）
-
-```
-resources/
-├── base/
-├── en_US/     # 美国英语
-├── en_GB/     # 英国英语
-├── zh_CN/     # 简体中文
-├── zh_TW/     # 繁体中文（台湾）
-├── zh_HK/     # 繁体中文（香港）
-└── ja/
-```
-
-**优点**：
-- 更精确的区域划分
-- 可以针对不同地区提供不同翻译
-
-**缺点**：
-- 目录较多
-- 需要维护更多资源文件
-
----
-
-## 推荐实践
-
-| 场景 | 推荐方案 | 示例 |
-|------|---------|------|
-| 单一市场应用 | 方案 1 | 中国应用：`zh`, `en` |
-| 多区域应用 | 方案 2 | 国际化应用：`zh_CN`, `zh_TW`, `en_US`, `en_GB` |
-| 简单国际化 | 方案 1 | `en`, `zh`, `ja` |
-| 专业国际化 | 方案 2 | 所有主要语言+区域 |
-
----
-
-## 语言代码对照表
-
-| 语言 | 语言代码 | 区域代码 | 完整代码 | 说明 |
-|------|---------|---------|---------|------|
-| 中文 | `zh` | - | `zh` | 通用中文 |
-| 简体中文 | `zh` | `CN` | `zh_CN` 或 `zh-Hans` | 中国大陆 |
-| 繁体中文 | `zh` | `TW` | `zh_TW` 或 `zh-Hant` | 台湾 |
-| 繁体中文 | `zh` | `HK` | `zh_HK` | 香港 |
-| 英文 | `en` | - | `en` | 通用英文 |
-| 美国英文 | `en` | `US` | `en_US` | 美国 |
-| 英国英文 | `en` | `GB` | `en_GB` | 英国 |
-| 日文 | `ja` | - | `ja` | 日本 |
-| 韩文 | `ko` | - | `ko` | 韩国 |
-
----
-
-## API 12+ 格式注意
-
-HarmonyOS 支持两种格式：
-
-| 格式 | 示例 | 说明 |
-|------|------|------|
-| 下划线格式 | `zh_CN`, `en_US` | 传统格式 |
-| 连字符格式 | `zh-Hans`, `zh-Hant` | Unicode 格式，API 12+ 推荐 |
-
----
-
-## 当前代码仓实践
-
-**代码仓使用**：`en_US/`（方案 2）
-
-```
-entry/src/main/resources/
-├── base/
-├── en_US/     # 美国英语
-└── dark/      # 深色模式
-```
-
-**分析**：
-- ✅ 使用了精确的区域划分
-- ⚠️ 只有英文翻译，缺少其他语言
-- 💡 建议：如需支持更多语言，可按相同模式添加
+# 语言代码对照表
+
+> HarmonyOS 支持的语言代码规范，包括 ISO 标准和使用示例
+
+---
+
+## 两种命名方案
+
+### 方案 1：仅使用语言代码（推荐用于简单应用）
+
+```
+resources/
+├── base/      # 默认资源（fallback）
+├── en/        # 英文
+├── zh/        # 中文
+├── ja/        # 日文
+└── ko/        # 韩文
+```
+
+**优点**：
+- 简单直观
+- 适配所有区域（en 匹配 en_US, en_GB, en_AU 等）
+
+**缺点**：
+- 无法区分 zh_CN（简体）和 zh_TW（繁体）
+
+---
+
+### 方案 2：使用语言+区域代码（推荐用于多区域应用）
+
+```
+resources/
+├── base/
+├── en_US/     # 美国英语
+├── en_GB/     # 英国英语
+├── zh_CN/     # 简体中文
+├── zh_TW/     # 繁体中文（台湾）
+├── zh_HK/     # 繁体中文（香港）
+└── ja/
+```
+
+**优点**：
+- 更精确的区域划分
+- 可以针对不同地区提供不同翻译
+
+**缺点**：
+- 目录较多
+- 需要维护更多资源文件
+
+---
+
+## 推荐实践
+
+| 场景 | 推荐方案 | 示例 |
+|------|---------|------|
+| 单一市场应用 | 方案 1 | 中国应用：`zh`, `en` |
+| 多区域应用 | 方案 2 | 国际化应用：`zh_CN`, `zh_TW`, `en_US`, `en_GB` |
+| 简单国际化 | 方案 1 | `en`, `zh`, `ja` |
+| 专业国际化 | 方案 2 | 所有主要语言+区域 |
+
+---
+
+## 语言代码对照表
+
+| 语言 | 语言代码 | 区域代码 | 完整代码 | 说明 |
+|------|---------|---------|---------|------|
+| 中文 | `zh` | - | `zh` | 通用中文 |
+| 简体中文 | `zh` | `CN` | `zh_CN` 或 `zh-Hans` | 中国大陆 |
+| 繁体中文 | `zh` | `TW` | `zh_TW` 或 `zh-Hant` | 台湾 |
+| 繁体中文 | `zh` | `HK` | `zh_HK` | 香港 |
+| 英文 | `en` | - | `en` | 通用英文 |
+| 美国英文 | `en` | `US` | `en_US` | 美国 |
+| 英国英文 | `en` | `GB` | `en_GB` | 英国 |
+| 日文 | `ja` | - | `ja` | 日本 |
+| 韩文 | `ko` | - | `ko` | 韩国 |
+
+---
+
+## API 12+ 格式注意
+
+HarmonyOS 支持两种格式：
+
+| 格式 | 示例 | 说明 |
+|------|------|------|
+| 下划线格式 | `zh_CN`, `en_US` | 传统格式 |
+| 连字符格式 | `zh-Hans`, `zh-Hant` | Unicode 格式，API 12+ 推荐 |
+
+---
+
+## 当前代码仓实践
+
+**代码仓使用**：`en_US/`（方案 2）
+
+```
+entry/src/main/resources/
+├── base/
+├── en_US/     # 美国英语
+└── dark/      # 深色模式
+```
+
+**分析**：
+- ✅ 使用了精确的区域划分
+- ⚠️ 只有英文翻译，缺少其他语言
+- 💡 建议：如需支持更多语言，可按相同模式添加