# c4Lab Git tutorial
###### 2017/07/18 @ 台大生機系

## Schedule
- **Part 0** 準備
- **Part 1** 基礎觀念、名詞解釋及常用指令
- **Ex 1** 從 pull 到 push
- **Part 2** Git協作：branch和merge
- **Ex 2** 現場多人協作練習
- **Part 3** IDE的git整合（以PyCharm為例）
- **Part 4** 進階主題

## Part 0 準備

**TODO 1：確認已安裝git** `必備`
https://git-scm.com/book/zh-tw/v1/開始-安裝Git
hint: 安裝前、安裝後以 `$ git --version` 檢查是否已安裝
- 開啟 Git Bash(win) 或 terminal(mac, linux)
- 執行 `git clone https://github.com/choznerol/c4lab-git-tutorial.git` 抓今天的教材
- 還沒裝好：https://vdi.ntu.edu.tw/portal/webclient/index.html#/desktop

**TODO 2：註冊GitHub帳號（或找回密碼XD）** `必備`
https://github.com/login
- 填寫你的 GitHub username：
-

**TODO 3：下載安裝 PyCharm** `自由選用`
好用又好看的python IDE，會demo它的版控功能，推薦給常在本機寫python的同學
https://www.jetbrains.com/pycharm/download/

**TODO 4： 下載安裝 GitKraken** `自由選用`
個人覺得最好用的Git的GUI，會demo它帶觀念，推薦給git新手＆常在本機用git協作的同學
https://www.gitkraken.com/download

## Part 1 基礎觀念及常用指令

### Git是啥
- Git v.s. Dropbox
- 版本控制：commit、branch、程式隨時可動
- 分散式：各自離線作業、需要再merge

### 不錯的學習資源
- [Try Git](https://try.github.io/levels/1/challenges/3)：GitHub的線上互動式git練習(15min)
- [連猴子都能懂的 Git 入門指南](https://backlogtool.com/git-guide/tw/intro/intro1_1.html)：中文的詳盡主題式Git指南
- [Git 名詞解釋](http://dylandy.github.io/Easy-Git-Tutorial/)：想知道什麼是reference、snapshot、HEAD？
- [Pro Git](https://git-scm.com/book/zh-tw/v1)：官方的git聖經本(?)

### 基本架構

四個工作區：**Working Directory / Staging Area / Local Repository / Remote Repository**
三種檔案狀態：<span style="color:red">modified</span> ---(add)---> <span style="color:green">staged</span> ---(commit)---> <span style="color:gray">committed</span>

**Staging Area** (noun.)
*a stopping place or assembly point en route to a destination.*

Q：Git = GitHub ?
A：錯誤，GitHub、GitLab、BitBucket都是'remote repository'

### Git基本指令

- **add**：將working directory的modified file加入staging area

$ git add <filename1> <filename2>
$ git add *.png || dirname
$ git add .                        //一次stage所有更動
$ git add -i                       //interactive

- **commit**：將目前在staging area的所有staged file做成一個版本快照，提交到repository

$ git commit -m "我修改了某某feature"  //
$ git commit --amend                 //

- **push**：將local repo的commit同步到remote repo上

//如果從 git clone 開始的
$ git push //失敗請檢查 git remote -v

//如果是用 git init 開始的
$ git remote //看看你有沒有 remote repo，沒有的話去 GitHub 創一個

$ git remote add origin git://github.com/johndoe/myproject.git
$ git remote -v
origin  git://github.com/schacon/ticgit.git

- **git pull**：從remote repo把線上的最新版抓下來
`$ git pull`
`$ git pull --no-ff`
- **status**：隨時檢查三個工作區的狀態
`$ git status`
- **log**：檢視commit歷史
`$ git log`
`$ git log --graph //顯示線圖`
`$ git log --graph --oneline //顯示線圖、精簡commit資訊`

### 從GUI上感受一下(demo)

## Ex 1 從 pull 到 push

**Step 1** 在 [TODO2](https://hackmd.io/MYTgbA7AzADApgDgLRwhArEgLAMxiJAIyh0JRgEZCEZ1ItEg?both#part-0-準備) 留下你的GitHub username，讓我把你加為專案的collaborator（取得push到remote repo的權限*），然後去收信

**Step 2** 在本機設定user資訊，才知道是誰commit的

$ git config --global user.name "John Doe"
$ git config --global user.email "[e-mail]"
$ more ~/.gitconfig                // 偷看一下其它 config 有什麼
$ git config --global color.ui true
$ ...

**Step 3** 從remote repo把一個專案clone下來開發

$ git clone https://github.com/choznerol/c4lab-git-tutorial.git
$ cd c4lab-git-tutorial            // 進入working directory
$ ls -al                           // 觀賞一下git專案的目錄
$ cd exercise-1_from-pull-to-push  // Ex1目錄
$ vim myusername.py                // 以你的username建立一個檔案
$ git status                       // 紅色是modified file，綠色是staged file

**Step 4**

$ git add myname.py                // stage你的更動  
$ git commit -m "Added myname.py"  // 輸入有意義的commit訊息
$ git log                          // 檢查

### 觀摩一下複雜版

## Part 2：Git協作：branch和merge

$ git branch                     //顯示目前有的分支

$ git branch my-branch           //創一個新分支`
$ git checkout my-branch         //切換到new-branch
$ git checkout master            //切換回到master分支

$ git checkout -b feature-1      //創一個分支並切換過去

$ git merge my-branch            //把new-branch merge回目前所在分(master)
                                 //編輯檔案解決conflict
$ git commit -m "merge my-branch into master"

$ git branch -d my-branch        //刪除my-branch

push失敗：

## Ex 2 現場多人協作練習

開一個 branch 編輯`ex2-coworking.py`加入自己的名字，嘗試merge直到成功push

$ git checkout -b adding-john
$ vim ex2-coworking.py                          //加入你的名字
$ git add ex2-coworking.py
$ git commit -m "Add john to ex2-coworking.py"  //在adding-john上commit
$ git checkout master                           //切回master準備merge
$ git merge adding-john                         //把adding-john分支merge進來（master）
$ git pull                                      //若pull回來有衝突就再次編輯檔案解決
$ git push                                      //若失敗就再pull

## Part 3 IDE的git整合（以PyCharm為例）
- Why use IDE?
- Debugger（[使用教學](https://www.youtube.com/watch?v=QJtWxm12Eo0&index=7&list=PLQ176FUIyIUZ1mwB-uImQE-gmkwzjNLjP)）
- Refactor
- 整合版本控制（[基礎](https://www.youtube.com/watch?v=_w9XWHDSSa4&index=12&list=PLQ176FUIyIUZ1mwB-uImQE-gmkwzjNLjP)、[進階](https://www.youtube.com/watch?v=AHkiCKG-JhM&index=13&list=PLQ176FUIyIUZ1mwB-uImQE-gmkwzjNLjP)）
- Demo!
- PyCharm官方教學（[播放清單](https://www.youtube.com/playlist?list=PLQ176FUIyIUZ1mwB-uImQE-gmkwzjNLjP)）

## Part 4 進階主題
- 不是Collaborator怎麼協作？ 發PR
- Private repo？[GitHub Student Package](https://education.github.com/pack)
- Git共享巨大檔案？[Git LFS](cyruschiu.github.io/2016/09/26/using-git-lfs/) 或用 dropbox 加 wget
- 每次push都要輸帳密好麻煩？[設定ssh-key](https://git-scm.com/book/zh-tw/v1/%E4%BC%BA%E6%9C%8D%E5%99%A8%E4%B8%8A%E7%9A%84-Git-%E7%94%9F%E6%88%90-SSH-%E5%85%AC%E9%96%8B%E9%87%91%E9%91%B0)