From 8f70ad377e700b9ea3aa96bf1deab0cc2d482ba3 Mon Sep 17 00:00:00 2001
From: "Danilo M." <danix@danix.xyz>
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 <noreply@anthropic.com>
---
 CONTENT_GUIDE.md | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)

(limited to 'CONTENT_GUIDE.md')

diff --git a/CONTENT_GUIDE.md b/CONTENT_GUIDE.md
index 1c74a00..cdc2733 100644
--- a/CONTENT_GUIDE.md
+++ b/CONTENT_GUIDE.md
@@ -42,6 +42,71 @@ content/
 
 ---
 
+## Navigation Menu Configuration
+
+The top navigation menu is configured in `hugo.toml`. You can easily add, remove, or reorder menu items.
+
+### How to Add Menu Items
+
+Edit your `hugo.toml` file and add a new `[[menu.main]]` block:
+
+```toml
+[[menu.main]]
+  name = 'Articles'
+  pageRef = '/articles'
+  weight = 10
+
+[[menu.main]]
+  name = 'About'
+  pageRef = '/is'
+  weight = 20
+
+[[menu.main]]
+  name = 'Contact'
+  pageRef = '/is/here'
+  weight = 30
+
+# Add a new page to the menu:
+[[menu.main]]
+  name = 'Uses'
+  pageRef = '/is/uses'
+  weight = 40
+```
+
+### Parameters
+
+- `name` — Text displayed in the navigation menu
+- `pageRef` — Path to your page (e.g., `/articles`, `/is/about`). Must match your content folder structure
+- `weight` — Controls menu order. Lower numbers appear first (leftmost), higher numbers appear last (rightmost)
+
+### External Links
+
+To link to external websites, use `url` instead of `pageRef`:
+
+```toml
+[[menu.main]]
+  name = 'GitHub'
+  url = 'https://github.com/danix2'
+  weight = 50
+```
+
+### Creating Pages for Menu Items
+
+Before adding a menu item, create the corresponding page in `content/`:
+
+```bash
+# Create a new static page
+hugo new is/uses.md
+
+# Then add it to the menu in hugo.toml
+[[menu.main]]
+  name = 'Uses'
+  pageRef = '/is/uses'
+  weight = 40
+```
+
+---
+
 ## Content Types
 
 Your blog supports five content types for articles. Each type is visually distinct in the feed with its own badge color.
-- 
cgit v1.2.3