翻译与贡献 — 非开发者也能帮 Seal 变得更好
Seal 有两种贡献方式
- 翻译贡献(不需要写代码):在 Hosted Weblate 上参与多语言翻译
- 代码/文档贡献(需要写代码或 Markdown):提 PR 或 Issue
本文重点讲翻译贡献,这是最多人能参与的方式。
翻译贡献步骤
步骤一:注册 Hosted Weblate 账号
Hosted Weblate 是一个开源的在线翻译协作平台,不需要写代码,纯浏览器界面。注册完成后进入 Seal 的翻译项目页面。
步骤二:选择语言
Seal 目前有 15+ 种语言。如果你想贡献的语言还没出现,可以发起新语言请求(需要 Weblate 管理员批准)。
步骤三:在线翻译
选语言后 Weblate 会列出所有未翻译的字符串。每个条目显示:
- 英文原文
- 已有的翻译(如果是多人协作可能有多个候选)
- 上下文注释(开发者给的提示,说明这个字符串在哪出现、什么含义)
直接在输入框里写翻译、提交。建议多参考上下文注释——界面里的短字符串如果没有上下文容易翻得不准确。
步骤四:等待审核合入
Seal 项目的维护者会定期审核 Weblate 上的翻译提交,合入仓库后下次 Release 会自动打包进应用。
CONTRIBUTING.md:贡献之前必读
Seal 仓库根目录有一个 CONTRIBUTING.md 文件,里面详细写了:
- Bug Report 怎么写(需要什么信息、模板是什么)
- Feature Request 怎么提(先说清楚为什么需要这个功能)
- PR 提交的工作流(fork → branch → commit → PR → 等 review)
- 翻译贡献的规范
贡献前先读一下这个文件,可以避免走弯路。
如何写好 Bug Report
Seal 的 Issue Tracker 里每天都有新 Issue,写得好的 Bug Report 更容易被维护者快速定位和修复。建议包含:
| 字段 | 示例 |
|---|---|
| 设备型号 | 小米 13 Ultra |
| 安卓版本 | Android 14(MIUI 15) |
| Seal 版本 | v1.13.1(arm64-v8a) |
| 复现步骤 | 1. 打开 Seal 2. 粘贴 xxx 链接 3. 点击下载 4. 崩溃 |
| 预期行为 | 正常开始下载 |
| 实际行为 | 应用崩溃/报 xxx 错误 |
| 日志 | 如果能拿到崩溃日志或 Seal 的错误日志,贴上来 |
非翻译的其他贡献
除了翻译,非开发者还能:
- 在 GitHub Issues 里帮助分类和确认其他人的 Bug Report
- 在 Matrix 社区里帮新用户答疑
- 在自己使用 Seal 的社交内容里提一下(让更多人知道这个开源项目)