github指南

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

"HEllO WORLD"工程是计算机编程的一个历史悠久的传统。它是当你在学习新知识的一个简单练习。让我们开始使用github吧!

你将学习:
创建并使用一个存储器
启动和管理一个新分支
对文件做改动并把它们当成任务存进github
打开并连接一个牵引请求




什么是github?
github是一个为了版本控制和合作的代码托管平台。它让你随时随地和其他人合作。
这个指南教你github的基本技能,例如贮藏室、分支、任务、牵引请求。你将创建你自己的HelloWorld存储器,并且学习github
流行的创建和检查代码的牵引请求工作流。


没有必要的代码
为了完成这个指南,你需要一个github.com的账号和互联网接入。
你不需要知道怎么写代码、使用命令行、或者安装Git(Github基于的版本控制软件)
提示:在分开的浏览器打开这个指南,以便于你能完成以下的步骤,同时也能看着这份指南


步骤一:创建一个存储器
 一个存储器通常用来组织一个单一的项目。存储器可以包含文件夹、文件、图片、音频、电子表格、数据集等你项目需要的东西。
我们推荐包含一个自述文档或者带有你项目信息的文档。Github让创建新的存储器的同时增加另一个存储器变的很容易。同时它也
提供了其它常用的选项,比如一个许可文件。
你的Hello-world存储器可以是你存储想法、资源、甚至是和其他人分享和讨论的地方。


创建一个新的存储器
1.在右上角,在你的用户名旁边,点击“+”然后点击“新建存储器(New repository)”
2.为你的存储器命名“hello-world”
3.写一个简短的描述
4.选择用一个自述文件来初始化这个存储器“Initialize this responsitory with a README”,点击“create responsitory”




步骤二:创建一个分支
分支是同时在一个存储器的不同版本工作的一种方式。
默认情况下,你的存储器有一个叫“master”的被认为是明确(决定性的,最后的)的分支。在提交到master之前,
我们用分支来做实验和编辑。
当你在master下创建一个分支,你相当于是在复制,或者是一个快照,因为这就是那个时候的master。
如果别的人在你用你的分支的时候对master分支做了改变,你可以加上那些改动。


这个图展示了:
主分支
一个名叫feature的新分支
“feature”分支在融合进“master”之前覆盖的行程


你曾经保存过同一个文件的不同版本吗?例如:
story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
分支在存储器里面完成相似的目标


在Github这里,我们的开发者、作家、和设计者用分支来保存漏洞修复和特别的工作,并把它们和master分开。它一个改变准备
发生,他们把其分支合并到master里。




产生一个新分支
1.去你的新存储器“hello-world”
2.点击在下拉列表顶部的“branch:master”文件
3.输入新分支的名字“readme-edits”进入新分支的文本框。
4.选择蓝色的“create branch”或者在键盘上按下“Enter”键
现在你有了连个分支“master”和“readme-edits”.它们看起来几乎一样,但这只是短时间的。
接下来我们会在新分支里增加一些变化。




步骤三:制作和提交修改
好极了!现在,你现在在“readme-edits”分支同时也是master的一个复制的代码视图下。让我们做一些编辑。


在Github,保存改变都叫“commits”(提交)。每一次提交都有相关的描述为什么要做一个特别的改变的信息。
提交信息记录了你的修改记录,所以其他贡献者可以明白你做了什么改动和你为什么要这样做。


创建并提交修改
1.点击“README.md”文件
2.在文件的右上角点击铅笔图标来编辑
3.在编辑器写一些关于你自己的信息
4.写一个描述你的修改的提交信息
5.点击“Commit changes”按钮
这些改变将只会在“readme-edits”分支的“README”文件下被修改,所以这个文件包含不同于master的内容




步骤四:打开一个牵引请求
编辑的好!现在你有一个在master下的分支被修改了,你可以打开牵引请求
牵引请求是在Github合作的核心。当你打开一个牵引请求,表示你建议和请求别人查看你的修改同时合并到他们的分支,
加进你的贡献。牵引请求显示了从两个分支里内容的差异。修改、编辑、删减的内容将以绿色和红色字体显示。


一旦你做了修改,你可以打开一个牵引请求然后开始一个讨论,甚至在代码完成之前。


通过在你的牵引请求中使用Github的@mention system,你可以要求从特定的人或者团队中获得返馈,不论他们在楼下大厅或者
在十倍距离那么远。


你甚至可以在你自己的存储器中打开牵引请求然后你自己合并它们。这是在更大的团队工作之前学习Github流程的好方法。
打开一个牵引请求对README的修改
点击图片建立一个更大的版本。步骤如下:
1.点击“Pull Request”,然后从Pull Request 页面点击绿色的“New pull request”按钮
2.选择你建立的“readme-edits”分支,来和master比较
3.检查在比较页面上的微小差异,确保它们是你想提交的。
4.当你满意这就是你想提交的,点击大的绿色按钮“Create Pull Request”
5.给你的牵引请求一个题目然后写一个简短的对你的修改的描述
当你完成了你的描述,点击“Create pull request”!
提示:你可以用emoj和拖拉照片和gifs在评论区和牵引请求。




步骤五:合并你的牵引请求
在最后一步,是时候把你的修改合并到一起了---合并“readme-edits”分支到“master”
1.点击绿色按钮“Merge pull request”来把修改合并
2.点击“Confirm merge”
3.点击紫色框“Delete branch”删除分支,因为它的改变已经被合并了


祝贺!
通过完成这个指南,你已经学会在Github上创建项目和牵引请求了。
这是你在这个指南里完成的:
1.创建一个开源存储器
2.创建和管理一个分支
3.改变一个文件和提交修改到Github
4.创建和合并一个牵引请求
查看你的Github文件你就会看到你的贡献区域
如果你想学习更多有关牵引请求的力量,我们推荐你阅读“Github Flow Guide”,你也可以
去 “GitHub Explore”参与到一个开源项目。
提示:查看我们其他的指南和YouTube频道来获取更多的用户指南 
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值