Hello World——Github官方新手教程

译/莫云斌

在编程界，初学者编写Hello World程序是一个历史悠久的传统了。当你学习新东西的时候，Hello World可以很容易的帮你入门。接下来，让我们开始Github的学习吧。

下面你将会学到：

• 创建和使用一个仓库
• 创建和编辑一个分支
• 修改一个文件并且提交到Github
• 打开并合并一个推送的请求

什么是Github

Github是一个拥有版本控制和共享合作功能的代码托管平台。它能让你和其他工作者在任何地方一起对托管的项目进行编辑。

本教程会教给你Github的重要知识，像仓库，分支，提交，拉取请求。你会创造出自己的Hello World仓库，学习在上面发布请求的操作流程，这是个很受欢迎的创建代码和审查代码的工作方式。

不用写代码

完成该教程，你需要一个Github帐号和良好的网络环境。你不用知道怎样编写代码，不用知道怎样用命令行，或者是安装Git（Github就是建立在该版本控制软件之上的）。

第一步：建立一个仓库

一个仓库通常创建一个单一的项目。在工程中只要你需要什么都能够放进去，比如，文件夹，文件，图片，视频，电子表格，数据等。我们推荐你建立一个Readme文件，或是一个能说明项目的文件。Github能够很简单de在同一时间创造和添加一个新的仓库，它会提供常见的功能选项，比如说，权限文件。

你的HelloWorld仓库能够成为你存储想法的地方，甚至还可以与其他人分享与讨论。

创建一个新的仓库

1. 在右上角，挨着你的头像或是ID的地方，有一个“+”，点击它，然后选择创建一个新的仓库。

2. 给你的仓库取名为“HelloWorld”。

3. 写一个简介。

4. 选择初始化仓库时创建一个Readme文件。

然后单击创建仓库～～～

第二步：创建一个分支

分支是一个仓库同时工作在不同版本的一种方式。

默认情况下，你的仓库有一个直接使用的分支，它叫master。在提交之前，我们可以用其他分支来实验和编辑项目。

当你想从主节点创建分支时，就需要在同一时间上创建主节点的副本或是快照。如果有人修改了你的项目，而恰巧你在主节点项目上工作着，那么就可以合并这些更新的内容。

如图所示.png

该图显示了以下内容：

• 主分支

• 一个新的分支，我们把它称作featrue（因为我们在这条分支上做了区别于主分支的工作内容）
• 该功能合并了所有修改的项目到主分支中

你曾经保存过不同版本的文件吗？就像一下这些：

• story.txt

• story-joe-edit.txt
• story-joe-edit-reviewed.txt

分支在Github仓库中会完成相同的目标工程。

在Github，我们的开发者、读者、设计者会借此修复Bug和增加新功能。当更新准备好时，他们会合并这些新的内容到主项目中。

创建一个新的分支

1. 去你的HelloWorld仓库

2. 单击顶部“branch：master”的下拉菜单

3. 在新的分支框中取名为“Readme-edits”

4. 选择蓝色背景的“创建新分支”，或者敲击键盘的“Enter”

readme-edits.gif

现在你已经有两个分支了，一个是“master”，一个是“Readme-edits”。它们看起来很像昂，但实际并不是的。接下来，我们要添加新的修改内容到我们的新分支中。

第三部：编辑和发布更改的内容

现在，你看到的是Readme-edits分支的代码编辑页面，里面的内容是复制master的。让我们来做一些更改。

在Github平台上，保存更改被称作发布。每发布一次都会附加着说明信息，用来解释特别的更新内容。发布的附加信息相当于历史更新的快照，其他项目参与者可以明白你做出的更改和更新的原因。

编辑和发布更新

1. 单击“README.md”文件

2. 在文件视图的右上角点击铅笔类型的图标

3. 在编辑器里编辑你的内容

4. 编写发布信息，来描述你的更新动态

5. 点击发布按钮

发布更新.png

这些更改仅作为Readme-edits分支上的README文件，因此现在此分支包含与master不同的内容。

第四步：拉取请求

现在你已经对master做出了更改，然后可以拉取请求了。拉取请求是Github合作功能的核心。当你打开此功能，并且发布了更改内容后，那么就可以请求别人审核和更改你的分支内容，并将其进行合并。该功能显示了来自两个分支的不同之处，更改，添加和删减的内容会相应的显示为绿色和红色。

一旦你完成了提交就可以开启拉取请求功能，并且能够和其他人讨论了。该功能甚至也能在项目代码没有完成的情况下使用。

在你的请求信息中可以通过@功能，提示某些特定的人或团队参与，不管他们在哪里都能够接收到提示。

你甚至可以在自己的仓库里拉取请求，并且自行合并。在进行大项目之前这是一个很好的学习Github Flow的方式。

打开召集请求功能，用来更改README文件

• 点击“Pull Request”选项卡，进入新界面，然后点击绿色的按钮

pr-tab.gif

• 与主节点进行比较，选择你创建的“Readme-edits”分支，

• 查看你修改的内容，然后确定哪些是你想要发布的

• 当你确定这些是要提交的更改后，点击提交按钮

• 给你的请求信息一个主题，并且添加一个对更新的简短描述

当你编辑完这些内容后，点击创建按钮

create.png

第五步：合并召集的请求

已经到最后一步了。是时候让你的更改合并在一起了——合并你的master主节点和Readme-edits分支。

1. 通过单击合并按钮和执行操作

2. 单击确认合并

3. 返回并且删除分支。被删除分支的内容已经合并到了master中。

合并分支.png

恭喜

通过完成此向导，你已经学会了在Github上新建项目和发布请求。

下面是所完成的内容：

• 创建一个开放的仓库

• 开始设计新的分支

• 修改文件并且在Github上发布

• 开启并且合并拉取的请求

看看你的Github配置文件，你会看到的贡献栏目。想要学习更多关于召集请求的内容，我们推荐你阅读Github Flow Guide
你也可以访问Github Explore并且参与开源项目。

这是官方原文