Skip to content
This repository has been archived by the owner on Sep 26, 2019. It is now read-only.

Github 新手指南:关于如何提交翻译以及后续更新的教程

Yucheng Wang edited this page Dec 16, 2017 · 8 revisions

本教程主要面向新接触 GitHub 的译者们,为了更方便的完成翻译任务而写。注意,本教程基于 GitHub 网页版操作。

1. 认领任务

先在 Issue 中挑选自己喜欢的文章进行认领。

2. Fork 翻译计划仓库

如果你之前有 Fork 过,请跳过这一步。并在开始翻译之前先 同步 一下翻译计划仓库,否则无法找到认领的文章。

访问Android Thing 翻译计划主页,并 Fork 到自己的账号下。

3. 进入 Fork 的仓库主页

回到自己的 GitHub 主页,并找到刚刚 Fork 过的翻译计划仓库,进入仓库主页。例如,我的即是 github.com/Zheaoli/atdocs

4. 新建 branch

现在你需要新建一个用于翻译一篇文章的 branch,先用鼠标左键单击 1 号箭头指向的位置,然后在 2 号箭头指向的地方填写新分支名称,我们推荐的新分支名格式为:章节名(例如 Hardware)/文件名,填写好后就会出现如 3 号箭头所示的东西,这时用鼠标左键单击它,新 branch 就建立好了,并且现在已经自动跳转到了这个新的 branch 上。

注:新建的分支用于进行翻译以及提交翻译。master 分支用于与翻译计划进行同步更新。

image

关联上级目录 git remote add upstream https://github.com/gdsub/atdocs.git

如果项目有新的更新,更新本地仓库

git fetch upstream

5. 找到翻译的文章

image

在所负责的章节文件夹中找到翻译的文章对应的 Markdown 文件(PS:可通过文件名使用浏览器的快速搜索找到)。然后点击 Raw 查看原始内容,并右键另存为将其保存到本地。

5. 翻译文章

在你的电脑上找到刚刚保存的文件,使用编辑器打开,开始进行翻译,翻译时保留英文,在新起一行记录翻译内容。

6. 提交翻译

翻译完成之后,在你 Fork 的仓库中找到对应的你翻译的文章,然后点击编辑按钮,将你的译文复制进去并将原有内容覆盖掉。滚动到页面最下方,第一步填写 Commit changes 信息并提交,初次提交译文时请勾选 Commit directly to the training/first-device.,之后点击 Commit changes 按钮进行提交。

image

7. 发起 Pull request

进行完第 6 步的提交之后,还在这个你 Fork 的 Repo 下点击 Pull requests 按钮,然后在页面右边会出现 New pull request 按钮,并点击它。

image

这时会自动跳转到翻译计划的 Repo 下,接下来你按照下图的解释进行操作:

自此,翻译提交完成,请等待其他译者校对。

8. 根据校对意见进行调整

在自己的项目主页中先切换到第 6 步提交时新创建的分支(参考下图),然后在相应文件夹中找到自己翻译的文章,点击编辑按钮并根据校对意见进行调整。调整完成之后提交时请选择 Commit directly to the ... 直接进行提交。不要新创建分支也不要重新创建 PR,该次提交会自动同步至之前的 PR 下面。

image

image

自此,修改提交完成,请等待技术终审。