跳到主要内容

任务型 recipe · ARC 2.0.0-beta.28

实作指南

按任务组织的站点与 AUP 组合路径,只链接规范单元页与已验证指南——不在此复述组件 API。

当你已经知道结果(第一站、列表页、文档 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)

  1. 第一站 — 已验证入门 + layout 单元的最小静态站。
  2. 集合列表页 — content 对象 + 列表 layout 组件。
  3. 文档 boarddocs-page surface 与相关 chrome。
  4. 文章中的 slides — MD slides 结构 + deck widget。
  5. 绑定 source 到 layout$source.<name> 写入 layout section。

Showcase 证据映射

  • Showcase 映射 — showcase-dsl / showcase page id → primitive/widget 单元页,以及本地运行说明(不在本站全量托管)。

旧叙事 recipe

这些页面保留更长的叙事纵切与证据边界。只需要单元页链条时,优先用上面的任务型 recipe。

  1. 最小信息站 — 已验证 route/layout/component 基础叙事。
  2. 内容站 — collection 纵切叙事与当前证据边界。
  3. 自定义组件 — 第二个真实页面需要同一呈现时。
  4. 定制主题与 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/