Hello GitHub

点击上方"蓝色小字"关注我哦^

想来GitHub对于理工科,尤其计算机专业的大佬们应该很熟悉了,但作为机械专业小铁渣渣,自从创建了我的GitHub账号,就从来没在上面刨过什么好东西,更没有啥拿的出手的项目往上面晒了。今天给大家翻译了一下GitHub官网的使用简介,当初看英文看的一点耐心都没有,希望中文好些吧。


原英文地址:

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

Hello world

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

你将会学到:

  • 创建并使用一个“ 仓库 ”
  • 启动并管理一个分支
  • 对文档进行修改并提交到GitHub
  • 打开并合并一个拉操作

What is GitHub?

GitHub是一个用于版本控制和协作的代码托管平台。它允许你和其他人在任何地点一起对同一个项目进行操作。本教程向您介绍GitHub的基本功能,如存储库、分支、提交和拉请求。你将创建自己的Hello World存储库,并将学习一种创建和检查代码的流行方法——GitHub的拉请求的工作流程。

没代码没关系

要完成本教程,您需要一个GitHub帐户(https://github.com/)和互联网接入。您不需要知道如何编写代码、使用命令行或者安装Git(版本控制软件GitHub是构建在Git之上的)。

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

步骤一:创建一个仓库

一个仓库往往用来管理一个项目,存储库可以包含文件夹和文件、图像、视频、电子表格和数据集——任何您的项目需要的东西。我们建议您在仓库中包括一个readme,或者一个包含您的项目信息的文件。GitHub使得在创建新存储库的同时添加一个文件变得很容易。它还提供了其他常见选项,如许可证文件。

动手创建一个仓库

  1. 在GitHub网站右上角您的头像旁边,点击+号并选择“New repository”
  2. 以“hello_world”命名你的仓库
  3. 写一段简短的介绍
  4. 选择一个自述型文件来填充你的仓库

点击Create repository

步骤二:创建一个分支

分支是对仓库文件的不同版本同时处理的方法。

你的仓库默认有一个名为“master”的分支,它被认为是最终分支。在把项目提交到“master”前,我们对其使用分支结构进行实验和编辑。

当你在主分支之外创建了另一个分支时,你便对当前主分支进行了复制,或者说快照。如果其他人在你处理该分支时对主分支进行了修改,你便可以适时的获得更新。

如下图所示:

  • 主分支master
  • 一个名为"feature"的新分支(因为我们在该分支上进行"特征工作")
  • 该"feature"分支在被整合到总分支master之前的经历

你曾保存过同一文件的不同版本吗?就像这样:

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

分支可以在GitHub存储库中完成类似的目标。

在GitHub,我们的开发人员、编写人员和设计人员使用分支将修复bug和特征工作与我们的主(生产)分支分开。当变更准备好时,他们将分支合并到主分支master中。

动手创建一个分支

  • 打开你的新仓库"hello_world"
  • 单击文件列表顶部的下拉列表,其中显示分支:master
  • 在新的分支文本框中键入分支名称readme-edits
  • 选择蓝色"创建分支"框或按键盘上的"回车"

现在有两个分支,master和readme-edits。它们看起来一模一样,但这只是暂时的!接下来,我们将把更改添加到新分支。

步骤三:做出更改并提交

好了!现在,您在readme-edits分支的代码界面中,它是master的副本。让我们做一些编辑。

在GitHub上,保存的更改被称为提交。每个提交都有一个相关的提交消息,这是一个解释为什么要进行特定更改的描述。提交消息捕获您的更改历史,这样其他贡献者就可以理解您所做的事情和原因。

动手更改并提交

  • 点击README.md文件
  • 单击文件视图右上角的铅笔图标进行编辑。
  • 在编辑区写一点自我介绍
  • 点击"Commit changes"button

这些更改将只针对于你readme-edits分支里的README文件,所以现在该分支的内容不同于主分支。

步骤四:打开一个拉请求

漂亮!现在您已经在master的分支中进行了更改,可以打开拉请求。

拉请求是GitHub协作的核心。当您打开一个拉请求时,你是在请求某人审查并接受您提议的更改,并将这些更改合并到他们的分支中。拉请求会显示来自两个分支内容上的差异。对内容的更改,添加和删除等操作将会以绿色和红色显示。

一旦内容提交,你便可以打开拉请求并开始进行讨论啦,这些甚至都可以在代码完成之前进行。

在你的拉请求信息中使用GitHub的https://help.github.com/en/github/writing-on-github/about-writing-and-formatting-on-github#text-formatting-toolbar,你可以向特定的人或团队寻求反馈,不管他们是在客厅的另一端还是在10个时区之外。

您甚至可以在自己的存储库中打开拉请求并自己合并它们。在进行大型项目之前,这是学习GitHub流程的好方法。

动手打开对README文件修改的拉请求

点击图片查看大图:

  1. 单击Pull Request选项卡,然后从Pull Request页面,单击绿色的New Pull Request按钮。
  1. 在“示例比较”框中,选择您创建的分支readme-edits与master(原始版本)进行比较。
  1. 查看您在比较页面上的差异中的更改,确保它们是您想要提交的。
  1. 当您确信这些是您想要提交的更改时,单击绿色的Create Pull Request按钮。
  1. 给你的拉请求一个标题,并写一个简短的变更描述。

完成后,点击"Create pull request"!

注意:你可以在评论区或者拉请求中使用表情符号或者拖拽图像,动图等。

步骤五:合并你的拉请求

最后一步,是时候将你"readme-edits"分支中的变更合并到"master"主分支中去了。

  • 单击绿色的Merge pull request按钮,将更改合并到master中。
  • 点击"Confirm merge"
  • 当分支中的更改已经合并后,单击紫色框中的"Delete branch"按钮删除分支

恭喜!

通过完成本教程,您已经学习了如何在GitHub上创建项目和发出pull request !

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

  • 创建一个公开资源仓库
  • 创建并管理一个新的分支
  • 修改一个文件并将修改提交到GitHub
  • 打开并合并一个拉请求

看看你的GitHub档案,你会看到你的新贡献广场!


看完这篇官方指导,我们已经可以基本的使用GitHub的仓库以及协同工作的功能了,后期更新如何【在GitHub上找项目】来投喂自己。

本文分享自微信公众号 - Opencv视觉实践(gh_31e12b1be0e0),作者:周旋

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2020-01-19

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • win10+ubuntu18.04双系统安装/大集合

    大一时曾按着CSDN教程按好了ubuntu+win10双系统,在宿舍里昏天黑地得干了一天,电脑重启无数次,心情经历了无比得崩溃。我相信每个经历这个过程得同学心理...

    周旋
  • 【opencv实践】easy卡尔曼滤波上:浅谈

    距离上一篇文到现在有十天左右了,现在我又来更新啦!现在正值我们专业课程多的一个学期,还赶上疫情在家学习效率低,所以没能有精力写推文了,不过幸好大家都还在,我会一...

    周旋
  • 【资源分享1】日本同行整理的视觉处理100问

    图像处理100问,这个项目切切实实的包含了100个各种直击你薄弱底子的问题,看完可以帮你完善很多的知识漏洞和误区。

    周旋
  • 版本分支管理标准 - Trunk Based Development 主干开发模型

    之前分享过《版本分支管理标准 - Git Flow》,不过在实际使用过程中, 因为其有一定的复杂度,使用起来较为繁琐,所以一些人员较少的团队并不会使用这个方案。

    用户1172223
  • windows中使用Git创建分支(branch)?

    分支可以方便同时处理多个版本的代码,它是在创建分支的那个时间点上的原始分支的精确副本。   即可以随意的体验或者是更改、提交新的分支,直到准备好了就可以安全...

    黑泽君
  • 如何从PPI网络进一步挖掘信息

    从数据库中得到蛋白质的相互作用信息之后,我们可以构建蛋白质间的相互作用网络,但是这个网络是非常复杂的,节点和连线的个数很多,如果从整体上看,很难挖掘出任何有生物...

    生信修炼手册
  • git ---- 产生冲突的场景 和解决办法

    关于push和pull其实就分别是用本地分支合并到远程分支 和 将远程分支合并到本地分支

    小蔚
  • 云数据中心网络运维的苦与乐

    前几年大家讲 SDN 比较多的是怎样利用控制器,像 OpenDayLight、ONOS 这些东西,其实在讲怎样做一个 Driver、怎样做控制。大概从去年开始,...

    SDNLAB
  • 夜话人工智能

    人工智能是一门非常复杂、庞大的科学,其中的机器学习、深度学习等细分学科是当下的研究热点。从1956年至今,无数科学家历经艰辛与坎坷,终于让人工智能迈出了属于全人...

    黄成甲
  • Rock Health:从预测性分析走向个性化医疗

    大数据文摘

扫码关注云+社区

领取腾讯云代金券