瀏覽文檔

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