参与Hyperledger文档国际化工作流程
1、前期工作
1) 注册Github,根据官方仓库,Fork 一个自己的存储库(my repositories)。
2) 下载git,https://www.git-scm.com/download/,安装运行gitbash。
3) 设定SSH:
a) 打开git bash,输入命令:
ssh-keygen
cat .ssh/id
git config --global user.name "自己的名字或者GitHub账户名字"
git config --global user.email 自己GitHub的认证邮箱账户
b) 打开github网页,网页右上角settings – SSH and GPG keys – New SSH key。将cat命令打印的内容拷贝粘贴到New SSH key里面。
4) 克隆存储库并更改branch
a) 打开github,找到自己的fork,clone with SSH,复制
b) 打开git bash,粘贴复制的内容
git clone git@github.com:自己的/fabric-docs-cn.git
cd fabric-docs-cn
git status
c) 更换branch(从master到1.4.0_zh-CN)
git branch –a
git checkout -b 1.4.0_zh-CN
2、翻译上传
1) 编辑中文版(位置目录:fabric-docs-cn/docs/source)
a) 方法一:新建存储库,网页上编辑中文版,导出文件(git clone),复制到目录
b) 方法二(推荐):下载 md/rst 格式文件编辑器 typora,直接编辑对应文件。(如有 IDE 则可直接编辑,rst 可在 http://rst.ninjs.org/ 上审阅)
注意格式:斜体、粗体、超链接、注释……
2) 提交更改、signoff 及合并
cd fabric-docs-cn
查看文件变化:git diff (Ctrl+c退出)
git add docs/source/文件名
Signoff提交:git commit -s -m "这里用英文写本次提交翻译了什么"
git push
3) 打开Github:Pull request – New pull request,比较上传,申请合并(填写描述)
3、 附件
1) 术语对照:术语表
其他:许可/非许可(permissioned/permissionless)
4、其他参考文档
- 操作说明文档fabric1.2翻译指南.docx
- 1.1.0版本的操作文档:如何参与hyperledger中文翻译工作.pdf。
这两个是早期版本的文档,仅供参考