Skip to content
samita edited this page Apr 23, 2015 · 8 revisions

Advanced-Bash-Scripting-Guide-in-Chinese项目-翻译流程-教程

LinuxStory/Advanced-Bash-Scripting-Guide-in-Chinese(以下简称ABS)是LS(LinuxStory)尝试翻译的第一本书。站点位置: https://github.com/LinuxStory/Advanced-Bash-Scripting-Guide-in-Chinese 我们使用的是Github管理项目,很多同学对Github不熟悉,我们的教程就从基本的注册开始吧。

这是高手翻译流程:

以下为详细流程:

第一步:注册

进入https://github.com/ 网页,点击注册,完成你的注册信息。如果是win用户,可以在这里下载Github客户端https://windows.github.com/

注册完成后进入类似新手引导界面

第二步:fork项目

进入我们的站点 https://github.com/LinuxStory/Advanced-Bash-Scripting-Guide-in-Chinese

点击右上方的fork按钮(三个button的最后一个button,可能会弹出头像选择,选择自己要使用的账号名即可),这样项目就fork到你的名下啦,我们返回个人网页就能看到这个项目

点击这个项目,进入你的ABS项目页面。请检查地址为: https://github.com/rootG/Advanced-Bash-Scripting-Guide-in-Chinese rootG处为你的用户名)

页面请停留在此,后面需用到。

第三步:clone项目到本地

Linux下建好文件夹(你想把项目放在哪里的文件夹),在当前文件夹打开终端; Win下的也先建好文件夹,然后安装github客户端(客户端自带Git shell),打开Git shell,将路径设置为之前建好的文件夹的路径。 如何设置路径:比如我这里文件夹的目录为C:\Github(所建文件夹为Github) 打开Git shell(我这里用cmd演示,道理相同)

输入命令行 cd c:\ 按回车

再输入命令行cd Github再按回车,路径就设置为了之前所建文件夹的路径。

PS:或者也可以使用Github客户端改变项目放置路径:打开Github客户端登陆后,在界面右上角找到齿轮图标选择options:

在option中找到clone path的选项,将路径改为之前你创建文件夹的路径,比如我是C:\Github然后左下角保存

设置好路径后开始clone项目: 在刚才的路径输入命令行:git clone 项目地址 项目地址就是第二步我们最后停留页面的地址 然后点击回车键Enter 我应该输入的命令就是:git clone https://github.com/rootG/Advanced-Bash-Scripting-Guide-in-Chinese,回车:

到这里,项目就clone到本地啦,可以进入本地查看。

是的,我们Github文件夹下面已经出现我们项目ABS的文件夹啦,clone完成!

第四步:新建分支

返回我们的Git shell(/终端),现在我们shell还停留在Github文件夹处,而我们新建分支需要对ABS文件夹操作,所以我们先用cd 进入ABS文件夹。 命令行:cd Advanced-Bash-Scripting-Guide-in-Chinese/

(温馨提示:输入cd Adv不用输入完整,可按tab键——左边换行按钮,自动补全)

然后点击回车键Enter,会显示:

你会看到下面地址已从Github进入ABS文件夹啦 细心的同学可能发现ABS文件夹后面跟了一个尾巴<master>。是的,这就是传说中的主分支!就像一棵树的树干。

现在我们来新建分支,也就相当于树枝丫。 命令行:git checkout -b dev 然后Enter dev为分支名,你可以自己命名,我这里命名为rootG,enter之后:

是的,被你发现了,ABS的小尾巴已经变成<rootG>啦,这就意味着我在自己家里啦,终于可以大吃大喝不用顾忌形象(分支操作不会对主干造成致命伤害)。

第五步:添加远程库

这一步就是让你的项目和正派老大(我们翻译的ABS项目)接头,方便以后交流。 命令行:git remote add upstream https://github.com/LinuxStory/Advanced-Bash-Scripting-Guide-in-Chinese.git

这一步不会有任何提示那就意味着你的操作No problem!

第六步:更新操作

命令行:git remote update 要Enter啦,不需要提醒了吧(●’◡’●) 更新完成~

第七步:把更新的信息拉取到本地

命令行:git fetch upstream master

第八步:更新合并到你的分支

命令行:git rebase upstream/master

温馨提示:如果在操作过程中迷失了自我,可输入命令行 git branch 查看是否在自己的分支活动

没错,依然指示在rootG分支,一切正常。咱们进行下一步

第九步:提交翻译成果

记住哟:

  1. 在自己的家里放肆,别在master这样的公众场合破坏形象(说人话:保持在分支中操作)
  2. 第九步之前的初始化到你提交自己的成果过程中,如果项目有更新,需要重复:更新到拉取到本地,再到更新合并到你的分支这几步。即:第六七八步。注意操作文件位置为ABS文件下。

然后将你翻译的文章放入相应位置(翻译内容统一放在source文件夹),如果我翻译的是part2的chapter 6,所以我把chapter 6 放入/source/part2中。此处我使用text.md进行测试。(注意:命名请和其他成员保持一致。)

先在回到终端查看,是否提示本地项目有所改变 命令行:git status

它告诉我们,新加了一个文件text.md 回到我们ABS文件夹,找到readme文件 打开,在翻译进度,自己翻译的位置添加自己Github账号,并保存

操作之后在终端使用命令依然能看到有更新信息。

这两项完成之后,我们开始提交 提交需要进入text.md所在文件夹,所以我们使用cd 进入相应文件夹,一步一步来为 cd source 从ABS大文件夹进入source文件夹;接着 cd part2 从source进入part2

现在开始提交: 命令行:git add 你的文件名(加后缀哦) 我们同样可以使用tab自动补全。

我这里为 git add text.md

这里也是没有任何回馈就是操作正确的意思 接着,我们写提交信息 命令行:git commit -m ’xxxx’

注意 ‘’为半角单引号 xxxx为你要说的话

我进行测试,我的命令行为:git commit -m ’finish text‘

现在,将你的修改push到你fork的项目中去 命令行:git push origin xxxx

注意xxxx是指你的分支

我的命令行为:git push origin rootG

注意 这个步骤经常出现这样的错误

放心这不是你的问题,多重复几次这个命令就好啦 到这里你可以关闭终端咯!

第十步:pull你的项目

网页登录Github进入你的ABS项目下即 https://github.com/rootG/Advanced-Bash-Scripting-Guide-in-ChineserootG为你的用户名)

在右边Code栏下面可以看见一个pull request 按钮,我们点击进去

进去之后再点击最显眼的绿色按钮 new pull request

点击绿色按钮,之后进入这一的界面,

Open a pull request文字下长框内,左边是你要pull的目的地,右边是你的出发点。

注意:前面base框中选择master,右边框中的compare框中选择你的分支(上图右边框可能未选择,默认显示为master分支,重新选择你的分支即可)

下面有个框,题目是你刚才写的提交信息(我的显示为 finish text),下面是一个评论框,你可以输入这次提交内容的详细信息,对刚刚的更新进行解释。 点击绿色按钮create pull request 提交

如果要合并到主分支,还可以进入LS的ABS页面,点击pull request进行相关操作!

嗯,夜深了,别熬了,碎觉!请校验and修改。