美文网首页
翻译Git Hub 之 Read the Guid

翻译Git Hub 之 Read the Guid

作者: oneYing | 来源:发表于2016-09-24 00:02 被阅读124次

    打开GitHub,我们首先看到的是这样

    其中Read the guide,是GitHub的一个简单指南。以下是我对该指南的翻译。

    ———————————————— 分割线 ——————————————————

    何为GitHub?

    GitHub是一个提供了版本控制与相互协作的平台。可以使你和来自世界各地的人一起来开发工程。

    本指南将说明GitHub上诸如资源库、分支、commits以及pull requests等基本功能.你可以先创建一个 Hello World 的repository资源库并以此来学习GitHub的 Pull Request 的使用流程,这是用来创建、审核代码的一种常见方式。

    不需要你懂得编码

    你需要拥有GitHub.com的账号及网络来学习本指南。你不需要懂得如何编码、使用命令行或者安装Git(GitHub上已预置版本控制软件)。

    提示:在单独创建的浏览器窗口来打开本指南,以便能够观察到在完成指南中的步骤后的效果。

    第一步:创建repository(资源库)

    repository(资源库)是用来组建一个单独的工程的。它包含文件夹、图片、视频、表格和数据——工程所需要的任何东西。我们建议其中应包含一份 README 或其他文件来描述你的工程。GitHub在创建新的repository(资源库)时可以很轻松的添加该描述文件。也能够提供其他的选项比如使用证书。

    你的hello-world资源库可以可以用来存放想法、资源或者与他人共享、讨论一些东西。

    如何创建资源库

    1、点击页面右上角头像旁边的+,选择 New repository.

    2、将资源库命名为hello-world.

    3、填写一个简短的描述

    4、勾选 Initialize this repository with a README.

    点击Create repository.

    第二步:创建一个分支

    branch(分支)用来同时操作一个资源库的不同版本。

    资源库有一个默认的分支,称之 master,被称作主干。我们可以在分支上进行测试

    及编辑,而后将其合并到 master.

    当你在 master 主干创建分支时,可以理解为是给在那一刻的 master 主干做了一份拷贝或者快照。如果有人在 master 主干做了改动而此时你是在自己的分支上工作,那么你可以把这些改动拉到分支上。

    下表将讲述:

    ·master主干

    ·一个名为feature(特色)的新分支(因为我们会在该分支做“有特色的工作”)

    ·feature分支在被合并到master主干之前的历程

    你是否有过将一个文件分成不同版本保存的经历呢?就像这样:

    ·story.text

    ·story-joe-edit.txt

    ·story-joe-edit-reviewed.txt

    GitHub资源库里的分支功能可以完成相类似的工作。

    在GitHub上,开发者、作家和设计师利用分支将修复bug及特殊工作从主干上剥离出来。

    一旦更改工作完成,即可将分支合并到主干。

    创建一个分支

    1.打开你的hello-world资源库

    2.单击branch:master 按钮的下拉菜单的顶部

    3.输入分支名称 —— readme-edits

    4.选中蓝色的 Create branch 选项框或者直接按回车键

    现在你就有了两个分支 master 和 readme-edits.它们是完全一样的,但这只是暂时的。下一步我们会把一些改动添加到新分支中。

    第三步:改动并提交

    现在,我们处于 readme-edits分支的 code 视图——这就是对master主干的一份拷贝。我们来做一些编辑工作。

    在GitHub上,把保存改动叫做commits(提交)。每一次提交都有一份与之相关联的提交备注用来描述本次的改动。提交备注记录你的改动历史,所以第一位贡献者都能够了解你第次改动都做了什么,为什么这样做。

    改动并提交

    1.单击README.md 文件

    2.单击位于文件神力右上角的钢笔图标进行编辑

    3.在编辑框写一些关于你自己的一些信息

    4.编写关于本次改动的提交注释

    5.单击Commit changes 按钮

    这仅仅是对你的readme-edits分支中的README文件做的改动,所以现在该分支里的内容跟master分支就不一样了。

    第四步:打开一个 Pull Request

    现在你脱离开master主干,在一个分支上做了些改动,你可以找打开一个pull request.

    在GitHub上,Pull Request是多人协作的核心。当你打开一个pull request时,你是在提交你所做的改动和请求,然后对方会审核、引用你的贡献并把它们合并到他的的分支中。Pull requests会显示两个分支中内容的不同之处。改动、新增及删减的内容会以绿色各红色显示。

    一旦你做了提交,就应该打开pull  request并进行讨论,即使代码还未完全完成。

    通过在 pull request备注中使用GigHub的@mention system,你可以得到一些人的回馈,不管他们离你是近是远。

    你可以在自己的资源库中打开 pull requests并亲自做合并。这是在你操作更大的项目前,用来熟练使用GitHub的一个很棒的方式。

    给READEME上的改动打开一个Pull Reques.

    点击查看大图。

    1.单击 Pull Reuest标签,在打开的 Pull Request页面,单击绿色的New pull request按钮

    2.选中你创建的 readme-edits分支来和master主干(原始的)做比较

    3.在对比页面显示的差异处来检查你所作的改动,确保所示差异是你想要提交的

    4.当你认为这些是你想要提交的改动时,点击Creat Pull Request这个绿色的大按钮

    5.给你的 pull request起一个标题并对你的改动写一个扼要的描述

    当你把描述信息写好后,点击 Creat pull request!

    提示:你可以使用表情拖拽图片和gif动图到评论区及Pull Request上。

    第5步:合并你的Pull Request

    最后一步,是把你所有的改动集中起来的时候——把readme-edits分支合并到master主干。

    1.单击绿色的 Merge pull request 按钮来把改动合并到master主干

    2.单击 Confirm merge

    3.继续操作。点击紫框中的 Delete branch 来删除该分支,因为它的改动已经被合并了

    恭喜你完成所有操作!

    通过完成所有操作,你已经学会了创建工程及pull request!

    你所完成的各步操作有:

    ·创建一个开源的资源库

    ·开启并操作一个新分支

    ·对文件进行改动并提交到GitHub上

    ·打开并合并Pull Request

    查看一下你的GitHub文件,你会发现新的协作平台.

    如果你想学习Pull Request更强大的功能,我们建议阅读GitHub Flow Guide。你也可以浏览GitHub Explore,通过一个开源项目来得到帮助。

    提示:查看我们其他的GuidesYouTube Channel可获取更多的GitHub指南。

    相关文章

      网友评论

          本文标题:翻译Git Hub 之 Read the Guid

          本文链接:https://www.haomeiwen.com/subject/cskgettx.html