jekyll-theme-centos 2.52.0.beta.95 → 2.52.0.beta.97

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 514d7cf7b23b5a2233b00dd34553cc9be81540fafc2fef9a3e3bdcd223355140
-  data.tar.gz: 11d9d4be1415ddf484b5f1c590fab9a79fb26d24a77e49724f93649d6680444f
+  metadata.gz: 02c33817b8b756a8de30c5e96c06b4c2defd9c65600ac6a82adce543427c86ec
+  data.tar.gz: 9d14e11510ea28e7ac5a29229a190a9d9340a915e10f66d8cbc19e80dbceb0df
 SHA512:
-  metadata.gz: ea8fca5a2626aaab45cef3f673115e3a4260f6ff5b9d31e9b436b5bb304413d879df61e586316fb2ff38bf58ceba27c6e99bdd89412b38f17a42f6d4b9cde8bd
-  data.tar.gz: c8f7a9cfc0ea451c92192656de898a3c2add1219a4ffa08eb4758520b48bbdc59ffe4ce82ed506d46fce7961228d407384524405e7798ee88873b50c4a2253c1
+  metadata.gz: 04ce54202918e0da657e661a0a03de681b3c83c1b68240695f7a11a4b910fe797712e024fdfc49d4558ba84f330fa24d6ca43bca61225312b6aa6853c33c683c
+  data.tar.gz: c4e526cad99918c56f708a5a0434ce30de714f4adfb3f3ff1a2da0d9b7f1a10231074b20bc5d6c1a6d6f766cff339e7056da3cbd64530dc41d64d2053adf333e

data/_config.yml

@@ -174,10 +174,6 @@ with_link_decorator_data:
     - img
 
 with_heading_anchor: true
-with_heading_anchor_data:
-  icon: "fa-solid fa-hashtag"
-  copy_success_message: "Copied!"
-  reset_delay: 2000
 
 with_minify: true
 with_minify_data:

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-1600x1200.webp
+  preamble: false
   finale: "Derivatives:"
   actions:
     - name: Action 1
@@ -36,7 +36,6 @@
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
     convallis at efficitur in eros. Sagittis morbi scelerisque faucibus
-  screenshot: base/screenshot-1600x1200.webp
   image: centos-symbol.svg
   actions:
     - name: Action 1
@@ -56,7 +55,6 @@
     - Upstream card example 1
 - name: Downstream example 1-2
   icon: fa-solid fa-arrow-right
-  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
@@ -69,7 +67,6 @@
       icon_position: end
       link: "#"
 - name: Downstream example 1-3
-  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
@@ -82,7 +79,6 @@
       icon_position: end
       link: "#"
 - name: Downstream example 1-4
-  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet

data/_data/base/content.yml

@@ -1,2 +1,4 @@
 ---
-class: col
+class: "container py-3"
+row_class: "row mb-3"
+col_class: col

data/_data/base/content_schema.yml

@@ -1,15 +1,22 @@
 title: Content Section Configuration
 description: >-
-  Schema for configuring the main content display partial. This controls the
-  rendering and layout of the primary content area on a page.
+  Schema for configuring the content component, which owns the <main>
+  element in the default layout. This controls the rendering of the entire
+  main page body — the announcement, bits, event, breadcrumb, title,
+  artwork, and table of contents components nested inside <main>, followed
+  by the page's own converted Markdown or HTML content — as well as the
+  layout of that content area.
 type: object
 properties:
   with_content:
     type: boolean
     default: true
     description: >-
-      Enables or disables the rendering of the content section. Set to `true`
-      (default) to display the content area; set to `false` to hide it entirely.
+      Enables or disables the rendering of the <main> element and every
+      component nested inside it (announcement, bits, event, breadcrumb,
+      title, artwork, toc, and the page's own content). Set to `true`
+      (default) to display the main content region; set to `false` to omit
+      `<main>` entirely from the rendered page.
   with_content_data:
     type: object
     description: >-
@@ -17,10 +24,29 @@ properties:
       rendered content section.
     properties:
       class:
+        type: string
+        default: "container py-3"
+        description: >-
+          Custom Bootstrap class(es) applied to the `<main>` element itself
+          — the outermost element owned by this component. Controls the
+          outer container behavior (max-width constraint, vertical padding)
+          for the entire main page body.
+      row_class:
+        type: string
+        default: "row mb-3"
+        description: >-
+          Custom Bootstrap class(es) applied to the `div.row` that wraps the
+          content section's `div.col` container. This same class is also
+          passed to the breadcrumb, title, artwork, and toc components, so
+          every row inside `<main>` shares the same spacing.
+      col_class:
         type: string
         default: col
         description: >-
-          A Bootstrap column class used to control the width and responsiveness of the content section container (e.g., `col`, `col-md-10`, `col-lg-8`).
-          This dictates the column size within the grid system.
+          A Bootstrap column class used to control the width and
+          responsiveness of the content section's `div.col` container (e.g.,
+          `col`, `col-md-10`, `col-lg-8`). This same class is also passed to
+          the breadcrumb, title, artwork, and toc components, so the whole
+          page moves as one aligned column.
     additionalProperties: false # Added to restrict unexpected properties in the data object
 additionalProperties: false

data/_data/base/footer.yml

@@ -2,6 +2,7 @@
 #
 # site.data.base.footer - Control footer branding.
 #
+class: "footer small bg-dark text-centos-purple-100 pt-5"
 brand_image: "centos-whitelogo.svg"
 brand_image_class: ""
 brand_image_height: "32"

data/_data/base/footer_schema.yml

@@ -20,6 +20,12 @@ properties:
       defined here (in the page's front matter) override any global `footer`
       data defined in site-wide `_data` files.
     properties:
+      class:
+        type: string
+        default: "footer small bg-dark text-centos-purple-100 pt-5"
+        description: >-
+          Custom Bootstrap class(es) applied to the `<footer>` element
+          itself — the outermost element owned by this component.
       brand_image:
         type: string
         default: "centos-whitelogo.svg"

data/_data/base/heading_anchor.yml

@@ -1,2 +1,2 @@
 ---
-icon: "fa-solid fa-hashtag"
+icon: "heading-anchor-hash pe-1"

data/_data/base/heading_anchor_schema.yml

@@ -2,8 +2,8 @@
 title: Heading Anchor Component Configuration
 description: >
   Configuration for the first-class heading anchor feature of jekyll-link-decorator.
-  Each heading (h1–h6) receives a Font Awesome link icon that, when clicked, copies
-  the full page URL with fragment to the clipboard.
+  Each heading (h1–h6) receives a permalink: an anchor with a hover/focus-revealed
+  glyph, linking to the heading itself.
 type: object
 properties:
   with_heading_anchor:
@@ -12,26 +12,16 @@ properties:
     default: true
   with_heading_anchor_data:
     type: object
-    description: Configuration for heading anchor appearance and copy behaviour.
+    description: Configuration for heading anchor appearance.
     properties:
       icon:
         type: string
-        description: Font Awesome icon classes applied to the anchor icon element.
-        default: "fa-solid fa-hashtag"
+        description: >
+          CSS classes applied to the anchor's glyph element. Defaults to a plain
+          "#" character rendered via the .heading-anchor-hash class.
+        default: "heading-anchor-hash pe-1"
       icon_size:
         type: string
         description: Font Awesome size modifier appended after the icon classes.
-      copy_success_message:
-        type: string
-        description: >
-          Feedback message shown after a successful clipboard copy.
-          Consumed by heading-anchor.js via data-success-message on the script element.
-        default: "Copied!"
-      reset_delay:
-        type: integer
-        description: >
-          Milliseconds to wait before the icon resets to its original state
-          after a successful copy. Consumed by heading-anchor.js via data-reset-delay.
-        default: 2000
     additionalProperties: false
 additionalProperties: false

data/_data/base/ogp.yml

@@ -2,12 +2,10 @@
 locale: en_US
 og:
   type: website
-  title: true
   url: true
   description: true
   logo: /assets/icons/apple-touch-icon.png
   image:
-    url: true
     alt: The CentOS Project
     type: image/png
     width: 1200
@@ -16,9 +14,7 @@ twitter:
   card: summary_large_image
   site: "@CentOS"
   creator: "@CentOS"
-  title: true
   url: true
   description: true
   image:
-    url: true
     alt: The CentOS Project

data/_data/base/ogp_schema.yml

@@ -26,7 +26,13 @@ properties:
           title:
             type: string
             default: The CentOS Project
-            description: The title of the content via the `og:title` tag.
+            description: >-
+              The title of the content via the `og:title` tag. Falls back to
+              `page.title` when omitted, then to this default. Set explicitly
+              to `false` or an empty string to omit the tag entirely; `true`
+              is treated the same as omitting it (kept for backward
+              compatibility with this component's own earlier documented
+              convention).
           description:
             type: string
             default: ""
@@ -38,13 +44,22 @@ properties:
               url:
                 type: string
                 format: uri
-                default: "{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png"
-                description: The non-secure URL via the `og:image:url` tag.
+                default: "/assets/img/centos-social-share.png"
+                description: >-
+                  The non-secure URL via the `og:image:url` tag. Falls back
+                  to this default (treated as a path relative to
+                  `site.url + site.baseurl`, same convention as `logo`) when
+                  omitted; `true` is treated the same as omitted, for
+                  backward compatibility with this component's own earlier
+                  documented convention. Set to a real string to override
+                  with a different image.
               secure_url:
                 type: string
                 format: uri
-                default: "{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png"
-                description: The secure HTTPS URL via the `og:image:secure_url` tag.
+                default: "/assets/img/centos-social-share.png"
+                description: >-
+                  The secure HTTPS URL via the `og:image:secure_url` tag.
+                  Same fallback and `true`-tolerance as `url` above.
               type:
                 type: string
                 default: image/png
@@ -154,13 +169,17 @@ properties:
               url:
                 type: string
                 format: uri
-                default: "{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png"
-                description: The image URL via the `twitter:image:url` tag.
+                default: "/assets/img/centos-social-share.png"
+                description: >-
+                  The image URL via the `twitter:image:url` tag. Same
+                  fallback and `true`-tolerance as `og.image.url`.
               secure_url:
                 type: string
                 format: uri
-                default: "{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png"
-                description: The secure HTTPS image URL.
+                default: "/assets/img/centos-social-share.png"
+                description: >-
+                  The secure HTTPS image URL. Same fallback and
+                  `true`-tolerance as `og.image.secure_url`.
               type:
                 type: string
                 default: image/png

data/_data/base/shortcut_schema.yml

@@ -46,11 +46,13 @@ properties:
                 An icon class (e.g., from Font Awesome) to display alongside the heading.
             visible_on:
               type: array
-              default: ["footer"]
               description: >-
                 Controls where this item is displayed. For the Shortcut component,
-                this array must contain `"footer"` to be rendered. Other values
-                (like `"navbar"`) are ignored in this context.
+                this array must contain `"footer"` to be rendered — there is no
+                standalone default for this property here; an item with no
+                `visible_on` at all is not shown in the footer (it falls back to
+                navbar-visible instead, per the Navbar component's own default).
+                Other values (like `"navbar"`) are ignored in this context.
               items:
                 type: string
                 enum:

data/_data/base/social.yml

@@ -2,6 +2,7 @@
 #
 # site.data.base.social - Provides social networks information.
 #
+preamble: "Follow us:"
 media:
   - name: YouTube
     icon: "fa-brands fa-youtube"

data/_data/base/social_schema.yml

@@ -18,7 +18,13 @@ properties:
       preamble:
         type: string
         default: "Follow us:"
-        description: "The social media premable. This is, a text introducing the social media buttons."
+        description: >-
+          The social media premable. This is, a text introducing the social
+          media buttons. This default is applied automatically whenever the
+          resolved data source omits the property — set it explicitly to
+          `false` or an empty string to render no preamble `<p>` at all; the
+          icon row's own margin then reclaims the vertical space. Any other
+          string value renders as the preamble text.
       preamble_class:
         type: string
         default: "mb-2"

data/_includes/base/artwork.html.liquid

@@ -19,6 +19,9 @@ Optional Inputs:
 - data: Artwork data object (overrides fallbacks)
 - column_class: Bootstrap column class for the row wrapper (set by the layout to
   keep this component aligned with the content column; defaults to "col")
+- row_class: Bootstrap class(es) for the row wrapper (set by the layout to
+  keep this component's row aligned with breadcrumb, title, toc, and
+  content; defaults to "row mb-3")
 
 Data Source Hierarchy (priority):
 1. include.data
@@ -49,9 +52,10 @@ Data Source Hierarchy (priority):
 {%- assign artwork_class       = with_artwork_data.class       | default: with_artwork_schema.class.default %}
 {%- assign artwork_image_class = with_artwork_data.image_class | default: with_artwork_schema.image_class.default %}
 {%- assign column_class        = include.column_class | default: 'col' %}
+{%- assign row_class           = include.row_class | default: 'row mb-3' %}
 
 {%- comment %} --- HTML --- {% endcomment %}
-<div class="row mb-3">
+<div class="{{ row_class }}">
   <div class="{{ column_class }}">
     <div class="{{ artwork_class }}">
       <div class="{{ artwork_image_class }}" role="img" aria-label="{{ artwork_alt }}"></div>

data/_includes/base/bits.html.liquid

@@ -25,7 +25,9 @@ Required Inputs (from data objects):
 
 Optional Inputs (from data objects):
 - description, screenshot, icon, image, actions, color
-- preamble, finale: Text before/after the upstream card
+- preamble, finale: Text before/after the upstream card; each falls back to
+its own schema-documented default when omitted — set explicitly to `false`
+or an empty string to render neither element instead
 - class, card_class, preamble_class, finale_class: Custom styling
 - downstream_style: 'card' (default) or 'accordion'
 - downstream_limit: accordion style only; caps items shown, omit for
@@ -71,6 +73,14 @@ Data Source Hierarchy (priority order):
   {%- assign upstream_bit_index_page_url        = upstream_bit.index_page_url   | default: with_bits_schema.index_page_url.default %}
   {%- assign upstream_bit_screenshot_class      = upstream_bit.screenshot_class | default: with_bits_schema.screenshot_class.default %}
   {%- assign upstream_bit_actions_class         = upstream_bit.actions_class    | default: with_bits_schema.actions_class.default %}
+  {%- assign upstream_bit_preamble = upstream_bit.preamble %}
+  {%- if upstream_bit.preamble == nil %}
+    {%- assign upstream_bit_preamble = with_bits_schema.preamble.default %}
+  {%- endif %}
+  {%- assign upstream_bit_finale = upstream_bit.finale %}
+  {%- if upstream_bit.finale == nil %}
+    {%- assign upstream_bit_finale = with_bits_schema.finale.default %}
+  {%- endif %}
   {%- assign upstream_bit_btn_class             = "btn btn-sm m-1 btn-"         | append: upstream_bit_color %}
   {%- assign upstream_bit_downstream_style      = upstream_bit.downstream_style  | default: with_bits_schema.downstream_style.default %}
   {%- assign upstream_bit_downstream_limit      = upstream_bit.downstream_limit %}
@@ -79,8 +89,8 @@ Data Source Hierarchy (priority order):
   <div class="d-flex flex-column{% if upstream_bit_class != "" %} {{ upstream_bit_class }}{% endif %}">
 
     {%- comment %} --- Upstream Preamble --- {% endcomment %}
-    {%- if upstream_bit.preamble %}
-      <p{% if upstream_bit_preamble_class != "" %} class="{{ upstream_bit_preamble_class }}"{% endif %}>{{ upstream_bit.preamble }}</p>
+    {%- if upstream_bit_preamble and upstream_bit_preamble != empty %}
+      <p{% if upstream_bit_preamble_class != "" %} class="{{ upstream_bit_preamble_class }}"{% endif %}>{{ upstream_bit_preamble }}</p>
     {%- endif %}
 
     {%- comment %} --- Upstream Card --- {% endcomment %}
@@ -120,9 +130,9 @@ Data Source Hierarchy (priority order):
       {%- assign show_index_link = true %}
     {%- endif %}
 
-    {%- if upstream_bit.finale %}
+    {%- if upstream_bit_finale and upstream_bit_finale != empty %}
       <div class="d-flex flex-row w-100 justify-content-between align-items-center">
-        <p class="m-1{% if upstream_bit_finale_class != "" %} {{ upstream_bit_finale_class }}{% endif %}">{{ upstream_bit.finale }}</p>
+        <p class="m-1{% if upstream_bit_finale_class != "" %} {{ upstream_bit_finale_class }}{% endif %}">{{ upstream_bit_finale }}</p>
         {%- if show_index_link %}
           <div class="m-1">
             {%- include base/link.html.liquid

data/_includes/base/breadcrumb.html.liquid

@@ -22,6 +22,9 @@ Optional Inputs:
 - with_breadcrumb_data.arialabel: aria-label for the <nav> element (default: "breadcrumb")
 - column_class (include param): Bootstrap column class for the row wrapper (set by
   the layout to keep this component aligned with the content column; defaults to "col")
+- row_class (include param): Bootstrap class(es) for the row wrapper (set by
+  the layout to keep this component's row aligned with title, artwork, toc,
+  and content; defaults to "row mb-3")
 
 Data Source Hierarchy:
 - with_breadcrumb: include.with_breadcrumb → page.with_breadcrumb
@@ -50,10 +53,11 @@ Data Source Hierarchy:
 {%- assign detected_locale = page.locale | default: 'en' %}
 
 {%- assign column_class = include.column_class | default: 'col' %}
+{%- assign row_class = include.row_class | default: 'row mb-3' %}
 
-<div class="row small mb-3">
+<div class="{{ row_class }}">
   <div class="{{ column_class }}">
-    <nav aria-label="{{ with_breadcrumb_data.arialabel | default: with_breadcrumb_schema.arialabel.default | default: 'breadcrumb' }}">
+    <nav class="small" aria-label="{{ with_breadcrumb_data.arialabel | default: with_breadcrumb_schema.arialabel.default | default: 'breadcrumb' }}">
       <ol class="breadcrumb mb-0">
         {%- comment %} Home link - adjust for locale {%- endcomment %}
         {%- if detected_locale == 'en' or detected_locale == '' %}

data/_includes/base/content.html.liquid

@@ -8,19 +8,49 @@
 | default: site.data.base.content
 -%}
 
+{%- assign content_schema_key = "content_schema" %}
+{%- assign content_schema     = include.schema
+| default: site.data[content_schema_key]
+| default: site.data.base[content_schema_key]
+-%}
+
+{%- assign class = include.class
+| default: with_content_data.class
+| default: content_schema.properties.with_content_data.properties.class.default
+| default: 'container py-3' -%}
+
+{%- assign row_class = include.row_class
+| default: with_content_data.row_class
+| default: content_schema.properties.with_content_data.properties.row_class.default
+| default: 'row mb-3' -%}
+
+{%- assign col_class = include.col_class
+| default: with_content_data.col_class
+| default: content_schema.properties.with_content_data.properties.col_class.default
+| default: 'col' -%}
+
 {%- if with_content -%}
-  {%- assign content_schema_key = "content_schema" %}
-  {%- assign content_schema     = include.schema
-  | default: site.data[content_schema_key]
-  | default: site.data.base[content_schema_key]
-  -%}
-  {%- assign class = include.column_class
-  | default: with_content_data.class
-  | default: content_schema.properties.with_content_data.properties.class.default
-  | default: 'col' -%}
-  <div class="row mb-3">
-    <div class="{{ class }} content">
+<main class="{{ class }}">
+
+  {%- include base/announcement.html.liquid %}
+
+  {% include base/bits.html.liquid %}
+
+  {% include base/event.html.liquid %}
+
+  {% include base/breadcrumb.html.liquid column_class=col_class row_class=row_class %}
+
+  {% include base/title.html.liquid column_class=col_class row_class=row_class %}
+
+  {% include base/artwork.html.liquid column_class=col_class row_class=row_class %}
+
+  {% include base/toc.html.liquid column_class=col_class row_class=row_class %}
+
+  <div class="{{ row_class }}">
+    <div class="{{ col_class }} content">
       {{ content }}
     </div>
   </div>
+
+</main>
 {%- endif -%}

data/_includes/base/footer.html.liquid

@@ -10,16 +10,17 @@
 
 {%- if with_footer -%}
 
-<footer class="footer small bg-dark text-centos-purple-100 pt-5">
-
 {%- assign with_footer_schema = site.data.base.footer_schema.properties.with_footer_data.properties %}
 
+{%- assign footer_class                     = with_footer_data.class                     | default: with_footer_schema.class.default %}
 {%- assign footer_brand_image               = with_footer_data.brand_image               | default: with_footer_schema.brand_image.default %}
 {%- assign footer_brand_image_class         = with_footer_data.brand_image_class         | default: with_footer_schema.brand_image_class.default %}
 {%- assign footer_brand_image_height        = with_footer_data.brand_image_height        | default: with_footer_schema.brand_image_height.default %}
 {%- 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 }}">
+
 <div class="container">
   <div class="row justify-content-between align-items-start gx-5">
     <div class="col-sm-12 col-lg-4">

data/_includes/base/head.html.liquid

@@ -29,7 +29,6 @@ Optional Inputs:
 - 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.with_heading_anchor: Include heading anchor copy behavior (boolean)
 - page.theme_color, site.theme_color: Override browser chrome color (default: #A54C93)
 ================================================================================
 {% endcomment %}
@@ -141,5 +140,4 @@ Uses CSS custom properties for cleaner, more maintainable dynamic styling.
 {%- comment %} JavaScript UI behavior components — depend on Bootstrap and FontAwesome SVG+JS {%- endcomment %}
 {%- include base/backtotop.html.liquid %}
 {%- include base/copyvalue.html.liquid %}
-{%- include base/heading_anchor.html.liquid %}
 </head>

data/_includes/base/navbar.html.liquid

@@ -10,7 +10,8 @@ Design Logic:
 - Responsive hamburger menu: collapses on mobile
 - Dropdown menus: multi-level navigation
 - Brand image and manifestation text support
-- Filtered navitems by visible_on='navbar'
+- Filtered navitems by visible_on='navbar'; an item that omits visible_on
+entirely falls back to being navbar-visible (schema default `["navbar"]`)
 
 Required Inputs:
 - brand_image: Logo image filename
@@ -50,7 +51,7 @@ Data Source Hierarchy (priority):
 {%- assign navbar_brand_image_height        = with_navbar_data.brand_image_height                       | default: with_navbar_schema.brand_image_height.default %}
 {%- assign navbar_brand_manifestation       = with_navbar_data.brand_manifestation                      | default: with_navbar_schema.brand_manifestation.default %}
 {%- assign navbar_brand_manifestation_class = with_navbar_data.brand_manifestation_class                | default: with_navbar_schema.brand_manifestation_class.default %}
-{%- assign navbar_navitems                  = with_navbar_data.navitems | where: "visible_on", "navbar" | default: with_navbar_schema.navitems.default %}
+{%- assign navbar_navitems                  = with_navbar_data.navitems | where_exp: "item", "item.visible_on == nil or item.visible_on contains 'navbar'" | default: with_navbar_schema.navitems.default %}
 
 <nav class="navbar bg-dark fixed-top navbar-expand-lg shadow{% if navbar_class != "" %} {{ navbar_class }}{% endif %}" aria-label="{{ include.arialable | default: 'navbar'}}" data-bs-theme="dark">
   <div class="container">

data/_includes/base/ogp.html.liquid

@@ -24,6 +24,14 @@ Optional Inputs:
 - page.locale: BCP 47 locale code set by jekyll-l10n on localized pages
 
 Data Source Hierarchy:
+- og:title, twitter:title: with_ogp_data[property].title (real string override)
+  → page.title → schema default. `true` (this component's own previously
+  documented convention) is treated the same as omitted, for backward
+  compatibility; `false` or "" suppresses the tag entirely.
+- og:image:url, :secure_url (+ twitter): with_ogp_data[property].image.url/
+  .secure_url (real string override) → schema default
+  (/assets/img/centos-social-share.png). Same `true`-tolerance as
+  title, for the same reason.
 - og:type:             with_ogp_data.og.type → schema default → 'website'
 - og:site_name:       with_ogp_data.og.site_name → site.title
 - og:logo:            with_ogp_data.og.logo → schema default → '/assets/icons/apple-touch-icon.png'
@@ -35,7 +43,6 @@ Data Source Hierarchy:
 - twitter:card:       with_ogp_data.twitter.card → schema default → 'summary_large_image'
 - twitter:site:       with_ogp_data.twitter.site → schema default → '@CentOS'
 - twitter:creator:    with_ogp_data.twitter.creator → schema default → '@CentOS'
-- Default image path: /assets/img/centos-social-share.png
 ================================================================================
 {% endcomment %}
 
@@ -89,8 +96,14 @@ Data Source Hierarchy:
     {%- endif %}
 
     {%- comment %} --- Title --- {% endcomment %}
-    {%- if with_ogp_data[property].title %}
-      <meta {{ meta_attr }}="{{ property }}:title" content="{{ page.title | escape }}" />
+    {%- assign ogp_title_raw = with_ogp_data[property].title %}
+    {%- if ogp_title_raw == nil or ogp_title_raw == true %}
+      {%- assign ogp_title = page.title | default: with_ogp_schema.og.properties.title.default %}
+    {%- else %}
+      {%- assign ogp_title = ogp_title_raw %}
+    {%- endif %}
+    {%- if ogp_title and ogp_title != empty %}
+      <meta {{ meta_attr }}="{{ property }}:title" content="{{ ogp_title | escape }}" />
     {%- endif %}
 
     {%- comment %} --- OG type and logo (after title, before url) --- {% endcomment %}
@@ -119,10 +132,24 @@ Data Source Hierarchy:
     {%- endif %}
 
     {%- comment %} --- Image --- {% endcomment %}
+    {%- assign ogp_image_url_raw = with_ogp_data[property].image.url %}
+    {%- if ogp_image_url_raw == nil or ogp_image_url_raw == true %}
+      {%- assign ogp_image_url = with_ogp_og_image_schema.url.default %}
+    {%- else %}
+      {%- assign ogp_image_url = ogp_image_url_raw %}
+    {%- endif %}
+
+    {%- assign ogp_image_secure_url_raw = with_ogp_data[property].image.secure_url %}
+    {%- if ogp_image_secure_url_raw == nil or ogp_image_secure_url_raw == true %}
+      {%- assign ogp_image_secure_url = with_ogp_og_image_schema.secure_url.default %}
+    {%- else %}
+      {%- assign ogp_image_secure_url = ogp_image_secure_url_raw %}
+    {%- endif %}
+
     {%- if with_ogp_data[property].image %}
-      <meta {{ meta_attr }}="{{ property }}:image" content="{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png" />
+      <meta {{ meta_attr }}="{{ property }}:image" content="{{ site.url }}{{ site.baseurl }}{{ ogp_image_url }}" />
       {%- if property == "og" %}
-        <meta {{ meta_attr }}="{{ property }}:image:secure_url" content="{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png" />
+        <meta {{ meta_attr }}="{{ property }}:image:secure_url" content="{{ site.url }}{{ site.baseurl }}{{ ogp_image_secure_url }}" />
         <meta {{ meta_attr }}="{{ property }}:image:type" content="{{ ogp_image_type }}" />
         <meta {{ meta_attr }}="{{ property }}:image:width" content="{{ ogp_image_width }}" />
         <meta {{ meta_attr }}="{{ property }}:image:height" content="{{ ogp_image_height }}" />

data/_includes/base/shortcut.html.liquid

@@ -8,7 +8,9 @@ sections of related links in multi-column layout suitable for footer placement.
 Strategic Design Logic:
 - Grouped navigation: categories of related links
 - Column layout: multi-column footer display
-- Filtered items: only shows items with visible_on='footer'
+- Filtered items: only shows items with visible_on='footer', required
+explicitly — an item that omits visible_on is not shown here (it defaults
+to navbar-visible instead, per navbar.html.liquid)
 - Reusable link component: consistent styling
 - Empty state handling: no output if no items
 - Category headings: uppercase section titles
@@ -46,7 +48,7 @@ Conditional Logic:
 | default: site.data.base.navbar
 %}
 
-{%- assign shortcut_navitems = with_shortcut_data.navitems | where: "visible_on", "footer" %}
+{%- assign shortcut_navitems = with_shortcut_data.navitems | where_exp: "item", "item.visible_on contains 'footer'" %}
 
 {%- if with_shortcut -%}
 

data/_includes/base/social.html.liquid

@@ -2,12 +2,13 @@
 ================================================================================
 Template: Social Links Component
 Purpose: Renders a collection of social media and external links as styled
-buttons with icons. Includes optional site description header.
+buttons with icons, with an optional preamble line introducing them.
 ================================================================================
 
-Strategic Design Logic:
+Design Logic:
 - Multi-level data source hierarchy for flexible configuration
-- Site description display for context/branding purposes
+- Optional preamble text and CSS class, and an optional CSS class on the
+  container wrapping the icon row, for full presentational customization
 - Link rendering via reusable link component with icon support
 - Icon-based visual identification for different platforms
 - Accessibility-first approach with proper ARIA labels
@@ -21,9 +22,6 @@ Required Fields (per item in the media array):
 Optional Inputs (from include):
 - data: Array of social link objects (overrides all fallbacks)
 
-Optional Inputs (from site configuration):
-- site.description: Brief site description displayed above social links
-
 Data Source Hierarchy (in priority order):
 1. include.data           - Explicitly passed social link array
 2. page.with_social_data  - Page front matter configuration
@@ -31,7 +29,10 @@ Data Source Hierarchy (in priority order):
 4. site.data.base.social  - Theme default social links
 
 Conditional Logic:
-- Site description displays only if site.description is defined
+- Preamble <p> falls back to the schema-documented default when omitted
+  from the resolved data source; set it explicitly to `false` or an empty
+  string to hide it entirely — no element is emitted in its place, so the
+  icon row's own margin reclaims the vertical space
 - Loops through all social links in resolved data source
 - Each link rendered with consistent button styling
 ================================================================================
@@ -50,27 +51,33 @@ Conditional Logic:
 {%- assign with_social_schema = site.data.base.social_schema.properties.with_social_data.properties %}
 
 {%- assign social_class          = with_social_data.class          | default: with_social_schema.class.default %}
-{%- assign social_preamble       = with_social_data.preamble       | default: with_social_schema.preamble.default %}
 {%- assign social_preamble_class = with_social_data.preamble_class | default: with_social_schema.preamble_class.default %}
 {%- assign social_media          = with_social_data.media          | default: with_social_schema.media.default %}
 
+{%- assign social_preamble = with_social_data.preamble %}
+{%- if with_social_data.preamble == nil %}
+  {%- assign social_preamble = with_social_schema.preamble.default %}
+{%- endif %}
+
 {% if with_social %}
 
   {%- comment %} === Presentation (Begin) === {% endcomment %}
-  {%- if social_preamble %}
+  {%- if social_preamble and social_preamble != empty %}
     <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 %}
+  <div class="{{ social_class }}">
+    {%- 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 %}
+  </div>
   {%- comment %} === Presentation (End) === {% endcomment %}
 
 {% endif %}

data/_includes/base/title.html.liquid

@@ -24,6 +24,9 @@ Optional Inputs (from include):
 - data: Title configuration object
 - column_class: Bootstrap column class for the row wrapper (set by the layout to
   keep this component aligned with the content column; defaults to "col")
+- row_class: Bootstrap class(es) for the row wrapper (set by the layout to
+  keep this component's row aligned with breadcrumb, artwork, toc, and
+  content; defaults to "row mb-3")
 
 Data Source Hierarchy (in priority order):
 1. include.data       - Explicitly passed configuration
@@ -57,8 +60,9 @@ Conditional Logic:
 {%- assign title_lead       = with_title_data.title_lead       | default: page.title_lead %}
 {%- assign title_lead_class = with_title_data.title_lead_class | default: with_title_schema.title_lead_class.default %}
 {%- assign column_class     = include.column_class | default: 'col' %}
+{%- assign row_class        = include.row_class | default: 'row mb-3' %}
 
-<div class="row mb-3">
+<div class="{{ row_class }}">
   <div class="{{ column_class }}">
     <div class="{{ class }}">
       <p class="{{ title_class }}">{{ title }}</p>

data/_includes/base/toc.html.liquid

@@ -33,6 +33,9 @@ Optional Inputs (from include):
 - data: TOC configuration object
 - column_class: Bootstrap column class for the row wrapper (set by the layout to
   keep this component aligned with the content column; defaults to "col")
+- row_class: Bootstrap class(es) for the row wrapper (set by the layout to
+  keep this component's row aligned with breadcrumb, title, artwork, and
+  content; defaults to "row mb-3")
 
 Data Source Hierarchy (in priority order):
 - with_toc:      include.with_toc → page.with_toc
@@ -62,11 +65,12 @@ Data Source Hierarchy (in priority order):
 {%- assign skip_no_ids       = with_toc_data.skip_no_ids       | default: with_toc_schema["skip_no_ids"].default %}
 {%- assign flat_toc          = with_toc_data.flat_toc          | default: with_toc_schema["flat_toc"].default %}
 {%- assign column_class      = include.column_class | default: 'col' %}
+{%- assign row_class         = include.row_class | default: 'row mb-3' %}
 
 {%- comment %} === Presentation === {% endcomment %}
 
 {%- comment %} --- HTML ---  {% endcomment %}
-<div class="row mb-3">
+<div class="{{ row_class }}">
   <div class="{{ column_class }}">
     <div class="accordion shadow-sm" id="pageToc">
       <div class="accordion-item">

data/_layouts/base/default.html

@@ -1,7 +1,7 @@
 <!doctype html>
 <html lang="{{ page.lang | default: 'en' }}"{% if page.with_ogp %} prefix="og: https://ogp.me/ns#"{% endif %}>
   {% include base/head.html.liquid -%}
-  <body id="top" class="bg-body{% if page.with_navbar %} has-navbar{% endif %}">
+  <body id="top" class="{{ page.body_class | default: 'bg-body' }}{% if page.with_navbar %} has-navbar{% endif %}">
 
     {% include base/navbar.html.liquid -%}
 
@@ -9,34 +9,7 @@
 
     {% include base/breakingnews.html.liquid -%}
 
-    {%- assign with_content_data = page.with_content_data
-    | default: site.data.content
-    | default: site.data.base.content
-    -%}
-    {%- assign content_schema = site.data.content_schema | default: site.data.base.content_schema -%}
-    {%- assign content_class = with_content_data.class
-    | default: content_schema.properties.with_content_data.properties.class.default
-    | default: 'col' -%}
-
-    <main class="container py-3">
-
-      {%- include base/announcement.html.liquid %}
-
-      {% include base/bits.html.liquid %}
-
-      {% include base/event.html.liquid %}
-
-      {% include base/breadcrumb.html.liquid column_class=content_class %}
-
-      {% include base/title.html.liquid column_class=content_class %}
-
-      {% include base/artwork.html.liquid column_class=content_class %}
-
-      {% include base/toc.html.liquid column_class=content_class %}
-
-      {% include base/content.html.liquid column_class=content_class %}
-
-    </main>
+    {% include base/content.html.liquid %}
 
     {% include base/footer.html.liquid %}
   </body>

data/_sass/base/_customization.scss

@@ -281,13 +281,13 @@ main {
     opacity: 1;
     transform: translateX(-100%);
   }
-  .heading-anchor.is-active {
-    opacity: 1 !important;
-    visibility: visible !important;
-    transform: translateX(-100%) !important;
+  // Plain "#" glyph — replaces the Font Awesome icon so this component has no
+  // icon-font dependency; font-style reset since it's text, not an icon glyph.
+  .heading-anchor-hash {
+    font-style: normal;
   }
-  .heading-anchor.is-active i {
-    color: var(--bs-primary);
+  .heading-anchor-hash::before {
+    content: "#";
   }
 
   // Accordion containers' bottom clearance — same as the headings/figure

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-centos
 version: !ruby/object:Gem::Version
-  version: 2.52.0.beta.95
+  version: 2.52.0.beta.97
 platform: ruby
 authors:
 - Alain Reguera Delgado
@@ -358,7 +358,6 @@ files:
 - _includes/base/fontawesome.html.liquid
 - _includes/base/footer.html.liquid
 - _includes/base/head.html.liquid
-- _includes/base/heading_anchor.html.liquid
 - _includes/base/highlight.html.liquid
 - _includes/base/image.html.liquid
 - _includes/base/link.html.liquid
@@ -518,7 +517,6 @@ files:
 - assets/js/base/backtotop.js
 - assets/js/base/copyvalue.js
 - assets/js/base/datatable.js
-- assets/js/base/heading-anchor.js
 - assets/js/base/highlight.js
 - assets/js/base/init-tooltips.js
 - assets/js/bootstrap.bundle.js

data/_includes/base/heading_anchor.html.liquid

@@ -1,67 +0,0 @@
-{% comment %}
-================================================================================
-Template: Heading Anchor Component
-Purpose: Loads heading-anchor.js which wires click-to-copy behaviour on anchor
-icons that jekyll-link-decorator injects inside h1–h6 elements. Clicking an
-anchor icon copies the full page URL (origin + pathname + fragment) to the
-clipboard, with a transient fa-check icon as visual feedback.
-
-Recommended Usage (in head.html.liquid):
-  {%- include base/heading_anchor.html.liquid %}
-
-The heading anchor icons themselves are injected by the jekyll-link-decorator
-Ruby plugin. This include only loads the JavaScript that powers copy behaviour.
-
-Required Inputs (from HTML elements produced by the plugin):
-- class="heading-anchor"   : Selector used to attach click handlers
-- data-copy-anchor="#id"   : Fragment to append to the current page URL
-
-Optional Inputs (from data objects):
-- reset_delay              : Milliseconds before icon resets (default from schema)
-- copy_success_message     : Not consumed by JS directly; available for reference
-
-Data Source Hierarchy (in priority order):
-1. include.data                    - Explicitly passed configuration
-2. page.with_heading_anchor_data   - Page front matter
-3. site.data.heading_anchor        - Site configuration
-4. site.data.base.heading_anchor   - Theme defaults
-
-Dependencies:
-jekyll-link-decorator gem, FontAwesome 6+, Clipboard API (modern browsers)
-================================================================================
-{% endcomment %}
-
-{%- assign with_heading_anchor = include.with_heading_anchor
-| default: page.with_heading_anchor
-| default: site.with_heading_anchor
--%}
-
-{%- assign with_heading_anchor_data = include.data
-| default: page.with_heading_anchor_data
-| default: site.data.heading_anchor
-| default: site.data.base.heading_anchor
--%}
-
-{%- assign with_heading_anchor_schema = site.data.base.heading_anchor_schema.properties.with_heading_anchor_data.properties -%}
-
-{%- if with_heading_anchor -%}
-
-{%- comment %} === Presentation === {% endcomment %}
-
-{%- comment %} --- Defaults --- {% endcomment %}
-{%- assign heading_anchor_reset_delay       = with_heading_anchor_data.reset_delay          | default: with_heading_anchor_schema.reset_delay.default -%}
-{%- assign heading_anchor_success_message   = with_heading_anchor_data.copy_success_message | default: with_heading_anchor_schema.copy_success_message.default -%}
-
-{%- comment %} --- HTML --- {% endcomment %}
-<!-- Load Heading Anchor functionality with configuration via data attributes -->
-<script id="centos-heading-anchor"
-        {%- if with_heading_anchor_data.reset_delay %}
-        data-reset-delay="{{ heading_anchor_reset_delay }}"
-        {%- endif %}
-        {%- if with_heading_anchor_data.copy_success_message %}
-        data-success-message="{{ heading_anchor_success_message }}"
-        {%- endif %}
-        src="{{ site.baseurl }}/assets/js/base/heading-anchor.min.js"
-        defer></script>
-
-{%- endif -%}

data/assets/js/base/heading-anchor.js

@@ -1,109 +0,0 @@
-// Heading Anchor Component — requires Bootstrap >= 5.3 (tooltip.setContent) and Font Awesome 6+
-
-document.addEventListener('DOMContentLoaded', () => {
-  if (typeof bootstrap === 'undefined') {
-    console.warn('heading-anchor: Bootstrap not available')
-    return
-  }
-
-  const DEFAULT_TEXT = 'Copy link'
-  const scriptEl = document.getElementById('centos-heading-anchor')
-  const RESET_DELAY = scriptEl?.dataset.resetDelay
-    ? parseInt(scriptEl.dataset.resetDelay, 10) : 2000
-  const SUCCESS_TEXT = scriptEl?.dataset.successMessage || 'Copied!'
-
-  // One shared region: multiple regions would cause simultaneous AT announcements per anchor.
-  let liveRegion = document.getElementById('centos-heading-anchor-live')
-  if (!liveRegion) {
-    liveRegion = document.createElement('div')
-    liveRegion.id = 'centos-heading-anchor-live'
-    liveRegion.setAttribute('aria-live', 'polite')
-    liveRegion.setAttribute('aria-atomic', 'true')
-    liveRegion.className = 'visually-hidden'
-    document.body.appendChild(liveRegion)
-  }
-
-  document.querySelectorAll('.heading-anchor[data-copy-anchor]').forEach(anchor => {
-    // FA SVG+JS replaces <i> with <svg> before this DOMContentLoaded fires.
-    // Cache innerHTML after FA has processed so it can be restored on reset.
-    const originalIconHTML = anchor.innerHTML
-    // Guards blur/mouseenter handlers from collapsing the tooltip during the success window.
-    let isLocked = false
-
-    const tooltip = new bootstrap.Tooltip(anchor, {
-      title: DEFAULT_TEXT,
-      trigger: 'manual',   // CSS sets pointer-events:none on hidden anchors, defeating Bootstrap's auto hover/focus triggers.
-      placement: 'top',
-      animation: false     // Prevents Bootstrap's fade and the CSS opacity transition from desyncing.
-    })
-
-    const updateUI = (isSuccess) => {
-      tooltip.setContent({ '.tooltip-inner': isSuccess ? SUCCESS_TEXT : DEFAULT_TEXT })
-      if (isSuccess) {
-        // FA SVG+JS mode: <i> has been replaced by <svg>; swap the path to a checkmark.
-        const svg = anchor.querySelector('svg')
-        if (svg) {
-          const path = svg.querySelector('path')
-          if (path) {
-            svg.setAttribute('viewBox', '0 0 448 512')
-            path.setAttribute('d', 'M434.8 70.1c14.3 10.4 17.5 30.4 7.1 44.7l-256 352c-5.5 7.6-14 12.3-23.4 13.1s-18.5-2.7-25.1-9.3l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l101.5 101.5 234-321.7c10.4-14.3 30.4-17.5 44.7-7.1z')
-          }
-        } else {
-          // FA webfont mode: <i> is still in the DOM; toggle classes normally.
-          const icon = anchor.querySelector('i')
-          if (icon) { icon.classList.remove('fa-hashtag'); icon.classList.add('fa-check') }
-        }
-      } else {
-        anchor.innerHTML = originalIconHTML
-      }
-      anchor.classList.toggle('is-active', isSuccess)
-      // Empty string on reset prevents AT from re-announcing stale text on DOM inspection.
-      liveRegion.textContent = isSuccess ? SUCCESS_TEXT : ''
-      if (isSuccess) tooltip.show()
-    }
-
-    const handleInteraction = (show) => {
-      if (!isLocked) show ? tooltip.show() : tooltip.hide()
-    }
-
-    anchor.addEventListener('mouseenter', () => handleInteraction(true))
-    anchor.addEventListener('mouseleave', () => handleInteraction(false))
-    anchor.addEventListener('focus', () => handleInteraction(true))
-    anchor.addEventListener('blur', () => handleInteraction(false))
-
-    anchor.addEventListener('click', async (e) => {
-      e.preventDefault()
-      anchor.closest('h1, h2, h3, h4, h5, h6')?.scrollIntoView()
-      if (isLocked) return
-
-      if (!navigator.clipboard) {
-        console.warn('heading-anchor: Clipboard API unavailable')
-        return
-      }
-
-      const url = window.location.origin + window.location.pathname + anchor.dataset.copyAnchor
-
-      try {
-        await navigator.clipboard.writeText(url)
-        isLocked = true
-        // isLocked must be true before blur() so the resulting blur event is suppressed
-        // and does not hide the tooltip before the success state has been rendered.
-        anchor.blur()
-        updateUI(true)
-
-        setTimeout(() => {
-          isLocked = false
-          updateUI(false)
-          // mouseleave/blur events fired while isLocked was true were suppressed;
-          // hide now if the user already moved away during the success window.
-          if (!anchor.matches(':hover')) tooltip.hide()
-        }, RESET_DELAY)
-
-      } catch (err) {
-        console.warn('heading-anchor: clipboard write failed', err)
-        isLocked = false
-        anchor.innerHTML = originalIconHTML
-      }
-    })
-  })
-})