取得你的專案¶
課程的程式都放在 Gitea 這個網站上。這一步要在 Gitea 上拿到一份屬於你的 Pac-Man 專案,再把它下載到電腦。
1. 登入 Gitea¶
- 打開 https://git.gridplusplus.ntuee.org。
- 帳號是你的學號,初始密碼由助教提供。
- 第一次登入會要求你設定新密碼,請設定一組自己記得住的密碼。
Gitea 上的作品只有修課同學看得到
沒有登入的人什麼都看不到。
2. Fork 一份 Pac-Man 專案¶
- 打開 https://git.gridplusplus.ntuee.org/GridPlusPlus/GridPlusPlus-Pacman。
- 按右上角的 Fork,下一頁直接按確認的按鈕。
完成後,網址會變成 .../你的學號/GridPlusPlus-Pacman。
Fork 是什麼?
Fork 會把整個專案複製一份到你的帳號底下。之後你修改的都是自己那一份,不會影響到別人,也不會改到原本的專案。
3. 設定 Git(只要做一次)¶
Git 是負責下載、保存程式的工具。打開終端機,貼上下面三行,記得先把 你的學號 換成自己的學號:
git config --global user.name "你的學號"
git config --global user.email "你的學號@ntu.edu.tw"
git config --global credential.helper store
這三行執行後不會有任何輸出,這是正常的。
這三行在做什麼?
前兩行告訴 Git「存檔的人是誰」,之後每次存檔都會記下你的學號和學校信箱。email 只用來標示作者,Git 不會寄信給你。
第三行讓 Git 記住你的 Gitea 密碼,之後就不用每次輸入。密碼會存在電腦的 ~/.git-credentials 檔案裡,所以請不要在公用電腦上執行這一行。
4. 把專案下載到電腦¶
同樣先把 你的學號 換掉,再貼到終端機:
不想自己改網址?
在你 fork 出來的專案頁面上,有一個顯示 HTTPS 網址的框框,旁邊有複製按鈕。在終端機打 git clone (後面有一個空格),再貼上複製的網址就可以了。
按下 Enter 後,終端機會先問你的帳號,畫面會停在這一行等你輸入:
輸入學號,按 Enter。接著它會問密碼:
輸入 Gitea 密碼,按 Enter。打密碼時畫面上什麼都不會出現(連 * 都沒有),這是正常的,照常打完按 Enter 就好。
只有第一次會問
因為第 3 步設定了 credential.helper store,輸入一次之後 Git 就會記住,之後 git push、git pull 都不會再問。
最後確認一下,執行:
看到 main.cpp、pacman.db、GridPlusPlus.h 等檔案,就代表下載成功了。
常見問題¶
出現 Authentication failed
學號或密碼輸入錯誤。重新執行一次 git clone 那一行,仔細輸入即可。
出現 Repository not found
確認網址裡的學號是不是自己的,以及第 2 步的 Fork 有沒有完成。
出現 destination path 'GridPlusPlus-Pacman' already exists
代表之前已經下載過了,不需要再下載一次,直接進行下一步。