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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17ed7d589e011c3e09c7cf062f7f64d1286c240416824337f422451e7f34798f
-  data.tar.gz: 81b6f83d055a43aaf4a7159b2af93c5f397cc99d095831f341ef2d194c84184a
+  metadata.gz: 5bfd8865d28f302b876848d4880cead6737a6c5db6557860cb5ea4c6c5bd6b5a
+  data.tar.gz: 0652ce4df5cd1f375f6635a223349349c44e154b1b02eb282eeacd902e5c11e8
 SHA512:
-  metadata.gz: b73d63d83f6c1fc8a1fbdc7bb35b08629227b8cd5902d824861501f52fbad49d22f5d5ddc4897844eb6f8e41f0427925fb456cf9c882261680f55683f3cc71b7
-  data.tar.gz: 94fbdbbcfd4b4cb8740d342395d33c8dbccc13ab97cb3bb9f660fa6976dfad2b8163c59066724f4f57bf5152496205b76ab4e51cef934a353e72d53eaf3c6efd
+  metadata.gz: 59d8fbfb01363664e4f52d6e0406cd208d18ca171dabe5254986c4f675146631bc630bad7c0fd43e7213c53cf43d585e8b47bfae8185a29df3fdbd0eb086501f
+  data.tar.gz: cd55937ac323c309df3715c59c6dd81bab1c1d87d9b17bc4147b234b7ac0155cc731bc94a286df4c5a075446adb2d1ad2f9d373015c083ed412e3abb6a33f3bd

data/_data/base/accordion_schema.yml

@@ -53,6 +53,12 @@ properties:
           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).
+      header_class:
+        type: string
+        default: "h2"
+        description: >-
+          CSS classes applied to the `accordion-header` element. Pass `""`
+          to remove the heading style.
       item_id:
         type: string
         default: ""

data/_data/base/announcement_schema.yml

@@ -26,7 +26,7 @@ properties:
         content:
           type: string
           default: ""
-          description: The main text content of the announcement. This field is required.
+          description: The main text content of the announcement. Accepts Markdown. This field is required.
         color:
           type: string
           default: "primary"

data/_data/base/artwork_schema.yml

@@ -6,10 +6,10 @@ type: object
 properties:
   with_artwork:
     type: boolean
-    default: true
+    default: false
     description: >-
-      Enables or disables the Artwork component. Set to `true` (default) to
-      display the artwork; set to `false` to hide it. When enabled,
+      Enables or disables the Artwork component. Set to `true` to
+      display the artwork; set to `false` (default) to hide it. When enabled,
       the related `with_artwork_data` property is used for configuration.
   with_artwork_data:
     type: object
@@ -45,4 +45,18 @@ properties:
         description: >-
           The text used as the `aria-label` on the artwork element, crucial
           for accessibility and SEO.
+  row_class:
+    type: string
+    description: >-
+      Include parameter. CSS classes for the wrapping `div.row`. When
+      omitted, the content component's `row_class` default applies. The
+      content component passes its own `row_class` here, so every row
+      inside `<main>` shares the same spacing.
+  column_class:
+    type: string
+    description: >-
+      Include parameter. CSS classes for the column `div` inside the row.
+      When omitted, the content component's `col_class` default applies.
+      The content component passes its own `col_class` here, so every row
+      inside `<main>` shares the same column width.
 additionalProperties: false

data/_data/base/bits_schema.yml

@@ -78,10 +78,15 @@ properties:
         screenshot_alt:
           type: string
           default: ""
-          description: The alternative text for the `screenshot` image, for accessibility.
+          description: >-
+            The alternative text for the `screenshot` image, for both upstream
+            and downstream Bits. When empty, falls back to the `screenshot`
+            file name.
         description:
           type: string
-          description: A concise description of the Bit, typically one or two sentences long.
+          description: >-
+            A concise description of the Bit, typically one or two sentences
+            long. Accepts Markdown.
         description_class:
           type: string
           default: ""
@@ -122,7 +127,7 @@ properties:
           default: "Bits produced upstream:"
           description: >-
             A descriptive message displayed before the Upstream Bits section.
-            Only relevant when `type` is set to `upstream`.
+            Accepts Markdown. Only relevant when `type` is set to `upstream`.
         preamble_class:
           type: string
           default: "mb-3"
@@ -132,7 +137,7 @@ properties:
           default: "Bits produced downstream:"
           description: >-
             A descriptive message displayed before the Downstream Bits section.
-            Only relevant when `type` is set to `upstream`.
+            Accepts Markdown. Only relevant when `type` is set to `upstream`.
         finale_class:
           type: string
           default: "mb-3"

data/_data/base/breadcrumb_schema.yml

@@ -24,4 +24,18 @@ properties:
           The `aria-label` attribute value for the breadcrumb `<nav>` element.
           Screen readers use this label to identify the navigation landmark.
     additionalProperties: false
+  row_class:
+    type: string
+    description: >-
+      Include parameter. CSS classes for the wrapping `div.row`. When
+      omitted, the content component's `row_class` default applies. The
+      content component passes its own `row_class` here, so every row
+      inside `<main>` shares the same spacing.
+  column_class:
+    type: string
+    description: >-
+      Include parameter. CSS classes for the column `div` inside the row.
+      When omitted, the content component's `col_class` default applies.
+      The content component passes its own `col_class` here, so every row
+      inside `<main>` shares the same column width.
 additionalProperties: false

data/_data/base/breakingnews_schema.yml

@@ -31,7 +31,7 @@ properties:
       properties:
         content:
           type: string
-          description: The main text content of the breaking news message. This field is required.
+          description: The main text content of the breaking news message. Accepts Markdown. This field is required.
         color:
           type: string
           default: primary

data/_data/base/calendar_schema.yml

@@ -9,8 +9,8 @@ properties:
     type: boolean
     default: false
     description: >-
-      Enables or disables the Event Calendar addon. Set to `true` (default)
-      to load the necessary CSS and JavaScript files; set to `false` to
+      Enables or disables the Event Calendar addon. Set to `true` to load
+      the necessary CSS and JavaScript files; set to `false` (default) to
       disable.
   with_calendar_data:
     type: object
@@ -155,4 +155,19 @@ properties:
       - css_integrity
       - script_integrity
     additionalProperties: false
+  id:
+    type: string
+    default: centos-calendar
+    description: >-
+      Include parameter for `calendar-init.html.liquid`. The DOM id of the
+      calendar container. The events JSON script, rendered by
+      `calendar-events.html.liquid`, gets the id `<id>-events`. Give each
+      calendar a distinct `id` when a page shows more than one.
+  event_data:
+    type: array
+    description: >-
+      Include parameter for `calendar-init.html.liquid`. The events for
+      this calendar, in the same item shape as `with_calendar_data.events`.
+      Takes priority over `with_calendar_data.events` and the event
+      component's `with_event_data`.
 additionalProperties: false

data/_data/base/card_schema.yml

@@ -62,7 +62,7 @@ properties:
     type: string
     default: "display-5 fw-bold mb-3"
     description: >-
-      CSS classes applied to the name wrapper `<div>`
+      CSS classes applied to the name `<p>` element
       (e.g., `display-5 fw-bold mb-3`).
   name_link:
     type: string
@@ -118,7 +118,7 @@ properties:
     type: string
     default: "mb-3"
     description: >-
-      CSS classes applied to the description wrapper `<div>`
+      CSS classes applied to the description `<p>` element
       (e.g., `mb-3`).
   actions:
     type: array

data/_data/base/copyright_schema.yml

@@ -6,10 +6,10 @@ type: object
 properties:
   with_copyright:
     type: boolean
-    default: false
+    default: true
     description: >-
       Enables or disables the rendering of the copyright notice. Set to `true`
-      to display the copyright; set to `false` (default) to hide it.
+      (default) to display the copyright; set to `false` to hide it.
   with_copyright_data:
     type: object
     description: >-
@@ -39,14 +39,6 @@ properties:
                 The URL for the legal document. Accepts absolute URLs, site-relative
                 paths, and anchor references (e.g., `https://example.org/legal`,
                 `/privacy/`, `#terms`).
-            color:
-              type: string
-              default: light
-              description: >-
-                The Bootstrap link color scheme (e.g., `light`, `primary`).
-                Substituted into `class`'s own default (see `class` below).
-                Has no effect when `class` is also set, because an explicit
-                `class` overrides the default entirely.
             icon:
               type: string
               description: >-
@@ -67,14 +59,12 @@ properties:
                 (e.g., `menuitem`).
             class:
               type: string
-              default: "link link-{color} link-offset-3 link-offset-3-hover link-underline-{color} link-underline-opacity-0 link-underline-opacity-100-hover focus-ring border-start ms-2 ps-2"
+              default: "link link-offset-2 link-offset-2-hover link-underline link-underline-opacity-0 link-underline-opacity-100-hover focus-ring"
               description: >-
-                Custom CSS classes applied to the anchor element. When set,
-                overrides the default legal link styling entirely, including
-                `color`. When unset, the template substitutes `color` (or
-                this property's own default color, if `color` is also
-                unset) into this schema's own documented default (see
-                `default` above).
+                CSS classes for the legal link. Set it to replace the
+                default styling. The default has no color class: the
+                footer's dark color mode sets the link colors. Don't add a
+                separator here; the template draws one before each link.
           required:
             - name
     additionalProperties: false

data/_data/base/copyvalue_schema.yml

@@ -11,7 +11,10 @@ properties:
     description: >-
       Enables or disables the Copy Value component JavaScript functionality.
       Set to `true` (default) to activate copy-to-clipboard features;
-      set to `false` to disable the script.
+      set to `false` to disable the script. The highlight, preview,
+      download, and color-table components add their own copy buttons
+      only when this is `true`; when it is `false`, they omit the button
+      and keep the rest of their output.
   with_copyvalue_data:
     type: object
     description: >-

data/_data/base/datatable_schema.yml

@@ -6,10 +6,10 @@ type: object
 properties:
   with_datatable:
     type: boolean
-    default: true
+    default: false
     description: >-
-      Enables or disables the DataTables addon. Set to `true` (default) to
-      load the necessary CSS and JavaScript files; set to `false` to disable.
+      Enables or disables the DataTables addon. Set to `true` to
+      load the necessary CSS and JavaScript files; set to `false` (default) to disable.
   with_datatable_data:
     type: object
     description: >-

data/_data/base/download_schema.yml

@@ -154,12 +154,14 @@ properties:
                             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 read-only text of the same input-group row as
+                            `checksum`, with a copy button (via the copyvalue
+                            component) when the page has `with_copyvalue` on,
+                            so it can be pasted directly into a terminal to
+                            compare against a locally computed checksum.
+                            Without `with_copyvalue`, the row ends at the
+                            read-only value. When empty but `checksum` is set,
+                            the row still renders and its value falls back to
                             the `checksum` URL itself.
                         signature_value:
                           type: string
@@ -168,14 +170,15 @@ properties:
                             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
+                            copyable value. Rendered as the read-only text of the
+                            same input-group row as `signature`, with a copy
+                            button (via the copyvalue component) when the page
+                            has `with_copyvalue` on, the same pattern most
+                            distros use to publish a signing key's fingerprint
+                            for manual verification. Without `with_copyvalue`,
+                            the row ends at the read-only value. When empty but
                             `signature` is set, the row still renders and its
-                            copyable text falls back to the `signature` URL
-                            itself.
+                            value falls back to the `signature` URL itself.
                         mirrors:
                           type: object
                           default: {}
@@ -231,7 +234,7 @@ properties:
                     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." }
+                      description: { type: string, default: "", description: "Supporting text for this milestone. Accepts Markdown." }
                     additionalProperties: false
                 commands:
                   type: array
@@ -257,12 +260,35 @@ properties:
                     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." }
+                      title: { type: string, default: "", description: "Caption heading overlaid on the slide. Accepts Markdown. Empty hides the caption's heading." }
+                      description: { type: string, default: "", description: "Caption body text overlaid on the slide. Accepts Markdown. Empty hides the caption's body." }
                     additionalProperties: false
               additionalProperties: false
           additionalProperties: false
       required:
         - title
       additionalProperties: false
+  title:
+    type: string
+    default: ""
+    description: >-
+      Include parameter. Renders only the entry whose `title` matches this
+      value. Empty renders every entry.
+  id:
+    type: string
+    default: DownloadsCard-1
+    description: >-
+      Include parameter. Prefix for the HTML ids of each entry's release
+      tabs and sections. The entry's slugified `title` is appended, and the
+      result is lowercased.
+  with_title:
+    type: boolean
+    default: true
+    description: >-
+      Include parameter. Set to `false` to hide each entry's title heading.
+  with_description:
+    type: boolean
+    default: true
+    description: >-
+      Include parameter. Set to `false` to hide each entry's description.
 additionalProperties: false

data/_data/base/event_schema.yml

@@ -27,7 +27,7 @@ properties:
         description:
           type: string
           default: ""
-          description: A brief description of the event.
+          description: A brief description of the event. Accepts Markdown.
         start:
           type: string
           description: >-

data/_data/base/footer_schema.yml

@@ -7,11 +7,11 @@ type: object
 properties:
   with_footer:
     type: boolean
-    default: false
+    default: true
     description: >-
-      Controls the visibility of the Footer component. Set to `true` to
-      display the footer at the bottom of the page. Set to `false` (default)
-      to hide it entirely.
+      Controls the visibility of the Footer component. Set to `true` (default)
+      to display the footer at the bottom of the page. Set to `false` to hide
+      it entirely.
   with_footer_data:
     type: object
     default: {}
@@ -24,8 +24,9 @@ properties:
         type: string
         default: "footer small bg-dark text-centos-purple-100 pt-5"
         description: >-
-          Custom Bootstrap class(es) applied to the `<footer>` element
-          itself — the outermost element owned by this component.
+          Bootstrap classes for the `<footer>` element. The footer always
+          uses Bootstrap's dark color mode, which gives links light colors,
+          so keep a dark background class such as `bg-dark`.
       brand_image:
         type: string
         default: "centos-whitelogo.svg"

data/_data/base/highlight_schema.yml

@@ -3,11 +3,13 @@ description: >-
   Schema for configuring the external Highlight.js library addon, used to
   provide dynamic syntax highlighting for code blocks within the content.
   Colors come from this site's own CentOS-palette theme
-  (_highlight-theme.scss), not a configurable CDN theme file. Copy-to-clipboard
-  for code blocks is handled separately, by base/highlight.js wrapping every
-  code block in the same toolbar/copy button treatment as
-  base/preview.html.liquid's own code row (see copyvalue_schema.yml) — not by
-  this addon.
+  (_highlight-theme.scss), not a configurable CDN theme file. The code block
+  frame is handled separately, by base/highlight.js wrapping every code block
+  in the same frame and code row as base/preview.html.liquid — not by this
+  addon. A toolbar above the code row renders only when it has content: a
+  language label when the fence declares one, and a copy button when the page
+  has `with_copyvalue` on (see copyvalue_schema.yml). Without either, only the
+  framed code block shows.
 type: object
 properties:
   with_highlight:

data/_data/base/image_schema.yml

@@ -24,7 +24,7 @@ properties:
     type: string
     description: >-
       Caption text rendered inside a `<figcaption>` element below the
-      image. When not set, no caption is rendered.
+      image. Accepts Markdown. When not set, no caption is rendered.
   extraclasses:
     type: string
     description: >-

data/_data/base/link_schema.yml

@@ -49,29 +49,23 @@ properties:
           - _blank
       class:
         type: string
-        default: "link link-{color} link-offset-3 link-offset-3-hover link-underline-{color} link-underline-opacity-0 link-underline-opacity-100-hover focus-ring"
-        description: >-
-          One or more CSS classes to apply to the link element. Use this
-          to override default link styling and apply component styles like
-          Bootstrap buttons (e.g., `btn btn-primary btn-lg`). When not set, the
-          template substitutes `color` into this schema's own documented
-          default (see `default` above) — a baseline specific to this
-          component's color-driven presentation, independent of
-          `jekyll-link-decorator`'s site-wide `default_link_classes` (which
-          only applies to plain links the decorator's post-processing pass
-          can reach; several `color`-driven call sites — `bits`, `card`,
-          `shortcut` — render via the layout, which the decorator
-          structurally never processes). Override this schema's default via
-          a site's own `_data/base/link_schema.yml` to change color-mode
-          styling site-wide, or pass `class` on an individual `{% include %}`
-          call to override just that one link.
+        default: "link link-{color} link-offset-2 link-offset-2-hover link-underline-{color} link-underline-opacity-0 link-underline-opacity-100-hover focus-ring"
+        description: >-
+          CSS classes for the link. Set it to replace the default styling,
+          for example with button classes (`btn btn-primary btn-lg`). When
+          you don't set it, the link copies the site's Markdown link
+          classes (`with_link_decorator_data.default_link_classes` in
+          `_config.yml`) and uses `color` for the text and underline, so
+          both kinds of links look the same. Sites without that setting
+          get this property's default, with `color` filled in.
       role:
         type: string
         default: ""
         description: >-
-          The ARIA role for the link element (e.g., `button` for styled links
-          that act as buttons). Used primarily for accessibility when the HTML
-          element's semantic meaning is being overridden.
+          The ARIA role for the link element. Leave it empty for links that
+          navigate to a page or section, including links styled with `.btn`
+          classes. Use `button` only for a link that triggers in-page behavior
+          instead of navigating, and prefer a native `<button>` element there.
       aria_label:
         type: string
         default: ""

data/_data/base/navbar_schema.yml

@@ -126,4 +126,10 @@ properties:
     required:
       - navitems # Navigation is critical for the navbar
     additionalProperties: false
+  arialabel:
+    type: string
+    default: navbar
+    description: >-
+      Include parameter. The `aria-label` of the `<nav>` element, which
+      screen readers announce as the name of the navigation landmark.
 additionalProperties: false

data/_data/base/preview_schema.yml

@@ -64,11 +64,14 @@ properties:
     type: string
     default: ""
     description: >-
-      Extra CSS classes applied to the toolbar's copy-button `<span>`. Set
+      Extra CSS classes applied to the toolbar's copy `<button>`. Set
       to `d-none` to hide the button without removing `code` (e.g., a
       snippet that's intentionally not meant to be copied). The button
-      itself only renders when `code` is supplied — there is nothing to
-      copy otherwise.
+      itself only renders when `code` is supplied and the page has
+      `with_copyvalue` on — without `code` there is nothing to copy, and
+      without `with_copyvalue` there is no copy script to handle a click.
+      When the button does not render and `language` is empty, the
+      toolbar is skipped entirely.
   code:
     type: string
     default: ""
@@ -77,7 +80,8 @@ properties:
       Liquid's `escape` filter) before being placed inside `<code>` and
       inside the copy button's `data-copy-value` attribute. When empty,
       this row does not render, and the toolbar's copy button does not
-      render either.
+      render either. When set, the copy button still renders only when
+      the page has `with_copyvalue` on.
   code_class:
     type: string
     default: "p-0 m-0"

data/_data/base/project_schema.yml

@@ -110,8 +110,10 @@ properties:
         description: Custom CSS classes applied to the container wrapping the action buttons list.
       actions_btn_class:
         type: string
-        default: btn text-nowrap m-1 btn-
-        description: Custom CSS classes applied to each individual action button element.
+        default: "btn text-nowrap m-1 btn-{color}"
+        description: >-
+          CSS classes applied to each action button. The card component
+          replaces `{color}` with its `color` value.
       resources:
         type: array
         default: []

data/_data/base/script_schema.yml

@@ -7,13 +7,13 @@ type: object
 properties:
   with_fontawesome:
     type: boolean
-    default: false
+    default: true
     description: >-
       When `true`, includes the Font Awesome JavaScript bundle before the
       closing `</body>` tag to enable icon rendering across the page.
   with_highlight:
     type: boolean
-    default: false
+    default: true
     description: >-
       When `true`, includes the Highlight.js JavaScript bundle and
       initializes syntax highlighting for all code blocks on the page.
@@ -26,14 +26,14 @@ properties:
       the `dataTable` CSS class.
   with_backtotop:
     type: boolean
-    default: false
+    default: true
     description: >-
       When `true`, includes the back-to-top button script, which renders
       a floating button that scrolls the page back to the top when
       clicked.
   with_copyvalue:
     type: boolean
-    default: false
+    default: true
     description: >-
       When `true`, includes the copy-value script, which attaches
       clipboard copy functionality to elements that use the designated

data/_data/base/shortcut_schema.yml

@@ -6,10 +6,10 @@ type: object
 properties:
   with_shortcut:
     type: boolean
-    default: true
+    default: false
     description: >-
       Controls the visibility of the Shortcut component in the page footer.
-      Set to `true` (default) to display the component; set to `false` to hide it.
+      Set to `true` to display the component; set to `false` (default) to hide it.
       When enabled, the component will load items where `footer` is included in
       their `visible_on` property, either from global `navitems` or `with_shortcut_data`.
   with_shortcut_data:

data/_data/base/social_schema.yml

@@ -6,10 +6,10 @@ type: object
 properties:
   with_social:
     type: boolean
-    default: false
+    default: true
     description: >-
       Enables or disables the rendering of the social media icons component.
-      Set to `true` to display the icons; set to `false` (default) to hide them.
+      Set to `true` (default) to display the icons; set to `false` to hide them.
   with_social_data:
     type: object
     default: {}

data/_data/base/sponsors.yml

@@ -3,8 +3,9 @@ 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 [becoming a sponsor!](/sponsors)
+  like to thank the following product/service for being a CentOS sponsor.
+closing_message: |
+  If you value our work, please consider [becoming a sponsor!](/sponsors)
 members:
   - name: sponsor-1
     country: usa

data/_data/base/sponsors_schema.yml

@@ -27,6 +27,13 @@ properties:
         type: string
         default: ""
         description: Introductory text rendered above the carousel, supports Markdown.
+      closing_message:
+        type: string
+        default: ""
+        description: >-
+          Closing text rendered below the carousel, supports Markdown. Use it
+          to invite visitors to act, e.g. to link to a page about becoming a
+          sponsor.
       # 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
@@ -79,4 +86,17 @@ properties:
     required:
       - members
     additionalProperties: false
+  id:
+    type: string
+    default: sponsorsCarousel
+    description: >-
+      Include parameter for `sponsors-carousel.html.liquid`. The DOM id of
+      the carousel wrapper. Give each carousel a distinct `id` when a page
+      shows more than one.
+  with_title:
+    type: boolean
+    default: true
+    description: >-
+      Include parameter for `sponsors-carousel.html.liquid`. Set to `false`
+      to hide the title, icon, and message above the carousel.
 additionalProperties: false