Skip to content

Latest commit

 

History

History
126 lines (90 loc) · 12.7 KB

README.chs.md

File metadata and controls

126 lines (90 loc) · 12.7 KB

Open Source Love

First Contributions

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 新分支的名称

对代码进行修改,而后 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 <分支的名称>

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

提交你的变动供他人审阅

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

create a pull request

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

submit pull request

让你复制的代码仓库和本仓库保持一致

收到你提交的变动后,我会将你提交到新分支中的改动,合并到 master(主分支)中。而你复制的代码仓库不会自动获取到合并后的更新内容。为了让你复制的代码仓库和我的代码仓库内容保持一致,首先你需要将我的代码仓库的地址使用 upstream remote url 命令添加到你的仓库配置信息中。

git remote add upstream https://github.com/multunus/first-contributions

如此一来,你就让 git 知道了你本地的这个代码仓库在远端还存在另一个版本(即我的代码仓库),而那个版本我们将其叫做 upstream。一旦我合并了你提交的改动到我的代码仓库后,你在本地通过下面这个命令便能将更新的内容同步到本地。

git fetch upstream

通过上面这个命令,我们便将远端我的代码仓库(upstream remote)中所有新增的改动抓回到了本地。但这样还没有结束,接下来,你也需要将更新 rebase(按照 git 中文文档将其翻译为 '衍合')进入你本地的 master 主分支中。

git rebase upstream/master

通过上面这个命令,你就能够将从远端抓下来的所有改动衍合到本地的 master 主分支中。接着如果你再做一次 push master 提交你本地代码到你自己的远端主分支的操作,你在 Github 上复制的远端代码仓库就也包含最新的代码了。

git push origin master

注意,上面这个命令中,你远端的代码仓库的名字叫做 origin。

教程使用其他工具

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

接下来做什么呢?

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

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