什么是GitHub?
GitHub是一个具有版本控制和协作的代码托管平台,它可以让你和任何地方的人一起开发一个项目。这个指导将会教你GitHub最基础的东西,像项目库、分支、提交和请求。你将创建自己的HelloWorld库并且学习GitHub的Pull request工作流程,对于创建和回顾代码来书这种方式很受欢迎。
不需要写代码
要完成这个教程,你只需要一个GitHub账户和网络就可以。不需要知道怎么编码、不用谢命令行或者安装Git(GitHub版本控制软件就是基于它的)。
第一步 创建库
一个库通常用来管理一个单一的项目工程。库可以包含文件夹、文件、图片、视频、电子表格和数据集——项目需要的任何东西。一般建议包含一个README文件,或者一个包含关于项目信息的文件。GitHub会在你创建库的时候提供添加这个文件,同时也提供其他的通用的选项例如协议文件。你的HelloWorld 库是一个可以存放想法、资源、甚至和其他人分享与讨论事情。
创建一个新的库
- 登陆自己的GitHub账户(注册账户),右上角头像旁边,点击“+”,选择“New repository”。
- 库名称填“hello_world”。
- 写一个库的介绍(非必需)。
- 勾选“Initialize this repository with a README"。
点击“create repository”。
第二步 创建分支
分支是一种可以同时在不同版本上工作的方法。
默认情况库里有一个名为master的分支,在讲其他分支提交到master分支之前,我们为您在这些分支上实验和编辑。当你创建了一个不同于master分支的分支的时候,相当于你将master分支复制了一份。当你在你的分支工作的时候,有人修改了这个项目,你可以将这些更改作为更新添加到你的master分支项目中。
下面的图展示了:
- master主分支。
- 一个新分支feature(因为我们正在做其他的工作,分支的名称可以随意)。
- 这是feature分支在合并到master之前的过程。
你是否见过一个文件的不同版本尼?比如:
- story.txt
- story-joy.txt
- story-joy-reviewed.txt
在GitHub库中,不同的分支完成的都是相似的目标。在GitHUb,开发者、作家和设计师使用来自master不同的分支完成修复bug和不同工作,修改完成后,吧他们的分支合并到master中。
创建一个新的分支
- 进入你新建的库hello_world。
- 点击branch标签按钮的下拉菜单中的master。
- 在文本框中输入新分支名字rename—edits。
- 点击蓝色的”createbranch“按钮或者按回车。
现在,你有两个分支,master和rename—edits,他们看起来几乎一样,但是不会太久!接下来在新分支中添加改动。
第三步 提交更改
现在你看到的是readme—edits分支的内容,这是复制master的。我们做一些修改。
在GitHub,保存改动叫做commits,每一个commit有一个关联的commit信息,这个信息用来解释为什么做这样的改动,捕获改动的历史记录,其他人可以明白你做了什么。
提交更改
- 点击”README.md“文件。
- 点击右上角的铅笔图标,编辑代码。
- 在编辑器里,写一点东西。
- 在”commit changes“里填写修改标题和描述。
- 点击”commit changes"按钮。
现在已经在readme—edits分支里做了改动,该分支的内容和master分支的内容已经不同。
第四步 打开一个Pull Request
改的好,现在你已经做了不同于master的改动,可以打开一个pull request了。
Pull Request是GitHub协作的核心,当你发起一次PullRequest时,你是在提出你的改动,是在请别人(也可以是你自己)检查你的工作并把这些改动合并到他的分支中。Pull request 显示了两个分支内容的差别和差异,修改、添加和删除都会用绿色和红色标注出来。一旦你提交一次,只要在编码完成之前你就可以打开一个pull request并且开始讨论。
通过在你的pull request中使用GitHub的通知系统(@mention system),你可以要求特定的人或团队回复信息,即使他们在大定或者十个时区那么远。
你也可以在你自己的仓库中开启pull request然后自己合并他们。这是一种在为大项目工作前学习GitHub Flow的好方法。
开启一个修改README文件的Pull Request
点击图片可放大查看。
步骤 | 操作截图 |
---|---|
点击pull request标签,在pull request页面点击右下角的绿色按钮“New pull request" | ![]() |
在 Example Comparisons表格中选择你创建的分支readme—edits与master分支作比较 | ![]() |
在比较页面查看修改的差异,确定是你想要提交的 | ![]() |
当你对这些提交的修改满意时,点击绿色按钮 Create Pull Request | ![]() |
给你的pull request 一个标题并且写一点对修改的描述 | ![]() |
编辑完之后,点击”create pullrequest “按钮。
第五步 合并你的Pull Request
在这最后一步,是时候将你修改的分支readme—edits合并到master中了。
- 点击”Merge pull request“按钮,吧修改合并到master中。
- 点击”Comfirm merge“。
- 续并且修改已经合并成功,点击紫色框中的”Delete branch“,删除分支(或者不删除以便在该分支上继续做修改)。
恭喜!
通过完成这个教学,你已经学到在GitHub创建项目和做一个pull request
下面是你在这个教学中学到的:
- 创建一个开源仓库
- 启动并管理一个新分支
- 修改文件并提交改变到GitHub
- 开启和合并一个Pull Request
