GitHub学习之旅 之 HelloWorld

概述：

以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 的开源框架，地址为：点击打开链接