GitLab 基本教學

前言

GitLab 是個整合軟體開發平台，SITCON 使用專案管理相關功能輔助籌備，僅需專注於 GitLab 網頁側邊功能欄的 Issue 及 Wiki 功能即可。

實用小提示
可以透過 Pin 的方式把常用功能置頂方便尋找

關鍵連結

• 夏令營 2025 籌備事項看板
• 夏令營 2025 籌備 wiki
• 批次開卡

如果你熟 GitLab

請點文件大綱了解 Issue Detail 欄位說明及基本原則及 Label 意義

如果你沒有使用過 GitLab

可以打開 Playground Project 隨意新增修改 issue 操作嘗試

基本概念及界面介紹

每個 issue 都是要處理的一件事，事情不要放腦袋想到就可以先列上避免遺忘，

列表檢視

這個列表就是在搜尋時好用，平常其實很少點進來

看板檢視（Board）

Board 可能有預設篩選條件，並且會根據篩選出來的 issue 分配到預先設定的 List 中，每個 list 可能代表一個狀態，通常由左而右是卡片的一個完整生命週期。
你可以按住拖曳卡片更改他所在的 list，每一個 list 的卡片上下順序也都會被記憶，可以把相對優先緊急的事情往上方一點移動避免遺忘。

issue 看起來就像張卡片，大家稱呼的卡就是 issue 別懷疑；board 頁面如果開了很久沒動建議重整一下網頁，以確保卡片狀態是最新的

切換看板

根據你所在的組別需要專注的事情不同，可以點左上方下拉選單切換看板，也可以把連結加入書籤方便自己常常檢視 issue 狀態

搜尋/篩選 issue

在兩個檢視方式上方都有搜尋列，可以使用關鍵字、被指派人、Label …… 等搜尋

新增 Issue

推薦方式

在 Board 所在的 List 有上方戳三個點點就會有 Create new issue 的按鈕，戳了就會長出一張卡片可以開始打字，完成後會自動套用目前所在 Board 和 List 的 label 十分方便！

如果有更多細節資訊想要填寫，點一下卡片就會在右方有側欄能夠編輯 issue details；點擊卡片標題也能進入卡片的詳細頁面點右上的筆編輯補充更多 issue 描述讓別人懂你要做什麼喔！

批次開卡

有一件事需要委派各組協助完成並且希望能夠方便追蹤各組完成狀況，可以先行建立追蹤的母卡，接著透過批次開卡小精靈來批次建立卡片，當然也別忘記要在 Options 的地方勾起相關 issue 並填上母卡的 id，就可以快速開啟各組需要執行的追蹤卡片了！

另外的方式

在 List 右上方有個 New Issue 按鈕，如果需要透過範本（目前還沒有，如果你想建可以參考這邊）建立 issue 才比較推薦從這邊開；透過這邊建立的 issue 請記得套用 label 及指定相關負責人

Issue Detail 欄位說明及基本原則

Assignee

這件事情的負責人，原則上請 Assign 給一個人好確認該追殺誰

Labels

這件事情的相關標籤，包含狀態、組別、分類… 等，請參照 Label 意義說明；Team 的 label 被設定了只能標記一組，也是為了確保這件事該追哪一組進行。
如果你有一件事情需要多組協助幫忙，可以使用批次開卡魔法協助你快速建立多張 issue。

Due date

預期被完成的日期或是提醒下一步動作的日期，GitLab 會在快到期前發信通知

Label 意義

Scoped label

長這樣的就是 Scoped label，同時只能被掛上一個不能重複，沒有薛丁格的狀態這種事。

其他 Label

請參考專案 Label 的說明

其他參考資料

• GitLab Flavored Markdown (GLFM)
  有些奇妙語法可以稍微滑過看看
• Description templates