[翻译]GitHub指南中的Hello World项目

Posted 2022-11-23 consolas11

原文链接：https://guides.github.com/activities/hello-world/

Hello World项目是一个久负盛名传统的计算机编程项目。它是一个当你学习新东西时的简单的练习。我们开始GitHub之旅吧！
你会学到怎么去做下面这些事：
- 创建并且使用仓库（repository）
- 开始并且管理一个新的分支（branch）
- 修改文件并作为提交push它们到GitHub
- 打开并且合并（merge）一个pull请求

GitHub是什么

---

GitHub是一个旨在版本控制和协作的代码托管平台。你和其他人可以从世界上任何地方合作完成项目。

这个指导将会教你GitHub的基本要素比如存储仓库(repositories)，分支（branches），提交（commits）和合并请求（pull requests）。你将会创建属于你自己的Hello World仓库同时学习GitHub的pull request workflow（合并请求工作流），这种流行的创建代码、审查代码的方式。

编程能力不是必要的

为了完成这个教学，你需要一个GitHub账户和网络连接。你不需要知道怎么去编程，使用命令行或者安装Git（版本控制软件，GitHub就是建立在Git基础上的）。

提示：在一个独立的浏览器窗口（或标签页）打开指南这样你就可以在完成教学步骤的同时看到它。

第一步 创建一个仓库

---

仓库通常用作组织单一的项目。仓库可以包含文件夹和文件、图片、视频、电子表格和数据集—任何你的项目需要的。我们推荐包含一个README，或者一个说明你的项目的文件。GitHub使你创建新仓库的同时更容易添加一个新文件。它同样提供通用的选项，比如许可文件。
你的 hello-world 仓库可以用来存储想法，资源或者甚至和其他人分享讨论一些事情。

去创建一个新的仓库

1.在右上角，你的用户名旁边，点击 + 然后点击New repository。
2.给仓库命名hello-world。
3.写一段简介。
4.选择Initialize this repository with a README。



点击Create repository.
:tada:

第二步 创建一个分支

---

分支是一种同时在同一个仓库的不同版本工作的方式。

你的仓库有一个被认为是决定性的默认分支叫做master。在提交给master分支前我们用其他分支来实验和编辑修改。

当你从master创建一个分支，你就有了一份master的复制品或叫做快照。如果在你工作在自己的分支时某个人对master分支做出改变，你可以把这些更新。

这些图表描述这种结构：

-master分支
-一个新的叫做feature的分支（因为我们在分支上做“特色工作”）

你曾经保存过不同版本的文件吗？类似这些：

• 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”键。

现在你有两个分支，master和readme-edits。它们看起来确实一样，但是不会一直这样！接下来我们会在新分支做出我们的改变。

第三步 做出更改并提交更改

---

好极了！现在，你看到readme-edits分支的代码视图，master分支的副本。我们来做些改动。

在GitHub上，保存改变叫做提交。每个提交有一个关联的提交信息，用来描述为什么做出一个特殊的修改。提交信息捕获你的修改历史，所以其他的贡献者能够理解你做了什么还有为什么做这些。

修改并提交

1.点击README.md文件。
2.点击文件视图右上角的铅笔图标来编辑。
3.在编辑器里，写一点关于你的东西。
4.写一段提交信息描述你的修改。
5.点击Commit changes按钮。

这些改变会在readme-edits分支的README文件，所以现在这个分支包含不同于master分支的内容。

第四步 开启一个PULL请求

---

漂亮的编辑！现在你有一个改变在master分支外，你可以开启一个pull request。

Pull请求是GitHub合作的核心。当你开启一个pull request，你提出修改建议和请求，其他人查看并采纳你的贡献合并修改到他们的分支中。Pull request展示两个分支内容的不同。修改、添加和删除被用绿色和红色显示。

一旦你完成一个提交，你可以开启一个pull request并且开始一个讨论，甚至在编码完成前就可以。

通过在你的pull request使用GitHub的@mention system（提示系统），你可以要求特定的人或团队的回复，不论他们在大厅或10个时区外。

你可以在你自己的仓库开启pull request然后自己合并他们。这是一种在为大项目工作前学习GitHub Flow的好方法。

开启一个修改README文件的Pull Request

点击图片查看大图

步骤	截图
点击Pull Request选项，然后从Pull Request界面点击绿色的New pull request按钮。
选择你做修改的分支，readme-edits，和master（原始的）分支比较。
在比较页面查看你的修改，确保它们是你想提交的。
当你对这些你想提交的改变很满意，点击大大绿色的Create Pull Request按钮。
给你的pull request一个标题和简短的关于修改的描述。

当你填完信息，点击Create pull request！

提示：你可以在评论和Pull Request使用emoji和drag and drop images and gifts。

第五步 合并你的Pull Request

---

在这最后一步，是时候一起带来你的修改了–把你的readme-edits分支合并到master分支。

1.点击绿色的Merge pull request按钮来合并修改到master。
2.点击confirm merge（确认合并）。
3.因为改变已经被合并，继续并且用紫色框内的Delete branch（删除分支）按钮删除分支。

恭喜！

通过完成这个教学，你已经学到在GitHub创建项目和做一个pull request！

:tada::octocat::zap:

下面是你在这个教学完成的：

• 创建一个开源仓库
• 启动并管理一个新分支
• 修改文件并提交改变到GitHub
• 开启和合并一个Pull Request

看你的GitHub资料然后你会发现你的新contribution squares！（贡献广场）

如果你想学更多的pull request的强大之处，我们建议阅读GitHub Flow Guide（GitHub流指南）。你可能还需要访问GitHub Explore还有加入一个开源项目

提示：看看我们其他的Guides和YouTube Channel获取更多GitHub新手教程。

上次更新2016年二月