[个人翻译]GitHub指导文件(GitHub Guides[Hello World])

[个人翻译]GitHub指导文件(GitHub Guides[Hello World])

Mirage_j个人翻译,欢迎转载,最好标明出处http://www.cnblogs.com/mirageJ/

原文地址https://guides.github.com/activities/hello-world/

Hello World是电脑编程史上悠久而又传统的工程。学习新事物时我们通常会以这个简单的小程序作为开始。我们就以此为开头了解GitHub吧!

通过这篇指导,你会学到如何

  • 建立并使用repository代码库
  • 开始和管理新的branch代码分支
  • 对文件进行修改并上传到GitHub进行commits确认存档
  • 开始和融合一个pull request拉入请求

什么是GitHub?

GitHub是一个为版本管理和协同工作而生的代码管理平台。在这里,你可以和世界各地与你志同道合的人一起实现或完成各种工程。

这篇指导将引导你学习了解GitHub的各种元素,包括:repository代码库branch代码分支commits确认存档pull request拉入请求。Pull Request是GitHub上一种非常流行的用来构建和检阅代码的方法,让我们从建立你自己的Hello World代码库来开始学习Pull Request的工作流程吧。

不需要敲代码

想要学习怎么使用GitHub,你得先注册一个GitHub账号(当然你还得能上网)。你甚至不需要知道怎么编程、怎么使用命令行、或者安装Git(一个建立GitHub的版本管理软件)。

Tip:你最好用新标签页打开这个页面,这样你就可以一边学习一边动手实践了

第一步:建立一个Repository

单个Repository经常用来管理单个工程。任何你的工程需要的东西——包括一堆文件夹、各种文件、图片、视频、表格和数据库,都可以扔进Repositories里。我们建议你的Repository里能包含一份README说明文档,或者一个写着你工程信息的文件。你可以很方便地在建立新的Repository的时候加入README或者工程信息,以及别的常用选项如证书文件。

建立一个hello-world Repository吧,你可以在里面存放你的想法,各种资源,进行分享以及与他人进行讨论。

建立一个新的Repository

  1. GitHub页面的右上角,你头像或者账号的下方,点+后选择New repository
  2. 给你的Repository取名为hello-world
  3. 随便写点描述
  4. 勾上Initialize this repository with a README.带上说明文件来初始化你的Repository

点击Creat repository,搞定!

第二步:建立一个Branch

Branching代码分支是一种对同一Repository的不同版本同时工作的方法。 Repository默认自带一个叫 master 的Branch,这个Branch是作为你工程的最终版本而存在的(或者正式版本)。我们利用多个Branch对工程进行试验和编辑,直到你把它确认到 master 。

当你在 master branch的下面建立一个新的branch时,你就等于复制了一个master branch,或者说是做了master在这个时间节点的快照。如果在你在自己的branch上工作的时候,有别人对master进行了修改,你可以将那些修改直接加进来。

下面这个图表展现了:

  • master branch
  • 一个叫feature的branch(因为我们通常都在这个branch上面做“feature work(实现功能)”的工作)
  • feature在融合进master之前经过的旅程

你有没有保存过一个文件的不同版本?像这种:

  • 一个故事.txt
  • 一个故事(老李修订版).txt
  • 一个故事(老李修订版-已审核).txt

Branch做的事情和上面的差不多,不过它是在Repository里面做的而已

在GitHub里面,开发者、写手、设计师用branch来为 master 修复bug和增加功能。当一个修改可以确认完成了,我们就把这些branch把融入到 master 里去

建立一个新branch

  1. 进入你的 hello-world Repository
  2. 点击下拉菜单,就在文件列表的上方,写着 branch:maser 那里
  3. 把要新建的branch的名字,如 readme-edits ,输到文本框里
  4. 按蓝色的 Create branch 或者按回车

现在你就有两个branch: master 和readme-edits 了,现在它们还完全一样,但是不会持续很久。接下来我们对新的branch做点修改

第三步:提出并确认修改

很好!现在你看到的是readme-edits的代码管理页,这个完全是复制 master的,让我们来对它进行点改动

在GitHub上,保存修改被称作 commits确认 。每个commit都带着一个确认消息,这条确认消息告诉大家为什么会进行这个修改,或者这个修改的具体描述。确认信息紧随着修改的历史记录,这样别的合作者就会知道你做了些什么以及你为什么这样做。

提出并确认修改

  1. 点击README.md文件
  2. 点击铅笔图标,它在编辑页面的右上角
  3. 在编辑栏里写些什么,可以是关于你自己
  4. 写下确认消息来描述你做的修改
  5. 点击 Commit changes 按钮

这些你做的修改都会在 readme-edits branch上保存,现在 readme-edits 就和 master 不一样了

第四部:开启一个Pull Request

干得好!你已经在 master 下做了修改了,现在你可以开启一个Pull Request

Pull Request是GitHub协同工作的核心。当你开启一个Pull Request,你就是提出你做的修改并告诉别人:来查阅你的修改,然后将你做的贡献拉到他们的branch里去。Pull Request展示了双方branch里的不同。这些修改、增加与删减会以绿色和红色进行区分

当你完成commit的同时,你可以开启一个Pull Request然后开始进行讨论,这甚至可以在代码完成之前就进行

你可以在你的pull request消息里使用GitHub’s @mention system,通过它向特定的人或者团队请求反馈,不管这些人就住在你楼下或者现在处在地球的另一边

你现在就可以在你自己的Repository里开启你的pull request并且自己把它们融合到你的Repository里,这是一种在很好的学习方法,可以帮助你提前了解GitHub里参与大型工程的流程。

为README的修改开启一个Pull Request

  • 点击Pull Request便签页,在打开的页面里点击绿色的New pull request按钮
  • 选择你刚刚生成的readme-editsbranch来和原始的master进行比较
  • 在这个对比页面里,你可以看到两个branch有什么不同,确保这些改动是你想确认保存的
  • 如果觉得这些改动可以提交了,点击那个巨大的绿色按钮Create Pull Request
  • 给你的pull request取个名字吧!你还可以大概地描述一下你做的改动

当你搞定这些东西之后,按Create pull request!

Tip:你还可以把emoji表情和图片拉到说明和Pull Request上

第五步:融合你的Pull Request

终于到最后一步了,是时候把你做的改动都放在一起了——将你的 readme-edits branch融入到 master branch里去

  1. 点击那个绿色的Merge pull request来把你做的改动融合到 master 里去
  2. 点击Confirm merge
  3. 让我们深入一点,学会怎么删除branch。既然这些改动已经被包含到 mater 了,那我们就可以按紫色方框里的Delete branch按钮删除掉之前的 readme-edits 了

恭喜!

你已经完成这篇教程了,也就是说你已经知道怎么在GitHub上面创建一项工程并开启Pull Request了

你在这篇教程里干了这些事情:

- 建立了一个开源的Repository代码库

- 建立了一个全新的branch代码分支并且学会怎么管理它

- 对一个文件进行改动,并且在GitHub上确认保存

- 开启Pull Request拉入请求并且将它融合到别的代码里去

你可以看一眼你的GitHub上的个人中心,你会发现你有一个新的贡献广场contribution squares

你可以在这里GitHub Flow Guide继续学习Pull Request。你也可以去访问 GitHub Explore和投身到一项开源项目里去。

Tip:想要更多地了解GitHub?看下http://guides.github.com/http://youtube.com/githubguides 和https://services.github.com/on-demand/吧。

时间: 2024-12-28 21:05:04

[个人翻译]GitHub指导文件(GitHub Guides[Hello World])的相关文章

转载:删除github上文件夹的两种方式

http://www.jianshu.com/p/286be61bb9b8 删除github上文件夹的两种方式(解决已经加入ignore的文件夹无法从远程仓库删除的问题) 如果此文件夹已被加入git追踪,那么删除方法很简单,只需要将此文件夹删掉,然后提交一下就可以了如果次文件夹曾经被加入过git追踪,现在被加入.gitignore里了,但是github上还有此文件夹.对于这种情况,稍微有点复杂,因为已经加入.gitignore的文件或文件夹,无法对其进行提交了,哪怕是将其删除,都无法提交.我们用

【Github教程】史上最全github用法:github入门到精通

原文 http://www.eoeandroid.com/thread-274556-1-1.html [初识Github] 首先让我们大家一起喊一句"Hello Github".YEAH!就是这样. Git是一个分布式的版本号控制系统,最初由Linus Torvalds编写,用作Linux内核代码的管理.在推出后,Git在其他项目中也取得了非常大成功,尤其是在Ruby社区中.眼下,包含Rubinius和Merb在内的非常多知名项目都使用了Git.Git相同能够被诸如Capistran

github学习:如何从本地把项目上传到github&&如何把github项目通过clone复制下来,详细教程

一.第一步---注册一个Github账号 首先要在GitHub上创建一个帐号,可以去官方网站注册一个账号. 前提:本地安装一个git 本人github:https://github.com/saucxs 二.git安装 下载地址:http://msysgit.github.io/ 二.第二步---生成私钥和秘钥 由于本地Git仓库和GitHub仓库之间的传输是通过SSH加密的,所以要在本地生成一个私钥和一个密钥 1.本地创建ssh key $ ssh-keygen -t rsa -C "[ema

我的github地址 https://github.com/1010de/Test.git

构建之法老师叫交下任务学习github,经过一段时间的学习和了解,看介绍.看视频.看博客.初步认识到github的方便与好处. 自己试着去注册和使用github,已经慢慢学会了一些基本操作. 小结 至此,你该对 Git 有了点基本认识,包括它和以前你使用的 CVCS 之间的差别.现在,在你的系统上应该已经装好了 Git,设置了自己的名字和电邮.接下来让我们继续学习 Git 的基础知识. 我的github地址   https://github.com/1010de/Test.git (计科13-1

Linux 小知识翻译 - 「/proc 文件夹」

这次聊聊 「/proc 文件夹」. /proc 文件夹用来保管系统状态相关的文件的特殊文件夹,这个文件夹中有的文件只是内存上的虚拟文件. /proc 文件夹下有些文件可以反映各个进程的运行状态.所以说是决定Linux运行的非常重要的文件夹. 通过这个文件夹下文件,可以获取各式各样的信息.比如,请在命令行下输入「cat /proc/cpuinfo」试试看.可以获得CPU的信息. 其它还可以获得内存信息,驱动信息,以及其它软硬件方面的各种信息. 因此,修改 /proc 文件夹下的文件,可以调整系统的

怎么翻译整个PDF文件

在办公或者学习的时候总会遇到大篇幅的英文文件,查起来又不方便,自己阅读又很艰难,那如何去解决翻译PDF文件的这一问题呢,请让小编来为大家整理翻译过程,仔细看哦.操作工具:[迅捷PDF转换器]1:打开电脑后,进入浏览器搜索关键词迅捷PDF在线转换器.2:进入转换器后,点开导航栏上第三个文档处理,将会弹出下拉框,我们在下拉框内找到PDF在线翻译.3:点开在线翻译后,点击选择文件加入需要进行翻译的文件,也可以直接拖动文件添加.4:添加完需要翻译的PDF文件,设置需要翻译成哪国的语言后,点击开始翻译.5

GitHub 指导手册之第一个项目 Hello World

翻译的第一篇文章,翻译得不好,欢迎大家提修改意见.(另外还没翻完,后面修改后继续翻...) 原文地址:https://guides.github.com/activities/hello-world/ 在计算机程序设计领域,Hello World算是老字号示例了.每当学一个新东西的时候,我们都可以通过Hello World来获得简单的练习.下面我们开始学习GitHub的Hello World吧! GitHub是一个项目托管和协作的平台.你不用担心硬盘上的数据丢失,也不用费时间在不同计算机上同步以

Github忽略文件设置经验

有很多文件不必使用git管理.例如Eclipse或其他IDE生成的项目文件,编译生成的各种目标或临时文件等.使用git status时,会在Untracked files里面看到这些文件列表,在一次需要添加的文件比较多时(使用git add . / git add -u),会把这些所有的未跟踪文件添加进索引. ============一些牢骚============ 于是自然想要告诉git把这些文件忽略,我们当然会想到去Google,输入本文标题这个关键字(一部分人会直接去看document),

git与github的文件推送

第一步:安装git 一切next完成之后 回到我们桌面 点击右键 出现了下图的两个图标 说明安装成功了 第二步:点击我们的git Bash Here 进入命令行 完成一下我们的配置 git config --global user.name"你的用户名" git config --global user.email"你的邮箱号" 设置好后 可以通过命令git config -l (这是字母l)查看我们刚才设置的参数 第三步:创建版本库  可以在你的电脑任何创建一个文