jekyll-theme-profile 2.1.1 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a19e1f36d78ca97f12fa97beb3998d4f3c00139f7ec979034ca3295c41f263b
-  data.tar.gz: 93612a420c7cec6d761ac57a4ae4e25bc21168c7fed3549f0bca6382b44c1ace
+  metadata.gz: aa628df566d3dd2147c61603e880b27c10b759a1d125e9003cb4a2058f7fa60c
+  data.tar.gz: 5a3e21311ad8c9cf6c9623ad445bdea4357053eb9a81d9c1800974920d34302c
 SHA512:
-  metadata.gz: 2c4eb4ccd33befacb647221e258848470e0eca69a3bb7321d887dbf7d9ff2b894775e236f1a2748e01584a73dba236ae3fc5f8b6db090207c87a120c79b999a1
-  data.tar.gz: 2a25173a306e96bfc040b3c5ec1c07952b1cd87a799d39170e3dac43e846c74458014adf42b47c65513b42418475a7511e9e32325867485431aed274d87be7f7
+  metadata.gz: 758bff4b0b36a335260f4da19132cc1c599e46212d9035b03f59e665e64ff70d7f4ffe0097c42097c9ce6ee04243ac581a54784eef230b3896fe75a7e3987956
+  data.tar.gz: '09fb03e94567c4ff551e017fc8b5450cbadcd2207e89433dc7150eb584aab0e664548677d762df3c023aa18d60c07dd0f735df04b4fe260252156391b7889f17'

data/_config.yml

@@ -34,6 +34,19 @@ repo_info: true # Show the information for the source of this project
 user_metadata: true # Show the metadata associated with the user
 profile_link: true # Show a link to the github profile for the user
 
+####################
+# Versioned docs settings
+# versions:
+#   enabled: true
+#   config: /versions.json
+#   prefix: ""
+#   # config and prefix are emitted exactly as configured here
+#   # versioning is enabled only when this block is present, or when enabled is explicitly true
+#   show_warning: true
+#   warning_title: Non-default version
+#   warning_message: You are viewing a non-default version of these docs.
+#   unavailable_label: Version info unavailable
+
 ##########################
 # # Social media settings
 # icon_color: "#959da5" # The color of the social media icons on the site

data/_includes/awesome-nav-breadcrumbs.html

@@ -1,9 +1,6 @@
 <div class="Breadcrumb d-flex flex-items-center">
   <nav aria-label="Breadcrumb" class="f5">
     <ol class="breadcrumb">
-      <li class="breadcrumb-item">
-        <a href="{{ '/' | relative_url }}">home</a>
-      </li>
       {% if page.breadcrumbs and page.breadcrumbs.size > 0 %}
         {% for crumb in page.breadcrumbs %}
           {% if forloop.last %}

data/_includes/head.html

@@ -29,6 +29,7 @@
   <script src="{{ '/assets/js/theme-toggle.js' | relative_url }}"></script>
   <script src="{{ '/assets/js/anchor-links.js' | relative_url }}"></script>
   <script src="{{ '/assets/js/topbar.js' | relative_url }}"></script>
+  <script src="{{ '/assets/js/versioning.js' | relative_url }}"></script>
   <script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
   <script src="{{ '/assets/js/mermaid.js' | relative_url }}"></script>
 

data/_includes/header-appbar.html

@@ -14,6 +14,9 @@
                 <span class="octicon octicon-mark-github-24"></span>
                 <span class="h4 text-semibold mx-3">{{ name }}</span>
             </a>
+            <span class="d-none d-sm-block flex-content-center ml-2">
+            {% include version-selector.html %}
+            </span>
         </div>
         <div class="AppHeader-item d-flex flex-items-center">
             {% include toggle.html %}

data/_includes/header-sidebar.html

@@ -36,6 +36,9 @@
                 <div class="px-5 py-2">
                     {%- include masthead.html size="128px" %}
                 </div>
+                <div class="d-flex flex-justify-center ml-2">
+                {% include version-selector.html %}
+                </div>
                 {%- if site.repo_info and site.repository %}
                 <div class="py-2">
                     {% include mini-repo-info-card.html class="Header-link no-underline" %}

data/_includes/header-stacked.html

@@ -12,16 +12,21 @@
     {%- endif %}
 </div>
 {%- if site.nav %}
-<div class="Header d-flex z-2 position-sticky top-0 topbar">
-    <div class="Header-item flex-row flex-justify-center flex-1 hide-sm">
-        {% include nav.html %}
-    </div>
-    <div class="d-flex flex-1 flex-sm-grow-0 flex-justify-start">
-        <div class="d-flex d-sm-none">
-            {% include nav-overlay.html%}
+<div class="Header z-2 position-sticky top-0 topbar">
+    <div class="container-xl d-flex flex-row flex-1">
+        <div class="d-flex flex-1 hide-sm">
+            {% include nav.html %}
         </div>
-        <div class="d-flex">
-            {% include toggle.html %}
+        <div class="d-flex flex-sm-grow-0 flex-justify-start">
+            <div class="d-flex d-sm-none">
+                {% include nav-overlay.html%}
+            </div>
+            <div class="d-flex">
+                <div class="m-2">
+                {% include version-selector.html %}
+                </div>
+                {% include toggle.html %}
+            </div>
         </div>
     </div>
 </div>

data/_includes/header-topbar.html

@@ -17,7 +17,12 @@
                     <span class="octicon octicon-mark-github-24"></span>
                 </a>
             </div>
-            <a href="{{ site.baseurl }}/" class="Header-item Header-link Header-item--full">{{ name }}</a>
+            <div class="Header-item Header-link Header-item--full">
+            <a href="{{ site.baseurl }}/">{{ name }}</a>
+            <div class="d-inline-block ml-4">
+            {% include version-selector.html %}
+            </div>
+            </div>
             <div class="Header-item">
             {% include toggle.html %}
             </div>

data/_includes/resolve-versioning.html

@@ -0,0 +1,16 @@
+{%- assign versions_enabled = false -%}
+{%- if site.versions and site.versions != empty -%}
+{%- assign versions_enabled = true -%}
+{%- endif -%}
+{%- if site.versions and site.versions.enabled != nil -%}
+{%- assign versions_enabled = site.versions.enabled -%}
+{%- endif -%}
+{%- if page.versions and page.versions.enabled != nil -%}
+{%- assign versions_enabled = page.versions.enabled -%}
+{%- endif -%}
+{%- assign versions_json = site.versions.config | default: "/versions.json" -%}
+{%- assign versions_prefix = site.versions.prefix | default: "" -%}
+{%- unless versions_enabled -%}
+{%- assign versions_json = "" -%}
+{%- assign versions_prefix = "" -%}
+{%- endunless -%}

data/_includes/version-selector.html

@@ -0,0 +1,22 @@
+{%- assign unavailable_label = site.versions.unavailable_label | default: "Version info unavailable" -%}
+<details class="version-selector details-reset details-overlay d-none" data-version-selector
+    data-version-unavailable-label="{{ unavailable_label }}">
+    <summary class="version-selector__trigger d-flex flex-items-center text-nowrap" aria-haspopup="true">
+        <span class="f6" data-version-current-label></span>
+        <span class="octicon octicon-chevron-down-16 ml-1"></span>
+    </summary>
+    <details-menu class="SelectMenu" role="menu">
+        <div class="SelectMenu-modal">
+            <div class="SelectMenu-header">
+                <div tabindex="-1" class="SelectMenu-title">Versions</div>
+            </div>
+            <div class="SelectMenu-list" data-version-options>
+                <div class="SelectMenu-item color-fg-muted" data-version-loading>Loading versions...</div>
+            </div>
+            <div class="SelectMenu-footer">
+                <div class="ActionList-sectionDivider mt-0 mb-1"></div>
+                <div class="color-fg-muted f6" data-version-status></div>
+            </div>
+        </div>
+    </details-menu>
+</details>

data/_includes/version-warning.html

@@ -0,0 +1,15 @@
+{%- assign show_version_warning = site.versions.show_warning | default: false -%}
+{%- assign version_warning_title = site.versions.warning_title | default: "Non-default version" -%}
+{%- assign version_warning_message = site.versions.warning_message | default: "You are viewing a non-default version of these docs." -%}
+{%- if show_version_warning != false -%}
+<div class="d-none mb-4" data-version-warning aria-live="polite"
+    data-version-warning-message="{{ version_warning_message | escape }}">
+    <div class="border rounded-2 color-bg-subtle p-3 d-flex flex-items-start">
+        <span class="octicon octicon-alert-16 mr-2 mt-1 color-fg-attention"></span>
+        <div class="f6 color-fg-default">
+            <strong class="d-block mb-1">{{ version_warning_title }}</strong>
+            <span data-version-warning-text>{{ version_warning_message }}</span>
+        </div>
+    </div>
+</div>
+{%- endif -%}

data/_layouts/default.html

@@ -1,8 +1,9 @@
 {%- assign style = page.style | default: layout.style | default: site.style | default: "appbar" %}
 {%- assign light_theme = site.light_theme | default: "light" %}
 {%- assign dark_theme = site.dark_theme | default: "dark" %}
+{%- include resolve-versioning.html %}
 <!doctype html>
-<html lang="en" data-color-mode="auto" data-light-theme="{{ light_theme }}" data-dark-theme="{{ dark_theme }}">
+<html lang="en" data-color-mode="auto" data-light-theme="{{ light_theme }}" data-dark-theme="{{ dark_theme }}" data-baseurl="{{ site.baseurl }}" data-versioning-enabled="{{ versions_enabled }}"{% if versions_enabled %} data-versions-json="{{ versions_json }}" data-versioning-prefix="{{ versions_prefix }}"{% endif %}>
 
 {%- include head.html %}
 

data/_layouts/docs.html

@@ -108,6 +108,7 @@ Set edit url
         </div>
     </div>
     <div class="container-xl flex-1  p-responsive pb-6">
+        {% include version-warning.html %}
         <div class="py-4 d-flex">
             <div class="d-xl-none">
                 {% if awesome_nav_enabled %}

data/_sass/_main.scss

@@ -160,6 +160,24 @@ body::before {
   color: var(--fgColor-default, var(--color-fg-default));
 }
 
+.version-selector__trigger {
+  color: var(--fgColor-default, var(--color-fg-default));
+  cursor: pointer;
+  text-decoration: none;
+}
+
+.version-selector__trigger:hover {
+  text-decoration: none;
+}
+
+.AppHeader .version-selector__trigger {
+  color: var(--fgColor-default, var(--color-fg-default));
+}
+
+.Header .version-selector__trigger {
+  color: var(--header-fgColor-default, var(--color-header-text));
+}
+
 .ActionListItem {
   background-color: var(--control-transparent-bgColor-rest, #0000);
   border-radius: var(--borderRadius-medium, 0.375rem);

data/assets/js/versioning.js

@@ -0,0 +1,300 @@
+document.addEventListener('DOMContentLoaded', function () {
+    var html = document.documentElement;
+    var selector = document.querySelector('[data-version-selector]');
+    var warning = document.querySelector('[data-version-warning]');
+
+    if (!selector && !warning) {
+        return;
+    }
+
+    var versioningEnabled = html.dataset.versioningEnabled === 'true';
+    var versionsUrl = html.dataset.versionsJson || '/versions.json';
+    var versioningPrefix = html.dataset.versioningPrefix || '';
+    var defaultAlias = normalizeKey(html.dataset.defaultDocAlias || 'latest');
+
+    if (!versioningEnabled) {
+        renderFallback();
+        return;
+    }
+
+    function ensureLeadingSlash(path) {
+        if (!path) {
+            return '/';
+        }
+
+        return path.charAt(0) === '/' ? path : '/' + path;
+    }
+
+    function stripTrailingSlash(path) {
+        if (!path || path === '/') {
+            return '/';
+        }
+
+        return path.replace(/\/+$/, '') || '/';
+    }
+
+    function normalizeKey(value) {
+        return String(value || '').trim().replace(/^\/+|\/+$/g, '');
+    }
+
+    function stripVersioningPrefix(path) {
+        var normalized = ensureLeadingSlash(path);
+        var normalizedPrefix = stripTrailingSlash(ensureLeadingSlash(versioningPrefix || ''));
+
+        if (!normalizedPrefix || normalizedPrefix === '/') {
+            return normalized;
+        }
+
+        if (normalized === normalizedPrefix) {
+            return '/';
+        }
+
+        if (normalized.indexOf(normalizedPrefix + '/') === 0) {
+            return normalized.slice(normalizedPrefix.length) || '/';
+        }
+
+        return normalized;
+    }
+
+    function normalizePath(value) {
+        var path = value || '/';
+
+        try {
+            path = new URL(path, window.location.origin).pathname;
+        } catch (error) {
+            path = String(path);
+        }
+
+        return stripVersioningPrefix(ensureLeadingSlash(path));
+    }
+
+    function versionRoot(key) {
+        var normalized = normalizeKey(key);
+        return normalized ? '/' + normalized + '/' : '/';
+    }
+
+    function buildHref(path) {
+        var normalized = normalizePath(path);
+        var normalizedPrefix = stripTrailingSlash(ensureLeadingSlash(versioningPrefix || ''));
+
+        if (!normalizedPrefix || normalizedPrefix === '/') {
+            return normalized;
+        }
+
+        if (normalized === '/') {
+            return normalizedPrefix;
+        }
+
+        return normalizedPrefix + normalized;
+    }
+
+    function joinPaths(left, right) {
+        var leftPath = stripTrailingSlash(normalizePath(left));
+        var rightPath = normalizePath(right);
+        var keepTrailingSlash = right === '/' || /\/$/.test(String(right || ''));
+
+        if (leftPath === '/') {
+            return keepTrailingSlash ? stripTrailingSlash(rightPath) + '/' : rightPath;
+        }
+
+        if (rightPath === '/') {
+            return leftPath + '/';
+        }
+
+        var joined = stripTrailingSlash(leftPath + '/' + rightPath.replace(/^\//, ''));
+        return keepTrailingSlash ? joined + '/' : joined;
+    }
+
+    function matchesRoot(pathname, root) {
+        if (root === '/') {
+            return pathname === '/';
+        }
+
+        return pathname === root.slice(0, -1) || pathname.indexOf(root) === 0;
+    }
+
+    function normalizeVersions(payload) {
+        if (!Array.isArray(payload)) {
+            return [];
+        }
+
+        var targets = [];
+        var seen = {};
+
+        payload.forEach(function (entry) {
+            if (!entry || !entry.version) {
+                return;
+            }
+
+            var version = normalizeKey(entry.version);
+            var title = entry.title || version;
+            var aliases = Array.isArray(entry.aliases) ? entry.aliases : [];
+            var normalizedAliases = aliases.map(normalizeKey).filter(Boolean);
+            var hasDefaultAlias = normalizedAliases.indexOf(defaultAlias) !== -1;
+
+            if (!version || seen[version]) {
+                return;
+            }
+
+            seen[version] = true;
+            targets.push({
+                key: version,
+                label: hasDefaultAlias ? title + ' (' + defaultAlias + ')' : title,
+                root: versionRoot(version),
+                version: version,
+                aliases: normalizedAliases
+            });
+        });
+
+        return targets;
+    }
+
+    function findActiveTarget(pathname, targets) {
+        var active = null;
+
+        targets.forEach(function (target) {
+            var targetRoots = [target.root].concat(target.aliases.map(versionRoot));
+
+            targetRoots.forEach(function (root) {
+                if (matchesRoot(pathname, root) && (!active || root.length > active.root.length)) {
+                    active = {
+                        key: target.key,
+                        label: target.label,
+                        root: root,
+                        version: target.version,
+                        aliases: target.aliases
+                    };
+                }
+            });
+
+            if (matchesRoot(pathname, target.root) && (!active || target.root.length > active.root.length)) {
+                active = target;
+            }
+        });
+
+        if (active) {
+            return active;
+        }
+
+        return null;
+    }
+
+    function stripActiveRoot(pathname, activeTarget) {
+        if (!activeTarget || activeTarget.root === '/') {
+            return pathname;
+        }
+
+        if (!matchesRoot(pathname, activeTarget.root)) {
+            return pathname;
+        }
+
+        if (pathname === activeTarget.root.slice(0, -1)) {
+            return '/';
+        }
+
+        return pathname.slice(activeTarget.root.length - 1) || '/';
+    }
+
+    function findDefaultTarget(targets) {
+        return targets.find(function (target) {
+            return target.key === defaultAlias || target.aliases.indexOf(defaultAlias) !== -1;
+        }) || targets[0] || null;
+    }
+
+    function renderFallback() {
+        if (selector) {
+            selector.classList.add('d-none');
+        }
+
+        if (warning) {
+            warning.classList.add('d-none');
+        }
+    }
+
+    function updateWarning(activeTarget, defaultTarget) {
+        if (!warning) {
+            return;
+        }
+
+        var message = warning.dataset.versionWarningMessage || 'You are viewing a non-default version of these docs.';
+        var text = warning.querySelector('[data-version-warning-text]');
+
+        if (text) {
+            text.textContent = message;
+        }
+
+        if (activeTarget && defaultTarget && activeTarget.version !== defaultTarget.version) {
+            warning.classList.remove('d-none');
+        } else {
+            warning.classList.add('d-none');
+        }
+    }
+
+    function render(payload) {
+        var targets = normalizeVersions(payload);
+
+        if (!targets.length) {
+            renderFallback();
+            return;
+        }
+
+        var currentPath = normalizePath(window.location.pathname);
+        var activeTarget = findActiveTarget(currentPath, targets);
+        var defaultTarget = findDefaultTarget(targets);
+        var relativePath = stripActiveRoot(currentPath, activeTarget);
+        var currentSearch = window.location.search || '';
+        var currentHash = window.location.hash || '';
+
+        if (selector) {
+            var list = selector.querySelector('[data-version-options]');
+            var currentLabel = selector.querySelector('[data-version-current-label]');
+            var status = selector.querySelector('[data-version-status]');
+
+            selector.classList.remove('d-none');
+
+            if (list) {
+                list.innerHTML = '';
+
+                targets.forEach(function (target) {
+                    var item = document.createElement('a');
+                    item.className = 'SelectMenu-item';
+                    item.setAttribute('role', 'menuitem');
+                    item.href = buildHref(joinPaths(target.root, relativePath)) + currentSearch + currentHash;
+                    item.textContent = target.label;
+
+                    if (activeTarget && target.key === activeTarget.key) {
+                        item.setAttribute('aria-current', 'page');
+                        item.classList.add('text-semibold');
+                    }
+
+                    item.addEventListener('click', function () {
+                        selector.removeAttribute('open');
+                    });
+
+                    list.appendChild(item);
+                });
+            }
+
+            if (currentLabel) {
+                currentLabel.textContent = activeTarget ? activeTarget.label : '';
+            }
+
+            if (status) {
+                status.textContent = targets.length + ' target' + (targets.length === 1 ? '' : 's') + ' available';
+            }
+        }
+
+        updateWarning(activeTarget, defaultTarget);
+    }
+
+    fetch(versionsUrl, { cache: 'no-cache' })
+        .then(function (response) {
+            if (!response.ok) {
+                throw new Error('Unable to load version metadata');
+            }
+
+            return response.json();
+        })
+        .then(render)
+        .catch(renderFallback);
+});

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-profile
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 2.2.1
 platform: ruby
 authors:
 - Allison Thackston
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-12 00:00:00.000000000 Z
+date: 2026-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -117,9 +117,12 @@ files:
 - _includes/related.html
 - _includes/repo-card.html
 - _includes/repositories.html
+- _includes/resolve-versioning.html
 - _includes/social.html
 - _includes/toggle.html
 - _includes/user-metadata.html
+- _includes/version-selector.html
+- _includes/version-warning.html
 - _layouts/category_index.html
 - _layouts/category_layout.html
 - _layouts/default.html
@@ -152,6 +155,7 @@ files:
 - assets/js/mermaid.js
 - assets/js/theme-toggle.js
 - assets/js/topbar.js
+- assets/js/versioning.js
 homepage: https://www.primerpages.com
 licenses:
 - MIT