[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)

# 第一次参与开源项目

| <img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="200"> | GitKraken 版 |
| ------------------------------------------------------------------------------------------------------------------------------------- | ----------- |

万事开头难。特别是当你正与其他人合作的时侯，出错不是一件舒服的事情。不过，开源的本质就是和他人合作。我们想要简化开源初学者第一次学习和贡献的方法。

你可以通过阅读文章和观看教程来得到帮助，但是没有比实际去做而不搞砸更好的方法了。本项目旨在简化并指导初学者参与他们的第一次开源。记住：过程越轻松，学习效益越高。如果你想要做出第一次贡献，只需按照以下简单步骤操作即可。相信我们，这将会是一个有趣的过程 :)

## Git Kraken

下载[GitKraken](https://www.gitkraken.com)，安装并打开它。

你应该会看到 "Welcome to GitKraken" 的对话框。

使用你的GitHub账号登陆并允许GitKraken 访问你的 GitHub 账户。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-login.png" alt="login to GitHub" />

(可选)点击文件“File” ，选择首选项“Preferences”，将你的项目目录设置为本地存储库的根目录。

## Fork（复制）本代码仓库

点击页面顶部的 “Fork”  按钮来分叉（Fork）这个仓库。<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/fork.png" alt="fork this repository" />
这将在你的账户中创建这个存储库的副本。

## Clone（克隆）代码仓库

在GitKraken中，点击文件“File” ，选择克隆储存库。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-clone.png" alt="clone this repository" />

在右侧窗格中选择 ”GitHub.com“。在你的用户名下，你应该看到 “first-contributions”。点击该存储库并查看窗格底部显示的完整路径。

当你确定你想要保存在本地的路径后，点击 “Clone the repo!”。

## 新建一个代码分支

点击工具栏上的 "分支"（Branch）按钮。

给你的分支命名为 "add-your-name"，例如："add-william-sutton"。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-branch.png" alt="name your branch" />

## 进行必要的更改并提交这些更改

现在在文本编辑器中打开`Contributors.md`文件并添加您的名字，然后保存文件。

如果你在 GitKraken 中打开了存储库，你会看到有更改。请通过选择最新的提交（标有“// WIP”以及更改的文件数和更改的类型）来审查和暂存这些更改。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-edit.png" alt="edit some file(s)" />

审查已更改的文件，并决定哪些文件你想要暂存。暂存很重要，它告诉 Git 哪些文件更改与这次提交相关。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-stage.png" alt="stage your changes" />

一旦你有了一个不错的提交消息（比如“将 <你的名字> 添加到贡献者列表”，这听起来不错而且描述清楚），并且对你的更改感到满意，你可以点击“暂存所有更改”来暂存所有已修改的内容，或者点击“暂存文件”来暂存单个文件。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-commit.png" alt="clone this repository" />

如果你改变主意，你可以取消这些更改，或者将它们全部丢弃。

警告：由于"discard"（丢弃）这个词的含义，这是一种破坏性的操作。只有当你不希望保留你所在的仓库中的任何更改时才执行此操作。

点击 commit（提交）

恭喜！你已将所有更改提交到首次贡献分支的本地副本。继续前进吧！

## 将改动 Push（推送）到 GitHub

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-push.png" alt="push your changes" />

点击工具栏上的 "Push" 按钮。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-origin.png" alt="origin or branch" />

如果你想要更改直接反映在主分支中，就提交更改到源分支。否则，选择你想要推送的适当分支。

## 提交你的更改供他人审阅

如果你在 GitHub 上进入你的存储库，你会看到`Compare & pull request`按钮。点击这个按钮。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/compare-and-pull.png" alt="create a pull request" />

现在提交拉取请求。

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/submit-pull-request.png" alt="submit pull request" />

很快我将把你的所有更改合并到这个项目的主分支中。一旦更改已经合并，你将收到通知邮件。

## 接下来该做什么呢？

恭喜！你刚刚完成了作为贡献者经常遇到的标准“分叉 -> 克隆 -> 编辑 -> 提交请求（PR）”的工作流程！

庆祝你的贡献，并通过前往[web app](https://firstcontributions.github.io/#social-share)分享给你的朋友和关注者。

如果有任何疑问或想获得更多协助，欢迎加入我们的 [Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)！

### [更多资料](../additional-material/git_workflow_scenarios/additional-material.md)

## 使用其他工具的教程

[返回主页](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.zh-cn.md)
