From f407b1c4af6340265e14b4580ec1dcf897d75ef0 Mon Sep 17 00:00:00 2001
From: "N0\\A" <n0va@krzak.org>
Date: Mon, 9 Mar 2026 20:05:42 +0100
Subject: [PATCH] extra navbar links

---
 README.md                                     |  4 +
 kewt.sh                                       | 74 +++++++++++++++++++
 site.conf                                     |  4 +
 .../the deepest depths/blobfish/blobfish.md   |  2 +
 site/index.md                                 |  4 +
 5 files changed, 88 insertions(+)

diff --git a/README.md b/README.md
index 2b1ebdd..97699e7 100644
--- a/README.md
+++ b/README.md
@@ -41,6 +41,8 @@ flatten = false
 order = ""
 home_name = "Home"
 show_home_in_nav = true
+nav_links = ""
+nav_extra = ""
 footer = "made with <a href="https://kewt.krzak.org">kewt</a>"
 logo = ""
 display_logo = false
@@ -57,6 +59,8 @@ favicon = ""
 - `order` comma separated file/directory name list to order the sidebar (alphabetical by default)
 - `home_name` text for the home link in navigation (default: "Home")
 - `show_home_in_nav` show home link in navigation (default: true)
+- `nav_links` comma separated extra nav links, as bare URLs or Markdown links like `[Label](https://example.com)`
+- `nav_extra` raw HTML appended inside the `<nav>` after the generated link list
 - `footer` footer html/text shown at the bottom of pages
 - `logo` logo image path (used in header if enabled)
 - `display_logo` show logo in header
diff --git a/kewt.sh b/kewt.sh
index 513540a..9667c6a 100755
--- a/kewt.sh
+++ b/kewt.sh
@@ -34,6 +34,8 @@ flatten = false
 order = ""
 home_name = "Home"
 show_home_in_nav = true
+nav_links = ""
+nav_extra = ""
 footer = "made with <a href="https://kewt.krzak.org">kewt</a>"
 logo = ""
 display_logo = false
@@ -258,6 +260,9 @@ flatten="false"
 order=""
 home_name="Home"
 show_home_in_nav="true"
+nav_links=""
+nav_extra=""
+footer="made with <a href=\"https://kewt.krzak.org\">kewt</a>"
 logo=""
 display_logo="false"
 display_title="true"
@@ -292,6 +297,8 @@ load_config() {
             order) order="$val" ;;
             home_name) home_name="$val" ;;
             show_home_in_nav) show_home_in_nav="$val" ;;
+            nav_links) nav_links="$val" ;;
+            nav_extra) nav_extra="$val" ;;
             footer) footer="$val" ;;
             logo) logo="$val" ;;
             display_logo) display_logo="$val" ;;
@@ -305,6 +312,64 @@ load_config() {
 load_config "./site.conf"
 load_config "$src/site.conf"
 
+escape_html_text() {
+    printf '%s' "$1" | sed \
+        -e 's/&/\&amp;/g' \
+        -e 's/</\&lt;/g' \
+        -e 's/>/\&gt;/g'
+}
+
+escape_html_attr() {
+    printf '%s' "$1" | sed \
+        -e 's/&/\&amp;/g' \
+        -e 's/"/\&quot;/g' \
+        -e 's/</\&lt;/g' \
+        -e 's/>/\&gt;/g'
+}
+
+nav_links_html() {
+    [ -n "$nav_links" ] || return
+
+    old_ifs=$IFS
+    set -f
+    IFS=','
+    set -- $nav_links
+    IFS=$old_ifs
+    set +f
+
+    [ $# -gt 0 ] || return
+
+    printf '<ul class="nav-extra-links">\n'
+    for raw_link in "$@"; do
+        link=$(printf '%s' "$raw_link" | sed 's/^[[:space:]]*//; s/[[:space:]]*$//')
+        [ -n "$link" ] || continue
+
+        case "$link" in
+            \[*\]\(*\))
+                label=${link#\[}
+                label=${label%%\]*}
+                link_url=${link#*](}
+                link_url=${link_url%)}
+                ;;
+            *)
+                link_url=$link
+                label=$(printf '%s' "$link" | sed \
+                    -e 's|^[A-Za-z][A-Za-z0-9+.-]*://||' \
+                    -e 's|/$||')
+                [ -n "$label" ] || label="$link"
+                ;;
+        esac
+
+        [ -n "$link_url" ] || continue
+        [ -n "$label" ] || label="$link_url"
+
+        link_attr=$(escape_html_attr "$link_url")
+        label_text=$(escape_html_text "$label")
+        printf '<li><a href="%s">%s</a></li>\n' "$link_attr" "$label_text"
+    done
+    printf '</ul>'
+}
+
 template="$src/template.html"
 [ -f "$template" ] || template="./template.html"
 [ -f "$template" ] || die "Template '$template' not found."
@@ -313,6 +378,15 @@ template="$src/template.html"
 mkdir -p "$out"
 
 nav=$(generate_nav "$src")
+extra_links=$(nav_links_html)
+if [ -n "$extra_links" ]; then
+    nav="$nav
+$extra_links"
+fi
+if [ -n "$nav_extra" ]; then
+    nav="$nav
+$nav_extra"
+fi
 
 find_closest() {
     target="$1"
diff --git a/site.conf b/site.conf
index f0319f7..8337095 100644
--- a/site.conf
+++ b/site.conf
@@ -10,3 +10,7 @@ display_title = true
 logo_as_favicon = true
 favicon = ""
 order = ""
+home_name = "Home"
+show_home_in_nav = true
+nav_links = ""
+nav_extra = ""
diff --git a/site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md b/site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md
index 52735e2..6c08011 100644
--- a/site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md	
+++ b/site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md	
@@ -15,3 +15,5 @@ Sed dictum tortor at interdum dignissim. Nunc hendrerit sollicitudin elementum.
 Cras vitae sapien egestas, blandit libero et, volutpat augue. Ut augue quam, sollicitudin quis libero laoreet, bibendum imperdiet massa. Duis sed venenatis risus. Praesent a est mollis, viverra erat quis, faucibus elit. Donec at sagittis est, non posuere nisi. Integer posuere pharetra dui in aliquam. Morbi vehicula eros in hendrerit aliquam. Duis in turpis vel mauris mattis convallis in id tortor. Cras et aliquam augue.
 
 Cras quis consectetur dolor, a sodales tortor. Vestibulum aliquam lacinia metus, sed viverra erat egestas in. Morbi interdum sapien sed bibendum maximus. Aenean accumsan pharetra libero dapibus aliquam. Etiam sodales purus posuere gravida ullamcorper. Vestibulum tincidunt, nibh a pulvinar aliquet, leo tortor pulvinar diam, ut viverra nunc elit bibendum nulla. Praesent vel pulvinar erat, eu efficitur magna. Mauris at consequat purus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Fusce in dui quis nisi elementum aliquam. Proin eget justo sed est commodo accumsan. Suspendisse a feugiat tellus, eget gravida tellus.
+
+![https://www.youtube.com/embed/NvQD9E5Cq8A]
diff --git a/site/index.md b/site/index.md
index 51f2d1d..4494917 100644
--- a/site/index.md
+++ b/site/index.md
@@ -41,6 +41,8 @@ flatten = false
 order = ""
 home_name = "Home"
 show_home_in_nav = true
+nav_links = ""
+nav_extra = ""
 footer = "made with <a href="https://kewt.krzak.org">kewt</a>"
 logo = ""
 display_logo = false
@@ -57,6 +59,8 @@ favicon = ""
 - `order` comma separated file/directory name list to order the sidebar (alphabetical by default)
 - `home_name` text for the home link in navigation (default: "Home")
 - `show_home_in_nav` show home link in navigation (default: true)
+- `nav_links` comma separated extra nav links, as bare URLs or Markdown links like `[Label](https://example.com)`
+- `nav_extra` raw HTML appended inside the `<nav>` after the generated link list
 - `footer` footer html/text shown at the bottom of pages
 - `logo` logo image path (used in header if enabled)
 - `display_logo` show logo in header