GitHub是一个版本控制和协作的主要代码平台。它使你和任何地方的其他人一起工作。
这个教程教给你GitHub的要领比如说资源库、分支、托管以及请求合并。你将会创造你自己的helloworld资源库,学习GitHub请求合并的工作流程,这是一种很流行的创造和回顾代码的方法
为了完成这个教程,你需要一个GitHub账号和网络。你不需要知道如何编码、使用命令行或者安装git(基于GitHub的版本控制工具)


创建一个新的版本库

一个版本库经常被用来组织单个的项目。版本库可以包含文件夹和文件、图片、音频、电子表格和数据集——任何你的项目所需要的。我们建议包含一个readme,或者是一个包含项目信息的文件。GitHub使得添加一个项目的同时创建一个新的版本库变得简单。它同样提供其它的公共操作比如一个许可文件。
你的helloworld版本库会和其它的东西一起放在你存放想法、资源甚至是分享和讨论事情的地方

  1. 在右上角,你的头像或者是身份标识的旁边,点击+号然后选择new respository.
  2. 输入名称helloworld
  3. 写一个简短的介绍
  4. 选中Initialize this repository with a README.
  5. 点击Create repository

创建一个新的分支:

分支是在同一时间对存储库的不同版本进行工作的方法
通过你默认的资源库有一个叫做master的被认为是决定性的分支,我们使用分支在提交到master之前进行试验和编辑
当你在master分支上创建分支的时候,你会做一个copy,或者是快照。如果有人在你修改分支的时候在主分支上做了修改,你可以进行更新。
这个图显示了:
1. master分支
2. 一个新的分支feature(因为我们即将做一些“future work”在这个分支上)
3. feature的试用在它融合到master之前
在GitHub中,我们的发展、写和设计使用分支为了保持修改代码和重要工作与master分支(即产品)分离。当这个change准备好了就会合并到master分支中去。
(目测大概就是版本更新的问题,使用branch进行版本更新可以在修改时先保存原先的版本然后搞定了之后再进行合并处理)

  1. 去到你新建的资源库helloworld
  2. 点击从顶端排下来的文件列表“branch:master”
  3. 在一个新的分支文档中写一个分支名“readme-edits”
  4. 选中蓝色的“create branch”按钮并单击
    现在你有两个分支:master和readme-edits。他们看上去是完全一样的但并不永远是。接下来我们将加入一些修改在新的branch中。

制作并提交修改

好极了!现在,你在readme-edits分支(从master复制过来的分支)的视图上,让我们来做一些编辑。
在GitHub上,保存修改称作提交。每次提交都会产生一个关联的提交信息,提交信息描述了为什么会做这样的修改。提交信息记录了你的修改历史,这样其它的参与者能更好的理解你做了哪些修改以及为什么要做这些修改。
步骤:
1. 点击 readme.md 文件
2. 点击右上角的铅笔图标进入编辑视图
3. 在编辑框里写一点关于你自己的信息
4. 写一个描述你的修改的提交信息
5. 点击“commit changes”按钮
这些修改只会放在你的readme-edits分支的readme文件中,所以现在这个分支包含了与master分支不同的东西


打开一个请求open a pull request

往仓库里边贡献代码向仓库所有者发出合并请求
非常棒的编辑!既然你在master分支上做了改变,你可以打开一个请求。
请求是在GitHub上合作的中心。当你打开一个请求时,您将提出您的变更,并请求某人查看并提取您的贡献并将其合并到他们的分支中。请求显示了两个分支内容的差异。这个变更、附件以及差集会用绿色和红色分别显示。
你一提交就会打开一个请求并且开始讨论甚至出现在代码完成之前。
通过在你的请求中使用GitHub的mention system(格式化工具),你可以向特定的人或组织请求回复,不管他们是在大厅里还是在十个时区之外。
你甚至可以在你自己的资源库中打开一个请求然后合并它。这是一个很好的方法来学习GitHub流程在在一个大的项目上工作之前。
打开一个请求并更改readme
点击图片为了一个更好的版本
1. 点击“pull request”然后在这个页面下点击绿色的“New pull request”按钮;
2. 选择你制作的分支,“readme edits”与master比较
3. 在比较页面上检查你的修改,确认你想要提交它;
4. 当你满意这些修改并且想要提交时,点击绿色的“Create pull request”按钮;
5. 给你的请求取一个名字并且为你的修改写一个简介。
当你在你的消息界面上完成了,点击“Create pull request”
tip:你可以使用表情符号或者拖入图片或gif动图到注解(comment)或者是请求(pull request)上


合并你的请求

在最后一步,是时候将你的修改和你的readme-edits分支一起合并到master分支了
1.点击绿色的“Merge pull request”按钮将更改合并到master分支中
2.点击“Confirm merge”
3.在合并修改之后,继续前进删除分支,在紫色的框里点击“delete branch”按钮


祝贺!通过完成这个教程,你学习了创建一个项目然后制作一个请求在GitHub上。
这是在教程上你完成的任务:
1.创建一个开源的资源库
2.开始并且托管一个新的分支
3.修改一个文件并且在GitHub上提交这些修改
4.打开和合并一个请求
看一下你的GitHub轮廓然后你可以看见你的新的contribution squares!
为了学习更多pull request 的魅力,我们建议你阅读GitHub flow guide。你同样可以进入GitHub explore 然后进入一个开源项目。
tip:了解更多如何开始GitHub通过其它的向导,YouTube通道以及按需训练

Logo

瓜分20万奖金 获得内推名额 丰厚实物奖励 易参与易上手

更多推荐