GitHub 网页版使用指导(hello world实例)

什么是GitHub?

GitHub是一个具有版本控制和协作的代码托管平台,它可以让你和任何地方的人一起开发一个项目。这个指导将会教你GitHub最基础的东西,像项目库、分支、提交和请求。你将创建自己的HelloWorld库并且学习GitHub的Pull request工作流程,对于创建和回顾代码来书这种方式很受欢迎。

不需要写代码

要完成这个教程,你只需要一个GitHub账户和网络就可以。不需要知道怎么编码、不用谢命令行或者安装Git(GitHub版本控制软件就是基于它的)。

第一步  创建库

一个库通常用来管理一个单一的项目工程。库可以包含文件夹、文件、图片、视频、电子表格和数据集——项目需要的任何东西。一般建议包含一个README文件,或者一个包含关于项目信息的文件。GitHub会在你创建库的时候提供添加这个文件,同时也提供其他的通用的选项例如协议文件。你的HelloWorld 库是一个可以存放想法、资源、甚至和其他人分享与讨论事情。

创建一个新的库

  1. 登陆自己的GitHub账户(注册账户),右上角头像旁边,点击“+”,选择“New repository”。
  2. 库名称填“hello_world”。
  3. 写一个库的介绍(非必需)。
  4. 勾选“Initialize this repository with a README"。

点击“create repository”。

第二步 创建分支

分支是一种可以同时在不同版本上工作的方法。

默认情况库里有一个名为master的分支,在讲其他分支提交到master分支之前,我们为您在这些分支上实验和编辑。当你创建了一个不同于master分支的分支的时候,相当于你将master分支复制了一份。当你在你的分支工作的时候,有人修改了这个项目,你可以将这些更改作为更新添加到你的master分支项目中。

下面的图展示了:

  • master主分支。
  • 一个新分支feature(因为我们正在做其他的工作,分支的名称可以随意)。
  • 这是feature分支在合并到master之前的过程。

你是否见过一个文件的不同版本尼?比如:

  • story.txt
  • story-joy.txt
  • story-joy-reviewed.txt

在GitHub库中,不同的分支完成的都是相似的目标。在GitHUb,开发者、作家和设计师使用来自master不同的分支完成修复bug和不同工作,修改完成后,吧他们的分支合并到master中。

创建一个新的分支

  1. 进入你新建的库hello_world。
  2. 点击branch标签按钮的下拉菜单中的master。
  3. 在文本框中输入新分支名字rename—edits。
  4. 点击蓝色的”createbranch“按钮或者按回车。

现在,你有两个分支,master和rename—edits,他们看起来几乎一样,但是不会太久!接下来在新分支中添加改动。

第三步 提交更改

现在你看到的是readme—edits分支的内容,这是复制master的。我们做一些修改。

在GitHub,保存改动叫做commits,每一个commit有一个关联的commit信息,这个信息用来解释为什么做这样的改动,捕获改动的历史记录,其他人可以明白你做了什么。

提交更改

  1. 点击”README.md“文件。
  2. 点击右上角的铅笔图标,编辑代码。
  3. 在编辑器里,写一点东西。
  4. 在”commit changes“里填写修改标题和描述。
  5. 点击”commit changes"按钮。


现在已经在readme—edits分支里做了改动,该分支的内容和master分支的内容已经不同。

第四步 打开一个Pull Request

改的好,现在你已经做了不同于master的改动,可以打开一个pull request了。

Pull Request是GitHub协作的核心,当你发起一次PullRequest时,你是在提出你的改动,是在请别人(也可以是你自己)检查你的工作并把这些改动合并到他的分支中。Pull request 显示了两个分支内容的差别和差异,修改、添加和删除都会用绿色和红色标注出来。一旦你提交一次,只要在编码完成之前你就可以打开一个pull request并且开始讨论。

通过在你的pull request中使用GitHub的通知系统(@mention system),你可以要求特定的人或团队回复信息,即使他们在大定或者十个时区那么远。

你也可以在你自己的仓库中开启pull request然后自己合并他们。这是一种在为大项目工作前学习GitHub Flow的好方法。

开启一个修改README文件的Pull Request

点击图片可放大查看。

步骤 操作截图
点击pull request标签,在pull request页面点击右下角的绿色按钮“New pull request"
Example Comparisons表格中选择你创建的分支readme—edits与master分支作比较
在比较页面查看修改的差异,确定是你想要提交的
当你对这些提交的修改满意时,点击绿色按钮 Create Pull Request
给你的pull request 一个标题并且写一点对修改的描述

编辑完之后,点击”create pullrequest “按钮。

第五步 合并你的Pull Request

在这最后一步,是时候将你修改的分支readme—edits合并到master中了。

  1. 点击”Merge pull request“按钮,吧修改合并到master中。    
  2. 点击”Comfirm merge“。                                                            
  3. 续并且修改已经合并成功,点击紫色框中的”Delete branch“,删除分支(或者不删除以便在该分支上继续做修改)。

恭喜!

通过完成这个教学,你已经学到在GitHub创建项目和做一个pull request

下面是你在这个教学中学到的:

  • 创建一个开源仓库
  • 启动并管理一个新分支
  • 修改文件并提交改变到GitHub
  • 开启和合并一个Pull Request
如果你想学更多的pull request的强大之处,我们建议阅读 GitHub Flow Guide (GitHub流指南)。你可能还需要访问 GitHub Explore 还有加入一个开源项目

猜你喜欢

转载自blog.csdn.net/qq_29856789/article/details/80590847