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.mdTypeposts,可以在 front matter 中自定义 type 进行覆盖,比如

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

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

Section:对于 .Kindsectiontaxonomyterm 的页面有效,用于更细粒度的模板控制,比如 /tags/hugo 对应的 Sectiontags,此时 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

相关推荐
wj3055853781 天前
课程 9:模型测试记录与 Prompt 策略
linux·人工智能·python·comfyui
abigriver1 天前
打造 Linux 离线大模型级语音输入法:Whisper.cpp + 3090 显卡加速与 Rime 中英混输终极调优指南
linux·运维·whisper
wangqiaowq1 天前
windows下nginx的安装
linux·服务器·前端
YYRAN_ZZU1 天前
Petalinux新建自动脚本启动
linux
charlie1145141911 天前
嵌入式Linux驱动开发pinctrl篇(1)——从寄存器到子系统:驱动演进之路
linux·运维·驱动开发
Agent手记1 天前
异常考勤智能预警与处理与流程优化方案 | 基于企业级Agent的超自动化实战教程
运维·人工智能·ai·自动化
于小猿Sup1 天前
VMware在Ubuntu22.04驱动Livox Mid360s
linux·c++·嵌入式硬件·自动驾驶
cen__y1 天前
Linux12(Git01)
linux·运维·服务器·c语言·开发语言·git
不仙5201 天前
VMware Workstation 26.0.0 在 Ubuntu 24.04 (内核 6.17.0) 上的安装与内核模块编译问题
linux·ubuntu·elasticsearch
AI视觉网奇1 天前
linux 检索库 判断库是否支持
java·linux·服务器