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

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

@@ -0,0 +1,98 @@
+{% comment %}
+Generates the top-level property table and initiates the recursive generation
+of separate, nested DataTables for complex properties.
+{% endcomment %}
+
+{% assign component             = page.component.name %}
+{% assign property_name         = "with_" | append: component %}
+{% assign property_name_schema  = component | append: "_schema" %}
+{% assign property_schema       = include.schema | default: site.data[property_name_schema] | default: site.data.base[property_name_schema] %}
+
+{% 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 | default: property_schema.columns %}
+
+{% if property_schema.properties %}
+
+  {% comment %} 1. Calculate the property count for the top table using | size. {% endcomment %}
+  {% assign property_count = property_schema.properties | size %}
+
+  {% comment %} 2. Determine the CSS classes for the top-level table. {% endcomment %}
+  {% assign table_classes = "table dataTable" %}
+
+  The `{{ page.component.name }}` {{ page.component.type }} {{ pt }} understands the following configuration variables:
+
+  {% comment %} 3. Render the top-level table completely {% endcomment %}
+  <table 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 property_schema.properties -%}
+        {% assign prop_key = property[0] %}
+        {% assign prop_details = property[1] %}
+        <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>{{ prop_details.default     | strip_newlines | markdownify | default: "—" }}</td>
+            <td>{{ prop_details.description | strip_newlines | markdownify | default: "—" }}</td>
+          {% endif %}
+        </tr>
+      {% endfor -%}
+    </tbody>
+  </table>
+
+  {% comment %} 4. Initiate recursive nested table generation (separate loop) {% endcomment %}
+  {% for property in property_schema.properties -%}
+    {% assign prop_key = property[0] %}
+    {% assign prop_details = property[1] %}
+
+    {% assign nested_properties = nil %}
+    {% assign type_desc = "" %}
+
+    {% comment %} Check for nested structures in the top-level properties {% endcomment %}
+    {% if prop_details.type == "object" and prop_details.properties %}
+      {% assign nested_properties = prop_details.properties %}
+      {% assign type_desc = "dictionary (map)" %}
+    {% elsif prop_details.type == "array" and prop_details.items.properties %}
+      {% comment %} Handle array of objects {% endcomment %}
+      {% assign nested_properties = prop_details.items.properties %}
+      {% assign type_desc = "list of dictionaries" %}
+    {% endif %}
+
+    {% if nested_properties %}
+      {% assign initial_level = 1 %}
+
+      {% comment %} Call the recursive include for the first level of nested properties. {% endcomment %}
+      {% include base/configuration-variables-nested.html.liquid
+      properties=nested_properties
+      parent_name=prop_key
+      type_desc=type_desc
+      level=initial_level
+      col_name=col_name
+      col_type=col_type
+      col_default=col_default
+      col_description=col_description
+      columns=columns
+      %}
+    {% endif %}
+  {% endfor -%}
+
+{% else %}
+  The `{{ page.component.name }}` {{ page.component.type }} {{ pt }} doesn't have configuration variables.
+{% endif %}

data/_includes/base/copyright.html.liquid

@@ -31,6 +31,7 @@ Data Source Hierarchy (priority):
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_copyright -%}
 {%- assign copyright = include.data | default: page.with_copyright_data | default: site.data.copyright | default: site.data.base.copyright %}
 
 {%- comment %} === Presentation === {% endcomment %}
@@ -53,4 +54,5 @@ Data Source Hierarchy (priority):
 {%- endcapture -%}
 
 {%- comment %} --- HTML --- {% endcomment %}
-<div class="my-3 text-center">Copyright &copy; {{ site.time | date: "%Y" }} {{ copyright_author }} {{ copyright_links }}</div>
+<div class="my-1">Copyright &copy; {{ site.time | date: "%Y" }} {{ copyright_author }} {{ copyright_links }}</div>
+{%- endif -%}

data/_includes/base/event.html.liquid

@@ -34,6 +34,7 @@ Data Source Hierarchy (priority):
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_event -%}
 {%- assign events = include.data | default: page.with_event_data | default: site.data.event | default: site.data.base.event %}
 
 {%- comment %} === Presentation === {% endcomment %}
@@ -87,3 +88,4 @@ Data Source Hierarchy (priority):
     </div>
   {% endfor %}
 </div>
+{%- endif -%}

data/_includes/base/footer.html.liquid

@@ -0,0 +1,62 @@
+{%- assign navbar_brand_image               = navbar.brand_image               | default: schema.brand_image.default %}
+{%- assign navbar_brand_image_class         = navbar.brand_image_class         | default: schema.brand_image_class.default %}
+{%- assign navbar_brand_image_height        = navbar.brand_image_height        | default: schema.brand_image_height.default %}
+{%- assign navbar_brand_manifestation       = navbar.brand_manifestation       | default: schema.brand_manifestation.default %}
+{%- assign navbar_brand_manifestation_class = navbar.brand_manifestation_class | default: schema.brand_manifestation_class.default %}
+
+{%- if page.with_footer -%}
+
+<div class="container">
+
+  <div class="row justify-content-between align-items-start gx-5">
+
+    <div class="col-sm-12 col-lg-4">
+      {%- if navbar_brand_image != "" %}
+        <a class="navbar-brand" href="{{ site.baseurl }}/">
+
+          <img
+              class="d-inline-block align-text-middle me-2{% if navbar_brand_image_class != "" %} {{ navbar_brand_image_class }}{% endif %}"
+              src="{{ site.baseurl }}/assets/img/{{ navbar_brand_image }}"
+              height="{{ navbar_brand_image_height }}"
+              alt="{{ site.title }}" />
+
+          {%- if navbar_brand_manifestation != "" %}
+            <span class="d-inline-block align-text-middle fs-6 border-start border-1 border-light opacity-75 ps-3{% if navbar_brand_manifestation_class != "" %} {{ navbar_brand_manifestation_class }}{% endif %}">{{ navbar_brand_manifestation }}</span>
+          {%- endif %}
+
+        </a>
+      {%- endif %}
+      {% if site.description %}
+        <p class="mt-2 mb-5">{{ site.description }}</p>
+      {% endif %}
+
+      {% include base/sponsors-carousel.html.liquid -%}
+    </div>
+
+    {% if page.with_shortcut %}
+    <div class="col-sm-12 col-lg-5">
+      {% include base/shortcut.html.liquid %}
+    </div>
+    {% endif %}
+
+    {% if page.with_locales or page.with_social %}
+    <div class="col-sm-12 col-lg-3 pb-5">
+      {% include base/locales.html.liquid %}
+      {% include base/social.html.liquid %}
+    </div>
+    {% endif %}
+
+  </div>
+</div>
+
+{% if page.with_copyright %}
+<div class="container">
+  <div class="row justify-content-between align-items-center py-3">
+    <div class="col">
+      {% include base/copyright.html.liquid %}
+    </div>
+  </div>
+</div>
+{% endif %}
+
+{%- endif -%}

data/_includes/base/locales.html.liquid

@@ -44,7 +44,8 @@ Locale Detection:
 
 {%- if page.with_locales and configured_locales %}
 
-<div class="dropdown">
+  <p class="mb-2">Change page language:</p>
+  <div class="dropdown mb-4">
   <button class="btn btn-sm btn-outline-primary dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false" aria-label="Languages">
     <i class="fa-solid fa-language me-1"></i> {{ site.data.base.languages[current_locale] }} ({{ current_locale }})
   </button>

data/_includes/base/navbar.html.liquid

@@ -30,6 +30,7 @@ Data Source Hierarchy (priority):
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_navbar -%}
 {%- assign navbar = include.data | default: page.with_navbar_data | default: site.data.navbar | default: site.data.base.navbar %}
 {%- assign schema = site.data.base.navbar_schema.properties["with_navbar_data"].properties %}
 
@@ -104,3 +105,4 @@ Data Source Hierarchy (priority):
 
   </div>
 </nav>
+{%- endif -%}

data/_includes/base/project.html.liquid

@@ -27,6 +27,7 @@ Data Source Hierarchy (priority):
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_project -%}
 {%- assign project = include.data | default: page.with_project_data | default: site.data.project | default: site.data.base.project %}
 
 {% assign project_class               = project.class               | default: "flex-column text-bg-dark bg-image" %}
@@ -88,3 +89,4 @@ Data Source Hierarchy (priority):
     {%- endif %}
   </div>
 </div>
+{%- endif -%}

data/_includes/base/shortcut.html.liquid

@@ -33,6 +33,7 @@ Conditional Logic:
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_shortcut -%}
 {%- assign shortcut = include.data
 | default: page.with_shortcut_data
 | default: page.with_navbar_data
@@ -44,22 +45,24 @@ Conditional Logic:
 
 {%- comment %} === Presentation === {% endcomment %}
 {% if shortcut_navitems.size > 0 %}
-<div class="d-flex flex-wrap justify-content-center m-2">
+  <div class="d-flex flex-wrap justify-content-evenly mb-4">
+
   {% for section in shortcut_navitems -%}
-  <div class="px-4 text-center">
-    <div class="h6">{{ section.name | upcase }}</div>
-    <ul class="px-4 mb-4">
+  <div class="pe-4">
+    <div class="h6">{% if section.icon %}<i class="{{ section.icon }} me-1"></i>{% endif %}{{ section.name }}</div>
+    <ul class="px-0 mb-4">
       {% for item in section.menu -%}
       <li class="list-unstyled my-1">
         {% include base/link.html.liquid
             name  = item.name
             link  = item.link
-            color = "light"
+            color = "primary"
         %}
         </li>
       {% endfor %}
     </ul>
   </div>
   {% endfor %}
-</div>
+  </div>
 {% endif %}
+{%- endif -%}

data/_includes/base/social.html.liquid

@@ -13,7 +13,7 @@ Strategic Design Logic:
 - Accessibility-first approach with proper ARIA labels
 - Centered layout for prominent footer or banner placement
 
-Required Inputs (from data objects):
+Required Fields (per item in the media array):
 - link: URL for the social media or external platform
 - icon: Icon class for Font Awesome (e.g., 'fa-brands fa-github')
 - name: Platform name for accessibility label (e.g., 'GitHub')
@@ -37,23 +37,30 @@ Conditional Logic:
 ================================================================================
 {% endcomment %}
 
-{%- assign social = include.data | default: page.with_social_data | default: site.data.social | default: site.data.base.social %}
+{%- assign social                = include.data          | default: page.with_social_data | default: site.data.social | default: site.data.base.social %}
+{%- assign social_class          = social.class          | default: site.data.base.social_schema.properties.with_social_data.properties.class.default %}
+{%- assign social_preamble       = social.preamble       | default: site.data.base.social_schema.properties.with_social_data.properties.preamble.default %}
+{%- assign social_preamble_class = social.preamble_class | default: site.data.base.social_schema.properties.with_social_data.properties.preamble_class.default %}
+{%- assign social_media          = social.media          | default: site.data.base.social_schema.properties.with_social_data.properties.media.default %}
 
-{%- comment %} === Presentation === {% endcomment %}
-{% if site.description %}
-  <div class="lead text-center mb-2">{{ site.description }}</div>
+{% if page.with_social %}
+  <div {% if social_class != "" %}class="{{ social_class }}"{% endif %}>
+
+    {%- comment %} === Presentation (Begin) === {% endcomment %}
+    {%- if social_preamble %}
+      <p class="{{ social_preamble_class }}">{{ social_preamble }}</p>
+    {%- endif %}
+
+    {%- for item in social_media -%}
+      {%- include base/link.html.liquid
+      class                = "btn btn-outline-primary m-1"
+      link                 = item.link
+      role                 = "button"
+      icon                 = item.icon
+      aria_label           = item.name
+      data_bs_title        = item.name
+      %}
+    {%- endfor %}
+    {%- comment %} === Presentation (End) === {% endcomment %}
+  </div>
 {% endif %}
-<div class="text-center">
-  {%- for item in social -%}
-    {%- include base/link.html.liquid
-    class                = "btn btn-primary ms-0 m-2 fs-5"
-    link                 = item.link
-    role                 = "button"
-    icon                 = item.icon
-    aria_label           = item.name
-    data_bs_toggle       = "tooltip"
-    data_bs_title        = item.name
-    data_bs_placement    = "bottom"
-    %}
-  {%- endfor %}
-</div>

data/_includes/base/sponsors-cards.html.liquid

@@ -0,0 +1,58 @@
+{% comment %}
+================================================================================
+Template: Sponsors Cards Component
+Purpose: Renders sponsor logos as a horizontal row of linked cards with
+border styling. Suitable for inline or content-area placement.
+================================================================================
+
+Strategic Design Logic:
+- Multi-level data source hierarchy for flexible configuration
+- Card-based layout for content-area or inline sponsor display
+- Active-flag filtering to soft-delete without data removal
+
+Required Fields (per item in the members array):
+- name:  Sponsor display name (used as alt text)
+- image: Logo source — bare filename (resolved via image_base_path) or absolute URL
+- url:   Sponsor website URL
+
+Optional Data Fields:
+- image_base_path: Base path for bare filenames (default: /assets/img/base/)
+
+Optional Inputs (from include):
+- data: Sponsors data object (overrides all fallbacks)
+
+Data Source Hierarchy (in priority order):
+1. include.data               - Explicitly passed sponsors data object
+2. page.with_sponsors_data    - Page front matter configuration
+3. site.data.sponsors         - Site-specific sponsors configuration
+4. site.data.base.sponsors    - Theme default sponsors data
+
+Conditional Logic:
+- Component renders only when page.with_sponsors is true
+- Members filtered by is_active != false
+================================================================================
+{% endcomment %}
+
+{%- assign sponsors            = include.data | default: page.with_sponsors_data | default: site.data.sponsors | default: site.data.base.sponsors -%}
+{%- assign sponsors_members    = sponsors.members | default: site.data.base.sponsors_schema.properties.with_sponsors_data.properties.members.default -%}
+{%- assign sponsors_image_base = sponsors.image_base_path | default: site.data.base.sponsors_schema.properties.with_sponsors_data.properties.image_base_path.default -%}
+
+{%- if page.with_sponsors -%}
+<div class="d-flex flex-wrap justify-content-between py-4 my-4 border-top border-bottom border-top-1 border-bottom-1">
+
+  {%- comment %} === Presentation (Begin) === {% endcomment %}
+  {%- for member in sponsors_members -%}
+  {%- if member.is_active != false %}
+  <div class="card border-light m-4" style="max-height: 60px; max-width: 242px">
+    {%- if member.image contains "https://" or member.image contains "http://" -%}
+    <a href="{{ member.url }}"><img src="{{ member.image }}" class="card-img-top rounded" style="max-height: 60px; max-width: 242px" alt="{{ member.name }}"></a>
+    {%- else -%}
+    <a href="{{ member.url }}"><img src="{{ site.baseurl }}{{ sponsors_image_base }}{{ member.image }}" class="card-img-top rounded" style="max-height: 60px; max-width: 242px" alt="{{ member.name }}"></a>
+    {%- endif -%}
+  </div>
+  {%- endif -%}
+  {%- endfor %}
+  {%- comment %} === Presentation (End) === {% endcomment %}
+
+</div>
+{%- endif -%}

data/_includes/base/sponsors-carousel.html.liquid

@@ -0,0 +1,78 @@
+{% comment %}
+================================================================================
+Template: Sponsors Carousel Component
+Purpose: Renders sponsor logos as a Bootstrap carousel with optional title and
+message. Automatically cycles through active sponsors.
+================================================================================
+
+Strategic Design Logic:
+- Multi-level data source hierarchy for flexible configuration
+- Carousel display with fade transition for visual polish
+- Markdown-enabled message for rich introductory text
+- Active-flag filtering to soft-delete without data removal
+
+Required Fields (per item in the members array):
+- name:  Sponsor display name (used as alt text)
+- image: Logo source — bare filename (resolved via image_base_path) or absolute URL
+- url:   Sponsor website URL
+
+Optional Data Fields:
+- image_base_path: Base path for bare filenames (default: /assets/img/base/)
+
+Optional Inputs (from include):
+- data:       Sponsors data object (overrides all fallbacks)
+- id:         Carousel element ID (default: "sponsorsCarousel")
+- with_title: Set false to suppress title/message block
+
+Data Source Hierarchy (in priority order):
+1. include.data               - Explicitly passed sponsors data object
+2. page.with_sponsors_data    - Page front matter configuration
+3. site.data.sponsors         - Site-specific sponsors configuration
+4. site.data.base.sponsors    - Theme default sponsors data
+
+Conditional Logic:
+- Component renders only when page.with_sponsors is true
+- Title/message block suppressed when include.with_title is false
+- Members filtered by is_active != false
+================================================================================
+{% endcomment %}
+
+{%- assign sponsors            = include.data | default: page.with_sponsors_data | default: site.data.sponsors | default: site.data.base.sponsors -%}
+{%- assign sponsors_title      = sponsors.title        | default: site.data.base.sponsors_schema.properties.with_sponsors_data.properties.title.default -%}
+{%- assign sponsors_icon       = sponsors.icon         | default: site.data.base.sponsors_schema.properties.with_sponsors_data.properties.icon.default -%}
+{%- assign sponsors_message    = sponsors.message      | default: site.data.base.sponsors_schema.properties.with_sponsors_data.properties.message.default -%}
+{%- assign sponsors_members    = sponsors.members      | default: site.data.base.sponsors_schema.properties.with_sponsors_data.properties.members.default -%}
+{%- assign sponsors_image_base = sponsors.image_base_path | default: site.data.base.sponsors_schema.properties.with_sponsors_data.properties.image_base_path.default -%}
+
+{%- assign carousel_id = include.id | default: "sponsorsCarousel" -%}
+
+{%- if page.with_sponsors -%}
+<div id="{{ carousel_id }}" class="d-flex flex-wrap mb-5">
+
+  {%- comment %} === Presentation (Begin) === {% endcomment %}
+  {%- if include.with_title != false %}
+  <div class="h6"><i class="{{ sponsors_icon }}"></i> {{ sponsors_title }}</div>
+  {{ sponsors_message | markdownify | decorate_links }}
+  {%- endif %}
+
+  <div class="carousel slide carousel-fade" data-bs-ride="carousel">
+    <div class="carousel-inner">
+      {%- for member in sponsors_members -%}
+      {%- if member.is_active != false %}
+      <div class="carousel-item{% if forloop.first %} active{% endif %}">
+        <div class="w-100 align-middle" style="height: 80px; width: 262px">
+          {%- if member.image contains "https://" or member.image contains "http://" -%}
+          <a href="{{ member.url }}"><img src="{{ member.image }}" class="rounded" style="max-height: 60px; max-width: 242px" alt="{{ member.name }}"></a>
+          {%- else -%}
+          <a href="{{ member.url }}"><img src="{{ site.baseurl }}{{ sponsors_image_base }}{{ member.image }}" class="rounded" style="max-height: 60px; max-width: 242px" alt="{{ member.name }}"></a>
+          {%- endif -%}
+        </div>
+      </div>
+      {%- endif -%}
+      {%- endfor %}
+    </div>
+  </div>
+  {%- comment %} === Presentation (End) === {% endcomment %}
+
+</div>
+{%- endif -%}

data/_includes/base/title.html.liquid

@@ -34,6 +34,7 @@ Conditional Logic:
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_title -%}
 {%- assign title_data = include.data | default: page.with_title_data | default: site.data.title | default: site.data.base.title %}
 {%- assign title_schema = site.data.base.title_schema.properties["with_title_data"].properties %}
 
@@ -50,3 +51,4 @@ Conditional Logic:
     <div class="{{ title_lead_class }}">{{ title_lead }}</div>
   {% endif %}
 </div>
+{%- endif -%}

data/_includes/base/toc.html.liquid

@@ -40,6 +40,7 @@ Data Source Hierarchy (in priority order):
 ================================================================================
 {% endcomment %}
 
+{%- if page.with_toc -%}
 {%- assign toc = include.data | default: page.with_toc_data | default: site.data.toc | default: site.data.base.toc %}
 {%- assign toc_schema = site.data.base.toc_schema.properties["with_toc_data"].properties %}
 
@@ -89,3 +90,4 @@ Data Source Hierarchy (in priority order):
     </div>
   </div>
 </div>
+{%- endif -%}

data/_layouts/base/default.html

@@ -3,43 +3,24 @@
   {% include base/head.html.liquid -%}
   <body id="top" class="bg-body">
 
-    {%- if page.with_navbar -%}
     {% include base/navbar.html.liquid -%}
-    {%- endif -%}
 
-    {% if page.with_project %}
     {% include base/project.html.liquid %}
-    {% endif %}
 
-    {%- if page.with_breakingnews and page.with_breakingnews_data.size > 0 -%}
     {% include base/breakingnews.html.liquid -%}
-    {%- endif -%}
 
     <main class="container py-3">
 
-      {%- if page.with_announcement and page.with_announcement_data.size > 0 -%}
       {%- include base/announcement.html.liquid %}
-      {%- endif -%}
 
-      {% if page.with_bits %}
       {% include base/bits.html.liquid %}
-      {% endif %}
 
-      {% if page.with_event %}
       {% include base/event.html.liquid %}
-      {% endif %}
 
-      {% if page.with_breadcrumb or page.with_locales %}
+      {% if page.with_breadcrumb %}
       <div class="row small mb-3">
         <div class="col">
-        {% if page.with_breadcrumb %}
-        {% include base/breadcrumb.html.liquid %}
-        {% endif %}
-        </div>
-        <div class="col-auto">
-          {% if page.with_locales %}
-          {% include base/locales.html.liquid %}
-          {% endif %}
+          {% include base/breadcrumb.html.liquid %}
         </div>
       </div>
       {% endif %}
@@ -63,7 +44,7 @@
       {% if page.with_toc %}
       <div class="row mb-3">
         <div class="{{ site.data.base.content.class | default: 'col' }}">
-        {% include base/toc.html.liquid %}
+          {% include base/toc.html.liquid %}
         </div>
       </div>
       {% endif %}
@@ -79,35 +60,8 @@
     </main>
 
     {% if page.with_footer %}
-    <footer class="footer small text-bg-dark">
-
-      <div class="container">
-        {% if page.with_shortcut %}
-        <div class="row p-4 pb-0 text-bg-centos-purple-600">
-          {% include base/shortcut.html.liquid %}
-        </div>
-        {% endif %}
-
-        {% if page.with_social %}
-        <div class="row p-4 text-light text-bg-centos-purple-700 border-top border-5 border-centos-purple-600 rounded-bottom">
-          {% include base/social.html.liquid %}
-        </div>
-        {% endif %}
-
-        {% if page.with_sponsors %}
-        <div class="row mt-2">
-          {% include sponsors/carousel.html -%}
-        </div>
-        {% endif %}
-
-        {% if page.with_copyright %}
-        <div class="row">
-          {% include base/copyright.html.liquid %}
-        </div>
-        {% endif %}
-
-      </div>
-
+    <footer class="footer small bg-dark text-centos-purple-100 pt-5">
+    {% include base/footer.html.liquid -%}
     </footer>
     {% endif %}