Version 7.1

See the changelog of this version for a detailed list of changes.

  • 0.126.0 Minimum required Hugo version

  • Breaking Change requiring action after upgrade

  • Change Change of behavior, may require action

  • New New behavior, often introducing new options

7.1.0 (2024-10-25)

Change

  • Change The sidebar menus are now completely configurable.

    This is provided by the new parameter sidebarmenus. With the new system, you can

    • show arbitrary amounts of menus
    • set headings for each menu
    • base it on your page structure or use Hugo’s menu feature
    • configure a starting page if a menu is based on page structure
    • display unlimited nesting for both menu types
    • reconfigure the menus in a page’s front matter
    • apply the usual parameter alwaysopen, collapsibleMenu, etc. for all menu types

    You don’t need to change anything in your existing installation as the old configuration is used as a default.

  • Change The children shortcode was changed to output a page’s LinkTitle instead of previously using the Title.

    As the shortcode always outputs subpages in context of the parent page, it functions similar to the sidebar menu. The sidebar menu itself uses the LinkTitle for naming the menu entries and so should the shortcode do.

    The parameter value sort=linktitle was deprecated for the easier sort=title. You can still use the old value but both behave the same way in sorting by LinkTitle.

New

  • New Menus created by your page structure are now able to contain arbitrary links inserted into the structure using the menuUrl or menuPageRef front matter.