...
翻译流程
1、前期工作
1) 注册 Github 账号,将官方仓库 官方仓库(https://github.com/hyperledger/fabric-docs-i18n) Fork 到自己的仓库。
2) 下载 git,https://www.git-scm.com/download/,安装运行 gitbash。
...
a) 打开 github,找到自己 fork 的仓库,clone with SSH,复制
b) 打开 git bash,粘贴复制的内容
git clone git@github.com:自己的/fabric-docs-cni18n.git
cd fabriccd fabric-docs-cn
git statusi18n
c) 切换 branch(从master到1.4.0_zh-CN branch(从master到 release-2.2 或者其他需要翻译的分支)
git branch –a
git checkout -b release-b 1.4.0_zh-CN2.2
2、认领任务
1.查看 issue 列表,根据当前任务的进度选择你要认领的任务。目前任务进度分为五个阶段:
- untranslated:尚未翻译
- transting:正在翻译
- unreviewed:尚未校对
- reviewing:正在校对
- completed:完成翻译并已校对,该标签的issue会被关闭
github中显示的标签如下:
,根据当前任务的进度选择你要认领的任务。
2.添加评论表明你要领取该翻译任务,然后等待管理员将任务分配给你。如下图:
...
3) 打开Github:Pull request – New pull request,比较上传,申请合并(填写描述)
4、查看翻译文档
Fabric Documents Translate Workflow
1. Prepare Documents Repository
1) Login Github and fork https://github.com/hyperledger-labs/fabric-docs-cn
2) Install git, more details see https://git-scm.com/downloads
3) Generate SSH key and it to your Github account, more details see https://help.github.com/en/github/authenticating-to-github/connecting-to-github-with-ssh
4) Clone the documents repository to your local use commond “git clone repo-url“, and checkout branch you want to use, like “git checkout -b release-2.2” it will change to branch release-2.2 which is Chinese translation branch.
2. Claim Tasks
1) Check the issue list https://github.com/hyperledger/fabric-docs-i18n/issues
2) Add a comment under the issue you want to claim, then wait for assigning by administrator. Like this:
3) If the list not contains the document you want to translate, make sure nobody has translated it, and then you can add an new issue,and leave a comment, then wait for assigning
4) Translate the documents after the administrator assigned it to youNOTE: If the issue is assigned more than two weeks, but not finished,anybody else can claim the issue again.
3. Upload Your Translations
1) Translate the documents with property editor,like Typora, VSCode, Atom, Vim. The source files are in fabric-docs-cn/docs/source directory
2) Commit and push your translation with signoff. The commonds are like this:
- git commit -s -m “your message”
- git push
3) Create a new Pull Reques in repository https://github.com/hyperledger/fabric-docs-i18n/issues,you can find it by chose “Pull request – New pull request”, then compare changes and create a PR with a message for want you have done.Like this:
4) Waiting for merge by administratorPR 被 merge 之后请去中文文档查看翻译内容是否已更新,如果没有更新请联系管理员。