这个 recipe 有意从第一个已本地验证的 Web Device path 开始。它是小型信息站点,不是通用博客 starter,也不是部署流程。
建立已验证基础
按建立第一个站点创建:
.route/web
.web/site.yaml
.web/components/hello/{manifest.json,render.js,style.css}
pages/index/layout.aup随后新增一个命名页面目录,例如 pages/about/,给它自己的 layout.aup 和已有 site component。navigation 必须是显式决定:建立 pages/about/ 只让 route 成为可能,不会自动出现在每一个 header/menu。
让第一次验收保持很窄
- 运行 lint、validation、blocklet check 和 build。
- 直接本地运行 blocklet,不做 DID Space 部署。
- 在命令实际打印的 URL 打开 home 和命名页面。
- 检查窄视口和一条内部导航路径。
- 只有两个页面确实都需要时,才抽取 shared header/footer component。
已验证基础有意以 component 为主。不要靠把 article body 粘进 layout 把它写成 content-site;站点真正需要 collection 时,再添加 content object 和 source binding。