GitHub使用学习笔记

一、创建一个存储库

存储库通常用于组织单个项目。 存储库可以包含文件夹和文件,图像,视频,电子表格和数据集 - 您的项目需要的任何东西。 我们建议包括一个自述文件或包含关于您项目信息的文件。 GitHub可以在创建新存储库的同时轻松添加一个。 它还提供其他常见选项,如许可证文件。

你的hello-world知识库可以是你存储想法,资源甚至与他人分享和讨论事物的地方。

创建一个新的存储库

1、 在右上角,在你的头像或身份证旁边,点击+然后选择New respository;

2、命名你的存储库:hello-world;

3、写一个简短的描述;

4、选择 Initialize this respository with a README;

5、点击Create repository


二、创建一个分支(Branch)

分支是一次处理不同版本的存储库的方式。

默认情况下,你的仓库有一个名为master的分支,它被认为是最终分支。 我们使用分支在将它们提交给master之前进行实验和编辑。

当您从主分支创建分支时,您正在制作主分支的副本或快照,就像它在那个时间点一样。 如果其他人在您的分支上工作时对主分支进行了更改,则可以引入这些更新。

如图显示:
     a、主分支
     b、一个叫做feature的新分支(因为我们正在这个分支上做'特色工作')

     c、该功能在合并到主分支之前所经历的历程


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

story.txt

story-joe-edit.txt

story-joe-edit-reviewed.txt

分支机构在GitHub存储库中实现类似的目标。

在GitHub上,我们的开发人员,作者和设计人员使用分支来将错误修复和功能工作与我们的主(生产)分支分开。 当一个变化准备就绪后,他们将他们的分支合并为主分支。

创建一个新的分支:

1、转到您的新存储库hello-world。

2、 单击文件列表顶部的下拉列表中的分支:master。

3、在新的分支文本框中输入分支名称readme-edits。

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


现在你有两个分支,master and readme-edits。 它们看起来完全一样,但时间不长! 接下来,我们会将我们的更改添加到新分支。

三、进行并提交更改

现在,您正在使用readme-edits分支的代码视图,该分支是主副本。 我们来做一些编辑。

在GitHub上,保存的更改称为提交。 每个提交都有一个关联的提交消息,它是解释为什么进行特定更改的说明。 提交消息捕获您所做更改的历史记录,所以其他贡献者可以了解您所做的工作以及原因。

进行并提交更改:

1、点击README.md文件。

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

3、在编辑器中,写一些关于你自己的信息。

4、编写描述您的更改的提交消息。

5、单机commit changes 按钮。


这些更改将仅针对readme-edits分支上的README文件进行,因此,此分支包含的内容与主分支不同。

四、打开合并请求

现在您的分支已经发生变化,您可以打开一个拉取请求。

合并请求是GitHub协作的核心。 当你打开一个拉取请求时,你正在提出你的改变,并要求有人审查并提交你的贡献,并将它们合并到他们的分支中。 拉取请求显示来自两个分支的内容的差异或不同。 更改,添加和减法以绿色和红色显示。

一旦你提交了,你甚至可以在代码完成之前打开一个pull请求并开始讨论。

通过在您的拉取请求消息中使用GitHub的@mention系统,您可以要求特定人员或团队提供反馈,无论他们是否在大厅或10个时区以外。

你甚至可以在你自己的仓库中打开pull请求并自己合并它们。 在开展大型项目之前,学习GitHub流程是一种很好的方式。

打开合并请求以更改README文件:

1、点击Pull Request标签,然后从合并请求页面点击绿色的New pull request按钮。


2、Example Comparisons框中,选择您创建的分支,readme-edits,以与master(原始)进行比较。



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

4、如果您满意这些是您要提交的更改,请点击绿色的Create Pull Request按钮。


5、给你的拉取请求一个标题,并写一个你的改变的简要说明。

完成消息后,请点击Create pull request!

提示:您可以使用表情符号并将图像和gif拖放到注释和合并请求上。


五、合并您的请求

在这最后一步中,是时候把你的修改结合在一起了 - 将你的readme-edits分支合并到master分支中。

1、点击绿色Merge pull request按钮,将更改合并到master中。

2、点击Confirm merge.

3、继续操作,删除分支,因为它的更改已经合并。用紫色框中的Delete branch按钮。



恭喜!

通过完成本教程,您已经学会了创建一个项目并在GitHub上提出拉取请求!

以下是您在本教程中完成的任务:
     创建了一个开源库
     开始并管理一个新的分支
     更改了一个文件并将这些更改提交给GitHub

     打开并合并拉取请求

看看你的GitHub配置文件,你会看到你的新贡献广场(contribution squares)!

要详细了解Pull Request的功能,我们推荐阅读GitHub Flow Guide.(流程指南)。 您也可以访问GitHub Explore并参与开源项目


提示:查看我们的其他指南,YouTube频道和点播培训,了解更多关于如何开始使用GitHub的信息。


参考:https://guides.github.com/activities/hello-world/

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章