Hello World · GitHub指南

Hello World 项目是计算机程序编程中流传已久的传统。 这是一个简单的练习,让你开始学习新的东西。 让我们开始使用GitHub!

你将学会如何:

  • 新建并使用一个仓库
  • 新建并管理一个新的分支
  • 更改文件,并将其作为提交推送到GitHub
  • 新建以及合并一个pull请求

GitHub是什么?

GitHub是用于版本控制和协作的代码托管平台。它让你和其他人可以在任何地方一起工作。

本教程教你使用GitHub的一些基础要素,如repositoriesbranchescommitsPull Requests。 你将创建自己的Hello World仓库,并学习GitHub的Pull Request工作流程,这是一种流行的创建和查看代码的方式。

无需编码

要完成本教程,你需要一个GitHub账户和Internet访问。你不需要知道如何编写代码,使用命令行或安装Git(GitHub所基于的版本控制软件)。

提示: 请在另一个浏览器窗口或页面打开这个教程,那么你可以看见。在单独的浏览器窗口(或页面)中打开本教程,以便在完成相应步骤时可以看到它。

Step 1. 创建一个仓库

一个仓库通常用于组织单个项目。仓库可以包含文件夹和文件,图像,视频,电子表格和数据集,即项目需要的任何内容。 我们建议您添加一个README或包含您项目信息的文件。Github让你很轻松地能在创建新的仓库的同时添加一个项目说明文件。 _它还提供其他常见选项,如许可证文件。

你的hello-world仓库可以是你存储想法,资源以及与他人分享和讨论的地方。

如何创建一个新的仓库

  1. 在页面右上角,你的头像或提示符旁边,单击加号,然后选择**新的存储库。
  2. 将你的仓库命名为hello-world
  3. 写一段简短的描述。
  4. 选择Initialize this repository with a README(使用README文件初始化这个仓库)。

点击 Create repository(创建仓库).

Step 2. 创建分支

分支是同时在不同版本的存库上工作的方式。

默认情况下,你的仓库有一个名为master的分支,它被认为是最终分支。 我们使用多个其他分支进行试验和编辑,然后将它们提交给master分支。

当您从master分支创建分支时,你就是在创建master的副本或快照,因为它是基于该时间节点的。 如果有人在你在分支上工作时对master分支进行了更改,那么你可以更新更改内容。

本图显示:

  • master 分支
  • 一个名为feature的新分支(因为我们在这个分支上做feature相关的工作)
  • feature分支在合并到master前需要经历的流程

你有没有保存过不同版本的文件?就像这样:

  • story.txt
  • story-joe-edit.txt
  • story-joe-edit-reviewed.txt

分支在GitHub仓库中完成了类似的目标。

在GitHub中,我们的开发人员,作家和设计师使用分支来保持bug修复,并将功能与我们的master(生产)分支分离开来。 当一个变更完成,他们才将其的分支合并到master

如何创建新分支

1.进入新仓库hello-world

2.点击文件列表顶部的下拉列表,它显示 branch:master 。

3.在新的分支文本框中输入一个分支名称readme-edits

4.选择蓝色的创建分支框,或者在键盘上点击Enter

现在你有两个分支,masterreadme-edits。 它们看起来完全一样,但不会一直一样!接下来,我们将添加对新分支的更改。

Step 3. 创建和提交变更

好样的! 现在,你正在查看readme-edits分支的代码内容,它是master分支的副本。 让我们进行一些编辑吧。

在GitHub上,保存的更改称为commits(提交)。 每个提交都有一个关联的commit message(提交信息),这是一个描述为什么进行特定更改的描述。 提交信息记录了你变更的历史,因此其他贡献者可以了解你做了什么以及为什么做。

如何创建和提交变更

  1. 点击README.md文件。
  2. 单击文件视图右上角的铅笔图标进行编辑。
  3. 在编辑时,写点儿关于你自己的东西。
  4. 写一个描述你的更改的提交信息。
  5. 单击提交变更按钮。

这些更改将仅对你的readme-edits分支上的README文件生效,因此现在该分支包含与master不同的内容。

Step 4. 发起一个pull请求

编辑得很好! 现在您已经在readme-edits中创建了不同于master的更改,可以发起一个pull 请求

pull请求是GitHub协作的核心。 当你发起一个pull 请求时,你在提议你的修改,并请求其他人检查并合并你的贡献,并将变更并入他们的分支。 pull请求显示两个分支的内容的差异(diff或differences)。 更改内容包括新增和删除内容显示为绿色和红色。

一旦你发起提交,你可以发起一个pull请求并开始一场讨论,这些甚至能在代码完成之前开始。

通过在pull请求消息中使用GitHub的@mention系统 ,你可以要求来自特定人员或团队的反馈,无论他们是近在大厅还是远在10个时区之外。

您甚至可以在自己的存储库中打开提取请求,并自行合并。 在开展大型项目之前,了解GitHub Flow是一个很好的方式。

发起一个更改README的pull请求

点击图片可观看大图

步骤截图

单击Pull Requesttab,然后在pull请求页面中,单击绿色的New pull request(新的pull请求)按钮。

选择你创建的分支readme-edits,和master(源)分支进行比较。

查看比较页面上的更改差异,确保它们是您要提交的。

当你确定这些是你想要提交的更改时,请点击绿色的Create Pull Request大按钮。

给你的pull request写一个标题,并为你的更改写一个简短的描述。

当你填写完信息后,点击Create pull request!


提示: 你可以在评论和pull请求中使用 emoji 以及 拖放图像和gifs 。

Step 5. 合并pull请求

在这最后的一步,是时候把你的更改合并啦——将readme-edits分支合并到master分支。

  1. 点击绿色Merge pull request按钮将更改合并到master分支中。
  2. 点击Confirm merge。
  3. 然后删除分支,因为它的更改已被合并,点击紫色框中的删除分支按钮。

祝贺!

通过实践这个教程,你已经学会了如何在Github上创建一个仓库并发起一个pull请求!

下面是对你在本教程中所完成内容的总结:

  • 创建一个开源代码库
  • 启动并管理新的分支机构
  • 更改了一个文件,并将这些变更提交给GitHub
  • 发起并合并pull请求

看查你的GitHub配置文件,你会看到你的新的贡献方块!

要了解有关Pull请求功能的更多信息,我们建议您阅读GitHub流程指南。 您也可以访问GitHub Explore并参与开源项目

原文发布于微信公众号 - 京程一灯(jingchengyideng)

原文发表时间:2017-08-25

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

扫码关注云+社区

领取腾讯云代金券