你好,世界——gitHub初学者指南

 

引言:引言部分为译者注,这是一篇gitHub初学者使用指南,主要是帮助初次接触gitHub而没有足够英文阅读理解能力的新手更加方便学习如何使用gitHub功能。由于译者水平有限,译文的错漏缺点在所难免,敬请批评指正。而且随着gitHub功能与版本的迭代,译文可能因为没有及时更新而不再适用。读者可直接访问gitHub官方网站译文原页面:https://guides.github.com/activities/hello-world/

Hello World项目在计算机编程中是一个历史悠久的传统。这是一个简单的练习,让你开始学习新的事物。让我们开始GitHub的探索之旅吧。

你将学会如何:

  • 创建和使用存储库

  • 启动和管理新的分支

  • 对文件进行更改并且将它们作为提交资料上传到GitHub。

  • 打开合并请求。

GitHub是什么?

GitHub是一个用于版本控制和协作的代码托管平台。它让您和其他人在任何地方合作项目。

本教程教您GitHub基本知识,诸如存储库,分支,提交以及合并请求。您将创建自己的Hello World存储库,并学习GitHub的合并请求工作流程,一种广受欢迎的方式来创建和查看代码。

无需编码

要完成本教程,你需要一个GitHub.com的账户以及网络访问。你不需要知道如何去编码,使用命令行或者安装Git(版本控制软件GitHub基于它而建立)。

提示:在单独的浏览器窗口(或选项卡)上打开这个指南,这样当你完成本教程的步骤后,你可以看见它。

步骤1.创建一个库

库通常用来组织单个项目。库可以包含文件夹和文件、图像、视频、电子表格以及数据集——你的项目所需要的任何东西。我们建议包括一个自述文件,或者一个带有关于你的项目信息的文件。GitHub让增加一个库的同时创建新的库变得简单。它还提供其他常见选项,如许可证文件。

你的hello-world库可以是一个你存储想法、资源甚至与他人分享和讨论事情的地方。

创建新的库

1.在右上角,紧邻你的头像或同一行,点击然后选择新的库。

2.命名你的库为hello-word。

3.写一个简单的描述。

4.选择使用自述文件初始化这个库。

点击创建库

步骤2.创建一个分支

分支是同时在一个存储库的不同版本中工作的方式。

默认情况下你的库有一个分支命名为master(主分支),它被认为是最终分支。我们在提交它们到主分支前使用分支来进行实验和编辑。

当你从主分支上创建一个分支时,你正在制作一份主分支在那个时间点的拷贝或者快照一样。如果有人在你的分支工作时对主分支做了更改,你可以拉进这些更新。

这个图表显示:

主分支一个命名为特征的新分支(因为我们在这个分支上做‘特征工作’)。

特征分支在被融入到主分支之前的过程。

你是否曾保存过不同版本的文件?就像是:

故事.txt

故事-乔-编辑.txt

故事-乔-编辑-已审查.txt

分支在GitHub库中实现了类似的目标。

在GitHub,我们的开发人员、编写人员以及设计人员使用多个分支来保持bug修复和特征工作与主(产品)分支分离。当一个改变已经就绪,他们合并他们的分支进入主分支。

创建一个新的分支

1、转到您的新库hello-wold。

2、单击位于列表顶部名为“branch:master”的下拉菜单。

3、键入一个分支名称,自述文件编辑到新的分支文本框中。

4、选择蓝色的创建分支框(Create branch box)或点击键盘上的“Enter”键。

现在您有两个分支,主分支以及自述编辑。它们看起来完全一样,但不是很长。接下来我们将向新分支添加改变。

步骤3.制作与提交更改

好极了!您现在看到的是readme-edits分支里的代码,它是主分支的拷贝。让我们做一些编辑。

在GitHub,保存更改称为提交(commits)。每一个提交(commits)都有一个相关的提交消息(commits message),提交消息是一个解释为什么做出特征更改的描述内容。提交消息捕获你的更改历史,因此其他贡献者们能明白你已经做了哪些事情以及为什么这么做。

制作和提交更改

1、单击README.md文件。

2、单击文件视图右上角铅笔图标进行编辑。

3、在编辑器中,写一点关于你自己的事情。

4、写下描述你的更改的提交消息。

5、单击提交更改(commit changes)按钮。

这些更改将只对您的readme-edit分支的README文件进行,所以现在这个分支包含的内容是与主分支不同的。

步骤4、打开一个合并请求(Pull Request)。

(译者注:"Pull Request 是一种通知机制。你修改了他人的代码,将你的修改通知原来的作者,希望他合并你的修改,这就是 Pull Request。")

愉快的编辑!现在你已经在主分支的一个分支做了更改,你能发起一个合并请求。

合并请求是GitHub合作的核心。当你发起一个合并请求,你正在提议你的更改并且请求有人审查、拉入您的贡献,合并它们进入他们的分支。合并请求展示了两个分支上内容的差异或者不同。更改、添加以及削减用绿色和红色展示。

一旦你做出提交,你可以发起一个合并请求并且开始讨论,甚至在代码完成之前。

通过在你的合并请求消息中使用GitHub的@提及系统,你可以想特定人或者团队请求反馈,无论他们是在大厅还是距离10时区。

你甚至可以在你自己的库中发起一个合并请求并且自己合并它们。在开始一个更大的项目前,学习GitHub流程非常重要。

对README的更改发起一个合并请求

步骤

单击合并请求标签,然后从合并请求页面单击绿色的新的合并请求按钮。

 在示例比较框中,选择你所做的分支,readme-edits与主分支(原始文档)进行比较。

查看比较页面上的差异,确保他们是你想要提交的

当你满意你想要提交的更改时,单击大绿色创建合并请求(Create Pull Request)按钮。

 给你的请求一个标题,并写一个你所做更改的简短的描述。

当你完成了这些信息,单击创建合并请求(Create pull request)。

提示:你可以使用表情包和拖放图片和gif图像到说明和合并请求上。

 步骤5.融入你的合并请求

在最后的步骤中,是时候将你的改变结合在一起了——融合你的readme-edits分支进入主分支。

1.单击绿色的融合合并请求(Merge pull request)按钮来融合改变的内容进入主干。

2.单击确认融合(Confirm merge)。

3.继续执行并且删除分支,因为它的更改已经被合并,在紫色框中使用删除分支(Delete branch)按钮。

 

庆祝一下!

通过完成本教程,你已经学会了在GitHub上创建一个项目并且使用合并请求。

以下是你在这篇教程中所完成的:

创建一个开源库

启动并管理一个新分支

更改一个文件并将这些更改提交到GitHub

发起并融合一个合并请求

看一看你的GitHub文件夹,你将会看到你的新贡献广场!

学习更多关于合并请求的功能,我们建议阅读《GitHub流程指南》。你还可以访问《GitHub探索》并参与一项开源项目。

提示:查看我们的其它指南,YouTube频道点播培训来了解更多如何开始GitHub。

猜你喜欢

转载自blog.csdn.net/weimob258616/article/details/82021084
今日推荐