jekyll-theme-centos 2.52.0.beta.4 → 2.52.0.beta.6

data/_data/download/cards.yml

@@ -0,0 +1,309 @@
+---
+#
+# site.data.download.cards - This file controls the information related to
+# downloadable items.
+#
+
+- title: "CentOS Stream"
+  description: |
+    Continuously delivered distro that tracks just ahead of Red Hat Enterprise
+    Linux (RHEL) development, positioned as a midstream between Fedora Linux
+    and RHEL. For anyone interested in participating and collaborating in the
+    RHEL ecosystem, CentOS Stream is your reliable platform for innovation.
+  releases:
+    9:
+      screenshots:
+        - src: "distribution-release-screenshot-1.png"
+          alt: "distribution-release-screenshot-1.png"
+        - src: "distribution-release-screenshot-2.png"
+          alt: "distribution-release-screenshot-2.png"
+        - src: "distribution-release-screenshot-3.png"
+          alt: "distribution-release-screenshot-3.png"
+      mirrors:
+        - architecture: "x86_64"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/x86_64/iso/CentOS-Stream-9-latest-x86_64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/x86_64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "ARM64 (aarch64)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/aarch64/iso/CentOS-Stream-9-latest-aarch64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/aarch64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Power (ppc64le)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/ppc64le/iso/CentOS-Stream-9-latest-ppc64le-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/ppc64le/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Z (s390x)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/s390x/iso/CentOS-Stream-9-latest-s390x-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/s390x/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+      documentation:
+        - title: Release Notes
+          link: "https://blog.centos.org/2021/12/introducing-centos-stream-9/"
+        - title: Release Email
+          link: "https://lists.centos.org/pipermail/centos-announce/2021-December/060971.html"
+        - title: Website
+          link: "https://docs.centos.org/en-US/docs/"
+      eol:
+        - title: ""
+          description: |
+            End of RHEL9 <a href="https://access.redhat.com/support/policy/updates/errata#Full_Support_Phase">full support</a> phase.
+    8:
+      screenshots:
+        - src: "distribution-release-screenshot-1.png"
+          alt: "distribution-release-screenshot-1.png"
+        - src: "distribution-release-screenshot-2.png"
+          alt: "distribution-release-screenshot-2.png"
+        - src: "distribution-release-screenshot-3.png"
+          alt: "distribution-release-screenshot-3.png"
+      mirrors:
+        - architecture: "x86_64"
+          iso: "http://isoredirect.centos.org/centos/8-stream/isos/x86_64/"
+          rpm: "http://mirror.centos.org/centos/8-stream/"
+          cloud: "https://cloud.centos.org/centos/8-stream/x86_64/images/"
+          containers: "https://quay.io/centos/centos:stream8"
+          vagrant: ""
+        - architecture: "ARM64 (aarch64)"
+          iso: "http://isoredirect.centos.org/centos/8-stream/isos/aarch64/"
+          rpm: "http://mirror.centos.org/centos/8-stream/"
+          cloud: "https://cloud.centos.org/centos/8-stream/aarch64/images/"
+          containers: "https://quay.io/centos/centos:stream8"
+          vagrant: ""
+        - architecture: "IBM Power (ppc64le)"
+          iso: "http://isoredirect.centos.org/centos/8-stream/isos/ppc64le/"
+          rpm: "http://mirror.centos.org/centos/8-stream/"
+          cloud: "https://cloud.centos.org/centos/8-stream/ppc64le/images/"
+          containers: "https://quay.io/centos/centos:stream8"
+          vagrant: ""
+      documentation:
+        - title: Release Notes
+          link: "https://wiki.centos.org/Manuals/ReleaseNotes/CentOSStream"
+        - title: Release Email
+          link: "https://lists.centos.org/pipermail/centos-announce/2019-September/023449.html"
+        - title: Webiste
+          link: "https://docs.centos.org/"
+      eol:
+        - title: "31 May 2024"
+          description: ""
+      commands:
+        - title: "Converting from CentOS Linux 8 to CentOS Stream 8"
+          lines: |-
+            dnf --disablerepo '*' --enablerepo extras swap centos-linux-repos centos-stream-repos
+            dnf distro-sync
+
+- title: "Fictitious Stream Distribution 1"
+  releases:
+    v0.1:
+      screenshots:
+        - src: "distribution-release-screenshot-1.png"
+          alt: "distribution-release-screenshot-1.png"
+        - src: "distribution-release-screenshot-2.png"
+          alt: "distribution-release-screenshot-2.png"
+        - src: "distribution-release-screenshot-3.png"
+          alt: "distribution-release-screenshot-3.png"
+      mirrors:
+        - architecture: "x86_64"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/x86_64/iso/CentOS-Stream-9-latest-x86_64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/x86_64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "ARM64 (aarch64)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/aarch64/iso/CentOS-Stream-9-latest-aarch64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/aarch64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Power (ppc64le)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/ppc64le/iso/CentOS-Stream-9-latest-ppc64le-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/ppc64le/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Z (s390x)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/s390x/iso/CentOS-Stream-9-latest-s390x-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/s390x/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+      documentation:
+        - title: Release Notes
+          link: "https://blog.centos.org/2021/12/introducing-centos-stream-9/"
+        - title: Release Email
+          link: "https://lists.centos.org/pipermail/centos-announce/2021-December/060971.html"
+        - title: Website
+          link: "https://docs.centos.org/en-US/docs/"
+      eol:
+        - title: "31 May 2024"
+          description: |
+            He was soon borne away by the waves, and lost in darkness and
+            distance. -- Frankenstein; or, The Modern Prometheus, by Mary
+            Shelley (1818)
+      commands:
+        - title: "Converting from CentOS Linux 8 to CentOS Stream 8"
+          lines: |-
+            dnf --disablerepo '*' --enablerepo extras swap centos-linux-repos centos-stream-repos
+            dnf distro-sync
+    v0.2:
+      screenshots:
+        - src: "distribution-release-screenshot-1.png"
+          alt: "distribution-release-screenshot-1.png"
+        - src: "distribution-release-screenshot-2.png"
+          alt: "distribution-release-screenshot-2.png"
+        - src: "distribution-release-screenshot-3.png"
+          alt: "distribution-release-screenshot-3.png"
+      mirrors:
+        - architecture: "x86_64"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/x86_64/iso/CentOS-Stream-9-latest-x86_64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/x86_64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "ARM64 (aarch64)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/aarch64/iso/CentOS-Stream-9-latest-aarch64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/aarch64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Power (ppc64le)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/ppc64le/iso/CentOS-Stream-9-latest-ppc64le-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/ppc64le/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Z (s390x)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/s390x/iso/CentOS-Stream-9-latest-s390x-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/s390x/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+      documentation:
+        - title: Release Notes
+          link: "https://blog.centos.org/2021/12/introducing-centos-stream-9/"
+        - title: Release Email
+          link: "https://lists.centos.org/pipermail/centos-announce/2021-December/060971.html"
+        - title: Website
+          link: "https://docs.centos.org/en-US/docs/"
+      eol:
+        - title: "31 May 2024"
+          description: |
+            I got to light out for the territory ahead of the rest, because
+            Aunt Sally she’s going to adopt me and sivilize me, and I can’t
+            stand it. I been there before. -- Adventures of Huckleberry Finn,”
+            by Mark Twain (1884)
+      commands:
+        - title: "Converting from CentOS Linux 8 to CentOS Stream 8"
+          lines: |-
+            dnf --disablerepo '*' --enablerepo extras swap centos-linux-repos centos-stream-repos
+            dnf distro-sync
+
+- title: "Fictitious Stream Distribution 2"
+  releases:
+    v0.1:
+      screenshots:
+        - src: "distribution-release-screenshot-1.png"
+          alt: "distribution-release-screenshot-1.png"
+        - src: "distribution-release-screenshot-2.png"
+          alt: "distribution-release-screenshot-2.png"
+        - src: "distribution-release-screenshot-3.png"
+          alt: "distribution-release-screenshot-3.png"
+      mirrors:
+        - architecture: "x86_64"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/x86_64/iso/CentOS-Stream-9-latest-x86_64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/x86_64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "ARM64 (aarch64)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/aarch64/iso/CentOS-Stream-9-latest-aarch64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/aarch64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Power (ppc64le)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/ppc64le/iso/CentOS-Stream-9-latest-ppc64le-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/ppc64le/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Z (s390x)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/s390x/iso/CentOS-Stream-9-latest-s390x-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/s390x/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+      documentation:
+        - title: Release Notes
+          link: "https://blog.centos.org/2021/12/introducing-centos-stream-9/"
+        - title: Release Email
+          link: "https://lists.centos.org/pipermail/centos-announce/2021-December/060971.html"
+        - title: Website
+          link: "https://docs.centos.org/en-US/docs/"
+      eol:
+        - title: "31 May 2024"
+          description: |
+            Reader, I did not even have coffee with him. That much I learned in
+            college. -- A Gate at the Stairs, by Lorrie Moore (2009)
+      commands:
+        - title: "Converting from CentOS Linux 8 to CentOS Stream 8"
+          lines: |-
+            dnf --disablerepo '*' --enablerepo extras swap centos-linux-repos centos-stream-repos
+            dnf distro-sync
+    v0.2:
+      screenshots:
+        - src: "distribution-release-screenshot-1.png"
+          alt: "distribution-release-screenshot-1.png"
+        - src: "distribution-release-screenshot-2.png"
+          alt: "distribution-release-screenshot-2.png"
+        - src: "distribution-release-screenshot-3.png"
+          alt: "distribution-release-screenshot-3.png"
+      mirrors:
+        - architecture: "x86_64"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/x86_64/iso/CentOS-Stream-9-latest-x86_64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/x86_64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "ARM64 (aarch64)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/aarch64/iso/CentOS-Stream-9-latest-aarch64-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/aarch64/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Power (ppc64le)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/ppc64le/iso/CentOS-Stream-9-latest-ppc64le-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/ppc64le/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+        - architecture: "IBM Z (s390x)"
+          iso: "https://mirrors.centos.org/mirrorlist?path=/9-stream/BaseOS/s390x/iso/CentOS-Stream-9-latest-s390x-dvd1.iso&redirect=1&protocol=https"
+          rpm: "http://mirror.stream.centos.org/9-stream/"
+          cloud: "https://cloud.centos.org/centos/9-stream/s390x/images"
+          containers: "https://quay.io/centos/centos:stream9"
+          vagrant: ""
+      documentation:
+        - title: Release Notes
+          link: "https://blog.centos.org/2021/12/introducing-centos-stream-9/"
+        - title: Release Email
+          link: "https://lists.centos.org/pipermail/centos-announce/2021-December/060971.html"
+        - title: Website
+          link: "https://docs.centos.org/en-US/docs/"
+      eol:
+        - title: "31 May 2024"
+          description: |
+            It's funny. Don't ever tell anybody anything. If you do, you start
+            missing everybody. -- "The Catcher in the Rye," by J.D. Salinger
+            (1951)
+      commands:
+        - title: "Converting from CentOS Linux 8 to CentOS Stream 8"
+          lines: |-
+            dnf --disablerepo '*' --enablerepo extras swap centos-linux-repos centos-stream-repos
+            dnf distro-sync

data/_data/download/navbar.yml

@@ -0,0 +1,11 @@
+---
+- name: "Documentation"
+  icon: "fa-solid fa-book"
+  link: "/documentation"
+  menu: []
+  visible_on: ["navbar"]
+- name: "Examples"
+  icon: "fa-solid fa-flask-vial"
+  link: "/examples"
+  menu: []
+  visible_on: ["navbar"]

data/_data/sponsors/carousel.yml

@@ -0,0 +1,37 @@
+---
+title: Sponsors
+icon: "fa-solid fa-hand-holding-heart"
+message: |
+  CentOS would not be possible without the support of our sponsors. We would
+  like to thank the following product/service for being a CentOS sponsor. If
+  you value our work, please consider <a href="/sponsors">becoming a sponsor!</a>
+members:
+  - name: sponsor-logo-1
+    country: usa
+    image: sponsor-logo-1.png
+    url: "#"
+  - name: sponsor-logo-2
+    country: usa
+    image: sponsor-logo-2.png
+    url: "#"
+  - name: sponsor-logo-3
+    country: usa
+    image: sponsor-logo-3.png
+    url: "#"
+  - name: sponsor-logo-4
+    country: usa
+    image: sponsor-logo-4.png
+    url: "#"
+  - name: sponsor-logo-5
+    country: usa
+    image: sponsor-logo-5.png
+    url: "#"
+  - name: sponsor-logo-6
+    country: usa
+    image: sponsor-logo-6.png
+    url: "#"
+  - name: sponsor-logo-7
+    country: usa
+    image: sponsor-logo-7.png
+    url: "#"
+    is_active: false

data/_data/sponsors/navbar.yml

@@ -0,0 +1,6 @@
+---
+- name: "Documentation"
+  icon: "fa-solid fa-book"
+  link: "/documentation"
+  menu: []
+  visible_on: ["navbar"]

data/_includes/base/announcement.html.liquid

@@ -0,0 +1,51 @@
+{%- comment %}
+================================================================================
+Template: Announcement Component
+Purpose: Renders dismissible alert boxes with icon and content.
+================================================================================
+
+Design Logic:
+- Multi-level data source hierarchy for flexibility
+- Dismissible alerts for user visibility management
+- Icon and color support for visual categorization
+- Looping structure for multiple announcements
+- Consistent fallback chain for content
+
+Required Inputs:
+- content: The announcement message or HTML content
+
+Optional Inputs:
+- data: Array of announcement objects (overrides fallbacks)
+- color: Alert color scheme (default: 'primary')
+- icon: Icon class for Font Awesome (default: 'fa-solid fa-bullhorn')
+
+Data Source Hierarchy (priority):
+1. include.data
+2. page.with_announcement_data
+3. site.data.announcement
+4. site.data.base.announcement
+================================================================================
+{%- endcomment %}
+
+{%- assign announcements = include.data | default: page.with_announcement_data | default: site.data.announcement | default: site.data.base.announcement %}
+
+{%- comment %} === Presentation === {% endcomment %}
+{%- for announcement in announcements %}
+
+{%- comment %} --- Defaults --- {% endcomment %}
+{%- assign announcement_color = announcement.color | default: "primary" %}
+{%- assign announcement_icon  = announcement.icon  | default: "fa-solid fa-bullhorn" %}
+
+{%- comment %} --- HTML --- {% endcomment %}
+<div class="announcement alert alert-{{ announcement_color }} alert-dismissible fade show shadow mb-3" role="alert">
+  <div class="d-flex justify-content-between align-items-start">
+    <div class="me-3">
+      <div class="h6 my-1"><i class="{{ announcement_icon }}"></i></div>
+    </div>
+    <div class="flex-fill text-start">
+      {{- announcement.content }}
+    </div>
+  </div>
+  <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
+</div>
+{%- endfor %}

data/_includes/base/artwork.html.liquid

@@ -0,0 +1,49 @@
+{% comment %}
+================================================================================
+Template: Artwork Component
+Purpose: Renders responsive images with intelligent URL resolution.
+Supports external URLs (http/https) and local asset paths.
+================================================================================
+
+Design Logic:
+- Smart URL resolution: detects external vs internal URLs
+- External URLs (http/https) rendered as-is
+- Internal paths prefixed with site.baseurl
+- Schema-based defaults for consistent styling
+- Alt text support for accessibility
+
+Required Inputs:
+- image: Image filename or full URL
+
+Optional Inputs:
+- alt: Alt text for accessibility
+- class: Container div CSS classes
+- image_class: Image element CSS classes
+- data: Artwork data object (overrides fallbacks)
+
+Data Source Hierarchy (priority):
+1. include.data
+2. page.with_artwork_data
+3. site.data.artwork
+4. site.data.base.artwork
+================================================================================
+{% endcomment %}
+
+{%- assign artwork = include.data | default: page.with_artwork_data | default: site.data.artwork | default: site.data.base.artwork %}
+
+{%- comment %} === Presentation === {% endcomment %}
+
+{%- comment %} --- Defaults --- {% endcomment %}
+{%- assign artwork_image       = artwork.image | default: site.data.base.artwork_schema.properties.with_artwork_data.properties.image.default %}
+{%- assign artwork_alt         = artwork.alt   | default: site.data.base.artwork_schema.properties.with_artwork_data.properties.alt.default %}
+{%- assign artwork_class       = artwork.class | default: site.data.base.artwork_schema.properties.with_artwork_data.properties.class.default %}
+{%- assign artwork_image_class = artwork.image_class | default: site.data.base.artwork_schema.properties.with_artwork_data.properties.image_class.default %}
+
+{%- comment %} --- HTML --- {% endcomment %}
+<div class="{{ artwork_class }}">
+  {% if artwork_image contains "https://" or artwork_image contains "http://" %}
+    <img src="{{ artwork_image }}" class="{{ artwork_image_class }}" alt="{{ artwork_alt }}" />
+  {% else %}
+    <img src="{{ site.baseurl }}{{ artwork_image }}" class="{{ artwork_image_class }}" alt="{{ artwork_alt }}" />
+  {% endif %}
+</div>

data/_includes/base/backtotop.html.liquid

@@ -0,0 +1,51 @@
+{% comment %}
+================================================================================
+Template: Back-to-Top Button Component
+Purpose: Loads vanilla-back-to-top library for floating scroll-to-top button.
+Customizable size and colors with CDN-based loading.
+================================================================================
+
+Design Logic:
+- CDN-based library loading for performance
+- Configurable button size (diameter) and colors
+- Floating button widget (standard UX pattern)
+- Vanilla JavaScript (no jQuery dependency)
+- Schema-based defaults
+
+Optional Inputs:
+- cdn: CDN base URL (defaults to unpkg.com)
+- version: Library version (e.g., "7.0.4")
+- diameter: Button diameter in pixels (default: 56)
+- background_color: Button background color (CSS hex)
+- text_color: Button text/icon color (CSS hex)
+- data: Configuration object (overrides fallbacks)
+
+Data Source Hierarchy (priority):
+1. include.data
+2. page.with_backtotop_data
+3. site.data.backtotop
+4. site.data.base.backtotop
+================================================================================
+{% endcomment %}
+
+{%- assign backtotop = include.data | default: page.with_backtotop_data | default: site.data.backtotop | default: site.data.base.backtotop %}
+
+{%- comment %} === Presentation === {% endcomment %}
+
+{%- comment %} --- Defaults --- {% endcomment %}
+{%- assign backtotop_cdn              = backtotop.cdn              | default: site.data.base.backtotop_schema.properties.with_backtotop_data.properties.cdn.default %}
+{%- assign backtotop_version          = backtotop.version          | default: site.data.base.backtotop_schema.properties.with_backtotop_data.properties.version.default %}
+{%- assign backtotop_diameter         = backtotop.diameter         | default: site.data.base.backtotop_schema.properties.with_backtotop_data.properties.diameter.default %}
+{%- assign backtotop_background_color = backtotop.background_color | default: site.data.base.backtotop_schema.properties.with_backtotop_data.properties.background_color.default %}
+{%- assign backtotop_text_color       = backtotop.text_color       | default: site.data.base.backtotop_schema.properties.with_backtotop_data.properties.text_color.default %}
+
+{%- comment %} --- HTML --- {% endcomment %}
+<!-- Load vanilla-back-to-top library from CDN -->
+<script src="{{ backtotop_cdn }}/vanilla-back-to-top@{{ backtotop_version }}/dist/vanilla-back-to-top.min.js"></script>
+
+<!-- Initialize back-to-top button with configuration via data attributes -->
+<script id="centos-backtop"
+        data-diameter="{{ backtotop_diameter }}"
+        data-background-color="{{ backtotop_background_color }}"
+        data-text-color="{{ backtotop_text_color }}"
+        src="{{ site.baseurl }}/assets/js/base/backtotop.min.js"></script>

data/_includes/base/bits.html.liquid

@@ -0,0 +1,135 @@
+{% comment %}
+================================================================================
+Template: Bits Component (Upstream/Downstream Relationships)
+Purpose: Renders hierarchical relationships between upstream and downstream
+components. Displays upstream with preamble, card, finale, and up to 3 preview
+cards of related downstream items.
+================================================================================
+
+Strategic Design Logic:
+- Hierarchical relationships: upstream parent, downstream children
+- Card-based presentation: reuses card component for consistency
+- Filtered display: shows max 3 downstream preview cards
+- Optional sections: preamble, finale, "View All" link
+- Relationship linking: downstream filtered by upstream name
+- Customizable styling: per-element class overrides
+
+Required Inputs (from data objects):
+- type: 'upstream' or 'downstream' (required)
+- name: Component name (required)
+- relationship: For downstream, name of upstream parent
+
+Optional Inputs (from data objects):
+- description, screenshot, icon, image, actions, color
+- preamble, finale: Text before/after card
+- class, card_class, preamble_class, finale_class: Custom styling
+- index_page_name, index_page_url: For "View All" link (shows if >3 items)
+
+Data Source Hierarchy (in priority order):
+1. include.data - Explicitly passed array
+2. page.with_bits_data - Page front matter
+3. site.data.bits - Site data
+4. site.data.base.bits - Theme defaults
+
+Component Layout:
+- Outer loop: upstream bits (type='upstream')
+- Preamble text (if present)
+- Card component for upstream
+- Finale section with optional "View All" link (if >3 downstream)
+- Downstream preview grid (max 3 items, filtered by relationship)
+================================================================================
+{% endcomment %}
+
+{%- assign bits = include.data | default: page.with_bits_data | default: site.data.bits | default: site.data.base.bits %}
+
+{%- comment %} === Presentation === {% endcomment %}
+{%- assign upstream_bits = bits | where: "type", "upstream" %}
+{%- for upstream_bit in upstream_bits %}
+
+  {%- comment %} --- Upstream Defaults --- {% endcomment %}
+  {%- assign upstream_bit_id                    = upstream_bit.name            | replace: " ", "" | capitalize %}
+  {%- assign upstream_bit_class                 = upstream_bit.class           | default: "bg-primary bg-opacity-10 border border-primary-subtle mb-3 p-5 align-items-center text-center rounded" %}
+  {%- assign upstream_bit_card_class            = upstream_bit.card_class      | default: "flex-column align-items-center text-center mb-3" %}
+  {%- assign upstream_bit_preamble_class        = upstream_bit.preamble_class  | default: "mb-3" %}
+  {%- assign upstream_bit_finale_class          = upstream_bit_finale_class    | default: "" %}
+  {%- assign upstream_bit_color                 = upstream_bit.color           | default: "primary" %}
+  {%- assign upstream_bit_index_page_name       = upstream_bit.index_page_name | default: "" %}
+  {%- assign upstream_bit_index_page_url        = upstream_bit.index_page_url  | default: "" %}
+  {%- assign upstream_bit_btn_class             = "btn btn-sm m-1 btn-"        | append: upstream_bit_color %}
+
+  <div class="d-flex flex-column{% if upstream_bit_class != "" %} {{ upstream_bit_class }}{% endif %}">
+
+    {%- comment %} --- Upstream Peamble --- {% endcomment %}
+    {%- if upstream_bit.preamble %}
+      <div{% if upstream_bit_preamble_class != "" %} class="{{ upstream_bit_preamble_class }}"{% endif %}>{{ upstream_bit.preamble }}</div>
+    {%- endif %}
+
+    {%- comment %} --- Upstream Card --- {% endcomment %}
+    {%- include base/card.html.liquid
+    class             = upstream_bit_card_class
+    screenshot        = upstream_bit.screenshot
+    screenshot_class  = upstream_bit.screenshot_class
+    screenshot_style  = upstream_bit.screenshot_style
+    screenshot_alt    = upstream_bit.screenshot_alt
+    icon              = upstream_bit.icon
+    icon_class        = upstream_bit.icon_class
+    image             = upstream_bit.image
+    image_class       = upstream_bit.image_class
+    image_style       = upstream_bit.image_style
+    image_alt         = upstream_bit.image_alt
+    name              = upstream_bit.name
+    name_class        = upstream_bit.name_class
+    description       = upstream_bit.description
+    description_class = upstream_bit.description_class
+    actions           = upstream_bit.actions
+    actions_class     = upstream_bit_actions_class
+    color             = upstream_bit_color
+    %}
+
+    {%- comment %} --- Upstream Finale (Downstream Introduction) --- {% endcomment %}
+    {%- assign downstream_bits           = bits                         | where: "type", "downstream" | where: "relationship", upstream_bit.name %}
+    {%- assign downstream_bit_total      = downstream_bits              | size %}
+    {%- assign downstream_bit_index_name = upstream_bit_index_page_name | append: " (" | append: downstream_bit_total | append: ")"  %}
+
+    {%- if upstream_bit.finale %}
+      <div class="d-flex flex-row w-100 justify-content-between align-items-center my-3">
+        <div class="m-1{% if upstream_bit_finale_class != "" %} {{ upstream_bit_finale_class }}{% endif %}">{{ upstream_bit.finale }}</div>
+        {%- if downstream_bit_total > 3 %}
+          <div class="m-1">
+            {% include base/link.html.liquid
+            name          = downstream_bit_index_name
+            class         = ""
+            icon          = "fa-solid fa-arrow-right"
+            icon_position = "end"
+            url           = upstream_bit_index_page_url
+            %}
+          </div>
+        {% endif %}
+      </div>
+    {%- endif %}
+
+    {%- comment %} --- Downstream Cards --- {% endcomment %}
+    <div class="d-flex flex-row flex-wrap flex-lg-nowrap justify-content-between w-100 mb-3">
+      {%- for downstream_bit in downstream_bits | limit: 3 %}
+        <div class="card border-{{ upstream_bit_color }}-subtle m-1">
+          <div class="bg-{{ upstream_bit_color }} rounded-top">
+          <img src="{{ site.url }}{{ site.baseurl }}/assets/img/{{ downstream_bit.screenshot }}" class="card-img-top" alt="{{ downstream_bit.screenshot }}">
+          </div>
+          <div class="card-body">
+            <div class="h5 card-title">{{ downstream_bit.name }}</div>
+            <p class="card-text">{{ downstream_bit.description }}</p>
+            {% for action in downstream_bit.actions | limit: 1 %}
+              {% include base/link.html.liquid
+              name          = action.name
+              class         = upstream_bit_btn_class
+              icon          = action.icon
+              icon_position = action.icon_position
+              %}
+            {% endfor %}
+          </div>
+        </div>
+      {%- endfor %}
+    </div>
+
+  </div>
+{% endfor %}