站点矩阵(sites matrix)
控制内容为哪些站点生成的配置对象,是语言、角色与版本三个维度的交集。
开始之前,你需要
- 在文档里遇到不认识的 Hugo 术语时查阅
读完之后你能
- 能判断一份内容或一个模板该出现在哪些站点,并知道矩阵写错时的典型症状
接着读:前置元数据
站点矩阵(sites matrix)是在内容前置元数据或文件挂载中定义的配置对象,用于精确控制内容应为哪些 sites 生成。在文件挂载中为模板定义时,它控制该模板将应用于哪些站点。在 Hugo 的多维内容模型中,该矩阵定义了三个维度的交集:language、role 和 version。该配置的结构是一个由 glob slices 组成的映射。
另请参见 sites complements、front matter: sites、module mounts: sites 和 segments: sites。
为什么重要
启用语言、角色或版本之后会产生站点矩阵;不加以约束,同一篇文章就会出现在所有站点上。sites.matrix 是「这份内容只发到哪几个站点」的开关,可以写在内容前置元数据里,也可以写在文件挂载里(此时控制模板应用到哪些站点)。glob 写错或漏掉排除项,最典型的现象是内部文档出现在不该出现的站点上。
延伸阅读:前置元数据 sites 字段、模块挂载 sites