GitHub 教學:上傳作業

Roan

2023年6月27日 上午 2:45

Solidity

開發班學員通常需要以 GitHub 上傳繳交作業等資料,本文教大家如何繳交作業。

先前準備

  1. GitHub 申請帳號
  2. 將帳號 ID 提供給課程助教,請助教開啟課程權限。
  3. 安裝終端機。 Mac 已有內建,也叫做「終端機」;Windows 請下載 GitBash
  4. 視課程要求安裝其他軟體,例如撰寫程式碼的文字編輯器,或是遊戲製作工具......等。

上傳作業步驟

  1.  Git Clone:複製課程資料夾結構到自己本機中。
  2. 創造分支。
  3. 在分支製作作業,並把作業放到對應當週的資料夾。
  4. Git Push:上傳作業。

以下以 Windows 11 的環境示範,逐一詳細解釋。

I. Git Clone:複製課程資料夾結構到自己本機中

打開 Git Bash,以"mkdir 資料夾名稱" 創建母資料夾、"cd 資料夾名稱" 前往資料夾的位置。以下為例,創建了一個叫做 z_homework 的資料夾並前往該資料夾。以後如果參加許多學院的開發班,都可以把每個開發班的資料夾集中放在 z_homework 母資料中當成學院作品集。

 

接著到課程 Repository (簡稱 repo)複製課程的 Git 連結。

 

於終端機輸入:

git clone 連結 設定資料名稱

例如以下設定資料夾名稱為 hw1。

 

檢查一下,確定已經複製好課程資料夾。

 

II、創造分支

什麼是分支?

可以把 GitHub 的分支 (branch)想像成許多平行宇宙。課程是「正史」宇宙,名稱為 main 或 master;大家以自己的學號創造的分支是平行宇宙。

假設共有 4 位同學,分別為 Z01~Z04,則每個人往後各別管理自己的分支。


 

在創造分支之前,一開始的預設分支,也就是剛 git clone 複製好的「正史」,名稱為 main 或 master。

於 Git Bash 輸入指令:

git branch 學號

創造分支(在此以 Z23057099 為例)。但此僅為創造分支而已,要前往該分支,要再輸入指令:

git checkout 學號

這樣才能前往該分支。也可以一條指令同時創造並前往分支:

git checkout -b 學號

這樣便完成了分支,接下來就可以做作業了。

III. 在分支製作作業,並把作業放到對應當週的資料夾

每個禮拜的資料夾都有 readme 檔案。可以在 readme 中加以說明作業,例如中間有沒有發生什麼問題、如何解決、有沒有什麼新發現……等。Readme 可以用文字編輯器(如 VS Code) 修改。

假設 Week 1 作業是畫一張圖,畫好後放到 hw1 / Week 1 資料夾,並修改 readme 說明

 

IV. Git Push:上傳作業

製作完後,分別輸入以下指令

git add .

git commit -m “說明文字”

上述的「說明文字」是用來給說明本次的修改做了什麼事情,在專案協作上可以用這個檢查專案的修改歷程。在這邊只要簡單說明就好。

輸入指令上傳作業:

git push -u origin 學號

 

最後到 GitHub 切換並查看分支

 

上傳成功!(ノ>ω<)ノ

 

注意事項

請維護好自己的分支就好,確保自己無論是製作作業還是上傳,都在自己的分支上!避免修改到 main (正史)或是其他同學的分支 (別人的平行宇宙),否則會造成宇宙混亂!

文章標籤

# github