Penpot 本地化指南：从多语言界面到 RTL 布局的完整路径

Penpot 本地化指南：从多语言界面到 RTL 布局的完整路径

【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot

把设计稿丢给西语团队，对方几分钟后回了一句："能把界面换成西班牙语吗？"商业工具里这种需求只能提工单排队，但在 Penpot——一个开源的设计与原型平台——本地化（i18n）是开箱即用的能力，语言切换即时生效，你也可以直接参与把缺失的翻译补上。

多语言支持做到什么程度了

先看几个硬数据：仓库里目前有 49 个语言的翻译文件，平台整体翻译完成度约 66%，其中西班牙语已到 96%、简体中文 87%、法语 84%、希腊语 90%。所有翻译文件放在 frontend/translations/ 目录下，每种语言一个 PO 文件，每条字符串都标注了它对应的源码位置，看到疑问文案能直接溯源到界面。

第一次上手：如何开始给 Penpot 翻译

整个翻译流程托管在 Weblate 翻译平台上，不需要装任何工具，浏览器里就能完成。

选定要译的语种

注册 Weblate 账号后，进入 Penpot 的语言列表，点击 "Start new translation"。左侧列表有上百种语言可搜，从阿拉伯语到希伯来语都齐，右侧 "Chosen" 框确认选择后点击底部按钮即可建好新语种。

选好别急，权限这一步很多人会卡住：启动一个新语言需要在项目 issue 里说明你想译的语种和你的账号，管理员回复后才会给你编辑权限，拿到权限再动手。

逐条翻译并实时保存

进入字符串列表后，每条待译字符串都带英文原文、出处（出现在哪个界面）和参考译文。输入译文即时保存，没有"保存"按钮可以找；你也可以先提交建议，把最终定稿留给审核人处理。

翻译进度怎么看、审核卡在哪

负责某个语言的人打开对应语言的仪表盘就行：已译字符串数、待审核数、需处理数各占多少一目了然。新功能上线会不断产生新字符串，进度条随代码同步更新，不用人工去数。

如何切换 RTL 布局，边界又在哪里

多语言不只是换文字。阿拉伯语、希伯来语从右往左读，界面如果照搬左对齐的排布，用起来会很别扭。

原理一句话：界面根据当前语言的文字方向，用 CSS 逻辑属性把面板、菜单、图标整体镜像，不需要维护一份独立的 RTL 版式。

实际效果是：切到阿拉伯语后，侧边栏自动从左边翻到右边，菜单、提示框对称翻转，功能逻辑保持不变。

边界也要说清：镜像只覆盖工具自身的界面，画布上的设计内容（artboard、文本块）不会自动翻转。设计稿里要做右到左排版，是在文本属性面板里手动选 RTL 方向，由设计师决定，系统不替你猜。

如何参与 Penpot 的本地化贡献

参与路径从浅到深有三条：

1. 翻译：注册 Weblate 账号，在 Penpot 项目里挑缺失字符串开始补，门槛最低；
2. 读代码：想弄清国际化实现，可克隆仓库git clone https://gitcode.com/GitHub_Trending/pe/penpot，对照 frontend/translations/ 与 docs/contributing-guide/translations/ 的贡献文档；
3. 反馈：发现某语种有错译，直接在项目 issue 里留言也算贡献。

回到开头那个西语团队——在 Penpot 里，"换成我们的语言"不需要等发版，改个语言设置就行；如果你们的语言完成度还不够高，去把缺的那几条字符串补上，就是从本地化里找到的最直接的切入点。

【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot