將妳的 APP 放上 GitHub
Created by Alyson La, @realalysonla
Translation by JuanitoFatas, @JuanitoFatas
開始前需要準備的東西
Git & GitHub
- 檢查是否已經安裝 Git
- 在終端機裡輸入
git --version
(1.8 或更高的版本較佳)
- 在終端機裡輸入
- 沒有安裝 Git 的話,到[這裡] (http://git-scm.com/downloads)下載 Git。
接著,設定妳的 Git 個人資料,打開終端機:
- 輸入
git config --global user.name "your-name"
-
輸入
git config --global user.email "your-email"
- 要檢查 Git 是不是已經設定好了,輸入
git config --list
- 輸入
- 去 GitHub 建立一個免費帳號,已經有帳號的話直接登入。
教練: 講點 Git、版本管理以及什麼是開源。
輸入命令將 APP 推送至 GitHub
在妳的 GitHub 個人頁面,按 “new repo” ,取個名字(比如:rails-girls),簡短敘述,選擇 “public” 選項,並按建立 “create repository”。不會建立的話可以問問教練,或是參考這篇文章。
接著回到終端機(Windows 叫命令提示字元),確保妳切換( cd
)到 railsgirls
目錄下之後,輸入:
git init
這會在妳的 railsgirls
目錄裡,初始化一個 Git Repository。
注意: 如果妳已經完成 Heroku 指南,則妳已經有 Git repository 了,妳可以跳過這步,直接往下。
接下來看看 railsgirls
目錄裡,有沒有一個叫做 README.rdoc
的檔案:
ls README.rdoc
dir README.rdoc
如果檔案不存在的話,可以輸入這行命令來新增一個:
touch README.rdoc
教練: 講講 README.rdoc 是做什麼的。
接下來輸入
git status
這會列出工作目錄下面,所有的檔案。
教練: 說說你自己愛用的 git 命令有那些。
接著輸入
git add .
把目錄下所有的檔案與變動加到 staging 區域。
然後輸入
git commit -m "first commit"
這會把剛剛加入的所有檔案提交(Commit)出去,並附加一則訊息 “first commit”
再來輸入
git remote add origin https://github.com/username/rails-girls.git
妳的 GitHub Repository 頁面會列出 repository 的 URL,去那邊複製下來,因為用手打很辛苦。可以在 URL 旁邊的剪貼板按鈕,按一下複製 URL。
這行命令會建立一個叫做 origin
的 remote (或稱為 connection),指向妳先前在 GitHub 網站上所建立的 GitHub Repository。
接著輸入
git push -u origin master
這會把妳剛剛的提交(commit)推送到 GitHub 上的 “master” 分支。
恭喜妳!妳的 app 現在放到 GitHub 上了!用剛剛複製的 URL(去掉 .git)看看妳放上去的程式碼吧。
如果妳想繼續修改妳的 APP,並更新到 GitHub 上,妳只會需要用到這三個命令:
git add .
git commit -m "type your commit message here"
git push origin master
下一步?
成為開源社群的一員
- 在 GitHub 上追隨一起參加 Rails Girls 的夥伴&教練
- 關注她們的專案或加星星
- Fork 一個 Repository, clone 下來並將修改 push 到妳 fork 的 Repository。透過發送一個 pull request,與原作者分享妳的修改!
- 找到錯誤時開一個 issue 吧
- 探索其它的開源專案 ─ 用程式語言或關鍵字來搜索
學更多 Git 的知識
-
看看 trygit.org
-
查詢 Git 命令 git-scm.org