2020-02-12 21:12:41 +00:00
|
|
|
<!--
|
|
|
|
|
Partial to generate page name from Title or File name.
|
|
|
|
|
Accepts Page as context
|
|
|
|
|
-->
|
2019-07-16 14:36:40 +00:00
|
|
|
{{ $title := "" }}
|
|
|
|
|
|
(MAINT) Respect LinkTitle in page metadata (#483)
Prior to this commit, the partial for determining a page title used the
`Title` property of a page, if present, or humanized and titleized the
file name if not.
It did not use the `LinkTitle` property at all (defined in the
[front matter][01]). According to the [menu documentation][02]:
> The following order is used to determine an Identifier:
>
> `.Name > .LinkTitle > .Title`
>
> This means that `.Title` will be used unless `.LinkTitle is present,
> etc.
Similar, the documentation for [menu entry variables][03] states:
> The `name` key, if set for the menu entry, sets this value. If that
> key is not set, and if the menu entry is set in a page front-matter,
> this value defaults to the page's `.LinkTitle`.
Together, these imply that if `.LinkTitle` is specified, it should be
preferred over `.Title` for the generated nav menu.
[01]: https://gohugo.io/content-management/front-matter/
[02]: https://gohugo.io/content-management/menus/#nesting
[03]: https://gohugo.io/variables/menus/#menu-entry-variables
2022-10-05 08:01:03 +00:00
|
|
|
{{ if .LinkTitle }}
|
|
|
|
|
{{ $title = .LinkTitle }}
|
|
|
|
|
{{ else if .Title }}
|
2019-07-16 14:36:40 +00:00
|
|
|
{{ $title = .Title }}
|
|
|
|
|
{{ else if and .IsSection .File }}
|
2020-03-31 21:29:21 +00:00
|
|
|
{{ $title = path.Base .File.Dir | humanize | title }}
|
2019-07-15 16:25:21 +00:00
|
|
|
{{ else if and .IsPage .File }}
|
|
|
|
|
{{ $title = .File.BaseFileName | humanize | title }}
|
|
|
|
|
{{ end }}
|
|
|
|
|
|
|
|
|
|
{{ return $title }}
|
