GitHub 指导手册之第一个项目 Hello World

翻译的第一篇文章，翻译得不好，欢迎大家提修改意见。（另外还没翻完，后面修改后继续翻...）

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

在计算机程序设计领域，Hello World算是老字号示例了。每当学一个新东西的时候，我们都可以通过Hello World来获得简单的练习。下面我们开始学习GitHub的Hello World吧！

GitHub是一个项目托管和协作的平台。你不用担心硬盘上的数据丢失，也不用费时间在不同计算机上同步以管理项目。最重要的是，GitHub能让软件工程在合作、异步工作流中完成得更好。

这个教程引导您熟悉GitHub的以下要点：Repositories代码仓库，Branches分支，Commits提交，Issues问题，以及Pull Requests。（注：Issue一直不知道翻译为什么好，就是能明白那个意思，但翻不过来。可能这里翻为“话题”更好些。）

熟悉这些操作，你就可以玩转GitHub了。通过这个hello-world示例代码仓库，你可以熟悉这个过程，而且也可以在这里记录你的很好的想法（也可以说是未来代码仓库，比如 jlord/hello-world），存储资源文件，或是记录一些笔记，甚至是在这里和别人进行讨论（比如holman/feedback）。

安装和代码自由区

在下面的教程中我们都是用GitHub.com来完成，所以你不需要知道命令行，甚至不需要安装Git（这是GitHub用以记录项目变化的软件）。你甚至都不需要知道怎么编程。但是，你需要一个GitHub账号；所以，如果你还没有一个账号，赶紧注册一个吧！

Tip：将这个指导页面在一个单独的浏览器窗口打开，这样当你执行下面步骤的时候可以很方便地看这个教程。

创建一个代码库

代码库是GitHub最基本的单元，通常意味着是一个单独的项目。代码库可以保护文件夹、文件，包括图片——任何你的项目需要的东西。我们推荐每个代码库都包含一个类似于README的描述项目的文件。当你创建一个新的代码库时，可以很方便地选择由GitHub自动创建一个这样的README文件。你也可以选择自动创建其他的文件如许可证等，这里我们暂时不考虑这些。

创建一个新的代码库具体步骤

1.      点击右上角、你的用户名旁边的 + 按钮；

2.      命名代码库为hello-world；

3.      写一个简短的项目描述；

4.      选择自动创建README（Initialize this repository with a README）；

点击创建代码库（Create repository）。哇唔，代码库创建好了！

新建一个通知Issue

Issue是关于该代码库需要注意的一些东西。它可以是一个bug，功能需求，一个问题或其他的一些东西。GitHub上，你可以通过打标签、搜索、分派issue很方便地管理一个active的项目。

现在你已经有了一个代码库，但是它暂时几乎还是空的。可以在README中提供多一些信息以便别人知道这个项目是干啥的。来，新建一个issue吧！

给README新建一个issue

1.      从工具栏中点击这个Issues标签；

2.      点击新建Issue（New Issue）；

3.      填写Issue的标题和描述

完成后点击提交新Issue（Submit new Issue）。这样这个issue就有了一个永久的URL，在你关闭后还可以使用这个URL。

后面就是你去编辑README这个文件以及关闭这个issue。

创建新分支

分支是用来同时在一个代码库的不同部分进行工作。当你创建一个代码库后，默认地它会有一个名为master的分支（主分支）。你可以就在这个分支上继续编写，也可以一直都只有这一个分支，这些都是可以的。但如果你有一个新功能或新想法想试一试，你可以基于master分支创建另一个新的分支，这样master分支可以保持当前的版本而不改变。

你创建一个分支时，其实你是对原分支的当前状态（就像快照）进行了一个复制。当你在新分支上进行修改时，如果原分支有了变化或修改，不用担心，你总是可以引入这些更新。

在你之前的工作中，你也许保存过一个文件的不同版本，如”story.txt”、”story-joe-edit.txt”、”story-sue-edit.txt”。GitHub上的分支功能很方便地完成了这样的效果。

GitHub上，开发者、编码者以及设计者都新分支来调bug，以及在保留主分支（可能是一个产品）版本的情况下，增加一个新功能。当新功能完成后或bug调好了，将新分支合并到主分支中。

创建一个新分支的步骤

1.      首先到hello-world代码库页面；

2.      然后在文件列表最上面点击branch：master打开下拉框；

3.      输入一个分支名，如readme-edits；

4.      选择蓝色的“Createbranch”选项框，或直接回车。

选择你有两个分支了，一个是master，一个是readme-edits。它们看起来是一样的，但只是暂时！以后我们在新分支里加入一些东西。

提交

GitHub中用以保存的操作叫做提交。提交是非常棒的一个操作，因为所有的提交版本在一起就是你的项目不断改进的记录。

 

每个提交都有一个相应的提交信息，一般用来描述为什么要进行一次修改。通过这些提交消息，你以及其他人可以很快明白你都做了哪些修改以及这样做的原因。

 

你应该仍在readme-edits分支的页面，现在进行一些修改吧！

提交修改的步骤

1.      点击README文件；

2.      点击文件栏右上角的铅笔样式按钮，对文件进行编辑；

3.      在编辑区写一些关于你自己的东西；

4.      再写一些描述你做的修改的信息。

点击提供更改（Commit changes）。现在这些更改已经更新到readme-edits分支的README文件了，而且这个分支和master分支包含的文件和提交已经是不一样的了。

合并

合并是GitHub协同工作的核心。