甘特图

甘特图是排在日历上的计划。它以 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 —— 会被指出。
• 相互等待形成循环的任务会被指出；请为其中一个指定开始日期。
• 结束早于开始的任务，或两个任务使用了同一个名称，都会被指出。

问题页面列出了每种情况的具体措辞。