jekyll-theme-centos 2.52.0.beta.104 → 2.52.0.beta.106

data/_includes/base/sponsors-data.html.liquid

@@ -0,0 +1,32 @@
+{% comment %}
+sponsors-data: renders nothing; it sets the sponsors gate, data, and each member's logo src for sponsors-cards and sponsors-carousel.
+Data: include.data > page.with_sponsors_data > site.data.sponsors > site.data.base.sponsors
+Schema: src/YAML/sponsors_schema.yml
+{% endcomment %}
+
+{%- comment %} Include assigns are global, so every value the callers read is reset here on each call. {% endcomment %}
+{%- assign sponsors_member_srcs = "" | split: "" %}
+
+{%- assign with_sponsors = include.with_sponsors
+| default: page.with_sponsors
+%}
+
+{%- assign with_sponsors_data = include.data
+| default: page.with_sponsors_data
+| default: site.data.sponsors
+| default: site.data.base.sponsors
+%}
+
+{%- assign with_sponsors_schema = site.data.base.sponsors_schema.properties.with_sponsors_data.properties %}
+{%- assign sponsors_members     = with_sponsors_data.members         | default: with_sponsors_schema.members.default %}
+{%- assign sponsors_image_base  = with_sponsors_data.image_base_path | default: with_sponsors_schema.image_base_path.default %}
+
+{%- comment %} sponsors_member_srcs lines up with sponsors_members by index, so callers read it with forloop.index0. {% endcomment %}
+{%- for member in sponsors_members %}
+  {%- if member.image contains "://" %}
+    {%- assign sponsors_member_src = member.image %}
+  {%- else %}
+    {%- assign sponsors_member_src = site.baseurl | append: sponsors_image_base | append: member.image %}
+  {%- endif %}
+  {%- assign sponsors_member_srcs = sponsors_member_srcs | push: sponsors_member_src %}
+{%- endfor -%}

data/_includes/base/title.html.liquid

@@ -1,42 +1,7 @@
 {% comment %}
-================================================================================
-Template: Page Title Component
-Purpose: Renders page title section with optional subtitle/lead text. Displays
-primary heading and descriptive lead with customizable styling.
-================================================================================
-
-Strategic Design Logic:
-- Semantic headings: h1 primary, lead text for subtitle
-- Data source hierarchy: flexible configuration
-- Customizable styling: class overrides per element
-- Optional lead text: subtitle/description support
-- Schema-based defaults: consistent styling
-- Responsive layout: bootstrap grid
-
-Required Inputs (from data objects):
-None - uses page.title as fallback
-
-Optional Inputs (from data objects):
-- title: Page heading text (defaults to page.title)
-- title_lead: Subtitle/description text
-
-Optional Inputs (from include):
-- data: Title configuration object
-- column_class: Bootstrap column class for the row wrapper (set by the layout to
-  keep this component aligned with the content column; defaults to "col")
-- row_class: Bootstrap class(es) for the row wrapper (set by the layout to
-  keep this component's row aligned with breadcrumb, artwork, toc, and
-  content; defaults to "row mb-3")
-
-Data Source Hierarchy (in priority order):
-1. include.data       - Explicitly passed configuration
-2. page.with_title_data - Page front matter
-3. site.data.title    - Site configuration
-4. site.data.base.title - Theme defaults
-
-Conditional Logic:
-- title_lead present: Only renders subtitle if not empty
-================================================================================
+title: renders the page title and optional lead inside a row and column; content.html.liquid sets row_class and column_class.
+Data: include.data > page.with_title_data > site.data.title > site.data.base.title
+Schema: src/YAML/title_schema.yml
 {% endcomment %}
 
 {%- assign with_title = include.with_title
@@ -52,15 +17,13 @@ Conditional Logic:
 {%- if with_title -%}
 
 {%- assign with_title_schema = site.data.base.title_schema.properties.with_title_data.properties %}
-
-{%- comment %} === Presentation === {% endcomment %}
 {%- assign class            = with_title_data.class            | default: with_title_schema.class.default %}
 {%- assign title            = with_title_data.title            | default: page.title %}
 {%- assign title_class      = with_title_data.title_class      | default: with_title_schema.title_class.default %}
 {%- assign title_lead       = with_title_data.title_lead       | default: page.title_lead %}
 {%- assign title_lead_class = with_title_data.title_lead_class | default: with_title_schema.title_lead_class.default %}
-{%- assign column_class     = include.column_class | default: 'col' %}
-{%- assign row_class        = include.row_class | default: 'row mb-3' %}
+{%- assign column_class     = include.column_class | default: site.data.base.content_schema.properties.with_content_data.properties.col_class.default %}
+{%- assign row_class        = include.row_class | default: site.data.base.content_schema.properties.with_content_data.properties.row_class.default %}
 
 <div class="{{ row_class }}">
   <div class="{{ column_class }}">

data/_includes/base/toc-generator.html.liquid

@@ -1,3 +1,7 @@
+{% comment %}
+toc-generator: renders a nested list of links to the headings in include.html (vendored allejo/jekyll-toc, MIT license below).
+{% endcomment %}
+{%- comment %} trim leading output {% endcomment -%}
 {% capture tocWorkspace %}
     {% comment %}
         Copyright (c) 2017 Vladimir "allejo" Jimenez

data/_includes/base/toc.html.liquid

@@ -1,46 +1,7 @@
 {% comment %}
-================================================================================
-Template: Table of Contents (TOC) Component
-Purpose: Generates interactive table of contents from page content headings
-using Jekyll-TOC generator. Displays in collapsible Bootstrap accordion.
-================================================================================
-
-Strategic Design Logic:
-- Accordion wrapper: collapsible expandable container
-- Heading extraction: automatic from page content
-- Hierarchy support: nested outline structure
-- Configuration-driven: customizable via data object
-- Automatic anchor generation: heading IDs for linking
-- Responsive: works on all screen sizes
-
-Required Inputs (from page object):
-- content: Page HTML content (automatically generated)
-
-Optional Inputs (from data objects):
-- class: Container CSS classes
-- id: TOC wrapper ID (default: "page-toc")
-- item_class: TOC item CSS classes (default: "my-2")
-- anchor_class: Anchor link CSS classes
-- h_min/h_max: Heading level range (h2-h4 typical)
-- ordered: Use ordered list (true/false)
-- submenu_class: Submenu CSS classes
-- base_url: Base URL for anchors
-- sanitize: Clean HTML in headings (boolean)
-- skip_no_ids: Skip headings without IDs (boolean)
-- flat_toc: Flatten hierarchy (boolean)
-
-Optional Inputs (from include):
-- data: TOC configuration object
-- column_class: Bootstrap column class for the row wrapper (set by the layout to
-  keep this component aligned with the content column; defaults to "col")
-- row_class: Bootstrap class(es) for the row wrapper (set by the layout to
-  keep this component's row aligned with breadcrumb, title, artwork, and
-  content; defaults to "row mb-3")
-
-Data Source Hierarchy (in priority order):
-- with_toc:      include.with_toc → page.with_toc
-- with_toc_data: include.data → page.with_toc_data → site.data.toc → site.data.base.toc
-================================================================================
+toc: renders a collapsible "On this page" accordion holding a table of contents built from the page content; content.html.liquid sets row_class and column_class.
+Data: include.data > page.with_toc_data > site.data.toc > site.data.base.toc
+Schema: src/YAML/toc_schema.yml
 {% endcomment %}
 
 {%- assign with_toc = include.with_toc
@@ -50,11 +11,9 @@ Data Source Hierarchy (in priority order):
 {%- if with_toc -%}
 {%- assign with_toc_data   = include.data | default: page.with_toc_data | default: site.data.toc | default: site.data.base.toc %}
 {%- assign with_toc_schema = site.data.base.toc_schema.properties["with_toc_data"].properties %}
-
-{%- comment %} === Configuration properties === {% endcomment %}
 {%- assign class             = with_toc_data.class             | default: with_toc_schema["class"].default %}
-{%- assign id                = with_toc_data.id                | default: with_toc_schema["id"].default | default: "page-toc" %}
-{%- assign item_class        = with_toc_data.item_class        | default: with_toc_schema["item_class"].default | default: "my-2" %}
+{%- assign id                = with_toc_data.id                | default: with_toc_schema["id"].default %}
+{%- assign item_class        = with_toc_data.item_class        | default: with_toc_schema["item_class"].default %}
 {%- assign anchor_class      = with_toc_data.anchor_class      | default: with_toc_schema["anchor_class"].default | default: site.with_link_decorator_data.default_link_classes %}
 {%- assign h_min             = with_toc_data.h_min             | default: with_toc_schema["h_min"].default %}
 {%- assign h_max             = with_toc_data.h_max             | default: with_toc_schema["h_max"].default %}
@@ -64,43 +23,31 @@ Data Source Hierarchy (in priority order):
 {%- assign sanitize          = with_toc_data.sanitize          | default: with_toc_schema["sanitize"].default %}
 {%- assign skip_no_ids       = with_toc_data.skip_no_ids       | default: with_toc_schema["skip_no_ids"].default %}
 {%- assign flat_toc          = with_toc_data.flat_toc          | default: with_toc_schema["flat_toc"].default %}
-{%- assign column_class      = include.column_class | default: 'col' %}
-{%- assign row_class         = include.row_class | default: 'row mb-3' %}
-
-{%- comment %} === Presentation === {% endcomment %}
-
-{%- comment %} --- HTML ---  {% endcomment %}
+{%- assign column_class      = include.column_class | default: site.data.base.content_schema.properties.with_content_data.properties.col_class.default %}
+{%- assign row_class         = include.row_class | default: site.data.base.content_schema.properties.with_content_data.properties.row_class.default %}
 <div class="{{ row_class }}">
   <div class="{{ column_class }}">
-    <div class="accordion shadow-sm" id="pageToc">
-      <div class="accordion-item">
-        <div class="accordion-header" id="flush-headingOne">
-          <button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#flush-collapseOne" aria-expanded="false" aria-controls="flush-collapseOne">
-            <i class="fa-solid fa-list" aria-hidden="true"></i>
-            <span class="mx-3 fw-bold">On this page</span>
-          </button>
-        </div>
-        <div id="flush-collapseOne" class="accordion-collapse collapse" data-bs-parent="#pageToc">
-          <div class="accordion-body small">
-            {%- include base/toc-generator.html.liquid
-            id=id
-            html=content
-            class=class
-            item_class=item_class
-            anchor_class=anchor_class
-            h_min=h_min
-            h_max=h_max
-            ordered=ordered
-            submenu_class=submenu_class
-            base_url=base_url
-            sanitize=sanitize
-            skip_no_ids=skip_no_ids
-            flat_toc=flat_toc
-            %}
-          </div>
-        </div>
-      </div>
-    </div>
+    {%- capture toc_body %}
+      {%- include base/toc-generator.html.liquid
+      id=id
+      html=content
+      class=class
+      item_class=item_class
+      anchor_class=anchor_class
+      h_min=h_min
+      h_max=h_max
+      ordered=ordered
+      submenu_class=submenu_class
+      base_url=base_url
+      sanitize=sanitize
+      skip_no_ids=skip_no_ids
+      flat_toc=flat_toc
+      %}
+    {%- endcapture %}
+    {%- capture toc_items %}
+      {%- include base/accordion-item.html.liquid icon="fa-solid fa-list" title="On this page" title_class="ms-2 fw-bold" header_class="" item_id="flush-collapseOne" accordion_id="pageToc" body_class="small" body=toc_body %}
+    {%- endcapture %}
+    {%- include base/accordion.html.liquid id="pageToc" class="shadow-sm" items=toc_items %}
   </div>
 </div>
 {%- endif -%}

data/_sass/base/_customization.scss

@@ -392,3 +392,21 @@ body.has-navbar main {
     scroll-margin-top: 80px;
   }
 }
+
+// --------------------------------------------------------------------------------
+// Sponsor logos
+// --------------------------------------------------------------------------------
+// Caps logo size in sponsors-cards (card and image) and sponsors-carousel (image).
+// Bootstrap has no max-height/max-width utilities beyond mh-100/mw-100, and a
+// class keeps the size out of inline styles, which html-validate flags.
+.sponsors-logo {
+  max-height: 60px;
+  max-width: 242px;
+}
+
+// Fixed slide box so the carousel keeps a stable height as logos of
+// different sizes fade in and out.
+.sponsors-carousel-slide {
+  height: 80px;
+  width: 262px;
+}

data/_sass/base/_preview.scss

@@ -2,7 +2,7 @@
 // Preview component: demo, toolbar, and code row layout
 // ================================================================================
 // Styles the three-row layout preview.html.liquid can render: a live demo,
-// a toolbar (language name and copy button), and a code sample. The rows
+// a toolbar (language name and/or copy button), and a code sample. The rows
 // sit flush against each other and the box, with no gaps or padding of
 // their own. The plain, single-row layout (just `content`, no `language`
 // or `code`) uses none of these classes, so none of these rules apply.
@@ -13,20 +13,16 @@
 // another row, so it never doubles up with the box's outer border.
 //
 // Every code block on the site — plain Markdown or built with the
-// preview component — gets the same toolbar/code layout via highlight.js,
-// and the same copy button, handled by copyvalue.js (loaded through
-// copyvalue.html.liquid).
+// preview component — gets the same frame and code row via highlight.js.
+// The toolbar only renders when it has content: a declared language, or a
+// copy button when copyvalue.html.liquid is on. Without a toolbar, the
+// code row sits directly under the demo row or the box's top edge.
 //
 // Long code blocks are capped at 50vh with a scrollbar, so one long
 // sample can't stretch the whole page.
 // ================================================================================
 
 .preview {
-  > .preview-content + .preview-toolbar,
-  > .preview-toolbar + .preview-code {
-    margin-top: $spacer * 0.75;
-  }
-
   .preview-toolbar {
     display: flex;
     flex-wrap: wrap;

data/assets/js/base/backtotop.js

@@ -15,9 +15,9 @@ document.addEventListener('DOMContentLoaded', () => {
   }
 
   const config = {
-    diameter: parseInt(scriptTag.dataset.diameter || '44', 10),
-    backgroundColor: scriptTag.dataset.backgroundColor || '#A14F8C',
-    textColor: scriptTag.dataset.textColor || '#ffffff'
+    diameter: parseInt(scriptTag.dataset.diameter, 10),
+    backgroundColor: scriptTag.dataset.backgroundColor,
+    textColor: scriptTag.dataset.textColor
   }
 
   addBackToTop(config)

data/assets/js/base/copyvalue.js

@@ -3,13 +3,13 @@
 
 (function () {
 class CopyButtonHandler {
-  constructor (button, config = {}) {
+  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.resetDelay = config.resetDelay
+    this.checkmarkPath = config.checkmarkPath
+    this.checkmarkViewbox = config.checkmarkViewbox
+    this.successMessage = config.successMessage
     this.originalIcon = this._captureIcon()
   }
 
@@ -115,13 +115,17 @@ class CopyButtonHandler {
 
 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
+  if (!scriptElement) {
+    console.warn('Copy Value: script tag with id "centos-copyvalue" not found')
+    return
+  }
+
+  const config = {
+    resetDelay: parseInt(scriptElement.dataset.resetDelay, 10),
+    checkmarkPath: scriptElement.dataset.checkmarkPath,
+    checkmarkViewbox: scriptElement.dataset.checkmarkViewbox,
+    successMessage: scriptElement.dataset.successMessage
   }
 
   const handlers = new WeakMap()

data/assets/js/base/datatable.js

@@ -18,15 +18,8 @@ document.addEventListener('DOMContentLoaded', () => {
     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)
-  }
+  const pageLength = parseInt(scriptTag.dataset.pageLength, 10)
+  const lengthMenu = JSON.parse(scriptTag.dataset.lengthMenu)
 
   document.querySelectorAll('table.dataTable').forEach(function (tableEl) {
     const rowCount = tableEl.querySelectorAll('tbody tr').length
@@ -60,10 +53,10 @@ document.addEventListener('DOMContentLoaded', () => {
       lengthMenu: lengthMenu,
       language: {
         paginate: {
-          first: '<i class="fa-solid fa-angles-left" aria-hidden="true"></i>',
-          previous: '<i class="fa-solid fa-chevron-left" aria-hidden="true"></i>',
-          next: '<i class="fa-solid fa-chevron-right" aria-hidden="true"></i>',
-          last: '<i class="fa-solid fa-angles-right" aria-hidden="true"></i>'
+          first: '<i class="fa-solid fa-angles-left fa-sm" aria-hidden="true"></i>',
+          previous: '<i class="fa-solid fa-chevron-left fa-sm" aria-hidden="true"></i>',
+          next: '<i class="fa-solid fa-chevron-right fa-sm" aria-hidden="true"></i>',
+          last: '<i class="fa-solid fa-angles-right fa-sm" aria-hidden="true"></i>'
         }
       },
       // DataTables puts the keyboard-focusable sort trigger on a nested

data/assets/js/base/highlight.js

@@ -1,9 +1,14 @@
-// Colorizes every <pre><code> block, then gives any block not already
-// inside a preview component the same toolbar (language label + copy
-// button) preview.html.liquid renders for its own code row. This way
-// every code sample looks and behaves the same, whether it's a plain
-// fenced Markdown block or built with the preview component. A wrapped
-// block has no demo row, since a plain fenced block has no demo to show.
+// Colorizes every <pre><code> block, then wraps any block not already
+// inside a preview component in the same frame and code row
+// preview.html.liquid renders. This way every code sample looks the same,
+// whether it's a plain fenced Markdown block or built with the preview
+// component. A wrapped block has no demo row, since a plain fenced block
+// has no demo to show.
+//
+// The toolbar above the code row only renders when it has content: a
+// language label when the author declared one, and a copy button when
+// copyvalue.html.liquid loaded its script. Without either, only the
+// framed code block shows.
 
 // Waits for DOMContentLoaded explicitly instead of relying on `defer`:
 // this script tag lives in <head>, and a consumer that inlines the file
@@ -32,6 +37,11 @@ document.addEventListener('DOMContentLoaded', () => {
 
   hljs.highlightAll()
 
+  // copyvalue.html.liquid writes this tag only when copyvalue is on, and a
+  // parsed <script> element is in the DOM before DOMContentLoaded fires,
+  // even though its deferred code may not have run yet.
+  const withCopy = document.getElementById('centos-copyvalue') !== null
+
   document.querySelectorAll('pre code.hljs').forEach(codeEl => {
     const preEl = codeEl.parentElement
     if (!preEl || preEl.closest('.preview-code')) return
@@ -41,32 +51,38 @@ document.addEventListener('DOMContentLoaded', () => {
     const wrapper = document.createElement('div')
     wrapper.className = 'preview mb-3 border rounded overflow-hidden'
 
-    // No border-top: the toolbar is always the first row here (a wrapped
-    // block has no demo row above it), so a top border would double up
-    // against the outer .preview border.
-    const toolbar = document.createElement('div')
-    toolbar.className = 'preview-toolbar m-0 p-2 border-bottom border-centos-purple-100'
-
-    if (language) {
-      const languageEl = document.createElement('span')
-      languageEl.className = 'preview-language small font-monospace text-body-secondary text-uppercase'
-      languageEl.textContent = language
-      toolbar.appendChild(languageEl)
+    let copyBtn = null
+    if (withCopy) {
+      copyBtn = document.createElement('button')
+      copyBtn.setAttribute('type', 'button')
+      copyBtn.className = 'copy-btn focus-ring preview-copy'
+      copyBtn.setAttribute('data-bs-toggle', 'tooltip')
+      copyBtn.setAttribute('data-bs-title', 'Copy code')
+      copyBtn.setAttribute('data-copy-value', codeEl.textContent)
+      copyBtn.setAttribute('aria-label', 'Copy code')
+      copyBtn.innerHTML = '<i class="fa-regular fa-copy"></i>'
     }
 
-    const actions = document.createElement('div')
-    actions.className = 'preview-actions'
+    if (language || copyBtn) {
+      // No border-top: the toolbar is always the first row here (a wrapped
+      // block has no demo row above it), so a top border would double up
+      // against the outer .preview border.
+      const toolbar = document.createElement('div')
+      toolbar.className = 'preview-toolbar m-0 p-2 border-bottom border-centos-purple-100'
 
-    const copyBtn = document.createElement('button')
-    copyBtn.setAttribute('type', 'button')
-    copyBtn.className = 'copy-btn focus-ring preview-copy'
-    copyBtn.setAttribute('data-bs-toggle', 'tooltip')
-    copyBtn.setAttribute('data-bs-title', 'Copy code')
-    copyBtn.setAttribute('data-copy-value', codeEl.textContent)
-    copyBtn.setAttribute('aria-label', 'Copy code')
-    copyBtn.innerHTML = '<i class="fa-regular fa-copy"></i>'
-    actions.appendChild(copyBtn)
-    toolbar.appendChild(actions)
+      if (language) {
+        const languageEl = document.createElement('span')
+        languageEl.className = 'preview-language small font-monospace text-body-secondary text-uppercase'
+        languageEl.textContent = language
+        toolbar.appendChild(languageEl)
+      }
+
+      const actions = document.createElement('div')
+      actions.className = 'preview-actions'
+      if (copyBtn) actions.appendChild(copyBtn)
+      toolbar.appendChild(actions)
+      wrapper.appendChild(toolbar)
+    }
 
     const codeRow = document.createElement('div')
     codeRow.className = 'preview-code p-0 m-0'
@@ -77,14 +93,13 @@ document.addEventListener('DOMContentLoaded', () => {
     preEl.classList.add('p-2')
 
     preEl.replaceWith(wrapper)
-    wrapper.appendChild(toolbar)
     codeRow.appendChild(preEl)
     wrapper.appendChild(codeRow)
 
     // init-tooltips.js already made its one-time pass before this button
     // existed, so its tooltip has to be initialized here instead — the
     // same thing preview.html.liquid's server-rendered copy buttons need.
-    if (typeof bootstrap !== 'undefined' && bootstrap.Tooltip) {
+    if (copyBtn && typeof bootstrap !== 'undefined' && bootstrap.Tooltip) {
       new bootstrap.Tooltip(copyBtn)
     }
   })

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-centos
 version: !ruby/object:Gem::Version
-  version: 2.52.0.beta.104
+  version: 2.52.0.beta.106
 platform: ruby
 authors:
 - Alain Reguera Delgado
@@ -373,6 +373,7 @@ files:
 - _includes/base/social.html.liquid
 - _includes/base/sponsors-cards.html.liquid
 - _includes/base/sponsors-carousel.html.liquid
+- _includes/base/sponsors-data.html.liquid
 - _includes/base/title.html.liquid
 - _includes/base/toc-generator.html.liquid
 - _includes/base/toc.html.liquid