jekyll-theme-centos 2.52.0.beta.89 → 2.52.0.beta.91

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b478d590320e1c0bfa50101d2a37ea82439f74cd87231c9b4ef20285b583211a
-  data.tar.gz: b672dc7ccda2bf6ae4e2c7d95cecd2d3518f82345de0c8f1e80d26171a13f301
+  metadata.gz: 23bf21a6e35d2941d90d11a7aefac6c245c1e2811fa5945eccf8bca522c02b90
+  data.tar.gz: 3f4e5a418e6a8e949b528bc4762899a351bebb05bd835c53df0945517d825e4b
 SHA512:
-  metadata.gz: c72e3f82fbecf8b002e996e06dddfb6216dcfd50adb9c41da33e441fdf8f61743afc48deee2da0440c11d42ebb3a5c0f8d376667f0b77ed384cf4ddba0dfa174
-  data.tar.gz: 6ec4146d254ce33046cbd8fa613b4a6745a7be5e39f774c967a5148acd97fe08c451a5b72a0cf28dda81fbffc146876841bf3149981f0d983fab2353b2376225
+  metadata.gz: 02da80654ac1f33df8888665c3f562face66490047e0726437ad8ac56c501e16046f6b1b3d993678159483204bf3612fb2086de5fdee8ce2b608aa4fda176130
+  data.tar.gz: 8d39190e6c26dc5c274933988326cbabe1152052e9f6e60f1eeeb2faacfbf472918f572b15c84122f77120f2d4e71d0b5385b1e5cd2981412b70f02bc6a21699

data/_config.yml

@@ -72,6 +72,7 @@ defaults:
       with_bits: false
       with_event: false
       with_calendar: false
+      with_download: false
       with_title: true
       with_preamble: true
       with_toc: true

data/_data/base/download.yml

@@ -0,0 +1,23 @@
+---
+#
+# site.data.base.download - Theme-shipped default data for the 'download'
+# component. Sites normally override this via _data/download.yml.
+#
+
+- title: "Example Distribution"
+  description: |
+    A minimal example download entry, used as the fallback when a site
+    doesn't provide its own `_data/download.yml`.
+  releases:
+    "1.0":
+      architecture:
+        x86_64:
+          mirrors:
+            iso: "https://example.com/mirrorlist?arch=x86_64"
+            rpm: "https://example.com/repo/x86_64/"
+      documentation:
+        - title: Release Notes
+          link: "https://example.com/release-notes/"
+      eol:
+        - date: "1 January 2030"
+          description: "End of support."

data/_data/base/download_schema.yml

@@ -0,0 +1,254 @@
+title: Download Component Configuration
+description: >-
+  Schema for configuring the 'Download' presentation component. Renders one or
+  more download entries, each with a tabbed release selector; every release
+  carries an architecture grid (each architecture with its own main
+  download/checksum/signature and mirror links),
+  release-wide documentation links, end-of-life notices, command snippets,
+  and a screenshot carousel. Sections render automatically when their data
+  is present — no separate visibility flag is needed per section. Data can
+  also come from a product-keyed `_data/download-<slug>.yml` file; assign
+  `site.data["download-<slug>"]` to a variable, then pass that variable as
+  the component's `data` parameter.
+type: object
+properties:
+  with_download:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the Download component rendering. Set to `true` to
+      display the component; set to `false` (default) to skip rendering.
+  with_download_data:
+    type: array
+    default: []
+    description: >-
+      An array of download entries (e.g. one per distribution). When defined,
+      this data overrides any values set in the component's default
+      configuration file. Use the component's `title` include parameter to
+      render only a single matching entry from this list.
+    items:
+      type: object
+      properties:
+        title:
+          type: string
+          default: ""
+          description: >-
+            The name of this download entry (e.g. `CentOS Stream`). Also used
+            to match the component's `title` include parameter when filtering
+            to a single entry.
+        description:
+          type: string
+          default: ""
+          description: A short description of this download entry, shown above the release selector. Supports Markdown.
+        image_base_path:
+          type: string
+          default: ""
+          description: >-
+            Base path used to resolve bare filenames in this entry's
+            `screenshots` field below. Always a path under
+            `/assets/img/`; never include `site.baseurl` in this value — only
+            the path that comes after it, since the component prepends
+            `site.baseurl` itself at render time. When left empty (the
+            default), download.html.liquid computes it dynamically from the
+            current page's own URL — `/assets/img` + `page.url` — so every
+            page hosting this component gets its own collision-free
+            screenshot directory automatically (e.g. a page rendered at
+            `/examples/components/download-single-release/` resolves
+            screenshots under
+            `/assets/img/examples/components/download-single-release/`),
+            with no per-page configuration required. Set this explicitly only
+            to point at a shared/external location instead of the hosting
+            page's own directory.
+        releases:
+          type: object
+          default: {}
+          description: >-
+            A map of release identifiers (e.g. `9`, `8`, `v1.0`) to release
+            content. Always required, even for a project like CentOS Stream
+            that only ever has one active version — a single entry still
+            identifies which version the surrounding sections belong to. With
+            more than one entry, order determines tab order and the first key
+            is the active tab on load; with exactly one entry, no tab
+            selector renders at all and that release's sections render
+            directly, since a permanently-active single tab has nothing to
+            switch between.
+          properties:
+            "{release_id}":
+              type: object
+              description: >-
+                Placeholder for a release identifier — the actual map key is
+                any string you choose (e.g. `9`, `8`, `v1.0`); each key
+                identifies one release and the content described below.
+              properties:
+                icon:
+                  type: string
+                  default: ""
+                  description: >-
+                    Font Awesome icon class shown alongside this release's tab
+                    label in the nav-pills selector (e.g. `fa-solid fa-expand`).
+                    Only rendered when there's more than one release — a single,
+                    non-interactive tab has no selector to label. Empty shows
+                    the label alone.
+                architecture:
+                  type: object
+                  default: {}
+                  description: >-
+                    A map of architecture label (e.g. `x86_64`, `aarch64`) to
+                    that architecture's own content — its main download/
+                    checksum/signature and mirror links. Each architecture's
+                    identity is defined once, as this map's key, instead of
+                    being repeated as a field inside a separate structure that
+                    could drift out of sync. Alternative images (flavors, e.g.
+                    a desktop spin) are not modeled here — a flavor is just
+                    another download entry, not a smaller variant of this one;
+                    give it its own `with_download_data` entry (with its own
+                    `architecture`/`mirrors`/`download`/`checksum`, and
+                    `releases` keyed by flavor name to reuse the tab selector)
+                    and link the two together via `documentation` or page
+                    content.
+                  properties:
+                    "{architecture}":
+                      type: object
+                      description: >-
+                        Placeholder for an architecture label — the actual map
+                        key is any string you choose (e.g. `x86_64`,
+                        `aarch64`); each key identifies one architecture and
+                        the content described below.
+                      properties:
+                        download:
+                          type: string
+                          default: ""
+                          description: >-
+                            Direct download URL for this architecture's main
+                            image. Rendered as a filled-primary Download button
+                            above the checksum/signature rows and mirror
+                            buttons. Empty hides the Download button.
+                        checksum:
+                          type: string
+                          default: ""
+                          description: >-
+                            Checksum file URL for the `download` image above.
+                            Rendered together with `checksum_value` as a single
+                            input-group row: this URL becomes the row's left
+                            icon-link (opens the checksum file); empty renders
+                            the icon as a non-interactive glyph instead of a
+                            link, but the row itself still renders if
+                            `checksum_value` is set.
+                        signature:
+                          type: string
+                          default: ""
+                          description: >-
+                            Detached GPG signature URL (e.g. a `.asc`/`.sig`
+                            file) for the `checksum` manifest above, so its
+                            authenticity can be verified independently of its
+                            integrity. Rendered together with `signature_value`
+                            as a single input-group row, the same pattern as
+                            `checksum`/`checksum_value`: this URL becomes the
+                            row's left icon-link; empty renders the icon as a
+                            non-interactive glyph instead of a link.
+                        checksum_value:
+                          type: string
+                          default: ""
+                          description: >-
+                            The literal checksum digest (e.g. a SHA256 hex
+                            string) for the `download` image above, distinct
+                            from `checksum`, which links to the checksum file
+                            itself rather than holding its value. Rendered as
+                            the read-only, copy-to-clipboard text of the same
+                            input-group row as `checksum` (via the copyvalue
+                            component), so it can be pasted directly into a
+                            terminal to compare against a locally computed
+                            checksum. When empty but `checksum` is set, the row
+                            still renders and its copyable text falls back to
+                            the `checksum` URL itself.
+                        signature_value:
+                          type: string
+                          default: ""
+                          description: >-
+                            The GPG key fingerprint used to produce `signature`
+                            above, distinct from `signature`, which links to the
+                            detached signature file itself rather than holding a
+                            copyable value. Rendered as the read-only,
+                            copy-to-clipboard text of the same input-group row as
+                            `signature` (via the copyvalue component), the same
+                            pattern most distros use to publish a signing key's
+                            fingerprint for manual verification. When empty but
+                            `signature` is set, the row still renders and its
+                            copyable text falls back to the `signature` URL
+                            itself.
+                        mirrors:
+                          type: object
+                          default: {}
+                          description: >-
+                            Mirror links for this architecture's image types,
+                            each rendered as its own outline-primary button
+                            below the download/checksum/signature group.
+                          properties:
+                            iso:        { type: string, default: "", description: "ISO mirror list URL. Empty hides the ISO Mirrors button." }
+                            rpm:        { type: string, default: "", description: "RPM repository URL. Empty hides the RPM Mirrors button." }
+                            cloud:      { type: string, default: "", description: "Cloud image directory URL. Empty hides the Cloud Images button." }
+                            containers: { type: string, default: "", description: "Container image registry URL. Empty hides the Container Images button." }
+                            vagrant:    { type: string, default: "", description: "Vagrant box URL. Empty hides the Vagrant Boxes button." }
+                            torrent:    { type: string, default: "", description: "Torrent (.torrent/magnet) URL, an alternate mirror-load-reducing distribution method. Empty hides the Torrent button." }
+                          additionalProperties: false
+                      additionalProperties: false
+                  additionalProperties: false
+                documentation:
+                  type: array
+                  description: >-
+                    Documentation links, release-wide rather than per
+                    architecture, presented as a compact secondary section
+                    below the architecture grid — a small heading and a row of
+                    outline buttons, not full cards.
+                  items:
+                    type: object
+                    properties:
+                      title: { type: string, default: "", description: "Visible link label." }
+                      link:  { type: string, default: "", description: "Target URL." }
+                    additionalProperties: false
+                eol:
+                  type: array
+                  description: >-
+                    End-of-life milestones, release-wide rather than per
+                    architecture, presented as a compact secondary section
+                    below the architecture grid — a small heading and a plain
+                    list, not full cards.
+                  items:
+                    type: object
+                    properties:
+                      date:        { type: string, default: "", description: "End-of-life date or milestone label, e.g. `31 May 2024`." }
+                      description: { type: string, default: "", description: "Supporting text or HTML for this milestone." }
+                    additionalProperties: false
+                commands:
+                  type: array
+                  description: >-
+                    Command snippets ("Migration"), release-wide rather than
+                    per architecture, presented as a compact secondary section
+                    below the architecture grid — a small heading, each
+                    command's own `title` as a smaller sub-title, and its code
+                    block, not full cards.
+                  items:
+                    type: object
+                    properties:
+                      title: { type: string, default: "", description: "Sub-title shown above this command's code block." }
+                      lines: { type: string, default: "", description: "Shell command(s), rendered inside a <pre><code> block." }
+                    additionalProperties: false
+                screenshots:
+                  type: array
+                  description: >-
+                    Images shown in the release's screenshot carousel,
+                    release-wide rather than per architecture.
+                  items:
+                    type: object
+                    properties:
+                      src: { type: string, default: "", description: "Bare filename, resolved against `image_base_path`." }
+                      alt: { type: string, default: "", description: "Alternative text for the image." }
+                      title: { type: string, default: "", description: "Caption heading overlaid on the slide. Empty hides the caption's heading." }
+                      description: { type: string, default: "", description: "Caption body text overlaid on the slide. Empty hides the caption's body." }
+                    additionalProperties: false
+              additionalProperties: false
+          additionalProperties: false
+      required:
+        - title
+      additionalProperties: false
+additionalProperties: false

data/_data/base/navbar_schema.yml

@@ -120,10 +120,10 @@ properties:
                   - name
                   - link # Required for all nested links
                 additionalProperties: false
-              required:
-                - name # Required for all top-level links/menus
-            additionalProperties: false
-      required:
-        - navitems # Navigation is critical for the navbar
-      additionalProperties: false
+          required:
+            - name # Required for all top-level links/menus
+          additionalProperties: false
+    required:
+      - navitems # Navigation is critical for the navbar
+    additionalProperties: false
 additionalProperties: false

data/_data/base/navindex_schema.yml

@@ -25,7 +25,7 @@ properties:
           format: uri-reference
         title_lead:
           type: string
-          description: A short description or lead paragraph displayed alongside the link in most formats.
+          description: A short description or lead paragraph displayed alongside the link in most formats. Supports Markdown.
         name:
           type: string
           description: The original filename or slug of the page, used when `show_page_filename` is `true`.

data/_data/base/sponsors.yml

@@ -1,7 +1,6 @@
 ---
 title: Sponsors
 icon: "fa-solid fa-hand-holding-heart"
-image_base_path: "/assets/img/base/"
 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

data/_data/base/sponsors_schema.yml

@@ -27,14 +27,23 @@ properties:
         type: string
         default: ""
         description: Introductory text rendered above the carousel, supports Markdown.
+      # NOTE: this default is hardcoded to match examples/jekyll/components/
+      # sponsors.md's current page.url (/components/sponsors/), not computed
+      # from it (YAML can't run Liquid). If that page is ever renamed or its
+      # permalink changes, update this default to match — nothing else does
+      # so automatically.
       image_base_path:
         type: string
-        default: "/assets/img/base/"
+        default: "/assets/img/components/sponsors/"
         description: >-
           Base path prepended to bare logo filenames when building the image `src`
-          attribute. Defaults to `/assets/img/base/`. Set to a different path
-          (e.g. `/assets/img/sponsors/`) to store logos elsewhere on the site.
-          Ignored when `image` is an absolute URL (`http://` or `https://`).
+          attribute. Defaults to `/assets/img/components/sponsors/`, where this
+          theme's own example logos live — a fixed, static default (not
+          page-derived) since sponsors data is typically shared across every
+          page that enables with_sponsors, not unique per page. Set to a
+          different path (e.g. `/assets/img/my-real-sponsors/`) to store real
+          logos elsewhere on the site. Ignored when `image` is an absolute URL
+          (`http://` or `https://`).
       members:
         type: array
         default: []

data/_data/base/title_schema.yml

@@ -36,7 +36,9 @@ properties:
       title_lead:
         type: string
         default: "`page.title_lead`"
-        description: An optional lead text or introductory paragraph displayed immediately beneath the H1, providing context or summary.
+        description: >-
+          An optional lead text or introductory paragraph displayed immediately
+          beneath the H1, providing context or summary. Supports Markdown.
       title_lead_class:
         type: string
         default: "lead"

data/_includes/base/download.html.liquid

@@ -0,0 +1,146 @@
+{% comment %}
+================================================================================
+Template: Download Component
+Purpose: Renders one or more download entries. Full data-driven section
+component (like bits/sponsors), gated by with_download and resolved through
+the standard 4-level fallback chain. Each entry in with_download_data is an
+independent download "card" (e.g. one per distribution); include.title
+filters to a single entry. Per-release sections (architecture/documentation/
+eol/commands/screenshots) render automatically when their data is present —
+no separate with_X flag per section, matching how card.html.liquid renders
+its own sections only "if content". Shared between both render paths via
+download_sections.html.liquid.
+
+Alternative images (flavors) are not a section of this schema — a flavor
+is just another download entry, linked via `documentation` or page
+content rather than nested inside this one.
+
+Data Source Hierarchy (in priority order):
+1. include.data            - Explicitly passed array
+2. page.with_download_data - Page front matter
+3. site.data.download      - Site data
+4. site.data.base.download - Theme defaults
+
+Optional Inputs (from include):
+- title: Render only the entry whose title matches exactly.
+- id:    HTML id prefix for the nav-pills tab selector (default: DownloadsCard-1).
+================================================================================
+{% endcomment %}
+
+{%- assign with_download = include.with_download
+| default: page.with_download
+%}
+
+{%- assign with_download_data = include.data
+| default: page.with_download_data
+| default: site.data.download
+| default: site.data.base.download
+%}
+
+{%- assign with_download_schema = site.data.base.download_schema.properties.with_download_data.items.properties %}
+
+{%- if with_download %}
+{%- for entry in with_download_data %}
+
+  {%- if include.title and include.title != "" and include.title != entry.title %}
+    {%- continue %}
+  {%- endif %}
+
+  {%- comment %} image_base_path defaults to a path derived from the current
+  page's own URL (page.url already ends in "/" for pretty permalinks) rather
+  than a fixed schema default — every page gets its own collision-free
+  screenshot directory automatically, with no per-page front matter needed,
+  unless the entry explicitly overrides it. See download_schema.yml's
+  image_base_path description for the full rationale. {% endcomment %}
+  {%- if entry.image_base_path and entry.image_base_path != "" %}
+    {%- assign entry_image_base_path = entry.image_base_path %}
+  {%- else %}
+    {%- assign entry_image_base_path = "/assets/img" | append: page.url %}
+  {%- endif %}
+
+  {%- comment %} entry.title feeds an HTML id (card_id) below. A hand-picked
+  remove: chain (mirroring link.html.liquid's anchor assignment) missed
+  characters like em dashes, which the id spec forbids just the same —
+  slugify handles any non-alphanumeric character, not just a fixed list. {% endcomment %}
+  {%- assign entry_title_id_safe = entry.title | slugify %}
+
+  {%- if include.id and include.id != "" %}
+    {%- assign card_id = include.id | append: "-" | append: entry_title_id_safe | downcase | replace: " ", "-" %}
+  {%- else %}
+    {%- assign card_id = "DownloadsCard-1-" | append: entry_title_id_safe | downcase | replace: " ", "-" %}
+  {%- endif %}
+
+  <div class="mb-1">
+    {%- assign single_release = nil %}
+    {%- if entry.releases.size == 1 %}
+      {%- assign single_release = entry.releases | first %}
+    {%- endif %}
+
+    {%- if entry.title and entry.title != "" %}
+    <div class="h2">
+      {{ entry.title | escape }}{% if single_release %} {{ single_release[0] | escape }}{% endif %}
+    </div>
+    {%- endif %}
+
+    {%- if entry.description and entry.description != "" %}
+    {{ entry.description | strip_newlines | markdownify }}
+    {%- endif %}
+
+    {%- comment %} A `releases` field always identifies which version(s) an
+    entry covers; when there's more than one, a tabbed nav-pills selector
+    switches between them. When there's exactly one — the common case for a
+    project like CentOS Stream, which only ever has one active version —
+    the tab selector is skipped and that release's sections render
+    directly, since a single, permanently-active, non-interactive tab would
+    just be chrome with nothing to switch between. {% endcomment %}
+    {%- if entry.releases.size == 1 %}
+      {%- for release in entry.releases %}
+      {%- assign release_data = release[1] %}
+      {%- assign release_id = card_id | append: "-pills1" %}
+      <div id="{{ release_id }}" class="bg-white rounded py-3 border">
+        {%- include base/download_sections.html.liquid release_data=release_data release_id=release_id image_base_path=entry_image_base_path -%}
+      </div>
+      {%- endfor %}
+    {%- elsif entry.releases.size > 1 %}
+    <ul class="nav nav-pills my-3 justify-content-start" id="{{ card_id }}-pills-tab" role="tablist">
+      {%- for release in entry.releases %}
+      <li class="nav-item" role="presentation">
+        <button class="nav-link{% if forloop.first %} active{% endif %} fw-bold"
+          id="{{ card_id }}-pills-tab{{ forloop.index }}"
+          data-bs-toggle="tab"
+          data-bs-target="#{{ card_id }}-pills{{ forloop.index }}"
+          type="button"
+          role="tab"
+          aria-controls="{{ card_id }}-pills-tab{{ forloop.index }}"
+          {%- if forloop.first %} aria-selected="true"{% endif %}
+          >{%- if release[1].icon and release[1].icon != "" %}<i class="{{ release[1].icon }} me-1"></i>{% endif %}{{ release[0] }}</button>
+      </li>
+      {%- endfor %}
+    </ul>
+
+    {%- comment %} border/rounded/bg-white live on this outer .tab-content div,
+    not the inner .tab-pane — a .tab-pane's own corners are always square, so if
+    the rounded, filled look lived there instead, its corners would poke past
+    this div's border at each corner. overflow-hidden clips each pane to match.
+    Mirrors the single-release path above, which only ever needs one
+    rounded/bordered/filled box. {% endcomment %}
+    <div class="tab-content border rounded overflow-hidden bg-white" id="{{ card_id }}-pills-tabContent">
+      {%- for release in entry.releases %}
+      {%- assign release_data = release[1] %}
+      {%- assign release_id = card_id | append: "-pills" | append: forloop.index %}
+      {%- assign tab_id = card_id | append: "-pills-tab" | append: forloop.index %}
+
+      <div class="tab-pane fade{% if forloop.first %} show active{% endif %} py-3"
+           id="{{ release_id }}"
+           role="tabpanel"
+           aria-labelledby="{{ tab_id }}"
+           tabindex="0">
+        {%- include base/download_sections.html.liquid release_data=release_data release_id=release_id image_base_path=entry_image_base_path -%}
+      </div>
+      {%- endfor %}
+    </div>
+    {%- endif %}
+
+  </div>
+{%- endfor %}
+{%- endif %}

data/_includes/base/download_accordion_item.html.liquid

@@ -0,0 +1,39 @@
+{% comment %}
+================================================================================
+Utility: Download Accordion Item
+Purpose: The Bootstrap accordion-item/header/button/collapse/body shell
+shared 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. 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="mx-3 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>