Hello World · GitHub 指南

简介

Hello World 项目是计算机编程历史中悠久的传统。在我们学习新知识的时候,她也是一个简单的练习。现在,就让我们一起了解 GitHub 吧!

你将学会,如何:

  • 创建和使用仓库;
  • 启用和管理一个新的分支;
  • 修改一个文件并将其提交到 GitHub;
  • 打开并合并一个 Pull 请求。

GitHub 是什么?

GitHub 是一个用于版本控制和协作的代码托管平台,她都能够让你和任何地方的其他工作者一起做项目。

本教程将告诉你 GitHub 的主要内容,包括仓库、分支、提交代码和 Pull 请求。在这里,你将会用一个流行的方式创建和检查代码、创建你自己的 Hello World 仓库和学习 GitHub 的 Pull 请求工作流。

不需要编程

为了完成这个教程,你需要一个 GitHub.com 账号并且联网,而不需要知道如何编程、使用命令行或者安装 Git(GitHub 就基于这个版本控制软件)。

提示:在单独的浏览器窗口(或选项卡)中打开此指南,这样你就可以边看边实践。

Step 1. 创建仓库

通常,一个仓库用于构建一个项目,仓库可以包含你项目所需要的任何东西,例如文件夹、文件、图片、视频、电子表格和数据集等。我们建议仓库中包含了一个README,或者一个描述你项目信息的文件。在你创建新仓库的时候,GitHub 可以很容易的将它添加进来。GitHub 也提供了其他常见的选项,例如许可证文件

你的Hello World库可以作为一个存储你的想法、资源,甚至与他人共享和讨论事情的地方。

创建新的仓库

  • 在右上角,你的头像旁边,点击+,然后选择New repository
  • 将你的仓库命名为Hello World
  • 写一个简短的描述;
  • 选择Initialize this repository with a README.

点击 Create repository.

Step 2. 创建分支

分支是某一时刻对同一个仓库(我感觉说是项目更加适合)在不同版本上进入工作的方法。在默认情况下,你的仓库有一个名为master的分支,它被公认为主分支。我们使用分支进行工作,然后再将其提交到master上。

当你从master中创建一个分支时,也可以说,你正在制作一个副本,或者快照,就像在那个时间点的master一样。当你在你的分支上工作的时候,如果其他人对你的master分支进行了修改,你可以Pull这些更新。

下图展示了:

  • master分支;
  • 一个名为feature的新分支(因为我们在这个分支上做“特别的工作”);
  • feature分支合并到master分支的过程。

你保存过不同版本的文件吗?像:

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

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

在 GitHub 上,我们开发人员、作家、设计师使用从master分支创建的其他分支修改 bug 以及完成特定的工作。当修改完成的时候,我们就可以将其合并到master分支啦!

创建新的分支

  • 进入你的hello-world仓库;
  • 单击顶部名为branch: master的文件列表;
  • 在新分支文本框中键入分支名称readme-edits
  • 选择蓝色的Create branch框或者敲键盘上的Enter键。

现在,你就有两个分支了,分别为masterreadme-edits,两者的内容看起来完全一起,但是很快就不一样啦!接下来,我们就在新分支中添加一些改变。

Step 3. 编辑和提交修改的内容

好极了!现在,你的代码视图中已经有readme-edits分支了,她是master分支的一个副本。下面,我们对她做一些编辑。

在 GitHub 上,保存修改被称之为commit,即提交。每次提交都有一个相关的提交消息,用来说明为什么进行特定的修改。提交消息保存了你修改的历史,因此其他贡献者能够通过“提交信息”了解你做了什么修改和为什么这么做。

编辑和提交修改内容

  • 点击readme.md文件;
  • 单击文件视图右上角的铅笔图标进行编辑;
  • 在编辑器中,写一点关于你自己的东西;
  • 写一个提交消息,描述你的修改;
  • 单击Commit changes按钮。

这些修改仅仅在你的readme-edits分支中的README中有所体现,因此这个分支就包含与master分支不同的内容啦!

Step 4. 提出 Pull 请求

编辑的很好!现在你已经有了一个与master内容不同的分支了,接下来,可以提出 Pull 请求啦!

Pull 请求是 GitHub 协同工作的核心。当你提出一个 Pull 请求的时候,你就已经默认允许其他人审查和合并你贡献的代码到他们的分支啦!Pull 请求展示了两个分支内容上的差异。这些修改,添加和删除的内容将分别用绿色和红色标记出来。

只要你提交过修改的内容,你就可以提出 Pull 请求,同时开启一个讨论,甚至在你的代码完成之前你就可以提出 Pull 请求。

在你 Pull 请求的“请求信息”中,通过使用 GitHub 的@mention system,你可以向特定的人或团队反馈问题,无论他们在你身边还是在 10 个时区之外。

你也可以在自己的仓库中提出 Pull 请求,并将其合并。在开发大型项目之前,这是学习 GitHub Flow 非常好的方法。

当你完成你的信息之后,点击Create pull request

Step 5. 合并你的 Pull 请求

在这最后一步中,是时候将你在readme-edits分支中的修改一起合并到master分支即主分支中啦!

  • 单击绿色Merge pull request按钮将修改的内容合并到master分支;
  • 单击Confirm merge按钮;
  • 删除该分支,因为它修改的内容已经合并了,在“紫色”框中点击Delete branch按钮。

庆祝吧!

通过完成本教程,你已经学会了在 GitHub 上创建项目并提出 Pull 请求啦!

以下是你在本教程中完成的内容,包括:

  • 创建一个开源库;
  • 开始并管理一个新的分支;
  • 修改文件并将这些修改的内容提交到 GitHub;
  • 提出及合并 Pull 请求。

在你的 GitHub 简介(Profile)上,你可以看到自己的贡献标记。

想要学习更多关于 Pull 请求的知识,我们推荐你阅读「GitHub Flow Guide」,你也可以通过访问 「GitHub Explore」了解更多的开源项目。

提示:可以通过「Guides」和「On-Demand Training」了解更多关于 GitHub 的内容。 最后,附上博主的 GitHub 账号,欢迎大家 Follow维C果糖

原文链接:Hello World · GitHub Guides

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

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏魏艾斯博客www.vpsss.net

wordpress 主题不显示、只显示一个主题的解决办法

1103
来自专栏微服务

Linux系统从安装开始

  已经很久很久没来得及写博客了,想想之前自己开始安装使用Linux系统的尝试,好像很简单!下面开始Linux系统的安装:这里推荐U盘安装   首先你必须下载一...

3687
来自专栏MoeLove

关于 webpack 你所忽略的细节(附源码分析)

随着前端技术的火热发展,工程化,模块化和组件化的思想已逐步成为主流,与之相应的,就需要有一整套工具流可以支撑起它。

973
来自专栏Python中文社区

使用scrapy,redis,mongodb实现的一个分布式网络爬虫

这个工程是对垂直搜索引擎中分布式网络爬虫的探索实现,它包含一个针对http://www.woaidu.org/ 网站的spider, 将其网站的...

4089
来自专栏Java进阶架构师

闪电侠:2018.3 IntelliJ IDEA 重大更新:支持CPU火焰图,新增酷炫主题

就在上周,JetBrain 公司发布了 Java 集成开发环境 IntelliJ IDEA 最新版本 2018.3Beta,本篇文章,我将根据官方博客以及自己的...

1151
来自专栏腾讯移动品质中心TMQ的专栏

如何轻松爬取网页数据?

在实际工作中,难免会遇到从网页爬取数据信息的需求,如:从微软官网上爬取最新发布的系统版本。很明显这是个网页爬虫的工作。本文将根据网站特性进行分类介绍几种使用py...

3.7K2
来自专栏云飞学编程

Python抓包获取网友上传的视频!世界那么大,只能在网上看了

作为一个小私企的(伪)程序员,你不止要负责软件,还得管硬件【大哭】,前几天给公司安装了一套监控,顺便浏览了下监控厂家的主页,发现一个很好玩的地方,正好在学习爬虫...

1444
来自专栏知晓程序

不小心给了小程序「授权」,怎么撤回?| 小程序问答 #49

最常见的,大概就是请求「获取你的昵称、头像」。除此之外,当小程序想要使用你的地理位置、麦克风等的时候,也需要你的授权才能获取。

1352
来自专栏编程

从w命令开始,系统状态命令哪个最强大?哪个你最熟悉?

最快的时间内,通过不同命令对Linux系统状态的把控,也是运维的基本功。今天一起来汇总一下,看看都有哪些。 1 使用w查看系统负载 相信所有的linux管理员最...

1998
来自专栏闪电gogogo的专栏

Git客户端使用教程

课程地址 《版本控制入门 – 搬进 Github》 笔记参考 《搬进 Github》 Git客户端的使用 Git for windows下载 新建一个仓库tat...

27912

扫码关注云+社区