甘特圖

甘特圖是排在日曆上的計劃。它以 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 —— 會被指出。
相互等待形成迴圈的任務會被指出；請為其中一個指定開始日期。
結束早於開始的任務，或兩個任務使用了同一個名稱，都會被指出。

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