引言:引言部分为译者注,这是一篇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基于它而建立)。
提示:在单独的浏览器窗口(或选项卡)上打开这个指南,这样当你完成本教程的步骤后,你可以看见它。
库通常用来组织单个项目。库可以包含文件夹和文件、图像、视频、电子表格以及数据集——你的项目所需要的任何东西。我们建议包括一个自述文件,或者一个带有关于你的项目信息的文件。GitHub让增加一个库的同时创建新的库变得简单。它还提供其他常见选项,如许可证文件。
你的hello-world库可以是一个你存储想法、资源甚至与他人分享和讨论事情的地方。
1.在右上角,紧邻你的头像或同一行,点击然后选择新的库。
2.命名你的库为hello-word。
3.写一个简单的描述。
4.选择使用自述文件初始化这个库。
点击创建库
分支是同时在一个存储库的不同版本中工作的方式。
默认情况下你的库有一个分支命名为master(主分支),它被认为是最终分支。我们在提交它们到主分支前使用分支来进行实验和编辑。
当你从主分支上创建一个分支时,你正在制作一份主分支在那个时间点的拷贝或者快照一样。如果有人在你的分支工作时对主分支做了更改,你可以拉进这些更新。
这个图表显示:
主分支一个命名为特征的新分支(因为我们在这个分支上做‘特征工作’)。
特征分支在被融入到主分支之前的过程。
你是否曾保存过不同版本的文件?就像是:
故事.txt
故事-乔-编辑.txt
故事-乔-编辑-已审查.txt
分支在GitHub库中实现了类似的目标。
在GitHub,我们的开发人员、编写人员以及设计人员使用多个分支来保持bug修复和特征工作与主(产品)分支分离。当一个改变已经就绪,他们合并他们的分支进入主分支。
1、转到您的新库hello-wold。
2、单击位于列表顶部名为“branch:master”的下拉菜单。
3、键入一个分支名称,自述文件编辑到新的分支文本框中。
4、选择蓝色的创建分支框(Create branch box)或点击键盘上的“Enter”键。
现在您有两个分支,主分支以及自述编辑。它们看起来完全一样,但不是很长。接下来我们将向新分支添加改变。
好极了!您现在看到的是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-edits与主分支(原始文档)进行比较。
查看比较页面上的差异,确保他们是你想要提交的
当你满意你想要提交的更改时,单击大绿色创建合并请求(Create Pull Request)按钮。
给你的请求一个标题,并写一个你所做更改的简短的描述。
当你完成了这些信息,单击创建合并请求(Create pull request)。
提示:你可以使用表情包和拖放图片和gif图像到说明和合并请求上。
在最后的步骤中,是时候将你的改变结合在一起了——融合你的readme-edits分支进入主分支。
1.单击绿色的融合合并请求(Merge pull request)按钮来融合改变的内容进入主干。
2.单击确认融合(Confirm merge)。
3.继续执行并且删除分支,因为它的更改已经被合并,在紫色框中使用删除分支(Delete branch)按钮。
庆祝一下!
通过完成本教程,你已经学会了在GitHub上创建一个项目并且使用合并请求。
以下是你在这篇教程中所完成的:
创建一个开源库
启动并管理一个新分支
更改一个文件并将这些更改提交到GitHub
发起并融合一个合并请求
看一看你的GitHub文件夹,你将会看到你的新贡献广场!
学习更多关于合并请求的功能,我们建议阅读《GitHub流程指南》。你还可以访问《GitHub探索》并参与一项开源项目。
提示:查看我们的其它指南,YouTube频道和点播培训来了解更多如何开始GitHub。