# openKylin i18n SIG


## 介绍

i18n-management负责openKylin多语言翻译的维护和持续化的贡献。

i18n-management SIG为各个需要维护翻译的其他SIG组在weblate平台上维护翻译并支持所有用户进行贡献。

在i18n SIG中，用户可找到感兴趣组件的翻译进行特定贡献，可通过一定的贡献量获得对应组件的管理权限。

## 原则

- i18n-management所维护的平台翻译都是开放的，任何人和组织都可以参与。
- 在 i18n-management的i18n.yaml 文件中包含了该项目需要在weblate上建的项目名称、owner、maintainer和翻译组件模块，若一个组件有多个模块需要翻译，则在模块列写出所有模块。
- 每个项目在weblate翻译平台的项目核心成员都拥有此项目的维护者权限，共同维护好应用的翻译状况。

## 如何参与

接下来将逐步介绍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. 审核处理用户提出的翻译建议

#### 职责划分以及如何贡献

##### 游客和验证用户：
1. 以测试项目kylin-os-installer为例，weblate进入如下界面后在字符串一栏进行选择，首先可以选择“未完成的字符串”，这一块基本上是属于没有翻译的部分，用户可以对此模块进行建议和查看。
2. 点击“未完成的字符串”进入以下界面会出现藏文出现空的情况，这时候如果作为用户的你有确定的翻译可以直接填在空白处然后点击建议，这样项目的维护者或管理者在下次查看翻译情况时会看到建议的词条，如果验证无误会接受你的建议。
![1.png](./img/1.png)

##### 项目维护者：
1. 如果你是一个项目的维护者或管理者，这意味着需要对整个项目的数据和维护负责，这需要每个拥有项目管理权限的人都要熟悉weblate的项目管理和基本的操作流程，https://docs.weblate.org/zh_CN/latest/user/basic.html 是weblate官方文档地址。
2. 需要熟悉OpenKylin 的weblate维护手册整个流程。https://docs.qq.com/doc/DWEhwU0dYc1hKUWN6?&u=b1219e2d6b5a42cdb745f00f376a2551
![2.png](./img/2.png)

##### 管理者：
1. 作为一位管理者，除了要熟悉项目维护者的工作之外，还需要清楚如何为项目维护者创建项目并分发权限。如下图所示，点击右上角的+号然后“添加新翻译项目”。
![3.png](./img/3.png)

2. 进入如下界面后，“项目名称”填组件名，“项目网站”填gitee的仓库地址，“翻译说明”由项目维护者后续自行补充，点“保存”
![4.png](./img/4.png)

3. 之后进入以下界面，点击“管理”->“设置”进入设置界面，点击访问，将“访问控制”设置为受保护的即可。
![5.png](./img/5.png)

4. 权限分发请看维护者说明的openkylin weblate维护手册第六节。

#### 提交权限申请

在了解了职责权限与贡献方式后，需要根据你的情况进行项目权限申请。

- clone此项目并在i18n-management创建对应的以项目名为文件名的文件夹，在文件夹中需新建一个i18n.yaml文件，并按以下格式填写。以kylin-os-installer为例：

```
name: kylin-os-installer
owner:
- xxx : weblate ID
maintainers:
- xxx : weblate ID
modules:
- kylin-os-installer
```

第一个name字段需要填写的是项目的名称，modules下填写的是在这个项目下我需要创建的翻译模块的名称。同时在owner和maintainer字段后需要填写weblate翻译平台的账号ID，方便在创建项目时给与维护者权限,如果没有maintainer的话这个字段下信息可选择不填。

## 其他注意事项


- weblate平台地址：[https://weblate.openkylin.top/projects/](https://weblate.openkylin.top/projects/)