簡(jiǎn)介：KubeVela v1.0 啟用了新的官網(wǎng)架構(gòu)和文檔維護(hù)方式，新增功能包括文檔版本化控制、i18n 國(guó)際化以及自動(dòng)化流程。但目前 KubeVela 官方文檔只有英文版，這提高了學(xué)習(xí)和使用 KubeVela 的門檻，不利于項(xiàng)目的傳播和發(fā)展，同時(shí)翻譯工作也能顯著提升語言能力，幫助我們拓寬閱讀技術(shù)資料的廣度，故組織本次活動(dòng)。

來源 | 阿里巴巴云原生公眾號(hào)

背景

KubeVela v1.0 啟用了新的官網(wǎng)架構(gòu)和文檔維護(hù)方式，新增功能包括文檔版本化控制、i18n 國(guó)際化以及自動(dòng)化流程。但目前 KubeVela 官方文檔只有英文版，這提高了學(xué)習(xí)和使用 KubeVela 的門檻，不利于項(xiàng)目的傳播和發(fā)展，同時(shí)翻譯工作也能顯著提升語言能力，幫助我們拓寬閱讀技術(shù)資料的廣度，故組織本次活動(dòng)。

活動(dòng)舉辦

本次活動(dòng)由 KubeVela 社區(qū)發(fā)起，KubeVela 社區(qū)和云原生社區(qū) OAM SIG 共同舉辦。

活動(dòng)流程

本次活動(dòng)主要在?kubevela.io?repo 下進(jìn)行，報(bào)名參與和認(rèn)領(lǐng)任務(wù)都在?KubeVela 官方文檔翻譯登記中（請(qǐng)務(wù)必在表格中登記信息）。

點(diǎn)擊進(jìn)入登記表。

開始翻譯

翻譯流程

參與翻譯活動(dòng)的基本流程如下：

• 任務(wù)領(lǐng)取：在 KubeVela 官方文檔翻譯登記并認(rèn)領(lǐng)任務(wù)；
• 提交：參與人員提交 PR 等待 review；
• 審閱：maintainer 審閱 PR；
• 終審：對(duì) review 后的內(nèi)容進(jìn)行最后確認(rèn)；
• 合并：merge 到 master 分支，任務(wù)結(jié)束。

參與指南

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

1. 準(zhǔn)備工作

• 賬號(hào)：您需要先準(zhǔn)備一個(gè) GitHub 賬號(hào)。使用 Github 進(jìn)行翻譯任務(wù)的認(rèn)領(lǐng)和 PR 提交；
• 倉(cāng)庫和分支管理?fork?kubevela.io 的倉(cāng)庫，并作為自己倉(cāng)庫的上游：git remote add upstream https://github.com/oam-dev/kubevela.io.git；
• 在自己的倉(cāng)庫，也就是 origin 上進(jìn)行翻譯；
• 一個(gè)任務(wù)新建一個(gè) branch；
• Node.js 版本 >= 12.13.0 （可以使用node -v命令查看）；
• Yarn 版本 >= 1.5（可以使用yarn --version命令查看）。

2. 參與步驟

Step 1：任務(wù)瀏覽

在?KubeVela 官方文檔翻譯登記并瀏覽有哪些任務(wù)可以認(rèn)領(lǐng)。

Step 2：任務(wù)領(lǐng)取

在 KubeVela 官方文檔翻譯登記表格中編輯并認(rèn)領(lǐng)任務(wù)。注意：為保證質(zhì)量，同一譯者只能同時(shí)認(rèn)領(lǐng)三個(gè)任務(wù)，完成后才可繼續(xù)認(rèn)領(lǐng)。

Step 3：本地構(gòu)建和預(yù)覽

# 命令安裝依賴 $ yarn install # 本地運(yùn)行中文文檔 $ 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

請(qǐng)勿修改?/docs目錄下內(nèi)容，中文文檔在?/i18n/zh/docusaurus-plugin-content-docs中，之后就可以在 http://localhost:3000/zh/ 中進(jìn)行預(yù)覽了。

Step 4：提交 PR

確認(rèn)翻譯完成就可以提交 PR 了，注意：為了方便 review 每篇翻譯為一個(gè) PR，如果翻譯多篇請(qǐng) checkout多個(gè)分支并提交多個(gè) PR。

Step 5：審閱

由 maintainer 對(duì) PR 進(jìn)行 review。

Step 6：任務(wù)完成

翻譯合格的文章將會(huì) merge 到 kubevela.io 的 master 分支進(jìn)行發(fā)布。

原文鏈接：https://developer.aliyun.com/article/783626?

版權(quán)聲明：本文內(nèi)容由阿里云實(shí)名注冊(cè)用戶自發(fā)貢獻(xiàn)，版權(quán)歸原作者所有，阿里云開發(fā)者社區(qū)不擁有其著作權(quán)，亦不承擔(dān)相應(yīng)法律責(zé)任。具體規(guī)則請(qǐng)查看《阿里云開發(fā)者社區(qū)用戶服務(wù)協(xié)議》和《阿里云開發(fā)者社區(qū)知識(shí)產(chǎn)權(quán)保護(hù)指引》。如果您發(fā)現(xiàn)本社區(qū)中有涉嫌抄襲的內(nèi)容，填寫侵權(quán)投訴表單進(jìn)行舉報(bào)，一經(jīng)查實(shí)，本社區(qū)將立刻刪除涉嫌侵權(quán)內(nèi)容。

總結(jié)

以上是生活随笔為你收集整理的【KubeVela 官方文档翻译】，欢迎大家踊跃参与的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。