Hello World · GitHub 指南

Posted CG国斌

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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 的内容。


原文链接:Hello World · GitHub Guides


———— ☆☆☆ —— 返回 -> 史上最简单的 GitHub 教程 <- 目录 —— ☆☆☆ ————

以上是关于Hello World · GitHub 指南的主要内容,如果未能解决你的问题,请参考以下文章

Hello World · GitHub 指南

RabbitMQ指南之一:"Hello World!"

github--hello,world(参考官网)

[个人翻译]GitHub指导文件(GitHub Guides[Hello World])

GitHub : Hello World

[个人翻译]GitHub指导文件(GitHub Guides[Hello World])