初学GitHub(原文点击链接)
介绍
使用Hello World向导,你将会创建一个repository(仓库)、开始一个branch(分支)、编写comments(注释)并打开一个pull request。
Hello World项目是计算机编程领域一个悠久的传统。这是一个简单的练习,使你学到新知识,让我们开始使用GitHub
你将学到如何:
- 创建并使用一个repository
- 开始并管理一个新的branch
- 修改文件并将其作为commits(提交)push(推送)给GitHub
- 打开并合并一个pull request
什么是GitHub?
GitHub是一个用于版本控制和协作的代码托管平台。它可以使您和其他人可以在任何地方共同处理项目。
本教程将教您GitHub基本知识,例如repositories(仓库),branches(分支),commits(提交)和Pull Requests(发起请求)。你将创建自己的Hello World repository并学习GitHub的Pull Request工作流程,这是一种创建和查看代码的流行方法
无需编码
为了完成本教程,你需要一个GitHub.com的账号和互联网。你不需要知道如何写代码,使用命令行或安装Git(版本控制软件GitHub是基于Git构建的)。
提示:在单独的浏览器窗口或者选项卡中打开本教程,以便在完成教程中的步骤时可以看到它
第一步.创建一个Repository
repository 经常用于组织单个项目。 Repositories 可以包含文件夹和文件、图像、视频、电子表格和数据集——项目需要的任何内容。 我们建议包含 README(项目自述文件), 或者包含有关您的项目信息的文件。 GitHub可以轻松地在创建新存储库的同时添加一个,它还提供了其他常用选项,例如许可证文件
你的 hello-world
repository可以是您存储想法、资源甚至是与他人共享和讨论事物的地方。
创建一个新的repository
- 在右上角头像旁,点击+并选择New repository
- 给你的repository命名为
hello-world
- 写一个简短的描述
- 选择Initialize this repository with a README
- 点击Create repository
第二步. 创建一个分支
Branching 是同时处理repository的不同版本的方法。
在默认情况下,您的repository有一个名为master
的branch,它被认为是主branch。在将branch提交给master
之前,我们可以使用branch进行实验与编辑。
当您在master
分支之外创建branch的时候,你是在复制或者是快照master
当时的副本。如果其他人在您处理branch时对master
进行了更改,您可以pull(引入)这些更新。
这个图表显示了:
-
master
分支 -
一个名为
feature
的分支 -
feature
在合并到master
之前的历程
你曾经保存过一个文件的不同版本吗?例如: -
story.txt
-
story-joe-edit.txt
-
story-joe-edit-reviewed.txt
Branches在GitHub repository中完成类似的目标。
在GitHub,我们的开发人员、编写人员和设计人员使用branches来修复bug和完成功能与我们的master
分支分开。当一个change准备好的时候,他们将其合并进master
中去
创建一个新的branch
-
进入你的新repository
hello-world
-
单击文件列表顶部显示branch: master的下拉列表
-
在新的分支文本框中键入分支名称
readme-edits
。 -
选择蓝色Create branch框或按键盘上的“回车”
现在你有两个分支,master
和readme-edits
,他们看起来一样,但不会太久,接下来我们将把更改添加到新分支中去
第三步. 做出并commit changes
万岁!现在您在readme-edits
分支的代码视图中,它是master
的一个副本,让我们做一些编辑。
在GitHub,保存的changes叫做commits(提交)。每一个commit有一个相关的*commit message(提交信息)*用来解释为什么要进行特定更改的描述。Commit message捕获您的更改历史,这样其他contributors(贡献者)可以理解您所做的事情和原因。
做出并提交更改
-
点击README.md文件
-
点击文件视图右上角pencil铅笔图标进行编辑
-
在编辑器中写一些关于你的信息
-
编写一个commit message来描述您的更改
-
点击Commit changes按钮
这些更改将只针对readme-edits
分支上的README文件,所以现在这个分支包含与master
不同的内容
第四步. Open一个Pull Request
干的漂亮!现在您已经在master的一个分支中进行了更改,你可以open一个pull request。
Pull Request是GitHub协作的核心。当你open一个pull request时,您是在提议您的更改并请求别人review并pull in 您的贡献,并将其合并入他们的分支中。Pull requests 显示来自两个分支的diffs。更改、添加和删除以绿色和红色显示。
一旦你进行了commit,你可以open一个pull request并开始讨论,甚至在代码完成之前也是如此
通过GitHub的@提醒系统,你可以向特定的人或团队寻求反馈,不管他们是在客厅的另一边还是10个时区之外。
你甚至能在自己的repository中open pull request并自己合并他们。在进行大型项目之前,这是学习GitHub流程的好方法。
Open一个给README的改变的Pull Request
以下步骤参照GitHub的GIF图
单击Pull Request 选项卡, 然后从Pull Request页面单击绿色的 New pull request 按钮
在Example Comparisons框中,选择您创建的分支readme-edits
与master
(原始版本)比较
查看你在比较页面中的更改的差异,确保他们是你想要的更改
当您确认这些是您想要提交的更改时,点击绿色的Create Pull Request按钮
给你的pull request一个标题并写一个简短的变更描述
你可以使用emoji或者把图片和gif拖放到评论和pull request中
第五步. 合并Pull Request
在最后一步,将所有更改集中在一起了——将readme-edits
分支合并到master
分支中
- 点击绿色的Merge pull request按钮来合并更高到
master
中 - 点击Confirm merge
- 继续并删除分支,因为已经合并了更改,因此在紫色框中选择Delete branch按钮
最后
更多有关Pull RequestGitHub flow Guide
其他指南