i18n-management/README.md

69 lines
4.1 KiB
Markdown
Raw Permalink Normal View History

2023-05-09 14:44:40 +08:00
# openKylin i18n SIG
## 介绍
2022-09-09 13:58:21 +08:00
2024-05-21 16:21:46 +08:00
i18n-management负责openKylin中各项目多语言翻译的维护和持续化的贡献。该仓库记录了openKylin中各个需要维护翻译的组件以及对应在weblate平台中的信息。
2022-09-09 13:58:21 +08:00
在i18n SIG中用户可找到感兴趣组件的翻译进行特定贡献可通过一定的贡献量获得对应组件的管理权限。
## 原则
2024-05-21 16:21:46 +08:00
- i18n SIG所维护的平台翻译都是开放的任何人和组织都可以参与。
- 在 i18n-management的i18n.yaml 文件中包含了该项目需要在weblate上建的项目名称、管理者、翻译文件地址。
- 每个项目在weblate翻译平台的项目核心成员都拥有此项目的维护者权限共同维护好组件的翻译状况。
2022-09-09 13:58:21 +08:00
2023-05-09 14:44:40 +08:00
## 如何参与
2023-05-10 10:22:23 +08:00
接下来将逐步介绍OpenKylin用户如何在weblate翻译平台进行翻译贡献。
#### weblate平台账号创建
weblate翻译平台网址[https://weblate.openkylin.top/projects/](https://weblate.openkylin.top/projects/) 进入网址进行账号注册成功后即成为了已验证用户。
先明确openkylin在weblate的用户权限分为五类超级权限者、管理者、各项目维护者、已验证的用户、游客。i18n SIG组的owner属于超级权限者i18N其他成员拥有管理者权限其他sig的owner和maintainer具有其对应项目的维护者权限已验证的用户具备对项目翻译进行建议的权限游客仅可查看翻译。
#### 职责划分:
超级权限者主要负责以下任务:
1. 负责分发各项目维护者权限给到各需要维护weblate翻译的sig组maintainer上。
2. 负责在weblate上建对应sig组的项目。
管理者主要负责以下任务:
1. 管理者基本具备所有权利,可帮忙负责权限分发和处理已验证用户所提的翻译建议等。
2. 审核其他sig组提出的翻译组件创建申请并帮忙在weblate中建好对应的项目。
项目维护者主要负责以下任务:
1. 负责在对应的项目中添加并维护翻译组件
2. 分发组内权限给与其他本sig内的成员
3. 审核处理用户提出的翻译建议
#### 职责划分以及如何贡献
##### 游客和验证用户:
###### weblate 子部件中已有语言
1. 以测试项目 kylin-os-installer 为例weblate进入如下界面后在字符串一栏进行选择首先可以选择“未完成的字符串”这一块基本上是属于没有翻译的部分用户可以对此模块进行建议和查看。
2023-05-10 10:22:23 +08:00
![1.png](./img/1.png)
2. 点击“未翻译字符串”进入以下界面,会出现对应语言翻译内容为空的情况,这时如果有确认的翻译可以填在空白处,然后点击建议按钮,进行建议保存。注意下完成一个字符串的翻译建议后,一定要点击建议,否则会出现建议未被保存的情况
![2.png](./img/2024-06-11_11-19-20.png)
3. 在完成一次项目的翻译建议后,在 openKylin gitee 中对应项目中建立相关 issue。项目的维护者会根据issue内容验证相关翻译如果无误会接受你的建议。
![3.png](img/c9f06249-91e1-4d0a-8389-ef5aecc11ba8.png)
###### weblate 子部件中缺少语言
1. 还是以测试项目 kylin-os-installer 为例,进入该子部件后,如果缺少需要补充翻译的语言,请点击子部件最下方“开始新翻译”,并选出需要增加的语言,之后重复 [weblate 子部件已有语言](https://gitee.com/openkylin/i18n-management/tree/master#weblate-%E5%AD%90%E9%83%A8%E4%BB%B6%E4%B8%AD%E5%B7%B2%E6%9C%89%E8%AF%AD%E8%A8%80) 步骤,进行翻译建议
![4.png](img/2024-06-11_11-29-29.png)
2023-05-10 10:22:23 +08:00
##### 项目维护者:
1. 如果你是一个项目的维护者或管理者这意味着需要对整个项目的数据和维护负责这需要每个拥有项目管理权限的人都要熟悉weblate的项目管理和基本的操作流程https://docs.weblate.org/zh_CN/latest/user/basic.html 是weblate官方文档地址。
2024-05-21 16:21:46 +08:00
2. 需要熟悉[openKylin i18n SIG 组 各项目Owner须知](./owner_README.md)。
2022-09-09 13:58:21 +08:00
## 其他注意事项
2023-05-10 10:22:23 +08:00
- weblate平台地址[https://weblate.openkylin.top/projects/](https://weblate.openkylin.top/projects/)