概述:
以HelloWorld工程开始学习是编程历史传统,它是简单练习来开启你学习新东西的旅程,让我开始GitHub学习之旅吧
你将会学到以下内容:
- 创建和使用仓库
- 开始和管理新的分支
- 向GitHub提交你改变的文件
- 打开和合并一个pull请求(也就是贡献者提供的代码)
什么是GitHub?
GitHub是版本控制和合并的代码托管平台。它可以让你和世界各地的开发者进行开发。
这个教程教会你GitHub的必要的技能例如:什么仓库?什么是分支?提交、推送请求。你将会创建你自己HelloWorld仓库学习GitHub的PullRequest(推送请求)工作流,它是一个创建和代码审查流行的工作方式。
没有编码要求
为了完成这个教程,你需要一个GitHub.com 的账户和可以联网,你并需要知道如何编写代码、使用命令行,或者安装Git(它是一个版本控制软件,GitHub也就是建立这个上面)
温馨提示:你可以将该网页分开两个窗口或者tab,然后你可以对照步骤进行操作。
步骤1.创建一个仓库
一个仓库经常被用来组织一个单一工程的。仓库可以包含文件夹和文件、图片、视频,电子表格(例如Excel)和数据集等等,任何你工程需要的东西。我们推荐包含一个README,或一个文件来描述你的工程。GitHub将会很容易在你创建仓库的时候进行添加,它也提供其他公共的选项,例如证书文件
你的hello-world 仓库可以放置你的灵感,资源,甚至与其他人分享和讨论的东西都是可以的。
开始创建一个新的仓库
1、在页面右上角,在你头像旁边有个一个加号(+),点击加号弹出下拉框,然后选择 New repository
2、然后写你仓库的名称这里写hello-world
3、写一个简短的描述
4、选择在初始化仓库的时候自动创建一个README文件
点击Create Repository (创建仓库)
步骤2、创建分支
分支是在同一时间对于仓库不同版本的进行工作方式。
在默认情况下,你的仓库有一个默认的分支名称为master,它被考虑作为主分支,我们使用分支去实验和作出修改,然后把修改的内容提交到master分支上
当你从master中重新创建一个新的分支,你其实在做一次master的复制或者说快照,也就是master那个时候工作点。如果有人已经在master上你正在工作的部分做一些修改,这时候你需要先更新修改然后才能提交。
图表展示:
- master 分支
- 一个新分支成为feature(因为我们在这个分支上做一些特性工作)
- feature分支在被合并到master当中的操作的过程
你是否有为保存不同版本的文件?写成如何文件名:
- story.txt
- story-joe-edit.txt
- story0-joe-edit-reviewed.txt
在GitHub上分支就是完成类似的工作的
在Github,我们的开发者,作者、设计者使用分支去修改bug和特性的增加,当修改完成之后我们可以将这些分支合并到master分支上
创建一个新分支
1、切换到你的新库存hello-world.
2、点击左边中间位置有一个Branch master,会弹出下拉输入框
3、键入分支的名称,例如readme-edits
4、选择蓝色Create branch 按钮或者直接回车
现在你有两个分支,master和readme-edits.它们看起来是一样的,但是不是永远一样,接下来我们将会添加一些新的改变到新的分支上。
步骤3、增加和提交修改
恭喜你! 你现在可以在你的新分支readme-edits上做一些改变。
在GitHub,保存改变被称为提交,每个提交都会关联一个提交信息,提交信息就是描述你为什么提交? 提交信息将会在你历史提交信息中找到,其它开发者可以看你为甚提交和提交什么。
创建和提交改变
1、点击README.md 文件
2、点击右上角像笔的图标,将文件视图切换到编辑视图
3、随便写一写信息
4、写一下提交信息,描述你修改的内容
5、点击Commit changes(提交)按钮
README文件在readme-edits分支上已经做了修改,所以现在这个分支和master分支包含的内容不同了。
步骤4.打开一个Pull Request(推送请求)
编辑非常漂亮!现在你在readme-edits上有不同master分支的内容,你可以打开pull Request
Pull Request 是在GitHub的整合的核心,当你打开一个pull request, 你将会提议你的修改去请求某人去审查,然后将你的修改整合master分支上。Pull request 将会展示差异地方,或者两个分支的内容不同。这个修改、增加、删除都会用绿色和红色展示。
只要你做了提交,你可以打开pull request 开始去讨论,甚至可以在代码完成之前。
通过在你提交信息使用GitHUB的 @mention System(提示系统),你可以请求特定人或者团队对你进行反馈。
你也可以打开pull Request在你自己的仓库,然后合并它们,在工作大的项目这是一个非常好的方式学习GitHub流。
为修改的README打开一个pull Request
=================================================================================================================
=========================================================================================================================
总结:就是它采用的是请求模式,你不能直接提交,你需要请求有资格人给你进行代码审查。
步骤5、合并你pull Request
这是最后一步,是时候合并你的修改,将分支readme-edits 合并到 master分支
1、点击绿色Merge pull request 按钮去合并修改到master分支
2、点击确认合并
3、当合并完成之后,开始删除你readme-edits分支,点击Delete branch 按钮在紫色对话框里
恭喜你完成教程,你已经学会在gitHub创建工程,然后pull request
如果你想学习更多Pull Request 的技能,我们推荐你读 GitHub Flow Guide,你可以探索GitHub 的开源框架,地址为:点击打开链接