Fix topbar settings for utPLSQL documentation

Jacek G&#281;bal · Jacek G&#281;bal · commit cb2ecec2b83b · 2026-06-15T23:53:24.000+03:00
diff --git a/docs/assets/topbar.css b/docs/assets/topbar.css
@@ -155,6 +155,11 @@
   display: block;
 }
 
+/* Org site links injected into Material's sidebar drawer &mdash; desktop: hidden */
+#utplsql-drawer-nav {
+  display: none;
+}
+
 @media screen and (max-width: 76.1875em) {
   /* Hide nav links on mobile &mdash; sidebar drawer handles navigation */
   #utplsql-topbar a:not(.utplsql-brand) {
@@ -171,4 +176,33 @@
   .md-search__inner {
     padding-top: 2rem !important;
   }
+
+  /* Org site nav section at the top of the drawer */
+  #utplsql-drawer-nav {
+    display: block;
+    padding: 0.6rem 0.8rem 0.4rem;
+    border-bottom: 1px solid var(--md-default-fg-color--lightest, rgba(0,0,0,.12));
+    margin-bottom: 0.4rem;
+  }
+
+  #utplsql-drawer-nav .utplsql-drawer-heading {
+    font-size: 0.65rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: var(--md-default-fg-color--light);
+    padding-bottom: 0.3rem;
+  }
+
+  #utplsql-drawer-nav a {
+    display: block;
+    padding: 0.25rem 0;
+    color: var(--md-typeset-a-color);
+    text-decoration: none;
+    font-size: 0.75rem;
+  }
+
+  #utplsql-drawer-nav a:hover {
+    color: var(--md-accent-fg-color);
+  }
 }
diff --git a/docs/assets/topbar.js b/docs/assets/topbar.js
@@ -116,6 +116,32 @@
   }
 
   /* Updates the active class on nav links based on the current URL. */
+  function injectDrawerNav() {
+    /* Already injected and still in the DOM &mdash; nothing to do. */
+    if (document.getElementById('utplsql-drawer-nav')) return;
+
+    var inner = document.querySelector('.md-sidebar--primary .md-sidebar__inner');
+    if (!inner) return;
+
+    var section = document.createElement('nav');
+    section.id = 'utplsql-drawer-nav';
+    section.setAttribute('aria-label', 'utPLSQL.org site navigation');
+
+    var heading = document.createElement('div');
+    heading.className = 'utplsql-drawer-heading';
+    heading.textContent = 'utPLSQL.org';
+    section.appendChild(heading);
+
+    NAV.forEach(function (item) {
+      var a = document.createElement('a');
+      a.href = item.url;
+      a.textContent = item.label;
+      section.appendChild(a);
+    });
+
+    inner.insertBefore(section, inner.firstChild);
+  }
+
   function updateActiveLink() {
     var bar = document.getElementById('utplsql-topbar');
     if (!bar) return;
@@ -131,6 +157,7 @@
     if (document.getElementById('utplsql-topbar')) {
       updateActiveLink();
       applyStoredScheme();
+      injectDrawerNav();
       return;
     }
 
@@ -140,6 +167,7 @@
       document.body.insertBefore(savedBar, document.body.firstChild);
       updateActiveLink();
       applyStoredScheme();
+      injectDrawerNav();
       return;
     }
 
@@ -212,6 +240,7 @@
     savedBar = bar;
     document.body.insertBefore(bar, document.body.firstChild);
     updateActiveLink();
+    injectDrawerNav();
 
     /* When auto mode is active, re-apply if the OS theme changes live. */
     window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', function () {
