jekyll-theme-centos 2.52.0.beta.52 → 2.52.0.beta.53

data/assets/js/base/heading-anchor.js

@@ -0,0 +1,108 @@
+// Heading Anchor Component — requires Bootstrap >= 5.3 (tooltip.setContent) and Font Awesome 6+
+
+document.addEventListener('DOMContentLoaded', () => {
+  if (typeof bootstrap === 'undefined') {
+    console.warn('heading-anchor: Bootstrap not available');
+    return;
+  }
+
+  const DEFAULT_TEXT = 'Copy link';
+  const scriptEl = document.getElementById('centos-heading-anchor');
+  const RESET_DELAY = scriptEl?.dataset.resetDelay
+    ? parseInt(scriptEl.dataset.resetDelay, 10) : 1500;
+  const SUCCESS_TEXT = scriptEl?.dataset.successMessage || 'Copied!';
+
+  // One shared region: multiple regions would cause simultaneous AT announcements per anchor.
+  let liveRegion = document.getElementById('centos-heading-anchor-live');
+  if (!liveRegion) {
+    liveRegion = document.createElement('div');
+    liveRegion.id = 'centos-heading-anchor-live';
+    liveRegion.setAttribute('aria-live', 'polite');
+    liveRegion.setAttribute('aria-atomic', 'true');
+    liveRegion.className = 'visually-hidden';
+    document.body.appendChild(liveRegion);
+  }
+
+  document.querySelectorAll('.heading-anchor[data-copy-anchor]').forEach(anchor => {
+    // FA SVG+JS replaces <i> with <svg> before this DOMContentLoaded fires.
+    // Cache innerHTML after FA has processed so it can be restored on reset.
+    const originalIconHTML = anchor.innerHTML;
+    // Guards blur/mouseenter handlers from collapsing the tooltip during the success window.
+    let isLocked = false;
+
+    const tooltip = new bootstrap.Tooltip(anchor, {
+      title: DEFAULT_TEXT,
+      trigger: 'manual',   // CSS sets pointer-events:none on hidden anchors, defeating Bootstrap's auto hover/focus triggers.
+      placement: 'top',
+      animation: false     // Prevents Bootstrap's fade and the CSS opacity transition from desyncing.
+    });
+
+    const updateUI = (isSuccess) => {
+      tooltip.setContent({ '.tooltip-inner': isSuccess ? SUCCESS_TEXT : DEFAULT_TEXT });
+      if (isSuccess) {
+        // FA SVG+JS mode: <i> has been replaced by <svg>; swap the path to a checkmark.
+        const svg = anchor.querySelector('svg');
+        if (svg) {
+          const path = svg.querySelector('path');
+          if (path) {
+            svg.setAttribute('viewBox', '0 0 448 512');
+            path.setAttribute('d', 'M434.8 70.1c14.3 10.4 17.5 30.4 7.1 44.7l-256 352c-5.5 7.6-14 12.3-23.4 13.1s-18.5-2.7-25.1-9.3l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l101.5 101.5 234-321.7c10.4-14.3 30.4-17.5 44.7-7.1z');
+          }
+        } else {
+          // FA webfont mode: <i> is still in the DOM; toggle classes normally.
+          const icon = anchor.querySelector('i');
+          if (icon) { icon.classList.remove('fa-link'); icon.classList.add('fa-check'); }
+        }
+      } else {
+        anchor.innerHTML = originalIconHTML;
+      }
+      anchor.classList.toggle('is-active', isSuccess);
+      // Empty string on reset prevents AT from re-announcing stale text on DOM inspection.
+      liveRegion.textContent = isSuccess ? SUCCESS_TEXT : '';
+      if (isSuccess) tooltip.show();
+    };
+
+    const handleInteraction = (show) => {
+      if (!isLocked) show ? tooltip.show() : tooltip.hide();
+    };
+
+    anchor.addEventListener('mouseenter', () => handleInteraction(true));
+    anchor.addEventListener('mouseleave', () => handleInteraction(false));
+    anchor.addEventListener('focus', () => handleInteraction(true));
+    anchor.addEventListener('blur', () => handleInteraction(false));
+
+    anchor.addEventListener('click', async (e) => {
+      e.preventDefault();
+      if (isLocked) return;
+
+      if (!navigator.clipboard) {
+        console.warn('heading-anchor: Clipboard API unavailable');
+        return;
+      }
+
+      const url = window.location.origin + window.location.pathname + anchor.dataset.copyAnchor;
+
+      try {
+        await navigator.clipboard.writeText(url);
+        isLocked = true;
+        // isLocked must be true before blur() so the resulting blur event is suppressed
+        // and does not hide the tooltip before the success state has been rendered.
+        anchor.blur();
+        updateUI(true);
+
+        setTimeout(() => {
+          isLocked = false;
+          updateUI(false);
+          // mouseleave/blur events fired while isLocked was true were suppressed;
+          // hide now if the user already moved away during the success window.
+          if (!anchor.matches(':hover')) tooltip.hide();
+        }, RESET_DELAY);
+
+      } catch (err) {
+        console.warn('heading-anchor: clipboard write failed', err);
+        isLocked = false;
+        anchor.innerHTML = originalIconHTML;
+      }
+    });
+  });
+});

data/assets/js/base/init-tooltips.js

@@ -1,5 +1,6 @@
-// Bootstrap Tooltip Initialization
-// Initializes all Bootstrap tooltips on the page
-// Data attributes are NOT needed - this is a global initialization
+// Bootstrap Tooltip and Popover Initialization
 const tooltipTriggerList = document.querySelectorAll('[data-bs-toggle="tooltip"]');
-const tooltipList = [...tooltipTriggerList].map((tooltipTriggerEl) => new bootstrap.Tooltip(tooltipTriggerEl));
+const tooltipList = [...tooltipTriggerList].map((el) => new bootstrap.Tooltip(el));
+
+const popoverTriggerList = document.querySelectorAll('[data-bs-toggle="popover"]');
+const popoverList = [...popoverTriggerList].map((el) => new bootstrap.Popover(el));

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-centos
 version: !ruby/object:Gem::Version
-  version: 2.52.0.beta.52
+  version: 2.52.0.beta.53
 platform: ruby
 authors:
 - ReleaseBot
@@ -298,7 +298,11 @@ files:
 - _data/base/datatable_schema.yml
 - _data/base/event_schema.yml
 - _data/base/fontawesome_schema.yml
+- _data/base/footer.yml
+- _data/base/footer_schema.yml
 - _data/base/head_schema.yml
+- _data/base/heading_anchor.yml
+- _data/base/heading_anchor_schema.yml
 - _data/base/highlight_schema.yml
 - _data/base/image_schema.yml
 - _data/base/languages.yml
@@ -317,7 +321,6 @@ files:
 - _data/base/sponsors.yml
 - _data/base/sponsors_schema.yml
 - _data/base/title_schema.yml
-- _data/base/toc_generator_schema.yml
 - _data/base/toc_schema.yml
 - _data/download/cards.yml
 - _data/download/navbar.yml
@@ -337,6 +340,7 @@ files:
 - _includes/base/fontawesome.html.liquid
 - _includes/base/footer.html.liquid
 - _includes/base/head.html.liquid
+- _includes/base/heading_anchor.html.liquid
 - _includes/base/highlight.html.liquid
 - _includes/base/image.html.liquid
 - _includes/base/link.html.liquid
@@ -351,8 +355,8 @@ files:
 - _includes/base/sponsors-cards.html.liquid
 - _includes/base/sponsors-carousel.html.liquid
 - _includes/base/title.html.liquid
+- _includes/base/toc-generator.html.liquid
 - _includes/base/toc.html.liquid
-- _includes/base/toc_generator.html.liquid
 - _includes/download/cards-body-commands.html
 - _includes/download/cards-body-convert.html
 - _includes/download/cards-body-doc.html
@@ -530,6 +534,8 @@ files:
 - assets/img/base/page-with-event.svg
 - assets/img/base/page-with-fontawesome.png
 - assets/img/base/page-with-fontawesome.svg
+- assets/img/base/page-with-footer.png
+- assets/img/base/page-with-footer.svg
 - assets/img/base/page-with-heading.png
 - assets/img/base/page-with-heading.svg
 - assets/img/base/page-with-highlight.png
@@ -592,6 +598,7 @@ files:
 - assets/js/base/backtotop.js
 - assets/js/base/copyvalue.js
 - assets/js/base/datatable.js
+- assets/js/base/heading-anchor.js
 - assets/js/base/highlight.js
 - assets/js/base/init-tooltips.js
 - assets/js/bootstrap.bundle.js

data/_data/base/toc_generator_schema.yml

@@ -1,102 +0,0 @@
-title: Table of Contents Generator Component Configuration
-description: >-
-  Schema for configuring the toc_generator component. Parameters are passed
-  directly as include parameters. The `html` parameter is required.
-type: object
-properties:
-  html:
-    type: string
-    description: >-
-      The compiled HTML string of the page content to generate the table
-      of contents from. Typically set to `content` (the Jekyll page
-      content variable). This parameter is required.
-  h_min:
-    type: integer
-    default: 1
-    description: >-
-      Minimum heading level to include in the table of contents. Headings
-      below this level are ignored (e.g., set to `2` to exclude `<h1>`
-      headings).
-  h_max:
-    type: integer
-    default: 6
-    description: >-
-      Maximum heading level to include in the table of contents. Headings
-      above this level are ignored (e.g., set to `3` to exclude `<h4>`
-      through `<h6>` headings).
-  sanitize:
-    type: boolean
-    default: false
-    description: >-
-      When `true`, strips HTML from heading text in the TOC links so that
-      only plain text is rendered in each list item.
-  class:
-    type: string
-    default: ""
-    description: >-
-      CSS class(es) applied to the root list element (`<ul>` or `<ol>`).
-      Use to apply custom styling to the table of contents container.
-  id:
-    type: string
-    default: ""
-    description: >-
-      ID attribute applied to the root list element. Use to target the
-      table of contents with CSS or JavaScript.
-  ordered:
-    type: boolean
-    default: false
-    description: >-
-      When `true`, renders the table of contents as an ordered list
-      (`<ol>`). When `false` (default), an unordered list (`<ul>`) is
-      rendered.
-  flat_toc:
-    type: boolean
-    default: false
-    description: >-
-      When `true`, renders a flat single-level list regardless of heading
-      nesting. When `false` (default), the list reflects the heading
-      hierarchy.
-  item_class:
-    type: string
-    default: ""
-    description: >-
-      CSS class(es) applied to each `<li>` list item. Supports the
-      `%level%` placeholder, which is replaced with the current heading
-      level number at render time.
-  submenu_class:
-    type: string
-    default: ""
-    description: >-
-      CSS class(es) applied to each nested child list element. Supports
-      the `%level%` placeholder, which is replaced with the submenu
-      heading level number at render time.
-  base_url:
-    type: string
-    default: ""
-    description: >-
-      Base URL prepended to each anchor link in the TOC. Use when the
-      table of contents is rendered on a different page than the content
-      it references.
-  anchor_class:
-    type: string
-    default: ""
-    description: >-
-      CSS class(es) applied to each `<a>` anchor element inside the TOC
-      list items.
-  skip_no_ids:
-    type: boolean
-    default: false
-    description: >-
-      When `true`, headings that do not have an `id` attribute are skipped
-      and not included in the table of contents.
-  baseurl:
-    type: string
-    description: >-
-      Deprecated. Use `base_url` instead. When provided, a deprecation
-      warning comment is emitted in the HTML output.
-  skipNoIDs:
-    type: boolean
-    description: >-
-      Deprecated. Use `skip_no_ids` instead. When provided, a deprecation
-      warning comment is emitted in the HTML output.
-additionalProperties: false