当你已经知道结果(第一站、列表页、文档 board、slides、source 绑定),需要正确的单元页链条时,用任务型 recipe。Recipe 不复述 props、caps 或 sample 合同 —— 那些在:
/docs/aup/primitives/<name>//docs/aup/widgets/<name>//docs/web-device/components/.../docs/web-device/markdown/.../docs/web-device/surfaces/...
任务型 recipe(#299 wave 4)
- 第一站 — 已验证入门 + layout 单元的最小静态站。
- 集合列表页 — content 对象 + 列表 layout 组件。
- 文档 board —
docs-pagesurface 与相关 chrome。 - 文章中的 slides — MD slides 结构 +
deckwidget。 - 绑定 source 到 layout —
$source.<name>写入 layout section。
Showcase 证据映射
- Showcase 映射 — showcase-dsl / showcase page id → primitive/widget 单元页,以及本地运行说明(不在本站全量托管)。
旧叙事 recipe
这些页面保留更长的叙事纵切与证据边界。只需要单元页链条时,优先用上面的任务型 recipe。
- 最小信息站 — 已验证 route/layout/component 基础叙事。
- 内容站 — collection 纵切叙事与当前证据边界。
- 自定义组件 — 第二个真实页面需要同一呈现时。
- 定制主题与 tokens — 收窄的 token-first 视觉路径。
入门(任何 recipe 之前)
分层提醒
| 任务需要… | 打开单元于 |
|---|---|
| 可移植 AUP 树节点 | /docs/aup/primitives/ |
| 仅 Web 的 AUP widget | /docs/aup/widgets/ |
| Theme / 站点 layout component | /docs/web-device/components/ |
| MD 指令 / 结构 | /docs/web-device/markdown/ |
| Board 壳(docs/search/…) | /docs/web-device/surfaces/ |