Skip to content

Latest commit

 

History

History
119 lines (79 loc) · 12.2 KB

README.cht.md

File metadata and controls

119 lines (79 loc) · 12.2 KB

Open Source Love

第一次參與開源

萬事起頭難。特別是和其他人合作時,犯錯格外令人不舒服。不過,開源的本質就是和其他人合作。我們希望為初學者帶來一個簡單的方法去學習及參與開源項目。

閱讀文章和觀看教程會有所幫助。不過,有什麼方法能比,在不會弄亂任何東西的情況下,實際動手做更好?本項目旨在指導初學者及簡化初學者參與開源的方式。記住:過程越輕鬆,學習效益越高。如果你想要做出第一次貢獻,只需按照以下簡單步驟操作即可。我們答應你,這將很好玩 :)

fork this repository

其他語言版本: 英語, 西班牙語, 荷蘭語, 印度語, 俄語, 日語, 越南語, 波蘭語, 韓語, 德語, 簡體中文, 繁體中文, Greek.

如果你的電腦上尚未安裝 git, 請按照這個 安裝指引 進行安裝。

Fork(複製)本代碼倉庫

點擊圖示中的按鈕去 Fork 這個代碼倉庫。 這個操作會將代碼倉庫複製到你的Github帳號下。

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