jekyll-theme-centos 2.52.0.beta.104 → 2.52.0.beta.106

data/_includes/base/download_commands.html.liquid

@@ -1,18 +1,6 @@
 {% comment %}
-================================================================================
-Utility: Download Commands List
-Purpose: Command snippets for one release, rendered as one collapsible item
-inside download_sections.html.liquid's shared documentation/commands/eol
-accordion — release-wide metadata that applies in common to every
-architecture above. Called from download_sections.html.liquid.
-
-Required Inputs:
-- commands: Array of {title, lines}
-- accordion_id: Parent accordion's id, for data-bs-parent scoping
-- item_id: This item's unique collapse id
-- expanded: true starts this item open; false starts it closed. Passed
-  through from the caller (see download_sections.html.liquid).
-================================================================================
+download_commands: renders a release's commands as one accordion item titled Migration.
+Schema: src/YAML/download_schema.yml
 {% endcomment %}
 {%- capture download_commands_body -%}
   {%- for row in include.commands %}

data/_includes/base/download_documentation.html.liquid

@@ -1,54 +1,20 @@
 {% comment %}
-================================================================================
-Utility: Download Documentation List
-Purpose: Documentation links for one release, rendered as one collapsible
-item inside download_sections.html.liquid's shared documentation/commands/
-eol/screenshots accordion — release-wide metadata that applies in common to
-every architecture above. Called from download_sections.html.liquid.
-
-Required Inputs:
-- documentation: Array of {title, link, description}
-- accordion_id: Parent accordion's id, for data-bs-parent scoping
-- item_id: This item's unique collapse id
-- expanded: true starts this item open; false starts it closed. Passed
-  through from the caller (see download_sections.html.liquid).
-
-An entry's optional `description` switches its own presentation rather than
-attaching a caption to a button: a bare button reads as a call to action
-("do this now"), a mismatched signifier for a full explanatory sentence
-sitting next to it — so once there's a sentence to say, the entry renders as
-one prose paragraph with `title` as the inline link and `description`
-continuing the sentence grammatically (e.g. "Release Notes are continuously
-updated..."), the standard, immediately-recognizable convention for
-referencing a resource from explanatory text. Entries without a description
-still render as a bare button, identical to before this field existed —
-prose and buttons render as two separate groups (prose first, since it's the
-richer content) rather than interleaved, so a documentation list mixing both
-kinds doesn't end up with paragraphs breaking up a button row.
-================================================================================
+download_documentation: renders a release's documentation as one accordion item, entries with a description as sentences and the rest as buttons.
+Schema: src/YAML/download_schema.yml
 {% endcomment %}
-{%- capture download_documentation_prose -%}
-  {%- for row in include.documentation %}
-    {%- assign has_description = false %}
+{%- comment %} An entry with a description renders as prose, since a bare button reads as a call to action; prose and buttons stay in separate groups. {% endcomment %}
+{%- assign download_documentation_prose = "" %}
+{%- assign download_documentation_buttons = "" %}
+{%- for row in include.documentation %}
+  {%- if row.title and row.title != "" %}
     {%- if row.description and row.description != "" %}
-      {%- assign has_description = true %}
+      {%- capture download_documentation_prose %}{{ download_documentation_prose }}
+    <p class="mb-2">{%- include base/link.html.liquid name=row.title link=row.link target="_blank" icon="fa-solid fa-up-right-from-square" icon_position="end" %} {{ row.description }}</p>{% endcapture %}
+    {%- else %}
+      {%- capture download_documentation_buttons %}{{ download_documentation_buttons }}{%- include base/link.html.liquid class="btn focus-ring btn-outline-primary text-start" name=row.title link=row.link target="_blank" icon="fa-solid fa-up-right-from-square" icon_position="end" -%}{% endcapture %}
     {%- endif %}
-    {%- if row.title and row.title != "" and has_description %}
-    <p class="mb-2">{%- include base/link.html.liquid name=row.title link=row.link target="_blank" icon="fa-solid fa-up-right-from-square" icon_position="end" %} {{ row.description }}</p>
-    {%- endif %}
-  {%- endfor %}
-{%- endcapture -%}
-{%- capture download_documentation_buttons -%}
-  {%- for row in include.documentation %}
-    {%- assign has_description = false %}
-    {%- if row.description and row.description != "" %}
-      {%- assign has_description = true %}
-    {%- endif %}
-    {%- if row.title and row.title != "" and has_description == false %}
-    {%- include base/link.html.liquid class="btn focus-ring btn-outline-primary text-start" role="button" name=row.title link=row.link target="_blank" icon="fa-solid fa-up-right-from-square" icon_position="end" -%}
-    {%- endif %}
-  {%- endfor %}
-{%- endcapture -%}
+  {%- endif %}
+{%- endfor %}
 {%- assign download_documentation_prose_stripped = download_documentation_prose | strip %}
 {%- assign download_documentation_buttons_stripped = download_documentation_buttons | strip %}
 {%- capture download_documentation_body -%}

data/_includes/base/download_eol.html.liquid

@@ -1,27 +1,17 @@
 {% comment %}
-================================================================================
-Utility: Download End-of-life List
-Purpose: End-of-life milestones for one release, rendered as one collapsible
-item inside download_sections.html.liquid's shared documentation/commands/
-eol accordion — release-wide metadata that applies in common to every
-architecture above. Called from download_sections.html.liquid.
-
-Required Inputs:
-- eol: Array of {date, description}
-- accordion_id: Parent accordion's id, for data-bs-parent scoping
-- item_id: This item's unique collapse id
-- expanded: true starts this item open; false starts it closed. Passed
-  through from the caller (see download_sections.html.liquid).
-================================================================================
+download_eol: renders a release's end-of-life milestones as one accordion item.
+Schema: src/YAML/download_schema.yml
 {% endcomment %}
 {%- capture download_eol_body -%}
   <ul class="list-unstyled mb-0">
     {%- for row in include.eol %}
+      {%- comment %} The pinned Liquid has no remove_last, so split/join drops the trailing "</p>" markdownify adds. {% endcomment %}
+      {%- assign download_eol_description_html = row.description | markdownify | strip | remove_first: "<p>" | split: "</p>" | join: "</p>" | strip %}
       <li class="mb-1">
         {%- if row.date and row.date != "" -%}
           <strong>{{ row.date }}</strong>{% if row.description and row.description != "" %} — {% endif %}
         {%- endif -%}
-        {{ row.description }}
+        {{ download_eol_description_html }}
       </li>
     {%- endfor %}
   </ul>

data/_includes/base/download_filevalue.html.liquid

@@ -1,58 +1,16 @@
 {% comment %}
-================================================================================
-Utility: Download File Value Row
-Purpose: One input-group row pairing a link-to-file icon with its copyable
-text value — the shared shape behind the checksum and signature rows in
-download_architecture.html.liquid's per-architecture box.
-
-A page using the copy button below must set `with_copyvalue: true` in its
-front matter — base/copyvalue.html.liquid (loaded globally from
-head.html.liquid, see src/JS/copyvalue.js for the copy-btn contract) is an
-opt-in include, not a global default, despite its own schema listing `true`
-as with_copyvalue's default (that default only covers with_copyvalue_data's
-sub-fields once the feature is already on).
-
-Required Inputs:
-- arch_name:   Architecture label, used only in the input's aria-label
-               (e.g. "Checksum value for x86_64").
-- field:       The file's own URL (checksum/signature). Empty renders the
-               left icon as a non-interactive glyph instead of a link.
-- field_value: The literal value to render/copy. Callers resolve their own
-               `X_value | default: X` fallback before calling this include —
-               this include renders field_value as-is.
-- icon:        Font Awesome icon class for the left icon (e.g.
-               "fa-solid fa-shield-halved").
-- label:       Lowercase noun used in tooltip/aria-label text (e.g.
-               "checksum", "signature").
-- id_prefix:   Page-unique prefix (release id + architecture label, built by
-               download_architecture.html.liquid) combined with `label` to
-               give the `<input>` a unique id — every form field needs an id
-               or name so the browser can autofill/target it correctly, and
-               arch_name/label alone aren't page-unique (the same
-               architecture repeats across every release/tab on the page).
-
-The clickable icon-link (when `field` is present) is rendered via
-base/link.html.liquid — the theme's canonical link component — rather than a
-hand-rolled `<a>`, so it inherits that component's javascript:/data:/vbscript:
-scheme neutralization and escaping. This also means, like the Download and
-Mirror buttons in download_architecture.html.liquid, it only renders when
-`page.with_link` is true; the non-interactive `<span>` fallback below covers
-both an empty `field` and a with_link-disabled page.
-================================================================================
+download_filevalue: renders an input group with a file link icon and a read-only value for one checksum or signature, plus a copy button when page.with_copyvalue is on.
+Schema: src/YAML/download_schema.yml
 {% endcomment %}
 {%- assign download_filevalue_label_cap = include.label | capitalize -%}
 {%- assign download_filevalue_id = include.id_prefix | append: "-" | append: include.label -%}
 {%- assign download_filevalue_open_text = "Open " | append: include.label | append: " file" -%}
 <div class="input-group input-group-sm">
-  {%- comment %} .link-primary is a Bootstrap utility, not a custom class —
-  it reads as a clickable link instead of the plain body-color text
-  .input-group-text renders by default, and compiles with `!important` so
-  it wins over .input-group-text's color unconditionally, no custom SCSS or
-  cascade ordering required. {% endcomment %}
-  {%- if include.field and include.field != "" %}
+  {%- comment %} .link-primary compiles with !important, so it overrides the .input-group-text color without custom SCSS. {% endcomment %}
+  {%- comment %} base/link.html.liquid renders nothing unless page.with_link is true, so the span stands in for it then. {% endcomment %}
+  {%- if include.field and include.field != "" and page.with_link %}
   {%- include base/link.html.liquid
       class="input-group-text link-primary text-decoration-none"
-      role="button"
       link=include.field
       icon=include.icon
       aria_label=download_filevalue_open_text
@@ -62,7 +20,9 @@ both an empty `field` and a with_link-disabled page.
   <span class="input-group-text"><i class="{{ include.icon }}"></i></span>
   {%- endif %}
   <input type="text" id="{{ download_filevalue_id }}" class="form-control font-monospace" readonly value="{{ include.field_value | escape }}" aria-label="{{ download_filevalue_label_cap }} value for {{ include.arch_name | escape }}">
-  {%- comment %} data-copy-value MUST go through `| escape` — see
-  base/copyvalue.html.liquid's own security note. {% endcomment %}
+  {%- comment %} Same gate as base/copyvalue.html.liquid: no copy script means no copy button. {% endcomment %}
+  {%- if page.with_copyvalue %}
+  {%- comment %} data-copy-value must go through escape: the browser decodes attribute entities before the script reads the value. {% endcomment %}
   <button type="button" class="input-group-text copy-btn focus-ring" data-copy-value="{{ include.field_value | escape }}" data-bs-toggle="tooltip" data-bs-title="Copy {{ include.label }} value" aria-label="Copy {{ include.label }} value"><span class="fa-regular fa-copy"></span></button>
+  {%- endif %}
 </div>

data/_includes/base/download_screenshots.html.liquid

@@ -1,85 +1,30 @@
 {% comment %}
-================================================================================
-Utility: Download Screenshots Carousel
-Purpose: Bootstrap carousel of screenshots for one release, rendered as one
-collapsible item inside download_sections.html.liquid's shared
-documentation/commands/eol/screenshots accordion — a sibling of Documentation
-and Migration, not nested inside either of them. Called from
-download_sections.html.liquid.
-
-Required Inputs:
-- screenshots: Array of {src, alt, title, description} — title/description
-  are optional; when present they render as a Bootstrap carousel caption
-  (https://getbootstrap.com/docs/5.3/components/carousel/#captions)
-  overlaid on the slide, hidden below md so it doesn't crowd small screens.
-  The caption heading is a `<div class="h5">`, not a real `<h5>` — same as
-  the accordion-item headers' `<div class="accordion-header h2">` — because
-  jekyll-toc auto-injects a "#" anchor into every real heading tag it scans,
-  which an overlaid caption doesn't want.
-- image_base_path: Resolved base path under /assets/img/ (see
-  download_schema.yml's image_base_path description)
-- release_id: Unique id of the parent tab-pane, used to scope carousel ids
-- accordion_id: Parent accordion's id, for data-bs-parent scoping
-- item_id: This item's unique collapse id
-- expanded: true starts this item open; false starts it closed. Passed
-  through from the caller (see download_sections.html.liquid).
-
-Each slide is wrapped in Bootstrap's `.ratio` utility, set to a fixed 16:10
-box (`--bs-aspect-ratio: 62.5%` — 800 / 1280) so screenshots of any native
-size crop to a consistent box instead of each slide having its own height.
-16:10 matches actual OS screenshot captures (e.g. 1280x800, a common
-display resolution) — deliberately not the 16:9 `ratio-16x9` modifier class
-artwork.html.liquid uses for its own image presentation
-(artwork_schema.yml's image_class default: `ratio ratio-16x9 rounded
-bg-dark bg-artwork`); real screen captures are rarely 16:9 natively, so
-matching artwork's ratio here would crop more than necessary. Bootstrap
-ships no `ratio-16x10` modifier class, hence the inline `--bs-aspect-ratio`
-override on the base `.ratio` class instead of a second modifier class.
-`object-fit-cover` on the `<img>` itself does the actual cropping — `.ratio`
-alone only stretches its child to fill the box.
-
-The carousel skips Bootstrap's `.carousel-dark` modifier: its indicator/
-caption colors are meant to react to whether the underlying image is
-generally light or dark, which fits calm banner photography but not real OS
-screenshots — a single release's slides span stark-white installer screens
-to busy desktop/app-grid content, no single color choice reads clearly
-against all of them. `.download-screenshots-carousel` (see
-src/SASS/_download.scss) instead gives the prev/next icons their own fixed
-dark scrim and the caption its own dark backdrop, so both stay legible over
-any screenshot regardless of image content.
-
-`.carousel-inner` and the two control buttons are wrapped in their own
-`.position-relative` div, separate from `.carousel-indicators` — Bootstrap's
-default markup puts indicators inside that same positioned box, overlaid on
-the image (`.carousel-indicators` is `position: absolute; bottom: 0`), which
-is illegible over screenshot content no scrim reliably fixes since a slide's
-content near the bottom edge varies per screenshot. Moving indicators
-outside the wrapper and resetting them to `position: static` in
-_download.scss instead renders them in normal flow below the image — plain
-dots on the page's own background, not an overlay — where they don't need a
-scrim at all. `.position-relative` also keeps the prev/next buttons
-(`top: 0; bottom: 0`, relative to the nearest positioned ancestor) scoped to
-the image's own height instead of stretching down to cover the indicator
-row too.
-================================================================================
+download_screenshots: renders a release's screenshots as a carousel inside one accordion item.
+Schema: src/YAML/download_schema.yml
 {% endcomment %}
 {%- capture download_screenshots_body -%}
   <div class="p-3">
     <div id="carouselScreenshotsIndicators-{{ include.release_id }}" class="carousel slide download-screenshots-carousel" data-bs-ride="true">
+      {% comment %} Indicators sit outside .position-relative so they render below the image instead of over screenshot content. {% endcomment -%}
       <div class="position-relative">
         <div class="carousel-inner">
           {%- for row in include.screenshots %}
+          {%- comment %} The pinned Liquid has no remove_last, so split/join drops the trailing "</p>" markdownify adds. {% endcomment %}
+          {%- assign download_screenshot_title_html       = row.title | markdownify | strip | remove_first: "<p>" | split: "</p>" | join: "</p>" | strip %}
+          {%- assign download_screenshot_description_html = row.description | markdownify | strip | remove_first: "<p>" | split: "</p>" | join: "</p>" | strip %}
           <div class="carousel-item{% if forloop.first %} active{% endif %}">
+            {% comment %} Bootstrap ships no 16:10 ratio class, so the screenshot aspect ratio is set inline. {% endcomment -%}
             <div class="ratio" style="--bs-aspect-ratio: 62.5%;">
               <img class="object-fit-cover" src="{{ site.baseurl }}{{ include.image_base_path }}{{ row.src | escape }}" alt="{{ row.alt | escape }}" />
             </div>
             {%- if row.title and row.title != "" or row.description and row.description != "" %}
             <div class="carousel-caption d-none d-md-block">
               {%- if row.title and row.title != "" %}
-              <div class="h5">{{ row.title }}</div>
+              {% comment %} A div.h5, not an h5, keeps jekyll-toc from adding an anchor to the caption. {% endcomment -%}
+              <div class="h5">{{ download_screenshot_title_html }}</div>
               {%- endif %}
               {%- if row.description and row.description != "" %}
-              <p>{{ row.description }}</p>
+              <p>{{ download_screenshot_description_html }}</p>
               {%- endif %}
             </div>
             {%- endif %}

data/_includes/base/download_sections.html.liquid

@@ -1,23 +1,6 @@
 {% comment %}
-================================================================================
-Utility: Download Release Sections
-Purpose: Renders one release's architecture/documentation/eol/commands/
-screenshots sections, in a fixed order, each only if its data is present.
-Shared by download.html.liquid's tabbed (multiple releases) and untabbed
-(single release) render paths, since the section content is identical either
-way — only the surrounding tab markup differs. Documentation, commands, eol,
-and screenshots render as sibling items inside one shared Bootstrap accordion
-below the architecture grid — collapsible, so they read as release-wide
-metadata that applies in common to every architecture above rather than
-disconnected trailing content. All start collapsed.
-
-Required Inputs:
-- release_data: One release's content object
-- release_id: Unique id for this release, used to scope nested element ids
-  (the documentation/commands/eol/screenshots accordion, the screenshots
-  carousel's own ids)
-- image_base_path: Resolved base path under /assets/img/
-================================================================================
+download_sections: renders a release's architecture grid, then its screenshots, documentation, commands, and end-of-life items in one accordion.
+Schema: src/YAML/download_schema.yml
 {% endcomment %}
 
 {%- if include.release_data.architecture.size > 0 %}

data/_includes/base/event.html.liquid

@@ -1,39 +1,7 @@
 {% comment %}
-================================================================================
-Template: Event Alerts Component
-Purpose: Renders event announcements as styled alert boxes with date, location,
-description, and optional action links.
-================================================================================
-
-Design Logic:
-- Alert-based styling: consistent with Bootstrap alert components
-- Icon support: visual identification of event type
-- Color coding: color-based categorization
-- Location details: address and city information optional
-- Date/time display: with location suffix if available
-- Optional action link: "Know more" button for details page
-- Multi-event support: loops through event array
-
-Required Inputs:
-- title: Event name/title
-- start: Event start (YYYY-MM-DD for an all-day event, or YYYY-MM-DDTHH:MM
-  to give it a specific start time on that same day)
-
-Optional Inputs:
-- description: Event description text
-- end: Event inclusive end (same format as start), defaults to start
-- location: Event location name
-- color: Alert color scheme (default: "secondary")
-- icon: Icon class (default: "fa-solid fa-calendar")
-- link: URL to event details page (optional)
-- data: Array of event objects
-
-Data Source Hierarchy (priority):
-1. include.data
-2. page.with_event_data
-3. site.data.event
-4. site.data.base.event
-================================================================================
+event: renders each event as an alert with its title, formatted date, location, description, and an optional "Know more" button.
+Data: include.data > page.with_event_data > site.data.event > site.data.base.event
+Schema: src/YAML/event_schema.yml
 {% endcomment %}
 
 {%- assign with_event = include.with_event
@@ -49,38 +17,19 @@ Data Source Hierarchy (priority):
 {%- if with_event %}
 
 {%- assign with_event_schema = site.data.base.event_schema.properties.with_event_data.items.properties %}
-
-{%- comment %} === Presentation === {% endcomment %}
 {%- if with_event_data.size > 0 %}
 <div class="mb-3">
   {%- for event in with_event_data %}
-    {%- comment %} --- Defaults --- {% endcomment %}
-    {%- assign event_address     = event.address     | default: with_event_schema.address.default %}
-    {%- assign event_city        = event.city        | default: with_event_schema.city.default %}
     {%- assign event_color       = event.color       | default: with_event_schema.color.default %}
     {%- assign event_location    = event.location    | default: with_event_schema.location.default %}
     {%- assign event_description = event.description | default: with_event_schema.description.default %}
+    {%- comment %} The pinned Liquid has no remove_last, so split/join drops the trailing "</p>" markdownify adds. {% endcomment %}
+    {%- assign event_description_html = event_description | markdownify | strip | remove_first: "<p>" | split: "</p>" | join: "</p>" | strip %}
 
-    {%- comment %}
-    Derive the same style of display string the old free-text `date` field
-    used to hold (e.g. "September 19 - 20, 2025") from the structured,
-    inclusive `start`/`end` ISO dates — collapsing the month/year whenever
-    both sides share it, spelling both out in full otherwise. No date
-    arithmetic here, only formatting and string comparison of the formatted
-    output; the calendar component (reading this same with_event_data) is
-    the one place that does inclusive-to-exclusive end-date arithmetic, in
-    JS. See the calendar component's event data contract documentation.
-
-    A `start` carrying a time-of-day (`YYYY-MM-DDTHH:MM`) is a same-day timed
-    event rather than a date range — it gets its own branch below that
-    appends the clock time(s) instead of running the range-collapsing logic.
-    {% endcomment %}
+    {%- comment %} Formats start and end into one display string, collapsing a shared month or year; a start with a time (T) is a same-day timed event. {% endcomment %}
     {%- assign event_start = event.start %}
-    {%- if event_start != "" and event_start != nil %}
+    {%- if event_start and event_start != "" %}
       {%- assign event_end = event.end | default: event_start %}
-      {%- if event_end == "" %}
-        {%- assign event_end = event_start %}
-      {%- endif %}
       {%- if event_start contains "T" %}
         {%- assign event_date = event_start | date: "%B %-d, %Y" %}
         {%- assign event_start_time = event_start | date: "%-l:%M %p" %}
@@ -115,13 +64,10 @@ Data Source Hierarchy (priority):
       {%- assign event_date = "" %}
     {%- endif %}
     {%- assign event_icon        = event.icon        | default: with_event_schema.icon.default %}
-    {%- assign event_image_url   = event.image_url   | default: with_event_schema.image_url.default %}
     {%- assign event_link        = event.link        | default: with_event_schema.link.default %}
     {%- assign event_title       = event.title       | default: with_event_schema.title.default %}
 
     {%- assign event_btn_class = "btn btn-sm text-nowrap btn-" | append: event_color %}
-
-    {%- comment %} --- HTML --- {% endcomment %}
     <div class="alert alert-{{ event_color }} rounded mb-1" role="alert">
       <div class="d-flex justify-content-between align-items-start">
         {%- if event_icon != "" %}
@@ -135,7 +81,7 @@ Data Source Hierarchy (priority):
             <p class="ms-1 mb-0">{{ event_date }}{% if event_location != "" %} • {{ event_location }}{%- endif %}</p>
           {%- endif %}
           {%- if event_description != "" %}
-            <p class="ms-1 mb-0">{{ event_description }}</p>
+            <p class="ms-1 mb-0">{{ event_description_html }}</p>
           {%- endif %}
         </div>
         {%- if event_link != "" %}
@@ -144,7 +90,6 @@ Data Source Hierarchy (priority):
             name          = "Know more"
             icon          = "fa-solid fa-arrow-right"
             icon_position = "end"
-            role          = "button"
             class         = event_btn_class
             color         = event_color
             link          = event_link

data/_includes/base/fontawesome.html.liquid

@@ -1,35 +1,7 @@
 {% comment %}
-================================================================================
-Template: Font Awesome Icon Library Component
-Purpose: Loads Font Awesome icon library CSS and JavaScript from CDN
-with integrity checks.
-================================================================================
-
-Design Logic:
-- CDN-based library loading with SRI integrity verification
-- Two loading modes: svg+js (default) and css
-  - svg+js: JavaScript bundle replaces <i> tags with inline SVGs via DOM mutation;
-    enables power transforms, layering, pseudo-element watching
-  - css: stylesheet + WOFF2 font files loaded on demand; lighter payload, no DOM cost
-- Format switching: separate head (CSS link) and script (JS) includes; preload hints mode-aware
-- Subresource Integrity (SRI): ensures file hasn't been tampered with
-- Privacy-focused: referrerpolicy="no-referrer"
-
-Optional Inputs:
-- type: "preload" for resource hint, "head" for CSS link, "script" for JavaScript
-- mode: "svg+js" (default) or "css" — controls which assets are emitted per type
-- version: Font Awesome version (e.g., "7.0.1")
-- cdn: CDN base URL (default: cdnjs.cloudflare.com)
-- css_bundle_name, js_bundle_name: Bundle identifiers
-- css_bundle_integrity, js_bundle_integrity: SRI hashes
-- data: Font Awesome configuration object
-
-Data Source Hierarchy (priority):
-1. include.data
-2. page.with_fontawesome_data
-3. site.data.fontawesome
-4. site.data.base.fontawesome
-================================================================================
+fontawesome: loads Font Awesome from the CDN in css or svg+js mode. head.html.liquid calls it with type="preload", type="head", and type="script".
+Data: include.data > page.with_fontawesome_data > site.data.fontawesome > site.data.base.fontawesome
+Schema: src/YAML/fontawesome_schema.yml
 {% endcomment %}
 
 {%- assign with_fontawesome = include.with_fontawesome
@@ -45,17 +17,13 @@ Data Source Hierarchy (priority):
 {%- assign with_fontawesome_schema = site.data.base.fontawesome_schema.properties.with_fontawesome_data.properties %}
 
 {%- if with_fontawesome %}
-
-{%- comment %} === Presentation === {% endcomment %}
-
-{%- comment %} --- Defaults --- {% endcomment %}
 {%- assign fontawesome_version              = with_fontawesome_data.version              | default: with_fontawesome_schema.version.default %}
 {%- assign fontawesome_cdn                  = with_fontawesome_data.cdn                  | default: with_fontawesome_schema.cdn.default %}
 {%- assign fontawesome_css_bundle_name      = with_fontawesome_data.css_bundle_name      | default: with_fontawesome_schema.css_bundle_name.default %}
 {%- assign fontawesome_css_bundle_integrity = with_fontawesome_data.css_bundle_integrity | default: with_fontawesome_schema.css_bundle_integrity.default %}
 {%- assign fontawesome_js_bundle_name       = with_fontawesome_data.js_bundle_name       | default: with_fontawesome_schema.js_bundle_name.default %}
 {%- assign fontawesome_js_bundle_integrity  = with_fontawesome_data.js_bundle_integrity  | default: with_fontawesome_schema.js_bundle_integrity.default %}
-{%- assign fontawesome_mode                 = with_fontawesome_data.mode                 | default: with_fontawesome_schema.mode.default | default: "svg+js" %}
+{%- assign fontawesome_mode                 = with_fontawesome_data.mode                 | default: with_fontawesome_schema.mode.default %}
 
 {%- capture html_fontawesome_preload %}
 {%- if fontawesome_mode == "css" %}
@@ -76,8 +44,6 @@ Data Source Hierarchy (priority):
 <script src="{{ fontawesome_cdn }}/{{ fontawesome_version }}/js/{{ fontawesome_js_bundle_name }}.min.js" integrity="{{ fontawesome_js_bundle_integrity }}" crossorigin="anonymous" referrerpolicy="no-referrer" defer></script>
 {%- endif %}
 {%- endcapture %}
-
-{%- comment %} --- HTML --- {% endcomment %}
 {%- assign type = include.type %}
 {%- case type %}
 {%- when "preload" %}

data/_includes/base/footer.html.liquid

@@ -1,3 +1,8 @@
+{% comment %}
+footer: renders the site footer with the brand, site description, sponsors carousel, shortcuts, locales, social links, and copyright.
+Data: include.data > page.with_footer_data > site.data.footer > site.data.base.footer
+Schema: src/YAML/footer_schema.yml
+{% endcomment %}
 {%- assign with_footer = include.with_footer
 | default: page.with_footer
 %}
@@ -19,9 +24,11 @@
 {%- assign footer_brand_manifestation       = with_footer_data.brand_manifestation       | default: with_footer_schema.brand_manifestation.default %}
 {%- assign footer_brand_manifestation_class = with_footer_data.brand_manifestation_class | default: with_footer_schema.brand_manifestation_class.default %}
 
-<footer class="{{ footer_class }}">
+{%- comment %} Dark color mode gives links colors that stay readable on the dark footer background. {% endcomment %}
+<footer class="{{ footer_class }}" data-bs-theme="dark">
 
-<div class="container">
+{%- comment %} overflow-hidden: gx-5 widens the row's negative margin past the container's padding, which scrolls the page sideways on phones. {% endcomment %}
+<div class="container overflow-hidden">
   <div class="row justify-content-between align-items-start gx-5">
     <div class="col-sm-12 col-lg-4">
       {%- if footer_brand_image != "" %}

data/_includes/base/head.html.liquid

@@ -1,41 +1,6 @@
 {% comment %}
-================================================================================
-Template: Page Head Section Component
-Purpose: Generates complete HTML <head> section with meta tags, stylesheets,
-icons, fonts, and conditional library includes.
-================================================================================
-
-Design Logic:
-- Comprehensive meta tags: charset, viewport, referrer policy, description, theme-color
-- Dynamic title generation: page title + site title
-- Favicon support: multiple formats (16x16, 32x32, SVG with type, Apple Touch)
-- Google Fonts: Montserrat (5 weights) and Source Code Pro (2 weights) via async stylesheet
-- Breakingnews scroll offset: dynamic CSS calculation
-- Conditional includes: OGP, Highlight.js, DataTables, FontAwesome (SVG+JS), Event Calendar
-- CSS load order: theme stylesheet loads first, then per-component vendor
-  CSS (FontAwesome, DataTables, Event Calendar). Components whose vendor CSS
-  needs correcting win with higher-specificity selectors in their own SCSS
-  partial instead of load order — see _datatable.scss and _calendar.scss.
-- Script loading: Bootstrap base first (defer), then optional extensions, then UI behaviors
-- Bootstrap and FontAwesome preloaded (high-priority fetch); CDN origins preconnected + dns-prefetched per active component
-
-Required Inputs:
-- page.title: Current page title
-- site.title: Site name/title
-- site.baseurl: Base URL for asset paths
-
-Optional Inputs:
-- page.with_ogp, page.with_fontawesome: Include OGP/Font Awesome SVG+JS (boolean)
-- page.with_breakingnews, page.with_highlight: Include breaking news/highlight
-- page.with_datatable: Include DataTables (boolean)
-- page.with_calendar: Include Event Calendar (boolean)
-- page.with_breakingnews_data: Array of breaking news items
-- page.with_backtotop: Include back-to-top button (boolean)
-- page.with_copyvalue: Include copy-to-clipboard behavior (boolean)
-- page.theme_color, site.theme_color: Override browser chrome color. The
-  fallback below is a literal, not read from head_schema.yml — keep both in
-  sync if the default ever changes.
-================================================================================
+head: renders the head element with meta tags, icons, fonts, the theme stylesheet, Bootstrap, and each enabled library's CSS and JS.
+Schema: src/YAML/head_schema.yml
 {% endcomment %}
 
 <head>
@@ -47,14 +12,14 @@ Optional Inputs:
 {% else -%}
   <title>{{ page.title | escape }} - {{ site.title | escape }}</title>
 {% endif -%}
-<meta name="description" content="{{ page.description | default: page.excerpt | default: page.title_lead | default: site.description | strip_html | truncate: 160 | escape }}" />
+<meta name="description" content="{{ page.description | default: page.excerpt | default: page.title_lead | default: site.description | markdownify | strip_html | strip_newlines | strip | truncate: 160 | escape_once }}" />
 {% include base/ogp.html.liquid %}
 <link rel="icon" href="{{ site.baseurl }}/assets/icons/favicon-16.png" sizes="16x16" />
 <link rel="icon" href="{{ site.baseurl }}/assets/icons/favicon-32.png" sizes="32x32" />
 <link rel="icon" href="{{ site.baseurl }}/assets/icons/favicon.svg" type="image/svg+xml" sizes="any" />
 <link rel="apple-touch-icon" href="{{ site.baseurl }}/assets/icons/apple-touch-icon.png" sizes="180x180" />
 <link rel="manifest" href="{{ site.baseurl }}/site.webmanifest" />
-{%- assign head_theme_color = page.theme_color | default: site.theme_color | default: '#A54C93' %}
+{%- assign head_theme_color = page.theme_color | default: site.theme_color | default: site.data.base.head_schema.properties.theme_color.default %}
 <meta name="theme-color" content="{{ head_theme_color }}" />
 <link rel="preconnect" href="https://fonts.googleapis.com" />
 <link rel="dns-prefetch" href="https://fonts.googleapis.com" />
@@ -81,9 +46,7 @@ Optional Inputs:
 <link rel="preload" href="https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;600;700&family=Source+Code+Pro:ital,wght@0,400;0,700&display=swap" as="style" onload="this.onload=null;this.rel='stylesheet'" />
 <noscript><link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;600;700&family=Source+Code+Pro:ital,wght@0,400;0,700&display=swap" /></noscript>
 <link rel="stylesheet" href="{{ site.baseurl }}/assets/css/base/stylesheet.min.css" />
-{%- comment %} Sets scroll-margin-top via CSS custom properties, sized to
-the current number of breaking news items, so anchor links land below the
-breaking news bar (and navbar, if present) instead of under it. {%- endcomment %}
+{%- comment %} Sets scroll-margin-top so anchor links land below the breaking news bar and navbar instead of under them. {%- endcomment %}
 {%- assign breakingnews = page.with_breakingnews_data | default: site.data.breakingnews | default: site.data.base.breakingnews %}
 {%- if page.with_breakingnews == true and breakingnews.size > 0 %}
   {%- assign breakingnews_alert_height = site.data.base.breakingnews_schema.properties.breakingnews_alert_height.default %}
@@ -123,8 +86,6 @@ breaking news bar (and navbar, if present) instead of under it. {%- endcomment %
   }
   </style>
 {%- endif %}
-
-{%- comment %} CSS dependencies {%- endcomment %}
 {%- include base/fontawesome.html.liquid type="head" %}
 {%- include base/datatable.html.liquid type="head" %}
 {%- include base/calendar.html.liquid type="head" %}
@@ -132,14 +93,12 @@ breaking news bar (and navbar, if present) instead of under it. {%- endcomment %
 {%- comment %} JavaScript base — Bootstrap must execute before all component scripts {%- endcomment %}
 <script src="{{ site.baseurl }}/assets/js/bootstrap.bundle.min.js" defer></script>
 <script src="{{ site.baseurl }}/assets/js/base/init-tooltips.min.js" defer></script>
-
-{%- comment %} JavaScript optional library extensions {%- endcomment %}
 {%- include base/fontawesome.html.liquid type="script" %}
 {%- include base/highlight.html.liquid %}
 {%- include base/datatable.html.liquid type="script" %}
 {%- include base/calendar.html.liquid type="script" %}
 
-{%- comment %} JavaScript UI behavior components — depend on Bootstrap and FontAwesome SVG+JS {%- endcomment %}
+{%- comment %} UI behavior scripts depend on Bootstrap, so they load after it. {%- endcomment %}
 {%- include base/backtotop.html.liquid %}
 {%- include base/copyvalue.html.liquid %}
 </head>