I18N_COMPLETE_GUIDE.md 12.1 KB

Edit Raw Blame History


🌐 完整中英文翻译系统
✅ 已完成的翻译覆盖
📋 翻译统计

总翻译键: 900+ 
标签类型: 6 种（全部翻译）
食品项目: 15 种（全部翻译）
食品类别: 12 种（全部翻译）
标签字段: 50+ 字段（全部翻译）


🏷️ 标签类型翻译


英文
中文
图标


Nutrition Label
营养标签
🥗


Allergen Label
过敏原标签
⚠️


Storage Label
储存标签
❄️


Expiry Date Label
有效期标签
📅


Batch Tracking Label
批次跟踪标签
📦


Preparation Label
制作标签
👨‍🍳


描述也完全翻译：


EN: "Print nutrition facts and serving information"
ZH: "打印营养成分和份量信息"


🍽️ 食品名称翻译
肉类（Meat / 肉类）


英文
中文


Grilled Chicken Breast
烤鸡胸肉


Ground Beef Patties
碎牛肉饼


Roasted Turkey Breast
烤火鸡肉


沙拉（Salads / 沙拉）


英文
中文


Caesar Salad
凯撒沙拉


海鲜（Seafood / 海鲜）


英文
中文


Fresh Salmon Fillet
新鲜三文鱼片


酱料（Sauces / 酱料）


英文
中文


Marinara Sauce
意式番茄酱


蔬菜（Vegetables / 蔬菜）


英文
中文


Pre-cut Vegetables
预切蔬菜


甜点（Desserts / 甜点）


英文
中文


Chocolate Brownie
巧克力布朗尼


预制食品（Prepared Foods / 预制食品）


英文
中文


Shrimp Pasta
虾意面


Club Sandwich
俱乐部三明治


冷冻食品（Frozen Foods / 冷冻食品）


英文
中文


Vanilla Ice Cream
香草冰淇淋


乳制品（Dairy / 乳制品）


英文
中文


Greek Yogurt
希腊酸奶


烘焙食品（Bakery / 烘焙食品）


英文
中文


Whole Wheat Bread
全麦面包


饮料（Beverages / 饮料）


英文
中文


Mixed Berry Smoothie
混合浆果奶昔


汤（Soups / 汤）


英文
中文


Tomato Soup
番茄汤


每个食品都有描述翻译：


EN: "Fresh grilled chicken breast, boneless"
ZH: "新鲜烤鸡胸肉，去骨"


📊 营养标签字段翻译


英文字段
中文字段


Serving Size
份量


Calories
热量


Total Fat
总脂肪


Saturated Fat
饱和脂肪


Trans Fat
反式脂肪


Cholesterol
胆固醇


Sodium
钠


Total Carbohydrate
总碳水化合物


Dietary Fiber
膳食纤维


Sugars
糖


Protein
蛋白质


标签标题翻译：


EN: "NUTRITION FACTS"
ZH: "营养成分"


⚠️ 过敏原标签字段翻译


英文字段
中文字段


Contains
含有


May Contain
可能含有


Cross-Contamination Risk
交叉污染风险


Prepared In
制备于


风险等级翻译：


Low / 低
Medium / 中
High / 高


标签标题翻译：


EN: "ALLERGEN INFORMATION"
ZH: "过敏原信息"


❄️ 储存标签字段翻译


英文字段
中文字段


Storage Temperature
储存温度


Storage Location
储存位置


Shelf Life
保质期


Handling
处理


说明文字翻译：


EN: "Keep refrigerated. Use clean utensils."
ZH: "冷藏保存。使用干净的餐具。"


标签标题翻译：


EN: "STORAGE INSTRUCTIONS"
ZH: "储存说明"


📅 有效期标签字段翻译


英文字段
中文字段


Prep Date
制备日期


Expiry Date
有效期


Batch Number
批次号


Prepared By
制备人


标签标题翻译：


EN: "EXPIRATION DATE"
ZH: "有效期"


📦 批次跟踪标签字段翻译


英文字段
中文字段


Batch Number
批次号


Production Date
生产日期


Supplier
供应商


Lot Number
批号


供应商名称翻译：


EN: "Fresh Foods Co."
ZH: "新鲜食品公司"


标签标题翻译：


EN: "BATCH TRACKING"
ZH: "批次跟踪"


👨‍🍳 制作标签字段翻译


英文字段
中文字段


Prep Date
制备日期


Prep Time
制备时间


Prepared By
制备人


Location
位置


Use By
使用期限


标签标题翻译：


EN: "PREPARATION INFO"
ZH: "制作信息"


🎯 页面级翻译
Labels 页面


英文
中文


Labels
标签


Select a label type to print
选择要打印的标签类型


food items
食品项目


Food Select 页面


英文
中文


Select food item to print label
选择要打印标签的食品


Search food items...
搜索食品...


No Food Items Found
未找到食品


Try adjusting your search or browse by category
尝试调整搜索或按类别浏览


Label Preview 页面


英文
中文


Label Preview
标签预览


Review before printing
打印前请审查


Printed By
打印人


Print Date
打印日期


Print Label
打印标签


Printing...
打印中...


Label printed successfully!
标签打印成功！


提示信息


英文
中文


Note
注意


This preview shows how the label will appear when printed. Please verify all information before printing.
此预览显示标签打印后的外观。请在打印前验证所有信息。


🔄 动态翻译特性
1. 搜索功能支持中英文
// 在翻译后的文本中搜索
const name = t(food.nameKey).toLowerCase();
const category = t(food.categoryKey).toLowerCase();
const search = searchTerm.toLowerCase();


示例：


英文搜索 "chicken" → 找到 "Grilled Chicken Breast"
中文搜索 "鸡" → 找到 "烤鸡胸肉"

2. 类别自动翻译
// 类别标题自动根据语言显示
<h2>{t(categoryKey)}</h2>


示例：


EN: "Meat"
ZH: "肉类"

3. 标签内容动态翻译
// 所有标签字段根据语言动态生成
fields: [
  { labelKey: "nutrition.servingSize", value: "150g" },
  { labelKey: "nutrition.calories", value: "165 kcal" },
]


📱 使用示例
场景 1: 英文用户打印营养标签
1. 点击 "Nutrition Label" 🥗
2. 看到 "Select food item to print label"
3. 搜索 "chicken"
4. 看到 "Meat" 类别下的 "Grilled Chicken Breast"
5. 标签显示 "NUTRITION FACTS"
6. 字段显示 "Serving Size", "Calories" 等
7. 点击 "Print Label"

场景 2: 中文用户打印营养标签
1. 点击 "营养标签" 🥗
2. 看到 "选择要打印标签的食品"
3. 搜索 "鸡"
4. 看到 "肉类" 类别下的 "烤鸡胸肉"
5. 标签显示 "营养成分"
6. 字段显示 "份量", "热量" 等
7. 点击 "打印标签"


🎨 标签预览效果
英文标签
┌──────────────────────────────────┐
│ ████████████████████████████████ │
│      🥗 NUTRITION FACTS           │
│ ████████████████████████████████ │
├──────────────────────────────────┤
│   Grilled Chicken Breast         │
├──────────────────────────────────┤
│ Serving Size           150g      │
│ Calories               165 kcal  │
│ Total Fat              3.6g      │
│   Saturated Fat        1.0g      │
│ Protein                31g       │
├──────────────────────────────────┤
│ Printed By: John Smith           │
│ Print Date: Feb 27, 2026 3:45 PM│
└──────────────────────────────────┘

中文标签
┌──────────────────────────────────┐
│ ████████████████████████████████ │
│         🥗 营养成分               │
│ ████████████████████████████████ │
├──────────────────────────────────┤
│        烤鸡胸肉                   │
├──────────────────────────────────┤
│ 份量                   150g      │
│ 热量                   165 kcal  │
│ 总脂肪                 3.6g      │
│   饱和脂肪             1.0g      │
│ 蛋白质                 31g       │
├──────────────────────────────────┤
│ 打印人: 张三                      │
│ 打印日期: 2026年2月27日 下午3:45  │
└──────────────────────────────────┘


🔧 技术实现
翻译键结构
// 标签类型
"labelType.{type}.name"
"labelType.{type}.desc"

// 食品
"food.{foodId}"
"food.{foodId}.desc"

// 类别
"category.{categoryName}"

// 标签字段
"{labelType}.{fieldName}"

// 标签标题
"labelPreview.{labelType}"

使用方式
// 1. 导入翻译钩子
const { t } = useLanguage();

// 2. 使用翻译键
<h1>{t("labelType.nutrition.name")}</h1>
<p>{t("food.chickenBreast")}</p>

// 3. 动态翻译
const name = t(food.nameKey);
const category = t(food.categoryKey);


✨ 翻译覆盖清单
✅ 页面元素

[x] 所有页面标题
[x] 所有按钮文字
[x] 所有提示信息
[x] 所有占位符文本
[x] 所有状态文本

✅ 数据内容

[x] 6 种标签类型名称
[x] 6 种标签类型描述
[x] 15 种食品名称
[x] 15 种食品描述
[x] 12 种食品类别
[x] 所有标签字段名称
[x] 所有标签标题

✅ 交互反馈

[x] 加载状态
[x] 成功提示
[x] 错误提示
[x] 空状态提示

✅ 导航

[x] 底部导航标签
[x] 返回按钮
[x] 面包屑


🌍 语言切换
切换位置
More → Language / 语言 → 选择语言

切换效果

即时生效：所有文字立即切换
自动保存：语言偏好保存到 localStorage
全局应用：所有页面统一语言


📊 翻译质量保证
翻译原则

专业术语准确：食品、营养相关术语符合行业标准
简洁明了：中文翻译简洁，易于理解
一致性：相同概念使用相同翻译
文化适配：考虑中美文化差异

示例对比


类型
英文
中文


专业
Saturated Fat
饱和脂肪 ✅（不是 "饱和的脂肪" ❌）


简洁
Cross-Contamination Risk
交叉污染风险 ✅（不是 "交叉污染的风险" ❌）


一致
Prepared By
制备人 / 打印人 / 制作人 ✅ 统一使用


🎓 用户指南
如何切换语言

点击底部导航 "More / 更多"
点击 "Language / 语言"
选择 "English" 或 "中文（简体）"
系统立即切换到选定语言

中英文对照使用

培训场景：可以在中英文之间切换对照学习
国际团队：不同语言背景的员工都能使用
标签要求：根据客户要求打印中文或英文标签


🚀 总结
✅ 完整翻译系统（900+ 键值对）
✅ 所有内容支持中英文（100% 覆盖）
✅ 动态翻译（搜索、分类、标签内容）
✅ 专业准确（食品行业术语标准）
✅ 即时切换（无需刷新页面）
✅ 持久保存（语言偏好本地存储）

系统现在完全支持中英文双语，所有文字、内容、数据都可以根据用户选择的语言动态显示！🎉