summaryrefslogtreecommitdiffstats
path: root/CONTENT_GUIDE.md
diff options
context:
space:
mode:
Diffstat (limited to 'CONTENT_GUIDE.md')
-rw-r--r--CONTENT_GUIDE.md65
1 files changed, 65 insertions, 0 deletions
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.