如何为OpenInfraMap贡献多语言翻译:Weblate国际化实战指南
如何为OpenInfraMap贡献多语言翻译:Weblate国际化实战指南
OpenInfraMap 是一个开源基础设施地图项目,它把 OpenStreetMap 中的电力、水、油气、电信等基础设施数据可视化在地图上。该项目使用 Weblate 平台管理多语言翻译,任何人无需编程基础即可参与。本文将带你快速上手 OpenInfraMap 翻译流程:从了解 i18next 国际化机制,到在 Weblate 上逐条翻译、提交审核,再到让新语言正式上线。
为什么要给 OpenInfraMap 翻译?
OpenInfraMap 的目标是让地图支持多语言。目前项目已收录 34 种语言 的翻译文件(见 web/locales/ 目录),但每多一个语种、每多一条完整译文,都会有更多人用上这张地图。
官方在 README.md 中明确写道:翻译工作通过 Weblate 进行,任何人都可以为新语言贡献内容。
💡 好消息:翻译贡献不需要克隆仓库、不需要写代码,在浏览器里就能完成。
先看懂:OpenInfraMap 的国际化是怎么实现的?
了解一点原理,能让你翻译得更顺手。
- 翻译框架:Web 前端基于 i18next 实现国际化,所有可翻译文本集中在 JSON 文件中。
- 源语言文件:英语是基准语言,位于 web/locales/en/translation.json,包含编辑入口、图例名称、单位等约两百条文案。
- 语言切换逻辑:web/src/l10n.ts 中还维护了一份图层支持语言列表,用于优先显示本地语言的地名(例如中文用户会优先看到
name:zh)。
举个例子,源语言文件中的一条记录:
{
"names": {
"power": {
"transformer": "Transformer"
}
}
}
你的工作就是把 Transformer 之类的文案翻译成目标语言(例如"变压器"),并保持一致的命名风格。
Weblate 翻译五步走:完整操作流程
第 1 步:注册 Weblate 账号
访问 Weblate 托管平台,使用 GitHub 或邮箱注册一个免费账号。整个平台是开源社区共用的,注册后即可浏览全部待翻译字符串。
第 2 步:找到 Open Infrastructure Map 项目
在 Weblate 首页搜索 open-infrastructure-map(项目全称为 "Open Infrastructure Map"),进入项目页后你会看到各语言的翻译进度条。
第 3 步:选择你的语言
- 已有语言:直接点进该语言开始补充未翻译的字符串;
- 新语言:任何人都可以在 Weblate 上新增一种语言,从英语源文本开始逐条翻译。
第 4 步:逐条翻译并提交
Weblate 会把每条待翻译字符串与上下文一起展示。翻译小技巧:
- 🌍 对照 web/locales/en/translation.json 的分组结构理解文案用途(
edit.*是编辑按钮,names.*是图例名称,units.*是单位); - ⚡ 专业术语保持一致:变压器、变电站、输电线路等电力词汇建议全篇统一译法;
- ✅ 每条译完点击保存,你的贡献会立即进入项目的翻译统计。
第 5 步:申请上线你的语言
根据官方规则:当某种语言的翻译完成度超过 75% 后,请在项目仓库提交一个 issue 说明进度,维护者就会在网站上启用该语言。这是新语言用户的"临门一脚",别忘了做!
进阶:想直接修改源文本怎么办?
如果你发现需要新增一条可翻译文案(例如新功能的按钮文字),按 web/README.md 中的说明:
新增翻译字符串时,必须同时把它加入
locales/en/translation.json,Weblate 才能自动拉取到这条新文案。
本地运行前端预览效果也很简单:
npm install
npm start
开发服务会在 http://localhost:5173 启动,默认连接生产后端,方便你即时查看翻译效果。
常见问题 FAQ
| 问题 | 解答 |
|---|---|
| 必须会编程才能翻译吗? | 不需要,Weblate 网页端即可完成全部翻译工作 |
| 翻译错了能改吗? | 可以,随时在 Weblate 上修改已提交的译文 |
| 新语言做到多少进度能上线? | 完成度超过 75% 后提交 issue 申请启用 |
| 术语在哪里查? | 参考 web/locales/en/translation.json 的分组结构与 docs/architecture.md 中的业务模块(电力、水务、油气、电信) |
结语:一条译文,点亮一种语言
参与 OpenInfraMap 的国际化并不需要高深的技术背景——注册 Weblate、选择语言、逐条翻译、达到 75% 后提交 issue,四步就能让你的母语出现在这张全球基础设施地图上。现在就去选择一条未完成的字符串,开始你的第一次贡献吧!🌏
