来源 | 阿里巴巴云原生公众号
背景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/ ? 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 的 master 分支进行发布。
时间回到2009年 那年 刚刚成立的阿里云正处于风口浪尖 在其他互联网大佬口中 要...
已经聊了三期和安全相关的话题 涉及安全审计和洞察、源码安全检测、数据备份和恢...
一、概述 二、原因 三、解决方案 四、总结 概述 在密码学中, 雪崩效应 ( avala...
大数据是未来的职业。我还要说更多:开发人员的数据工程技能是迫切需要的。在200...
1.胖不是罪,只是上帝嫉妒你瘦下去会太完美。 2.我未来的老公,别对你现在对象...
一、什么是变量? 变量从字面意思可以理解成:是变化的量。但是这样理解和没有理...
1.如果我能原谅你的庸俗,那么你能原谅我的装逼么? 2.有时候,我在想,我眼里...
云计算服务正在以前所未有的速度在各行各业快速普及,成为IT应用的最主流实现形...
本文转载自微信公众号「接地气学堂 」,作者接地气的陈老师 。转载本文请联系接...
鱼皮结合自己的大学经历,现身说法! 时间好快呀,鱼皮的老弟小阿巴已经在大学读...