jekyll-theme-centos 0.0.0

data/assets/js/base/backtotop.js

@@ -0,0 +1,20 @@
+// Back-to-Top Button Initialization
+// Reads configuration from data attributes on this script tag
+// Applied via backtotop.html.liquid template with data attributes
+
+(function () {
+  const scriptTag = document.getElementById('centos-backtop')
+
+  if (!scriptTag) {
+    console.warn('Back-to-Top: script tag with id "centos-backtop" not found')
+    return
+  }
+
+  const config = {
+    diameter: parseInt(scriptTag.dataset.diameter || '56', 10),
+    backgroundColor: scriptTag.dataset.backgroundColor || '#A54C93',
+    textColor: scriptTag.dataset.textColor || '#ffffff'
+  }
+
+  addBackToTop(config)
+})()

data/assets/js/base/copyvalue.js

@@ -0,0 +1,145 @@
+// Copy Value Component
+// Provides copy-to-clipboard functionality with visual feedback.
+
+(function () {
+class CopyButtonHandler {
+  constructor (button, config = {}) {
+    this.button = button
+    this.originalTitle = button.getAttribute('data-bs-title') || button.getAttribute('aria-label') || button.getAttribute('title')
+    this.resetDelay = config.resetDelay || 2000
+    this.checkmarkPath = config.checkmarkPath || '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'
+    this.checkmarkViewbox = config.checkmarkViewbox || '0 0 448 512'
+    this.successMessage = config.successMessage || 'Copied!'
+    this.originalIcon = this._captureIcon()
+  }
+
+  _captureIcon () {
+    const svg = this.button.querySelector('svg')
+    if (svg) {
+      const path = svg.querySelector('path')
+      return { mode: 'svg', viewBox: svg.getAttribute('viewBox'), pathD: path ? path.getAttribute('d') : null }
+    }
+    const iconEl = this.button.querySelector('[class*="fa-"]')
+    if (iconEl) {
+      return { mode: 'css', className: iconEl.className }
+    }
+    return null
+  }
+
+  handleClick (e) {
+    e.preventDefault()
+
+    const value = this.button.getAttribute('data-copy-value')
+
+    if (!value) {
+      console.warn('No copy value found in data-copy-value attribute', this.button)
+      return
+    }
+
+    navigator.clipboard.writeText(value.trim())
+      .then(() => this.showSuccess())
+      .catch((err) => {
+        console.error('Failed to copy value:', value, 'Error:', err)
+      })
+  }
+
+  showSuccess () {
+    this.changeToCheckmark()
+    this.updateTooltip(this.successMessage)
+    setTimeout(() => this.reset(), this.resetDelay)
+  }
+
+  changeToCheckmark () {
+    if (!this.originalIcon) return
+
+    if (this.originalIcon.mode === 'svg') {
+      const svg = this.button.querySelector('svg')
+      if (svg) {
+        svg.setAttribute('viewBox', this.checkmarkViewbox)
+        const path = svg.querySelector('path')
+        if (path) path.setAttribute('d', this.checkmarkPath)
+      }
+    } else {
+      // CSS/webfont mode: fa-check only exists in Solid style — force fa-solid
+      // regardless of the original style prefix to avoid a missing-glyph box.
+      const iconEl = this.button.querySelector('[class*="fa-"]')
+      if (iconEl) iconEl.className = 'fa-solid fa-check'
+    }
+  }
+
+  updateTooltip (message) {
+    if (!message || typeof message !== 'string') {
+      console.warn('Invalid tooltip message:', message)
+      return
+    }
+
+    this.button.setAttribute('data-bs-title', message)
+
+    try {
+      const tooltip = bootstrap.Tooltip.getInstance(this.button)
+      if (tooltip) {
+        tooltip._config.title = message
+        tooltip.update()
+        tooltip.show()
+      }
+    } catch (err) {
+      console.warn('Bootstrap Tooltip unavailable or error updating tooltip:', err)
+    }
+  }
+
+  reset () {
+    if (this.originalIcon) {
+      if (this.originalIcon.mode === 'svg') {
+        const svg = this.button.querySelector('svg')
+        if (svg) {
+          svg.setAttribute('viewBox', this.originalIcon.viewBox)
+          const path = svg.querySelector('path')
+          if (path && this.originalIcon.pathD) path.setAttribute('d', this.originalIcon.pathD)
+        }
+      } else {
+        const iconEl = this.button.querySelector('[class*="fa-"]')
+        if (iconEl) iconEl.className = this.originalIcon.className
+      }
+    }
+
+    this.updateTooltip(this.originalTitle)
+
+    try {
+      const tooltip = bootstrap.Tooltip.getInstance(this.button)
+      if (tooltip) tooltip.hide()
+    } catch (err) {
+      console.warn('Bootstrap Tooltip unavailable or error hiding tooltip:', err)
+    }
+  }
+}
+
+document.addEventListener('DOMContentLoaded', function () {
+  const scriptElement = document.getElementById('centos-copyvalue')
+  const config = {}
+
+  if (scriptElement) {
+    if (scriptElement.dataset.resetDelay) config.resetDelay = parseInt(scriptElement.dataset.resetDelay, 10)
+    if (scriptElement.dataset.checkmarkPath) config.checkmarkPath = scriptElement.dataset.checkmarkPath
+    if (scriptElement.dataset.checkmarkViewbox) config.checkmarkViewbox = scriptElement.dataset.checkmarkViewbox
+    if (scriptElement.dataset.successMessage) config.successMessage = scriptElement.dataset.successMessage
+  }
+
+  const handlers = new WeakMap()
+
+  document.addEventListener('click', function (e) {
+    const button = e.target.closest('.copy-btn')
+    if (!button) return
+
+    if (!handlers.has(button)) {
+      try {
+        handlers.set(button, new CopyButtonHandler(button, config))
+      } catch (err) {
+        console.error('Failed to initialize copy button:', button, 'Error:', err)
+        return
+      }
+    }
+
+    handlers.get(button).handleClick(e)
+  })
+})
+})()

data/assets/js/base/datatable.js

@@ -0,0 +1,41 @@
+// DataTables Initialization
+// Reads configuration from data attributes on this script tag
+// Applied via datatable.html.liquid template with data attributes
+
+(function () {
+  if (typeof DataTable === 'undefined') {
+    console.warn('datatable: DataTable not available')
+    return
+  }
+
+  const scriptTag = document.getElementById('centos-datatable')
+
+  if (!scriptTag) {
+    console.warn('DataTables: script tag with id "centos-datatable" not found')
+    return
+  }
+
+  const pageLength = parseInt(scriptTag.dataset.pageLength || '10', 10)
+  const lengthMenuStr = scriptTag.dataset.lengthMenu || '[10,25,50,75]'
+
+  let lengthMenu = [10, 25, 50, 100]
+  try {
+    lengthMenu = JSON.parse(lengthMenuStr)
+  } catch (e) {
+    console.warn('DataTables: Invalid lengthMenu format, using default:', e)
+  }
+
+  document.querySelectorAll('table.dataTable').forEach(function (tableEl) {
+    const rowCount = tableEl.querySelectorAll('tbody tr').length
+    const enabledCondition = rowCount > 10
+
+    new DataTable(tableEl, {
+      paging: enabledCondition,
+      info: enabledCondition,
+      searching: enabledCondition,
+      order: [[0, 'asc']],
+      pageLength: pageLength,
+      lengthMenu: lengthMenu
+    })
+  })
+})()

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) : 2000
+  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-hashtag'); 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/highlight.js

@@ -0,0 +1,12 @@
+// Highlight.js Initialization
+// Initializes syntax highlighting on all code blocks with 'hljs' class
+// Enables copy-to-clipboard functionality via highlightjs-copy plugin
+(function () {
+  if (typeof hljs === 'undefined' || typeof CopyButtonPlugin === 'undefined') {
+    console.warn('highlight: hljs or CopyButtonPlugin not available')
+    return
+  }
+  document.querySelectorAll('.content code').forEach(el => el.classList.add('hljs'))
+  hljs.addPlugin(new CopyButtonPlugin())
+  hljs.highlightAll()
+})()

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

@@ -0,0 +1,12 @@
+// Bootstrap Tooltip and Popover Initialization
+(function () {
+  if (typeof bootstrap === 'undefined') {
+    console.warn('init-tooltips: Bootstrap not available')
+    return
+  }
+  const tooltipTriggerList = document.querySelectorAll('[data-bs-toggle="tooltip"]')
+  ;[...tooltipTriggerList].forEach((el) => new bootstrap.Tooltip(el))
+
+  const popoverTriggerList = document.querySelectorAll('[data-bs-toggle="popover"]')
+  ;[...popoverTriggerList].forEach((el) => new bootstrap.Popover(el))
+})()