阅读其他语言版本。
首次贡献
本项目旨在简化并指导初学者进行首次贡献。如果你想进行首次贡献,请按以下步骤操作。
如果你不熟悉命令行,这里有使用GUI工具的教程。
如果你的电脑上没有安装git,请先安装。
Fork 这个仓库
点击本页面顶部的fork按钮来fork这个仓库。 这将在你的账户中创建一个本仓库的副本。
克隆仓库
现在,将fork的仓库克隆到你的电脑上。进入你的GitHub账户,打开fork的仓库,点击代码按钮,然后点击_复制到剪贴板_图标。
打开终端,运行以下git命令:
git clone "你刚才复制的url"
其中"你刚才复制的url"(不带引号)是本仓库的url(你fork的项目)。参考之前的步骤获取url。
例如:
git clone git@github.com:这是你的用户名/first-contributions.git
其中这是你的用户名
是你的GitHub用户名。这里你是将GitHub上first-contributions仓库的内容复制到你的电脑上。
创建分支
切换到仓库目录(如果你还没有切换):
cd first-contributions
现在使用git switch
命令创建一个分支:
git switch -c 你的新分支名
例如:
git switch -c add-alonzo-church
进行必要的修改并提交这些修改
现在用文本编辑器打开Contributors.md
文件,添加你的名字。不要将它添加到文件的开头或结尾,而是将其放在中间的任何位置。然后,保存文件。
如果你进入项目目录并执行git status
命令,你会看到有修改。
使用git add
命令将这些修改添加到你刚才创建的分支:
git add Contributors.md
现在使用git commit
命令提交这些修改:
git commit -m "Add 你的名字 to Contributors list"
将你的名字
替换为你的名字。
将修改推送到GitHub
使用git push
命令推送你的修改:
git push -u origin 你的分支名
将你的分支名
替换为你之前创建的分支名。
如果在推送时遇到任何错误,请点击这里:
-
认证错误
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/
请参考GitHub的教程,了解如何生成并配置SSH密钥到你的账户。/first-contributions.git/'
提交你的修改以供审核
如果你访问GitHub上的仓库,你会看到一个Compare & pull request
按钮。点击该按钮。
现在提交pull request。
不久后,我会将你所有的修改合并到这个项目的主分支中。一旦修改被合并,你将收到一封通知邮件。
接下来做什么?
恭喜!你刚刚完成了标准的 fork -> clone -> edit -> pull request 工作流程,这是你作为贡献者经常会遇到的!
庆祝你的贡献,并通过访问web应用与你的朋友和关注者分享。
如果你需要任何帮助或有任何问题,可以加入我们的slack团队。加入slack团队。
现在让我们开始为其他项目做贡献吧。我们整理了一个易于入手的问题列表,你可以从中开始。查看web应用中的项目列表。
附加材料
使用其他工具的教程
本项目由以下机构支持: