diff --git a/images/1.PNG b/images/1.PNG new file mode 100644 index 0000000000000000000000000000000000000000..e9ea6d94606b430ab2dd0607d752ee249e7feaaf Binary files /dev/null and b/images/1.PNG differ diff --git a/images/2.PNG b/images/2.PNG new file mode 100644 index 0000000000000000000000000000000000000000..8cdc3fdaf56a4cf3d1478840bee960ba3cd29e66 Binary files /dev/null and b/images/2.PNG differ diff --git a/images/3.PNG b/images/3.PNG new file mode 100644 index 0000000000000000000000000000000000000000..526a37dcc6a3a8e79cfa4c2e151b86cfebc9e224 Binary files /dev/null and b/images/3.PNG differ diff --git a/images/4.PNG b/images/4.PNG new file mode 100644 index 0000000000000000000000000000000000000000..249e6ca52e2f67346207e0d27c03d68e4c236b9d Binary files /dev/null and b/images/4.PNG differ diff --git "a/images/\346\215\225\350\216\267.PNG" "b/images/\346\215\225\350\216\267.PNG" new file mode 100644 index 0000000000000000000000000000000000000000..9af8627dff6db8e6fe90ef7ee46f452eab0d3407 Binary files /dev/null and "b/images/\346\215\225\350\216\267.PNG" differ diff --git a/openeuler-g11n-contribution-guide.md b/openeuler-g11n-contribution-guide.md index 52492438f5f8d5ddbafa0b5a3e4c5da535943a82..3b4567ccf231c240b30c0ede863fc84283046097 100644 --- a/openeuler-g11n-contribution-guide.md +++ b/openeuler-g11n-contribution-guide.md @@ -1,10 +1,7 @@ - - - - # openEuler G11N 贡献指南 -![image 1](https://gitee.com/yanhuiling/globalization/raw/master/images/image%201.png) + +![`输入图片说明`](https://gitee.com/yanhuiling/globalization/raw/master/images/%E6%8D%95%E8%8E%B7.PNG "在这里输入图片标题") openEuler G11N 特别兴趣小组旨在向全球不同语言背景的openEuler开发者提供专业语言服务平台,向国内开发者普及全球化能力,跨越语言和文化障碍,壮大openEuler社区,使openEuler惠及更多开发者。 @@ -14,11 +11,11 @@ G11N特别兴趣小组欢迎各种形式的贡献,包括但不限于: - 推荐/翻译/撰写热点技术文档或博客 - 修改材料和交付件错误 -#### ![image 2](https://gitee.com/yanhuiling/globalization/raw/master/images/image%202.png) 翻译openEuler社区材料 +![image 2](https://gitee.com/yanhuiling/globalization/raw/master/images/image%202.png) 翻译openEuler社区材料 openEuler需要翻译的材料包括官网内容以及开源社区160+仓库的README,about,releases,技术文档等。 若你想为openEuler社区贡献你的译文,请注册Gitee账号并订阅G11N mailing list成为我们小组的一员,然后加入对应语种的翻译团队认领需要翻译的内容。每个语种团队会提供相应的翻译指导,规范、文化禁忌、风格指南、翻译知识库等。 -#### ![image 3](https://gitee.com/yanhuiling/globalization/raw/master/images/image%203.png) 推荐/翻译/撰写热点技术文档或博客 +![image 3](https://gitee.com/yanhuiling/globalization/raw/master/images/image%203.png) 推荐/翻译/撰写热点技术文档或博客 分享开源与全球化最新趋势、技术和业界动态。 @@ -34,12 +31,10 @@ openEuler需要翻译的材料包括官网内容以及开源社区160+仓库的R 推荐或翻译热点技术文档,为社区提供全球领域的技术新知识。 -#### ![image 4](https://gitee.com/yanhuiling/globalization/raw/master/images/image%204.png) 修改材料和交付件错误 +![image 4](https://gitee.com/yanhuiling/globalization/raw/master/images/image%204.png) 修改材料和交付件错误 欢迎大家对G11N的材料和交付件进行修改和优化,包括各个仓库的译稿,翻译指导,全球化规范,博客等,只要你发现了不合理/错误的地方,都欢迎提交PR进行修改,让我们一起打造更专业的全球化兴趣小组。 -![image 5](https://gitee.com/yanhuiling/globalization/raw/master/images/image%205.png) - 以下为具体的贡献指导,请按照步骤操作。 # 一、注册账号并订阅G11N @@ -48,7 +43,7 @@ openEuler需要翻译的材料包括官网内容以及开源社区160+仓库的R **步骤 2**: 注册成功后登录,点击页面左上角的**个人主页**进入你的个人页面,点击头像下的**个人设置**,再在左边导航栏选择**邮箱管理**,设置一个你的常用邮箱作为主邮箱(这个邮箱非常重要,后面用来接收翻译项目,会议通知等)。 -###### ![image 6](https://gitee.com/yanhuiling/globalization/raw/master/images/image%206.png "image 6") +![image 6](https://gitee.com/yanhuiling/globalization/raw/master/images/image%206.png "image 6") **步骤 3**: 签署openEuler社区[贡献者许可协议 (CLA)](https://clasign.osinfra.cn/sign/Z2l0ZWUlMkZvcGVuZXVsZXI=) 。请选择**个人CLA**。签署邮箱请填写你设置的主邮箱。 @@ -60,7 +55,7 @@ openEuler需要翻译的材料包括官网内容以及开源社区160+仓库的R 3. 填写你的名字和主邮箱用于接收G11N消息。 -###### image 7 +image 7 4. 提交订阅后你的邮箱会收到一个confirm邮件,直接回复邮件进行确认。待收到"Welcome to the "G11n" mailing list"邮件,说明你已订阅成功。 @@ -68,23 +63,19 @@ openEuler需要翻译的材料包括官网内容以及开源社区160+仓库的R 想要贡献openEuler开源社区,有两个工具需熟练掌握,一个是Typora,一个是Git。 -Typora([下载](https://typora.io/)):Typora是一个所见即所得的Markdown格式文本编辑器,支持Windows、macOS和GNU/Linux操作系统,包括对GitHub Flavored Markdown扩展格式的支持、拼写检查、自定义CSS样式、数学公式渲染(通过MathJax)等特性。之后我们译稿或博客上传到开源社区需要使用这个格式。具体使用方法,请参考[markdown-basics](待补充链接)。 - -###### image 9 - -Git([下载](https://gitforwindows.org/ )): Git是一个开源的分布式版本控制系统,可以有效、高速地处理项目版本管理。 我们翻译或创作好的文档需要通过Git工具上传到开源社区。请大家自学一下Git 工具的使用。我们也提供了丰富的学习资源,请参考[git-self-learning-materials](待补充链接)和[git-basics](待补充链接)。 +Typora([下载](https://typora.io/)):Typora是一个所见即所得的Markdown格式文本编辑器,支持Windows、macOS和GNU/Linux操作系统,包括对GitHub Flavored Markdown扩展格式的支持、拼写检查、自定义CSS样式、数学公式渲染(通过MathJax)等特性。之后我们译稿或博客上传到开源社区需要使用这个格式。具体使用方法,请参考[markdown-basics](https://gitee.com/openeuler/G11N/blob/master/learning-materials/open-source-basics/markdown-basics.md)。 -###### ![image 10](https://gitee.com/yanhuiling/globalization/raw/master/images/image%2010.png) +Git([下载](https://gitforwindows.org/ )): Git是一个开源的分布式版本控制系统,可以有效、高速地处理项目版本管理。 我们翻译或创作好的文档需要通过Git工具上传到开源社区。请大家自学一下Git 工具的使用。我们也提供了丰富的学习资源,请参考[git-self-learning-materials](https://gitee.com/openeuler/G11N/blob/master/learning-materials/open-source-basics/git-self-learning-materials.md)和[git-basics](https://gitee.com/openeuler/G11N/blob/master/learning-materials/open-source-basics/git-basics.md)。 # 三、翻译项目参与流程 -###### ![image 11](https://gitee.com/yanhuiling/globalization/raw/master/images/image%2011.png) +![image 11](https://gitee.com/yanhuiling/globalization/raw/master/images/image%2011.png) 上面的准备工作做好后,大家就可以开始参与G11N发布的翻译项目啦。目前试点英文翻译项目,主要流程如下: -- G11N翻译项目协调人员将待翻译任务列表放在G11N/globalization仓库的[translation-projects](https://gitee.com/openeuler/globalization/tree/master/translation-projects)文件夹下,每个翻译任务以“编号-文档名-交付时间”命名并附上对应仓库链接。项目启动时,G11N协调人员会给大家邮箱发布翻译列表,大家根据邮件里的链接或直接进入translation-projects文件夹选取感兴趣的任务发送到G11N邮箱([g11n@openeuler.org](mailto:g11n@openeuler.org) )。协调人员收到后会在该任务Translator一栏写上你的ID。有任何问题都可以发邮件到[g11n@openeuler.org](mailto:g11n@openeuler.org),工作日实时回复。 +- G11N翻译项目协调人员将待翻译任务列表放在G11N/globalization仓库的[translation-projects](https://gitee.com/openeuler/globalization/tree/master/translation-projects)文件夹下,每个翻译任务以“编号-任务名-交付时间”命名并附上对应仓库链接。项目启动时,G11N协调人员会给大家邮箱发布翻译列表,大家根据邮件里的链接或直接进入translation-projects文件夹选取感兴趣的任务发送到G11N邮箱([g11n@openeuler.org](mailto:g11n@openeuler.org) )。协调人员收到后会在该任务Translator一栏写上你的ID。有任何问题都可以发邮件到[g11n@openeuler.org](mailto:g11n@openeuler.org),工作日实时回复。 -- 认领好自己的待翻译任务后就可以点击仓库链接去到对应仓库获取待翻译内容。你可以拷贝到线下用word格式进行翻译,方便工具检查和评审,也可以直接用Markdown格式进行编辑。相关翻译风格指南和术语,请参考[xxx](待补充)和xxx。翻译完成后请先自检,保证没有低错、语法错误等。然后发送邮件到G11N邮箱申请评审(请在截稿时间前1-2天发评审,给评审人员预留时间)。评审完成后也会通过邮件返回给你。 +- 认领好自己的待翻译任务后就可以点击仓库链接去到对应仓库获取待翻译内容。你可以拷贝到线下用word格式进行翻译,方便工具检查和评审,也可以直接用Markdown格式进行编辑。相关翻译风格指南和术语,请参考[Tips for translating web content](https://gitee.com/openeuler/globalization/blob/master/translation-tips-and-terminology/Tips-for-translating-web-content.md)和[Terms and tips](https://gitee.com/openeuler/globalization/blob/master/translation-tips-and-terminology/Terminology.md)。翻译完成后请先自检,保证没有低错、语法错误等。然后发送邮件到G11N邮箱申请评审(请在截稿时间前1-2天发评审,给评审人员预留时间)。评审完成后也会通过邮件返回给你。 - 译稿完成翻译和评审后,你就可以上传到对应仓库,具体方式有两种:轻量级Pull Request(PR)和Git工具上传(需要学习Git工具使用)。 @@ -96,31 +87,31 @@ Git([下载](https://gitforwindows.org/ )): Git是一个开源的分布式 **步骤 1**: 根据提供的链接进入对应仓库,找到对应英文文档,单击进入,如图所示。 -###### image 12 +image 12 **步骤 2**: 点击右上角的**编辑**按钮进入在线编辑模式(Markdown格式)。 -###### image 13 +image 13 **步骤 3**: 修改内容并检查完成后预览一下效果,确认无误后在扩展信息内简述变更原因,点击**提交审核**创建一个轻量级PR。若页面跳转到PR详情页面,则轻量级PR创建成功。 审核通过后你的内容就可以合入仓库。 -###### image 14 +image 14 ## 上传文档到代码仓 流程(使用Git工具操作) -###### ![image 15](https://gitee.com/yanhuiling/globalization/raw/master/images/image%2015.png) +![image 15](https://gitee.com/yanhuiling/globalization/raw/master/images/image%2015.png) **步骤 1**: 代码仓fork到个人仓。比如点击Fork将[openEuler](https://gitee.com/openeuler) / [globalization](https://gitee.com/openeuler/globalization)仓库fork到你的个人仓。 -###### image 16 +image 16 注意: 上传文档只能先上传到你的个人仓再创建PR推送到主仓进行审核,不能直接上传文件到主仓。待翻译的文档在哪个仓库就fork哪个仓库。比如如果待翻译文档在[openEuler](https://gitee.com/openeuler) / [A-Tune](https://gitee.com/openeuler/A-Tune)仓库,就fork这个仓库到个人仓。 如果之前已经fork到个人仓,此时也可以在个人仓单击同步按钮,将主仓的内容直接同步到个人仓,例如: -###### image 17 +image 17 **步骤 2**:个人仓clone到本地,以克隆[openEuler](https://gitee.com/openeuler) / [globalization](https://gitee.com/openeuler/globalization)仓库为例。 @@ -129,11 +120,11 @@ Git([下载](https://gitforwindows.org/ )): Git是一个开源的分布式 1. 新建本地文件夹,以仓库名命名,在文件夹内右键选择“Git Bash Here”,进入Git命令行。Git操作请参考[二、Markdown和Git工具学习](#二、Markdown和Git工具学习)。 2. 在命令行页面执行**git clone git@gitee.com:yanhuiling/globalization.git**将个人仓的文件拉取到本地。 - ###### image 18 + image 18 其中“git@gitee.com:yanhuiling/globalization.git”为个人仓地址,可以通过如下方式获取: - ###### image 19 + image 19 需要注意的是,gitee上默认clone的是master仓的文件,如果需要指定分支,例如clone dev分支的文件,可以通过-b指定,例如: @@ -153,11 +144,11 @@ git add .** **步骤 4**: 个人仓提交PR到代码仓。在个人仓创建PR。源分支选择个人仓,目的分支选择主仓。分支也要一一对应。审核通过后你的译文便可在仓库呈现。 -###### image 20 +image 20 # 四、其他贡献参与流程 -#### ![image 3](https://gitee.com/yanhuiling/globalization/raw/master/images/image%203.png) 推荐/翻译/撰写热点技术文档或博客 +![image 3](https://gitee.com/yanhuiling/globalization/raw/master/images/image%203.png) 推荐/翻译/撰写热点技术文档或博客 你可以分享开源与全球化最新趋势、技术和业界动态并撰写博客。 @@ -181,7 +172,7 @@ git add .** - 校对:hcy@321 - 发布:yan@123 -#### ![image 4](https://gitee.com/yanhuiling/globalization/raw/master/images/image%204.png)修改材料和交付件错误 +![image 4](https://gitee.com/yanhuiling/globalization/raw/master/images/image%204.png)修改材料和交付件错误 我们欢迎大家对G11N的材料和交付件进行修改和优化,包括各个仓库的译稿,翻译指导,全球化规范,博客等,只要你发现了不合理/错误的地方,都欢迎提交PR进行修改。这种贡献形式比较适合提交轻量级PR,流程请参考[提交轻量级PR](#提交轻量级PR)。