Hello World程序是计算机编程中由来已久的惯例,这是一个当你在学习新事物的时候开始的一个简单的小练习。让我们开始GitHub的"Hello World".

你将学会:

- 创建和使用一个版本库

- 开始和管理一个新的代码分支

- 对一个文件作出变化,并且将它们提交到GitHub上

- 打开及合并一个合并请求(pull request)

什么是GitHub?

GitHub 是一个进行版本控制和协作的代码托管平台。它可以让你与世界各地的开发者一起开发同一个项目。

这份指导将会教你GitHub的基本概念:版本库、分支、提交、以及合并请求。你将会创造属于你自己的Hello World 版本库并且学会GitHub的合并请求的工作流程,这是一个是受欢迎的创建和评审代码的方式。

没有写代码的必要

要完成这份教程,你需要一个GitHub网站的账号和能够连接连互联网,你不需要会写代码,也不需要会利用命令行及安装Git(GitHub内置的版本控制软件)。

提示:建议在单独的浏览器窗口(separate browser window)(或者标签),这样你可以在完成本教程的步骤时随时翻看本教程。

Step 1. 创建一个版本库

一个版本库是用来组织一个单独的项目。版本库中可以容纳文件夹和文件、图片、视频、电子表格,或是数据集,任何你的项目需要的东西。我们建议版本库中包含一个README,或者是一个介绍你的项目信息的文件。GitHub能够轻易地在你创建一个新的版本库的同时添加上述文件。GitHub也提供了其他常用的设置例如一个许可文件。

你的 hello-world 版本库将是一个你储存想法、资源甚至是与他人讨论想法的绝佳胜地。

新建一个新的版本库

1. 在页面靠近你的头像的右上角,点击符号,选择New repository

2. 将你的标准库命名为 Hello-World

3. 写一个简单的描述

4. 将 Initialize this repository with a README 选项勾上,这样GitHub在生成版本库的同时会生成一个README文件

5. 点击Create repository,这样一个HelloWorld的版本库便创建好了。

Step 2. 创建一个分支

分支系统是一个版本库同时在多个不同的版本上工作的一种方式。你的版本库在创建成功后会默认的创建一个名为master的分支,这个分支被认为是决定性的主线版本。在将内容提交到 master 分支之前,我们将会在其他分支上实验和修改我们的内容。

当你从 master 分支创建另外一个分支时,相当于将该时间段的 master 拷贝或者创建一个快照到你创建的分支上。当你在其他分支上工作时, master 分支被其他人修改了。这时候你可以在你的版本上合并这些更新。

下图展示出:

- 主线版本 master

- 一个叫做 feature 的新的分支(因为我们在这个分支上做着“未来的工作”)

- 在 feature 合并到 master 之前,它经历的过程

你是不是也对一个文件创建过下面的这些版本?

- 文件.txt

- 文件初稿完成版.txt

- 文件初稿完成版修改版.txt

- 文件最终修改版.txt

- 文件最终修改版再次修改版.txt

分支系统能够轻松的在GitHub中完成上述的工作。

在GitHub中,开发者,文案和设计者利用从 master (产品)单独拷贝的分支来进行bug的修改和功能独立的工作。当修改完毕,他们可以将他们自己的分支合并到 master 中。

创建一个新的分支

1. 跳转到你的新版本库hello-world

2. 点击在文件列表顶端显示branch:master的下拉菜单

3. 在新的分支文本框中新分支的名称, readme-edits

4. 选择蓝色的Create按钮或者敲击键盘的回车键。

现在,你就拥有了两个分支:主线分支 master 和 新创立的分支 readme-edits。这两个分支只是暂时看起来是一模一样的。接下来我们将会在新的分支上进行改动

Step 3. 进行和提交修改

接下来,你将要对你的readme-edits分支,master的一个备份,进行代码审查。首先我们先做出一些修改。

在GitHub中,保存更改的操作称为提交。每个提交的操作都会关联着一份提交信息,提交信息是一份解释为何要做出此更改的描述性文字。提交信息会保存你更改的历史,这样其他贡献者能够了解到你的成果以及你为什么要这样做。

制造并提交修改

  1. 点击README.md文件。
  2. 点击文件预览窗口右上方的铅笔的小图标来进行编辑。
  3. 在编辑中,自由发挥写一点内容。
  4. 写一个描述你做出的改变的提交信息。
  5. 点击Commit changes按钮。

刚才在README文件中做出的改变仅仅是在你的readme-edits分支上。所以现在这个分支上包含的内容与master上面的内容是不同的。

Step 4.打开一个合并请求

既然你已经在master之外的分支做出了许多的更改,那么你就可以开放一个合并请求。

合并是在GitHub上进行合作的核心。当你开放一个合并请求,意味着你正在提议你的修改,请求别人的评审并且采纳你的贡献将你修改的内容合并到他们的分支中。合并请求会显示出两个分支之间的差异和不同。修改,增加和减少将会以红绿对比的形式展示。

即使在编写代码的工作完成之前,只要你进行一次提交,你就可以开放一个合并请求并且开始一场讨论。

通过在你的合并请求信息中使用GitHub的提示信息,你可以向特定的人群或者团队请求回信,不论他们就在你楼下还是远在地球的另一边。

你甚至可以在你自己的版本库中开放请求信息然后合并它们,这是在处理大的项目之前一个很好的学习GitHub流程的方式。

对README的修改开放一个合并请求

1. 点击Pull Request标签,然后在合并请求的页面上,点击绿色的New pull request按钮

[

2. 选择你创建的分支readme-edits,拿它与master(源版本)进行比较。

3. 仔细检查比较页面你更改的不同,确保这些改变是你想要提交的

4. 当你对要提交的改变满意时,点击绿色的Create Pull Request的大按钮。

5. 给你的合并请求设置好题目并且对你做出的更改写一个简单的介绍

完成上述步骤之后,点击Create pull request创建合并请求

提示:你可以在合并请求和评论当中使用emoji表情和拖入图片或动图来更好的表达你的想法。

Step 5.提取你的合并请求

在最后的步骤,是将你的改变整合到一起去的时候——合并你的readme-edits分支到master分支上去

1. 点击绿色的Merge pull request按钮来将改变合并到master中。

2. 点击Confirm merge按钮来确认合并请求

3. 在分支被合并之后,可以利用紫色区域的Delete branch按钮来删除它。



祝贺你完成本次教程

在完成教程的过程中,我们学习了创建一个工程并且在GitHub上创建一个请求。

这是你在完成这份教程中所做的事:

- 创建了一个开源的版本库

- 开始并且管理一个新的分支

- 对文件作出改变,并且提交了这些改变在GitHub中

- 打开和合并一个合并请求

查看你的GitHub的侧面板你会看到你的新的贡献广场

想学习更多关于合并请求的功能,我们推荐阅读GitHub流程指南,你也可以访问GitHub浏览加入到开源项目中。

    提示:可以查找我们其他的GuideYouTube Channel以及On-Demand Training来学习更多开启GitHub的方法

GitHub简单教程的更多相关文章

  1. Git和Github简单教程

    原文链接:Git和Github简单教程 网络上关于Git和GitHub的教程不少,但是这些教程有的命令太少不够用,有的命令太多,使得初期学习的时候需要额外花不少时间在一些当前用不到的命令上. 这篇文章 ...

  2. Git和Github简单教程(收藏)

    原文链接:Git和Github简单教程 目录: 零.Git是什么 一.Git的主要功能:版本控制 二.概览 三.Git for Windows软件安装 四.本地Git的使用 五.Github与Git的 ...

  3. Git和Github简单教程【转】

    转自:https://www.cnblogs.com/schaepher/p/5561193.html#clone 原文链接:Git和Github简单教程 网络上关于Git和GitHub的教程不少,但 ...

  4. 转:Git和Github简单教程

    转自:https://www.cnblogs.com/schaepher/p/5561193.html Git和Github简单教程   原文链接:Git和Github简单教程 网络上关于Git和Gi ...

  5. Git和Github简单教程(转)

    这篇文章只挑一部分命令来讲,差不多够用就行的程度.如果需要其他命令,到时候再去其他地方了解就行了先在Github上写好再搬过来的:本文Github链接 目录: 零.Git是什么 一.Git的主要功能: ...

  6. 如何使用github,简单教程

    前期准备:先行设置SSH KEY(请看我之前发的关于设置添加SSH的文章) 直接上命令: clone 已有仓库到身边的开发环境中 git clone git@github.com:<yourna ...

  7. GitHub 简单教程

    码农朋友们都知道,GitHub是一个面向开源及私有软件项目的托管平台,上面托管了众多的优秀的项目,比如Linux内核源码.Git源码.机器学习框架Tensorflow等等.当然,除了这些顶尖项目外,还 ...

  8. git和github使用教程

    看官请移步git和github简单教程, 本文是上述链接的截图,担心哪天作者不小心删除了,备一份在自己这里,仅为自己看着方便.侵权请告知

  9. github简单使用教程

    github是一个基于git的代码托管平台,付费用户可以建私人仓库,我们一般的免费用户只能使用公共仓库,也就是代码要公开.对于一般人来说公共仓库就已经足够了,而且我们也没多少代码来管理,O(∩_∩)O ...

随机推荐

  1. HTML 表格

    HTML 表格:表格由<table>标签来定义,行数由<tr>标签来定义,单元格由<td>标签来定义:<table border="1"& ...

  2. POS管理系统之出入库单分页查询

    JSP: <html>  <head>    <title>My JSP 'inOutKuPage.jsp' starting page</title> ...

  3. A taste of urllib3

    import urllib3 import certifi http = urllib3.PoolManager( cert_reqs='CERT_REQUIRED', # Force certifi ...

  4. Linux下Hadoop的简单安装

    Hadoop 的安装极为简单,一共只有三步:   安装JDK 安装Hadoop 配置Hadoop     1,安装JDK       下载JDK,ftp传到linux或者linux中下载     切换 ...

  5. htm5实现视差动画

    requestAnimationFrame.js window.requestAnimFrame = (function() { return window.requestAnimationFrame ...

  6. 当 IDENTITY_INSERT 设置为 OFF 时,不能向表 中的标识列插入显式值错误的解决方法

    一个主键.两个外键,把两个外键改为非空就行了. CREATE TABLE [dbo].[User_Compare]( ,) NOT NULL, [UserId] [int] NOT NULL, [Pa ...

  7. js中时间戳与日期转换-js日期操作

    常用的一些日期操作. 用js获取一个时间戳. <script type="text/javascript"> var date = new Date();//当前时间 ...

  8. 炫酷的CSS3发光搜索表单,附演示和源码

    原文:炫酷的CSS3发光搜索表单,附演示和源码 昨天在国外的论坛上逛的时候,看到一篇帖子是求助如何利用CSS3实现发光效果的,网友回复中有一个推荐了一款CSS3发光搜索表单,利用CSS3的动画属性,设 ...

  9. css常用居中

    对一个已知大小的元素上下左右居中(已知大小了,直接margin也就行了): css如下:.parent{height:100px;width:100px;background:grey;positio ...

  10. Jmeter转换成中文模式

    本片文章转至:https://blog.csdn.net/him2014/article/details/79603887 下载安装好Jmeter后默认的是英文,对于我这种学渣来说简直就是受到了100 ...