jekyll-theme-primerpages 2.3.0

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

@@ -0,0 +1,184 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-theme-primerpages
+version: !ruby/object:Gem::Version
+  version: 2.3.0
+platform: ruby
+authors:
+- Allison Thackston
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: jekyll-seo-tag
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: jemoji
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: kramdown-parser-gfm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+description:
+email:
+- allison@allisonthackston.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- _config.yml
+- _includes/awesome-nav-breadcrumb-trail.html
+- _includes/awesome-nav-breadcrumbs.html
+- _includes/awesome-nav-menu-tree.html
+- _includes/awesome-nav-menu.html
+- _includes/awesome-nav-sidebar.html
+- _includes/awesome-nav-tree.html
+- _includes/breadcrumbs.html
+- _includes/category_index.html
+- _includes/collection-menu.html
+- _includes/collection-sidebar.html
+- _includes/custom-colors.html
+- _includes/footer.html
+- _includes/head.html
+- _includes/header-appbar.html
+- _includes/header-sidebar.html
+- _includes/header-stacked.html
+- _includes/header-topbar.html
+- _includes/link-card.html
+- _includes/links.html
+- _includes/masthead.html
+- _includes/mini-repo-info-card.html
+- _includes/nav-overlay.html
+- _includes/nav.html
+- _includes/navbar-underline.html
+- _includes/paginator_nav.html
+- _includes/post-card.html
+- _includes/post-feature-card.html
+- _includes/post-gallery.html
+- _includes/post-index.html
+- _includes/post-tease-image-card.html
+- _includes/post-tease-text-card.html
+- _includes/post-timeline-card.html
+- _includes/post-timeline.html
+- _includes/posts.html
+- _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
+- _layouts/docs.html
+- _layouts/docs_index.html
+- _layouts/home.html
+- _layouts/landing.html
+- _layouts/linktree.html
+- _layouts/page.html
+- _layouts/paginate.html
+- _layouts/paginate_timeline.html
+- _layouts/post.html
+- _layouts/profile.html
+- _layouts/repositories.html
+- _layouts/tag_index.html
+- _layouts/tags.html
+- _sass/_admonitions.scss
+- _sass/_highlight-syntax.scss
+- _sass/_language-colors.scss
+- _sass/_main.scss
+- _sass/jekyll-theme-primerpages-compat.scss
+- _sass/jekyll-theme-primerpages.scss
+- assets/css/style.scss
+- assets/css/theme.scss
+- assets/img/default.png
+- assets/img/favicon.ico
+- assets/img/social-preview.png
+- assets/img/user-image.jpg
+- assets/js/anchor-links.js
+- assets/js/mermaid.js
+- assets/js/theme-toggle.js
+- assets/js/topbar.js
+- assets/js/versioning.js
+homepage: https://www.primerpages.com
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Jekyll theme built off of Github's personal website template and primer.
+test_files: []