119、【Ubuntu】【Hugo】首页板块配置:Template Lookup Order

【声明】本博客所有内容均为个人业余时间创作,所述技术案例均来自公开开源项目(如Github,Apache基金会),不涉及任何企业机密或未公开技术,如有侵权请联系删除

背景

上篇 blog
【Ubuntu】【Hugo】首页板块配置:Template Lookup Order(.Kind)

分析了 Hugo 模板系统的继承机制 Template Lookup Order,并着重分析了里面的 .Kind 机制,以及 Hugo 可以用 .Kind 做什么,下面继续分析

搭建私人博客

继续分析
https://gohugo.io/templates/lookup-order/?spm=5176.28103460.0.0.5efd7551qOOnnF#kind

Template Lookup Order 中关于 Kind 的描述

后面这段话比较重要

  • 如果页面是单个内容页,比如一篇博客,那么该页面属于 single page,Hugo 会去找 single.html 模板
  • 如果页面是列表页,比如 home 首页,categories 分类页,tags 标签页,section 板块页,那么它们都属于 list page,Hugo 就回去找 list.html 模板

这里可以看到,首页 / 虽然特殊,但其本质上属于一个 list page ,所以当用户访问首页 / 时,Hugo 知道其 .Kind = "home",因为 home 属于 list page,Hugo 会优先找 index.html(首页专用),找不到就退一步去找 list.html

这就是 _default/list.html 能渲染首页的原因,如果没有更具体的 index.html 模板,Hugo 就会用通用的 _default/list.html 作为兜底,PaperMod 就是靠 _default/list.html 来渲染首页的 ,所以在 PaperMod 中,没有 index.html 也能显示首页,但如果用户自己新建 index.html 的话就能完全接管首页,PaperMod 选择只用一个 list.html 来搞定所有列表页,体现其极简主义的风格

OK,除了 .Kind 类型的匹配,还有如下匹配规则

  • Layout:可以在文章的 front matter 汇总指定,比如
bash 复制代码
---
layout: featured
---

此时 Hugo 就会优先查找 featured.html 模板,而不是默认的 single.html,这样可以为特殊文章使用不同的布局,比如置顶文章,广告页等等

Output Format:模板的输出格式,每个模板可以输出多种格式的页面(文件),比如 HTML,RSS,AMP,JSON 等,模板名可以包含格式名,方便辨认,比如

  • index.html:默认 HTML 模板
  • index.rss.xml:RSS 订阅模板
  • single.amp.html:AMP 加速模板

OK,继续往下看

Language:在多语言站点中,模板可按语言区分,文件命名规则 index.[lang].[format].html,比如

  • index.en.html:英语首页
  • index.zh.html:中文首页

Type:内容类型,默认为文件所在根目录名,比如 content/posts/xxx.md 的 Type 为 posts,可以在 front matter 中自定义 type 进行覆盖,比如

bash 复制代码
---
type: article
---

此时由于主动设置了 type,模板路径页随之变化,从 layouts/posts/list.html 变成 layouts/article/list.html,如果没设置,并且文章根目录为 content/,则默认 Type 为 page

Section:对于 .Kind 为 section,taxonomy,term 的页面有效,用于更细粒度的模板控制,比如 /tags/hugo 对应的 Section 为 tags,此时 Hugo 就会去找 layouts/tags/list.html(如果存在的话)

举个实际模板查找的例子

比如用户访问一个中文站点的首页(HTML 格式),并且没有设置 layout,此时 Hugo 会按照如下顺序查找模板

  • layouts/index.zh.html:Language + Kind 起作用
  • layouts/index.html:Kind 起作用
  • layouts/_default/index.html:回退到默认模板
  • themes/.../index.zh.html:查找主题下的模板
  • themes/.../index.html:查找主题下的首页
  • layouts/_default/list.html:最终兜底,因为首页 Home 属于 list page

OK,本篇先到这里,如有疑问,欢迎评论区留言讨论,祝各位功力大涨,技术更上一层楼!!!更多内容见下篇 blog

相关推荐
Lhan.zzZ8 分钟前
Linux + Qt/QML:解决 QtQuick.VirtualKeyboard.Plugins 模块加载失败与环境变量配置
linux·数据库·qt
小毛驴85012 分钟前
mvn help:effective-settings 与 mvn help:effective-pom
java·linux·前端
我先去打把游戏先24 分钟前
Git-Rebase使用指南-从原理到实战
服务器·git·嵌入式硬件·物联网·ubuntu
半杯咖啡半行码27 分钟前
Linux字符设备驱动实战:ioctl接口与GPIO操作指南
linux·开发语言
Zenova EdgeOS28 分钟前
Linux Nginx 反向代理实战:工业边缘 API 接入与安全加固
linux·nginx·安全·边缘计算·工业网关
小白鸽i42 分钟前
【Linux】已安装的软件如何重新构建deb安装包?
linux·运维·服务器
其实防守也摸鱼1 小时前
CTF Web 6 题全解 Writeup
linux·sql·学习·算法·安全·ctf·xss
考虑考虑1 小时前
JFROG手动上传包
运维·后端·自动化运维
qq_401700411 小时前
CAN 开源库大全(嵌入式/上位机,适配STM32、Linux、Qt,附带Github地址)
linux·stm32·开源
Initialize-le1 小时前
备份显示成功、恢复却失败?四步验证法
运维