jekyll-theme-zer0 0.22.5 → 0.22.20

data/_includes/core/head.html

@@ -12,7 +12,7 @@
   - Loads critical JavaScript libraries before page render
   - Includes SEO optimization and social media meta tags
   - Configures third-party integrations (Analytics, MathJax)
-  - Sets up progress bar and UI enhancement scripts
+  - Sets up progress bar via components/nanobar.html include
   
   Dependencies:
   - seo.html: SEO meta tags and Open Graph data
@@ -22,7 +22,7 @@
   Performance Notes:
   - Scripts loaded in head for immediate availability
   - MathJax loaded asynchronously to prevent render blocking
-  - Nanobar provides visual loading feedback
+  - Nanobar provides visual loading feedback (see components/nanobar.html)
   ===================================================================
 -->
 
@@ -52,29 +52,8 @@
   {% include components/mermaid.html %}
 {% endif %}
 
-<!-- Nano Progress Bar - Visual loading indicator -->
-<script defer src="{{'/assets/js/nanobar.min.js' | relative_url }}"></script>
-
-<!-- Progress Bar Initialization - Creates visual loading feedback -->
-<script>
-    // Wait for DOM to be ready before initializing Nanobar
-    document.addEventListener('DOMContentLoaded', function() {
-        // Check if the progress bar element exists before initializing
-        var progressElement = document.getElementById('top-progress-bar');
-        if (progressElement) {
-            var options = {
-              classname: 'nanobar',
-              id: 'top-progress-bar'
-            };
-            var nanobar = new Nanobar(options);
-            nanobar.go( 30 );  // Initial loading state
-            nanobar.go( 76 );  // Partial completion
-            nanobar.go(100);   // Complete loading
-        } else {
-            console.warn('Progress bar element #top-progress-bar not found. Skipping Nanobar initialization.');
-        }
-    });
-</script>
+<!-- Nano Progress Bar - Visual loading indicator (config-driven) -->
+{% include components/nanobar.html %}
 
 <!-- MathJax - Mathematical notation rendering (async; bundled under assets/vendor) -->
 <script id="MathJax-script" async src="{{ '/assets/vendor/mathjax/es5/tex-mml-chtml.js' | relative_url }}"></script>
@@ -88,9 +67,10 @@
 <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
 
 <!-- ================================ -->
-<!-- SEO AND SOCIAL MEDIA META TAGS  -->
+<!-- SEO SUPPLEMENT                  -->
 <!-- ================================ -->
-<!-- Comprehensive SEO optimization including Open Graph and Twitter Cards -->
+<!-- Additional SEO tags not covered by jekyll-seo-tag plugin ( in root.html).
+     Outputs custom og:image with assets_prefix normalisation and non-Google site verification. -->
 {% include content/seo.html %}
 
 <!-- ========================== -->

data/_includes/core/header.html

@@ -30,7 +30,10 @@
   - ARIA labels for screen readers
   - Focus management for offcanvas
   
-  TODO: Fix Nanobar progress bar positioning and animation
+  Nanobar:
+  - Configured via `site.nanobar.*` in _config.yml
+  - When `position: navbar`, the bar mounts inside `#top-progress-target` below
+  - Otherwise it floats fixed to the viewport (top or bottom)
   ===================================================================
 -->
 
@@ -48,15 +51,7 @@
     <!-- TOP NAVIGATION BAR              -->
     <!-- ================================ -->
     <div class="navbar navbar-expand-lg bg-body-tertiary flex-nowrap justify-content-center bottom-shadow">
-       
-        <!-- ========================== -->
-        <!-- PROGRESS BAR INDICATOR    -->
-        <!-- ========================== -->
-        <!-- Fixed position progress bar for page loading feedback -->
-        <div class="nanobar" id="top-progress-bar" style="position: fixed;" role="progressbar" aria-label="Page loading progress" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
-            <div class="bar"></div>
-        </div>
-        
+
         <!-- ========================== -->
         <!-- MAIN NAVIGATION CONTAINER -->
         <!-- ========================== -->
@@ -105,11 +100,18 @@
             <div class="navbar-brand-group d-inline-flex align-items-center gap-2">
                 <!-- Home Navigation Button (Desktop only) -->
                 <div class="navbar-home-links d-none d-lg-inline-flex" role="navigation" aria-label="Quick navigation">
-                    {%- for home in site.data.navigation.home -%}
-                    <a class="btn" href="{{ home.url | relative_url }}" aria-label="{{ home.title }}" title="{{ home.title }}" {% if home.url == page.url %}aria-current="page"{% endif %}>
-                        <i class="{{ site.default_icon}} {{ home.icon }}"></i>
-                    </a>
-                    {% endfor %}
+                    {%- assign nav_home = site.data.navigation.home -%}
+                    {%- if nav_home and nav_home.size > 0 -%}
+                      {%- for home in nav_home -%}
+                      <a class="btn" href="{{ home.url | relative_url }}" aria-label="{{ home.title }}" title="{{ home.title }}" {%- if home.url == page.url %} aria-current="page"{% endif %}>
+                          <i class="{{ site.default_icon}} {{ home.icon }}"></i>
+                      </a>
+                      {%- endfor -%}
+                    {%- else -%}
+                      <a class="btn" href="{{ '/' | relative_url }}" aria-label="Home" title="Home — {{ site.title }}">
+                          <i class="{{ site.default_icon }} bi-house"></i>
+                      </a>
+                    {%- endif -%}
                 </div>
                 
                 <!-- Brand Logo Link to Root -->
@@ -151,11 +153,11 @@
                     <span class="nav-link-text d-none d-xl-inline ms-1">Search</span>
                 </button>
 
-                <!-- Settings Modal Toggle -->
+                <!-- Settings Offcanvas Toggle -->
                 <button
                     class="btn nav-settings-button d-none d-lg-inline-flex"
                     type="button"
-                    data-bs-toggle="modal" 
+                    data-bs-toggle="offcanvas" 
                     data-bs-target="#info-section" 
                     aria-label="Open settings"
                     aria-haspopup="dialog"
@@ -179,4 +181,15 @@
             </div>
         </nav>
     </div>
+
+    <!-- ========================== -->
+    <!-- PROGRESS BAR MOUNT POINT  -->
+    <!-- ========================== -->
+    <!-- Nanobar mounts here when site.nanobar.position == "navbar" so the bar
+         renders as a thin strip directly under the header. For "top" / "bottom"
+         the bar floats fixed to the viewport and no mount is needed. -->
+    {%- assign _nb_pos = site.nanobar.position | default: "top" -%}
+    {%- if site.nanobar.enabled != false and _nb_pos == "navbar" -%}
+    <div id="top-progress-target" class="nanobar-mount" aria-hidden="true"></div>
+    {%- endif -%}
 </header>

data/_includes/landing/landing-install-cards.html

@@ -30,15 +30,26 @@ docker run -p 4000:4000 {{ site.resources.docker.image | default: '' | join: ''
   <div class="col-12 col-sm-10 col-md-6 col-lg-4">
     <div class="card h-100 border-0 shadow-sm">
       <div class="card-header bg-secondary text-white">
-        <h5 class="card-title mb-0"><i class="bi bi-git me-2"></i>Fork Repository</h5>
+        <h5 class="card-title mb-0"><i class="bi bi-git me-2"></i>Fork & Deploy</h5>
       </div>
       <div class="card-body p-4 d-flex flex-column text-center">
-        <p class="card-text mb-3">Improve the theme by forking the repo and opening a PR.</p>
-        <pre class="bg-dark text-light p-3 rounded mb-3 small text-start overflow-auto"><code>git clone {{ site.resources.github_repo | default: '' | join: '' | default: site.github.repository_url }}
-cd {{ site.local_repo | default: site.repository_name | default: 'repo' }}
-git remote add upstream {{ site.resources.github_repo | default: '' | join: '' | default: site.github.repository_url }}
-git checkout -b feature/your-change</code></pre>
-  <a class="btn btn-outline-secondary btn-sm mt-auto" href="{{ site.resources.github_fork | default: '' | join: '' | default: site.github.repository_url | append: '/fork' }}" target="_blank" rel="noopener">Fork on GitHub</a>
+        {% assign github_fork_base = site.resources.github_fork | default: site.github.repository_url | join: '' %}
+        {% assign github_fork_suffix = github_fork_base | slice: -5, 5 %}
+        {% if github_fork_suffix == '/fork' %}
+          {% assign github_fork_url = github_fork_base %}
+        {% else %}
+          {% assign github_fork_url = github_fork_base | append: '/fork' %}
+        {% endif %}
+        <p class="card-text mb-3">Fork into <code>&lt;username&gt;.github.io</code> for a personal site in minutes.</p>
+        <ol class="text-start small mb-3">
+          <li>Fork <a href="{{ github_fork_url }}" target="_blank" rel="noopener">bamr87/zer0-mistakes</a></li>
+          <li>Name it <code>&lt;your-username&gt;.github.io</code></li>
+          <li>Enable GitHub Pages in Settings</li>
+        </ol>
+        <pre class="bg-dark text-light p-3 rounded mb-3 small text-start overflow-auto"><code>git clone https://github.com/&lt;you&gt;/&lt;you&gt;.github.io.git
+cd &lt;you&gt;.github.io
+./scripts/fork-cleanup.sh</code></pre>
+  <a class="btn btn-outline-secondary btn-sm mt-auto" href="{{ github_fork_url }}" target="_blank" rel="noopener">Fork on GitHub</a>
       </div>
     </div>
   </div>

data/_includes/navigation/admin-nav.html

@@ -0,0 +1,95 @@
+<!--
+  ===================================================================
+  ADMIN NAV — Data-driven sidebar navigation for admin/settings pages
+  ===================================================================
+
+  File: admin-nav.html
+  Path: _includes/navigation/admin-nav.html
+  Purpose: Renders a vertical nav list for administrative pages.
+           Items are read from _data/navigation/admin.yml.
+           Highlights the active page based on page.url or
+           page.admin_section matching.
+
+  Dependencies: Bootstrap 5 nav component, Bootstrap Icons,
+                _data/navigation/admin.yml
+  Used by: _layouts/admin.html
+  ===================================================================
+-->
+
+{% assign current_path = page.url %}
+{% assign admin_items = site.data.navigation.admin %}
+
+<ul class="nav nav-pills flex-column">
+
+  {% assign rendered_separator = false %}
+  {% for item in admin_items %}
+
+    {% if item.external and rendered_separator == false %}
+      {% assign rendered_separator = true %}
+      <li role="separator"><hr class="my-2"></li>
+    {% endif %}
+
+    {% comment %} Active detection: exact URL match or admin_section match {% endcomment %}
+    {% assign is_active = false %}
+    {% if current_path == item.url %}
+      {% assign is_active = true %}
+    {% elsif page.admin_section and page.admin_section == item.title %}
+      {% assign is_active = true %}
+    {% endif %}
+
+    {% comment %} Dynamic badges when no static badge is set {% endcomment %}
+    {% assign dynamic_badge = nil %}
+    {% assign badge_class = "bg-secondary" %}
+    {% unless item.badge or item.external %}
+      {% if item.url == "/about/settings/collections/" %}
+        {% assign dynamic_badge = site.collections | size %}
+      {% elsif item.url == "/about/settings/analytics/" %}
+        {% if site.posthog.enabled %}
+          {% assign dynamic_badge = "On" %}
+          {% assign badge_class = "bg-success" %}
+        {% else %}
+          {% assign dynamic_badge = "Off" %}
+          {% assign badge_class = "bg-secondary" %}
+        {% endif %}
+      {% elsif item.url == "/about/settings/environment/" %}
+        {% if jekyll.environment == "production" %}
+          {% assign dynamic_badge = "Prod" %}
+          {% assign badge_class = "bg-success" %}
+        {% else %}
+          {% assign dynamic_badge = "Dev" %}
+          {% assign badge_class = "bg-warning text-dark" %}
+        {% endif %}
+      {% endif %}
+    {% endunless %}
+
+    <li class="nav-item">
+      {% if item.external %}
+        {% comment %} Resolve placeholder tokens for external URLs {% endcomment %}
+        {% assign resolved_url = item.url
+             | replace: '{github_user}', site.github_user
+             | replace: '{repository_name}', site.repository_name %}
+        <a class="nav-link d-flex align-items-center text-body-secondary"
+           href="{{ resolved_url }}"
+           target="_blank" rel="noopener">
+          <i class="{{ item.icon }} me-2"></i>
+          {{ item.title }}
+          <i class="bi bi-box-arrow-up-right ms-auto small"></i>
+        </a>
+      {% else %}
+        <a class="nav-link d-flex align-items-center{% if is_active %} active{% endif %}"
+           href="{{ item.url | relative_url }}"
+           {% if item.description %}title="{{ item.description }}"{% endif %}>
+          <i class="{{ item.icon }} me-2"></i>
+          {{ item.title }}
+          {% if item.badge %}
+            <span class="badge bg-secondary ms-auto">{{ item.badge }}</span>
+          {% elsif dynamic_badge %}
+            <span class="badge {{ badge_class }} ms-auto">{{ dynamic_badge }}</span>
+          {% endif %}
+        </a>
+      {% endif %}
+    </li>
+
+  {% endfor %}
+
+</ul>

data/_includes/navigation/navbar.html

@@ -6,8 +6,8 @@
              with hover-activated dropdowns for desktop and accessible interactions
  -->
 
-<!-- Navigation Links - Offcanvas -->
-<div class="offcanvas offcanvas-end col-lg-2" tabindex="-1" id="bdNavbar" aria-labelledby="mainNavOffcanvasLabel" aria-modal="true" role="dialog">
+<!-- Navigation Links - Responsive Offcanvas (inline at lg+, offcanvas below) -->
+<div class="offcanvas-lg offcanvas-end" tabindex="-1" id="bdNavbar" aria-labelledby="mainNavOffcanvasLabel">
 
     <!-- Main Navigation Header - Offcanvas -->
     <div class="offcanvas-header border-bottom">
@@ -26,8 +26,19 @@
                     Home
                 </a>
             </li>
-            {%- for link in site.data.navigation.main -%}
+            {%- comment -%}
+              Navigation: data-driven when _data/navigation/main.yml exists;
+              otherwise auto-generated from site.collections as a fallback so
+              a consumer repo needs only markdown files and _config.yml.
+              Exclude a collection from auto-nav by setting nav_exclude: true
+              under its entry in _config.yml collections:.
+            {%- endcomment -%}
+            {%- assign nav_main = site.data.navigation.main -%}
+            {%- if nav_main and nav_main.size > 0 -%}
+
+              {%- for link in nav_main -%}
                 {%- assign has_children = link.children and link.children.size > 0 -%}
+                {%- assign items_remaining = nav_main.size | minus: forloop.index -%}
 
                 {%- if has_children -%}
                     <li class="nav-item dropdown d-flex align-items-center nav-hover-dropdown" role="none">
@@ -59,7 +70,7 @@
                             <span class="visually-hidden">Toggle {{ link.title }} submenu</span>
                         </button>
 
-                        <ul class="dropdown-menu dropdown-menu-start" aria-labelledby="dropdown-{{ link.title | slugify }}" role="menu">
+                        <ul class="dropdown-menu {% if items_remaining < 2 %}dropdown-menu-end{% else %}dropdown-menu-start{% endif %}" aria-labelledby="dropdown-{{ link.title | slugify }}" role="menu">
                             {%- for child in link.children -%}
                                 <li role="none">
                                     <a
@@ -93,7 +104,35 @@
                         </a>
                     </li>
                 {%- endif -%}
-            {%- endfor -%}
+              {%- endfor -%}
+
+            {%- else -%}
+              {%- comment -%}
+                Dynamic navigation: one nav item per collection that has output
+                documents. The "pages" collection is skipped (structural only).
+                Set nav_exclude: true on a collection in _config.yml to hide it.
+              {%- endcomment -%}
+              {%- for collection in site.collections -%}
+                {%- unless collection.label == "pages" or collection.nav_exclude -%}
+                  {%- if collection.docs.size > 0 -%}
+                    {%- assign col_title = collection.label | replace: "-", " " | replace: "_", " " | capitalize -%}
+                    {%- assign col_url = "/" | append: collection.label | append: "/" -%}
+                    <li class="nav-item" role="none">
+                        <a
+                            class="nav-link"
+                            href="{{ col_url | relative_url }}"
+                            role="menuitem"
+                            title="{{ col_title }}"
+                            {%- if page.collection == collection.label -%} aria-current="page"{%- endif -%}
+                        >
+                            <span class="nav-link-text">{{ col_title }}</span>
+                        </a>
+                    </li>
+                  {%- endif -%}
+                {%- endunless -%}
+              {%- endfor -%}
+
+            {%- endif -%}
             <li class="nav-item d-lg-none" role="none">
                 <button
                     class="nav-link btn btn-link text-start w-100"
@@ -110,7 +149,7 @@
                 <button
                     class="nav-link btn btn-link text-start w-100"
                     type="button"
-                    data-bs-toggle="modal"
+                    data-bs-toggle="offcanvas"
                     data-bs-target="#info-section"
                     aria-controls="info-section"
                     aria-haspopup="dialog"

data/_includes/navigation/sidebar-left.html

@@ -1,4 +1,4 @@
-<!--
+  <!--
   ===================================================================
   SIDEBAR LEFT - Dynamic Navigation Sidebar
   ===================================================================