GitHub网页版指南

GitHub网页版指南
  • 什么是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,从工具栏点击!Issuetab(连起来的按钮)
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
未完。。。

推荐阅读