jekyll-theme-centos 2.52.0.beta.3 → 2.52.0.beta.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31a00ed1a85937dc6cbb6851b81b74665fa4f4211959878ef8ae1e03bcbcca6d
-  data.tar.gz: b7b0d18055c48d4e15e69c5ee0624aa1ac75d239237445c12fd818220da5b399
+  metadata.gz: 8e277162bcff7fef4019b4dfc95f7948d1e2b73451e99020373df53f6896b278
+  data.tar.gz: 25e64b4f95f3e17b18d86478bf92e8d8df4b09c1c7ccbd63c6ba183fe3877497
 SHA512:
-  metadata.gz: ac7108ce0a075bc01dae10b339e6d25d28003ef8b4c129f59003f40b36c18083ba449da31f45dcd31ee7a990daf32715f4663791ff88dcec5e19271b3c2ec620
-  data.tar.gz: 7b61cc8c5cae058c7c48c6b1ec245c2d765ebd30cbdade66dff58433bca81d877271482d77d57a29091815edad30becee8a9af9f98e2541d56ae1034b969fc2e
+  metadata.gz: 987543de88167a9b80706bb09e8b3f089d1ecc625f6a4d17f7be53a0342a6166f14c0cb4c8ab21091aa6ba9be050e99595f488ec8f747c14af5785c8fdb1b7a1
+  data.tar.gz: 2eb37a87c50c65c30ff5d39f897b09b4bd12bb6be997cc158a211bc24ddbd3e638ad64bb59df9c9dfca93aadedc0a7da97e40fb94e99fd460408c42c45eae700

data/_data/base/announcement_schema.yml

@@ -0,0 +1,50 @@
+---
+title: Announcement Component Configuration
+description: >-
+  Schema for configuring the 'Announcement' presentation component. This component
+  is typically used to display important, user-facing messages.
+type: object
+properties:
+  with_announcement:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the Announcement component. Set to `true` to
+      display announcements; set to `false` (default) to hide them. When enabled,
+      the related `with_announcement_data` property must be populated with content.
+  with_announcement_data:
+    type: array
+    default: []
+    description: >-
+      The configuration data for the announcement component. This property
+      accepts a list of announcement objects to be presented when
+      `with_announcement` is set to `true`. If multiple announcements are
+      provided, they will be displayed in the order they appear in the list.
+    items:
+      type: object
+      properties:
+        content:
+          type: string
+          default: ""
+          description: The main text content of the announcement. This field is required.
+        color:
+          type: string
+          default: "primary"
+          description: >-
+            Defines the visual style/severity of the announcement. Defaults to
+            `primary`. Available options are any supported [color](../color/)
+            class (e.g., `secondary`, `warning`, `success`, `danger`,
+            `centos-purple-800`.
+        icon:
+          type: string
+          default: ""
+          description: >-
+            The Font Awesome icon class (e.g., `fa-solid fa-bell`) to display
+            on the left side of the announcement. Only [freely distributed Font
+            Awesome icons](https://fontawesome.com/search?ic=free-collection) are supported. If no value is provided, the default
+            icon `fa-solid fa-bullhorn` will be used by the rendering engine.
+      required:
+        - content
+      additionalProperties: false
+additionalProperties: false
+# test

data/_data/base/artwork_schema.yml

@@ -0,0 +1,46 @@
+title: Artwork Component Configuration
+description: >-
+  Defines the schema for configuring the presentation and content of the Artwork
+  component, typically used to display a decorative or informational image.
+type: object
+properties:
+  with_artwork:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the Artwork component. Set to `true` (default) to
+      display the artwork; set to `false` to hide it. When enabled,
+      the related `with_artwork_data` property is used for configuration.
+  with_artwork_data:
+    type: object
+    description: >-
+      The configuration dictionary for the Artwork component. This object contains
+      all necessary settings, such as image source, container classes, and alt text.
+    properties:
+      class:
+        type: string
+        default: col
+        description: >-
+          Custom CSS class(es) to apply to the Artwork component's container element.
+          The default value `col` suggests a standard column layout.
+      image:
+        type: string
+        default: /assets/img/centos-motif.png
+        description: >-
+          The URL path to the image file. This supports both relative paths (e.g., `/assets/img/your-image.jpg`) and absolute URLs.
+      image_class:
+        type: string
+        default: img-fluid rounded bg-dark
+        description: >-
+          Custom CSS class(es) to apply directly to the image element (e.g.,
+          `<img>`). The default classes apply common styling like responsiveness,
+          rounded corners, and a dark background.
+      alt:
+        type: string
+        default: centos-motif.png
+        description: >-
+          The alternative text for the image, crucial for accessibility and
+          SEO. This text is displayed when the image cannot be loaded.
+    required:
+      - image # Added a required field constraint for best practice
+additionalProperties: false

data/_data/base/backtotop_schema.yml

@@ -0,0 +1,53 @@
+title: Back to Top Component Configuration
+description: >-
+  Schema for configuring the 'Back to Top' scroll-assist component (addon). This
+  allows users to quickly return to the top of a long page.
+type: object
+properties:
+  with_backtotop:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the Back to Top component. Set to `true` (default)
+      to activate the scroll button; set to `false` to hide it. Configuration is
+      managed via the `with_backtotop_data` property when enabled.
+  with_backtotop_data:
+    type: object
+    description: >-
+      The configuration object for the Back to Top addon. This dictionary
+      contains settings for distribution and visual customization.
+    properties:
+      cdn:
+        type: string
+        default: "https://unpkg.com"
+        description: >-
+          The Content Delivery Network (CDN) base URL from which the Back
+          to Top addon's distribution files are sourced (e.g., `https://unpkg.com`).
+      version:
+        type: string
+        default: "7.2.1"
+        description: >-
+          Specifies the version of the Back to Top addon to load from the CDN
+          (e.g., `7.2.1`).
+      diameter:
+        type: string
+        default: "56"
+        description: >-
+          The diameter (size) of the circular Back to Top button, specified
+          as a string (e.g., `56` which likely represents pixels).
+      background_color:
+        type: string
+        default: "#A54C93"
+        description: >-
+          The background color of the Back to Top button. Value must be a
+          valid CSS color string, typically a hexadecimal code (e.g., `#A54C93`).
+      text_color:
+        type: string
+        default: "#ffffff"
+        description: >-
+          The color of the icon/text displayed inside the Back to Top button.
+          Value must be a valid CSS color string (e.g., `#ffffff`).
+    required:
+      - cdn
+      - version # Added required fields for best practice
+additionalProperties: false

data/_data/base/bits.yml

@@ -0,0 +1,96 @@
+---
+- name: Upstream card example 1
+  class: bg-primary bg-opacity-10 border border-primary-subtle mb-3 p-5 rounded
+  type: upstream
+  image: centos-symbol.svg
+  image_style: "height: 92px"
+  description: |
+    Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
+    convallis at efficitur in eros. Sagittis morbi scelerisque faucibus
+    conubia consectetur.
+  screenshot: base/screenshot-example-1600x1200.webp
+  finale: "Derivatives:"
+  actions:
+    - name: Action 1
+      icon: fa-solid fa-arrow-right
+      icon_position: end
+      link: "#"
+    - name: Action 2
+      icon: fa-solid fa-arrow-right
+      icon_position: start
+      link: "#"
+    - name: Action 3
+      icon: fa-solid fa-circle-info
+      link: "#"
+    - name: Action 4
+      link: "#"
+  index_page_name: See all
+  index_page_link: "#"
+  relationship:
+    - Downstream example 1-1
+    - Downstream example 1-2
+    - Downstream example 1-3
+    - Downstream example 1-4
+- name: Downstream example 1-1
+  type: downstream
+  description: |
+    Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
+    convallis at efficitur in eros. Sagittis morbi scelerisque faucibus
+  screenshot: base/screenshot-example-1600x1200.webp
+  image: centos-symbol.svg
+  actions:
+    - name: Action 1
+      icon: fa-solid fa-arrow-right
+      link: "#"
+      icon_position: end
+    - name: Action 2
+      icon: fa-solid fa-arrow-right
+      icon_position: start
+      link: "#"
+    - name: Action 3
+      icon: fa-solid fa-arrow-right
+      link: "#"
+    - name: Action 4
+      link: "#"
+  relationship:
+    - Upstream card example 1
+- name: Downstream example 1-2
+  icon: fa-solid fa-arrow-right
+  screenshot: base/screenshot-example-1600x1200.webp
+  type: downstream
+  description: |
+    Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
+    convallis at efficitur in eros. Sagittis morbi scelerisque faucibus
+  relationship:
+    - Upstream card example 1
+  actions:
+    - name: Action 1
+      icon: fa-solid fa-arrow-right
+      icon_position: end
+      link: "#"
+- name: Downstream example 1-3
+  screenshot: base/screenshot-example-1600x1200.webp
+  type: downstream
+  description: |
+    Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
+    convallis at efficitur in eros. Sagittis morbi scelerisque faucibus
+  relationship:
+    - Upstream card example 1
+  actions:
+    - name: Action 1
+      icon: fa-solid fa-arrow-right
+      icon_position: end
+      link: "#"
+- name: Downstream example 1-4
+  screenshot: base/screenshot-example-1600x1200.webp
+  type: downstream
+  description: |
+    Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
+    convallis at efficitur in eros. Sagittis morbi scelerisque faucibus
+  relationship:
+    - Upstream card example 1
+  actions:
+    - name: Action 1
+      icon: fa-solid fa-arrow-right
+      icon_position: start
+      link: "#"

data/_data/base/bits_schema.yml

@@ -0,0 +1,183 @@
+title: Bits Component Configuration
+description: >-
+  Schema for configuring the 'Bits' presentation component. This component is
+  designed to showcase related projects or derivatives, typically in an
+  Upstream/Downstream relationship.
+type: object
+properties:
+  with_bits:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the Bits component rendering. Set to `true` to display
+      the component; set to `false` (default) to skip rendering.
+  with_bits_data:
+    type: array
+    default: []
+    description: >-
+      An array of objects defining the custom data structure for all Bits. When
+      defined, this data overrides any values set in the component's default
+      configuration file.
+    items:
+      type: object
+      properties:
+        name:
+          type: string
+          default: ""
+          description: >-
+            The unique identifying name of the Bit (e.g., `CentOS-Stream`). This
+            value is often used to generate HTML element IDs and must contain
+            only alphanumeric characters, dashes (-), and underscores (_).
+          pattern: "^[a-zA-Z0-9_-]+$"
+        name_class:
+          type: string
+          default: ""
+          description: Custom Bootstrap classes applied to the HTML element containing the Bit's `name`.
+        icon:
+          type: string
+          default: ""
+          description: >-
+            The Font Awesome icon class to represent the Bit. Only freely
+            distributed Font Awesome icons are supported
+            (see: https://fontawesome.com/v7/search?ic=free&o=r).
+        icon_class:
+          type: string
+          default: ""
+          description: Custom Bootstrap classes applied to the Bit's `icon` element.
+        image:
+          type: string
+          default: ""
+          description: >-
+            The Bit's branding image file path, relative to the `/assets/img/`
+            directory (e.g., `logo.svg` for a file at `/assets/img/logo.svg`).
+        image_class:
+          type: string
+          default: ""
+          description: Custom Bootstrap classes applied directly to the Bit's branding `image` element.
+        image_style:
+          type: string
+          default: ""
+          description: >-
+            Custom CSS styles (e.g., `height: 100px;`) applied inline to the
+            Bit's branding `image` element to control presentation (e.g., height).
+        screenshot:
+          type: string
+          description: >-
+            The path to the main visual representation or screenshot of the Bit,
+            relative to the `/assets/img/` directory. The recommended image size is
+            1600x1200 pixels, but the ratio can be adjusted via height/ratio to
+            control vertical spacing between description and actions.
+          format: uri-reference
+        screenshot_class:
+          type: string
+          default: ""
+          description: Custom Bootstrap classes applied to the `screenshot` image element.
+        screenshot_style:
+          type: string
+          description: Custom CSS styles applied inline to the `screenshot` image element.
+        screenshot_alt:
+          type: string
+          default: ""
+          description: The alternative text for the `screenshot` image, for accessibility.
+        description:
+          type: string
+          description: A concise description of the Bit, typically one or two sentences long.
+        description_class:
+          type: string
+          default: ""
+          description: Custom Bootstrap classes applied to the Bit's `description` element.
+        type:
+          type: string
+          description: >-
+            Defines the role of the Bit in the component layout. `upstream` Bits
+            are main projects/products. `downstream` Bits are derivatives or
+            related projects, and must link back to an Upstream Bit via the
+            `relationship` property.
+          enum:
+            - upstream
+            - downstream
+        relationship:
+          type: array
+          description: >-
+            A list of Bit names that define the connection between Bits. For a
+            `downstream` Bit, this list should contain the `name` of its Upstream parent. For an `upstream` Bit, this list specifies its Downstream children. Direct relationships between Bits of the same type are not supported.
+          items:
+            type: string
+        actions:
+          type: array
+          default: []
+          description: >-
+            A list of configuration objects for Call-to-Action (CTA) buttons associated with the Bit presentation. Each item configures a link button
+            using the `base/link.html.liquid` template structure.
+          items:
+            type: object
+            description: Configuration object for a single action button (link). Refer to the `link` component documentation for specific properties.
+            additionalProperties: true # Changed to true as properties are defined externally
+        actions_class:
+          type: string
+          description: Custom Bootstrap classes applied to the container holding the list of `actions` buttons.
+        preamble:
+          type: string
+          default: "Bits produced upstream:"
+          description: >-
+            A descriptive message displayed before the Upstream Bits section.
+            Only relevant when `type` is set to `upstream`.
+        preamble_class:
+          type: string
+          default: mb-3
+          description: Custom Bootstrap classes applied to the `preamble` message element (default adds margin-bottom).
+        finale:
+          type: string
+          default: "Bits produced downstream:"
+          description: >-
+            A descriptive message displayed before the Downstream Bits section.
+            Only relevant when `type` is set to `upstream`.
+        finale_class:
+          type: string
+          default: mb-3
+          description: Custom Bootstrap classes applied to the `finale` message element (default adds margin-bottom).
+        class:
+          type: string
+          default: ""
+          description: >-
+            Custom Bootstrap classes applied to the main container of the
+            Upstream Bit layout. Use this to control padding, background, and element
+            alignment within the card, often in combination with the `color` property.
+        card_class:
+          type: string
+          default: "flex-column align-items-center text-center mb-3"
+          description: Custom Bootstrap classes applied directly to the card element inside the Upstream Bit container.
+        color:
+          type: string
+          default: primary
+          description: >-
+            The presentation color used for styling the Bit's elements (e.g., links,
+            borders). Possible values are any valid Bootstrap color utility classes (e.g., `primary`, `success`, `warning`).
+          enum:
+            - primary
+            - secondary
+            - warning
+            - success
+            - danger
+            - info
+            - light
+            - dark
+        index_page_name:
+          type: string
+          default: ""
+          description: The visible link text (e.g., `See all derivatives`) used to connect to the Downstream index page.
+        index_page_url:
+          type: string
+          description: >-
+            The URL path to the index page listing all Downstream resources related
+            to this Upstream Bit. For example, if the Upstream is at `/my-project/`,
+            this might be `/my-project/derivatives/`.
+          format: uri-reference
+      required:
+        - screenshot
+        - description
+        - type
+        - color
+        - name # Added name as it is critical for relationship
+      additionalProperties: false
+additionalProperties: false

data/_data/base/breadcrumb_schema.yml

@@ -0,0 +1,14 @@
+title: Breadcrumb Navigation Configuration
+description: >-
+  Schema for configuring the breadcrumb navigation component within the Jekyll theme.
+  Breadcrumbs provide a secondary navigation aid showing the user's location
+  within the site hierarchy.
+type: object
+properties:
+  with_breadcrumb:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the rendering of the breadcrumb navigation component.
+      Set to `true` (default) to display the breadcrumbs; set to `false` to hide them.
+additionalProperties: false

data/_data/base/breakingnews_schema.yml

@@ -0,0 +1,59 @@
+title: Breaking News Component Configuration
+description: >-
+  Schema for configuring the 'Breaking News' display component within the Jekyll theme.
+  This component is typically used to draw attention to urgent or critical updates.
+type: object
+properties:
+  with_breakingnews:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the Breaking News component. Set to `true` to
+      display the messages; set to `false` (default) to hide them. When enabled,
+      the `with_breakingnews_data` property must be provided.
+  with_breakingnews_data:
+    type: array
+    default: [] # Corrected: Moved default to array level and set to []
+    description: >-
+      An array of objects containing the configuration and messages for the
+      breaking news display. If multiple items are provided, they will be
+      presented in the order they appear in this list.
+    items:
+      type: object
+      properties:
+        content:
+          type: string
+          description: The main text content of the breaking news message. This field is required.
+        color:
+          type: string
+          default: primary
+          description: >-
+            Defines the visual style/severity of the message. Defaults to
+            `primary`. Available options are listed in the `enum`.
+          enum:
+            - primary
+            - secondary
+            - info
+            - warning
+            - danger
+            - success
+            - dark
+            - light
+        icon:
+          type: string
+          default: fa-solid fa-bullhorn
+          description: >-
+            The Font Awesome icon class displayed on the left side of the
+            message (e.g., `fa-solid fa-bell`). The default is `fa-solid fa-bullhorn`.
+            Note that the [Font Awesome theme addon](../../addons/fontawesome/) must be enabled for these icons to render.
+        link:
+          type: string
+          format: uri
+          description: >-
+            The URL pointing to a page or resource with detailed information
+            about the breaking news message.
+      required:
+        - content
+additionalProperties: false
+required:
+  - with_breakingnews