jekyll-theme-centos 2.52.0.beta.4 → 2.52.0.beta.6

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 component. 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/converter_link_schema.yml

@@ -0,0 +1,48 @@
+title: Converter Link Plugin Configuration
+description: >-
+  Schema for configuring the converter_link.rb Jekyll plugin, which
+  automatically applies standardized Bootstrap utility classes to link elements
+  generated from Markdown syntax, and manages external links with protective
+  attributes and icons.
+type: object
+properties:
+  enabled:
+    type: boolean
+    default: true
+    description: >-
+      Controls whether the plugin runs during Jekyll's build process.
+      Set to `true` (default) to apply link classes and external link features
+      automatically; set to `false` to disable automatic link styling and
+      use plain Markdown links. When disabled, the plugin logs:
+      "Disabled via configuration. Skipping custom link modification."
+      Useful for debugging or testing.
+  default_link_classes:
+    type: string
+    default: "link link-offset-3 link-offset-3-hover link-underline-primary link-underline-opacity-0 link-underline-opacity-100-hover"
+    description: >-
+      Bootstrap utility classes applied to all links outside of alert blocks.
+      Customize this to match your site's link styling preferences.
+      Each class is separated by spaces. The default creates an elegant hover
+      effect where the underline fades in as users interact with the link.
+      See [Bootstrap Link Utilities documentation](https://getbootstrap.com/docs/5.3/utilities/link/)
+      for class reference.
+  alert_link_classes:
+    type: string
+    default: "alert-link"
+    description: >-
+      Bootstrap classes applied to links within `.alert` paragraphs.
+      The `alert-link` class adapts link color to match the alert context
+      (primary, success, warning, danger, etc.). Supports multiple classes
+      separated by spaces. See [Bootstrap Alert Link Color documentation](https://getbootstrap.com/docs/5.3/components/alerts/#link-color)
+      for details.
+  external_link_icon:
+    type: boolean
+    default: true
+    description: >-
+      Controls whether external-link icons are added to cross-domain external
+      links. Set to `true` (default) to display Font Awesome external-link
+      icons (`fa-solid fa-external-link`) at the end of links pointing to
+      different domains. Set to `false` to disable external-link icon insertion.
+required:
+  - enabled
+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,34 @@
+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 note. Each item is configured
+          using the external `base/link.html.liquid` template structure.
+        items:
+          type: object
+          description: Configuration for a single legal text link. Refer to the link component's documentation for valid properties.
+          additionalProperties: true
+    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.5"
+        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-X4ObCG8fB8SK+9d3GgWfrrKjO7nk3Q2PrwyEKa4Nx78Su/v2xEBtCnJ9kRP+gHhi"
+        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-nhDlWXAURrLQOkCo8hXDhpFWZjzFzX/udlaGLd8PDMKvv67k6YMfex2pZjLU6o2U"
+        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,122 @@
+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.
+        summary:
+          type: string
+          default: ""
+          description: A brief summary or short description of the event.
+        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,49 @@
+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.
+    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/highlight_schema.yml

@@ -0,0 +1,68 @@
+title: Highlight.js Syntax Highlighting Configuration
+description: >-
+  Schema for configuring the external Highlight.js library addon, used to
+  provide dynamic syntax highlighting for code blocks within the content.
+  Includes customizable copy button icons for syntax-highlighted code blocks.
+type: object
+properties:
+  with_highlight:
+    type: boolean # CORRECTED: Changed from string to boolean
+    default: true
+    description: >-
+      Enables or disables the Highlight.js addon. Set to `true` (default)
+      to enable syntax highlighting; set to `false` to disable the addon entirely.
+  with_highlight_data:
+    type: object
+    description: >-
+      The configuration object defining the visual style (theme), version,
+      and custom icons for the Highlight.js library.
+    properties:
+      theme:
+        type: string
+        default: default
+        description: >-
+          The name of the specific CSS theme file to use for syntax colors
+          and styles (e.g., `stackoverflow-light`). This theme dictates the
+          visual appearance of the highlighted code.
+      version:
+        type: string
+        default: "11.11.1"
+        description: >-
+          The specific version of the Highlight.js library being loaded
+          (e.g., `11.11.1`).
+      copy_button_icons:
+        type: object
+        description: >-
+          Customizable SVG icons for the copy button in different states.
+          Icons are defined as SVG strings for use with CSS mask property.
+          The copy icon is required and displays in the normal button state.
+          The success icon is optional and displays after successful copy.
+        properties:
+          copy:
+            type: object
+            description: "Icon displayed in normal (copy) state. Primary customization point."
+            properties:
+              svg:
+                type: string
+                default: '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 640 640"><!--!Font Awesome Free v7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d="M480 400L288 400C279.2 400 272 392.8 272 384L272 128C272 119.2 279.2 112 288 112L421.5 112C425.7 112 429.8 113.7 432.8 116.7L491.3 175.2C494.3 178.2 496 182.3 496 186.5L496 384C496 392.8 488.8 400 480 400zM288 448L480 448C515.3 448 544 419.3 544 384L544 186.5C544 169.5 537.3 153.2 525.3 141.2L466.7 82.7C454.7 70.7 438.5 64 421.5 64L288 64C252.7 64 224 92.7 224 128L224 384C224 419.3 252.7 448 288 448zM160 192C124.7 192 96 220.7 96 256L96 512C96 547.3 124.7 576 160 576L352 576C387.3 576 416 547.3 416 512L416 496L368 496L368 512C368 520.8 360.8 528 352 528L160 528C151.2 528 144 520.8 144 512L144 256C144 247.2 151.2 240 160 240L176 240L176 192L160 192z"/></svg>'
+                description: "File icon as SVG (Font Awesome - for use with CSS mask property)"
+            required:
+              - svg
+            additionalProperties: false
+          success:
+            type: object
+            description: "Icon displayed after successful copy (in [data-copied='true'] state). Optional enhancement."
+            properties:
+              svg:
+                type: string
+                default: '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 640 640"><!--!Font Awesome Free v7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d="M530.8 134.1C545.1 144.5 548.3 164.5 537.9 178.8L281.9 530.8C276.4 538.4 267.9 543.1 258.5 543.9C249.1 544.7 240 541.2 233.4 534.6L105.4 406.6C92.9 394.1 92.9 373.8 105.4 361.3C117.9 348.8 138.2 348.8 150.7 361.3L252.2 462.8L486.2 141.1C496.6 126.8 516.6 123.6 530.9 134z"/></svg>'
+                description: "Checkmark icon as SVG in (Font Awesome - for use with CSS mask property) - shown after successful copy"
+            required:
+              - svg
+            additionalProperties: false
+        additionalProperties: false
+    required:
+      - theme
+      - version
+    additionalProperties: false
+additionalProperties: false

data/_data/base/languages.yml

@@ -0,0 +1,186 @@
+---
+#
+# Language codes (https://loc.gov/standards/iso639-2/ISO-639-2_utf-8.txt)
+#
+ab: "Abkhaz"
+aa: "Afar"
+af: "Afrikaans"
+ak: "Akan"
+sq: "Albanian"
+am: "Amharic"
+ar: "Arabic"
+an: "Aragonese"
+hy: "Armenian"
+as: "Assamese"
+av: "Avaric"
+ae: "Avestan"
+ay: "Aymara"
+az: "Azerbaijani"
+bm: "Bambara"
+ba: "Bashkir"
+eu: "Basque"
+be: "Belarusian"
+bn: "Bengali"
+bh: "Bihari"
+bi: "Bislama"
+bs: "Bosnian"
+br: "Breton"
+bg: "Bulgarian"
+my: "Burmese"
+ca: "Catalan; Valencian"
+ch: "Chamorro"
+ce: "Chechen"
+ny: "Chichewa; Chewa; Nyanja"
+zh: "Chinese"
+cv: "Chuvash"
+kw: "Cornish"
+co: "Corsican"
+cr: "Cree"
+hr: "Croatian"
+cs: "Czech"
+da: "Danish"
+dv: "Divehi; Dhivehi; Maldivian;"
+nl: "Dutch"
+en: "English"
+eo: "Esperanto"
+et: "Estonian"
+ee: "Ewe"
+fo: "Faroese"
+fj: "Fijian"
+fi: "Finnish"
+fr: "French"
+ff: "Fula; Fulah; Pulaar; Pular"
+gl: "Galician"
+ka: "Georgian"
+de: "German"
+el: "Greek"
+gn: "Guaraní"
+gu: "Gujarati"
+ht: "Haitian; Haitian Creole"
+ha: "Hausa"
+he: "Hebrew (modern)"
+hz: "Herero"
+hi: "Hindi"
+ho: "Hiri Motu"
+hu: "Hungarian"
+ia: "Interlingua"
+id: "Indonesian"
+ie: "Interlingue"
+ga: "Irish"
+ig: "Igbo"
+ik: "Inupiaq"
+io: "Ido"
+is: "Icelandic"
+it: "Italian"
+iu: "Inuktitut"
+ja: "Japanese"
+jv: "Javanese"
+kl: "Kalaallisut"
+kn: "Kannada"
+kr: "Kanuri"
+ks: "Kashmiri"
+kk: "Kazakh"
+km: "Khmer"
+ki: "Kikuyu"
+rw: "Kinyarwanda"
+ky: "Kirghiz"
+kv: "Komi"
+kg: "Kongo"
+ko: "Korean"
+ku: "Kurdish"
+kj: "Kwanyama"
+la: "Latin"
+lb: "Luxembourgish"
+lg: "Luganda"
+li: "Limburgish"
+ln: "Lingala"
+lo: "Lao"
+lt: "Lithuanian"
+lu: "Luba-Katanga"
+lv: "Latvian"
+gv: "Manx"
+mk: "Macedonian"
+mg: "Malagasy"
+ms: "Malay"
+ml: "Malayalam"
+mt: "Maltese"
+mi: "Māori"
+mr: "Marathi (Marāṭhī)"
+mh: "Marshallese"
+mn: "Mongolian"
+na: "Nauru"
+nv: "Navajo"
+nb: "Norwegian Bokmål"
+nd: "North Ndebele"
+ne: "Nepali"
+ng: "Ndonga"
+nn: "Norwegian Nynorsk"
+no: "Norwegian"
+ii: "Nuosu"
+nr: "South Ndebele"
+oc: "Occitan"
+oj: "Ojibwe"
+cu: "Old Church Slavonic"
+om: "Oromo"
+or: "Oriya"
+os: "Ossetian"
+pa: "Panjabi"
+pi: "Pāli"
+fa: "Persian"
+pl: "Polish"
+ps: "Pashto"
+pt: "Portuguese"
+qu: "Quechua"
+rm: "Romansh"
+rn: "Kirundi"
+ro: "Romanian"
+ru: "Russian"
+sa: "Sanskrit"
+sc: "Sardinian"
+sd: "Sindhi"
+se: "Northern Sami"
+sm: "Samoan"
+sg: "Sango"
+sr: "Serbian"
+gd: "Gaelic"
+sn: "Shona"
+si: "Sinhala"
+sk: "Slovak"
+sl: "Slovene"
+so: "Somali"
+st: "Southern Sotho"
+es: "Spanish"
+su: "Sundanese"
+sw: "Swahili"
+ss: "Swati"
+sv: "Swedish"
+ta: "Tamil"
+te: "Telugu"
+tg: "Tajik"
+th: "Thai"
+ti: "Tigrinya"
+bo: "Tibetan"
+tk: "Turkmen"
+tl: "Tagalog"
+tn: "Tswana"
+to: "Tonga"
+tr: "Turkish"
+ts: "Tsonga"
+tt: "Tatar"
+tw: "Twi"
+ty: "Tahitian"
+ug: "Uighur"
+uk: "Ukrainian"
+ur: "Urdu"
+uz: "Uzbek"
+ve: "Venda"
+vi: "Vietnamese"
+vo: "Volapük"
+wa: "Walloon"
+cy: "Welsh"
+wo: "Wolof"
+fy: "Western Frisian"
+xh: "Xhosa"
+yi: "Yiddish"
+yo: "Yoruba"
+za: "Zhuang"