enh: add return to home shortcut key ('q')

great_docs/_translations.py

@@ -377,6 +377,33 @@
         "ar": "نسخ الصفحة كـ Markdown",
         "he": "העתק דף כ-Markdown",
     },
+    "kb_home": {
+        "en": "Go to homepage",
+        "fr": "Aller à l'accueil",
+        "de": "Zur Startseite",
+        "es": "Ir a la página principal",
+        "pt": "Ir para a página inicial",
+        "it": "Vai alla homepage",
+        "nl": "Ga naar startpagina",
+        "ja": "ホームページへ移動",
+        "ko": "홈페이지로 이동",
+        "zh-Hans": "转到首页",
+        "zh-Hant": "前往首頁",
+        "ru": "На главную",
+        "pl": "Przejdź do strony głównej",
+        "tr": "Ana sayfaya git",
+        "sv": "Gå till startsidan",
+        "da": "Gå til forsiden",
+        "nb": "Gå til forsiden",
+        "is": "Fara á forsíðu",
+        "fi": "Siirry etusivulle",
+        "cs": "Přejít na hlavní stránku",
+        "ro": "Mergi la pagina principală",
+        "el": "Μετάβαση στην αρχική",
+        "hi": "मुखपृष्ठ पर जाएं",
+        "ar": "الذهاب إلى الصفحة الرئيسية",
+        "he": "עבור לדף הבית",
+    },
     "kb_show_help": {
         "en": "Show keyboard shortcuts",
         "fr": "Afficher les raccourcis clavier",

great_docs/assets/keyboard-nav.js

@@ -4,6 +4,7 @@
  * Features:
  * - `/` or `s` to focus search
  * - `[` / `]` for previous/next page navigation
+ * - `q` to navigate to homepage
  * - `m` or `n` to show/hide floating menu overlay (sidebar nav or navbar links)
  * - `d` to toggle dark mode
  * - `c` to copy page as Markdown (when available)
@@ -96,6 +97,17 @@
         }
     }
 
+    function navigateHome() {
+        // Use the navbar brand link (always points to site root)
+        var brand = document.querySelector('.navbar-brand');
+        if (brand && brand.href) {
+            window.location.href = brand.href;
+            return;
+        }
+        // Fallback: navigate to site root
+        window.location.href = './';
+    }
+
     // ── Show Menu Overlay ──────────────────────────────────────────────
 
     /**
@@ -368,6 +380,7 @@
                 { keys: ['['], descKey: 'kb_prev_page', descFallback: 'Previous page' },
                 { keys: [']'], descKey: 'kb_next_page', descFallback: 'Next page' },
                 { keys: ['m', 'n'], descKey: 'kb_show_menu', descFallback: 'Show menu' },
+                { keys: ['q'], descKey: 'kb_home', descFallback: 'Go to homepage' },
             ]
         },
         {
@@ -554,6 +567,11 @@
                 showMenu();
                 break;
 
+            case 'q':
+                e.preventDefault();
+                navigateHome();
+                break;
+
             case 'd':
                 e.preventDefault();
                 toggleDarkMode();