术语表

分类法对象(taxonomy object)

由术语及其关联的加权页面组成的映射。

难度
参考
预计用时
按需查阅

开始之前,你需要

  • 站点已经配置了分类法(tags、categories 之类),知道术语(term)是什么。

读完之后你能

  • 分清分类法对象(术语 → 页面集合的映射)与分类法页(一个页面);
  • 在模板里按术语取出其下的页面,并理解为什么返回的是加权页面;
  • 判断该用 .Site.Taxonomies 还是 .GetTerms。

接着读:分类法 · Taxonomy · /content-management/taxonomies/#分类法权重

分类法对象(taxonomy object)是一个 map,包含 terms 以及与之关联的 weighted pages。

为什么重要

它是「按标签建索引页」这一类需求的底层结构:键是术语(如 hugo),值是那篇术语下的页面集合(带权重)。它和数据文件里的普通 map 不一样——遍历它拿到的是加权页面对象,可以直接取 .Page.Title、.Count 等。

两个最常见的用法区分:

  • 想列出某篇内容身上挂了哪些术语 → 用 .GetTerms(页面侧);
  • 想遍历全部分类法、为每个术语生成索引页 → 用 .Site.Taxonomies(站点侧)。

弄混的典型现象是「索引页里只列出了当前文章自己的标签」,而不是全站该标签下的所有文章。

延伸阅读:分类法、Taxonomy 方法