翻译官方教程 :https://guides.github.com/activities/hello-world/

Hello World在计算机编程中是一个悠久的传统,它是一个让你在学习新东西时的简单练习,让我们开始使用GitHub!

你将学习如何:

  •     创建并使用一个仓库
  •     开始并管理一个新的分支
  •     对文件进行修改并将它们推送给GitHub
  •     打开并合并一个请求

什么是GitHub?

    GitHub是一个用来版本控制和协作的代码托管平台,它可以让你和其他人在任何地方一起为你的项目工作。

    本教程向您介绍GitHub的要素如仓库,分支,提交和合并请求。你将创建你自己的Hello World仓库并且学习GitHub的拉取请求流程,这是一种创建和查看代码流行的方式。

    没有必要的编码

    要完成本教程,您需要一个GitHub.com账户和Internet访问权限,你不需要知道如何编写代码,使用命令行或安装Git(构建了GitHub的版本控制软件)。

    提示:在单独的浏览器(或选项卡)中打开本指南,以便在完成教程中的步骤时看到它。


步骤1:创建一个仓库

    一个仓库通常用来组织单个项目,仓库可以包含文件夹和文件,图片,视频,表格和数据集——任何你项目需要的东西。我们建议包括一个自述文件或包含关于您项目信息的文件。GitHub可以很轻松在你新建你的仓库同时新增一个。它还提供其他常见选项,如许可证文件。

    你的hello world仓库可以成为你存放想法,资源,甚至于他人分享和讨论事物的地方。


创建一个新的仓库

    1.在右上角,在您的头像或身份标识旁边,点击+,然后选择New repository

    2.命名您的仓库hello-world。

    3.写一个简短的描述。

    4.选择Initialize this repository with a README. 使用自述文件初始化该仓库。

GitHub —— No.1向导

    点击Create repository创建存储库。


步骤2:   创建一个分支

    分支是在一个仓库中处理不同版本的一种方式

    默认情况下,您的仓库有一个名为master的分支,它被认为是最终分支。我们在提交给master之前使用分支来进行实验和编辑。

    当您从master分支中创建分支时,您将创建master分支的复制或快照,就像它在那个时间点一样。如果其他人在您的分支上工作时对主分支进行了更改,则可以引入这些更新。

    此图显示:

  •     master 分支
  •     一个叫做feature的新分支(因为我们正在这个分支上做feature work)
  •     当feature合并到master之前要经历的流程

GitHub —— No.1向导

您有没有保存过不同版本的文件? 就像是:

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

分支机构在GitHub分支中实现类似的目标。

在GitHub上,我们开发人员,作者和设计人员使用分支将错误修复和特色工作与master分支分开,当更改准备就绪后,他们将分支合并到master中。


创建一个新的分支

    1.转到您的仓库hello-world.

    2.点击文件列表顶部的下拉列表中的branch:master

    3.在新的分支文本框中输入分支名称readme-edits

    4.选择蓝色的Create branch框或点击键盘上的Enter.

GitHub —— No.1向导

现在你有两个分支,master和readme-edits,它们看起来完全一样,但不会太久!接下来我们会将我们更改添加到新分支中。


步骤3:制作和提交更改

    好样的!现在,您正在使用readme-edits分支的代码视图,该分支是master的副本。我们来做一些编辑。

    在GitHub上,保存的更改称为提交。每个提交都有一个关联的提交消息,它是解释为什么进行特定更改的说明。提交消息捕获您所做更改的历史记录,所以其他贡献者可以了解您所做的工作以及原因。

    制作和提交更改

    1.点击RADME.md文件

    2.点击文件视图右上角的铅笔图表进行编辑

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

    4.编写描述您更改的提交信息

    5.点击Commit changes提交更改按钮

GitHub —— No.1向导

这些更改将仅针对readme-edits分支上的README文件中进行,因此,该分支包含的内容与主文件不同。


步骤4:打开合并请求

    好的,现在您的分支已经发生变化,您可以打开一个合并请求。

    合并请求是GitHub协作的核心。当您打开一个合并请求时,你正在提出你的改变,并要求有人审查并提交你的贡献,并将它们合并到他们的分支中。合并请求显示来自两个分支的内容差异。更改,添加和删减以绿色和红色显示。

    一旦你提交了,你甚至可以在代码完成之前打开一个合并请求并开始讨论。

    通过在你的合并请求中使用GitHub的@mention系统,您可以要求特定人员或团队提供反馈,无论他们是否在大厅或10个时区以外。

    你甚至可以在自己的仓库中打开合并请求并自己合并,在开展大型项目之前,学习GitHub流程是一种很好的方式。


    打开合并请求以更改自述文件

    

Step Screenshot

Click the  Pull Request tab, then from the Pull Request page, click the green New pull request button.

点击合并请求标签,然后从合并请求页面点击绿色的新建请求按钮

GitHub —— No.1向导
In the Example Comparisons box, select the branch you made, readme-edits, to compare with master (the original).在“示例比较”框中,选择您创建的分支readme-edits与master进行比较 GitHub —— No.1向导

Look over your changes in the diffs on the Compare page, make sure they’re what you want to submit.

查看比较页面上的差异,确保它们是你想要提交的内容

GitHub —— No.1向导

When you’re satisfied that these are the changes you want to submit, click the big green Create Pull Request button.

如果你满意这些要提交的更改,请点击绿色的“创建合并请求”按钮

GitHub —— No.1向导

Give your pull request a title and write a brief description of your changes.

为您的合并请求提供一个标题并写下您的更改的简要说明

GitHub —— No.1向导


步骤5:合并您的请求

    在这最后一步中,是时候把你的修改结合起来,将你的readme-edits分支合并到master分支中

    1.点击绿色Merge pull request来将更改合并到master中。

    2.点击Confirm merge。点击确认合并

    3.继续操作,删除分支,因为它的更改已经合并,并且在紫色框中带有删除分支按钮。

GitHub —— No.1向导

GitHub —— No.1向导

恭喜!

    通过完成本教程,您已经学会了创建一个项目,并在GitHub上提出合并请求

    以下是您在本教程中完成的任务:

  •     创建一个开源库
  •     开始并管理一个新的分支
  •     更改了一个文件并将这些更改提交给GitHub
  •     打开并合并请求
  •     看看你的GitHub配置文件,你会看到你的新贡献广场!

要了解更多关于Pull Request的功能,我们推荐阅读GitHub流程指南。您也可以访问GitHub Explore并参与开源项目:octocat:

提示:查看我们的其他指南,YouTube频道和点播培训,了解更多关于如何开始使用Git-Hub的信息

相关文章:

  • 2021-10-31
  • 2022-01-03
  • 2021-06-26
  • 2021-11-11
  • 2021-06-02
  • 2021-11-19
  • 2021-08-19
  • 2021-08-04
猜你喜欢
  • 2020-03-18
  • 2021-12-04
  • 2021-05-06
  • 2021-09-09
  • 2021-10-09
  • 2021-10-13
  • 2021-09-18
相关资源
相似解决方案