Skip to content

Latest commit

 

History

History
119 lines (78 loc) · 12.2 KB

README.chs.md

File metadata and controls

119 lines (78 loc) · 12.2 KB

Open Source Love

第一次参与开源

万事起头难。特别是和其他人合作时,犯错格外令人不舒服。不过,开源的本质就是和其他人合作。我们希望为初学者带来一个简单的方法去学习及参与开源项目。

阅读文章和观看教程会有所帮助。不过,有什麽方法能比,在不会弄乱任何东西的情况下,实际动手做更好?本项目旨在指导初学者及简化初学者参与开源的方式。记住:过程越轻松,学习效益越高。如果你想要做出第一次贡献,只需按照以下简单步骤操作即可。我们答应你,这将很好玩 :)

fork this repository

其他语言版本: 英语, 西班牙语, 荷兰语, 印度语, 俄语, 日语, 越南语, 波兰语, 韩语, 德语, 简体中文, 繁体中文, Greek.

如果你的电脑上尚未安装 git, 请按照这个 安装指引 进行安装。

Fork(复制)本代码仓库

点击图示中的按钮去 Fork 这个代码仓库。 这个操作会将代码仓库复制到你的账户名下。

Clone(克隆)代码仓库

clone this repository

接下来,将复制後的代码仓库克隆到你的电脑上。点击图示中的绿色按钮,接着点击复制到剪切版按钮(将代码仓库地址复制下来)

随後打开命令行窗口,敲入如下 git 命令:

git clone "刚才复制的 url 链接"

"刚才复制的 url 链接"(去掉双引号)就是复制到你账户名下的代码仓库地址。获取这链接地址的方法请见上一步。

copy URL to clipboard

譬如:

git clone https://github.com/你的Github用户名/first-contributions.git

'你的 Github 用户名' 指的就是你的 Github 用户名。这一步,你将复制到你账户名下的 first-contributions 这个代码仓库克隆到本地电脑上。

新建一个分支

下面的命令能在命令行窗口中,把目録切换到 first-contributions

cd first-contributions

接下来使用 git checkout 命令新建一个代码分支

git checkout -b <新分支的名称>

譬如:

git checkout -b add-myname

(新分支的名称不一定需要有* add 。然而,在新分支的名称加入 add *是一件合理的事情,因为这个分支的目的是将你的名字添加到列表中。)

对代码进行修改,而後 Commit (提交) 修改

打开 Contributors.md 这个文件,更新文件内容,将你的名字加上去,保存修改。git status 这命令会列出被改动的文件。接着 git add 这命令则可以添加你的改动,就像如下这条命令。

git add Contributors.md

现在就可以使用 git commit 命令 commit 你的修改了。

git commit -m "Add <你的名字> to Contributors list"

<你的名字> 替换为你的名字

将改动 Push(发布)到 GitHub

使用 git push 命令发布代码

git push origin <分支的名称>

<分支的名称> 替换为之前新建的分支名称。

提出 Pull Request 将你的修改供他人审阅

前往 Github 你的代码仓库,你会看到一个 Compare & pull request 的按钮。点击该按钮。

create a pull request

接着再点击 Create pull request 按钮,正式提交 pull request。

submit pull request

不久之後,我便会把你所有的变化合并到这个项目的主分支。更改合并後,你会收到通知电邮。

使用其他工具的教程

GitHub Desktop Visual Studio 2017 GitKraken
GitHub Desktop Visual Studio 2017 GitKraken

接下来做什麽呢?

如果有任何疑问或想获得更多协助,欢迎加入我们的 Slack

通过下面这些链接,你能看到当前流行的众多代码仓库中,适合初学者解决的问题列表,还等什麽,去吧 :)

exercism fun-retro habitat scikit-learn elasticsearch
exercism Fun Retros react habitat scikit-learn Leiningen numpy elasticsearch
homebrew rust vuejs Suave OpenRA PowerShell coala moment
homebrew Rust vuejs Suave OpenRA PowerShell coala moment
ava freeCodeCamp webpack hoodie pouchdb neovim babel
ava freeCodeCamp webpack hoodie pouchdb neovim babel brackets
Node.js
Node.js Semantic-UI-React