如何使用Github(依据官方向导“Hello World”整理)
Hello world项目在编程届是一个具有悠久历史的项目(工程/文件),很多时候它也是我们接触一门计算机语言的最初的记忆。同样的在GitHub也有Hello world项目,它是一个向导,通过它你将可以学会一下内容:
1. 创建并使用一个 repository(存储库/仓库)
2. 开始和管理一个新的branch(分支)
3. 修改一个文件,然后作为提交(commits)发布(push)到GitHub
4. 开放和合并一个提取请求(pull request)
什么是GitHub?
GitHub是一个代码版本控制和协作的托管平台。它能够让你在任何地方都能够加入到一个项目中,因为代码是托管在平台上的。
这一个示例将教会你使用GitHub使用的一些必须概念,例如:repositories(仓库)、 branches(分支)、 commits(提交)、Requests(请求)。
当然要完成这个向导的学习,一个GitHub和良好的网络连接是必不可少的。
Step 1. Create a Repository(创建一个存储库/仓库)
repository(存储库/仓库)通常是用来组织一个单独的项目的。在repository(存储库/仓库)中可以包含你的项目任何所需要的资源,包括:文件夹和文件、图片、视频、电子表格和数据集。通常建议你包括以下文件:README(自诉文件,就是包含一些和你项目相关的信息的文件)。这东西GitHub在你创建一个新的repository(存储库/仓库)的时候很容易的就会为你创建一个。而且它还能够为你提供一些其他的常见选项,例如一个许可证书之类的。
To create a new repository(创建一个存储库/仓库)
1、 在左上角avatar 或者identicon 的边上点击然后选择新的存储库
2、 为你的repository(存储库/仓库)命名为hello-world.
3、 写一个简短的描述。
4、 选择“Initialize this repository with a README”
5、 点击“Create repository“
Step 2. Create a Branch(创建一个分支)
这里讲的分支(Branch)指的是不同版本的存储库的工作方式。在默认配置下你的repository(存储库/仓库)有一个名为“master “的分支,它是主分支。在我们提交他们去到主分支之前,我们在各个分支进行实验和编辑。
当你创建了一个master的子分支的时候,你就做了master那个时间点的复制、快照。如果有其他人在master上进行了一些更新,你就可以将这些修改更新过去。
下跟的这个图表显示:
1、 一个master
2、 一个名为feature的master的分支
3、 更新在被归并到master之前的过程
这时候你有没有保存不同版本的文件呢?例如类似于story.txt、story-joe-edit.txt、story-joe-edit-reviewed.txt这样的文件。在GitHub各种分支完成的就是类似的东西。在Github,我们开发的时候就是利用这些分支管理,使得我们在各个master分支的子分支上修复Bug或者新功能添加完成后才将其归并到master分支。
To create a new branch(创建一个新的分支)
1、 去到你的新repository(存储库/仓库)hello-world
2、 点击顶部的下拉列表,选择master分支
3、 输入分支名到新分支的命名框,例如“readme-edits “
4、 在蓝色的创建分支选项点击,或者直接按下回车键
那么现在你就有了master分支和master分支的子分支readme-edits两个分支了。但通常这个过程不会太久,因为我们会对子分支进行修改,然后归并到主分支。
Step 3. Make and commitchanges(进行和提交修改)
现在,你可以在master分支的子分支readme-edits分支的代码视图进行修改操作。在GitHub,保存更改被称为提交。每个提交都有一个关联的提交消息,这是一个描述解释为什么进行一个特定的更改的消息。
Do Make and commit changes
1、 点击README.md 文件
2、 点击铅笔图标右上角的编辑文件的视图。
3、 在编辑器中,写一点关于你自己的情况。
4、 写一个用于描述您的更改的提交消息。
5、 点击“Commit changes”按钮
这些修改将会在readme-edits分支的README文件中进行,完成后readme-edits分支就有了和其主分支master分支所不同的内容。
Step 4. Open a Pull Request(打开一个合并请求)
Pull Request(合并请求)在Github的协作开发中是一个核心的支持。当你打开一个Pull Request(合并请求)的时候,意味着你提出了一个你的修改,并且请求某个人或某些人审查你的修改并将你的修改合并到他或者他们的分支中去。Pull Request请求展现的是不同分支间的差别、差异。其中的修改、添加和删除会使用绿色和红色标识。
一旦你执行了提交操作,你就可以打开一个Pull Request(合并请求)并开始讨论之前已经完成的代码。
通过在你的Pull Request(合并请求)中使用GitHub @mention系统,你可以随时和具体的反馈人或者团队进行交流。
你还可以在自己的代码库提交Pull Request(合并请求),并将修改内容合并到你自己的代码库。
Open a Pull Request forchanges to the README(为README的修改打开一个合并请求)
1、 单击Pull Request(合并请求)选项卡,然后在Pull Request(合并请求)页面点击绿色的新Pull Request(合并请求)按钮。
2、 在示例比较框,选择你想要选择的分支——readme-edits,和其主分支——master进行比较。
3、 在差别比较页面查看你的更改,确保他们是你想要的提交内容。
4、 当你满意的时候,即这些变化是你想要提交的内容的时候,点击绿色创建合并请求的按钮。
5、 为你的合并请求写一个标题和一个简短的描述,用于描述你的更改行为。
当你完成相关信息的填写后,记得点击创建合并请求按钮。
Step 5. Merge your PullRequest(归并你的合并请求)
在这最后一步了,在这一步把你在readme-edits分支的修改你合并到你的master主分支。
1、 单击绿色的Merge pull request(归并合并请求)按钮将更改归并到master分支。
2、 点击 Confirm merge(确认合并)按钮。
3、 然后执行删除分支操作,自从归并合并请求以来,在紫色框中的删除分支按钮就一直在那里了。
通过完成这个简单的向导教程之后,你便已经学会了在GitHub创建一个项目和执行相应的合并请求了。同时也开启了你的Github之旅。