Discover Overlay本地化指南：如何为你的语言贡献翻译

Discover Overlay本地化指南：如何为你的语言贡献翻译

【免费下载链接】DiscoverYet another discord overlay for linux项目地址: https://gitcode.com/gh_mirrors/discov/Discover

Discover Overlay是一款专为Linux设计的Discord覆盖层工具，它能在游戏或其他应用运行时显示Discord通知和语音状态。本指南将详细介绍如何为Discover Overlay添加新的语言翻译，帮助全球用户更好地使用这款优秀的开源工具。

本地化准备工作

在开始翻译前，请确保你的开发环境已准备就绪：

1. 克隆项目仓库

   git clone https://gitcode.com/gh_mirrors/discov/Discover cd Discover

2. 了解本地化文件结构
   项目的翻译文件位于 discover_overlay/locales/ 目录下，包含以下关键文件：

   • base.pot: 翻译模板文件，包含所有需要翻译的原始文本
   • 语言目录（如de/、fr/、tr/）: 每个目录下的LC_MESSAGES/default.po存储对应语言的翻译内容

翻译步骤详解

1. 创建新语言文件

以添加中文(zh-CN)翻译为例：

# 复制模板文件创建新的翻译文件 mkdir -p discover_overlay/locales/zh_CN/LC_MESSAGES cp discover_overlay/locales/base.pot discover_overlay/locales/zh_CN/LC_MESSAGES/default.po

2. 编辑翻译文件

使用文本编辑器打开default.po文件，重点关注以下内容：

• 文件头部信息
  修改版权和作者信息：

  # Copyright (C) 2024 Discover Overlay contributors # This file is distributed under the same license as the Discover Overlay package. # 你的名字 <你的邮箱>, 2024.

• 翻译核心内容
  文件中包含大量msgid和msgstr对，例如：

  msgid "Welcome to Discover Overlay" msgstr "欢迎使用Discover覆盖层" msgid "Show overlay" msgstr "显示覆盖层"

  翻译提示：保持术语一致性（如 "overlay" 统一译为 "覆盖层"），确保翻译后的文本适合界面显示。

3. 编译翻译文件

将.po文件编译为程序可识别的.mo格式：

msgfmt discover_overlay/locales/zh_CN/LC_MESSAGES/default.po -o discover_overlay/locales/zh_CN/LC_MESSAGES/default.mo

4. 测试翻译效果

运行应用程序并指定测试语言：

LANG=zh_CN python3 -m discover_overlay

检查界面文本是否正确显示，特别注意：

• 配置窗口标题 discover_overlay/locales/base.pot:106
• 语音状态标签 discover_overlay/locales/base.pot:166-173
• 设置选项 discover_overlay/locales/base.pot:223-244

高级翻译技巧

处理复数和特殊格式

某些语言有复杂的复数规则，可通过msgid_plural处理：

msgid "1 notification" msgid_plural "%d notifications" msgstr[0] "1条通知" msgstr[1] "%d条通知"

维护翻译文件

当项目更新时，使用以下命令同步模板文件：

./remake_base_pot.sh # 更新翻译模板 msgmerge discover_overlay/locales/zh_CN/LC_MESSAGES/default.po discover_overlay/locales/base.pot -o new_default.po

提交贡献

完成翻译后，你可以通过以下方式贡献：

1. fork 项目仓库
2. 创建语言分支（如feature/zh-CN-translation）
3. 提交翻译文件并创建 Pull Request

常见问题解决

• 翻译不生效：确保.mo文件已正确编译并放置在LC_MESSAGES目录
• 格式错误：使用msgfmt --check命令验证.po文件语法
• 术语不确定：参考现有语言翻译（如 fr/LC_MESSAGES/default.po）保持一致性

通过参与本地化，你不仅能帮助更多用户使用Discover Overlay，还能成为开源社区的重要一员！如有疑问，可查看项目文档或参与社区讨论。

【免费下载链接】DiscoverYet another discord overlay for linux项目地址: https://gitcode.com/gh_mirrors/discov/Discover