menu: make header area configurable #1057

docs/content/configuration/sidebar/headerfooter/_index.en.md

@@ -48,6 +48,8 @@ If this option isn't set for a specific language, it will use these default valu
   landingPageName = '<i class="fa-fw fas fa-home"></i> Home'
 {{< /multiconfig >}}
 
+For a free configuration of the header menus, see [configuration of the sidebar menus](/configuration/sidebar/menus#defining-sidebar-menus).
+
 ## History
 
 {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} Turn on `showVisitedLinks=true` to see checkmarks next to visited pages in the main menu. This also adds a `Clear History` option at the bottom of the menu to remove all checkmarks. Note that checkmarks will disappear if you rebuild your site, as the page IDs may change.

docs/content/configuration/sidebar/menus/_index.en.md

@@ -1,8 +1,8 @@
 +++
 categories = ["howto"]
 description = "Configure all things menus"
-frontmatter = ["alwaysopen", "collapsibleMenu", "linkTitle", "menuPageRef", "menuPost", "menuPre", "menuUrl", "ordersectionsby", "sidebarmenus"]
-options = ["alwaysopen", "collapsibleMenu", "disableShortcutsTitle", "ordersectionsby",  "sidebarmenus"]
+frontmatter = ["alwaysopen", "collapsibleMenu", "linkTitle", "menuPageRef", "menuPost", "menuPre", "menuUrl", "ordersectionsby", "sidebarheadermenus", "sidebarmenus"]
+options = ["alwaysopen", "collapsibleMenu", "disableShortcutsTitle", "ordersectionsby",  "sidebarheadermenus", "sidebarmenus"]
 title = "Menus"
 weight = 4
 +++
@@ -166,16 +166,17 @@ If you want to learn how to configure different Hugo menus for each language, [s
 
 {{< multiconfig fm=true >}}
 [[menu.addendum]]
+  identifier = 'addendum-top'
   name = 'A Menu Title for the Whole Menu'
 
 [[menu.addendum]]
-  parent = 'Parent'
+  parent = 'addendum-top'
   name = 'A Menu Entry Title for Child 1'
   url = 'https://example.com/1'
   weight = 1
 
 [[menu.addendum]]
-  parent = 'Parent'
+  parent = 'addendum-top'
   name = 'A Menu Entry Title for Child 2'
   url = 'https://example.com/2'
   weight = 2
@@ -201,9 +202,16 @@ other = "Other Great Stuff"
 
 ## Defining Sidebar Menus
 
-{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} Menus are defined using the `sidebarmenus` option.
+{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} Menus are defined using the `sidebarheadermenus` or `sidebarmenus` option.
 
-You can define as many menus, as you like. If you don't overwrite this option, the theme defaults to
+As these options are arrays, you can define as many menus, as you like.
+
+- `sidebarheadermenus`: the non-scrolling area below the search box
+- `sidebarmenus`: the scrolling area below the search box
+
+If you don't overwrite this option, for `sidebarheadermenus` the theme accounts to your settings of `disableLandingPageButton` and `landingPageName`. See [configuration for the landing page](/configuration/sidebar/headerfooter#home-button-configuration) for further information.
+
+If you don't overwrite this option, for `sidebarmenus` the theme defaults to
 
 {{< multiconfig >}}
 sidebarmenus = [
@@ -212,6 +220,8 @@ sidebarmenus = [
 ]
 {{< /multiconfig >}}
 
+The default value for the shortcut's `disableTitle` accounts to the setting of `disableShortcutsTitle`.
+
 ### Parameter
 
 | Name                  | Default         | Notes       |

docs/content/configuration/sidebar/menus/_index.pir.md

@@ -1,8 +1,8 @@
 +++
 categories = ["howto"]
 description = "Configure all things menus"
-frontmatter = ["alwaysopen", "collapsibleMenu", "linkTitle", "menuPost", "menuPre", "ordersectionsby", "sidebarmenus"]
-options = ["alwaysopen", "collapsibleMenu", "disableShortcutsTitle", "ordersectionsby",  "sidebarmenus"]
+frontmatter = ["alwaysopen", "collapsibleMenu", "linkTitle", "menuPost", "menuPre", "ordersectionsby", "sidebarheadermenus", "sidebarmenus"]
+options = ["alwaysopen", "collapsibleMenu", "disableShortcutsTitle", "ordersectionsby",  "sidebarheadermenus", "sidebarmenus"]
 title = "Menus"
 weight = 4
 +++