让Bongo Cat走向世界：国际化翻译社区协作指南

你是否曾因语言障碍无法让全球用户体验Bongo Cat的萌趣互动？作为一款拥有3种语言支持的桌面宠物软件，Bongo Cat的国际化翻译社区正等待你的加入。本文将带你掌握从翻译贡献到版本发布的全流程，让这只可爱猫咪跨越语言边界，陪伴更多用户的日常操作。

翻译框架解析

Bongo Cat采用Vue I18n（Internationalization，国际化）框架实现多语言支持，核心配置位于src/locales/index.ts。该文件通过createI18n函数初始化国际化环境，目前已集成英语（en-US）、中文（zh-CN）和越南语（vi-VN）三种语言包。系统默认语言为英语，当某些文本在目标语言中缺失时，会自动回退到英语版本。

export const i18n = createI18n({
  legacy: false,
  locale: LANGUAGE.EN_US,
  fallbackLocale: LANGUAGE.EN_US,
  messages: {
    [LANGUAGE.ZH_CN]: zhCN,
    [LANGUAGE.EN_US]: enUS,
    [LANGUAGE.VI_VN]: viVN,
  },
})

翻译文件结构

所有翻译文本采用JSON格式存储在src/locales目录下，每种语言对应独立的JSON文件：

• 中文：src/locales/zh-CN.json
• 英文：src/locales/en-US.json
• 越南语：src/locales/vi-VN.json

文件采用多级嵌套结构，按功能模块组织键值对。以偏好设置页面的猫咪设置为例，中文版本的结构如下：

"pages": {
  "preference": {
    "cat": {
      "title": "猫咪设置",
      "labels": {
        "modelSettings": "模型设置",
        "mirrorMode": "镜像模式",
        "singleMode": "单键模式",
        // 更多设置项...
      }
    }
  }
}

翻译贡献流程

1. 翻译文件选择

根据你的语言专长，选择对应的JSON文件进行翻译。建议优先关注用户高频使用的界面元素，如：

• 偏好设置：涵盖猫咪行为、窗口显示、快捷键等核心配置
• 组件文本：包括按钮标签、提示信息和状态说明
• 菜单选项：系统托盘和上下文菜单的文本内容

2. 翻译规范要点

• 保持键名一致：所有语言文件使用相同的JSON键结构，仅修改值部分
• 专业术语统一：技术术语如"passThrough"（窗口穿透）需保持翻译一致性
• 长度控制：考虑UI显示空间，避免文本过长导致截断
• 文化适配：如越南语版本将"Always On Top"译为"Luôn trên cùng"（始终在顶部）

3. 示例对比

以"窗口穿透"功能的提示文本为例，三种语言的翻译对比：

语言	原文	翻译
中文	"启用后，窗口不影响对其他应用程序的操作。"	src/locales/zh-CN.json
英文	"When enabled, the window will not affect operations on other applications."	src/locales/en-US.json
越南语	"Bật để cửa sổ không ảnh hưởng đến thao tác trên ứng dụng khác."	src/locales/vi-VN.json

测试与验证

完成翻译后，需通过以下步骤验证效果：

1. 修改src/locales/index.ts中的locale属性切换测试语言
2. 启动应用观察界面文本是否正确显示
3. 特别检查长文本在不同窗口尺寸下的显示效果
4. 验证动态内容（如提示信息、状态变化）的翻译准确性

提交与审核

1. Fork项目仓库至个人账号
2. 创建语言专属分支（如feature/translate-ja-JP）
3. 提交翻译文件并创建Pull Request
4. 等待项目维护者审核，根据反馈进行修改
5. 审核通过后，你的翻译将合并到主分支

社区协作建议

• 关注未翻译项：使用i18n-ally等VS Code插件可直观显示缺失翻译
• 定期同步更新：监控src/locales/zh-CN.json的新增文本
• 参与术语讨论：在社区中提出翻译疑问，如"singleMode"应译为"单键模式"还是"独立模式"
• 文化本地化：为特定语言添加地区特色表达，如越南语使用"Đang đổi kích thước..."（正在调整大小）更符合当地表达习惯

通过参与Bongo Cat国际化翻译，你不仅能帮助全球用户跨越语言障碍，还能在开源社区建立影响力。无论你是语言爱好者还是技术开发者，都能在这个项目中找到适合自己的贡献方式。现在就从翻译一个短语开始，让这只可爱猫咪走向更广阔的世界吧！

项目地址：https://gitcode.com/gh_mirrors/bong/BongoCat