jekyll-theme-centos 2.52.0.beta.46 → 2.52.0.beta.48

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d3c803dbc0eacfc2999709235c94c945b9bf707f9974a5432647bc07357321d
-  data.tar.gz: 3736a941bd500bd164dc8d4c839b506a8a8a837f1c090dffb8cce45bb99c0273
+  metadata.gz: 6038d25fa442be63264e6ce920e4d294ac2b7551371648390193504ac20ce4d3
+  data.tar.gz: 7962476a3a8fed79fcc6c7785fd395b64c86100010b4e8cee412ff65a9c6de60
 SHA512:
-  metadata.gz: b4ce312cb37982b118eab77b08553e404174f5bb4d7612d2e05d5e255be61867a014766c0e07bb38998f626f1ae0b6558983f18cc5ce826012a8aae692210a4c
-  data.tar.gz: e178b82afd6fc9225e206e7f37ff322ee87d249be53ba5db6c44fbcec8006e8fc8954f00955ebb464600398ecfc6ca744512eea43a9e561e04ad64b4753a0925
+  metadata.gz: ac274007410865e0ae745f84178a505efcf5fd12f997aa59a57728a5256ca1fd6413da09e2d7d5e9027c09c7df13c059642a6627c22cdae3da1f996e6eb4458f
+  data.tar.gz: b2280745be4eebae67bfb9cc2225e86d9f2769ad2debcf86085b1807de5e97af258d8938e367519f1e4aa340b0fba692fbcc7c335c8bed7df59f9b80b1bf9192

data/_data/base/bits.yml

@@ -8,7 +8,7 @@
     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
+  screenshot: base/screenshot-1600x1200.webp
   finale: "Derivatives:"
   actions:
     - name: Action 1
@@ -36,7 +36,7 @@
   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
+  screenshot: base/screenshot-1600x1200.webp
   image: centos-symbol.svg
   actions:
     - name: Action 1
@@ -56,7 +56,7 @@
     - Upstream card example 1
 - name: Downstream example 1-2
   icon: fa-solid fa-arrow-right
-  screenshot: base/screenshot-example-1600x1200.webp
+  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
@@ -69,7 +69,7 @@
       icon_position: end
       link: "#"
 - name: Downstream example 1-3
-  screenshot: base/screenshot-example-1600x1200.webp
+  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
@@ -82,7 +82,7 @@
       icon_position: end
       link: "#"
 - name: Downstream example 1-4
-  screenshot: base/screenshot-example-1600x1200.webp
+  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet

data/_data/base/locales_schema.yml

@@ -12,14 +12,147 @@ properties:
       display the selector and initiate the content localization process. Set
       to `false` (default) to hide the selector.
   with_locales_data:
-    type: array
-    default: []
+    type: object
+    default: {}
     description: >-
-      An array of ISO 639-1 or ISO 639-2 language codes (e.g., `["en", "es", "fr"]`).
-      These codes are used to define the list of available languages in the
-      selector and initiate the pipeline that generates localized pages.
-    items:
-      type: string
-      description: A single language code (e.g., `es` for Spanish).
-    minItems: 0 # Explicitly allowing an empty array
+      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: true
+            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/social.yml

@@ -2,24 +2,25 @@
 #
 # site.data.base.social - Provides social networks information.
 #
-- name: YouTube
-  icon: "fab fa-youtube"
-  link: "https://youtube.com/TheCentOSProject"
-- name: Mastodon
-  icon: "fab fa-mastodon"
-  link: "https://fosstodon.org/@centos"
-- name: Facebook
-  icon: "fab fa-facebook-f"
-  link: "https://www.facebook.com/CentOSProject"
-- name: LinkedIn
-  icon: "fab fa-linkedin"
-  link: "https://www.linkedin.com/company/centos-project/"
-- name: x
-  icon: "fab fa-x-twitter"
-  link: "https://x.com/centos"
-- name: Discourse
-  icon: "fab fa-discourse"
-  link: "https://discussion.fedoraproject.org/c/neighbors/centos/"
-- name: Reddit
-  icon: "fab fa-reddit"
-  link: "https://www.reddit.com/r/CentOS/"
+media:
+  - name: YouTube
+    icon: "fa-brands fa-youtube"
+    link: "https://youtube.com/TheCentOSProject"
+  - name: Mastodon
+    icon: "fa-brands fa-mastodon"
+    link: "https://fosstodon.org/@centos"
+  - name: Facebook
+    icon: "fa-brands fa-facebook-f"
+    link: "https://www.facebook.com/CentOSProject"
+  - name: LinkedIn
+    icon: "fa-brands fa-linkedin"
+    link: "https://www.linkedin.com/company/centos-project/"
+  - name: X
+    icon: "fa-brands fa-x-twitter"
+    link: "https://x.com/centos"
+  - name: Discourse
+    icon: "fa-brands fa-discourse"
+    link: "https://discussion.fedoraproject.org/c/neighbors/centos/"
+  - name: Reddit
+    icon: "fa-brands fa-reddit"
+    link: "https://www.reddit.com/r/CentOS/"

data/_data/base/social_schema.yml

@@ -15,7 +15,15 @@ properties:
     default: {}
     description: Configuration object for the social media component.
     properties:
-      links:
+      preamble:
+        type: string
+        default: "Follow us:"
+        description: "The social media premable. This is, a text introducing the social media buttons."
+      preamble_class:
+        type: string
+        default: "mb-2"
+        description: "The social media premable customization classes."
+      media:
         type: array
         default: []
         description: A list of objects, where each object defines a single social media link/icon.
@@ -30,14 +38,10 @@ properties:
               description: >-
                 The Font Awesome icon class representing the social network
                 brand (e.g., `fa-brands fa-x-twitter`).
-              required:
-                - icon
             link:
               type: string
               format: uri
               description: The absolute URL to the project's profile on this social network (e.g., `https://www.youtube.com/`).
-              required:
-                - link
           required:
             - name
             - icon
@@ -48,6 +52,6 @@ properties:
         default: ""
         description: Custom CSS classes applied to the container element wrapping the social media icons list.
     required:
-      - links
+      - media
     additionalProperties: false
 additionalProperties: false

data/_data/base/sponsors.yml

@@ -0,0 +1,41 @@
+---
+title: Sponsors
+icon: "fa-solid fa-hand-holding-heart"
+image_base_path: "/assets/img/base/"
+message: |
+  CentOS would not be possible without the support of our sponsors. We would
+  like to thank the following product/service for being a CentOS sponsor. If
+  you value our work, please consider [becoming a sponsor!](/sponsors)
+members:
+  - name: sponsor-1
+    country: usa
+    image: example-sponsors-logo-1.png
+    url: https://www.example.com/sponsor-1
+  - name: sponsor-2
+    country: usa
+    image: example-sponsors-logo-2.png
+    url: https://www.example.com/sponsor-2
+  - name: sponsor-3
+    country: usa
+    image: example-sponsors-logo-3.png
+    url: https://www.example.com/sponsor-3
+  - name: sponsor-4
+    country: usa
+    image: example-sponsors-logo-4.png
+    url: https://www.example.com/sponsor-4
+  - name: sponsor-5
+    country: usa
+    image: example-sponsors-logo-5.png
+    url: https://www.example.com/sponsor-5
+  - name: sponsor-6
+    country: usa
+    image: example-sponsors-logo-6.png
+    url: https://www.example.com/sponsor-6
+  - name: sponsor-7
+    country: usa
+    image: example-sponsors-logo-7.png
+    url: https://www.example.com/sponsor-7
+  - name: sponsor-8
+    country: usa
+    image: example-sponsors-logo-8.png
+    url: https://www.example.com/sponsor-8

data/_data/base/sponsors_schema.yml

@@ -0,0 +1,73 @@
+title: Sponsors carousel component configuration
+description: >-
+  Schema for configuring the sponsors carousel, which displays sponsor logos
+  in a rotating carousel, typically rendered in the footer.
+type: object
+properties:
+  with_sponsors:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the rendering of the sponsors carousel component.
+      Set to `true` to display the carousel; set to `false` (default) to hide it.
+  with_sponsors_data:
+    type: object
+    default: {}
+    description: Configuration object for the sponsors carousel component.
+    properties:
+      title:
+        type: string
+        default: "Sponsors"
+        description: The heading displayed above the carousel.
+      icon:
+        type: string
+        default: "fa-solid fa-hand-holding-heart"
+        description: Font Awesome icon class shown next to the title.
+      message:
+        type: string
+        default: ""
+        description: Introductory text rendered above the carousel, supports Markdown.
+      image_base_path:
+        type: string
+        default: "/assets/img/base/"
+        description: >-
+          Base path prepended to bare logo filenames when building the image `src`
+          attribute. Defaults to `/assets/img/base/`. Set to a different path
+          (e.g. `/assets/img/sponsors/`) to store logos elsewhere on the site.
+          Ignored when `image` is an absolute URL (`http://` or `https://`).
+      members:
+        type: array
+        default: []
+        description: List of sponsor entries to display in the carousel.
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              description: Display name of the sponsor (used as image alt text).
+            country:
+              type: string
+              description: Country of the sponsor (informational).
+            image:
+              type: string
+              description: >-
+                Logo image source. Accepts a bare filename (resolved using
+                `image_base_path`, e.g. `logo.png`) or an absolute URL
+                (e.g. `https://cdn.example.com/logo.png`, used as-is).
+            url:
+              type: string
+              format: uri
+              description: URL to the sponsor's website.
+            is_active:
+              type: boolean
+              default: true
+              description: Set to `false` to hide this sponsor without removing the entry.
+          required:
+            - name
+            - image
+            - url
+          additionalProperties: false
+    required:
+      - members
+    additionalProperties: false
+additionalProperties: false

data/_includes/base/announcement.html.liquid

@@ -27,6 +27,7 @@ Data Source Hierarchy (priority):
 ================================================================================
 {%- endcomment %}
 
+{%- if page.with_announcement and page.with_announcement_data.size > 0 -%}
 {%- assign announcements = include.data | default: page.with_announcement_data | default: site.data.announcement | default: site.data.base.announcement %}
 
 {%- comment %} === Presentation === {% endcomment %}
@@ -49,3 +50,4 @@ Data Source Hierarchy (priority):
   <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
 </div>
 {%- endfor %}
+{%- endif -%}

data/_includes/base/artwork.html.liquid

@@ -29,6 +29,7 @@ Data Source Hierarchy (priority):
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_artwork -%}
 {%- assign artwork = include.data | default: page.with_artwork_data | default: site.data.artwork | default: site.data.base.artwork %}
 
 {%- comment %} === Presentation === {% endcomment %}
@@ -47,3 +48,4 @@ Data Source Hierarchy (priority):
     <img src="{{ site.baseurl }}{{ artwork_image }}" class="{{ artwork_image_class }}" alt="{{ artwork_alt }}" />
   {% endif %}
 </div>
+{%- endif -%}

data/_includes/base/bits.html.liquid

@@ -40,6 +40,7 @@ Component Layout:
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_bits -%}
 {%- assign bits = include.data | default: page.with_bits_data | default: site.data.bits | default: site.data.base.bits %}
 
 {%- comment %} === Presentation === {% endcomment %}
@@ -133,3 +134,4 @@ Component Layout:
 
   </div>
 {% endfor %}
+{%- endif -%}

data/_includes/base/breadcrumb.html.liquid

@@ -24,6 +24,7 @@ Data Sources:
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_breadcrumb -%}
 {%- comment %} Use original_url if available (without locale), otherwise use full url {%- endcomment %}
 {%- assign breadcrumb_url = page.original_url | default: page.url %}
 
@@ -56,3 +57,4 @@ Data Sources:
     {%- endfor %}
   </ol>
 </nav>
+{%- endif -%}

data/_includes/base/breakingnews.html.liquid

@@ -29,6 +29,7 @@ Data Source Hierarchy (priority):
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_breakingnews and page.with_breakingnews_data.size > 0 -%}
 {%- assign breakingnews = include.data | default: page.with_breakingnews_data | default: site.data.breakingnews | default: site.data.base.breakingnews %}
 
 {%- comment %} === Presentation === {% endcomment %}
@@ -72,3 +73,4 @@ Data Source Hierarchy (priority):
     </div>
   {% endfor %}
 </div>
+{%- endif -%}

data/_includes/base/configuration-variables-nested.html.liquid

@@ -0,0 +1,98 @@
+{% comment %}
+Generates one separate table and then triggers subsequent recursion to produce
+others. Requires two distinct loops for valid HTML structure.
+{% endcomment %}
+
+{% assign current_properties = include.properties %}
+{% assign parent_name        = include.parent_name %}
+{% assign current_level      = include.level | plus: 0 %}
+{% assign type_desc          = include.type_desc %}
+
+{% assign col_name        = include.col_name        | default: "Name" %}
+{% assign col_type        = include.col_type        | default: "Type" %}
+{% assign col_default     = include.col_default     | default: "Default" %}
+{% assign col_description = include.col_description | default: "Description" %}
+
+{% assign columns = include.columns %}
+
+{% if current_properties %}
+
+  {% comment %} 1. Calculate the property count for THIS specific set of data using | size. {% endcomment %}
+  {% assign current_property_count = current_properties | size %}
+
+  {% comment %} 2. Determine CSS classes and ID for THIS table {% endcomment %}
+  {% assign table_classes = "table dataTable" %}
+  {% assign table_id = parent_name | slugify | append: '-nested-' | append: current_level %}
+
+  {% comment %} 3. Render the current nested table (Loop 1: Rendering) {% endcomment %}
+  <p class="my-3">The <code>{{ parent_name }}</code> variable is a {{ type_desc }} with the following properties:</p>
+
+  <table id="{{ table_id }}" class="{{ table_classes }}">
+    <thead class="table-light">
+      <tr>
+        <th scope="col">{{ col_name }}</th>
+        {% if columns %}
+          {% for col in columns %}<th scope="col">{{ col.label }}</th>{% endfor %}
+        {% else %}
+          <th scope="col">{{ col_type }}</th>
+          <th scope="col">{{ col_default }}</th>
+          <th scope="col">{{ col_description }}</th>
+        {% endif %}
+      </tr>
+    </thead>
+    <tbody>
+      {% for property in current_properties -%}
+        {% assign prop_key = property[0] %}
+        {% assign prop_details = property[1] %}
+        {% assign default_value = prop_details.default | default: "—" %}
+
+        <tr>
+          <td>{{ prop_key }}</td>
+          {% if columns %}
+            {% for col in columns %}<td>{{ prop_details[col.key] | strip_newlines | markdownify | default: "—" }}</td>{% endfor %}
+          {% else %}
+            <td>{{ prop_details.type        | strip_newlines | markdownify | default: "—" }}</td>
+            <td>{{ default_value            | strip_newlines | markdownify | default: "—" }}</td>
+            <td>{{ prop_details.description | strip_newlines | markdownify | default: "—" }}</td>
+          {% endif %}
+        </tr>
+      {% endfor -%}
+    </tbody>
+  </table>
+
+  {% comment %} 4. Run recursion check (Loop 2: Initiation, must run AFTER </table>) {% endcomment %}
+  {% for property in current_properties %}
+    {% assign prop_key = property[0] %}
+    {% assign prop_details = property[1] %}
+
+    {% assign nested_properties = nil %}
+
+    {% comment %} Check if the current property requires further recursion {% endcomment %}
+    {% if prop_details.type == "object" and prop_details.properties %}
+      {% assign nested_properties = prop_details.properties %}
+      {% assign next_type_desc = "dictionary (map)" %}
+    {% elsif prop_details.type == "array" and prop_details.items.properties %}
+      {% assign nested_properties = prop_details.items.properties %}
+      {% assign next_type_desc = "list of dictionaries" %}
+    {% endif %}
+
+    {% if nested_properties %}
+      {% comment %} Found deeper nesting: Call the next level {% endcomment %}
+      {% assign next_parent_name = include.parent_name | append: "." | append: prop_key %}
+      {% assign next_level_val = current_level | plus: 1 %}
+
+      {% include base/configuration-variables-nested.html.liquid
+      properties=nested_properties
+      parent_name=next_parent_name
+      type_desc=next_type_desc
+      level=next_level_val
+      col_name=col_name
+      col_type=col_type
+      col_default=col_default
+      col_description=col_description
+      columns=columns
+      %}
+    {% endif %}
+  {% endfor %}
+
+{% endif %}