mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-14 01:31:50 +00:00
Roshanjossey
109 lines
6.6 KiB
Markdown
109 lines
6.6 KiB
Markdown
[](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)
|
||
[](https://opensource.org/licenses/MIT)
|
||
[](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)
|