mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2024-12-02 20:23:06 +00:00
47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
+++
|
|
description = "Default behavior of the navigation menu"
|
|
options = ["alwaysopen", "collapsibleMenu", "ordersectionsby"]
|
|
title = "Navigation Menu"
|
|
weight = 4
|
|
+++
|
|
|
|
The navigation menu is automatically created from [your content files](content/organization).
|
|
|
|
All configurations options apply to all pages but can be changed in each page's front matter.
|
|
|
|
## Expand State of Nested Sections
|
|
|
|
{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} Use `alwaysopen` to control how submenus appear. Set it to `true` to expand submenus, or `false` to collapse them. If not set, the first menu level is collapsed, and all others are expanded.
|
|
|
|
{{< multiconfig file=hugo >}}
|
|
[params]
|
|
alwaysopen = true
|
|
{{< /multiconfig >}}
|
|
|
|
|
|
The current page's submenus are always expanded, regardless of this setting.
|
|
|
|
## Expander for Nested Sections
|
|
|
|
{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} Set `collapsibleMenu=true` to add an expander for submenus. This shows submenus as collapsible trees with a clickable expander.
|
|
|
|
{{< multiconfig file=hugo >}}
|
|
[params]
|
|
collapsibleMenu = true
|
|
{{< /multiconfig >}}
|
|
|
|
> [!WARNING]
|
|
> Using this option may slow down your build process, especially with many pages.
|
|
>
|
|
> We've seen builds taking 2 minutes with 1000+ pages, and over 30 minutes with 5000+ pages.
|
|
>
|
|
> This happens because each new page affects all other pages, leading to exponentially longer build times.
|
|
|
|
## Default Sort By
|
|
|
|
{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} Use `ordersectionsby` to choose how navigation menus are sorted. The default is `weight`. You can sort by `weight`, `title`, `linktitle`, `modifieddate`, `expirydate`, `publishdate`, `date`, `length`, or `default` (Hugo's standard order).
|
|
|
|
{{< multiconfig file=hugo >}}
|
|
[params]
|
|
ordersectionsby = 'weight'
|
|
{{< /multiconfig >}}
|