github入门训练营[2]-创建一个仓库

想把项目放到github上,你必须创建一个仓库。

在Github的仓库里你可以存储很多项目,包括开源项目。 通过项目开源,你可以分享你的代码让他变得更强壮更好。

提示:你可以为你的开源项目创建公共仓库。当创建公共仓库时,请确保包含一个license文件来规定你分享代码的许可情况。
更多的开源相关信息,比如如何创建和运营你的开源项目,Github已经创建了开源指南来告诉你运作开源社区、维护开源项目的最佳实践。

创建仓库步骤

  1. 在页面右上角,点击加号,创建一个新仓库 new repository
  2. 输入一个简单的容易记忆的名字
  3. 可选的,你可以写一个项目描述,比如“我在Github的第一个项目”
  4. 选择创建一个公共还是私有的仓库。

    public: 公共的,这种仓库适合刚入门学习,他会向所有github用户公开访问,所以你可以从社区合作中受益。
    private: 这种仓库需要额外的一点设置。它只能由仓库所有者访问,或者你选择的合作者。私有仓库只能给付费用户使用,更多信息请参考Github;s billing plans

  5. 选择用README文件初始化这个仓库
  6. 选择 Create Repository

恭喜,你已经创建了你的第一个仓库,并初始化了README文件。

提交你的更改

一个提交commit就像一个你项目里所有文件的某一时刻的快照。当你创建新仓库时,你应该用一个README.md文件来初始化你的仓库。README文件非常适合用来描述你的项目,或者写一些安装和说明文档。README文件里的内容会被Github给你自动显示在你仓库的首页。

现在让我们来做个训练: 修改并提交README文件。

  1. 在Github上你仓库里,点击README.md文件。
  2. 点击上方修改按钮(一个小铅笔图标)
  3. 在编辑界面上,在edit选项卡里面写一点东西。
  4. 点击preview page选项卡预览一下。
  5. 检查下你做的更改。
  6. 在页面底部,填写点简单而有意义的提交信息,描述下你对文件做了更改。
  7. 在commit message提交信息的下方,选择下你是提交到当前分支还是新的分支。如果当前分支是master,你应该选择创建一个新分支并提交,然后接下来去创建pull request拉取要求
  8. 点击 propose file change按钮提交本次更改。

恭喜

恭喜,你已经创建了一个仓库,包括README.md文件,并且你创建了你的第一次提交。

克隆远程仓库

1
git clone jQuery https://github.com/jquery/jquery.git

这样克隆下来的仓库,会默认创建一个叫做 origin 的远程主机名,并指向 https://github.com/jquery/jquery.git
如果你希望自定义这个远程主机名, 可以这样:

1
git clone -o jQuery https://github.com/jquery/jquery.git

使用 git remote -v 可以查看当前的远程仓库主机名称列表。

克隆的同时,git默认会把远程的所有分支都克隆到本地仓库。但是会作为独立的分支而存在(跟本地工作工作的分支不是同一个)。使用 git branch -a 可以查看到远程拉取过来的分支,都会以刚才的 origin 为前缀作为分支名称:

1
2
3
4
* master
remotes/origin/HEAD -> origin/master
remotes/origin/gh-pages
remotes/origin/master

这个意味着从远程克隆了2个分支下来: origin/gh-pagesorigin/master, 当前远程分支的HEAD处在 origin/master 这个远程分支(注意: 虽然叫远程分支,但他确实是存储在本地仓库的一个分支,只是其表达了远程分支的意思)。

没有 origin 做前缀的分支,就是本地工作分支,就是你写代码的分支咯。 前面有个 * 号表示你工作区当前处在master分支。

从某远程分支检出一个工作分支

1
git checkout -b newBrach origin/master

参考

https://help.github.com/articles/create-a-repo/