Git LFS 本地化(L10N)开发指南

Git LFS 本地化(L10N)开发指南

git-lfs 项目地址: https://gitcode.com/gh_mirrors/git/git-lfs

前言

Git LFS 作为 Git 大文件存储解决方案，其用户遍布全球各地。为了让非英语用户也能获得良好的使用体验，项目采用了基于 gettext 格式的 Gotext 库来实现本地化支持。本文将深入解析 Git LFS 的本地化实现机制，为开发者和翻译者提供实用指导。

本地化的重要性

1. 用户体验提升：让全球用户能够使用母语操作软件
2. 技术学习辅助：帮助学习特定语言的开发者掌握技术术语
3. 社区参与：降低非英语开发者的贡献门槛

可翻译内容范围

应当翻译的内容

• 状态信息（如操作进度提示）
• 错误提示信息
• 命令行帮助文档
• 用户正常操作流程中可见的所有文本

不应翻译的内容

• 调试跟踪输出（如 tracerx.Printf 输出）
• 功能性字符串（如认证方案名称、HTTP 方法）
• 程序名、命令名、参数名（但其帮助文档应当翻译）
• 专有名词（人名、公司名等）
• Git LFS 和 Git 本身的名称

代码中的本地化实现

基础翻译方法

使用 tr.Tr.Get 方法包装需要翻译的字符串：

Print(tr.Tr.Get("fetch: Fetching reference %s", ref.Name))

复数形式处理

对于需要考虑单复数形式的字符串，使用 tr.Tr.GetN 方法：

Print(tr.Tr.GetN(
    "fetch: Fetching changes within %v day of %v",
    "fetch: Fetching changes within %v days of %v",
    fetchconf.FetchRecentCommitsDays,
    fetchconf.FetchRecentCommitsDays,
    refName,
))

最佳实践建议

1. 完整短语原则：避免拼接字符串，提供完整的短语

   • 错误做法："Upload" + "ing objects"
   • 正确做法：直接提供 "Uploading objects"

2. 单复数处理：始终使用 tr.Tr.GetN 处理数量变化

   • 不同语言的复数规则差异很大（如阿拉伯语有6种复数形式）

3. 字面量原则：只翻译代码中的字面量字符串

   • 变量内容不会被提取到翻译文件中

4. 语言风格：使用简单直接的标准英语

   • 避免俚语、习惯用语和地区性表达

翻译工作指南

翻译流程

1. 提取待翻译字符串：

   go install -v github.com/leonelquinteros/gotext/cli/xgotext
   xgotext -in . -out po -v
   

2. 翻译生成的 .po 文件

3. 提交翻译贡献

注意：xgotext 工具运行较慢，可能需要耐心等待

语言变体处理建议

• 优先创建通用语言翻译（如 es 而非 es_MX）
• 仅在必要情况下使用地区变体（如葡萄牙语的 pt_BR 和 pt_PT）

术语统一原则

• 尽量与 Git 项目的翻译保持一致
• 选择更通用的表达方式（如法语中使用 quatre-vingts 而非 huitante）

常见问题解决

1. 提取工具性能问题：xgotext 运行缓慢是已知问题
2. 翻译疑问：可通过项目讨论区寻求帮助
3. 版本协调：翻译更新会配合发布周期进行

结语

良好的本地化支持是国际化项目成功的关键因素之一。通过遵循本文的指导原则，开发者可以确保 Git LFS 的本地化工作高效有序地进行，而翻译者也能提供高质量的本地化内容。项目团队欢迎各种语言的翻译贡献，共同打造更好的多语言用户体验。

git-lfs 项目地址: https://gitcode.com/gh_mirrors/git/git-lfs