jekyll-theme-centos 2.52.0.beta.94 → 2.52.0.beta.95

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1ddd48e40839e62993220986497939549cbacca43c0c8a26020996e3520a3e6
-  data.tar.gz: dccc3f654ba6ef736e52803738dd01eb9846024e37c09e16c52ed916ad83a59b
+  metadata.gz: 514d7cf7b23b5a2233b00dd34553cc9be81540fafc2fef9a3e3bdcd223355140
+  data.tar.gz: 11d9d4be1415ddf484b5f1c590fab9a79fb26d24a77e49724f93649d6680444f
 SHA512:
-  metadata.gz: 15fe51e10c40b2e264a5008e0a315d7bb79180718dd6632416ae090adeb5fe71131abed39ba5416198eaced8978f9091e8accc731c0cf115b6fadc87dc265f09
-  data.tar.gz: 67b10667ff2b8831b4fbe115f2388f496f7a8b4295d5aabdb75f7ec437143c7396afefa9b322850fcacec2eb8529cde40dbd3111acddc9207748dc53b90ab064
+  metadata.gz: ea8fca5a2626aaab45cef3f673115e3a4260f6ff5b9d31e9b436b5bb304413d879df61e586316fb2ff38bf58ceba27c6e99bdd89412b38f17a42f6d4b9cde8bd
+  data.tar.gz: c8f7a9cfc0ea451c92192656de898a3c2add1219a4ffa08eb4758520b48bbdc59ffe4ce82ed506d46fce7961228d407384524405e7798ee88873b50c4a2253c1

data/_data/base/accordion_schema.yml

@@ -0,0 +1,100 @@
+title: Accordion Component Configuration
+description: >-
+  Schema for configuring a Bootstrap accordion. `accordion.html.liquid`
+  renders the wrapper `<div class="accordion" id="...">`, given a
+  pre-rendered HTML string of one or more accordion-item includes built by
+  the caller. `accordion-item.html.liquid` renders one accordion-item
+  (header/button/collapse/body); its own defaults live under `item`, below.
+  All parameters are passed directly as include parameters when calling
+  either component.
+type: object
+properties:
+  id:
+    type: string
+    default: ""
+    description: >-
+      The wrapper's DOM id, referenced by every child accordion-item's
+      `data-bs-parent` scoping. This field is required.
+  class:
+    type: string
+    default: ""
+    description: >-
+      CSS classes applied to the wrapper `<div class="accordion ...">`
+      (e.g., `accordion-flush mt-3`, `w-100 mb-3`).
+  items:
+    type: string
+    default: ""
+    description: >-
+      Pre-rendered HTML string containing one or more `accordion-item`
+      includes, built by the caller via a `capture` tag (looping and
+      appending one accordion-item render per iteration, or capturing
+      several sibling includes together). This field is required.
+  item:
+    type: object
+    description: >-
+      Per-item defaults, used by accordion-item.html.liquid. Each accordion
+      item is rendered by its own include call — this component never
+      loops over structured item data itself.
+    properties:
+      icon:
+        type: string
+        default: ""
+        description: >-
+          Font Awesome icon class shown before the title (e.g., `fa-solid
+          fa-book`). This field is required.
+      title:
+        type: string
+        default: ""
+        description: Accordion button label text. This field is required.
+      title_class:
+        type: string
+        default: "ms-1"
+        description: >-
+          CSS classes applied to the title `<span>`, replacing the default
+          (e.g., `ms-1 fw-bold` for a bold title instead of the
+          regular-weight default).
+      item_id:
+        type: string
+        default: ""
+        description: >-
+          This item's unique collapse id, used for `data-bs-target`/`id`/
+          `aria-controls` wiring. Must be unique across the page. This
+          field is required.
+      accordion_id:
+        type: string
+        default: ""
+        description: >-
+          The parent accordion wrapper's id, used for `data-bs-parent`
+          scoping so this item collapses its siblings correctly. Must match
+          the `id` passed to accordion.html.liquid for the surrounding
+          wrapper. This field is required.
+      expanded:
+        type: boolean
+        default: false
+        description: >-
+          `true` starts this item open (`show` class,
+          `aria-expanded="true"`, button not collapsed); `false` (default)
+          starts it closed.
+      body:
+        type: string
+        default: ""
+        description: >-
+          Pre-rendered HTML string (built via a `capture` tag at the call
+          site) for the accordion-body's contents. This field is required.
+      body_class:
+        type: string
+        default: ""
+        description: >-
+          Extra CSS classes appended to `accordion-body` (e.g., `p-0` to
+          remove body padding when the content supplies its own).
+    required:
+      - icon
+      - title
+      - item_id
+      - accordion_id
+      - body
+    additionalProperties: false
+required:
+  - id
+  - items
+additionalProperties: false

data/_includes/base/accordion-item.html.liquid

@@ -0,0 +1,55 @@
+{% comment %}
+================================================================================
+Template: Accordion Item Component
+Purpose: Renders a single Bootstrap accordion-item (header/button/collapse/
+body), the shared shell for one collapsible entry within an accordion.
+Pairs with accordion.html.liquid, which renders the surrounding wrapper —
+this component only renders one item; callers loop/capture as many as they
+need and pass the concatenated result to accordion.html.liquid as `items`.
+
+Design Logic:
+- Bootstrap's accordion-item/header/button/collapse/body markup, driven
+  entirely by include parameters — no data-source fallback chain
+- `item_id`/`accordion_id` scope this item's collapse behavior to the
+  caller-supplied parent accordion via `data-bs-parent`
+- `expanded` toggles the initial open/closed state across button, collapse
+  container, and ARIA attributes together
+
+Optional Inputs:
+- title_class: Classes for the title span, replacing the "ms-1" default
+  (e.g. "ms-1 fw-bold" for a bold title).
+- body_class: Extra classes appended to "accordion-body" (e.g. "p-0" to
+  remove body padding when the content supplies its own).
+
+Data Source:
+- Derived from include parameters only
+================================================================================
+{% endcomment %}
+
+{%- assign with_accordion_item_schema = site.data.base.accordion_schema.properties.item.properties %}
+
+{%- assign accordion_item_icon         = include.icon         | default: with_accordion_item_schema.icon.default %}
+{%- assign accordion_item_title        = include.title        | default: with_accordion_item_schema.title.default %}
+{%- assign accordion_item_title_class  = include.title_class  | default: with_accordion_item_schema.title_class.default %}
+{%- assign accordion_item_item_id      = include.item_id      | default: with_accordion_item_schema.item_id.default %}
+{%- assign accordion_item_accordion_id = include.accordion_id | default: with_accordion_item_schema.accordion_id.default %}
+{%- assign accordion_item_expanded     = include.expanded     | default: with_accordion_item_schema.expanded.default %}
+{%- assign accordion_item_body         = include.body          | default: with_accordion_item_schema.body.default %}
+{%- assign accordion_item_body_class   = include.body_class    | default: with_accordion_item_schema.body_class.default %}
+
+{%- comment %} === Presentation === {% endcomment %}
+{%- comment %} --- HTML --- {% endcomment -%}
+<div class="accordion-item">
+  <div class="accordion-header h2">
+    <button class="accordion-button{% unless accordion_item_expanded %} collapsed{% endunless %}" type="button" data-bs-toggle="collapse" data-bs-target="#{{ accordion_item_item_id }}" aria-expanded="{{ accordion_item_expanded }}" aria-controls="{{ accordion_item_item_id }}">
+      <i class="{{ accordion_item_icon }} me-2"></i>
+      <span{% unless accordion_item_title_class == blank %} class="{{ accordion_item_title_class }}"{% endunless %}>{{ accordion_item_title }}</span>
+    </button>
+  </div>
+  <div id="{{ accordion_item_item_id }}" class="accordion-collapse collapse{% if accordion_item_expanded %} show{% endif %}" data-bs-parent="#{{ accordion_item_accordion_id }}">
+    <div class="accordion-body{% if accordion_item_body_class != "" %} {{ accordion_item_body_class }}{% endif %}">
+      {{ accordion_item_body }}
+    </div>
+  </div>
+</div>
+{%- comment %} trim trailing output {% endcomment -%}

data/_includes/base/accordion.html.liquid

@@ -0,0 +1,40 @@
+{% comment %}
+================================================================================
+Template: Accordion Wrapper Component
+Purpose: Renders the Bootstrap accordion wrapper `<div class="accordion"
+id="...">`, given a pre-rendered HTML string of one or more accordion-item
+includes. Pairs with accordion-item.html.liquid, which renders each
+individual item — see that file for the item-level markup. Callers build
+`items` via a capture tag: loop-and-append when the item count is dynamic
+(see bits.html.liquid), or capture several sibling accordion-item includes
+together when the items are fixed (see download_sections.html.liquid).
+
+Design Logic:
+- Wrapper only: no looping over structured item data — Jekyll's Liquid
+  include mechanism has no block/yield content-passing, so per-item body
+  content must already be caller-rendered HTML by the time it reaches this
+  component
+- `id` is the scoping anchor every child accordion-item's `accordion_id`
+  parameter must match, via `data-bs-parent`
+
+Optional Inputs:
+- class: Extra classes appended to "accordion" (e.g. "accordion-flush
+  mt-3", "w-100 mb-3").
+
+Data Source:
+- Derived from include parameters only
+================================================================================
+{% endcomment %}
+
+{%- assign with_accordion_schema = site.data.base.accordion_schema.properties %}
+
+{%- assign accordion_id    = include.id    | default: with_accordion_schema.id.default %}
+{%- assign accordion_class = include.class | default: with_accordion_schema.class.default %}
+{%- assign accordion_items = include.items | default: with_accordion_schema.items.default %}
+
+{%- comment %} === Presentation === {% endcomment %}
+{%- comment %} --- HTML --- {% endcomment -%}
+<div class="accordion{% if accordion_class != "" %} {{ accordion_class }}{% endif %}" id="{{ accordion_id }}">
+{{- accordion_items -}}
+</div>
+{%- comment %} trim trailing output {% endcomment -%}

data/_includes/base/bits.html.liquid

@@ -167,20 +167,37 @@ Data Source Hierarchy (priority order):
         {%- endcapture %}
 
         {%- capture downstream_bit_media %}
+          {% if downstream_bit.screenshot and downstream_bit.screenshot != "" %}
           <div class="bg-{{ upstream_bit_color }} rounded-top">
             <img src="{{ site.baseurl }}/assets/img/{{ downstream_bit.screenshot }}" class="{{ downstream_item_img_class }}" alt="{{ downstream_bit.screenshot }}">
           </div>
+          {% endif %}
         {%- endcapture %}
 
         {%- if upstream_bit_downstream_style == "accordion" %}
           {%- assign downstream_bit_id = downstream_bit.name | replace: " ", "" | capitalize %}
           {%- assign downstream_item_id = downstream_accordion_id | append: "-" | append: downstream_bit_id %}
+          {%- capture downstream_bit_actions_full %}
+            {%- if downstream_bit.actions.size > 0 %}
+            <div class="{{ upstream_bit_actions_class }}">
+              {%- for downstream_bit_action in downstream_bit.actions %}
+                {%- include base/link.html.liquid
+                name          = downstream_bit_action.name
+                link          = downstream_bit_action.link
+                class         = upstream_bit_btn_class
+                icon          = downstream_bit_action.icon
+                icon_position = downstream_bit_action.icon_position
+                -%}
+              {%- endfor %}
+            </div>
+            {%- endif %}
+          {%- endcapture %}
           {%- capture downstream_bit_body %}
             {{- downstream_bit_media | strip -}}
             <p class="card-text mt-3">{{ downstream_bit.description }}</p>
-            {{ downstream_bit_action_button }}
+            {{ downstream_bit_actions_full }}
           {%- endcapture %}
-          {%- include base/accordion_item.html.liquid
+          {%- include base/accordion-item.html.liquid
           icon          = downstream_bit.icon
           title         = downstream_bit.name
           item_id       = downstream_item_id
@@ -205,7 +222,7 @@ Data Source Hierarchy (priority order):
     {%- endcapture %}
 
     {%- if upstream_bit_downstream_style == "accordion" %}
-      <div class="accordion w-100 mb-3" id="{{ downstream_accordion_id }}">{{- downstream_items_html -}}</div>
+      {%- include base/accordion.html.liquid id=downstream_accordion_id class="w-100 mb-3" items=downstream_items_html -%}
     {%- else %}
       <div class="row w-100 mb-3 g-2">{{- downstream_items_html -}}</div>
     {%- endif %}

data/_includes/base/color-table.html.liquid

@@ -1,3 +1,4 @@
+<div class="table-responsive bg-light border rounded mb-3">
 <table class="table dataTable">
   <thead>
     <tr>
@@ -34,3 +35,4 @@
 {%- endfor %}
   </tbody>
 </table>
+</div>

data/_includes/base/download_commands.html.liquid

@@ -24,4 +24,4 @@ Required Inputs:
     {%- endif %}
   {%- endfor %}
 {%- endcapture -%}
-{%- include base/accordion_item.html.liquid icon="fa-solid fa-terminal" title="Migration" item_id=include.item_id accordion_id=include.accordion_id expanded=include.expanded body=download_commands_body -%}
+{%- include base/accordion-item.html.liquid icon="fa-solid fa-terminal" title="Migration" item_id=include.item_id accordion_id=include.accordion_id expanded=include.expanded body=download_commands_body -%}

data/_includes/base/download_documentation.html.liquid

@@ -55,4 +55,4 @@ kinds doesn't end up with paragraphs breaking up a button row.
   {%- if download_documentation_prose_stripped != "" %}{{ download_documentation_prose }}{%- endif %}
   {%- if download_documentation_buttons_stripped != "" %}<div class="d-flex flex-wrap gap-2">{{ download_documentation_buttons }}</div>{%- endif %}
 {%- endcapture -%}
-{%- include base/accordion_item.html.liquid icon="fa-solid fa-book" title="Documentation" item_id=include.item_id accordion_id=include.accordion_id expanded=include.expanded body=download_documentation_body -%}
+{%- include base/accordion-item.html.liquid icon="fa-solid fa-book" title="Documentation" item_id=include.item_id accordion_id=include.accordion_id expanded=include.expanded body=download_documentation_body -%}

data/_includes/base/download_eol.html.liquid

@@ -26,4 +26,4 @@ Required Inputs:
     {%- endfor %}
   </ul>
 {%- endcapture -%}
-{%- include base/accordion_item.html.liquid icon="fa-solid fa-hourglass-end" title="End-of-life" item_id=include.item_id accordion_id=include.accordion_id expanded=include.expanded body=download_eol_body -%}
+{%- include base/accordion-item.html.liquid icon="fa-solid fa-hourglass-end" title="End-of-life" item_id=include.item_id accordion_id=include.accordion_id expanded=include.expanded body=download_eol_body -%}

data/_includes/base/download_screenshots.html.liquid

@@ -108,4 +108,4 @@ row too.
     </div>
   </div>
 {%- endcapture -%}
-{%- include base/accordion_item.html.liquid icon="fa-solid fa-desktop" title="Screenshots" item_id=include.item_id accordion_id=include.accordion_id expanded=include.expanded body_class="p-0" body=download_screenshots_body -%}
+{%- include base/accordion-item.html.liquid icon="fa-solid fa-desktop" title="Screenshots" item_id=include.item_id accordion_id=include.accordion_id expanded=include.expanded body_class="p-0" body=download_screenshots_body -%}

data/_includes/base/download_sections.html.liquid

@@ -31,7 +31,7 @@ Required Inputs:
 {%- assign meta_eol_id = meta_accordion_id | append: "-eol" %}
 
 {%- if include.release_data.documentation.size > 0 or include.release_data.commands.size > 0 or include.release_data.eol.size > 0 or include.release_data.screenshots.size > 0 %}
-<div class="accordion accordion-flush mt-3" id="{{ meta_accordion_id }}">
+  {%- capture meta_accordion_items %}
   {%- if include.release_data.screenshots.size > 0 %}
     {%- include base/download_screenshots.html.liquid screenshots=include.release_data.screenshots image_base_path=include.image_base_path release_id=include.release_id accordion_id=meta_accordion_id item_id=meta_screenshots_id expanded=false -%}
   {%- endif %}
@@ -47,5 +47,6 @@ Required Inputs:
   {%- if include.release_data.eol.size > 0 %}
     {%- include base/download_eol.html.liquid eol=include.release_data.eol accordion_id=meta_accordion_id item_id=meta_eol_id expanded=false -%}
   {%- endif %}
-</div>
+  {%- endcapture %}
+  {%- include base/accordion.html.liquid id=meta_accordion_id class="accordion-flush mt-3" items=meta_accordion_items -%}
 {%- endif %}

data/_includes/base/navindex.html.liquid

@@ -130,6 +130,7 @@ Data Object Properties:
 
 {% capture table %}
 {% assign show_page_filename = include.show_page_filename | default: "false" %}
+<div class="table-responsive bg-light border rounded mb-3">
 <table class="table dataTable">
   <thead>
     <tr>
@@ -148,14 +149,16 @@ Data Object Properties:
             <td>{% include base/link.html.liquid name=item.title link=item.url %}</td>
           {%- endif %}
         {%- endif %}
-        <td>{{ item.title_lead | strip_newlines | markdownify }}</td>
+        <td>{{ item.title_lead | strip_newlines | markdownify | remove: "<p>" | remove: "</p>" | strip }}</td>
       </tr>
     {%- endfor %}
   </tbody>
 </table>
+</div>
 {%- endcapture %}
 
 {% capture component_table %}
+<div class="table-responsive bg-light border rounded mb-3">
 <table class="table dataTable">
   <thead>
     <tr>
@@ -181,11 +184,12 @@ Data Object Properties:
       <tr>
         <td>{% include base/link.html.liquid name=item.component.name link=item.url %}</td>
         <td class="text-nowrap">{{ status_icon }}</td>
-        <td>{{ item.title_lead | strip_newlines | markdownify }}</td>
+        <td>{{ item.title_lead | strip_newlines | markdownify | remove: "<p>" | remove: "</p>" | strip }}</td>
       </tr>
     {%- endfor %}
   </tbody>
 </table>
+</div>
 {% endcapture %}
 
 {% case format %}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-centos
 version: !ruby/object:Gem::Version
-  version: 2.52.0.beta.94
+  version: 2.52.0.beta.95
 platform: ruby
 authors:
 - Alain Reguera Delgado
@@ -280,6 +280,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - _config.yml
+- _data/base/accordion_schema.yml
 - _data/base/announcement_schema.yml
 - _data/base/artwork_schema.yml
 - _data/base/backtotop_schema.yml
@@ -326,7 +327,8 @@ files:
 - _data/base/sponsors_schema.yml
 - _data/base/title_schema.yml
 - _data/base/toc_schema.yml
-- _includes/base/accordion_item.html.liquid
+- _includes/base/accordion-item.html.liquid
+- _includes/base/accordion.html.liquid
 - _includes/base/announcement.html.liquid
 - _includes/base/artwork.html.liquid
 - _includes/base/backtotop.html.liquid

data/_includes/base/accordion_item.html.liquid

@@ -1,40 +0,0 @@
-{% comment %}
-================================================================================
-Utility: Accordion Item
-Purpose: The Bootstrap accordion-item/header/button/collapse/body shell,
-shared across components. Used by the four sibling sections below a
-release's architecture grid (Screenshots, Documentation, Migration,
-End-of-life — see download_sections.html.liquid for how these compose into
-one shared accordion) and by the bits component's accordion downstream
-style (see bits.html.liquid). Body content is built by the caller via a
-capture tag and passed in as a pre-rendered HTML string, since Jekyll's
-Liquid include mechanism has no block/yield content-passing.
-
-Required Inputs:
-- icon:         Font Awesome icon class shown before the title.
-- title:        Accordion button label text.
-- item_id:      This item's unique collapse id.
-- accordion_id: Parent accordion's id, for data-bs-parent scoping.
-- expanded:     true starts this item open; false starts it closed.
-- body:         Pre-rendered HTML string (built via a capture tag at the
-                call site) for the accordion-body's contents.
-
-Optional Inputs:
-- body_class: Extra classes appended to "accordion-body" (e.g.
-              "d-flex flex-wrap gap-2", "p-0"). Omit for a plain
-              accordion-body.
-================================================================================
-{% endcomment %}
-<div class="accordion-item">
-  <div class="accordion-header h2">
-    <button class="accordion-button{% unless include.expanded %} collapsed{% endunless %}" type="button" data-bs-toggle="collapse" data-bs-target="#{{ include.item_id }}" aria-expanded="{{ include.expanded }}" aria-controls="{{ include.item_id }}">
-      <i class="{{ include.icon }} me-2"></i>
-      <span class="ms-1 fw-bold">{{ include.title }}</span>
-    </button>
-  </div>
-  <div id="{{ include.item_id }}" class="accordion-collapse collapse{% if include.expanded %} show{% endif %}" data-bs-parent="#{{ include.accordion_id }}">
-    <div class="accordion-body{% if include.body_class and include.body_class != "" %} {{ include.body_class }}{% endif %}">
-      {{ include.body }}
-    </div>
-  </div>
-</div>