跳到主要内容

任务型 recipe · ARC 2.0.0-beta.28

实作：文章中的 slides

用 MD 结构单元与 deck widget 单元把 Markdown 文章变成 slides——不在此复述 API。

任务： 一个 content 对象（文章或文档）在浏览器中以 slides 呈现（当 slides 路径可用时）。本页只链单元合同。

结果

  • Front matter 打开 slides 路径
  • 顶层 HR / thematic break 成为分页边界
  • 运行时含 slides player 时浏览器显示 slides chrome；否则按单元页所述走诚实的服务端 transcript fallback

步骤（只链出）

  1. 在 content/articles/ 或 content/docs/ 写普通 Markdown 对象 —— 对象规则：内容对象、元数据与 locale。
  2. 启用 slides 并理解 HR 边界：
  3. 薄 hub（仅导航）：撰写与嵌入 Markdown slides。
  4. 运行时挂上 player 时的演示页：Slides demo。

规范单元（此处不复述 props）

角色单元页层
打开 slides 路径slides-front-matterMD structure
分页边界thematic-breakMD structure
AUP deck / slides player（仅 Web widget）deckAUP widget — 不是 layout component
幻灯片内可选富媒体media · image (inline)primitive / MD

分层纪律

  • MD 结构（slides: true、HR）在 /docs/web-device/markdown/…。
  • deck 是 AUP widget，不是 Web Device theme component，也不是跨设备 primitive。合同：deck widget。
  • 不要把 product-showcase 这类 layout component 当 slides API。

Fallback 诚实边界

没有 slides: true → 普通文章。运行时没有 slides widget → 仅服务端 transcript。这些说法归上面的单元页；本 recipe 不另编第三条 fallback 故事。

相关