jekyll-theme-centos 0.0.0

data/_data/base/highlight_schema.yml

@@ -0,0 +1,98 @@
+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`).
+      css_integrity:
+        type: string
+        default: "sha384-4Y0nObtF3CbKnh+lpzmAVdAMtQXl+ganWiiv73RcGVdRdfVIya8Cao1C8ZsVRRDz"
+        description: >-
+          SRI hash for the Highlight.js theme CSS loaded from cdnjs. Must be
+          updated when `version` or `theme` changes.
+      script_integrity:
+        type: string
+        default: "sha384-RH2xi4eIQ/gjtbs9fUXM68sLSi99C7ZWBRX1vDrVv6GQXRibxXLbwO2NGZB74MbU"
+        description: >-
+          Subresource Integrity (SRI) hash for the Highlight.js script loaded
+          from cdnjs. Must be updated when `version` changes.
+      copy_version:
+        type: string
+        default: "1.0.6"
+        description: >-
+          Version of the highlightjs-copy plugin loaded from unpkg
+          (e.g., `1.0.6`).
+      copy_script_integrity:
+        type: string
+        default: "sha384-0/jh9+ifwJ5mqtDZ+DWdwgFjZ8I4HIfXqaWJi2mdeAwy8aUPlw5dTYNsqAqNE4yD"
+        description: >-
+          SRI hash for the highlightjs-copy plugin script. Must be updated
+          when `copy_version` changes.
+      copy_css_integrity:
+        type: string
+        default: "sha384-jx4j2QNE8PcYHQikjfTfY6TM0sYVodTr0OGqUfAR6bKYJBgW91lTieqkghTu9+Kk"
+        description: >-
+          SRI hash for the highlightjs-copy plugin stylesheet. Must be updated
+          when `copy_version` changes.
+      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/image_schema.yml

@@ -0,0 +1,34 @@
+title: Image Component Configuration
+description: >-
+  Schema for configuring the image component. Parameters are passed directly
+  as include parameters. The `file` and `alt` parameters are required.
+type: object
+properties:
+  file:
+    type: string
+    description: >-
+      Filename of the image to display, relative to `/assets/img/`.
+      This parameter is required.
+  alt:
+    type: string
+    description: >-
+      Alt text describing the image for accessibility. This parameter is
+      required. Also used as the basis for the generated `id` attribute
+      on the `<figure>` element (slugified).
+  link:
+    type: string
+    description: >-
+      URL to wrap the image in a hyperlink (`<a>` element). When not set,
+      the image is rendered without a link.
+  caption:
+    type: string
+    description: >-
+      Caption text rendered inside a `<figcaption>` element below the
+      image. When not set, no caption is rendered.
+  extraclasses:
+    type: string
+    description: >-
+      Additional CSS classes appended to the image element alongside the
+      default `figure-img img-fluid rounded` classes. When not set, only
+      the default classes apply.
+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"

data/_data/base/link_schema.yml

@@ -0,0 +1,187 @@
+title: Link Component Configuration
+description: >-
+  Schema for defining and configuring a single link element. This component is
+  often reused by other components to define buttons or navigation items.
+type: object
+properties:
+  with_link:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the rendering of the Link component. Set to `true`
+      (default) to display the link; set to `false` to suppress rendering.
+      This is a page-level front matter variable read as `page.with_link` by
+      the template. It is set globally via `_config.yml` defaults and can be
+      overridden per page.
+  with_link_data:
+    type: object
+    default: {}
+    description: >-
+      The configuration object containing all attributes necessary to render and
+      style the link element (`<a>`). Requires either `name` (for text or icon+text links)
+      or `icon` with `aria_label` (for icon-only links). The `link` parameter is optional —
+      if omitted, an anchor link is automatically generated from `name` for in-page navigation.
+    properties:
+      name:
+        type: string
+        default: ""
+        description: The visible text or label of the link. This field is required unless `icon` is provided for icon-only links.
+      link:
+        type: string
+        default: ""
+        description: >-
+          The target URL the link points to. This can be a relative path (prefixed by site URL settings), a path using `../` (e.g., `../some-page`),
+          or an absolute URL (e.g., `https://example.com`). If omitted, an
+          anchor link is generated from the `name` parameter by converting to lowercase,
+          replacing spaces with hyphens, and removing the characters `"`, `'`, `?`, `&`, `#`, and `/`
+          (e.g., "Back to Top" becomes "#back-to-top"), enabling in-page navigation to section headings.
+        format: uri-reference
+      target:
+        type: string
+        default: ""
+        description: >-
+          The link target behavior. Set to `_blank` to open the link in a new window or tab.
+          When set to `_blank`, the component automatically adds `rel="noopener noreferrer"`
+          for security. The `jekyll-link-decorator` plugin independently adds an external-link
+          icon to cross-domain links regardless of this setting.
+        enum:
+          - ""
+          - _blank
+      class:
+        type: string
+        default: ""
+        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
+          applies: `link link-{color} link-offset-3 link-offset-3-hover
+          link-underline-{color} link-underline-opacity-0 link-underline-opacity-100-hover`.
+      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.
+      aria_label:
+        type: string
+        default: ""
+        description: >-
+          The ARIA label providing a concise, accessible description of the link's
+          purpose. Required when `name` is omitted (icon-only links): without it,
+          the link has no accessible name and screen readers cannot describe its
+          purpose. For text+icon links, `aria_label` is not required — all `<i>`
+          icon elements are automatically rendered with `aria-hidden="true"` so
+          screen readers rely on the visible `name` text only.
+      color:
+        type: string
+        default: primary
+        description: >-
+          The visual color of the link text. Possible values are standard
+          Bootstrap color utility classes (e.g., `primary`, `danger`, `dark`).
+        enum:
+          - primary
+          - secondary
+          - success
+          - info
+          - warning
+          - danger
+          - light
+          - dark
+      icon:
+        type: string
+        default: ""
+        description: >-
+          The Font Awesome icon class (e.g., `fa-solid fa-download`) to display
+          within the link. When provided, this icon is used instead of any icon
+          the `jekyll-link-decorator` plugin would otherwise add to external links.
+      icon_position:
+        type: string
+        default: start
+        description: >-
+          The position of the icon relative to the link text. Choose `start`
+          (default) for the icon before the text, or `end` for the icon
+          after the text. This parameter applies only when `name` is also set.
+          For icon-only links (when `name` is not provided), `icon_position` has
+          no effect and no spacing margin is applied.
+        enum:
+          - start
+          - end
+      data_bs_toggle:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-toggle` attribute. Set to `tooltip` or `popover`
+          to enable the corresponding Bootstrap interactive component on the link element.
+        enum:
+          - ""
+          - tooltip
+          - popover
+      data_bs_title:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-title` attribute. For tooltips, provides the tooltip
+          text. For popovers, provides the optional header displayed above the body.
+          Use `data_bs_content` to provide the popover body text.
+      data_bs_content:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-content` attribute. Provides the body text displayed
+          inside a Bootstrap popover. Required when `data_bs_toggle` is set to `popover`;
+          Bootstrap suppresses the popover if this value is empty.
+      data_bs_placement:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-placement` attribute. Controls where the tooltip or
+          popover appears relative to the link element.
+        enum:
+          - ""
+          - top
+          - bottom
+          - start
+          - end
+      data_bs_trigger:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-trigger` attribute. Controls how the tooltip or popover
+          is shown and dismissed. Tooltips default to `"hover focus"`; popovers default
+          to `"click"`. Use `"click focus"` to allow dismissal by clicking away or
+          tabbing away.
+      data_bs_delay:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-delay` attribute. Sets the show and hide delay in
+          milliseconds. Accepts a number (e.g., `"500"`) or a JSON object for separate
+          delays (e.g., `'{"show":500,"hide":100}'`). Applies to both tooltips and
+          popovers.
+      data_bs_html:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-html` attribute. Set to `"true"` to allow HTML in the
+          tooltip or popover content. Use only with trusted content; never use with
+          user-supplied input. Defaults to `"false"` (plain text).
+        enum:
+          - ""
+          - "true"
+          - "false"
+      data_bs_custom_class:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-custom-class` attribute. Adds one or more custom CSS
+          classes to the tooltip or popover element, enabling targeted styling overrides.
+      data_bs_offset:
+        type: string
+        default: ""
+        description: >-
+          The Bootstrap `data-bs-offset` attribute. Offsets the tooltip or popover
+          position from its target. Accepts a comma-separated pair of values
+          (e.g., `"0,8"` shifts 8 px along the main axis).
+    additionalProperties: false
+additionalProperties: false

data/_data/base/locales_schema.yml

@@ -0,0 +1,158 @@
+title: Language Selector Component Configuration
+description: >-
+  Schema for configuring the 'Language Selector' component, which allows users
+  to switch between different localized versions of the content.
+type: object
+properties:
+  with_locales:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the Language Selector component. Set to `true` to
+      display the selector and initiate the content localization process. Set
+      to `false` (default) to hide the selector.
+  with_locales_data:
+    type: object
+    default: {}
+    description: >-
+      Configuration object for the Language Selector component and the
+      jekyll-l10n localization pipeline. Accessed in templates as
+      `page.with_locales_data`.
+    properties:
+      locales:
+        type: array
+        default: []
+        description: >-
+          List of ISO 639-1 language codes for which localized pages are
+          generated (e.g., `["es", "fr", "it"]`). English (`en`) is always
+          included automatically by the template and does not need to be listed
+          here.
+        items:
+          type: string
+          description: A single ISO 639-1 language code (e.g., `es` for Spanish).
+        minItems: 0
+      locales_dir:
+        type: string
+        default: "_locales"
+        description: >-
+          Directory (relative to the site root) where `.po` translation files
+          are stored. Defaults to `_locales`.
+      extract_on_build:
+        type: boolean
+        default: true
+        description: >-
+          When `true`, the jekyll-l10n plugin extracts translatable strings
+          from the generated HTML during the build phase and writes them to
+          the `.po` source files in `locales_dir`.
+      update_compendium:
+        type: boolean
+        default: true
+        description: >-
+          When `true`, the plugin updates the translation compendium file
+          with newly extracted strings.
+      extraction:
+        type: object
+        description: Controls which HTML content is extracted for translation.
+        properties:
+          translatable_attributes:
+            type: array
+            default: [title, alt, aria-label, placeholder, aria-description]
+            description: >-
+              HTML attributes whose values are extracted as translatable
+              strings in addition to text content.
+            items:
+              type: string
+          exclude_selectors:
+            type: array
+            default: [script, style, "code.language-plaintext", "pre code"]
+            description: >-
+              CSS selectors identifying HTML elements whose content is
+              excluded from extraction (e.g., code blocks, scripts).
+            items:
+              type: string
+        additionalProperties: false
+      logging:
+        type: object
+        description: Controls logging verbosity during the build.
+        properties:
+          level:
+            type: string
+            default: "debug"
+            description: >-
+              Log level for the localization pipeline. Accepted values:
+              `debug`, `info`, `warn`, `error`.
+          show_statistics:
+            type: boolean
+            default: true
+            description: >-
+              When `true`, prints translation coverage statistics at the
+              end of the build.
+          debug:
+            type: boolean
+            default: false
+            description: >-
+              When `true`, enables verbose debug output from the
+              localization pipeline.
+        additionalProperties: false
+      translation:
+        type: object
+        description: >-
+          Controls how translated strings are applied and configures the
+          optional LibreTranslate machine translation backend.
+        properties:
+          fallback:
+            type: string
+            default: "english"
+            description: >-
+              Language name used as fallback when a translation is missing.
+          preserve_html:
+            type: boolean
+            default: true
+            description: >-
+              When `true`, HTML markup inside translated strings is preserved
+              rather than escaped.
+          libretranslate_enabled:
+            type: boolean
+            default: false
+            description: >-
+              Enables automatic machine translation via a LibreTranslate
+              instance for strings without a manual translation.
+          libretranslate_api_url:
+            type: string
+            default: "http://localhost:5000"
+            description: >-
+              URL of the LibreTranslate API endpoint used for machine
+              translation.
+          libretranslate_api_key:
+            description: >-
+              API key for the LibreTranslate instance. Set to `nil` if the
+              instance does not require authentication.
+          libretranslate_timeout:
+            type: integer
+            default: 300
+            description: >-
+              Timeout in seconds for LibreTranslate API requests.
+          libretranslate_batch_size:
+            type: integer
+            default: 50
+            description: >-
+              Number of strings submitted per LibreTranslate API request.
+          libretranslate_retry_attempts:
+            type: integer
+            default: 3
+            description: >-
+              Number of retry attempts on a failed LibreTranslate API call.
+          libretranslate_retry_delay:
+            type: integer
+            default: 2
+            description: >-
+              Delay in seconds between LibreTranslate API retry attempts.
+          libretranslate_stop_on_error:
+            type: boolean
+            default: false
+            description: >-
+              When `true`, the build stops on an unrecoverable LibreTranslate
+              API error rather than continuing with untranslated strings.
+        additionalProperties: false
+    additionalProperties: false
+additionalProperties: false

data/_data/base/navbar.yml

@@ -0,0 +1,20 @@
+---
+brand_manifestation: jekyll-theme-centos
+navitems: []
+# navitems:
+#   - name: "Link"
+#     icon: "fa-solid fa-book"
+#     link: "/"
+#     menu: []
+#     visible_on: ["navbar"]
+#   - name: "Menu"
+#     icon: "fa-solid fa-book"
+#     link: ""
+#     menu:
+#       - name: Item 1
+#         link: "/item-1/"
+#       - name: Item 2
+#         link: "/item-2/"
+#       - name: Item 3
+#         link: "/item-3/"
+#     visible_on: ["navbar"]