GitHub官方介绍

官方链接地址

http://guides.github.com/activities/hello-world/



Hello World 项目在计算机编程界是一项历史悠久的传统。当你开始学习一些新的东西时,这个项目是一项简单的练习。让我们开始用GitHub开始吧!

你可以学到怎样去做:

  • 创造并使用一个储存库
  • 开始并管理一个新的分支
  • 对一个文件进行改动并且把他们推送到GitHub作为提交
  • 打开并合并一个提取请求

什么是GitHub?

GitHub是一个版本控制和协作的代码管理平台。它可以让你和他人在任何地点一起进行项目工作。

此教程教你GitHub的基本要点,例如储存库,分支,提交,提取请求。你将会创造你自己的Hello World储存库,并且学习GitHub’s提取请求工作流程。这个工作流程是一种创造和审查代码的流行方式。

不需要写代码

为了完成这个教程,你需要一个GitHub.com 的账户和因特网通道。你不必知道怎样编程,使用命令行或者安装Git(GitHub基于的版本控制软件)。

提示:在一个单独的浏览窗口或者选项卡中打开本指南,以便当你在完成本教程中的步骤时你可以看见它。

步骤 1. 创建一个储存库



一个储存库通常被用来组织一个单独的项目。存储库可以包含文件夹和文件,图片,视频,电子表格,和数据集合——你的项目的任何东西。我们建议包含一个README(说明档案),或者包含关于你项目信息的文件。同时GitHub使得你创建你的新储存库变得容易。它也提供其它普通的选项例如一个授权文件。

你的hello-world储存库可以存放你的想法,资料,甚至是你和他人分享和讨论的东西。

去创建一个新的储存库

1.在右上角,临近你的名字,点击 + 号并且然后点击New Repository.

2.把你的仓库命名为hello world.

3.撰写一个简短的介绍。

4.挑选Intialize this repository with a README(用一个说明档案初始化这个存储库)

点击Create repository(创建储存库) :tada:

步骤 2.创建一个分支

分支是在同一时间内能工作在一个储存库中的不同版本上的方法。

你的储存库中有一个名字为master的分支,此分支默认为决定性的分支。在提给master之前,我们使用分支来试验和编辑。

当你创建一个分支与master分支分开时,你正在进行拷贝或者说是复制master在那个时间点。当你正工作在你的分支时,别人对master分支进行改动,你可以提取这些更新。

这个示意图说明了以下几点:

  • 主分支
  • 一个被叫做feature的新分支(因为在这个分支上我们正在进行‘特别工作’)
  • feature被合并到master之前它所走过的旅行路线

你曾保存过一个文件的不同版本吗?就像:

  • story.txt
  • story-jop-edit.txt
  • story-joe-edit-reviewed.txt

在GitHub的储存库中,分支完成相似的任务。

在GitHub,我们的发明者,作者和设计师都在用分支来进行bug修复和重要的工作,这些分支从我们的master分支中分离出来。当一项改动准备好时,他们把分支合并到master中。

来创建一个新的分支

1.来到你的新的hello world储存库。

2.点击顶端文件(master)的下拉菜单

3.敲写分支的名字,readme-edits,进入新的分支文件盒子。

4.选择蓝色的Create branch盒子 或者在你的键盘上点击“Enter”。

现在你拥有了两条分支,masterreadme-edits.它们看起来完全一样,但是不会太久的!

步骤3.作出改动并且提交

好极了!现在,为你的readme-edit分支(master的副本),你正在代码视图上。让我们来做些编辑工作吧。

在GitHub,保存改动被称为提交。每项提交都有一个相关联的信息。这个信息是一个说明,用来阐述为什么要进行特殊的改动。提交信息捕获你的改动历史,以便其他的合作者可以明白你改动的东西和目的。

作出改动并且提交

  1. 点击README.md文件。
  2. 在文件视野的右上角点击铅笔图标进行编辑。
  3. 在编辑器中,写一点关于你自己的东西。
  4. 点击Commit changes 按钮。

    这些改动将仅仅会在你的readme-edits分支中的文件中出现,因此现在这个分支中的内容不同于master

步骤 4.开启一个提取请求

漂亮的编辑!现在你在master的分离的分支上作出改动了,你可以开启一个提取请求。

在HitHub中提取请求是合作的核心。当你开启一个提取请求,表明你正在提议你的更改并且请求某人审查并提取你的贡献内容,同时把你的贡献内容合并到他们的分支上。这些改动,添加和删除会被用绿色和红色显示。

一旦你做出提交,你就可以开启一个提取请求和开始一场讨论,甚至可以在代码完成之前。

通过使用在你的提取请求GitHub的[@mention system](http://help.github.com/articles/about-writing-and-formatting-on-github/#text-formatting-toolbar 通知栏,你可以要求某个具体的人或者团队的反馈,无论他们是在大厅还是相隔10个时区的地方。

你甚至可以在你的个人储存库开启提取请求,并且亲自把它们合并。在学习更大的项目之前,下面是一种很棒的学习GitHub的方法。

为了修改README文件而开启一个提取请求

*点击图片可以获得更大的版本

步骤 屏幕截图
点击Pull Requst 标签,然后从提交请求页面点击绿色的New pull request按钮
选择你创建的分支,readme-edits,和master分支比较
检查你在不同版本间的改动,确它们就是你想要提交的东西
当你对你想要提交的内容感到满意时,点击那个大的绿色的Creat Pull Request按钮
给你的提交请求起个名字,并且为你的改动写一个简短的说明

当你完成你的信息表时,点击Create pull request!

提示:你可以在评论区和提交请求区使用[表情包](http://help.github.com/articles/basic-writing-and-formatting-syntax/#using-emoji 和拖拽图片和动画图片

步骤 5.合并你的提交请求

1.在最后一步,是时候把你的改动整合起来——把你的readme edits分支合并到master分支中。

2.点击Confirm merge

3.继续, 因为改动已经被合并了,所以可以用在紫色框中的Delete branch按钮删除分支。

庆祝吧!

通过完成此教程,你已经学会了如何在GitHub中创建一个项目并且提交一项请求。

这里是你在此教程中完成的东西:

  • 创建并打源储存库
  • 开始并管理一个新的分支
  • 改动一个文件并且提交这些改动给GitHub
  • 开启并合并一个提取请求

看一眼你的GitHub配置文件,你将会看到你的新[contribution squares](http://https://help.github.com/articles/viewing-contributions !

如果你想学习更多关于提取请求命令,我们建议你阅读GitHub Flow Guide.

你也可以访问GitHub Explore和参与一个新的开源项目:octocat:

提示: 查看我们其他的Guides和[YouTube Channel](http://http://youtube.com/githubguides 来学习更多的GitHub 新手入门知识!

最后跟新于2016年2月。

2016-03-10 23:51:58 星期四

来自为知笔记(Wiz)

时间: 2024-08-06 08:36:30

GitHub官方介绍的相关文章

Github入门级介绍

Github入门级介绍 一.  简介 1.基本功能 作为开源代码库以及版本控制系统,Github拥有超过900万开发者用户.随着越来越多的应用程序转移到了云上,Github已经成为了管理软件开发以及发现已有代码的首选方法. 在GitHub,用户可以十分轻易地找到海量的开源代码. 二.  注册 1.  登录 https://github.com/ ,点击右上角的注册按钮,输入自己用户名.邮箱.密码等等. 2.  验证码,需要把一个小狗摆正 3.  选择免费/付费账号 一般选择免费,上传的代码会公开

GitHub Desktop for Mac(Github官方桌面客户端) v2.2.4

哪里有Github官方桌面客户端?GitHub Desktop for Mac是mac上一款功能强大的github客户端工具,可以帮助您以更直观和简化的方式连接到您的github帐户并管理您的存储库和其他相关活动,而且github Desktop附带一个设置助手,可帮助您输入github凭据并自动填充Git配置.这样您就可以在几分钟内开始编码.感兴趣的朋友们可以尝试下载使用哦! Github官方桌面客户端 https://www.macdown.com/mac/4687.html 属性可以轻松地

OkHttp使用进阶 译自OkHttp Github官方教程

没有使用过OkHttp的,可以先看OkHttp使用介绍 英文版原版地址 Recipes · square/okhttp Wiki 同步get 下载一个文件,打印他的响应头,以string形式打印响应体.响应体的 string() 方法对于小文档来说十分方便.高效.但是如果响应体太大(超过1MB),应避免适应 string()方法 ,因为他会将把整个文档加载到内存中.对于超过1MB的响应body,应使用流的方式来处理body. private final OkHttpClient client =

Github官方app分析——用户身份验证模块

这篇文章记述的是我对Giuhub官方app的用户身份验证模块的分析. Giuhub的官方app虽然是一个非常小众的程序,但是从程序的设计的角度看,这是一个非常优秀的项目.对于其用户身份验证模块,给我留下的印象更是非常深刻.如果你对此有兴趣,请移步到我的blog,地址如下: 地址: http://kohoh1992.github.io/GithubAppAccountAuthenticatorAnalysis/ 哦,对了.忘记补充了,这里的文章全部都是我个人blog上的副本.如果你对我的blog有

GitHub官方Markdown语法教程

说明:Markdown随着编译器不一样,语法也都不一样,但这份GitHub提供的官方教程,基本学会这份就够了. https://guides.github.com/features/mastering-markdown/ https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf 原文地址:https://www.cnblogs.com/EasonJim/p/8463510.html

【杨镇】【中译修订版】以太坊的分片技术官方介绍

杨镇,资深软件架构师,资深开发工程师.以太坊技术爱好者与布道者. 是Solidity官方文档中译项目的重要贡献者,以太坊Homestead官方文档中文版译者,并对以太坊黄皮书中文版.Thunder共识白皮书中文版进行了独立校订.目前致力于以太坊技术推广及智能合约开发.安全审计方向. 原文链接:    https://github.com/ethereum/sharding/blob/develop/docs/doc.md 作者: Vitalik 序言 本文的目的是为那些希望理解分片建议详情,乃至

git和github -1 介绍

1. git — 工具,版本控制 作用:回到过去的状态.找回丢失的内容.多人协作开发( 解决冲突 ).查看历史记录等 2. github — 网站,社交平台,开源项目,远程仓库 ( 例:可直接修改代码,然后请求合并 ) 优点:a. 强大啊的协作 b. 减少冲突 c. 最大的源码开放平台 d. 更多知识和工具

nuget的Rnet官方介绍文档

http://rdotnet.codeplex.com/documentation?referringTitle=Home 本页基于Rnet1.5.13版本.其实1.5.12也一样的. Rnet使得net环境可以用R语言交互.Rnet需要net4和R环境的Rdlls.随便使用哪种语言吧.研究本文档之前,几件事情:F#最好用这个:https://github.com/BlueMountainCapital/FSharpRProvider 设置 一个列表,Rnet运行的程序准备: 对于1.5.10:

rxjava-android 官方介绍

RxAndroid: Reactive Extensions for Android Android specific bindings for RxJava. This module adds the minimum最小量的 classes to RxJava that make writing reactive components组件 in Android applications easy and hassle-free省事. More specifically, it provides