文档翻译要求
文档翻译工作由大家协作完成，每个人的习惯有所不同，为了使翻译内容整齐规范，建议大家翻译时参照本规范翻译文档内容和整理文档格式。具体内容如下：
- 翻译前请先阅读《术语表》，文中术语尽量按照术语表翻译，以免产生歧义；对于一些专有名词，容易引起歧义的单词，可以保留原单词不做翻译。
- 文档语句采用逐字逐句“正翻”的方法，不可自由发挥，确保翻译的严谨性，但是为了保证语义通顺，请合理地调整语序，我们知道英文的语言习惯和中文是不一样的；
- 在中文语句中出现的英文单词，应在英文单词前后各空一格，使文档保持美观。除非和英文单词相邻的是标点符号，这种情况可不加空格。
- 翻译语句的标点符号请使用中文标点，避免中英文标点混用的情况。提示：英文中没有顿号“、”，所以都使用逗号“,”表示停顿，在中文翻译中请使用“、”替换。
- 对于文中的引用、代码块、超链接，其内容可以保持原文，不强制要求翻译。
- 原文语句中的加粗、重点、斜体等标记，在翻译时也应该同样标记出来。
翻译流程
参与Hyperledger文档国际化工作流程
...
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-cni18ngit status
c) 切换 branch（从master到1.4.0_zh-CN branch（从master到 release-2.2 或者其他需要翻译的分支）
git branch –a
git checkout -b 1.4.0_zh-CNb release-2.2
2、认领任务
1
...
.查看 issue 列表
...
2) 如果issue中没有列出你要翻译的内容，在确保该内容没有人翻译的情况下，添加新issue，并添加“assign me”评论。
3)管理员将任务分配后，即可开始翻译。
，根据当前任务的进度选择你要认领的任务。
2.添加评论表明你要领取该翻译任务，然后等待管理员将任务分配给你。如下图：
3.如果issue中没有列出你要翻译的内容，在确保该内容没有人翻译的情况下，添加新issue，并添加评论表明你要认领该任务。
4.管理员将任务分配后，即可开始翻译。
注意：任务自被分配之日起两周未完成的可以被其他人重新认领。
...
3、翻译上传
1) 编辑中文版（位置目录：fabric-docs-cn/docs/source）
...
3) 打开Github：Pull request – New pull request，比较上传，申请合并（填写描述）
4、查看翻译文档
PR 被 merge 之后请去中文文档查看翻译内容是否已更新，如果没有更新请联系管理员。
5、其他参考文档
- 操作说明文档fabric1.2翻译指南.docx
- 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:
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 administrator这两个是早期版本的文档，仅供参考