github入门训练营[2]-创建一个仓库
想把项目放到github上,你必须创建一个仓库。
在Github的仓库里你可以存储很多项目,包括开源项目。 通过项目开源,你可以分享你的代码让他变得更强壮更好。
提示:你可以为你的开源项目创建公共仓库。当创建公共仓库时,请确保包含一个license文件来规定你分享代码的许可情况。
更多的开源相关信息,比如如何创建和运营你的开源项目,Github已经创建了开源指南来告诉你运作开源社区、维护开源项目的最佳实践。
创建仓库步骤
- 在页面右上角,点击加号,创建一个新仓库 new repository
- 输入一个简单的容易记忆的名字
- 可选的,你可以写一个项目描述,比如“我在Github的第一个项目”
- 选择创建一个公共还是私有的仓库。
public: 公共的,这种仓库适合刚入门学习,他会向所有github用户公开访问,所以你可以从社区合作中受益。
private: 这种仓库需要额外的一点设置。它只能由仓库所有者访问,或者你选择的合作者。私有仓库只能给付费用户使用,更多信息请参考Github;s billing plans - 选择用README文件初始化这个仓库
- 选择 Create Repository
恭喜,你已经创建了你的第一个仓库,并初始化了README文件。
提交你的更改
一个提交commit就像一个你项目里所有文件的某一时刻的快照。当你创建新仓库时,你应该用一个README.md文件来初始化你的仓库。README文件非常适合用来描述你的项目,或者写一些安装和说明文档。README文件里的内容会被Github给你自动显示在你仓库的首页。
现在让我们来做个训练: 修改并提交README文件。
- 在Github上你仓库里,点击README.md文件。
- 点击上方修改按钮(一个小铅笔图标)
- 在编辑界面上,在edit选项卡里面写一点东西。
- 点击preview page选项卡预览一下。
- 检查下你做的更改。
- 在页面底部,填写点简单而有意义的提交信息,描述下你对文件做了更改。
- 在commit message提交信息的下方,选择下你是提交到当前分支还是新的分支。如果当前分支是master,你应该选择创建一个新分支并提交,然后接下来去创建pull request拉取要求。
- 点击 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 | * master |
这个意味着从远程克隆了2个分支下来: origin/gh-pages
和 origin/master
, 当前远程分支的HEAD处在 origin/master
这个远程分支(注意: 虽然叫远程分支,但他确实是存储在本地仓库的一个分支,只是其表达了远程分支的意思)。
没有 origin
做前缀的分支,就是本地工作分支,就是你写代码的分支咯。 前面有个 *
号表示你工作区当前处在master分支。
从某远程分支检出一个工作分支
1 | git checkout -b newBrach origin/master |