关于Github上第一个Hello World文档介绍翻译

这篇博客介绍了如何在GitHub上创建Hello World项目,包括创建存储库、分支、提交更改以及如何打开和合并Pull Request。适合初学者了解GitHub的基本工作流程。
摘要由CSDN通过智能技术生成

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

        你将学习如何:

  1. 创建和使用一个存储
  2. 开始和管理一个新的分支
  3. 对一个文件做出修改,并作为提交推到GitHub
  4. 打开并且合并一个pull request

GitHub是什么?


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

       本教程教你GitHub的要点,如存储库、分支、提交和Pull Requests。你将创建自己的Hello World存储库,并学习GitHub的Pull Request工作流,这是一种创建和审查代码的流行方式。

无需必要的编码

       要完成本教程,您需要GitHub.com帐户和互联网访问。你不需要知道如何编码、使用命令行或者安装Git (GitHub建立在其上的版本控制软件)。

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

步骤1 创建一个存储库


       存储库通常用于组织单个项目。存储库可以包含文件夹和文件、图像、视频、电子表格和数据集——项目所需要的任何东西。我们建议包含一个README文件或一个包含有关项目信息的文件。GitHub使得在你创建新的存储库的同时添加一个上述文件很容易。它还提供了其他常见的选项,如许可证文件。 

       你的hello-world存储库可以是你存储想法、资源甚至与他人分享和讨论事情的地方。

创建一个新的存储库

  1. 在右上角,你的头像或身份旁边,点击+,然后选择New repository
  2. 将存储库命名为hello-world。
  3. 写一篇简短的描述。
  4. 选择带有README文件初始化这个存储库。

new-repo-form

 步骤2 创建一个分支


       分支是同时处理存储库的不同版本的方法。

       默认情况下,您的存储库有一个名为main的分支,它被认为是明确的分支。我们使用分支进行实验,并在提交给main之前进行编辑。 

       当您在main分支之外创建一个分支时,您正在创建一个main分支在当时的副本或快照。如果在您处理您的分支时,其他人对main分支进行了更改,您可以将这些更新拉入。

       这个图表显示:

  1. main分支
  2. 一个名为feature的新分支(因为我们正在这个分支上做feature工作)
  3. feature在并入main之前所经历的旅程

a branch

        你曾经保存过不同版本的文件吗?比如说:

  1. story.txt
  2. story-joe-edit.txt
  3. story-joe-edit-reviewed.txt

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

        在GitHub上,我们的开发人员、编写人员和设计人员使用分支将错误修复和特性工作与我们的main(生产)分支分开。当一个变更准备好了,他们将其分支合并到main中。 

创建一个新的分支

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

branch gif

       现在有了两个分支,main和readme-edits。它们看起来一模一样,但不会持续太久!接下来,我们将把更改添加到新分支中。

步骤3 做出和提交更改


        万岁!现在,您进入了readme- editits分支的代码视图,它是main的副本。让我们做一些修改。
        在GitHub上,保存的更改被称为提交。每个提交都有一个关联的提交消息,这是一个解释为什么进行特定更改的描述。提交消息捕获更改的历史,以便其他贡献者能够理解您做了什么以及为什么。

做出和提交更改

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

commit       这些更改将只对readme-editits分支上的README文件进行,因此现在这个分支包含与main不同的内容。

 步骤4 打开Pull Request


       漂亮的编辑!现在您已经在main分支中进行了更改,您可以打开一个pull请求。
       Pull Requests是GitHub上协作的核心。当您打开一个拉入请求时,您是在建议您的更改,并请求某人检查并拉入您的贡献,并将它们合并到他们的分支中。Pull请求显示来自两个分支内容的差异。绿色和红色显示了变化、增加和减少。

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

        通过在你的pull request消息中使用GitHub@mention系统,你可以从特定的人或团队寻求反馈,无论他们是在走廊下面还是10个时区之外。

        您甚至可以在自己的存储库中打开pull requests并自己合并它们。这是一个学习GitHub流程的好方法,在忙于更大的项目之前。

打开一个Pull Request来更改README

点击图片查看大图

GitHub Documentation

GitHub Documentation

 GitHub Documentation

GitHub Documentation

GitHub Documentation

 当您完成您的消息,单击创建Pull Request。

提示:你可以使用表情符号,拖放图片和gif到评论和Pull Requests。

第5步 合并你的Pull Request

 在最后一步中,是时候将更改合并到一起了——将readme- edits分支合并到main分支中。

  1. 单击绿色的Merge pull request按钮将更改合并到main分支中。
  2. 点击Confirm merge
  3. 继续并删除分支,因为它的更改已经合并,使用紫色框中的Delete branch按钮。

庆祝! 

      通过完成本教程,你已经学会了在GitHub上创建一个项目并做出一个pull request!

      以下是你在本教程中所完成的:

  1. 创建一个开源库
  2. 启动并管理一个新的分支
  3. 改变一个文件并提交到GitHub
  4. 打开并合并一个Pull Request

     看看你的GitHub档案,你会看到你的新贡献方块

    要了解更多Pull Requests的功能,我们推荐阅读GitHub流程指南。你也可以访问GitHub Explore并参与一个开源项目。

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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值