跳到主要内容

任务型 recipe · ARC 2.0.0-beta.28

实作：第一站

按既有入门步骤与单元页顺序，搭出可本地运行的最小 Web Device 站点——不在此复述组件 API。

任务： 本地静态站点，一个首页路由 + 一个具名页面。本页只编排已有单元页与指南链接，不重写 component / primitive / Markdown 合同。

结果

  • .route/web + .web/site.yaml + 至少一个 pages/<name>/layout.aup
  • 页面上使用一个 theme 或站点 layout component
  • 本地 check + 用 CLI 打印的 URL 打开浏览器

步骤（只链出）

  1. 安装并确认 CLI 版本：安装 ARC CLI。
  2. 确认这是静态 Web Device 站点（不是交互式 AUP app）：准备与适用范围。
  3. 写出已验证的最小文件集：建立第一个站点。
  4. lint / validate / check / build，再打开 CLI 打印的 URL：运行、检查与查看。

会碰到的规范单元

在本路径上的角色单元页（合同只在那边）
页面壳 / 分区page-stack · page-sections
站点 chrome（可选后加）portal-header · portal-footer
AUP 容器（若页面上放 document 树）view · text · action

布局组合规则（非单元 API）：组合页面与布局 · AUP 布局边界。

这里不要做

  • 不要为 layout component 发明 props —— 读该名字的单元页。
  • 不要把文章正文贴进 layout.aup 就叫内容站 —— 下一步用 实作：集合列表页。
  • 首次验收不要部署到 DID Space。

下一则 recipe