跳到主要内容

文档草稿

编写站点

Web Device 文档草稿:配置、组合和扩展一个已有站点。

本节按修改站点的工作组织:配置全站行为,组合页面和内容,再使用组件与主题扩展它。每页都会写明当前版本边界,不把未完整的 contract 伪装成捷径。

按这个顺序阅读

  1. 全站配置:了解当前配置职责和 legacy 边界。
  2. 组合页面与布局:了解页面级组合模型。
  3. 把内容绑定到页面:使用有名称且有 scope 的内容数据。
  4. 使用与覆盖组件:查看 beta.25 的组件规则与 resolver 顺序。
  5. 主题与 tokens:配置视觉值,不要假定存在可直接选择 overlay 的入口。
  6. Web Device 内容 Markdown:查看内容对象语法及其 source-plus-rendered 证据。
  7. 限制谁能读一页:集合默认值、记录 access 与 serve-time 门。
  8. 收藏与笔记(save 能力)blocklet.yamlsave:、展示模式,以及 bookmark/annotate action。