Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

(MAINT) Respect LinkTitle in page metadata #483

Commits on Sep 11, 2022

  1. (MAINT) Respect LinkTitle in page metadata

    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
    michaeltlombardi committed Sep 11, 2022
    Copy the full SHA
    30da320 View commit details
    Browse the repository at this point in the history