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 列表,根据当前任务的进度选择你要认领的任务。目前任务进度分为五个阶段:找到尚未分配的任务,添加评论表明你想领取该翻译任务,然后等待管理员将任务分配给你。如下图:,根据当前任务的进度选择你要认领的任务。

Image Removed

2.如果issue中没有列出你要翻译的内容,在确保该内容没有人翻译的情况下,添加新issue,并添加评论表明你要认领该任务。添加评论表明你要领取该翻译任务,然后等待管理员将任务分配给你。如下图:

Image Added

3.管理员将任务分配后,即可开始翻译。如果issue中没有列出你要翻译的内容,在确保该内容没有人翻译的情况下,添加新issue,并添加评论表明你要认领该任务。3.任务自被分配之日起两周未完成的可以被其他人重新认领。

4.管理员将任务分配后,即可开始翻译

注意:任务自被分配之日起两周未完成的可以被其他人重新认领。

3、翻译上传

1)  编辑中文版(位置目录:fabric-docs-cn/docs/source)

...

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

4、查看翻译文档

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

5、其他参考文档

  1. 操作说明文档fabric1.2翻译指南.docx
  2. 1.1.0版本的操作文档:如何参与hyperledger中文翻译工作.pdf


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:

 Image Added

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 Added

4) Waiting for merge by administrator这两个是早期版本的文档,仅供参考