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”。
现在你拥有了两条分支,master
和readme-edits
.它们看起来完全一样,但是不会太久的!
步骤3.作出改动并且提交
好极了!现在,为你的readme-edit
分支(master
的副本),你正在代码视图上。让我们来做些编辑工作吧。
在GitHub,保存改动被称为提交。每项提交都有一个相关联的信息。这个信息是一个说明,用来阐述为什么要进行特殊的改动。提交信息捕获你的改动历史,以便其他的合作者可以明白你改动的东西和目的。
作出改动并且提交
- 点击
README.md
文件。 - 在文件视野的右上角点击铅笔图标进行编辑。
- 在编辑器中,写一点关于你自己的东西。
- 点击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 星期四
GitHub官方介绍(中文翻译)的更多相关文章
- 撒花!中文翻译仓库链接已加入 ML.NET 官方示例网站首页
从2018年12月02日决定开始做ML.NET 示例中文版https://github.com/feiyun0112/machinelearning-samples.zh-cn,然后以每天一篇的速度进 ...
- Umbraco官方技术文档 中文翻译
Umbraco 官方技术文档中文翻译 http://blog.csdn.net/u014183619/article/details/51919973 http://www.cnblogs.com/m ...
- Go 语言官方包函数中文翻译
Go官方包函数中文翻译 *** import "strings" func Join(a []string, sep string) string Join concatenate ...
- Python 3.10 版本采纳了首个 PEP,中文翻译即将推出
现在距离 Python 3.9.0 的最终版本还有 3 个月,官方公布的时间线是: 3.9.0 beta 4: Monday, 2020-06-29 3.9.0 beta 5: Monday, 202 ...
- Objective-C 编程艺术 (Zen and the Art of the Objective-C Craftsmanship 中文翻译)
# 禅与 Objective-C 编程艺术 (Zen and the Art of the Objective-C Craftsmanship 中文翻译) - 原文 <https://githu ...
- Xcode9新特性介绍-中文篇
背景: Xcode 9 新特性介绍: 1.官方原文介绍链接 2.Xcode9 be ta 2 官方下载链接 本文为官方介绍翻译而来,布局排版等都是按照官方布局来的. 与原文相比,排版上基本还是熟悉的配 ...
- Next.js v4.1.4 文档中文翻译【转载】
最近想稍稍看下 React的 SSR框架 Next.js,因为不想看二手资料, 所以自己跑到 Github上看,Next.js的文档是英文的,看倒是大概也能看得懂, 但有些地方不太确定,而且英文看着毕 ...
- [中文翻译] ASP.NET 5 简介(Introducing ASP.NET 5,原作ScottGu 2015/2/23)
本文出处 [中文翻译] ASP.NET 5 简介(Introducing ASP.NET 5,原作ScottGu 2015/2/23) 这是我的文章备份 http://www.dotblogs.co ...
- Cassandra官方介绍及安装
Cassandra官方介绍及安装 这个数据库有很高的伸缩性和可用性,你完全不需要向性能妥协.在硬件或者云设施上做修改 官网:Cassandra官网 一.简介 cassandra这个数据库有很高的伸缩性 ...
随机推荐
- java中的枚举类型
枚举类型是那些字段由一组固定常量组成的类型.常见的例子有:东南西北四个方向,星期几等. 所有枚举类型都隐式继承java.lang.Enum类型,因为java不支持多重继承,所以枚举不能继承其他任何类. ...
- Linux终端更改提示符
打开~/.bashrc可以看到命令提示的内容为:\u@\h\w\$ \u表示用户名,\h表示主机名,\w表示当前目录,\$表示命令提示符(普通用户$,超级用户#) 这个命令提示符有点长,很碍事,\u@ ...
- model 的验证
Ext.onReady(function(){ Ext.define('User', { extend: 'Ext.data.Model', fields: [ { name: 'name', typ ...
- Mac 下,配置SVN
Mac 环境下 sv 服务器的配置 本文目录 • 一.创建代码仓库,用来存储客户端所上传的代码 • 二.配置svn的用户权限 • 三.使用svn客户端功能 在Windows环境中,我们一般使用Tort ...
- 【URAL 1297】Palindrome 最长回文子串
模板题,,,模板打错查了1h+QAQ #include<cmath> #include<cstdio> #include<cstring> #include< ...
- 【BZOJ 3050】【USACO2013 Jan】Seating 线段树
线段树维护4个标记, 昨天互测时题意理解错了,今天上午才发现. #include<cstdio> #include<cstring> #include<algorithm ...
- 51nod 1013快速幂 + 费马小定理
http://www.51nod.com/onlineJudge/questionCode.html#!problemId=1013 这是一个等比数列,所以先用求和公式,然后和3^(n+1)有关,有n ...
- GridView多表关联
有些时候,需要多表关联查询,使用SqlDataProvider比较灵活 Controller中 use yii\data\SqlDataProvider; $dataProvider = new Sq ...
- Extract Fasta Sequences Sub Sets by position
cut -d " " -f 1 sequences.fa | tr -s "\n" "\t"| sed -s 's/>/\n/g' & ...
- js-JavaScript高级程序设计学习笔记13
第十五章 canvas绘图 1.WebGL是针对Canvas的3D上下文. 2.类型化数组 WebGL涉及的复杂计算需要提前知道数值的精度,而标准的JS数值无法满足需求.因此WebGL引入了一个概念, ...