目录
- Create and use a repository
- Start and manage a new branch
- Make changes to a file and push them to GitHub as commits
- Open and merge a pull request
What is GitHub?
Github是一个代码托管平台。
本教程将向您介绍GitHub的基本功能,如存储库、分支、提交和拉取请求。您将创建自己的hello world存储库,并学习github的pull-request工作流,这是一种创建和审查代码的流行方法。
无需编码
要完成本教程,您需要github.com帐户和Internet访问。您不需要知道如何编写代码、使用命令行或安装git(版本控制软件github是基于此构建的)。
提示:请在单独的浏览器窗口(或选项卡)中打开此指南,以便在完成教程中的步骤时可以看到它。
第一步:创建仓库(repository)
存储库通常用于组织单个项目。存储库可以包含文件夹和文件、图像、视频、电子表格和数据集—任何项目需要的内容。我们建议包括一个自述文件,或者一个包含项目信息的文件。github使您可以在创建新存储库的同时轻松添加一个存储库。它还提供其他常见选项,如许可证文件。
hello world存储库可以是一个存储想法、资源,甚至与他人共享和讨论内容的地方。
创建新存储库
1.在右上角,在您的头像或标识图标旁边,单击,然后选择New Repository。
2.命名存储库hello world。
3.写一个简短的描述。
4.选择“使用自述文件初始化此存储库”。
第二步:创建一个分支(branch)
分支是一次处理不同版本存储库的方法。
默认情况下,存储库有一个名为master的分支,该分支被视为最终分支。在将分支提交给master之前,我们使用分支进行实验和编辑。
当您在主分支上创建分支时,您正在按主分支在该时间点上的状态创建主分支的副本或快照。如果其他人在您处理分支时对主分支进行了更改,您可以将这些更新拉入。
下图显示:
•主分支
•一个名为Feature的新分支(因为我们正在对该分支进行“功能工作”)
•功能在融入主功能之前所经历的旅程
你保存过不同版本的文件吗?类似于:
- story.txt
- story-joe-edit.txt文件
- story-joe-edit-reviewed.txt文件
分支在github存储库中实现类似的目标。
在github,我们的开发人员、作者和设计师使用分支来保持bug修复和功能工作与我们的主(生产)分支分离。当变化准备好时,他们将分支合并为master。
创建新分支
1.去你的新仓库Hello World。
2.单击文件列表顶部的下拉列表,其中显示branch:master。
3.在“新建分支”文本框中键入分支名称“自述编辑”。
4.选择蓝色的创建分支框或按键盘上的“回车”键。
现在有两个分支,master和readme编辑。它们看起来一模一样,但不会太久!下一步我们将把我们的更改添加到新的分支。
第三步:更改和提交更改
好极了!现在,您进入了readme edits分支的代码视图,它是master的副本。让我们做些编辑。
在github上,保存的更改称为提交(commit)。每个提交都有一个关联的提交消息,这是一个说明,解释为什么进行了特定更改。提交消息捕获更改的历史记录,以便其他贡献者能够理解您所做的操作以及原因。
更改和提交更改
1.单击readme.md文件。
2.单击文件视图右上角的铅笔图标进行编辑。
3.在编辑器中,写一点关于你自己的东西。
4.编写一条说明更改的提交消息。
5.单击“提交更改”按钮。
这些更改将仅对“自述编辑”分支上的自述文件进行,因此现在此分支包含与“主控”不同的内容。
第四步:打开拉取请求
很好的编辑!现在您已经更改了master的分支,可以打开一个pull请求。
拉取请求是github上协作的核心。当您打开一个请求时,您提出了您的更改,并请求有人检查和拉入您的贡献并将其合并到他们的分支中。拉取请求显示来自两个分支的内容的差异。更改、添加和减法显示为绿色和红色。
一旦提交,就可以打开请求并开始讨论,甚至在代码完成之前。
通过在pull请求消息中使用github的@notice系统,您可以请求特定人员或团队的反馈,无论他们是在大厅下面还是10个时区之外。
您甚至可以在自己的存储库中打开pull请求并自己合并它们。在处理更大的项目之前,这是学习github流的好方法。
打开请求更改自述文件
点击图片查看更大版本
1. 单击“拉取请求”选项卡,然后在“拉取请求”页面中,单击绿色的“新建拉取请求”按钮。:
2. 在“示例比较”框中,选择要与主控形状(原始形状)进行比较的分支“自述编辑”。
3. 查看比较页上差异中的更改,确保它们是您要提交的内容。
4. 当您确信这些是要提交的更改时,请单击绿色的“创建请求”按钮。
5. 给你的请求一个标题,并写一个简短的变更描述。
完成信息后,单击“创建拉取请求”!
提示:您可以使用emoji并将图像和gif拖放到评论和请求中。
第五步:合并拉取请求
在最后一步中,是时候将您的更改合并到一起了——将您的自述编辑分支合并到主分支中。
1.单击绿色的合并请求按钮,将更改合并到主控形状。
2.单击“确认合并”。
3.继续删除分支,因为它的更改已经合并,紫色框中有delete branch按钮。
庆祝一下!
通过完成本教程,您已经学会了在github上创建项目和发出请求!
以下是您在本教程中完成的内容:
•创建了一个开源存储库
•开办和管理一个新的分支机构
•更改了一个文件并将这些更改提交给github
•打开并合并拉取请求
看看你的github档案,你会看到你的新贡献广场!
要了解pull请求的强大功能,我们建议阅读github流指南。您还可以访问github explore并参与一个开源项目。
____________________
提示:查看我们的其他指南、youtube频道和点播培训,了解更多关于如何开始使用github的信息。
上次更新时间:2016年4月7日