jekyll-theme-centos 0.0.0

data/_data/base/configuration_variables_schema.yml

@@ -0,0 +1,42 @@
+title: Configuration Variables Component Configuration
+description: >-
+  Include parameters for the 'configuration_variables' component. All parameters
+  are optional and apply to both the top-level table and all recursively
+  generated nested tables.
+type: object
+properties:
+  schema:
+    type: object
+    description: >-
+      A schema object passed directly as a parameter. Overrides automatic schema
+      resolution from `site.data` and `site.data.base`. Use this when the schema
+      is stored under a non-standard data key or namespace.
+  columns:
+    type: array
+    description: >-
+      Array of `{ key, label }` objects defining which schema fields to render as
+      columns. When set, overrides the `col_type`, `col_default`, and
+      `col_description` parameters. Can also be declared in the `*_schema.yml`
+      file itself.
+  col_name:
+    type: string
+    default: Name
+    description: >-
+      Label for the variable name column. Always rendered as the first column,
+      regardless of whether `columns` is set.
+  col_type:
+    type: string
+    default: Type
+    description: >-
+      Label for the type column. Used only when `columns` is not set.
+  col_default:
+    type: string
+    default: Default
+    description: >-
+      Label for the default column. Used only when `columns` is not set.
+  col_description:
+    type: string
+    default: Description
+    description: >-
+      Label for the description column. Used only when `columns` is not set.
+additionalProperties: false

data/_data/base/content.yml

@@ -0,0 +1,2 @@
+---
+class: col

data/_data/base/content_schema.yml

@@ -0,0 +1,26 @@
+title: Content Section Configuration
+description: >-
+  Schema for configuring the main content display partial. This controls the
+  rendering and layout of the primary content area on a page.
+type: object
+properties:
+  with_content:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the rendering of the content section. Set to `true`
+      (default) to display the content area; set to `false` to hide it entirely.
+  with_content_data:
+    type: object
+    description: >-
+      Configuration object for customizing the presentation and layout of the
+      rendered content section.
+    properties:
+      class:
+        type: string
+        default: col
+        description: >-
+          A Bootstrap column class used to control the width and responsiveness of the content section container (e.g., `col`, `col-md-10`, `col-lg-8`).
+          This dictates the column size within the grid system.
+    additionalProperties: false # Added to restrict unexpected properties in the data object
+additionalProperties: false

data/_data/base/copyright.yml

@@ -0,0 +1,12 @@
+---
+#
+# site.data.base.copyright - Control copyright information and legal links.
+#
+author: "The CentOS Project"
+legals:
+  - name: "Legal"
+    link: "https://www.centos.org/legal"
+  - name: "Privacy"
+    link: "https://www.centos.org/legal/privacy"
+  - name: "Site source"
+    link: "https://gitlab.com/CentOS/promo/centos.org"

data/_data/base/copyright_schema.yml

@@ -0,0 +1,74 @@
+title: Copyright Component Configuration
+description: >-
+  Schema for configuring the display and content of the site's copyright notice,
+  typically rendered in the footer.
+type: object
+properties:
+  with_copyright:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the rendering of the copyright notice. Set to `true`
+      to display the copyright; set to `false` (default) to hide it.
+  with_copyright_data:
+    type: object
+    description: >-
+      The configuration object containing the content and legal links for the
+      copyright note.
+    properties:
+      author:
+        type: string
+        default: The CentOS Project
+        description: >-
+          The name of the site creator, owner, or organization that holds the copyright (e.g., `The CentOS Project`).
+      legals:
+        type: array
+        description: >-
+          A list of objects defining legal links (e.g., Privacy Policy, Terms of Use) to be displayed alongside the copyright notice.
+        items:
+          type: object
+          description: Configuration for a single legal link rendered using the `base/link.html.liquid` template.
+          properties:
+            name:
+              type: string
+              description: >-
+                The display text for the legal link (e.g., `Privacy Policy`).
+            link:
+              type: string
+              description: >-
+                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
+              description: >-
+                The Bootstrap link color scheme (e.g., `light`, `primary`). Has no
+                effect when `class` is also set, because the Copyright component
+                supplies a default `class` that takes precedence.
+            icon:
+              type: string
+              description: >-
+                Font Awesome icon class to display alongside the link text
+                (e.g., `fa-solid fa-file-lines`).
+            icon_position:
+              type: string
+              enum: [start, end]
+              default: start
+              description: >-
+                Position of the icon relative to the link text. Set to `start`
+                (default) to place the icon before the text, or `end` to place
+                it after.
+            role:
+              type: string
+              description: >-
+                ARIA `role` attribute for the anchor element
+                (e.g., `menuitem`).
+            class:
+              type: string
+              description: >-
+                Custom CSS classes applied to the anchor element. When set,
+                overrides the default legal link styling entirely.
+          required:
+            - name
+    additionalProperties: false
+additionalProperties: false

data/_data/base/copyvalue_schema.yml

@@ -0,0 +1,49 @@
+title: Copy Value Component Configuration
+description: >-
+  Schema for configuring the 'Copy Value' component. This utility component
+  provides a reusable copy-to-clipboard functionality with visual feedback,
+  supporting SVG icon transformation and tooltip updates.
+type: object
+properties:
+  with_copyvalue:
+    type: boolean
+    default: true
+    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.
+  with_copyvalue_data:
+    type: object
+    description: >-
+      The configuration object for the Copy Value component. This dictionary
+      contains settings for behavior and visual customization.
+    properties:
+      reset_delay:
+        type: integer
+        default: 2000
+        description: >-
+          The delay in milliseconds before reverting the icon and tooltip
+          to their original state after a successful copy. Default is 2000ms
+          (2 seconds).
+      checkmark_path:
+        type: string
+        default: "M434.8 70.1c14.3 10.4 17.5 30.4 7.1 44.7l-256 352c-5.5 7.6-14 12.3-23.4 13.1s-18.5-2.7-25.1-9.3l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l101.5 101.5 234-321.7c10.4-14.3 30.4-17.5 44.7-7.1z"
+        description: >-
+          The SVG path data for the checkmark icon displayed after copying.
+          This is the d attribute of the checkmark path element in FontAwesome
+          fa-check icon. Can be customized for different visual styles.
+      checkmark_viewbox:
+        type: string
+        default: "0 0 448 512"
+        description: >-
+          The viewBox attribute for the checkmark SVG. Defines the coordinate
+          system for the checkmark icon path.
+      success_message:
+        type: string
+        default: "Copied!"
+        description: >-
+          The tooltip message displayed after successful copy. Customize to
+          match your site's language or messaging preferences.
+    required:
+      - reset_delay
+additionalProperties: false

data/_data/base/datatable_schema.yml

@@ -0,0 +1,57 @@
+title: DataTables.js Addon Configuration
+description: >-
+  Schema for configuring the external DataTables.js library addon, used to add
+  advanced interaction controls (sorting, searching, pagination) to HTML tables.
+type: object
+properties:
+  with_datatable:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the DataTables addon. Set to `true` (default) to
+      load the necessary CSS and JavaScript files; set to `false` to disable.
+  with_datatable_data:
+    type: object
+    description: >-
+      The configuration object containing version, integrity checks, and default
+      behavior settings for DataTables.js.
+    properties:
+      version:
+        type: string
+        default: "v/bs5/jq-3.7.0/dt-2.3.8"
+        description: >-
+          The specific version and dependencies string for the compressed
+          and minified DataTables distribution (e.g., `v/bs5/jq-3.7.0/dt-2.3.5`).
+          This value is sourced from the DataTables [download page](https://datatables.net/download/).
+      css_integrity:
+        type: string
+        default: "sha384-nD9P196GmYuiIASpxI7+7/0LqD6BBA74CfgIOSQUo7brmKKeph8lSEMm2sGgSAvK"
+        description: >-
+          The Subresource Integrity (SRI) CSS checksum (`sha384-...`) for the
+          specific DataTables version used. This is essential for ensuring the integrity
+          of the loaded CSS resource.
+      script_integrity:
+        type: string
+        default: "sha384-pszF7QvU8ChuuhQBJGIvzVEcojfpYqQOVG2PaXES4M4Mcn+1CqfQ4r1b/mpdtn/6"
+        description: >-
+          The Subresource Integrity (SRI) JavaScript checksum (`sha384-...`)
+          for the specific DataTables version used. This ensures the integrity of
+          the loaded JavaScript file.
+      page_length:
+        type: integer # SUGGESTION: Changed from string to integer for strict validation
+        default: 10
+        description: >-
+          The default number of entries (rows) to display per page initially.
+          Users can dynamically change this value using the length menu control.
+      length_menu:
+        type: string # Kept as string to preserve comma-separated input ease
+        default: "10,25,50,75"
+        description: >-
+          A comma-separated list of numbers defining the options available
+          in the "Show X entries" dropdown menu (e.g., `10,25,50,75`).
+    required:
+      - version
+      - css_integrity
+      - script_integrity # Added integrity checks and version as required for security/functionality
+    additionalProperties: false
+additionalProperties: false

data/_data/base/event_schema.yml

@@ -0,0 +1,130 @@
+title: Event Component Configuration
+description: >-
+  Schema for configuring the 'Event' presentation component. This component
+  displays one or more upcoming events, often as alerts, providing links for
+  more details.
+type: object
+properties:
+  with_event:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the rendering of the Event component. Set to `true`
+      to display the event list; set to `false` (default) to hide it.
+  with_event_data:
+    type: array
+    default: []
+    description: >-
+      An array of objects (dictionaries) defining the configuration and content
+      for each event to be presented. Events are displayed in the order they
+      appear in this list.
+    items:
+      type: object
+      properties:
+        title:
+          type: string
+          description: The name or title of the event. This field is required.
+        description:
+          type: string
+          default: ""
+          description: A brief description of the event.
+        address:
+          type: string
+          default: ""
+          description: The street address of the event venue.
+        city:
+          type: string
+          default: ""
+          description: The city where the event takes place.
+        date:
+          type: string # Changed from 'date' to 'string' for flexibility
+          default: ""
+          description: >-
+            The event start and end date range as a readable string (e.g.,
+            `September 19 - 20, 2025`).
+        location:
+          type: string
+          default: ""
+          description: The city and country where the event takes place (e.g., `Boston, USA`).
+        image_url:
+          type: string
+          format: uri
+          default: ""
+          description: The absolute or relative URL of an image related to the event (e.g., a banner or logo).
+        color:
+          type: string
+          default: secondary
+          description: >-
+            Defines the visual style/color of the event alert. Defaults to
+            `secondary`. Possible values are standard Bootstrap color utility classes.
+          enum:
+            - primary
+            - secondary
+            - info
+            - warning
+            - danger
+            - success
+            - dark
+            - light
+        icon:
+          type: string
+          default: "fa-solid fa-calendar"
+          description: >-
+            The Font Awesome icon class displayed on the event alert
+            (e.g., `fa-solid fa-calendar`). The Font Awesome addon must be
+            enabled for icons to render.
+        link:
+          type: string
+          format: uri-reference
+          default: ""
+          description: >-
+            The URL (relative or absolute) that the "Know more" button
+            will link to, providing additional details about the event.
+        presentations:
+          type: array
+          description: A list of objects detailing the individual talks or sessions associated with this event.
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+                description: The title of the presentation or talk.
+              summary:
+                type: string
+                description: A concise summary or abstract describing what the presentation is about.
+              author:
+                type: string
+                description: The name of the person who created or is delivering the presentation.
+              author_email:
+                type: string
+                format: email
+                description: The author's email address.
+              author_webiste:
+                type: string
+                format: uri
+                description: The author's website or profile URL.
+              date:
+                type: string
+                format: date-time
+                description: The presentation date and time (e.g., ISO 8601 format).
+              slides_url:
+                type: string
+                format: uri
+                description: The URL to the presentation slides (e.g., PDF or Google Slides link).
+              video_url:
+                type: string
+                format: uri
+                description: The URL to the presentation video recording.
+              information_url:
+                type: string
+                format: uri
+                description: A general URL for more information about the presentation.
+            required:
+              - name
+              - author
+            additionalProperties: false
+      required:
+        - title
+        - link
+      additionalProperties: false
+additionalProperties: false

data/_data/base/fontawesome_schema.yml

@@ -0,0 +1,62 @@
+title: Font Awesome Icon Library Configuration
+description: >-
+  Schema for configuring the external Font Awesome icon library addon, used to
+  display scalable vector icons throughout the theme.
+type: object
+properties:
+  with_fontawesome:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the loading of the Font Awesome library. Set to
+      `true` (default) to enable icons; set to `false` to disable the addon.
+  with_fontawesome_data:
+    type: object
+    description: >-
+      The configuration object defining the source, version, and security details
+      for loading the Font Awesome assets.
+    properties:
+      version:
+        type: string
+        default: "7.0.1"
+        description: The specific version of the Font Awesome distribution files to be loaded (e.g., `7.0.1`).
+      cdn:
+        type: string
+        default: "https://cdnjs.cloudflare.com/ajax/libs/font-awesome"
+        description: The base Content Delivery Network (CDN) address from which Font Awesome files will be downloaded.
+      css_bundle_name:
+        type: string
+        default: "all"
+        description: The name of the CSS bundle file to include (e.g., `all` loads all styles).
+      css_bundle_integrity:
+        type: string
+        default: "sha512-2SwdPD6INVrV/lHTZbO2nodKhrnDdJK9/kg2XD1r9uGqPo1cUbujc+IYdlYdEErWNu69gVcYgdxlmVmzTWnetw=="
+        description: The Subresource Integrity (SRI) CSS checksum (`sha512-...`) for the specified bundle, ensuring the security and integrity of the stylesheet file.
+      js_bundle_name:
+        type: string
+        default: "all"
+        description: The name of the JavaScript bundle file to include (e.g., `all` loads all JS functionality).
+      js_bundle_integrity:
+        type: string
+        default: "sha512-6BTOlkauINO65nLhXhthZMtepgJSghyimIalb+crKRPhvhmsCdnIuGcVbR5/aQY2A+260iC1OPy1oCdB6pSSwQ=="
+        description: The Subresource Integrity (SRI) JavaScript checksum (`sha512-...`) for the specified bundle, ensuring the security and integrity of the script file.
+      mode:
+        type: string
+        enum:
+          - "svg+js"
+          - "css"
+        default: "css"
+        description: >-
+          Loading mode for Font Awesome. `css` (default) downloads a stylesheet and
+          loads WOFF2 font files on demand — lighter first-visit payload and no DOM
+          manipulation cost. `svg+js` downloads a JavaScript bundle that replaces
+          `<i class="fa-...">` elements with inline SVGs via DOM mutation — enables
+          power transforms, layering, and pseudo-element watching. Use `svg+js` when
+          advanced transform, layering, or pseudo-element features are needed.
+    required:
+      - version
+      - cdn
+      - css_bundle_integrity
+      - js_bundle_integrity # Integrity checks and source are required for secure and functional loading
+    additionalProperties: false
+additionalProperties: false

data/_data/base/footer.yml

@@ -0,0 +1,9 @@
+---
+#
+# site.data.base.footer - Control footer branding.
+#
+brand_image: "centos-whitelogo.svg"
+brand_image_class: ""
+brand_image_height: "32"
+brand_manifestation: jekyll-theme-centos
+brand_manifestation_class: ""

data/_data/base/footer_schema.yml

@@ -0,0 +1,55 @@
+title: Footer Component Configuration
+description: >-
+  Schema for configuring the Footer component, which renders the site's
+  bottom section including brand identity, shortcuts, locales, social links,
+  and copyright information.
+type: object
+properties:
+  with_footer:
+    type: boolean
+    default: false
+    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.
+  with_footer_data:
+    type: object
+    default: {}
+    description: >-
+      The page-level configuration object for the Footer component. Settings
+      defined here (in the page's front matter) override any global `footer`
+      data defined in site-wide `_data` files.
+    properties:
+      brand_image:
+        type: string
+        default: "centos-whitelogo.svg"
+        description: >-
+          The filename of the brand logo or image to display in the footer.
+          This file is expected to be located in your site's image assets
+          directory.
+      brand_image_class:
+        type: string
+        default: ""
+        description: >-
+          One or more Bootstrap CSS classes to apply directly to the brand
+          image element (`<img>`).
+      brand_image_height:
+        type: string
+        default: "32"
+        description: >-
+          The desired fixed height for the brand image, specified in pixels
+          as a string (e.g., `"32"`).
+      brand_manifestation:
+        type: string
+        default: ""
+        description: >-
+          The text label or name (e.g., project name) that is displayed
+          alongside the brand image in the footer.
+      brand_manifestation_class:
+        type: string
+        default: ""
+        description: >-
+          One or more Bootstrap CSS classes to apply to the brand
+          manifestation text element.
+    additionalProperties: false
+additionalProperties: false

data/_data/base/head_schema.yml

@@ -0,0 +1,19 @@
+title: Head Component Configuration
+description: >-
+  Schema for the head component. The head component is a layout coordinator
+  that assembles the HTML <head> section by conditionally including
+  sub-components (OGP, Font Awesome, Highlight.js, DataTables, Breaking News,
+  Back to Top, Copy Value, Heading Anchor). Each sub-component is configured
+  through its own schema. Only properties exclusive to the head component
+  itself are defined here.
+type: object
+properties:
+  theme_color:
+    type: string
+    default: "#A54C93"
+    description: >-
+      Browser chrome color for mobile browsers (Chrome on Android, Safari on iOS).
+      Used by the `<meta name="theme-color">` tag. Should match `theme_color`
+      in the site's `site.webmanifest`. Resolved from `page.theme_color` first,
+      then `site.theme_color`, then this default.
+additionalProperties: false

data/_data/base/heading_anchor.yml

@@ -0,0 +1,2 @@
+---
+icon: "fa-solid fa-hashtag"

data/_data/base/heading_anchor_schema.yml

@@ -0,0 +1,37 @@
+---
+title: Heading Anchor Component Configuration
+description: >
+  Configuration for the first-class heading anchor feature of jekyll-link-decorator.
+  Each heading (h1–h6) receives a Font Awesome link icon that, when clicked, copies
+  the full page URL with fragment to the clipboard.
+type: object
+properties:
+  with_heading_anchor:
+    type: boolean
+    description: Enable or disable automatic heading anchor injection.
+    default: true
+  with_heading_anchor_data:
+    type: object
+    description: Configuration for heading anchor appearance and copy behaviour.
+    properties:
+      icon:
+        type: string
+        description: Font Awesome icon classes applied to the anchor icon element.
+        default: "fa-solid fa-hashtag"
+      icon_size:
+        type: string
+        description: Font Awesome size modifier appended after the icon classes.
+      copy_success_message:
+        type: string
+        description: >
+          Feedback message shown after a successful clipboard copy.
+          Consumed by heading-anchor.js via data-success-message on the script element.
+        default: "Copied!"
+      reset_delay:
+        type: integer
+        description: >
+          Milliseconds to wait before the icon resets to its original state
+          after a successful copy. Consumed by heading-anchor.js via data-reset-delay.
+        default: 2000
+    additionalProperties: false
+additionalProperties: false