jekyll-theme-centos 0.0.0

data/_data/base/breakingnews_schema.yml

@@ -0,0 +1,67 @@
+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.
+  breakingnews_alert_height:
+    type: integer
+    default: 31
+    description: >-
+      Height in pixels of a single breaking news alert bar. Used by both the
+      breakingnews component and the head component to calculate sticky
+      positioning and scroll-margin-top offsets. Must match the rendered height
+      of `.breakingnews.alert.p-2`.
+  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

data/_data/base/card_schema.yml

@@ -0,0 +1,146 @@
+title: Card Component Configuration
+description: >-
+  Schema for configuring the card component. All parameters are passed
+  directly as include parameters when calling the component.
+type: object
+properties:
+  class:
+    type: string
+    default: "flex-column align-items-start mb-3"
+    description: >-
+      CSS classes applied to the outer card container `<div>`. Controls
+      layout direction and spacing (e.g., `flex-column align-items-start mb-3`).
+  color:
+    type: string
+    default: "primary"
+    description: >-
+      Bootstrap color scheme applied to the card. Used as the screenshot
+      background color and as the default button color suffix
+      (e.g., `primary`, `secondary`, `danger`).
+  image:
+    type: string
+    default: ""
+    description: >-
+      Filename of an image to display at the top of the card, relative to
+      `/assets/img/`. When empty, no image is rendered.
+  image_class:
+    type: string
+    default: "img-fluid mb-3 rounded"
+    description: >-
+      CSS classes applied to the image element (e.g., `img-fluid mb-3 rounded`).
+  image_style:
+    type: string
+    default: ""
+    description: >-
+      Inline CSS style string applied to the image element
+      (e.g., `max-height: 200px`). When empty, no inline style is added.
+  image_alt:
+    type: string
+    default: ""
+    description: >-
+      Alt text for the image. Defaults to the image filename when not set.
+  icon:
+    type: string
+    default: ""
+    description: >-
+      Font Awesome icon class to display in the card
+      (e.g., `fa-solid fa-star`). When empty, no icon is rendered.
+  icon_class:
+    type: string
+    default: "display-6 mb-3"
+    description: >-
+      CSS classes applied to the icon wrapper `<div>`
+      (e.g., `display-6 mb-3`).
+  name:
+    type: string
+    default: ""
+    description: >-
+      Title text displayed in the card. When empty, the name section is
+      not rendered.
+  name_class:
+    type: string
+    default: "display-5 fw-bold mb-3"
+    description: >-
+      CSS classes applied to the name wrapper `<div>`
+      (e.g., `display-5 fw-bold mb-3`).
+  screenshot:
+    type: string
+    default: ""
+    description: >-
+      Filename of a screenshot image shown inside a colored background box,
+      relative to `/assets/img/`. When empty, no screenshot is rendered.
+  screenshot_class:
+    type: string
+    default: "img-fluid"
+    description: >-
+      CSS classes applied to the screenshot image element
+      (e.g., `img-fluid`).
+  screenshot_style:
+    type: string
+    default: ""
+    description: >-
+      Inline CSS style string applied to the screenshot image element.
+      When empty, no inline style is added.
+  screenshot_alt:
+    type: string
+    default: ""
+    description: >-
+      Alt text for the screenshot image. Defaults to the screenshot
+      filename when not set.
+  description:
+    type: string
+    default: ""
+    description: >-
+      Body text displayed below the name. When empty, the description
+      section is not rendered.
+  description_class:
+    type: string
+    default: "mb-3"
+    description: >-
+      CSS classes applied to the description wrapper `<div>`
+      (e.g., `mb-3`).
+  actions:
+    type: array
+    default: ""
+    description: >-
+      List of action button definitions. Each item is rendered as a link
+      button using the `link` component. When empty or not provided, no
+      action buttons are rendered.
+    items:
+      type: object
+      properties:
+        name:
+          type: string
+          default: ""
+          description: Visible label text for the action button.
+        url:
+          type: string
+          default: ""
+          description: Target URL the action button links to.
+        icon:
+          type: string
+          default: ""
+          description: >-
+            Font Awesome icon class displayed alongside the button text
+            (e.g., `fa-solid fa-download`).
+        icon_position:
+          type: string
+          default: "start"
+          description: >-
+            Position of the icon relative to the button text. Use `start`
+            to place the icon before the text or `end` to place it after.
+      additionalProperties: false
+  actions_class:
+    type: string
+    default: ""
+    description: >-
+      CSS classes applied to the actions wrapper `<div>`. Use to align
+      or space the action buttons (e.g., `d-flex gap-2`).
+  actions_btn_class:
+    type: string
+    default: "btn m-1 btn-{color}"
+    description: >-
+      CSS classes applied to each action button. The `{color}` placeholder
+      is replaced at render time with the value of the `color` parameter
+      (e.g., `btn m-1 btn-primary`).
+additionalProperties: false