在GitHub 创建“Hello World”工程

Hello World项目是计算机编程中一个历史悠久的传统。这是一个简单的练习,让你开始学习新的东西。让我们从GitHub开始吧!
您将学习如何:

  1. 创建并使用存储库
  2. 启动并管理一个新的分支
  3. 对文件进行更改,并在提交时将其推送到GitHub
  4. 打开并合并一个pull请求

GitHub是什么?
GitHub是一个用于版本控制和协作的代码托管平台。它可以让你和其他人在任何地方一起完成项目。
本教程将向您介绍GitHub的基本要素,如存储库、分支、提交和拉请求。您将创建自己的Hello World存储库,并学习GitHub的Pull Request工作流,这是一种创建和检查代码的流行方法。
没有必要的编码
要完成本教程,您需要一个GitHub.com帐户和Internet访问。您不需要知道如何编写代码、使用命令行或安装Git(构建在版本控制软件GitHub之上)。

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

步骤1 创建一个存储库
存储库通常用于组织单个项目。存储库可以包含文件夹和文件、图像、视频、电子表格和数据集——任何您的项目需要的东西。我们建议包括一个自述文件,或者一个包含有关项目信息的文件。GitHub使得在创建新存储库的同时添加一个库变得很容易。它还提供了其他常见选项,比如许可证文件。
hello-world存储库可以是您存储想法、资源甚至与他人共享和讨论内容的地方。
创建一个新的存储库
在右上角,在您的头像或identicon旁边,单击并选择New repository。
命名您的存储库hello-world。
写一个简短的描述。
选择使用README初始化此存储库。
在这里插入图片描述
点击创建存储库。
步骤2 创建一个分支
分支是同时处理存储库的不同版本的方法。
默认情况下,存储库有一个名为master的分支,它被认为是最终分支。在将分支提交给master之前,我们使用分支进行实验和编辑。
当您从主分支创建一个分支时,您正在复制或快照当时的主分支。如果其他人在您处理分支时对主分支进行了更改,您可以导入这些更新。
这个图表显示:
主分支
一个名为feature的新分支(因为我们在这个分支上做“特性工作”)
该功能在合并为master之前所经历的过程

在这里插入图片描述
你曾经保存过不同版本的文件吗?喜欢的东西:

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

分支在GitHub存储库中实现了类似的目标。
在GitHub,我们的开发人员、编写人员和设计人员使用分支将bug修复和特性工作与我们的主(生产)分支分开。当变更就绪时,它们将分支合并到master中。
创建一个新的分支

  1. 转到您的新存储库hello-world。
  2. 单击文件列表顶部的下拉菜单,其中显示branch: master。
  3. 在新的分支文本框中键入分支名称readme-edits。
  4. 选择蓝色创建分支框或按键盘上的“Enter”。

在这里插入图片描述
现在有两个分支,master和readme-edits。它们看起来一模一样,但不会太久!接下来,我们将向新分支添加更改。
步骤3 做出并提交更改
万岁!现在,您在readme-edits分支的代码视图中,它是master的副本。让我们做一些编辑。
在GitHub上,保存的更改被称为提交。每个提交都有一个关联的提交消息,该消息解释了为什么要进行特定的更改。提交消息捕获更改的历史记录,这样其他贡献者就可以理解您做了什么以及为什么要这样做。
做出并提交更改

  1. 单击README。md文件。
  2. 单击文件视图右上角的铅笔图标进行编辑。
  3. 在编辑器中,写一些关于你自己的东西。
  4. 编写一条提交消息来描述您的更改。
  5. 单击提交更改按钮。

在这里插入图片描述
这些更改只针对README -edits分支上的README文件,所以现在这个分支包含与master不同的内容。
步骤4 打开Pull请求
漂亮的编辑!现在已经在master的分支中进行了更改,可以打开pull请求。
拉请求是GitHub上协作的核心。当您打开一个pull request时,您是在提议您的更改,并请求某人审阅您的贡献并将其合并到他们的分支中。Pull请求显示来自两个分支的内容的差异。更改、添加和删除以绿色和红色显示。
一旦提交,就可以打开pull请求并开始讨论,甚至在代码完成之前。
通过在您的pull request消息中使用GitHub的@mention系统,您可以向特定的人员或团队请求反馈,无论他们是在大厅的另一端,还是在10个时区之外。
您甚至可以在自己的存储库中打开pull请求并自己合并它们。在处理大型项目之前,这是学习GitHub流程的好方法。
打开对自述的更改的拉请求
点击图片查看大图
在这里插入图片描述

单击Pull Request选项卡,然后从Pull Request页面中,单击绿色的New Pull Request按钮。
在“示例比较”框中,选择您创建的分支readme-edits,以便与master(原始版本)进行比较。

在这里插入图片描述

在比较页面的差异中查看您的更改,确保它们是您想提交的。
当您确信这些是您想提交的更改时,单击绿色的Create Pull Request按钮。

在这里插入图片描述

给你的拉请求一个标题,并写一个简短的变更描述。

当您处理完消息后,单击Create pull request!

小贴士:你可以使用表情符号、拖放图片和gif到评论和拉拽请求中。

第5步 合并您的Pull请求

  1. 在最后一个步骤中,是时候将更改合并到一起了——将readme-edits分支合并到主分支中。
  2. 单击绿色Merge pull request按钮将更改合并到master中。
  3. 点击确认合并。
  4. 使用紫色框中的delete branch按钮,继续删除分支,因为已经合并了它的更改。

在这里插入图片描述
庆祝!
通过完成本教程,您已经学会了在GitHub上创建项目并发出pull request !
以下是你在本教程中完成的内容:

  1. 创建一个开源存储库
  2. 开始并管理一个新的分支
  3. 更改文件并将这些更改提交到GitHub
  4. 打开并合并一个Pull请求

看看你的GitHub配置文件,你会看到你的新贡献广场!
要了解更多关于拉请求的功能,我们建议阅读GitHub flow Guide。您还可以访问GitHub Explore并参与一个开源项目。
提示:查看我们的其他指南、YouTube频道和按需培训,了解更多关于如何开始使用GitHub的信息。

翻译自 https://guides.github.com/activities/hello-world/

猜你喜欢

转载自blog.csdn.net/weixin_39500654/article/details/88748358