跳到主要内容

功能

Foundation 提供什么,以及它在何处刻意停下。

Foundation 是可复用的网站基础。本页的所有内容都存在于项目中,并可由每次部署进行配置,而下方的边界与能力同样是有意为之。

  • 六个能力族,全部通过配置而非编码实现
  • 本页每个主张背后都有仓库中的证据
  • 边界被表述为架构范围,而不是缺失的功能

包含什么

每个能力族都说明企业最先注意到的变化、产生它的机制,以及需要您提供的部分。

  • 品牌标识与内容

    名称、标语、描述、导航、页面与集合都在属于您的配置和文件中,而不是散落在模板里的代码:修改只需一处。

    内部机制

    严格校验的站点配置,以及带 frontmatter 的 Markdown 页面,通过内容仓库接口读取;导航顺序与页面是否存在是两件不同的事,因此菜单无法凭空创造页面。

    需要您提供

    标识取值、文字、集合,以及可选能力的取舍。

  • 呈现

    由于布局、间距和排版系统已经建好,网站从第一天起就显得整齐一致,而品牌重塑就是替换一组已命名的视觉角色。

    内部机制

    基于设计令牌的呈现层,包含浅色与深色方案以及单一强调色;标志、favicon、社交预览、横幅、背景和图形角色都是配置,缺少角色时不会绘制任何内容。

    需要您提供

    品牌视觉素材、强调色选择,以及您添加的任何自定义呈现。

  • 国际化

    新增语言是内容工作而不是开发项目:一个字典文件加一个内容目录,而且在翻译未完成时网站依然完整可用。

    内部机制

    基于路径的语言与语言协商、每种语言通过 schema 校验的界面字典、按页面回退到默认语言的内容回退,以及仅为真正有页面的语言生成的语言标注。

    需要您提供

    您的翻译与语言组合。

  • 可见性

    搜索引擎与社交预览能获得正确的标题、规范地址和结构化数据,无需有人逐页记得添加。

    内部机制

    由配置与内容派生的按路由元数据、由内容模型与实际语言组合生成的站点地图、引用它的 robots 输出、Open Graph 与 Twitter 卡片,以及由配置构建的 schema.org 结构化数据。

    需要您提供

    您的域名、描述,以及您添加的活动或分析元数据。

  • 连接

    您已在使用的服务保持原样。Foundation 呈现访客意图并把它传递出去,因此更换服务商是配置变更而不是重建。

    内部机制

    位于按能力划分的工厂之后、不依赖服务商的集成点,由配置选择,并显式标注关闭状态,让未使用的能力不产生成本。

    需要您提供

    您在这些服务商的账号及其费用。

  • 工程质量

    变更会被自动检查,因此后续修改悄悄弄坏无人查看的页面的可能性大大降低。

    内部机制

    对配置和字典进行 schema 校验、由测试证明的架构边界、已提交的真实浏览器验证矩阵、对已记录令牌组合的自动对比度检查,以及资源、类型、lint、测试和构建关卡。

    需要您提供

    没有 —— 这是您继承的部分,也正是它让列表中其余部分值得信赖。

Foundation 不打算替代的东西

Foundation 呈现业务并把访客意图交给您的系统。它刻意在系统本身之前停下。

  • 您的 CRM 与客户数据
  • 您的财务与开票
  • 您的支付记录与卡片处理
  • 您的预订或排班运营数据库
  • 您的客户账号与登录
  • 您的库存以及更广泛的运营

这些是边界,而不是缺陷。想要包揽一切的网站会更难持有、更难修改,也更难交接。

本页主张的来源

上述每项能力都可以在仓库中验证,而不只是在此声明。以下是支撑它们的维护文档。

  • 架构

    分层、依赖方向,以及由测试强制执行的边界。

  • 定制

    如何在不接触平台代码的情况下修改配置、内容、字典与资源。

  • 品牌资源

    已命名的视觉角色,使替换标识素材成为一项明确任务而不是搜寻。

  • 部署

    构建好的网站如何部署到采用方自己的账号与域名。

  • 手册

    从获取 Foundation 到排障的完整采用路径。

本站对这些文档做概述,而不会成为它们的第二份副本。

看看它如何运行

两个不同的企业在这个基础上运行。看看它产出什么,并阅读各部分如何衔接。