Skip to content

Latest commit

 

History

History
126 lines (90 loc) · 12.7 KB

README.cht.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