Bs17 hugo docsy update

.github/workflows/gh-pages.yml

@@ -44,7 +44,7 @@ env:
   # ----------------------------------------------------------------------------
   # Specify the deployment environment:  staging or production
   HUGO_ENVIRONMENT: ${{ vars.HUGO_ENVIRONMENT || 'staging' }}
-  HUGO_VERSION: 0.144.2
+  HUGO_VERSION: 0.155.3
 
 jobs:
   # ----------------------------------------------------------------------------

assets/js/search-text-fragment.js

@@ -0,0 +1,81 @@
+/**
+ * Text Fragment Enhancement for Google Programmable Search Engine
+ * 
+ * This script intercepts clicks on GCSE search result links and adds
+ * text fragment highlighting (#:~:text=...) to navigate users directly
+ * to the relevant content on the target page.
+ * 
+ * Text fragments are supported in Chrome 80+, Edge 80+, and other
+ * Chromium-based browsers. Firefox and Safari have limited support.
+ */
+
+(function() {
+  'use strict';
+
+  // Get the search query from the URL
+  function getSearchQuery() {
+    const params = new URLSearchParams(window.location.search);
+    return params.get('q') || '';
+  }
+
+  // Create a text fragment from search terms
+  function createTextFragment(query) {
+    if (!query) return '';
+
+    // Clean and encode the query for use in text fragment
+    // Use the first few significant words (avoid very long fragments)
+    const words = query.trim().split(/\s+/).slice(0, 5);
+    const fragment = words.join(' ');
+
+    return '#:~:text=' + encodeURIComponent(fragment);
+  }
+
+  // Check if browser supports text fragments
+  function supportsTextFragments() {
+    return 'fragmentDirective' in document || 
+           // Chrome/Edge support detection
+           (navigator.userAgent.includes('Chrome') || navigator.userAgent.includes('Edg'));
+  }
+
+  // Intercept clicks on GCSE result links
+  function setupLinkInterception() {
+    const query = getSearchQuery();
+    if (!query || !supportsTextFragments()) return;
+
+    const textFragment = createTextFragment(query);
+
+    // Use event delegation since GCSE results are loaded dynamically
+    document.addEventListener('click', function(event) {
+      // Find if click was on a GCSE result link
+      const link = event.target.closest('.gs-title a, a.gs-title');
+      if (!link) return;
+
+      const href = link.getAttribute('href');
+      if (!href) return;
+
+      // Only modify links to our own site
+      const currentHost = window.location.hostname;
+      try {
+        const linkUrl = new URL(href, window.location.origin);
+        if (linkUrl.hostname !== currentHost) return;
+
+        // Don't add fragment if one already exists
+        if (linkUrl.hash && !linkUrl.hash.startsWith('#:~:text=')) return;
+
+        // Modify the link to include text fragment
+        event.preventDefault();
+        const newUrl = href.split('#')[0] + textFragment;
+        window.location.href = newUrl;
+      } catch (e) {
+        // Invalid URL, let it proceed normally
+      }
+    }, true);
+  }
+
+  // Initialize when DOM is ready
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', setupLinkInterception);
+  } else {
+    setupLinkInterception();
+  }
+})();

assets/scss/_styles_project.scss

@@ -5,3 +5,77 @@
 .td-page-meta {
     display: none;
 }
+
+.td-navbar .navbar-brand__name {
+    display: none;
+}
+
+// Image gallery shortcode styles
+.image-gallery {
+    overflow: auto;
+    margin-left: -1% !important;
+
+    li {
+        float: left;
+        display: block;
+        margin: 0 0 1% 1%;
+        width: 19%;
+
+        a {
+            text-align: center;
+            text-decoration: none !important;
+            color: #777;
+
+            span {
+                display: block;
+                text-overflow: ellipsis;
+                overflow: hidden;
+                white-space: nowrap;
+                padding: 3px 0;
+            }
+
+            img {
+                width: 100%;
+                display: block;
+            }
+        }
+    }
+}
+
+// Custom styles used by home page
+.hero-content-column {
+    background-position: -2px 0;
+    background-repeat: no-repeat;
+    background-size: 26em 28em;
+
+    .text-center {
+        h1, p {
+            text-shadow: 2px 3px 0 #333;
+        }
+
+        .display-1,
+        .display-3 {
+            font-weight: 700;
+        }
+    }
+
+    .top-summary {
+        background: rgba(0, 0, 0, 0.3);
+        padding: 7px;
+        border-radius: 11px;
+    }
+}
+
+// Keep search visible on mobile, wrap to second row
+@media (max-width: 991.98px) {
+    .td-navbar-container {
+        flex-wrap: wrap;
+    }
+    // Override Bootstrap d-none with higher specificity
+    nav.td-navbar .td-navbar__search.d-none.d-lg-block {
+        display: block !important;
+        width: 100%;
+        order: 99;
+        padding: 0.5rem 0;
+    }
+}

assets/scss/_variables_project.scss

@@ -1,3 +1,9 @@
-//$primary: #390040;
-#$primary: #c80000;
-$secondary: #A23B72;
+$primary: #30638e;  // rgb(48, 99, 142)
+$secondary: #f08073;
+
+$td-enable-google-fonts: true;
+
+// Set the navbar background color to match the primary color
+$td-navbar-bg-color: #30638e;
+
+// $enable-dark-mode: false;

config/_default/hugo.yaml

@@ -26,7 +26,7 @@ canonifyURLs: false
 enableRobotsTXT: false
 
 # assetDir:  Location where Hugo looks for assets
-assetDir: static
+#assetDir: static
 
 # Enable .GitInfo object for each page.  This will give values to .Lastmod etc.
 enableGitInfo: true

config/_default/module.yaml

@@ -3,7 +3,7 @@
   # replacements = "github.com/google/docsy -> ../../docsy"
   hugoVersion:
     extended: true
-    min: "0.73.0"
+    min: "0.155.2"
   imports:
     - path: "github.com/google/docsy"
       disable: false

config/_default/params.yaml

@@ -41,17 +41,17 @@ copyright:
   from_year: 2024
   license: MIT
 
-# github information
+# github information - disabled, only needed if feedback is enabled.
 #  github_repo:  url to repo of web site
 #  github_branch:  main branch of repo
 #  github_subdir:  unused by Interlisp.org
 #  github_project_repo: added by Interlisp.org points to repo used
 #                       for issue reporting
 #  
-github_repo: https://github.com/interlisp/Interlisp.github.io
-github_branch: main
-github_subdir: 
-github_project_repo: https://github.com/interlisp/medley
+#github_repo: https://github.com/interlisp/Interlisp.github.io
+#github_branch: main
+#github_subdir: 
+#github_project_repo: https://github.com/interlisp/medley
 
 # Google custom search engine configuration
 #  gcs_engine_id:  search engine 
@@ -136,24 +136,11 @@ taxonomy:
 
 # User Interface Configuration options
 #
-# feedback:
-#   Adds a H2 section titled "Feedback" to the bottom of each doc. The responses 
-#   are sent to Google Analytics as events.  This feature depends 
-#   on [services.googleAnalytics] and will be disabled if 
-#   "services.googleAnalytics.id" is not set.
-#
-#   If you want this feature, but occasionally need to remove the 
-#   "Feedback" section from a single page,
-#   add "hide_feedback: true" to the page's front matter.
-#    enable:  boolean Turn feedback
-#    yes: text to display with yes is selected
-#    no: text to display when no is selected
-
 ui:
+  # Adds a H2 section titled "Feedback" to the bottom of each doc. The responses 
+  # are sent to Google Analytics as events.  
   feedback:
-    enable: true
-    'yes': 'Glad to hear it! Please <a href="https://github.com/Interlisp/medley/issues/new?template=documentation.md&projects=Interlisp/medley/5">tell us how we can improve</a>.'
-    'no': 'Sorry to hear that. Please <a href="https://github.com/Interlisp/medley/issues/new?template=documentation.md&projects=Interlisp/medley/5">tell us how we can improve</a>.'
+    enable: false
 
   # Adds a reading time to the top of each doc.
   # If you want this feature, but occasionally need to remove the Reading time from a single page, 
@@ -187,7 +174,8 @@ ui:
 
   ul_show: 3
 
-# Identify the custom css files
-custom_css:
-  - "css/custom.css"
+  # Set the navbar to dark mode, This keeps the fonts white, which works better with the blue background.
+  navbar_theme: dark
 
+  # Set to false to disable dark mode menu
+  showLightDarkModeMenu: true