GitHub 使用

git / GitHub / gitlab
简介
Git - 版本控制工具
Git是一个开源的分布式版本控制系统,用以有效、高速的处理从很小到非常大的项目版本管理。
Git 是 Linus Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。
</br>
Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper,后者之前一直是 Linux 内核开发人员在全球使用的主要源代码工具。
开放源码社区中的有些人觉得 BitKeeper 的许可证并不适合开放源码社区的工作,因此 Torvalds 决定着手研究许可证更为灵活的版本控制系统。
尽管最初 Git 的开发是为了辅助 Linux 内核开发的过程,但是我们已经发现在很多其他自由软件项目中也使用了 Git。例如 最近就迁移到 Git 上来了,很多 Freedesktop 的项目也迁移到了 Git 上。
</br>
Github - 一个网站,提供给用户空间创建git仓储,保存用户的一些数据文档或者代码等
作为开源代码库以及版本控制系统,Github目前拥有140多万开发者用户。
随着越来越多的应用程序转移到了云上,Github已经成为了管理软件开发以及发现已有代码的首选方法。
如前所述,作为一个分布式的版本控制系统,在Git中并不存在主库这样的概念,每一份复制出的库都可以独立使用,任何两个库之间的不一致之处都可以进行合并。
GitHub可以托管各种git库,并提供一个web界面,但与其它像 SourceForge或Google Code这样的服务不同,GitHub的独特卖点在于从另外一个项目进行分支的简易性。
为一个项目贡献代码非常简单:首先点击项目站点的“fork”的按钮,然后将代码检出并将修改加入到刚才分出的代码库中,最后通过内建的“pull request”机制向项目负责人申请代码合并。已经有人将GitHub称为代码玩家的MySpace。
</br>
GitLab - 基于Git的项目管理软件
GitLab 是一个用于仓库管理系统的开源项目。使用Git作为代码管理工具,并在此基础上搭建起来的web服务。

三者都是基于git的,可以说是git的衍生品。
什么是GitHub?

GitHub是一个版本控制和协作的代码管理平台。它可以让你和他人在任何地点一起进行项目工作。

步骤 1. 创建一个储存库
一个储存库通常被用来组织一个单独的项目。存储库可以包含文件夹和文件,图片,视频,电子表格,和数据集合——你的项目的任何东西。我们建议包含一个README(说明档案),或者包含关于你项目信息的文件。同时GitHub使得你创建你的新储存库变得容易。它也提供其它普通的选项例如一个授权文件。

去创建一个新的储存库

1.在右上角,临近你的名字,点击 + 号并且然后点击New Repository.
2.把你的仓库命名为hello world.
3.撰写一个简短的介绍。
4.挑选Intialize this repository with a README(用一个说明档案初始化这个存储库)----此处若不选中,则不初始化,创建完成后,页面上出现提示说明,有具体做法。

01.png

这里建的就是origin的远端仓库,下面说一下,把本地代码上传到origin:
方式一:

1.仓库克隆到本地:git clone +远端地址; (进到准备存储代码的目录中,再克隆)
2.创建ignore文件: touch .gitignore
3.提交.gitignore文件到远端
4.用sourcetree查看提交等日志
5.把代码放到本地仓库中,添加git add + 点;提交到本地:git commit (后面加-m “提交的日志”)
6.把本地代码推送到远端:git push origin master
7.如果:代码工程放到本地后,发现有问题,git发现不了这个工程,可能是:工程本身里面有个.git的跟踪,删除即可。

方式二:

1. 一般此时,本地已经创建了一个项目,而且xcode创建项目的时候自带了隐藏文件夹.git, 此时本地项目和gitHub上面并没有任何的联系。
2. 创建ignore文件,放入本地项目中。
3. cd命令进入到本地项目中,然后 git add . 。
4. 命令:git commit -m"提交项目工程"  ,这是提交到本地。
5. 命令:git remote add origin http://*****/iOS_group/***.git。
6. 命令: push -u origin master,或者push origin master。
(如果当前分支与多个主机存在追踪关系,那么这个时候-u选项会指定一个默认主机,这样后面就可以不加任何参数使用git push, push -u origin master是:本地的master分支推送到origin主机,同时指定origin为默认主机,后面就可以不加任何参数使用git push)
此时,github里面的project里面就有了项目代码。

其实,在gitlab中创建项目后,里面未初始情况下,会提示各种情况的操作:


111.png

操作过程中,可能出现错误:fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
解决:

出现这个问题是很可能是因为没有在github账号添加SSH key,或者是没有把专用密钥添加到 ssh-agent 的高速缓存中;
具体参考:我的另一篇文章 “iOS ssh keys 和 mac下使用github 上传代码”中的“ ssh -T git@github.com”检测过程的步骤,则可以解决。

步骤 2.创建一个分支
分支是在同一时间内能工作在一个储存库中的不同版本上的方法。
你的储存库中有一个名字为master的分支,此分支默认为决定性的分支。在提给master之前,我们使用分支来试验和编辑。

当你创建一个分支与master分支分开时,你正在进行拷贝或者说是复制master在那个时间点。当你正工作在你的分支时,别人对master分支进行改动,你可以提取这些更新。

在GitHub的储存库中,分支完成相似的任务。

在GitHub,我们的发明者,作者和设计师都在用分支来进行bug修复和重要的工作,这些分支从我们的master分支中分离出来。当一项改动准备好时,他们把分支合并到master中。

来创建一个新的分支

1.来到你的新的hello world储存库。
2.点击顶端文件(master)的下拉菜单
3.敲写分支的名字,readme-edits,进入新的分支文件盒子。
4.选择蓝色的Create branch盒子 或者在你的键盘上点击“Enter”。

现在你拥有了两条分支,master和readme-edits.它们看起来完全一样。

步骤3.作出改动并且提交
你的readme-edit分支(master的副本)。让我们来做些编辑工作吧。
在GitHub,保存改动被称为提交。每项提交都有一个相关联的信息。这个信息是一个说明,用来阐述为什么要进行特殊的改动。提交信息捕获你的改动历史,以便其他的合作者可以明白你改动的东西和目的。

作出改动并且提交

点击README.md文件。
在文件视野的右上角点击铅笔图标进行编辑。
在编辑器中,写一点关于你自己的东西。
点击Commit changes 按钮。

这些改动将仅仅会在你的readme-edits分支中的文件中出现,因此现在这个分支中的内容不同于master。

步骤 4.开启一个提取请求
现在你在master的分离的分支上作出改动了,你可以开启一个提取请求。

在HitHub中提取请求是合作的核心。当你开启一个提取请求,表明你正在提议你的更改并且请求某人审查并提取你的贡献内容,同时把你的贡献内容合并到他们的分支上。这些改动,添加和删除会被用绿色和红色显示。

一旦你做出提交,你就可以开启一个提取请求和开始一场讨论,甚至可以在代码完成之前。

通过使用在你的提取请求GitHub的[@mention system](http://help.github.com/articles/about-writing-and-formatting-on-github/#text-formatting-toolbar 通知栏,你可以要求某个具体的人或者团队的反馈,无论他们是在大厅还是相隔10个时区的地方。

你甚至可以在你的个人储存库开启提取请求,并且亲自把它们合并。在学习更大的项目之前,下面是一种很棒的学习GitHub的方法。

为了修改README文件而开启一个提取请求

当你完成你的信息表时,点击Create pull request!

步骤 5.合并你的提交请求
1.在最后一步,是时候把你的改动整合起来——把你的readme edits分支合并到master分支中。
2.点击Confirm merge。
3.继续, 因为改动已经被合并了,所以可以用在紫色框中的Delete branch按钮删除分支。

在GitHub 的页面上,先定义两个角色:原著A用户的工程a,和想要针对a做些操作的B用户。

02.png

例如,针对这个afnet, 想要做些操作,进到此处,点击里面的某个文件--”README“, 然后进行编辑--修改,这个过程是创建了一个fork(针对外来人员可编辑的一个分支)。

03.png

编辑过后,下面的显示,填写编写日志,点击后:


04.png

此处的base fork 是原著A的,head fork是B的已复制的一个可编写的分支,点击:create pull request,就是提出让A拉取B修改内容的请求,若A拉取合并则,A中的a项目就合并了B的修改。
注意:AFNetworking/AFNetworking 和 wgj0808/AFNetworking, AFNetworking/AFNetworking指的是原著,而 wgj0808/AFNetworking指的是fork的分支,是属于wgj0808的一份可编辑并可保存修改内容的一个复制品。不管怎样,想要A在a项目中看到Pull requests 的申请,B必须要在自己账号中提出pull的请求。

code: 代码,修改,编辑,切换分之;
Issues: 错误,在原著中的a里面可以编辑提交,让A看到。
Pull reaquests: 拉取请求,外来人员的一些修改代码,请求合并的申请。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,905评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,140评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,791评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,483评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,476评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,516评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,905评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,560评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,778评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,557评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,635评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,338评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,925评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,898评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,142评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,818评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,347评论 2 342

推荐阅读更多精彩内容