-
Notifications
You must be signed in to change notification settings - Fork 417
附录:如何同时进行多篇文章的翻译
GCTT 项目的工作流程为: 选题->翻译->提交->校验->发布。如果译者每次都按照此流程完成一篇译文,再翻译下一篇的时,只要在 master
这个分支上进行简单操作即可。有时候,可能同时进行几篇文章的翻译,如果都在 Master 分支上工作,就有可能出现这样的情况:
一个 PR 提交了多篇文章,这和流程中的『PR 请只包含一篇文章的翻译成果』的要求是冲突。对于熟悉 Git 开发流程人来说,是一个很简单的问题,利用 Git 的分支。下面我们会介绍这种方法:
成功 Fork 后,你会在自己的账号下,发现 GCTT 的仓库。
anonymous2123
为我们的测试账号,你可以将anonymous2123
替换成你自己的账号运行以下命令。
λ git clone https://github.com/anonymous2123/GCTT.git
Cloning into 'GCTT'...
remote: Counting objects: 7459, done.
remote: Compressing objects: 100% (11/11), done.
remote: Total 7459 (delta 5), reused 14 (delta 5), pack-reused 7443
Receiving objects: 100% (7459/7459), 12.65 MiB | 973.00 KiB/s, done.
Resolving deltas: 100% (4979/4979), done.
一个重要的原则是,一个分支只对应一篇文,这里隐藏了一个问题,分支应该从哪里创建出来,我们的建议是保持 master 分支不动,所有的翻译分支都从 master 分支创建出来。了解更多关于分支
创建 trans_article_1
分支,并切换到该分支
git branch trans_article_1
git checkout trans_article_1
或者使用 -b
参数一步达成
git checkout -b trans_article_1
接下来,就可以在该分支进行翻译。翻译完成后,将工作提交到分支之中。
在正式推送到 Github 之前,你需要保证和 studygolang/GCTT 是同步的,以防止在提出 PR 的时候出现冲突。
git remote add upstream https://github.com/studygolang/GCTT.git // 只需要第一次做,之后不需要该步骤
git fetch upstream
git rebase upstream/master
将 trans_article_1
分支推动到你的 Github 仓库中,并以此在 Github 中创建相应的分支。
git push -f origin trans_article_1
Github 的效果如下,有 master
和 trans_article_1
两个分支:
最后,你只需要像在 master
分支一样,在 trans_article_1
分支向 studygolang/GCTT
提出 PR 请求。
当你同时进行另一篇翻译的时候,你需要回到 master
分支下,再创建一个新分支 trans_article_2
。注意不要在 trans_article_1
中创建 trans_article_2
分支。如此做,就意味着你把你上一篇翻译的文章引入到这一篇的分支中,在提交 PR 时,就会出现两篇文章,这不满足『PR 请只包含一篇文章的翻译成果』的要求。
git checkout master
git checkout -b trans_article_2
在 trans_article_2
分支中,执行相同的流程:翻译,commit,与 studygolang/GCTT 同步,提交到 Github 中,提出 PR,最后完成翻译。
以上的流程中,你有几篇文章,就有会几个分支,每一个分支都会向 studygolang/GCTT 提出自己 Pull Request。如果你需要修订你某一分支的提交,并不会影响其他分支。
这只是 Git&Github 的很小的一个应用场景,如果你想了解更多关于 Git 的知识,Git 的官方文档,或是 《Pro Git》 都不错的方式。