![頭圖.png](https://ucc.alicdn.com/pic/developer-ecology/934131234ef94686bd9c684926988d6e.png)

來源 | [阿里巴巴雲原生公眾號](https://mp.weixin.qq.com/s/ewpBAqFOd1BbTJwp235yQw)

# 背景
KubeVela v1.0 啟用了新的官網架構和文件維護方式，新增功能包括文件版本化控制、i18n 國際化以及自動化流程。但目前 KubeVela 官方文件只有英文版，這提高了學習和使用 KubeVela 的門檻，不利於專案的傳播和發展，同時翻譯工作也能顯著提升語言能力，幫助我們拓寬閱讀技術資料的廣度，故組織本次活動。

# 活動舉辦
本次活動由 KubeVela 社群發起，**KubeVela 社群和雲原生社群 OAM SIG 共同舉辦**。

# 活動流程
本次活動主要在 [kubevela.io](https://github.com/oam-dev/kubevela.io) repo 下進行，報名參與和認領任務都在 [KubeVela 官方文件翻譯登記](https://shimo.im/sheets/QrCwcDqh8xkRWKPC/MODOC)中（**請務必在表格中登記資訊**）。

[點選進入登記表](https://shimo.im/sheets/QrCwcDqh8xkRWKPC/MODOC?dingtalkLoginFailed=1)。

# 開始翻譯
![1.png](https://ucc.alicdn.com/pic/developer-ecology/4826ac7c22854ecb8511bb17fb61c13d.png)
翻譯流程

參與翻譯活動的基本流程如下：

- 任務領取：[在 KubeVela 官方文件翻譯登記](https://shimo.im/sheets/QrCwcDqh8xkRWKPC/MODOC)並認領任務；
- 提交：參與人員提交 PR 等待 review；
- 審閱：maintainer 審閱 PR；
- 終審：對 review 後的內容進行最後確認；
- 合併：merge 到 master 分支，任務結束。

# 參與指南
下面具體介紹參與翻譯的具體工作。

## 1. 準備工作

- 賬號：您需要先準備一個 GitHub 賬號。使用 Github 進行翻譯任務的認領和 PR 提交；
- 倉庫和分支管理•fork [kubevela.io](https://github.com/oam-dev/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 官方文件翻譯登記](https://shimo.im/sheets/QrCwcDqh8xkRWKPC/MODOC)並瀏覽有哪些任務可以認領。

### **Step 2：任務領取**
在 [KubeVela 官方文件翻譯登記](https://shimo.im/sheets/QrCwcDqh8xkRWKPC/MODOC)表格中編輯並認領任務。注意：為保證質量，同一譯者只能同時認領三個任務，完成後才可繼續認領。

### **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/
✔ Client
  Compiled 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
✔ Client
  Compiled 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](https://github.com/oam-dev/kubevela.io) 的 master 分支進行釋出。

歡迎參與 KubeVela 官方文件翻譯活動

相關文章