- 什么是GitHub
- 步骤一创建仓库
- 步骤二打开Issue
- 步骤三创建分支
- 步骤四提交
- 步骤五上推请求
原文请点击这里,这是本人拙劣的译文。
什么是GitHub
当我们开始学习一门新编程语言时,打出HelloWorld
是一个传统性的纪念时刻。我们同样也来练习GitHub中的HelloWorld吧。
GitHub是一个项目托管和协作的平台。你无需再担心硬件或者管理多台电脑带来的数据丢失问题–你可以无论何地地同步你的项目。最重要的是,GitHub是一个能一起让软件变得更好的协作的、异步的工作流。
这份指南通过GitHub中最本质东西–respority(库)、branch(分支)、commit(提交)、Issue(问题?)以及 pull request(合并请求)来指导你学习github。
有了这些知识,你能走得更远。并有一个HelloWorld
仓库来存储你的想法(也就是未来的库,像这样 weiZhang/hello-world)、源码或者其它像笔记一类的东西,甚至在上面和其它人一起讨论(类似 holman/feedback)。
安装 & 免费的代码空间
我们将要通过GitHub.com完成任务通过这份指导,所以你不需要了解任何的命令行或者安装Git(GitHub软件由此建立而来)。你也不需要指导怎么样编码。你仅仅只需要了解如何使用GitHub客户端,所以,赶快注册一个GitHub账号吧!
tip:用单独的窗口打开这份指导,这样你就可以跟着这份指南一步一步完成了。
步骤一:创建仓库
仓库是GitHub中最基础的单元,最普通的一个对象。每一个仓库都可以包含文件夹和文件,包括图片–其它任何你的项目中需要的东西。也因为在每一个项目中,我们建议通过一份README或者文档来介绍这个项目,使得同时你创建的新项目变得更加容易(理解?)。当然,GitHub也提供类似许可声明的常见选项,但我们现在先暂时跳过这步。
创建一个新的仓库
1,点击右上角紧挨着你用户名的+
按钮。
2,为你的仓库命名为hello-world
。
3,写一个简短的介绍。
4,选择伴随一份README初始化仓库。
点击创建仓库
,嘣!仓库建好了。
步骤二:打开Issue
一个Issue是一个仓库需要增加一些东西的记录。它可以是一个BUG,一个新特性,一个问题或者其它的许多东西。在GitHub上你可以标记、搜索和分配Issue,使得管理一个活跃的项目更加容易。
现在你已经拥有一个仓库了,但是它还十分贫瘠。可以通过填充一份README或者更多信息在里面使得人们了解正在进行什么。去打开Issue吧,少年!
为编辑README打开Issue
1,从工具栏点击!Issue
tab(连起来的按钮)
2,点击新的Issue
3,给你的Issue一个标题和详细。。
点击提交新的Issue
当你做完上面这些时。现在这个Issue已经有了一个永久的链接(URL),之后你关掉这个Issue式也可以通过URL来引用到它。
下一步,向着编辑README和关闭Issue,前进!
步骤三:创建分支
分支是一种,仓库在一个时间里需要修改不同部分的方法。
当你创建一个仓库时,默认生成一个名为master
的分支。你可以持续在这一个分支上工作。但是,当你有一个新特性和主意,你可以从master
分支上起一个新的分支,这样你就可以离开master
继续工作了。
当你创建一个分支时,此时你正在复制一份某个时间点上(如照片快照)的原生分支。当你在新分支上工作时假如原生分支发生了改变,不用担心,你可以时刻上推这些更新。
在你生命中的某些时刻,你可能会保存一些不同版本的文件,类似‘故事.txt’、‘joe编辑的故事.txt’、‘sue编辑的故事.txt’。分支可以完成这些目标,但是管理起来却更方便在仓库里。
在GitHub里,我们的开发者,作者,和设计人员使用分支来持续bug修改和功能分离从我们的master(产品)分支。当一个功能准备好或者是bug被修复,分支都可被合并到master。
创建一个新分支
1,进入‘hello-world’仓库
2,点击在文件顶部写着‘branch:master’的下拉库
3,编辑分支名字–readme-edits进入新分支文本框
4,选择蓝色的Create branch框或者在你的键盘上点击Enter
现在,你有两个看起来一样的分支了,master 和 readme-edits。但这并不会太久,下一步我们会添加改变进入我们的新分支。
步骤四:提交
在GitHub中,保存改变叫做提交。提交是极好的。因为一连串的提交读起来就像你项目的历史一样。
每一个提交都附带了一个提交信息,这段描述解释了为什么会有特变的改变。感谢这些提交,你和其他人才可以通过阅读这些提交去理解你已经做了什么,为什么会这么做。
你现在应该继续在readme-edits分支上编码,现在做出一些改动吧。
提交改变
1,点击README文件
2,点击文件视图右上角的铅笔图标来编辑你的文件
3,在编辑栏里,写一些内容
4,写提交信息解释你为什么要做这些改动
点击 Commit chages.现在这些改变已经进入了你的readme-edits分支上的README文件,现在分支比起master包含了不同的内容和提交。
步骤五:上推请求
上推请求是GitHub协作功能呢的核心内容。当你提出上推请求时,代表你正建议你的这些改变,请求某人拉你的贡献-又叫做合并你的改变进入他们的分支。GitHub的上推请求特征允许你比较两个分支上的内容区别。包括改变,增添以及删除都会以绿色和红色显示出来。这些改变叫做diffs
未完。。。