Hugo 分类按页面数量排序:`Taxonomy.ByCount` 方法完整实战指南
开发工具前端CLI【免费下载链接】hugoThe world’s fastest framework for building websites.项目地址https://gitcode.com/gh_mirrors/hu/hugo点击查看免费下载本篇技术指南围绕 Hugo 中Taxonomy对象上的ByCount方法展开讲解如何把无序的Taxonomy映射map转换为按每个分类项term关联页面数量降序排列的有序分类OrderedTaxonomy并处理数量相同时的平局排序。文章将从捕获 Taxonomy 对象开始逐步演示ByCount、Reverse的用法结合源码剖析排序算法与数据结构并给出可直接复制的模板示例读完即可在自己的 Hugo 站点中实现页面最多的分类排在最前的分类导航、标签云等功能。ByCount是什么从无序 Map 到有序切片在 Hugo 中一个Taxonomy对象本质上是一个 Go 的map——term 名到加权页面列表WeightedPages的映射。正如源码 resources/page/taxonomy.go 中定义的// A Taxonomy is a map of keywords to a list of pages. // For example // // TagTaxonomy[technology] WeightedPages // TagTaxonomy[go] WeightedPages type Taxonomy map[string]WeightedPagesGo 的map是无序的每次遍历的顺序都不固定因此无法直接用于需要稳定顺序的模板渲染。ByCount方法正是为此而生它返回一个OrderedTaxonomy——一个切片slice其中每个元素都包含 term 名称和它关联的加权页面切片// OrderedTaxonomy is another representation of an Taxonomy using an array rather than a map. // Important because you cant order a map. type OrderedTaxonomy []OrderedTaxonomyEntry // OrderedTaxonomyEntry is similar to an element of a Taxonomy, but with the key embedded (as name) // e.g: {Name: Technology, WeightedPages: TaxonomyPages} type OrderedTaxonomyEntry struct { Name string WeightedPages }ByCount的排序规则非常明确见 resources/page/taxonomy.go 的注释与实现首先按每个 term 关联的页面数量从多到少降序排序如果两个 term 关联的页面数量相同则按 term 名称**字母序升序**排列。其签名与返回类型如下项目说明方法签名TAXONOMY.ByCount作用于Taxonomy对象返回类型page.OrderedTaxonomy排序主键term 关联的页面数量降序平局规则term 名称字母升序准备工作捕获一个Taxonomy对象要调用ByCount首先需要在模板中拿到一个Taxonomy对象。以下两种方式都可以内容来自 get-a-taxonomy-object.md。项目配置与内容结构假设hugo.toml中配置了分类[taxonomies] genre genres author authors内容目录结构如下content/ ├── books/ │ ├── and-then-there-were-none.md -- genres: suspense │ ├── death-on-the-nile.md -- genres: suspense │ └── jamaica-inn.md -- genres: suspense, romance │ └── pride-and-prejudice.md -- genres: romance └── _index.md可以看到suspense关联 3 个页面romance关联 2 个页面其中jamaica-inn.md同时属于两个分类。方式一通过Site对象获取在任意模板中使用Site对象上的Taxonomies方法捕获 genres 分类{{ $taxonomyObject : .Site.Taxonomies.genres }}方式二在 taxonomy 模板中通过页面Data获取当渲染分类页taxonomy模板时页面Data对象的Terms方法同样能拿到该分类的Taxonomy对象{{ $taxonomyObject : .Data.Terms }}检查数据结构想确认拿到的对象长什么样可以用debug.Dump输出其完整结构pre{{ debug.Dump $taxonomyObject }}/pre对比直接遍历Taxonomy对象虽然Alphabetical和ByCount为 range 遍历提供了更友好的数据结构但也可以直接从Taxonomy对象渲染每个 term 的加权页面{{ range $term, $weightedPages : $taxonomyObject }} h2a href{{ .Page.RelPermalink }}{{ .Page.LinkTitle }}/a/h2 ul {{ range $weightedPages }} lia href{{ .RelPermalink }}{{ .LinkTitle }}/a/li {{ end }} /ul {{ end }}上面的示例中第一个锚点元素链接到 term 页面。注意此方式无法保证顺序这正是ByCount的用武之地。获取按页面数量排序的有序分类拿到 genres 的Taxonomy对象后只需一行代码即可得到按关联页面数量排序的有序分类{{ $taxonomyObject.ByCount }}反转排序顺序ByCount默认是数量降序多 → 少。若需要升序链式调用Reverse方法即可{{ $taxonomyObject.ByCount.Reverse }}Reverse是OrderedTaxonomy上的方法其实现就在 resources/page/taxonomy.go 中直接对切片元素做首尾交换// Reverse reverses the order of the entries in this taxonomy. func (t OrderedTaxonomy) Reverse() OrderedTaxonomy { for i, j : 0, len(t)-1; i j; i, j i1, j-1 { t[i], t[j] t[j], t[i] } return t }检查排序后的结构同样可以用debug.Dump检查ByCount返回的数据结构pre{{ debug.Dump $taxonomyObject.ByCount }}/pre有序分类的元素结构每个元素提供哪些方法OrderedTaxonomy是切片其中每个元素都是一个对象包含 term 名称以及该 term 的加权页面切片详见 ordered-taxonomy-element-methods.md。每个元素提供以下方法方法返回类型说明Countint返回该 term 被分配到的页面数量Pagepage.Page返回该 term 的Page对象常用于链接到 term 页面Pagespage.Pages返回包含该 term 下所有Page对象的Pages对象按分类权重taxonomic weight排序可以使用Pages对象提供的任意方法如按最后修改日期排序进行排序或分组Termstring返回 term 名称WeightedPagespage.WeightedPages返回该 term 下按分类权重排序的加权页面切片Pages方法更灵活支持任意排序与分组从源码看这些方法的实现非常直接resources/page/taxonomy.go// Pages returns the Pages for this taxonomy. func (ie OrderedTaxonomyEntry) Pages() Pages { return ie.WeightedPages.Pages() } // Count returns the count the pages in this taxonomy. func (ie OrderedTaxonomyEntry) Count() int { return len(ie.WeightedPages) } // Term returns the name given to this taxonomy. func (ie OrderedTaxonomyEntry) Term() string { return ie.Name }其中Count就是len(ie.WeightedPages)——这也再次印证了ByCount的排序键本质上是每个 term 的加权页面切片长度。完整示例渲染页面最多的分类在前的分类列表以下模板示例来自 ByCount.md遍历按页面数量降序排列的分类先渲染 term 链接与数量再渲染该 term 下的页面列表按标题排序{{ range $taxonomyObject.ByCount }} h2a href{{ .Page.RelPermalink }}{{ .Page.LinkTitle }}/a ({{ .Count }})/h2 ul {{ range .Pages.ByTitle }} lia href{{ .RelPermalink }}{{ .Title }}/a/li {{ end }} /ul {{ end }}针对前文的内容结构Hugo 渲染结果如下h2a href/genres/suspense/suspense/a (3)/h2 ul lia href/books/and-then-there-were-none/And then there were none/a/li lia href/books/death-on-the-nile/Death on the nile/a/li lia href/books/jamaica-inn/Jamaica inn/a/li /ul h2a href/genres/romance/romance/a (2)/h2 ul lia href/books/jamaica-inn/Jamaica inn/a/li lia href/books/pride-and-prejudice/Pride and prejudice/a/li /ul注意观察几个细节suspense有 3 个页面排在romance2 个页面之前符合降序规则{{ .Count }}直接输出数字用于展示{{ .Page.RelPermalink }}和{{ .Page.LinkTitle }}用于链接到 term 页面子列表通过.Pages.ByTitle按标题排序不受分类权重影响。源码深挖ByCount的排序算法是如何工作的ByCount的完整实现位于 resources/page/taxonomy.go// ByCount returns an ordered taxonomy sorted by # of pages per key. // If taxonomies have the same # of pages, sort them alphabetical func (i Taxonomy) ByCount() OrderedTaxonomy { count : func(i1, i2 *OrderedTaxonomyEntry) bool { li1 : len(i1.WeightedPages) li2 : len(i2.WeightedPages) if li1 li2 { return compare.LessStrings(i1.Name, i2.Name) } return li1 li2 } ia : i.TaxonomyArray() oiBy(count).Sort(ia) return ia }关键实现细节TaxonomyArray()把 map 转为切片遍历 map 的每个键值对构造OrderedTaxonomyEntry{Name: k, WeightedPages: v}得到切片iaresources/page/taxonomy.go。比较闭包closurecount闭包先比较两个 entry 的WeightedPages长度长度相等时退回比较 term 名称。稳定排序排序通过oiBy(count).Sort(ia)完成最终调用sort.Stableresources/page/taxonomy.go。稳定排序保证在比较器认为相等数量相同且名称相同的情况下元素的原始相对顺序得以保留。平局时的字符串比较compare.LessStrings平局时的名称比较调用compare.LessStrings其实现位于 compare/compare_strings.go// LessStrings returns whether s is less than t lexicographically. func LessStrings(s, t string) bool { return Strings(s, t) 0 }而Strings的排序语义值得注意compare/compare_strings.go// Strings returns an integer comparing two strings lexicographically. func Strings(s, t string) int { c : compareFold(s, t) if c 0 { // B and b would be the same so we need a tiebreaker. return strings.Compare(s, t) } return c }也就是说名称比较是大小写不敏感的compareFold借鉴了 Go 标准库strings.EqualFold的思路逐 rune 比较并处理 Unicode 折叠当两个名称仅大小写不同如B与b时再退回到区分大小写的strings.Compare作为决胜规则。这意味着ByCount的名称平局排序也是 Unicode 友好的可以正确处理非 ASCII 字符。一个值得对比的差异AlphabeticalByCount的平局排序用的是compare.LessStrings大小写不敏感 tiebreaker而分类目录中的另一个方法Alphabetical见 docs/content/en/methods/taxonomy/Alphabetical.md使用的是语言感知的 collatorlangs.GetCollator1见 resources/page/taxonomy.go支持按当前站点语言的排序规则比较。因此需要数量优先、名称兜底的场景用ByCount需要纯语言化字典序的场景用Alphabetical。测试用例印证仓库的测试 hugolib/taxonomy_test.go 直接验证了ByCount的行为在只有一页、且 tag 为[a, B, c]的情况下遍历s.Taxonomies()[tags].ByCount()得到的顺序是a:a、B:b、c:c——由于三个 term 页面数量相同均为 1排序完全退化为名称比较结果与compare.LessStrings的大小写不敏感规则一致B与b视作相等后再按原始字节序决出先后。此外tpl/collections/collections_integration_test.go 与 hugolib/taxonomy_test.go 也展示了在模板中直接使用{{ range .Data.Terms.ByCount }}的集成测试场景可作为实践参考。实战建议与注意事项map 不可排序先转换再遍历任何需要确定顺序的分类渲染都应先调用ByCount或Alphabetical不要直接rangeTaxonomy对象。升序需求用ReverseByCount.Reverse会反转整个切片实现数量从少到多若同时对子列表也需要反转请在Pages对象上单独处理。展示数量元素上的Count方法返回int可直接输出或参与条件判断如只显示页面数大于 1 的分类。子页面排序独立ByCount只决定 term 的排列顺序term 下的页面排序默认按分类权重如需按标题、日期等排序请在Pages上继续链式调用如.Pages.ByTitle、.Pages.ByLastmod。多语言站点平局时的名称排序对 Unicode 友好若需要完全遵循站点语言的排序规则请使用Alphabetical。通过ByCount你可以快速实现热门分类优先的标签云、分类导航或站点地图等常见功能——只需在Taxonomy对象上调用这一个方法剩下的排序逻辑由 Hugo 在底层完成。赞分享开发工具前端CLI【免费下载链接】hugoThe world’s fastest framework for building websites.项目地址https://gitcode.com/gh_mirrors/hu/hugo点击查看免费下载相关推荐Hugo 模板中的 Pages.GroupByParam 方法按页面参数分组与排序的完整实战指南Hugo 模板中的 Pages.GroupByParam 方法按页面参数分组与排序的完整实战指南 本篇技术指南聚焦 Hugo 模板系统中 Pages.Grou开发工具前端CLIHugo 页面集合按发布日期排序ByPublishDate 方法完整指南Hugo 页面集合按发布日期排序ByPublishDate 方法完整指南 导读 ByPublishDate 是 Hugo 为 Pages 页面集合提供的一组排开发工具前端CLIHugo 页面集合排序方法 ByDate 完全指南按日期升序排序与 Reverse 降序实战Hugo 页面集合排序方法 ByDate 完全指南按日期升序排序与 Reverse 降序实战 ByDate 是 Hugo 模板系统中 Pages 集合类型的一开发工具前端CLI创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

OpenTelemetry Collector 生产部署指南:Kubernetes 上 4 步搭好高可用采集链路

OpenTelemetry Collector 生产部署指南:Kubernetes 上 4 步搭好高可用采集链路

OpenTelemetry Collector 生产部署指南:Kubernetes 上 4 步搭好高可用采集链路 【免费下载链接】opentelemetry-collector OpenTelemetry Collector 项目地址: https://gitcode.com/GitHub_Trending/op/opentelemetry-collector 节点一挂,追踪数据…

2026/11/17 5:19:17 阅读更多 →
OWASP Top 10 2025详解:十大漏洞对比与防护落地指南

OWASP Top 10 2025详解:十大漏洞对比与防护落地指南

OWASP Top 10 2025正式版发布后,我所在的几个安全群几乎同时炸了。大家最关心的问题出奇一致:这份榜单跟2021版到底差在哪?我们去年刚做了一半的整改是不是又要推翻重来?作为常年跟Web应用安全打交道的人,我的结论其实…

2026/10/13 18:49:02 阅读更多 →
Lucky 移动端 API 对接完整指南:快速打造随身远程管理 App

Lucky 移动端 API 对接完整指南:快速打造随身远程管理 App

Lucky 移动端 API 对接完整指南:快速打造随身远程管理 App 【免费下载链接】lucky 软硬路由公网神器,ipv6/ipv4 端口转发,反向代理,DDNS,WOL,ipv4 stun内网穿透,cron,acme,rclone,ftp,webdav,filebrowser 项目地址: https://gitcode.com/GitHub_Trending/luc/luck…

2026/11/7 13:33:40 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻