在Hugo中添加自定义面包屑导航

介绍

面包屑导航对于用户和搜索引擎来说都是非常有用的导航工具。它们提供了网站页面的清晰层次结构,使用户更容易了解网站结构,也使搜索引擎更容易抓取和索引内容。

对于用户来说,面包屑导航为他们提供了一条通往当前页面的清晰路径,以及一种返回上级页面的简便方法。这改善了用户体验,使他们更有可能在网站上停留更长时间并在将来再次访问。

对于搜索引擎来说,面包屑导航提供了网站页面的清晰层次结构,使它们更容易抓取和索引内容。这提高了网站在搜索结果中的可见性,使用户更有可能找到并点击进入该网站。

如果我们自己实现面包屑导航需要使用循环递归等方法,比较麻烦,幸运的是,在Hugo v0.109.0 版本以上,添加了一个新的 .Ancestors 方法,该方法可沿树向上走到主页。 有了它,面包屑模板可以大大简化。下面我们来以我的博客为例实现一下。

一、添加模板或者短代码

你可以使用模板或者短代码的方式来实现面包屑导航,我把他直接放在了模板中。在你的路径layouts/partials/article下面新建一个文件breadcrumbs.html,里面添加下面代码

<nav class="breadcrumb" aria-label="breadcrumbs">
  <ol class="breadcrumb-list">
      {{- range .Ancestors.Reverse }}
      <li class="breadcrumb-item">
          <a href="{{ .RelPermalink }}">{{ if .IsHome }}{{ i18n "home" }}{{ else }}{{ i18n "posts" }}{{ end }}</a>
      </li>
      <li class="breadcrumb-separator">»</li>
      {{- end }}
      <li class="breadcrumb-item active">
          <a href="{{ .RelPermalink }}" aria-current="location">{{ .Title }}</a>
      </li>
  </ol>
</nav>

二、在模板中引用breadcrumbs模块

layouts/partials/article/article.html 或者layouts/partials/article/components/content.html 添加下面引用,注意breadcrumbs.html 路径。

 <!-- 添加面包屑导航 -->
{{ partial "breadcrumbs.html" . }}

三、添加i18n

如果你想使用中文,需要在i18n/zh-cn.yaml 文件中添加类似定义

home: 主页
posts: 文章列表

四、添加样式

在自定义样式custom.scss 中添加样式,以下作为参考,根据需要自行调整

.breadcrumb {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
}

.breadcrumb-item {
  margin-right: 0.5rem;
}

.breadcrumb-item a {
  text-decoration: none;
  color: #007bff;
}

.breadcrumb-item a:hover {
  text-decoration: underline;
}

.breadcrumb-item.active {
  color: #6c757d;
}

五、重新生成站点

保存所有更改后,重新生成你的 Hugo 站点,并在浏览器中查看效果。

hugo server

通过以上步骤,你可以在 Hugo 站点的文章中添加面包屑导航,提高用户导航体验。如果需要进一步定制,可以根据具体需求调整短代码、模板和样式.

本文地址

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,451评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,172评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,782评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,709评论 1 294
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,733评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,578评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,320评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,241评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,686评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,878评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,992评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,715评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,336评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,912评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,040评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,173评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,947评论 2 355

推荐阅读更多精彩内容