项目Hello World 是电脑编程的经典。这是学习新东西时的简单练习。让我们开始学习GitHub吧!
你将学到:
创建和使用仓库
创建和管理一个新的分支
提交改变的文件到GitHub
打开和合并拉取的内容
GitHub是什么?
GitHub是一个版本控制和分享的代码托管平台。它允许你和其他任何地方的人一起操作同一个项目。
这个教程教会你像仓库、分支、提交、拉取等基本操作。你将创建你自己的Hello World仓库并且学习流行的创建和审查代码的GitHub的拉取工作流。
不需要知道代码原理
开始学习之旅前,你需要一个可用的网络环境和一个GitHub.com的账号。你并不需要知道要如何编码,只需命令行,或者安装Git(GitHub所依赖的版本控制工具)。
提示:在单独的窗口打开这个引导页,这样当你完成教程前方便你查看。
步骤1.创建一个仓库
仓库通常是用来管理一个单独的项目。仓库可以包含你的项目所需要的任何东西--文件、文件夹、图片、视频、电子表格和数据集。我们建议在项目里添加一个“文件说明”,或者项目的说明信息。通过GitHub在你创建一个仓库的时候你可以很方便地添加一个文件。当然也有其他像授权文件等类似的操作。
你的hello-world仓库可以是一个你分享想法、资源或者其它分享或讨论的东西的地方。
创建一个新的仓库
1.在右上角的头像旁边,点击+号,然后选择New repository
2.将仓库命名为hello-wold
3.写一个简短的描述
4.选择Initialize this repository with a README
点击Create repository
步骤2.创建一个分支
分支用于同时操作一个仓库中的不同版本。仓库中默认有一个不可更改的名为master的默认分支。我们通过分支在提交到分支master之前来实验或者编辑代码。
当你从master分支上创建一个分支时,你实际上是做了一份拷贝,或者是当前时间点的快照。当你在你当前的分支工作时有人对master分支进行了更改,你可以拉取所做的更改。
如下图所示:
--master分支
-- 一个新的feature分支(因为我们要在这个分支上做“新特性”之类的工作)
--在feature分支合并到master分支之前进行了拉取
你曾经保存过同一个文件的不同版本吗?像这样:
在GitHub仓库中可以完成类似的目标。
在GitHub,开发人员通过与在master分支之外的独立的分支上开发、写代码、修改bug并完成功能性工作。当所有这些改变完成的时候,他们将会将代码合并到master分支上。
创建一个新的分支
1.打开你新建的hello-world仓库
2.点击下拉列表并且选择branch:master
3.在编辑框中输入新的分支名readme-edits
4.选择蓝色按钮Create branch 或者在键盘上点击“Enter”
现在你有master和readme-edits两个分支。他们现在看起来是一样的,但很快就不是了!下面我们将对新的分支做一些改变。
步骤3.更改并提交改变
哇!现在你在readme-edits分支上,这是一个master分支的复件。让我们对其进行编辑一下。
在GitHub上,保存所做的更改叫做提交。每次提交都可以提交一个对本次更改内容进行描述的信息。信息是更改历史的记录,这样其他的开发者可以明白你更改了哪些内容。
更改并提交
1.点击文件README.md
2.点击文件右上方用于编辑的画笔图标
3.在编辑器中写一小段关于你的描述
4.写关于你本次更改的描述信息
5.点击按钮Commit changes
那些更改只操作了readme-edits分支的README文件,所以现在所在的分支与master分支的内容是不一样的。
步骤4.拉取请求
做的好!既然更改了master分支,现在你可以打开pull请求。
pull请求是协作式GitHub的核心。当打开pull请求时,实际上你是允许其他人拉取、审核你更改的文件到本地并且合并到他们的分支上。pull请求显示了两个分支的不同或者说是区别。所做的更、添加、删除都将在红色和绿色的下划线上。
当你提交后,你可以打开一个pull请求并且开启一个讨论,即使在结束编码之后也可以。
在你的拉取信息中通过GitHub的@mention system 功能,你可以从特定的人或团队中获得反馈,即使他们远在天边。
你也可以拉取到你自己的仓库中并与自己的代码合并。在操作大型项目之前学习GitHub的流程是很棒的。
对改变后的README文件进行拉取
点击标签 Pull Requests,在Pull Request 页面,点击绿色的New pull request按钮
选择你更改文件的分支readme-edits,与分支master(原始的)进行比对(点击右上角的蓝色的compare)。
在Compare页面看文件的区别,并确保是你所要提交的。
当你对所要提交的都满意时,点击大的绿色的按钮Create Pull Reuest
为你的拉取请求写一个标题,并对更改的内容做一个简单的描述。
当编辑完后,点击按钮Crate pull request!
步骤5.合并你拉取请求的内容
在最后一步,到了将你更改的内容放到一起的时候了-将分支readme-edits合并到分支master
1.点击绿色的按钮Merge pull request来将更改合并到master分支上。
2.点击Confirm merge
3.继续并删除分支,因为已经将更改进行了合并,点击紫色的按钮Delete branch删除分支。
恭喜!
经过这个指南,你已经学会了在GitHub上创建一个项目、创建一个pull请求。
下面是你在这个指南中所完成的:
--创建一个公开的仓库
--创建并管理一个新的分支
--更改一个文件并将更改提交到GitHub上
--打开并合并Pull请求
如果你想学习pull请求更多的内容,我们建议你读一下 GitHub Flow Guide(https://guides.github.com/introduction/flow/)。你也可以访问网站 GitHub Explore(https://guides.github.com/introduction/flow/)并参与到开源项目中来
提示:更多关于GitHub的内容尽在Guides (https://guides.github.com/)和 YouTube Channel(http://youtube.com/githubguides)
原文地址:https://guides.github.com/activities/hello-world/