浏览文档

Title

2024年3月8日 2 分钟阅读 文档 模板 标题

为页面生成带有分隔符、栏目和国际化的分页信息的标题。

赞助

成为我们的资助者或赞助商，以支持我们的工作。

爱发电 GitHub 赞助商 PayPal
本页内容
赞助商
Title

配置

hugo.yaml

1params:
2  title_sections: true
3  title_separator: '-'

hugo.toml

1[params]
2  title_sections = true
3  title_separator = '-'

hugo.json

1{
2   "params": {
3      "title_sections": true,
4      "title_separator": "-"
5   }
6}

参数

title_separator

名称上下文类型必填默认值版本示例
title_separator-string----

标题分隔符。

title_sections

名称上下文类型必填默认值版本示例
title_sections-boolean-true--

为 false 时隐藏栏目标题。

title_sections_depth

名称上下文类型必填默认值版本示例
title_sections_depth-number----

栏目的最大深度。

title_sections_depth_dir

名称上下文类型必填默认值版本示例
title_sections_depth_dir-string-end--

栏目数目计算方向，为 start 时，深度是从根部开始计算的。

用法

 1{{/* baseof.html */}}
 2<html>
 3  <head>
 4    <title>
 5      {{ block "title" . }}{{ partial "base/title" . }}{{ end }}
 6    </title>
 7  </head>
 8  <body>
 9    {{ block "main" . }}{{ end }}
10  </body>
11</html>

 1{{/* list.html */}}
 2{{ define "title" }}
 3  {{ $mainSections := slice "blog" }}
 4  {{ $pages := where .Site.RegularPages "Type" "in" $mainSections }}
 5  {{/* We MUST initialize the paginator first. */}}
 6  {{ .Store.Set "paginated" true }} {{/* Indicate current page is a pagination page. */}}
 7  {{ $paginator := .Paginate $pages 10 }}
 8  {{/* Then include the title partial. */}}
 9  {{ partial "base/title" . }}
10{{ end }}
11
12{{ define "main" }}
13  {{/* Use the initialized paginator above. */}}
14  {{ range .Paginator.Pages }}
15    {{/* List pages. */}}
16  {{ end }}
17  {{ template "_internal/pagination.html" . }}
18{{ end }}

示例

PageKindTitle
/HomeMy Site.
/page/1ListMy Site - Page 1 of N.
/page/2ListMy Site - Page 2 of N.
/blogSectionBlog - My Site.
/blog/page/1SectionBlog - Page 1 of N. - My Site.
/blog/page/2SectionBlog - Page 1 of N. - My Site.
/blog/helloPageHello world - Blog - My Site.
/blog/fooSectionFoo - My Site.
/blog/foo/barPageBar - Foo - My Site.
Partial If Exists