翻译官方教程 :https://guides.github.com/activities/hello-world/
Hello World在计算机编程中是一个悠久的传统,它是一个让你在学习新东西时的简单练习,让我们开始使用GitHub!
你将学习如何:
- 创建并使用一个仓库
- 开始并管理一个新的分支
- 对文件进行修改并将它们推送给GitHub
- 打开并合并一个请求
什么是GitHub?
GitHub是一个用来版本控制和协作的代码托管平台,它可以让你和其他人在任何地方一起为你的项目工作。
本教程向您介绍GitHub的要素如仓库,分支,提交和合并请求。你将创建你自己的Hello World仓库并且学习GitHub的拉取请求流程,这是一种创建和查看代码流行的方式。
没有必要的编码
要完成本教程,您需要一个GitHub.com账户和Internet访问权限,你不需要知道如何编写代码,使用命令行或安装Git(构建了GitHub的版本控制软件)。
提示:在单独的浏览器(或选项卡)中打开本指南,以便在完成教程中的步骤时看到它。
步骤1:创建一个仓库
一个仓库通常用来组织单个项目,仓库可以包含文件夹和文件,图片,视频,表格和数据集——任何你项目需要的东西。我们建议包括一个自述文件或包含关于您项目信息的文件。GitHub可以很轻松在你新建你的仓库同时新增一个。它还提供其他常见选项,如许可证文件。
你的hello world仓库可以成为你存放想法,资源,甚至于他人分享和讨论事物的地方。
创建一个新的仓库
1.在右上角,在您的头像或身份标识旁边,点击+,然后选择New repository
2.命名您的仓库hello-world。
3.写一个简短的描述。
4.选择Initialize this repository with a README. 使用自述文件初始化该仓库。
点击Create repository创建存储库。
步骤2: 创建一个分支
分支是在一个仓库中处理不同版本的一种方式
默认情况下,您的仓库有一个名为master的分支,它被认为是最终分支。我们在提交给master之前使用分支来进行实验和编辑。
当您从master分支中创建分支时,您将创建master分支的复制或快照,就像它在那个时间点一样。如果其他人在您的分支上工作时对主分支进行了更改,则可以引入这些更新。
此图显示:
- master 分支
- 一个叫做feature的新分支(因为我们正在这个分支上做feature work)
- 当feature合并到master之前要经历的流程
您有没有保存过不同版本的文件? 就像是:
story.txtstory-joe-edit.txtstory-joe-edit-reviewed.txt
分支机构在GitHub分支中实现类似的目标。
在GitHub上,我们开发人员,作者和设计人员使用分支将错误修复和特色工作与master分支分开,当更改准备就绪后,他们将分支合并到master中。
创建一个新的分支
1.转到您的仓库hello-world.
2.点击文件列表顶部的下拉列表中的branch:master
3.在新的分支文本框中输入分支名称readme-edits
4.选择蓝色的Create branch框或点击键盘上的Enter.
现在你有两个分支,master和readme-edits,它们看起来完全一样,但不会太久!接下来我们会将我们更改添加到新分支中。
步骤3:制作和提交更改
好样的!现在,您正在使用readme-edits分支的代码视图,该分支是master的副本。我们来做一些编辑。
在GitHub上,保存的更改称为提交。每个提交都有一个关联的提交消息,它是解释为什么进行特定更改的说明。提交消息捕获您所做更改的历史记录,所以其他贡献者可以了解您所做的工作以及原因。
制作和提交更改
1.点击RADME.md文件
2.点击文件视图右上角的铅笔图表进行编辑
3.在编辑器中,写一些关于你自己的信息
4.编写描述您更改的提交信息
5.点击Commit changes提交更改按钮
这些更改将仅针对readme-edits分支上的README文件中进行,因此,该分支包含的内容与主文件不同。
步骤4:打开合并请求
好的,现在您的分支已经发生变化,您可以打开一个合并请求。
合并请求是GitHub协作的核心。当您打开一个合并请求时,你正在提出你的改变,并要求有人审查并提交你的贡献,并将它们合并到他们的分支中。合并请求显示来自两个分支的内容差异。更改,添加和删减以绿色和红色显示。
一旦你提交了,你甚至可以在代码完成之前打开一个合并请求并开始讨论。
通过在你的合并请求中使用GitHub的@mention系统,您可以要求特定人员或团队提供反馈,无论他们是否在大厅或10个时区以外。
你甚至可以在自己的仓库中打开合并请求并自己合并,在开展大型项目之前,学习GitHub流程是一种很好的方式。
打开合并请求以更改自述文件
步骤5:合并您的请求
在这最后一步中,是时候把你的修改结合起来,将你的readme-edits分支合并到master分支中
1.点击绿色Merge pull request来将更改合并到master中。
2.点击Confirm merge。点击确认合并
3.继续操作,删除分支,因为它的更改已经合并,并且在紫色框中带有删除分支按钮。
恭喜!
通过完成本教程,您已经学会了创建一个项目,并在GitHub上提出合并请求
以下是您在本教程中完成的任务:
- 创建一个开源库
- 开始并管理一个新的分支
- 更改了一个文件并将这些更改提交给GitHub
- 打开并合并请求
- 看看你的GitHub配置文件,你会看到你的新贡献广场!
要了解更多关于Pull Request的功能,我们推荐阅读GitHub流程指南。您也可以访问GitHub Explore并参与开源项目:octocat:
提示:查看我们的其他指南,YouTube频道和点播培训,了解更多关于如何开始使用Git-Hub的信息