来源 | 阿里巴巴云原生公众号

背景

KubeVela v1.0 启用了新的官网架构和文档维护方式，新增功能包括文档版本化控制、i18n 国际化以及自动化流程。但目前 KubeVela 官方文档只有英文版，这提高了学习和使用 KubeVela 的门槛，不利于项目的传播和发展，同时翻译工作也能显著提升语言能力，帮助我们拓宽阅读技术资料的广度，故组织本次活动。

活动举办

本次活动由 KubeVela 社区发起，KubeVela 社区和云原生社区 OAM SIG 共同举办。

活动流程

本次活动主要在 kubevela.io repo 下进行，报名参与和认领任务都在 KubeVela 官方文档翻译登记中（请务必在表格中登记信息）。

点击进入登记表。

开始翻译

翻译流程

参与翻译活动的基本流程如下：

任务领取：在 KubeVela 官方文档翻译登记并认领任务；
提交：参与人员提交 PR 等待 review；
审阅：maintainer 审阅 PR；
终审：对 review 后的内容进行最后确认；
合并：merge 到 master 分支，任务结束。

参与指南

下面具体介绍参与翻译的具体工作。

1. 准备工作

账号：您需要先准备一个 GitHub 账号。使用 Github 进行翻译任务的认领和 PR 提交；
仓库和分支管理•fork kubevela.io 的仓库，并作为自己仓库的上游：git remote add upstream https://github.com/oam-dev/kubevela.io.git；
在自己的仓库，也就是 origin 上进行翻译；
一个任务新建一个 branch；
Node.js 版本 >= 12.13.0 （可以使用node -v命令查看）；
Yarn 版本 >= 1.5（可以使用yarn --version命令查看）。

2. 参与步骤

Step 1：任务浏览

在 KubeVela 官方文档翻译登记并浏览有哪些任务可以认领。

Step 2：任务领取

在 KubeVela 官方文档翻译登记表格中编辑并认领任务。注意：为保证质量，同一译者只能同时认领三个任务，完成后才可继续认领。

Step 3：本地构建和预览

# 命令安装依赖
$ yarn install
# 本地运行中文文档
$ yarn run start -- --locale zh
yarn run v1.22.10
warning From Yarn 1.0 onwards, scripts don't require "--" for options to be forwarded. In a future version, any explicit "--" will be forwarded as-is to the scripts.
$ docusaurus start --locale zh
Starting the development server...
Docusaurus website is running at: http://localhost:3000/zh/
✔ ClientCompiled successfully in 7.54s
ℹ ｢wds｣: Project is running at http://localhost:3000/
ℹ ｢wds｣: webpack output is served from /zh/
ℹ ｢wds｣: Content not from webpack is served from /Users/saybot/own/kubevela.io
ℹ ｢wds｣: 404s will fallback to /index.html
✔ ClientCompiled successfully in 137.94ms

请勿修改 /docs目录下内容，中文文档在 /i18n/zh/docusaurus-plugin-content-docs中，之后就可以在 http://localhost:3000/zh/ 中进行预览了。

Step 4：提交 PR

确认翻译完成就可以提交 PR 了，注意：为了方便 review 每篇翻译为一个 PR，如果翻译多篇请 checkout多个分支并提交多个 PR。

Step 5：审阅

由 maintainer 对 PR 进行 review。

Step 6：任务完成

翻译合格的文章将会 merge 到 kubevela.io 的 master 分支进行发布。

欢迎参与 KubeVela 官方文档翻译活动相关推荐

【KubeVela 官方文档翻译】，欢迎大家踊跃参与
简介:KubeVela v1.0 启用了新的官网架构和文档维护方式,新增功能包括文档版本化控制.i18n 国际化以及自动化流程.但目前 KubeVela 官方文档只有英文版,这提高了学习和使用 Kub ...
苹果官方将首次参与天猫 618 促销活动；淘宝回应用户账号被禁用980年；Julia 1.5.0 beta1 发布 | 极客头条...
整理 | 屠敏头图 | CSDN 下载自东方 IC 快来收听极客头条音频版吧,智能播报由出门问问「魔音工坊」提供技术支持. 「极客头条」-- 技术人员的新闻圈! CSDN 的读者朋友们早上好哇,「极 ...
全球仅10%的开发者从不加班；淘宝回应用户账号被禁用 980 年;苹果宣布首次以官方形式参与天猫618折扣活动...
编辑 | 程佳琳全球仅 10% 的开发者不用加班:微信首次回应 WeTool 被封事件:苹果宣布首次以官方形式参与天猫 618 折扣活动:马云:买菜等小事未来都会在网上,这是活下去的关键:淘宝回应用 ...
【iOS官方文档翻译】iOS蓝牙的基本概念
之前写了[iOS官方文档翻译]iOS的蓝牙连接.数据接收及发送一文,介绍了怎样进行蓝牙通讯,但是很多基本概念没有进行解释,看起来可能有点吃力,所以现在再翻译一篇苹果对官方蓝牙4.0一些基本概念介绍的文 ...
UIControl事件---iOS-Apple苹果官方文档翻译
本系列所有开发文档翻译链接地址: iOS7开发-Apple苹果iPhone开发Xcode官方文档翻译PDF下载地址 UIControl事件1.UIControlEventTouchDown 单点触摸按 ...
众信旅游：旅游及相关产品会参与阿里双十一活动
日前,众信旅游在互动平台回复投资者称,正在积极协商,众信的旅游及相关产品都会参与阿里双十一活动. 根据此前发布的公告显示,众信旅游预计今年1-9月归属上市公司股东的净利润亏损2.8亿到3.3亿元之间, ...
UIPageControl---iOS-Apple苹果官方文档翻译
本系列所有开发文档翻译链接地址:iOS7开发-Apple苹果iPhone开发Xcode官方文档翻译PDF下载地址 //转载请注明出处--本文永久链接:http://www.cnblogs.com/Ch ...
Python3.2官方文档翻译--异常抛出和自定义异常
Python3.2官方文档翻译--异常抛出和自定义异常 Python3.2官方文档翻译--异常抛出和自定义异常,有需要的朋友可以参考下. 6.4 抛出异常 Raise语句运行程序员强制抛出一个具体的异 ...
Log4j2官方文档翻译--欢迎使用Log4j2！
官网原文标题<Welcome to Log4j 2!> 官网原文地址http://logging.apache.org/log4j/2.x/manual/index.html 译者:本文介 ...

欢迎参与 KubeVela 官方文档翻译活动

背景