From 8f70ad377e700b9ea3aa96bf1deab0cc2d482ba3 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Sun, 5 Apr 2026 10:15:12 +0200 Subject: docs: add comprehensive menu configuration guide Added documentation explaining how to configure navigation menu via hugo.toml: - Explains menu item parameters (name, pageRef, weight) - Shows how to add new menu items - Demonstrates external links - Provides examples of creating pages for menu items Also updated hugo.toml with better comments explaining menu configuration. Co-Authored-By: Claude Haiku 4.5 --- hugo.toml | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) (limited to 'hugo.toml') diff --git a/hugo.toml b/hugo.toml index c84f52b..50c0043 100644 --- a/hugo.toml +++ b/hugo.toml @@ -21,7 +21,16 @@ locale = 'en-US' ordered = false startLevel = 2 -# Menus +# Navigation Menu +# Add menu items below. Items are displayed left-to-right in order of weight. +# Parameters: +# name = Text displayed in menu (visible to users) +# pageRef = Path to your page (e.g., /articles, /is/about) +# weight = Order (lower numbers = leftmost, higher = rightmost) +# +# For external links, use 'url' instead of 'pageRef': +# url = 'https://example.com' + [[menu.main]] name = 'articles' pageRef = '/articles' @@ -37,6 +46,12 @@ locale = 'en-US' pageRef = '/is/here' weight = 30 +# Example: Add a new page to the menu +# [[menu.main]] +# name = 'uses' +# pageRef = '/is/uses' +# weight = 40 + # Content sections [params] description = 'Writing about IT, life, and the things that matter.' -- cgit v1.2.3