GitHub Hello world中文教程

原文网址：https://guides.github.com/activities/hello-world/

前言：

Hello world程序是一个计算机编程里的非常经得起考验的程序。在你开始学习一种新的语言的时候，Hello world程序是一个非常好的开始。所以让我们也从Hello world来学习GitHub

你将要学会：

1:创建和使用一个库（repository）
2:开始和管理一个新的分支（branch）
3:更改文件（files）并且作为承诺（commits）提交给GitHub
4:打开和合并一个pull请求

什么是GitHub？

GitHub是一个用来实现代码版本控制和协作的代码托管平台。它可以让你和其他人在任何地方共同开展项目。
本教程教你的GitHub的几个要素如：库（repository）， 分支（branch），提交（commits） ，和pull请求。你将会创建一个Hello world库，同时要学习GitHub的pull请求工作流，这是一种流行的创建和检查代码的方法。

没有编程的必要

为了完成这一个教程，你需要GitHub账号还有网络连接。你不需要知道怎么编程，怎么使用命令行，或者怎么安装Git。
提示：你最好同时打开两个标签页，这样你可以一边看教程一边完成教程里的步骤。

---

第一步：创建库（repository）

库（repository）经常被用来组织单个工程。库可以包含你的程序需要的一切（包括：文件夹（folder），图片（images），视频（video），电子表格（spreadsheet），还有数据集（data sets））。
我们推荐库（repository）里应该包括一个README文件，或者是一个保存了你的工程（project）的信息的文件。GitHub的功能十分强大，可以让你在创建库（repository）的时候轻松添加这几个文件。GitHub还可以比如提供其他默认文件创建选项比如许可证（license）文件。

你的hello-world库可以成为保存你的想法（ideas）,资源（resources），甚至是和其他人讨论和分享东西的地方。

创建一个新的库（repository）

1:在右上角，在你的头像或者是id旁边，点击选择New repository。
2:将你的库命名为hello-world。
3:写一个简短的描述。
4:选择Initialize this repository with a README.

点击Create repository。完成创建。

第二步:创建一个分支（branch）

分支（Branching）是一种同时在同一个库（repository）的不同的版本（version）上同时工作的方法。
你的库（repository）有一个默认的分支（branch）叫做master，这个分支被认为是决定性（definitive）分支（branch）。我们使用不同的分支（branches）在提交（commits）给master之前进行试验和更改。

当你创建了一个master分支的分支，你就创建了master分支在那个时间点的一个副本。如果有人在你在你的分支（branch）上工作的时候更改了master分支，你可以把这些更新都pull到master。

这个图表显示：

1：master分支
2：一个叫做特性——feature的新分支（因为我们在这个分支上进行了特性feature操作）
3：在合并入master之前feature分支都经历了什么

你是不是看到过像下面这样的不同版本的文件：

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

在GitHub中分支（branches）完成的是相似的目的。

在GitHub中，开发者，写文档的，设计者都使用从master分出来的分支（branches）来修复bug和添加新特性（feature）的通知。当改动完成之后，这些分支就会被合并入master。

创建一个新的分支（branch）

1：进入你的新库（repository）hello-world
2: 点击下拉栏，下拉栏列表的最上面是master
3：在新分支（new branch）的文本框里输入一个名字——readme-edits
4：选择蓝色的Create branch框，或者是敲回车。

现在你拥有两个分支（branch），master分支和readme-edits。它们现在看上去没什么不同，但是过一会我们会在新的分支（branch）中加入我们的更改（changes）。

第三步：更改和提交（commit）更改（changes）

Bravo!（这里翻译了就没感觉了），现在你从编码的视角看上去readme-edits就是master的一个副本。让我们来做出一些更改（changes）。

在GitHub上，保存更改（changes）叫做提交（commits）。每一个提交（commits）都关联着一个提交信息（commit messages）,这个信息反映了这一更改（changes）为什么要被做出。提交信息（commit messages）捕获了你做出的更改（changes）的历史。这样其他的贡献者（contributors）就可以理解你的更改（changes）。

更改和提交更改（changes）

1：点击README.md文件
2：点击右上角的铅笔图标来进行更改
3：在编辑器中，写一下和你相关的内容
4：写一个提交信息（commit message）来描述你的更改
5：点击Commit changes 按钮

这些更改将只针对readme-edit分支上的README.md文件，所以现在这个分支包含了与master不同的内容。

第四步：打开一个Pull请求

改得不错!现在你更改了master的一个分支，你现在可以打开一个pull请求了。

Pull请求是GitHub协作（collaboration）功能的核心。当你打开一个pull请求，你就提出了你的更改（changes），并且要求其他人回顾（review）你的贡献并且在其中做出pull操作，然后合并到自己的分支（branch）里。Pull请求显示出两个分支的不同的内容。在这些更改中绿色代表添加（additions）红色代表减少（subtractions）。

在你做出一个提交（commits），你就可以打开一个pull请求，并且开始讨论（discussion），甚至是在代码写完之前就可以进行。

在你的pull 请求中使用GitHub的@mention系统，你可以要求指定的人或者团队进行反馈（feedback），无论他们在你身边还是在千里之外。

你甚至可以在你自己的库（repository）打开一个pull请求，并且自己把他们合并。这是一个在进行更大项目之前练习GitHub流的非常好的方法。

为README文件的更改（changes）打开一个pull请求。

在比较大的版本上点击这个图标。

步骤	截图
点击Pull Request选项卡，然后再Pull Request 页面，点击绿色的New pull request 按钮
选择你创建的分支——readme-edits，和原本的master比较检查在比较（compare）页面的更改（changes）确保这些更改（changes）都是你想要提交的。
当你对这些更改都满意的时候，单击绿色的Create Pull Request按钮
给你的pull请求写一个标题（title）并且对你的更改（changes）写一个简短的描述（brief description）
当你完成你的信息，点击Create pull request！

提示：你可以在pull请求和评论中使用emoji表情和图片。

第五步：合并你的pull请求

这是最后一步，是时候让你的更改(changes)都到一起了，（让你的readme-edits分:支并入master分支）

1：点击绿色的Merge pull request 按钮将更改（changes）并入master分支
2：点击Confirm merge
3：现在点击紫色框中的Delete branch按钮删除这个分支，因为它的更改（changes）已经并入了master分支。

祝贺你：

完成这个教程之后，你已经学会了如何在GitHub上个创建一个工程（project）并且做出一个pull请求。

你在这个教程里完成了：

1：创建一个开源的库（repository）
2：创建和管理一个新的分支（branch）
3：更改一个文件并且向GitHub提交这些修改
5：打开和合并一个pull请求

看一看你的GitHub主页，你会看到你的新的贡献团队
学习更多的关于pull 请求的功能，我们推荐阅读GitHub Flow Guide，当然你也可以浏览GitHub explore 加入更多的开源项目。

提示：留意我们的其他的教程，YouTube频道和On-Demand Training来学习如何使用GitHub.

最后更新日期：20160407