Add GitHub widget injection and styles

Author: rich-iannone

great_docs/assets/post-render.py

@@ -733,3 +733,54 @@ def add_parens_to_functions(match):
             file.write(content)
 
 print("Finished processing all files")
+
+
+# ============================================================================
+# GitHub Widget Injection
+# ============================================================================
+# Replace escaped GitHub widget placeholder with actual HTML
+# This handles cases where Quarto escapes the HTML in navbar text items
+
+
+def inject_github_widget():
+    """
+    Find and replace escaped GitHub widget placeholders with actual widget HTML.
+
+    Quarto escapes HTML in navbar text items, so we need to post-process
+    to inject the actual widget div.
+    """
+    print("Checking for GitHub widget placeholders...")
+
+    widget_escaped_pattern = re.compile(
+        r'<span class="menu-text">&lt;div id="github-widget" '
+        r'data-owner="([^"]*)" data-repo="([^"]*)"&gt;&lt;/div&gt;</span>'
+    )
+
+    widget_count = 0
+
+    for html_file in all_html_files:
+        with open(html_file, "r") as file:
+            content = file.read()
+
+        # Check if this file has an escaped widget placeholder
+        match = widget_escaped_pattern.search(content)
+        if match:
+            owner = match.group(1)
+            repo = match.group(2)
+
+            # Replace with actual widget HTML
+            replacement = f'<div id="github-widget" data-owner="{owner}" data-repo="{repo}"></div>'
+            content = widget_escaped_pattern.sub(replacement, content)
+
+            with open(html_file, "w") as file:
+                file.write(content)
+
+            widget_count += 1
+
+    if widget_count > 0:
+        print(f"Injected GitHub widget into {widget_count} HTML files")
+    else:
+        print("No GitHub widget placeholders found")
+
+
+inject_github_widget()

great_docs/assets/styles.css

@@ -341,3 +341,178 @@ a.sidebar-item-text.sidebar-link.text-start > span {
         padding-right: 12px;
     }
 }
+
+/* ==========================================================================
+   GitHub Widget Styles
+   ========================================================================== */
+
+#github-widget {
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    margin-left: 8px;
+}
+
+.gh-widget-trigger {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    padding: 6px 10px;
+    background: rgba(255, 255, 255, 0.1);
+    border: 1px solid rgba(255, 255, 255, 0.2);
+    border-radius: 6px;
+    color: white;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    font-size: 13px;
+}
+
+.gh-widget-trigger:hover {
+    background: rgba(255, 255, 255, 0.18);
+    border-color: rgba(255, 255, 255, 0.3);
+}
+
+.gh-widget-open .gh-widget-trigger {
+    background: rgba(255, 255, 255, 0.2);
+    border-color: rgba(255, 255, 255, 0.35);
+}
+
+.gh-icon {
+    flex-shrink: 0;
+}
+
+.gh-stats {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    margin-left: 4px;
+}
+
+.gh-stat {
+    display: flex;
+    align-items: center;
+    gap: 3px;
+    font-weight: 500;
+}
+
+.gh-stat svg {
+    opacity: 0.85;
+}
+
+.gh-count {
+    min-width: 16px;
+    text-align: center;
+}
+
+.gh-dropdown-arrow {
+    margin-left: 2px;
+    opacity: 0.7;
+    transition: transform 0.2s ease;
+}
+
+.gh-widget-open .gh-dropdown-arrow {
+    transform: rotate(180deg);
+}
+
+.gh-dropdown {
+    position: absolute;
+    top: calc(100% + 6px);
+    right: 0;
+    min-width: 180px;
+    background: #ffffff;
+    border: 1px solid #d0d7de;
+    border-radius: 8px;
+    box-shadow: 0 8px 24px rgba(31, 35, 40, 0.12);
+    opacity: 0;
+    visibility: hidden;
+    transform: translateY(-8px);
+    transition: all 0.2s ease;
+    z-index: 1000;
+    overflow: hidden;
+}
+
+.gh-widget-open .gh-dropdown {
+    opacity: 1;
+    visibility: visible;
+    transform: translateY(0);
+}
+
+.gh-dropdown-item {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 10px 14px;
+    color: #24292f !important;
+    text-decoration: none !important;
+    font-size: 14px;
+    font-weight: 500;
+    transition: background 0.15s ease;
+}
+
+.gh-dropdown-item:hover {
+    background: #f6f8fa;
+    text-decoration: none !important;
+}
+
+.gh-dropdown-item svg {
+    color: #57606a;
+    flex-shrink: 0;
+}
+
+.gh-dropdown-divider {
+    height: 1px;
+    margin: 4px 0;
+    background: #d8dee4;
+}
+
+.gh-badge {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 20px;
+    height: 20px;
+    padding: 0 6px;
+    margin-left: auto;
+    background: #ddf4ff;
+    color: #0969da;
+    border-radius: 10px;
+    font-size: 12px;
+    font-weight: 600;
+}
+
+/* Mobile responsive adjustments */
+@media (max-width: 768px) {
+    .gh-stats {
+        display: none;
+    }
+
+    .gh-widget-trigger {
+        padding: 6px 8px;
+    }
+
+    .gh-dropdown {
+        right: auto;
+        left: 0;
+        min-width: 160px;
+    }
+}
+
+/* Ensure navbar doesn't clip the dropdown */
+#quarto-header,
+#quarto-header nav,
+#quarto-header .navbar,
+#quarto-header .container-fluid,
+#navbarCollapse,
+.navbar-nav,
+.navbar-nav.ms-auto,
+.navbar-nav.ms-auto > li,
+.navbar-nav.ms-auto > li > .nav-link {
+    overflow: visible !important;
+}
+
+/* Print styles - hide widget */
+@media print {
+    #github-widget {
+        display: none;
+    }
+}