Hello World 项目是计算机程序编程中流传已久的传统。 这是一个简单的练习,让你开始学习新的东西。 让我们开始使用GitHub!
你将学会如何:
GitHub是用于版本控制和协作的代码托管平台。它让你和其他人可以在任何地方一起工作。
本教程教你使用GitHub的一些基础要素,如repositories,branches,commits和Pull Requests。 你将创建自己的Hello World仓库,并学习GitHub的Pull Request工作流程,这是一种流行的创建和查看代码的方式。
要完成本教程,你需要一个GitHub账户和Internet访问。你不需要知道如何编写代码,使用命令行或安装Git(GitHub所基于的版本控制软件)。
提示: 请在另一个浏览器窗口或页面打开这个教程,那么你可以看见。在单独的浏览器窗口(或页面)中打开本教程,以便在完成相应步骤时可以看到它。
一个仓库通常用于组织单个项目。仓库可以包含文件夹和文件,图像,视频,电子表格和数据集,即项目需要的任何内容。 我们建议您添加一个README或包含您项目信息的文件。Github让你很轻松地能在创建新的仓库的同时添加一个项目说明文件。 _它还提供其他常见选项,如许可证文件。
你的hello-world
仓库可以是你存储想法,资源以及与他人分享和讨论的地方。
hello-world
。点击 Create repository(创建仓库).
分支是同时在不同版本的存库上工作的方式。
默认情况下,你的仓库有一个名为master
的分支,它被认为是最终分支。 我们使用多个其他分支进行试验和编辑,然后将它们提交给master
分支。
当您从master
分支创建分支时,你就是在创建master
的副本或快照,因为它是基于该时间节点的。 如果有人在你在分支上工作时对master
分支进行了更改,那么你可以更新更改内容。
本图显示:
master
分支feature
的新分支(因为我们在这个分支上做feature
相关的工作)feature
分支在合并到master
前需要经历的流程你有没有保存过不同版本的文件?就像这样:
story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
分支在GitHub仓库中完成了类似的目标。
在GitHub中,我们的开发人员,作家和设计师使用分支来保持bug修复,并将功能与我们的master
(生产)分支分离开来。 当一个变更完成,他们才将其的分支合并到master
。
1.进入新仓库hello-world
。
2.点击文件列表顶部的下拉列表,它显示 branch:master 。
3.在新的分支文本框中输入一个分支名称readme-edits
。
4.选择蓝色的创建分支框,或者在键盘上点击Enter
。
现在你有两个分支,master
和readme-edits
。 它们看起来完全一样,但不会一直一样!接下来,我们将添加对新分支的更改。
好样的! 现在,你正在查看readme-edits
分支的代码内容,它是master
分支的副本。 让我们进行一些编辑吧。
在GitHub上,保存的更改称为commits(提交)。 每个提交都有一个关联的commit message(提交信息),这是一个描述为什么进行特定更改的描述。 提交信息记录了你变更的历史,因此其他贡献者可以了解你做了什么以及为什么做。
README.md
文件。这些更改将仅对你的readme-edits
分支上的README文件生效,因此现在该分支包含与master
不同的内容。
编辑得很好! 现在您已经在readme-edits
中创建了不同于master
的更改,可以发起一个pull 请求。
pull请求是GitHub协作的核心。 当你发起一个pull 请求时,你在提议你的修改,并请求其他人检查并合并你的贡献,并将变更并入他们的分支。 pull请求显示两个分支的内容的差异(diff或differences)。 更改内容包括新增和删除内容显示为绿色和红色。
一旦你发起提交,你可以发起一个pull请求并开始一场讨论,这些甚至能在代码完成之前开始。
通过在pull请求消息中使用GitHub的@mention系统 ,你可以要求来自特定人员或团队的反馈,无论他们是近在大厅还是远在10个时区之外。
您甚至可以在自己的存储库中打开提取请求,并自行合并。 在开展大型项目之前,了解GitHub Flow是一个很好的方式。
点击图片可观看大图
步骤截图
单击Pull Requesttab,然后在pull请求页面中,单击绿色的New pull request(新的pull请求)按钮。
选择你创建的分支readme-edits
,和master
(源)分支进行比较。
查看比较页面上的更改差异,确保它们是您要提交的。
当你确定这些是你想要提交的更改时,请点击绿色的Create Pull Request大按钮。
给你的pull request写一个标题,并为你的更改写一个简短的描述。
当你填写完信息后,点击Create pull request!
提示: 你可以在评论和pull请求中使用 emoji 以及 拖放图像和gifs 。
在这最后的一步,是时候把你的更改合并啦——将readme-edits
分支合并到master
分支。
master
分支中。通过实践这个教程,你已经学会了如何在Github上创建一个仓库并发起一个pull请求!
下面是对你在本教程中所完成内容的总结:
看查你的GitHub配置文件,你会看到你的新的贡献方块!
要了解有关Pull请求功能的更多信息,我们建议您阅读GitHub流程指南。 您也可以访问GitHub Explore并参与开源项目