Hyperledger Fabric 1.2翻译指南：协作与提交流程详解

Hyperledger Fabric 是一个开源的区块链平台，它在 Hyperledger 超级账本项目中占据核心地位，提供了企业级的分布式账本解决方案。这个翻译指南主要针对的是 Fabric 1.2 版本的技术文档翻译过程，旨在引导开发者和贡献者参与到 Fabric 的本地化工作中，以便更好地理解和使用该技术。 首先，翻译者需要具备一定的技术背景，尤其是对区块链和Hyperledger Fabric 的了解，因为这涉及到对技术细节的准确解读。加入 Fabric 的翻译工作需要以下几个步骤： 1. **前期准备**: - 注册并加入 GitHub：这是参与开源社区的基础，通过创建个人仓库（myrepositories）并fork官方文档仓库（https://github.com/hyperledger-labs/fabric-docs-cn）。 2. **版本控制工具**: - 安装 Git：作为分布式版本控制系统，Git 是协作翻译文档的重要工具，如安装 Git Bash 并配置 SSH 密钥，确保与 GitHub 的顺畅交互。 3. **设置 SSH key**: - 生成 SSH 密钥对，将公钥添加到 GitHub 账户的 SSH keys 设置中，便于克隆仓库。 4. **克隆仓库和切换分支**: - 使用 SSH URL 克隆个人 fork 的仓库，并切换到特定的翻译分支（如 1.2.0_zh-CN），以保持与官方文档同步。 5. **文档编辑**: - 有两种编辑方式可供选择： - 方法一：新建仓库，直接在 GitHub 网页上编辑中文文档，然后导出文件进行本地处理。 - 方法二：推荐使用轻量级富文本编辑器 Typora 进行编辑，支持 Markdown 和 ReStructuredText 格式，方便格式化和审阅。 6. **提交更改**: - 编辑完成后，使用 Git 提交更改，确保遵循适当的提交规范。比如，使用 `git add` 和 `git commit` 命令，并在提交消息中添加 `Signed-off-by` 以表明同意贡献协议。 7. **代码审查和合并**: - 在完成初步提交后，通过 Git 的 `git diff` 查看文件变化，确认无误后使用 `git push` 发送到 fork 的仓库。然后，向官方仓库发送 Pull Request，请求合并你的翻译更新。 8. **社区协作**: - 保持与社区的沟通，接受他人的反馈和建议，共同提升文档质量。 这个翻译指南强调了标准和协作的重要性，确保文档的准确性和一致性，对于那些希望参与开源社区、学习或分享 Fabric 技术的人来说，是一个宝贵的资源。通过遵循这些步骤，不仅能提高个人的技术能力，还能促进 Hyperledger Fabric 在中国的普及和发展。