first-contributions - 🚀✨初学者如何为开源项目做贡献

Created at: 2016-09-20 22:35:09
Language:
License: MIT

开源之爱 授权协议: MIT 开源助手

其他语言阅读本文。

什奇普 乌兹别克语 Azərbaycan dili বাংলা 保加利亚语 葡萄牙语 加泰罗尼亚 中文(简体) 捷克语 德语 丹斯克 العربية 西班牙 法语 加莱戈 Ελληνικά ქართული 匈牙利的 印度尼西亚语 עִברִית हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ் தமிழ் فارسی پښتو 意大利菜 日本語 සිංහල 斯瓦希里语(肯尼亚) 한국어 한국어 Lietuvių kalba 林巴罗曼纳 林巴罗曼纳 မြန်မာ Македонски 墨西哥西班牙语 马来语 / بهاس ملايو / 马来语 荷兰语 挪威 नेपाली 维康菲律宾语 英语(海盗) اردو 波兰斯基 葡萄牙(葡萄牙) Русский язык عربى 瑞典语 斯洛文奇纳 斯洛文希纳 ภาษาไทย Türkçe 中文(繁体) Українська 天越 祖鲁语(南非) 南非语(南非) 伊博语(尼日利亚) 约鲁巴语(尼日利亚) 豪萨语(尼日利亚) 拉托维亚 索梅克西 Беларуская мова Српски Қазақша 波斯尼亚斯基 波斯尼亚斯基 赫尔瓦茨基 پښتو

首次贡献

该项目旨在简化和指导初学者做出第一次贡献的方式。如果你想进行首次贡献,请按照以下步骤操作。

如果你不熟悉命令行,以下是使用 GUI 工具的教程。

分叉此存储库

如果你的计算机上没有 git,请安装它

分叉此存储库

通过单击此页面顶部的分叉按钮来分叉此存储库。这将在你的帐户中创建此存储库的副本。

克隆存储库

克隆此存储库

现在将分支存储库克隆到你的计算机。转到你的 GitHub 帐户,打开分支存储库,单击代码按钮,然后单击复制到剪贴板图标。

打开终端并运行以下 git 命令:

git clone "url you just copied"

其中“你刚刚复制的URL”(不带引号)是此存储库(此项目的分支)的URL。请参阅前面的步骤以获取 URL。

将网址复制到剪贴板

例如:

git clone https://github.com/this-is-you/first-contributions.git

你的 GitHub 用户名在哪里。在这里,你将 GitHub 上首次贡献存储库的内容复制到你的计算机。

this-is-you

创建分支

切换到计算机上的存储库目录(如果尚未更改):

cd first-contributions

现在使用以下命令创建一个分支:

git switch

git switch -c your-new-branch-name

例如:

git switch -c add-alonzo-church

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

现在在文本编辑器中打开文件,在其中添加你的名字。不要将其添加到文件的开头或结尾。把它放在两者之间的任何地方。现在,保存文件。

Contributors.md

吉特状态

如果你转到项目目录并执行命令,你将看到有更改。

git status

使用以下命令将这些更改添加到刚刚创建的分支:

git add

git add Contributors.md

现在使用以下命令提交这些更改:

git commit

git commit -m "Add your-name to Contributors list"

替换为你的姓名。

your-name

将更改推送到 GitHub

使用以下命令推送更改:

git push

git push -u origin your-branch-name

替换为之前创建的分支的名称。

your-branch-name

如果你在推送时遇到任何错误,请单击此处:
  • 身份验证错误

    remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
    remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
    fatal: Authentication failed for 'https://github.com//first-contributions.git/'
    转到 GitHub 关于为你的帐户生成和配置 SSH 密钥的教程。

提交更改以供审核

如果你转到 GitHub 上的存储库,你将看到一个按钮。单击该按钮。

Compare & pull request

创建拉取请求

现在提交拉取请求。

提交拉取请求

很快,我将把你的所有更改合并到该项目的主分支中。合并更改后,你将收到一封通知电子邮件。

何去何从?

恭喜!你刚刚完成了作为贡献者经常遇到的标准分叉 -> 克隆 ->编辑 -> 拉取请求工作流!

庆祝你的贡献,并通过转到网络应用程序与你的朋友和关注者分享。

如果你需要任何帮助或有任何疑问,可以加入我们的 Slack 团队。加入松弛团队

现在,让我们开始为其他项目做出贡献。我们编制了一份项目列表,其中包含你可以开始解决的简单问题。查看 Web 应用程序中的项目列表

其他材料

使用其他工具的教程

GitHub 桌面 Visual Studio 2017 吉特海妖 VS 代码 源树应用 智能理念
GitHub 桌面 Visual Studio 2017 吉特海妖 视觉工作室代码 阿特拉斯源树 智能理念