甘特圖

甘特圖是排在日曆上的計劃。它以 gantt 及其標題開頭。

gantt Launching the site
start: 2026-11-02
skip: weekends
today: 2026-11-12
section Design
Sketches: 3d [done]
Mock-ups: after Sketches, 4d [done]
section Build
Pages: after Mock-ups, 6d [active]
Search: after Mock-ups, 4d
Testing: after Pages and Search, 3d [critical]
section Ship
Launch: after Testing, milestone

設定

設定	別名	值
start	starts, begin, from	在沒有其他說明時任務的開始日期
today	now, status date	用一條線標記的日期
skip	excludes, exclude, holidays	weekends，以及不工作的日期，以逗號分隔：skip: weekends, 2026-12-25
dates	date format, axis format, format	日曆書寫日期的方式，採用 D3 時間格式：%b %d 表示 Nov 02，%d/%m 表示 02/11

任務

每一行是一個任務：任務名、一個冒號，然後是開始時間和所需時長，以逗號分隔。

部分	含義
3d, 1w, 4h, 1d 4h	所需時長，以天、周、小時或分鐘計
2026-11-02, from 2026-11-02, on 2026-11-02	開始的日期
after Pages, after Pages and Search, after Pages, Search	在所列出的每個任務都結束後開始
until 2026-11-20, to …, end …，或第二個日期	結束的日期，包含當天
milestone	一個時刻而非一段時間，繪製為菱形

沒有指定開始的任務，會在其上方任務結束時開始，或在圖表的 start 開始；沒有指定時長的任務佔用一天。after 後的任務名匹配時不區分大小寫。跳過的日期不計入時長，任何任務也不會在這些日期開始。

任務狀態

任務名或時間之後方括號中的單詞，說明任務的進展情況：

單詞	別名	繪製方式
done	complete, completed, finished	灰顯
active	current, now, in progress, doing	填充
critical	crit, urgent	紅色輪廓
milestone		菱形

方括號中的顏色會為任務著色。

分節

section Name 為其後的任務加上標籤，其色帶在這些任務後方橫貫整個日曆。

計劃可能出現的問題

• 任務所等待的任務在圖表中不存在時，會連同所給的名稱一起被指出。
• 任務沒有可以作為起點的日期 —— 既沒有自己的日期，上方也沒有任務，也沒有 start —— 會被指出。
• 相互等待形成迴圈的任務會被指出；請為其中一個指定開始日期。
• 結束早於開始的任務，或兩個任務使用了同一個名稱，都會被指出。

問題頁面列出了每種情況的具體措辭。