Github入门2之新建一个库

二、新建一个库

1、在Github上建一个新的库

每次你通过git作一个提交，它都被存储到一个库里面。把你的项目放在Github上，你就需要有一个Github库去让它栖身。

Git把你项目的所有文件存储到一个库中。如果你在你的系统中可以看到隐藏文件，那你在运行git init命令的项目目录中将会看到一个名叫“.git”的子目录。这个地方，就是Git存储你所有的提交，以及一切提交所需的每样东西。除了你本地，你也可以有远程库(类似于Github库)。远程库与你本地库是一致的，不过存储在不同的服务器或者计算机以便于合作，备份

为你的库创建一个 readme

对于Github库来讲，一个readme不是一个必要的部分，不过，做一个是个好的主意。

README 是一个大地方去描述你的项目或者增加一些文档介绍比如如何去安装或使用你的项目。你可能想去包含联系信息。如果你的项目开始流行起来，人们会想到得到你的帮助。

如果你包含一个使用readme作为文件名的文件在你的库中，它就会自动地被展示在你的库的首页。是不是很酷呢？Github支持几种不同的readme格式。在这个教程中的这种，会形成一个基本的文本文件而其它格式，例如.markdown或者.textile可以被用作渲染像links或者headers 这些HTML内容。更多关于这类支持标志格式的信息，可以在https://github.com/github/markup上面查到。

步骤1：创建一个readme文件

在提示框里，输入以下代码：

$mkdir ~/Hello-World

#在你的用户目录下，给你的项目新建一个叫Hello-World的目录。

$cd ~/Hello-World

#改变当前的工作目录到你的新建的目录下

$git init

#安装这些必需的Git文件

$touch README

#在你的Hello-World目录下，新建一个叫README的文件

使用文本编译器打开在你的Hello-World目录下的新建的README文档并加入“HelloWorld!”这句话。当你完成之后，保存并退出这个文件。

步骤2：提交你的README

现在你建好了你的README，是时候去提交它了。一次提交本质上是你的项目的所有文件在一个特定的时候点的一个快照。在提示框中，输入以下代码

思考一下，提交作为你的项目的快照——代码，文件，所有东西——在一个特定的时间点。在你第一次提交后，git将会只保存这些有改动的文件，以便节省空间。

警告：git将尽力去压缩你的文件，不过大文件以及二进制文件将使一个库变得膨胀且笨重。尝试去避免提交如压缩文件（zips,rars,jars），已经编译的代码（对象文件，类库，可执行文件），数据库备份还有多媒体文件（flv,psd,music,movies）这些文件。

$git add README

#展示你的Readme文件，加入它到被提交的文件列表当中去

$git commit -m 'first commit'

#提交你的文件，增加这个信息“first commit”

步骤3：推送你的提交

到目前为止，你所做的事情都在你的本地库完成，意味着，你仍然没有在Github上完成任何事。连接你的本地库到你的Github帐号，你将需要设置一个远程库，并将你的提交推送到上面去。

一个远程库是一个存储在位于Github的服务器的另一台计算机上的库。把指向你的主远程库（例如，你的Github库）命名为origin是标准实践（是某些情况下也是默认的）

Git支持多个远程库。当forking一个库的时候，这是一个普遍的用法。

$git remote add origin https://github.com/username/Hello-World.git

#新建一个远程库，名叫“origin” 指向你的Github库

$git push origin master

#发送你的提交在“master”分支到Github

现在，如果你看到你的库在Github，你将会看到你的README已经加到上面了。