-
Notifications
You must be signed in to change notification settings - Fork 16
Github 新手指南:关于如何提交翻译以及后续更新的教程
本教程主要面向新接触 GitHub 的译者们,为了更方便的完成翻译任务而写。注意,本教程基于 GitHub 网页版操作。
先在 Issue 中挑选自己喜欢的文章进行认领。
如果你之前有 Fork 过,请跳过这一步。并在开始翻译之前先 同步 一下翻译计划仓库,否则无法找到认领的文章。
访问Android Thing 翻译计划主页,并 Fork 到自己的账号下。
回到自己的 GitHub 主页,并找到刚刚 Fork 过的翻译计划仓库,进入仓库主页。例如,我的即是 github.com/Zheaoli/atdocs。
现在你需要新建一个用于翻译一篇文章的 branch
,先用鼠标左键单击 1
号箭头指向的位置,然后在 2
号箭头指向的地方填写新分支名称,我们推荐的新分支名格式为:章节名(例如 Hardware)/文件名
,填写好后就会出现如 3
号箭头所示的东西,这时用鼠标左键单击它,新 branch
就建立好了,并且现在已经自动跳转到了这个新的 branch
上。
注:新建的分支用于进行翻译以及提交翻译。master
分支用于与翻译计划进行同步更新。
关联上级目录
git remote add upstream https://github.com/gdsub/atdocs.git
如果项目有新的更新,更新本地仓库
git fetch upstream
在所负责的章节文件夹中找到翻译的文章对应的 Markdown 文件(PS:可通过文件名使用浏览器的快速搜索找到)。然后点击 Raw
查看原始内容,并右键另存为将其保存到本地。
在你的电脑上找到刚刚保存的文件,使用编辑器打开,开始进行翻译,翻译时保留英文,在新起一行记录翻译内容。
翻译完成之后,在你 Fork 的仓库中找到对应的你翻译的文章,然后点击编辑按钮,将你的译文复制进去并将原有内容覆盖掉。滚动到页面最下方,第一步填写 Commit changes 信息并提交,初次提交译文时请勾选 Commit directly to the training/first-device.
,之后点击 Commit changes
按钮进行提交。
进行完第 6 步的提交之后,还在这个你 Fork 的 Repo 下点击 Pull requests
按钮,然后在页面右边会出现 New pull request
按钮,并点击它。
这时会自动跳转到翻译计划的 Repo 下,接下来你按照下图的解释进行操作:
自此,翻译提交完成,请等待其他译者校对。
在自己的项目主页中先切换到第 6 步提交时新创建的分支(参考下图),然后在相应文件夹中找到自己翻译的文章,点击编辑按钮并根据校对意见进行调整。调整完成之后提交时请选择 Commit directly to the ...
直接进行提交。不要新创建分支也不要重新创建 PR,该次提交会自动同步至之前的 PR 下面。
自此,修改提交完成,请等待技术终审。