Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

翻译流程

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,复制

Image RemovedImage Added


b) 打开 git bash,粘贴复制的内容
git clone git@github.com:自己的/fabric-docs-cni18n.git

Image Removed

cd fabriccd fabric-docs-cn
git statusImage Removedi18n

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

Image AddedImage Removed

2、认领任务

1.查看 issue 列表,根据当前任务的进度选择你要认领的任务。目前任务进度分为五个阶段:

  1. untranslated:尚未翻译
  2. transting:正在翻译
  3. unreviewed:尚未校对
  4. reviewing:正在校对
  5. completed:完成翻译并已校对,该标签的issue会被关闭

github中显示的标签如下:

Image Removed

,根据当前任务的进度选择你要认领的任务。

2.添加评论表明你要领取该翻译任务,然后等待管理员将任务分配给你。如下图:

...

3)  打开Github:Pull request – New pull request,比较上传,申请合并(填写描述)

...

PR 被 merge 之后请去中文文档查看翻译内容是否已更新,如果没有更新请联系管理员。


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

...

  1. untranslated:The document is waiting for translatin
  2. translating:The document is translating by someon
  3. unreviewed:The translation is not reviewe
  4. reviewing:The document is reviewing by someon
  5. completed:The documets is translated and the translation is reviewed ,and the issue will be closed

2) Add a comment under the issue you want to claim, then wait for assigning by administrator. Like this:

 Image Modified

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:

Image Modified

4) Waiting for merge by

...

administrator