万事开头难。特别是和其他人合作时,出错往往会令人不适。不过,开源的本质就是和他人合作。这个项目的初衷就是为初学者提供一个简单的方法去学习以及参与开源项目。
你可以通过阅读文章和观看教程来得到帮助,但上手实操才是最好的学习方式。本项目旨在简化并指导初学者参与他们的第一次开源。记住:过程越轻松,学习效益越高。如果你想要做出第一次贡献,只需按照以下简单步骤操作即可。这将会是一个很有趣的过程 :)
如果你对 command line(命令行)不熟悉,请参考以下的 GUI 工具教程。
如果你的电脑上未安装 git, 请参考 GitHub 文档 进行安装。
点击图示中的按钮去 Fork 这个代码仓库。 这个操作会将代码仓库复制到你的账户名下。
接下来将复制的代码仓库克隆到你的电脑上。点击图示中的绿色按钮,接着点击复制到剪切板按钮(将代码仓库地址复制下来)
随后打开命令行窗口,敲入如下 git 命令:
git clone "刚才复制的 url 链接"
"刚才复制的 url 链接"(去掉双引号)就是复制到你账户名下的代码仓库地址。获取该链接的方法详见上一步。
譬如:
git clone https://github.com/<Github用户名>/first-contributions.git
'Github 用户名' 指的是你的 Github 用户名。这一步,这个操作将会克隆你账户名下 first-contributions 这个代码仓库到本地电脑上。
在命令行窗口中把目录切换到 first-contributions
cd first-contributions
接下来使用 git switch
命令新建一个代码分支
git switch -c <新分支的名称>
譬如:
git switch -c add-myname
(新分支的名称不一定需要有 add。然而,在新分支的名称加入 add 是一件合理的事情,因为这个分支的目的是将你的名字添加到列表中。)
打开 Contributors.md
这个文件,更新文件内容,将你的名字加上去,保存修改。git status
这命令会列出被改动的文件。接着 git add
这命令则可以添加你的改动,就像如下这条命令。
git add Contributors.md
现在就可以使用 git commit
命令 commit 你的修改了。
git commit -m "Add <你的名字> to Contributors list"
将 <你的名字>
替换成你的名字
使用 git push
命令推送代码
git push origin <分支的名称>
将 <分支的名称>
替换为之前新建的分支名称。
如果在 push(发布)过程中出 error(错误),点击这里
-
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's tutorial 学习如何生成新的 SSH 密匙以及配置。
前往你的 Github 代码仓库,你会看到一个 Compare & pull request
的按钮。点击该按钮。
接着再点击 Create pull request
按钮,正式提交 pull request。
不久之后,我便会把你所有的变化合并到这个项目的主分支。更改合并后,你会收到一封电子邮件通知。
为你的第一次贡献庆祝吧,不要忘记和你的朋友以及你的小迷弟小迷妹们分享我们的网站哟!
如果有任何疑问或想获得更多协助,欢迎加入我们的 Slack!
还在等什么,马上加入到其他项目的开发中去吧!为了方便你快速上手,我们收集了当前流行的众多代码仓库中,适合初学者解决的问题列表。
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |
项目支持者: