什么是Github
- GitHub是用于版本控制和协作的代码托管平台。 它使你和其他人可以在任何地方共同处理项目。
- 本教程将教您GitHub基本知识,例如存储库,分支,提交和请求。 您将创建自己的Hello World存储库,并学习GitHub的Pull Request工作流程,这是一种创建和查看代码的流行方法
- 要完成本教程,无需编码,只需要一个GitHub.com帐户和Internet访问权限
创建和使用存储库
- 存储库通常用于组织单个项目。 储存库可以包含文件夹和文件,图像,视频,电子表格和数据集等,建议包括README或包含有关您的项目信息的文件
- 你的hello world存储库可以是你存储想法,资源,甚至与他人共享和讨论事物的地方
创建一个新的存储库
1.在右上角的头像或identicon旁边,单击,然后选择“New repository”。
2.命名您的存储库hello-world。
3.写一个简短的描述。
4.选择使用README初始化此存储库
创建一个新分支
- 分支是一次在不同版本的存储库上工作的方式。
- 默认情况下,您的存储库有一个名为main的分支,该分支被视为权威分支。 我们使用分支进行实验并进行编辑,然后再将其提交给main
- 当您从主分支创建分支时,您正在复制main, 如果在您处理分支时其他人对主分支进行了更改,则可以提取这些更新。
- 该图显示:
main分支
一个名为feature的新分支(因为我们正在此分支上进行“feature work”)
feature分支在融入main之前要经历的旅程
你是否曾经保存过不同版本的文件? 就像是:
story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
分支在GitHub存储库中实现相似的目标。
在GitHub上,我们的开发人员,作家和设计师使用branches将错误修复和feature work与我们的main(生产)分支区分开来。 准备好更改后,他们会将分支合并到main中。
创建一个新分支
- 转到新的存储库hello-world。
- 单击文件列表顶部显示分支:main的下拉列表。
- 在新的分支文本框中键入分支名称,readme-edits。
- 选择蓝色的“创建”分支框,或在键盘上按“ Enter”
现在您有两个分支,main和readme-edits, 现在它们看起来完全一样,接下来,我们将所做的更改添加到新分支中。
启动和管理新分支
- 现在,你位于readme-edits 分支的代码视图中,该分支是main的副本。 现在让我们进行一些编辑。
- 在GitHub上,保存的更改称为提交。 每个提交都有一个关联的提交消息,该消息是说明了为什么进行特定的更改。 提交消息记录了您的更改历史记录,因此其他贡献者可以了解您所做的事情以及原因。
进行并提交更改
单击README.md文件。
单击文件视图右上角的铅笔图标以进行编辑。
在编辑器中,写一些关于您自己的信息。
编写描述您所做更改的提交消息。
单击提交更改按钮
仅对readme-edits分支上的README文件进行更改,因此,此分支现在包含的内容与main有所不同
打开pull request
- 现在您已经在main分支中进行了更改,现在可以打开pull request。
- Pull Requests是GitHub上协作的核心。 当您打开请求请求时,您是在提出更改,并要求某人查看并提取您的贡献并将其合并到其分支中。 拉取请求显示两个分支中内容的差异或差异。 更改,加法和减法以绿色和红色显示。
- 提交后,即使在代码完成之前,您也可以打开pull request并开始讨论
- 通过在你的pull request消息中使用GitHub的@mention系统,你可以要求特定人员或团队提供反馈,无论他们是在大厅还是在10个时区之外
- 你甚至可以在自己的存储库中打开拉取请求,然后自己合并它们。 这是在进行大型项目之前学习GitHub流程的好方法
- 打开Pull Request更改README的请求
【1】单击“Pull Request”选项卡,然后从“拉取请求”页面中,单击绿色的“新建拉取请求”按钮。
【2】在“Example Comparisons”框中,选择您创建的分支(readme-edits),以便与main(原始)进行比较
【3】在“Compare”页面的差异中查看您的更改,确保它们是你要提交的
【4】当你对要提交的更改感到满意后,请点击绿色的大的创建请求请求按钮
【5】给你的请求请求一个标题,并写下你的更改的简短描述
留言完毕后,点击"Create pull request"!
提示:您可以使用表情符号并将图像和gif拖放到注释和“Pull Request”上。
打开并合并Pull Request
在最后的步骤中,是时候将你的更改集中在一起了–将readme-edit分支合并到main分支中
- 点击绿色的“Merge pull request”按钮将更改合并到main中
- 点击Confirm merge
- 继续并删除分支,因为已经合并了其更改,请在紫色框中使用“Delete branch”按钮。
完成本教程后,你已经学会了创建项目并在GitHub上发出拉取请求!
查看您的GitHub个人资料,您将看到新的贡献方块!
要了解有关请求请求功能的更多信息,我们建议阅读GitHub flow Guide。 您还可以访问GitHub Explore,并参与一个开源项目。