Hello GitHub!初次见面,请多多指教
如何创建GitHub存储库以及pull request
Reference: GitHub Guides Hello GitHub! Click me!
本文主要介绍GitHub的基础知识,包括存储库(Repository)、分支(Branch)、提交(Commit)和请求(Pull Request);并介绍如何创建属于自己的Hello World存储库 + Pull Request的工作流程。
1. GitHub是什么?
GitHub是一个可用于控制版本和协作的代码托管平台(其实就是个代码仓库),也是一个协同工作的平台。
为了完全本教程,你需要有一个GitHub的账号。
2. 创建存储库(Create a Repository)
a. 存储库(Repository)是什么?
每一个单独的项目都有一个存储库,而这个存储库里可以储存文件夹、文件、图片、视频、表格、数据集等;建议存储库里有Readme文档(通常包含该项目的说明或注意事项),方便他人理解项目详情。
存储库可以存储个人想法、资源,也可以和他人交流互动(感觉也可以是个社交平台了)。
b. 创建步骤
第一步:在主页右上角,个人头像的隔壁有一个“➕”,然后选择“New repository“,如下图:
第二步:给新的存储库命名,写一段简单的描述,并且要选择“Initialize this repository with a README”;
第三步:点击“Create repository”
创建成功!
3. 创建一个分支(Create a Branch)
a. Branch是什么?
1、分支是指允许同时修改不同版本的存储库,但却互不影响。
2、每一个存储库都有一个默认分支,称为“master”;我们可以使用不同的分支去做不同的实验、修改,最后提交到“master”里。
b. 如何将新建分支合并到默认分支“master”中
第一步:创建分支;
第二步:提交更改(Commit Changes);
第三步:提交请求(Submit Pull Request);
第四步:讨论变更(Discuss Proposed Changes)
第五步:合并到默认分支“master”
我们以前写程序的时候,应该都会有多个版本吧,例如version1.txt、version1-zoey-edit.txt等等;
而分支的功能就是帮助储存不同版本的文件,而当分支经过确认后,即可合并到默认分支“master”中。
c. 建立新的分支
在空白处输入分支名称,按“enter”即可创建新的分支。
4. 提交更改(Make and commit changes)
在GitHub里,保存更改称为commits(提交);每一个commit都有一个相关信息(commit message),描述修改之处;而且,commit message还记录了更改的历史记录,方便他人了解更改详情,所以这也是个协同工作的工具。
a. 如何提交更改
第一步:点击README.md文件;
第二步:选择需要修改的branch,点击✏️进行修改
第三步:编辑,并在commit message中描述本次的更改
第四步:提交更改
注意:以上仅对readme-edit分支中的README文件进行修改,所以这个新的branch中所包含的内容与master的并不相同。
5. 开启请求(Open a Pull Request)
现在已经完成更改啦,接下来就是打开请求了。
a. 什么是Pull Request(拉取请求)
1、这是GitHub协同合作的核心功能。当你开启pull request的时候,你可以指出你的更改之处,并可以请求某人检查,从而拉取你的贡献并将其合并到他们的分支中;
2、pull request还可以展示两个分支的不同点或差异;
3、加法是绿色呈现,减法是红色;
一旦提交更改,即可开启pull request和开展讨论。
4、GitHub还有一个提及(@)功能;即你可以通过@一些专业人员或者团队,向他们请求反馈;
b. 详细教程
第一步:点击上方的“pull request”,然后点击“New pull request“
第二步:在“example comparisons”区域,可以选择你新建的branch与master进行比较;点击进去即可看到具体的不同之处;
第三步:确认过眼神之后,即可点击“Create Pull Request“
第四步:给pull request命名以及加一些简单的描述
提示:描述可以用????或图片、GIF哦~
6. 合并请求(Merge your Pull Request)
最后一步啦~~~将新的branch合并到默认分支master中。
第一步:点击“Merge pull request“
第二步:确认(confirm merge);
第三步:确认过后就可以删除这个分支啦,因为已经合并到master里了。
好啦 非常详细的教程 希望对你们有用 再见 ????