本文是GitHub官方指南Github Guides的英文翻译,帮助大家更好的使用。
翻译并不是直接翻译,而是按照中文思维翻译。使用MarkDown
转载请注明出处。
阅读全文需时十分钟
编写Hello world项目是计算机编程领域的一个时代传统,所以我们学习GitHub也从Hello world开始吧!
你将会学习到:
GitHub是一个用于版本控制和协作的代码托管平台。它允许您和其他人在任何地方的项目上一起工作。
本教程介绍了GitHub的基础知识,例如版本库、分支、提交、发布请求。你将创建自己的Hello world版本库并学习如何发布请求。
实现本教程只需要一个GitHub账号和互联网链接,不需要安装git,因为GitHub已经内置了git。
小贴士:在单独的浏览器窗口(或选项卡)中打开本指南,以便在完成教程中的步骤时可以看到它。
一个项目存放于一个版本库中,版本库可以包含文件夹和文件、图像、视频、电子表格和数据以及任何项目需要的内容。我们建议包含一个自述文件:README,或者一个包含项目信息的文件。GitHub使您在创建新版本库的同时添加一个库变得容易。它还提供其他常见选项,如许可证文件。
你的Hello World
存储库可以是一个存储想法、资源甚至与他人共享和讨论事物的地方。
+
号,选择New repository点击 Create repository.
分支是一次处理不同版本存储库的方法。
默认情况下,您的版本库中有一个名为master的分支,该分支被视为最终分支。在将分支提交给master之前,我们使用分支进行实验和编辑。
当你在你的分支上工作时,其他人对master进行了修改,你可以拉取master并更新你的分支。
下图展示了:
您是否保存过不同版本的文件?类似:
story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
分支在Github存储库中实现了类似的目标。
在Github,我们的开发人员、编写人员和设计人员使用分支将错误修复和功能工作与我们的主(生产)分支分开。当变更准备就绪时,它们将分支合并到主节点中。
readme-edits
现在你有了两个分支:master和readme-edits,它们目前看起来一样,但是在我们修改之后就不一样了。
好极了!现在,您在代码视图中看到了readme edits分支,它是master的副本。让我们做些编辑。
在GitHub上,保存的更改称为提交。每次提交都有一个关联的提交消息
,这是一个描述,解释了为什么进行了特定的更改。提交消息包含了更改的历史记录,以便其他参与者能够理解您所做的以及为什么。
现在你已经对master的分支进行了修改,可以发布一个发布请求
。
请求是GitHub上协作的核心,当你发布一个一个发布请求
表达的含义是:你正在提议你的更改并请求他人审阅你的更改并合并到他们自己的分支中。发布请求
会显示两个分支的差异,增加的内容用绿色显示,删除的内容用红色显示。
一旦提交,就可以打开请求并开始讨论,甚至在代码完成之前。
你可以使用GitHub’s @mention system来创建你的发布请求
,您可以请求特定人员或团队的反馈,无论他们是在大厅下面还是在10个时区之外。
您甚至可以在自己的版本库中打开请求并自己合并它们。这是在处理大型项目之前学习Github流
的一个很好的方法。
Open a Pull Request for changes to the README
发布请求
发布请求
按钮。单击创建发布请求
!
您可以使用emoji,将图像和gif拖放到注释和请求中。
发布请求
在最后一步中,是时候将您的更改合并在一起了——将readme edits分支合并到master分支中。
单击绿色的合并请求按钮将更改合并到主控形状中。
单击“确认合并”。
继续删除分支,因为它的更改已经合并,紫色框中的删除分支按钮。